@d3plus/core 4.9.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -4,7 +4,7 @@
4
4
  zoom-controls panel's "N buttons, one flex-row `htmlOverlay` panel"
5
5
  composition (`zoomControls.ts`/`zoomControlsMarkup.ts`), except fed by
6
6
  independent contributor functions (`backContribution`,
7
- `tableViewContribution`, `searchContribution`) rather than one feature's
7
+ `tableViewContribution`, `saveContribution`, `searchContribution`) rather than one feature's
8
8
  own fixed button set. A downstream branch adding a new top-left control
9
9
  appends its own contributor function to `TOP_LEFT_CONTRIBUTORS` — a
10
10
  one-line diff, not a dynamic registry.
@@ -19,6 +19,7 @@
19
19
  @module
20
20
  */ import { backContribution } from "./backControl.js";
21
21
  import { tableViewContribution } from "./tableViewControl.js";
22
+ import { saveContribution } from "./saveControl.js";
22
23
  import { searchContribution } from "./searchControls.js";
23
24
  import { buildTopLeftPanel } from "./topLeftControlsMarkup.js";
24
25
  /**
@@ -27,6 +28,7 @@ import { buildTopLeftPanel } from "./topLeftControlsMarkup.js";
27
28
  */ export const TOP_LEFT_CONTRIBUTORS = [
28
29
  backContribution,
29
30
  tableViewContribution,
31
+ saveContribution,
30
32
  searchContribution
31
33
  ];
32
34
  /** The current, non-null contributions for a chart — computed once per layout/measurement. */ export function getTopLeftContributions(viz) {
@@ -122,7 +122,7 @@ const ESTIMATED_ITEM_HEIGHT = 20;
122
122
  The shared top-left panel's rendered size (padding included) as it will
123
123
  render in the chart's page, so top-positioned content can leave room for
124
124
  it — the same measure-a-hidden-probe technique `zoomControlsBox` uses,
125
- generalized to whichever mix of controls (back / table-view / search)
125
+ generalized to whichever mix of controls (back / table-view / save / search)
126
126
  is currently contributing, and to each contribution's OWN resolved
127
127
  button styling (not just its markup). Returns null when nothing is
128
128
  contributing.
@@ -7,7 +7,9 @@ import { autoZoomMax } from "../features/zoomExtent.js";
7
7
  import { isBrushing, mountCustomIcons, paintZoomButton, setBrushing, showsZoomControls, syncBrushButton, ZOOM_PANEL_STYLE, zoomControlsHtml } from "./zoomControlsMarkup.js";
8
8
  import { refreshBottomRightPanel } from "./bottomRightControlsMarkup.js";
9
9
  import { startsOnBrush } from "./zoomGesture.js";
10
+ import { gestureHoverEnd, gestureHoverMove, gestureHoverStart } from "./gestureHover.js";
10
11
  import { forgetTransform, recordTransform, showsTransform } from "./zoomShown.js";
12
+ import { effectiveDuration, motionReduced } from "../viz/reducedMotion.js";
11
13
  /**
12
14
  Builds the four zoom-control buttons as an `htmlOverlay` scene-node
13
15
  panel, pinned to the top-right corner of the whole chart (not the
@@ -127,8 +129,18 @@ import { forgetTransform, recordTransform, showsTransform } from "./zoomShown.js
127
129
  viz._zoomBehavior.filter((event)=>zoomGestureFilter(viz, event)).wheelDelta(wheelDelta).extent(area).scaleExtent([
128
130
  1,
129
131
  zoomMax(viz, width, height)
130
- ]).translateExtent(area).on("zoom", (event)=>{
132
+ ]).translateExtent(area).on("start", (event)=>{
133
+ gestureHoverStart(viz, event);
134
+ viz._zoomGesture?.start(event);
135
+ }).on("zoom", (event)=>{
136
+ // Tooltips and hover wait while the gesture moves the chart.
137
+ gestureHoverMove(viz, event);
138
+ // A chart can take the gesture itself (a Geomap globe rotates).
139
+ if (viz._zoomGesture?.zoom(event)) return;
131
140
  if (!showsTransform(viz, event.transform)) zoomed.bind(viz)(event.transform);
141
+ }).on("end", (event)=>{
142
+ viz._zoomGesture?.end(event);
143
+ gestureHoverEnd(viz);
132
144
  });
133
145
  viz._zoomToBounds = zoomToBounds.bind(viz);
134
146
  const panel = showsZoomControls(viz) ? buildZoomControlPanel(viz) : null;
@@ -182,7 +194,7 @@ import { forgetTransform, recordTransform, showsTransform } from "./zoomShown.js
182
194
  kind: "generic",
183
195
  width,
184
196
  height,
185
- duration: viz.schema.duration
197
+ duration: effectiveDuration(viz)
186
198
  });
187
199
  }
188
200
  if (viz._renderer !== "canvas") retargetZoom(viz, viz._select);
@@ -325,6 +337,7 @@ import { forgetTransform, recordTransform, showsTransform } from "./zoomShown.js
325
337
  @param transform
326
338
  @private
327
339
  */ function zoomed(transform = false, duration = 0) {
340
+ if (motionReduced(this)) duration = 0;
328
341
  if (this._zoomGroup) {
329
342
  if (!duration) this._zoomGroup.attr("transform", transform);
330
343
  else this._zoomGroup.transition().duration(duration).attr("transform", transform);
@@ -379,7 +392,10 @@ import { forgetTransform, recordTransform, showsTransform } from "./zoomShown.js
379
392
  */ function zoomMath(factor = 0) {
380
393
  if (!this._container) return;
381
394
  const [[x0, y0], [x1, y1]] = this._zoomBehavior.extent().bind(document)(), cx = (x0 + x1) / 2, cy = (y0 + y1) / 2, t = zoomTransform((this._zoomEventTarget || this._container).node());
382
- if (!factor) return zoomTo(this, 1, 0, 0);
395
+ if (!factor) {
396
+ this._zoomGesture?.reset();
397
+ return zoomTo(this, 1, 0, 0);
398
+ }
383
399
  // Scale about the chart area's center: keep the content point currently at
384
400
  // the center fixed on screen.
385
401
  const k = t.k * factor;
@@ -393,7 +409,7 @@ import { forgetTransform, recordTransform, showsTransform } from "./zoomShown.js
393
409
 
394
410
  Exported so `minimap.ts`'s drag-to-pan and Cmd/Ctrl+scroll-to-zoom can
395
411
  reuse the same scale/translate clamping instead of reimplementing it.
396
- */ export function zoomTo(viz, scale, x, y, duration = viz.schema.duration) {
412
+ */ export function zoomTo(viz, scale, x, y, duration = effectiveDuration(viz)) {
397
413
  const [kMin, kMax] = viz._zoomBehavior.scaleExtent(), [[x0, y0], [x1, y1]] = viz._zoomBehavior.translateExtent(), k = Math.max(kMin, Math.min(kMax, scale));
398
414
  // Content must still cover the whole area: its left edge (x0·k + tx) can't
399
415
  // move right of x0, nor its right edge (x1·k + tx) left of x1.
@@ -411,7 +427,7 @@ import { forgetTransform, recordTransform, showsTransform } from "./zoomShown.js
411
427
  displayed) fill the chart area, less `zoomPadding`. `null` resets.
412
428
  @param bounds
413
429
  @private
414
- */ function zoomToBounds(bounds, duration = this.schema.duration) {
430
+ */ function zoomToBounds(bounds, duration = effectiveDuration(this)) {
415
431
  if (!bounds) return zoomTo(this, 1, 0, 0, duration);
416
432
  const [[x0, y0], [x1, y1]] = this._zoomBehavior.translateExtent(), pad = this.schema.zoomPadding, t = zoomTransform((this._zoomEventTarget || this._container).node()), // Un-apply the current transform: bounds → unzoomed surface space.
417
433
  bx0 = (bounds[0][0] - t.x) / t.k, by0 = (bounds[0][1] - t.y) / t.k, bx1 = (bounds[1][0] - t.x) / t.k, by1 = (bounds[1][1] - t.y) / t.k;
@@ -1,8 +1,10 @@
1
1
  import { merge } from "d3-array";
2
+ import { legendSnapshot, recordLegendChange } from "../viz/history.js";
2
3
  import { broadcastLegend } from "../viz/linkGroup.js";
3
4
  /**
4
5
  @module clickLegend
5
- On click event for all legend shapes in a Viz.
6
+ On click event for all legend shapes in a Viz. A click that changes what
7
+ is hidden or solo'd goes on the chart's Back history (see `legendHistory`).
6
8
  @private
7
9
  */ export default function(d, i, x, event) {
8
10
  this._select.style("cursor", "auto");
@@ -21,8 +23,11 @@ import { broadcastLegend } from "../viz/linkGroup.js";
21
23
  return id;
22
24
  })).length;
23
25
  const inverted = this.schema.legendFilterInvert.bind(this)(this);
26
+ const viz = this;
27
+ const before = legendSnapshot(viz);
24
28
  const rerender = ()=>{
25
- broadcastLegend(this);
29
+ recordLegendChange(viz, before);
30
+ broadcastLegend(viz);
26
31
  this.render();
27
32
  };
28
33
  if (inverted) {
@@ -1,10 +1,38 @@
1
1
  import { nodeRect } from "../pipeline/drillMorph.js";
2
+ import { groupDepthOf, groupNarrows, groupPath, inGroup } from "../viz/groupRow.js";
3
+ import { takeLegendState } from "../viz/history.js";
4
+ /**
5
+ Zooms into the group a group row stands for (see `viz/groupRow.ts`):
6
+ filters the data to that group, keeping the drawn depth, and records the
7
+ previous view on the drill-down history so Back steps out. Does nothing
8
+ when the group is already all that's drawn.
9
+ */ function zoomIntoGroup(viz, d, depth) {
10
+ const groupBy = viz.schema.groupBy;
11
+ const path = groupPath(groupBy, d, depth);
12
+ if (!groupNarrows(groupBy, path, viz._filteredData ?? [])) return;
13
+ viz._select.style("cursor", "auto");
14
+ viz.hover(false);
15
+ viz._tooltipClass.data([]).render();
16
+ const oldFilter = viz.schema.filter;
17
+ viz._history.push({
18
+ depth: viz.schema.depth,
19
+ filter: oldFilter
20
+ });
21
+ viz.config({
22
+ filter: (f, x)=>(!oldFilter || oldFilter(f, x)) && inGroup(groupBy, path, f, x)
23
+ }).render();
24
+ }
2
25
  /**
3
26
  @module clickShape
4
27
  On click event for all shapes in a Viz.
5
28
  @private
6
29
  */ export default function(d, i, x, event) {
7
30
  event.stopPropagation();
31
+ const groupDepth = groupDepthOf(d);
32
+ if (groupDepth !== undefined) {
33
+ zoomIntoGroup(this, d, groupDepth);
34
+ return;
35
+ }
8
36
  if (this._drawDepth < this.schema.groupBy.length - 1) {
9
37
  this._select.style("cursor", "auto");
10
38
  const filterGroup = this.schema.groupBy[this._drawDepth], filterId = filterGroup(d, i);
@@ -30,15 +58,23 @@ import { nodeRect } from "../pipeline/drillMorph.js";
30
58
  parentEndAngle: pickedNode.endAngle
31
59
  };
32
60
  }
61
+ // The legend's hidden and solo'd ids name groups at the level being
62
+ // left, so the drill clears them and Back puts them back.
63
+ const legend = takeLegendState(this);
33
64
  this._history.push({
34
65
  depth: this.schema.depth,
35
66
  filter: oldFilter,
36
67
  groupId: filterId,
37
- groupDepth: this._drawDepth
68
+ groupDepth: this._drawDepth,
69
+ ...legend && {
70
+ legend
71
+ }
38
72
  });
73
+ // A threshold bucket's id lists the groups it holds; it opens onto them.
74
+ const inGroup = Array.isArray(filterId) ? (v)=>filterId.includes(v) : (v)=>v === filterId;
39
75
  this.config({
40
76
  depth: this._drawDepth + 1,
41
- filter: (f, x)=>(!oldFilter || oldFilter(f, x)) && filterGroup(f, x) === filterId
77
+ filter: (f, x)=>(!oldFilter || oldFilter(f, x)) && inGroup(filterGroup(f, x))
42
78
  }).render();
43
79
  }
44
80
  }
@@ -1,4 +1,5 @@
1
1
  import { colorScaleBucketOf, colorScaleBucketPredicate } from "../features/colorScaleBucket.js";
2
+ import { groupDepthOf, groupPath, inGroup } from "../viz/groupRow.js";
2
3
  import { shapeHoverEnabled } from "../viz/shapeHover.js";
3
4
  /**
4
5
  @module mouseEnter
@@ -29,6 +30,14 @@ import { shapeHoverEnabled } from "../viz/shapeHover.js";
29
30
  // (`_plotColumnHighlight`) owns it too: it highlights the mark's column.
30
31
  if (this._sharedHoverActive && this._plotColumnHighlight) return;
31
32
  if (shapeHoverEnabled(this)) {
33
+ // A group row highlights every row in its group.
34
+ const groupDepth = groupDepthOf(d);
35
+ if (groupDepth !== undefined) {
36
+ const groupBy = this.schema.groupBy;
37
+ const path = groupPath(groupBy, d, groupDepth);
38
+ this.hover((h, x)=>inGroup(groupBy, path, h, x));
39
+ return;
40
+ }
32
41
  let filterIds = this._id(d, i);
33
42
  if (!(filterIds instanceof Array)) filterIds = [
34
43
  filterIds
@@ -1,6 +1,7 @@
1
1
  import { merge } from "d3-array";
2
2
  import clickLegend from "./click.legend.js";
3
3
  import { legendLabel } from "../features/legendLabel.js";
4
+ import { appendThresholdMembers } from "../features/thresholdMembers.js";
4
5
  import { leadTitleWithSwatch, pickSwatch } from "../features/tooltipSwatch.js";
5
6
  import { configPrep } from "../../utils/index.js";
6
7
  /**
@@ -49,6 +50,8 @@ import { configPrep } from "../../utils/index.js";
49
50
  this._tooltipClass.data([
50
51
  x || d
51
52
  ]).footer(hasDefaultClick ? invertedBehavior ? this._solo.length && !solo || hidden ? t("Click to Highlight") : this._solo.length === 1 && solo || this._hidden.length === dataLength - 1 ? t("Click to Show All") : `${t("Click to Highlight")}<br />${t("Shift+Click to Hide")}` : this._solo.length && !solo || hidden ? `${t("Click to Show")}<br />${t("Shift+Click to Highlight")}` : this._solo.length === 1 && solo || this._hidden.length === dataLength - 1 ? t("Click to Show All") : `${t("Click to Hide")}<br />${t("Shift+Click to Highlight")}` : false).title(this.schema.legendConfig.label ? this._legendClass.label() : legendLabel.bind(this)).titleSwatch(true).position(position).config(configPrep.bind(this)(this.schema.tooltipConfig)).config(configPrep.bind(this)(this.schema.legendTooltip));
53
+ // A threshold bucket's entry lists what it holds.
54
+ appendThresholdMembers(this._tooltipClass, this, d);
52
55
  // The title leads with the hovered entry's swatch, as on the chart.
53
56
  leadTitleWithSwatch(this._tooltipClass, pickSwatch(this, this._lastScenePick)).render();
54
57
  }
@@ -1,6 +1,9 @@
1
1
  import { configPrep } from "../../utils/index.js";
2
2
  import clickShape from "./click.shape.js";
3
+ import { groupDepthOf, groupNarrows, groupPath } from "../viz/groupRow.js";
4
+ import { appendThresholdMembers } from "../features/thresholdMembers.js";
3
5
  import { leadTitleWithSwatch, pickSwatch } from "../features/tooltipSwatch.js";
6
+ import { pointTooltipAnchor } from "../viz/pointTooltipAnchor.js";
4
7
  /**
5
8
  @module mouseMoveShape
6
9
  Tooltip logic for a specified data point.
@@ -20,19 +23,22 @@ import { leadTitleWithSwatch, pickSwatch } from "../features/tooltipSwatch.js";
20
23
  // does the shape still have our default "click.shape" event?
21
24
  // (if the user only sets "click", both functions will fire)
22
25
  const hasDefaultClick = this.schema.on["click.shape"] && this.schema.on["click.shape"].toString() === defaultClick;
23
- // can the viz show deeper data?
24
- const hasDeeperLevel = this._drawDepth < this.schema.groupBy.length - 1;
26
+ // can the viz show deeper data? A group row zooms into its group.
27
+ const groupDepth = groupDepthOf(d);
28
+ const hasDeeperLevel = groupDepth === undefined ? this._drawDepth < this.schema.groupBy.length - 1 : groupNarrows(this.schema.groupBy, groupPath(this.schema.groupBy, d, groupDepth), this._filteredData ?? []);
25
29
  // only show the hand cursor when the shape has a click event
26
30
  this._select.style("cursor", hasUserClick || hasDefaultClick && hasDeeperLevel ? "pointer" : "auto");
27
31
  // Plot's snapped hover (shared or single) owns the tooltip while active.
28
32
  if (this._sharedHoverActive) return;
29
- const position = event.touches ? [
33
+ // A point mark's tooltip points at the mark, wherever the pointer is
34
+ // within reach of it; anything else follows the pointer.
35
+ const position = pointTooltipAnchor(this, this._lastScenePick?.node) ?? (event.touches ? [
30
36
  event.touches[0].clientX,
31
37
  event.touches[0].clientY
32
38
  ] : [
33
39
  event.clientX,
34
40
  event.clientY
35
- ];
41
+ ]);
36
42
  // Unwrap to the underlying source row so tooltip cell accessors (e.g.
37
43
  // the Treemap "share" column) resolve regardless of whether the hovered
38
44
  // scene node was the shape (datum = row) or its text label (datum = a
@@ -42,6 +48,8 @@ import { leadTitleWithSwatch, pickSwatch } from "../features/tooltipSwatch.js";
42
48
  this._tooltipClass.data([
43
49
  tooltipDatum
44
50
  ]).footer(hasDefaultClick && hasDeeperLevel ? this.schema.translate("Click to Expand") : false).title((dd, ii)=>this._drawLabel(dd, ii)).titleSwatch(true).position(position).config(configPrep.bind(this)(this.schema.tooltipConfig));
51
+ // A threshold bucket lists what it holds.
52
+ appendThresholdMembers(this._tooltipClass, this, tooltipDatum);
45
53
  // The title leads with a swatch of the hovered mark, as in the legend.
46
54
  leadTitleWithSwatch(this._tooltipClass, pickSwatch(this, this._lastScenePick)).render();
47
55
  }
@@ -15,6 +15,7 @@
15
15
 
16
16
  @module
17
17
  */ import { drawWithInset } from "../pipeline/insetPlacement.js";
18
+ import { drawWithAlongLegend } from "../Plot/alongLegend.js";
18
19
  import { backgroundInk } from "../viz/backgroundInk.js";
19
20
  import { FACET_ASPECT, facetActive, facetOuterAxes, facetScalesShared, resolveFacetConfig } from "./facetConfig.js";
20
21
  import { facetFilteredData, facetGroups, facetTimeFilter, formatFacetValue } from "./facetData.js";
@@ -171,7 +172,7 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
171
172
  rows: config.rows,
172
173
  padding: config.padding,
173
174
  titleHeight: 0,
174
- aspect: hooks.aspect ?? FACET_ASPECT
175
+ aspect: (typeof hooks.aspect === "function" ? hooks.aspect(viz) : hooks.aspect) ?? FACET_ASPECT
175
176
  };
176
177
  const titleHeight = facetTitleBand(viz, texts, facetGrid(panels.length, area, opts), style);
177
178
  opts.titleHeight = titleHeight;
@@ -276,6 +277,13 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
276
277
  viz._filteredData = all;
277
278
  viz._insetPending = null;
278
279
  viz._insetPlacement = null;
280
+ // Chrome that reads what the panels draw (a stacked legend's order) sees
281
+ // every panel's rows before it lays out.
282
+ const hooks = viz._facetHooks ? viz._facetHooks() : {};
283
+ if (hooks.chrome) {
284
+ hooks.chrome(viz, panels.map((p)=>p.data));
285
+ viz._filteredData = all;
286
+ }
279
287
  viz._facetStep = "chrome";
280
288
  try {
281
289
  viz._draw();
@@ -294,7 +302,6 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
294
302
  width: viz.schema.width - margin.left - margin.right,
295
303
  height: viz.schema.height - margin.top - margin.bottom
296
304
  };
297
- const hooks = viz._facetHooks ? viz._facetHooks() : {};
298
305
  const shared = facetScalesShared(config, hooks);
299
306
  const { states, zoomShapes } = drawPanels(viz, {
300
307
  config,
@@ -326,7 +333,9 @@ import { facetBodyNode, facetPanelNode, facetTitleNodes, measureFacetTitles, pre
326
333
  Draws the chart for this render: as small multiples when `facet` is set,
327
334
  otherwise as one chart (with chrome placed inside it when it fits).
328
335
  */ export function drawChart(viz) {
329
- viz._facetPanels = undefined;
330
- if (facetActive(viz) && drawFacets(viz)) return;
331
- drawWithInset(viz);
336
+ drawWithAlongLegend(viz, ()=>{
337
+ viz._facetPanels = undefined;
338
+ if (facetActive(viz) && drawFacets(viz)) return;
339
+ drawWithInset(viz);
340
+ });
332
341
  }
@@ -3,7 +3,7 @@
3
3
  chart can supply to tune how its panels are laid out and drawn.
4
4
 
5
5
  @module
6
- */ import { accessor } from "../../utils/index.js";
6
+ */ import { fieldAccessor } from "../../utils/fieldAccessor.js";
7
7
  /** Default panel title style: smaller than the chart title, centered over its panel. */ export const FACET_TITLE_DEFAULTS = {
8
8
  fontSize: 12,
9
9
  fontWeight: 600,
@@ -17,7 +17,7 @@
17
17
  function is kept, and anything else (`false`, `undefined`) turns faceting off.
18
18
  */ export function coerceFacet(value) {
19
19
  if (typeof value === "function") return value;
20
- if (typeof value === "string" && value) return accessor(value);
20
+ if (typeof value === "string" && value) return fieldAccessor(value);
21
21
  return undefined;
22
22
  }
23
23
  /** `facetConfig` with defaults filled in. */ export function resolveFacetConfig(config) {
@@ -76,13 +76,13 @@ import { computeFilteredData, computeTimeFilter, dataFilter } from "../pipeline/
76
76
  /**
77
77
  One panel's drawable rows: `rows` run through the same time filter,
78
78
  rollup, legend hide/solo, and threshold the chart applies to its whole
79
- dataset. `timeFilter` is computed once from the whole dataset, so every
79
+ dataset (a threshold that weighs rows weighs the whole chart's). `timeFilter` is computed once from the whole dataset, so every
80
80
  panel shows the same period.
81
81
  */ export function facetFilteredData(viz, rows, timeFilter) {
82
82
  const out = {};
83
83
  computeFilteredData(viz, out, viz._drawDepth, viz._id, timeFilter, rows);
84
84
  let data = out.filteredData ?? [];
85
- if (rows.length && out._thresholdTree && viz._thresholdFunction) data = viz._thresholdFunction(data, out._thresholdTree);
85
+ if (rows.length && out._thresholdTree && viz._thresholdFunction) data = viz._thresholdFunction(data, out._thresholdTree, viz._thresholdRows ?? out.legendData);
86
86
  return data;
87
87
  }
88
88
  /** The time filter every panel shares (see `facetFilteredData`). */ export function facetTimeFilter(viz) {
@@ -0,0 +1,179 @@
1
+ /**
2
+ Where annotation positions land in a Plot's pixels: values in data units
3
+ map through the axis scales (dates parsed, categories matched), and
4
+ `"plot"` positions read as fractions of the plot area.
5
+ */ import { date } from "@d3plus/dom";
6
+ /** Whether an axis runs vertically. */ export const isVertical = (axis)=>axis[0] === "y";
7
+ /** A comparable key for an axis value: a date's time, or the value's string. */ const valueKey = (v)=>v instanceof Date ? `${+v}` : `${v}`;
8
+ /**
9
+ The pixel position of `value` on `axis`, or NaN when it has none: the
10
+ axis is missing, the value is not one of a category axis's categories,
11
+ or it does not parse. A `"plot"` value is a fraction of the plot area
12
+ (`0` at the left or bottom edge, `1` at the right or top).
13
+ @param frame The plot area and its axes.
14
+ @param axis The axis the value is on.
15
+ @param value The value, in data units or as a fraction.
16
+ @param ref How the value is read.
17
+ */ export function axisPixel(frame, axis, value, ref = "data") {
18
+ if (value === undefined || value === null || value === "") return NaN;
19
+ const { plot } = frame;
20
+ if (ref === "plot") {
21
+ const f = Number(value);
22
+ if (!Number.isFinite(f)) return NaN;
23
+ return isVertical(axis) ? plot.y1 - f * (plot.y1 - plot.y0) : plot.x0 + f * (plot.x1 - plot.x0);
24
+ }
25
+ const a = frame.axes[axis];
26
+ if (!a) return NaN;
27
+ const v = a.time ? date(value) : value;
28
+ if (v === false || v === undefined) return NaN;
29
+ if (a.categories) {
30
+ const key = valueKey(v);
31
+ if (!a.categories.some((c)=>valueKey(c) === key)) return betweenCategories(a, v);
32
+ }
33
+ const px = a.scale(v);
34
+ return typeof px === "number" && Number.isFinite(px) ? px : NaN;
35
+ }
36
+ /** A number for a numeric category or date, or NaN. */ const numeric = (v)=>v instanceof Date ? +v : typeof v === "number" ? v : NaN;
37
+ /**
38
+ The pixel position of a number (or date) that is not itself a category
39
+ on an axis of numeric categories: interpolated between the categories on
40
+ either side of it, or NaN outside them or among non-numeric categories.
41
+ @param a The axis.
42
+ @param value The value.
43
+ */ export function betweenCategories(a, value) {
44
+ const v = numeric(value);
45
+ const cats = a.categories || [];
46
+ if (!Number.isFinite(v) || !cats.length) return NaN;
47
+ const points = cats.map((c)=>[
48
+ numeric(c),
49
+ a.scale(c)
50
+ ]).sort((p, q)=>p[0] - q[0]);
51
+ if (points.some(([n, px])=>!Number.isFinite(n) || !Number.isFinite(px))) return NaN;
52
+ for(let i = 1; i < points.length; i++){
53
+ const [n0, p0] = points[i - 1], [n1, p1] = points[i];
54
+ if (v >= n0 && v <= n1) return p0 + (v - n0) / (n1 - n0) * (p1 - p0);
55
+ }
56
+ return NaN;
57
+ }
58
+ /**
59
+ Half the pixel distance between neighboring categories on a category
60
+ axis whose categories fill slots (bars; half the plot's extent along it
61
+ when it has one category), or `0` on any other axis.
62
+ @param frame The plot area and its axes.
63
+ @param axis The axis.
64
+ */ export function categoryHalfStep(frame, axis) {
65
+ const a = frame.axes[axis];
66
+ if (!a || !a.slots || !a.categories || !a.categories.length) return 0;
67
+ const pixels = a.categories.map((c)=>a.scale(c)).filter((p)=>Number.isFinite(p)).sort((p, q)=>p - q);
68
+ let gap = Infinity;
69
+ for(let i = 1; i < pixels.length; i++){
70
+ const d = pixels[i] - pixels[i - 1];
71
+ if (d > 0.5 && d < gap) gap = d;
72
+ }
73
+ if (Number.isFinite(gap)) return gap / 2;
74
+ const { plot } = frame;
75
+ return (isVertical(axis) ? plot.y1 - plot.y0 : plot.x1 - plot.x0) / 2;
76
+ }
77
+ /**
78
+ The pixel extent `[lo, hi]` between two values on an axis, or null when
79
+ either has no position. On a category axis of bars it takes in each end
80
+ category's whole slot.
81
+ @param frame The plot area and its axes.
82
+ @param axis The axis the values are on.
83
+ @param values The two values.
84
+ @param ref How the values are read.
85
+ */ export function axisSpan(frame, axis, values, ref = "data") {
86
+ const a = axisPixel(frame, axis, values[0], ref);
87
+ const b = axisPixel(frame, axis, values[1], ref);
88
+ if (!Number.isFinite(a) || !Number.isFinite(b)) return null;
89
+ const half = ref === "data" ? categoryHalfStep(frame, axis) : 0;
90
+ return [
91
+ Math.min(a, b) - half,
92
+ Math.max(a, b) + half
93
+ ];
94
+ }
95
+ /**
96
+ Clips a pixel extent to `[min, max]`, or null when nothing of it is left.
97
+ @param span The extent.
98
+ @param min The lower bound.
99
+ @param max The upper bound.
100
+ */ export function clipSpan(span, min, max) {
101
+ const lo = Math.max(span[0], min), hi = Math.min(span[1], max);
102
+ return hi - lo >= 0.5 ? [
103
+ lo,
104
+ hi
105
+ ] : null;
106
+ }
107
+ /**
108
+ Whether a pixel point lies in the plot area, give or take `tolerance`.
109
+ @param point The point.
110
+ @param plot The plot area.
111
+ @param tolerance Pixels of slack on each side.
112
+ */ export function inPlot([x, y], plot, tolerance = 0.5) {
113
+ return x >= plot.x0 - tolerance && x <= plot.x1 + tolerance && y >= plot.y0 - tolerance && y <= plot.y1 + tolerance;
114
+ }
115
+ /**
116
+ The pixel position of an annotation row's anchor: its `x` (or `x2`, on
117
+ that axis) and `y` (or `y2`), or NaN coordinates when it has none.
118
+ @param frame The plot area and its axes.
119
+ @param d The row.
120
+ @param xRef How its x value is read.
121
+ @param yRef How its y value is read.
122
+ */ export function anchorPoint(frame, d, xRef = "data", yRef = "data") {
123
+ const xAxis = d.x === undefined && d.x2 !== undefined ? "x2" : "x";
124
+ const yAxis = d.y === undefined && d.y2 !== undefined ? "y2" : "y";
125
+ return [
126
+ axisPixel(frame, xAxis, d[xAxis], xRef),
127
+ axisPixel(frame, yAxis, d[yAxis], yRef)
128
+ ];
129
+ }
130
+ /** Category-like axis scales, whose values must match a category. */ const CATEGORY_SCALES = new Set([
131
+ "band",
132
+ "ordinal",
133
+ "point"
134
+ ]);
135
+ /** The mapping frame of one rendered axis. */ function axisFrame(axis, scale, time, slots) {
136
+ if (!axis || !axis._d3Scale) return undefined;
137
+ const type = axis.schema.scale;
138
+ const frame = {
139
+ scale,
140
+ time: time || type === "time"
141
+ };
142
+ if (CATEGORY_SCALES.has(type)) {
143
+ frame.categories = axis._d3Scale.domain();
144
+ if (slots) frame.slots = true;
145
+ }
146
+ return frame;
147
+ }
148
+ /**
149
+ The annotation frame of a painted Plot: its plot area in content pixels
150
+ and its rendered axes. `x2`/`y2` are present only when the chart plots
151
+ on them, and `slots` marks a bar chart, whose categories fill slots
152
+ along its discrete axis.
153
+ @param viz The chart.
154
+ @param measured The axis functions and ranges `renderAxes` solved.
155
+ */ export function plotAnnotationFrame(viz, measured) {
156
+ const { x, y, xRange, yRange, x2Height } = measured;
157
+ const ys = [
158
+ yRange[0],
159
+ yRange[1]
160
+ ].map((v)=>v - x2Height);
161
+ const plot = {
162
+ x0: Math.min(xRange[0], xRange[1]),
163
+ y0: Math.min(ys[0], ys[1]),
164
+ x1: Math.max(xRange[0], xRange[1]),
165
+ y1: Math.max(ys[0], ys[1])
166
+ };
167
+ const discrete = viz.schema.discrete || "x";
168
+ const slots = (axis)=>!!measured.slots && axis[0] === discrete;
169
+ const axes = {
170
+ x: axisFrame(viz._xAxis, (v)=>x(v), !!viz._xTime, slots("x")),
171
+ y: axisFrame(viz._yAxis, (v)=>y(v), !!viz._yTime, slots("y"))
172
+ };
173
+ if (measured.x2Exists) axes.x2 = axisFrame(viz._x2Axis, (v)=>x(v, "x2"), !!viz._x2Time, slots("x2"));
174
+ if (measured.y2Exists) axes.y2 = axisFrame(viz._y2Axis, (v)=>y(v, "y2"), !!viz._y2Time, slots("y2"));
175
+ return {
176
+ plot,
177
+ axes
178
+ };
179
+ }
@@ -0,0 +1,83 @@
1
+ /**
2
+ Text for callouts and reference labels: the theme-aware text style, the
3
+ label wrapped to a width, and the text node that draws it.
4
+ */ import { fontFamilyStringify, textWrap } from "@d3plus/text";
5
+ import { backgroundInk } from "../viz/backgroundInk.js";
6
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
7
+ /**
8
+ The text style for an annotation: each key from `config` (through `pick`,
9
+ which may read a row), else the defaults: the chart's text color for its
10
+ background and font family, 12px, weight 400, a 1.3 line height, and
11
+ a 150px wrap width.
12
+ @param viz The chart.
13
+ @param pick Reads one style key.
14
+ */ export function annotationTextStyle(viz, pick) {
15
+ const fontSize = num(pick("fontSize"), 12);
16
+ const family = pick("fontFamily") ?? viz.schema.fontFamily;
17
+ return {
18
+ fontColor: pick("fontColor") || backgroundInk(viz),
19
+ fontFamily: typeof family === "string" || Array.isArray(family) ? fontFamilyStringify(family) : "sans-serif",
20
+ fontSize,
21
+ fontWeight: pick("fontWeight") ?? 400,
22
+ lineHeight: num(pick("lineHeight"), Math.round(fontSize * 1.3)),
23
+ maxWidth: Math.max(1, num(pick("maxWidth"), 150))
24
+ };
25
+ }
26
+ /**
27
+ Wraps `text` at the style's `maxWidth`, measuring each line.
28
+ @param text The label.
29
+ @param style The text style.
30
+ */ export function wrapAnnotationText(text, style) {
31
+ const wrap = textWrap().fontFamily(style.fontFamily).fontSize(style.fontSize).fontWeight(style.fontWeight).lineHeight(style.lineHeight).width(style.maxWidth).height(Number.MAX_SAFE_INTEGER)(text);
32
+ const lines = [];
33
+ const widths = [];
34
+ wrap.lines.forEach((line, i)=>{
35
+ if (line === "") return;
36
+ lines.push(line);
37
+ widths.push(wrap.widths[i] ?? 0);
38
+ });
39
+ return {
40
+ lines,
41
+ widths,
42
+ width: widths.length ? Math.ceil(Math.max(...widths)) : 0,
43
+ height: lines.length * style.lineHeight,
44
+ lineHeight: style.lineHeight
45
+ };
46
+ }
47
+ /**
48
+ The text node that draws a wrapped label whose block's top edge sits at
49
+ `y`, lined up against `x` by `align` (its left edge, center, or right
50
+ edge). Inert: annotations take no pointer or keyboard focus.
51
+ @param block The wrapped label.
52
+ @param style Its text style.
53
+ @param at Where the block goes, and its key.
54
+ */ export function annotationTextNode(block, style, at) {
55
+ return {
56
+ type: "text",
57
+ key: at.key,
58
+ interactive: false,
59
+ x: 0,
60
+ y: 0,
61
+ transform: {
62
+ x: at.x,
63
+ y: at.y
64
+ },
65
+ lines: block.lines.map((text, i)=>({
66
+ text,
67
+ x: 0,
68
+ y: block.lineHeight * (i + 0.5),
69
+ width: block.widths[i]
70
+ })),
71
+ font: {
72
+ family: style.fontFamily,
73
+ size: style.fontSize,
74
+ weight: style.fontWeight,
75
+ anchor: at.align,
76
+ baseline: "middle"
77
+ },
78
+ paint: {
79
+ fill: style.fontColor,
80
+ opacity: at.opacity ?? 1
81
+ }
82
+ };
83
+ }
@@ -0,0 +1,10 @@
1
+ /**
2
+ The config shapes of a Plot's callout annotations, reference lines, and
3
+ reference bands.
4
+ */ /**
5
+ A shaded span across the plot between two values: give `x` (a vertical
6
+ band) or `y` (a horizontal one) as `[start, end]`, or `x2`/`y2`. On a
7
+ category axis the band covers each end category's whole slot; on a
8
+ continuous or time axis its ends widen the axis domain, unless the user
9
+ set that end of the domain.
10
+ */ export { };