@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
@@ -0,0 +1,130 @@
1
+ /**
2
+ Circle labels on a chart: resolves each label's `labelPosition`, measures
3
+ its text, places it (see `circleLabelPlacement.ts`), and emits the labels
4
+ that sit beside their circles. Shared by Plot's point marks, Network's
5
+ nodes, and Geomap's coordinate points.
6
+
7
+ @module
8
+ */
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { Bounds } from "@d3plus/math";
11
+ import type { SceneNode } from "@d3plus/render";
12
+ import type { VizInstance } from "../viz/vizTypes.js";
13
+ import type { CircleLabelPlacement, CircleLabelBox, LabelPosition, LabelSide } from "./circleLabelPlacement.js";
14
+ /** A font to measure or wrap text in. */
15
+ export interface LabelFont {
16
+ family?: string | string[];
17
+ size: number;
18
+ weight?: string | number;
19
+ /** The line height, in pixels (default 1.2 × `size`). */
20
+ lineHeight?: number;
21
+ }
22
+ /** The box an inside label wraps in, before padding. */
23
+ export interface InsideLabelBox {
24
+ width: number;
25
+ height: number;
26
+ /** `"circle"` wraps lines as chords of the circle the box holds. */
27
+ shape?: "circle" | "square";
28
+ /** CSS-style padding inside the box (default 0). */
29
+ padding?: number | string;
30
+ }
31
+ /**
32
+ Whether `text` fits inside a box at `font.size`, wrapped the way a label
33
+ TextBox wraps it, without being cut short.
34
+ @param text The label text.
35
+ @param box The box, with its wrapping shape and padding.
36
+ @param font The font, at the smallest size that counts as fitting.
37
+ */
38
+ export declare function labelFitsInside(text: string, box: InsideLabelBox, font: LabelFont): boolean;
39
+ /**
40
+ The box a one-line label takes: its measured width, plus a pixel of slack
41
+ on each side so the TextBox drawing it never wraps it, by a line's height
42
+ plus a pixel.
43
+ */
44
+ export declare function measureLabel(text: string, font: LabelFont): {
45
+ width: number;
46
+ height: number;
47
+ };
48
+ /** The resolved `pointLabelConfig`. */
49
+ export interface PointLabelSettings {
50
+ /** The smallest font size an inside label may shrink to before it moves outside. */
51
+ fontMin: number;
52
+ /** The font size of a label beside its circle. */
53
+ fontSize: number;
54
+ /** The space between a circle's edge and a label beside it. */
55
+ padding: number;
56
+ /** The TextBox config of a label beside its circle (font, color, …). */
57
+ text: Record<string, unknown>;
58
+ }
59
+ /** Reads `pointLabelConfig`: numbers for fontMin/fontSize/padding, the rest as TextBox config. */
60
+ export declare function pointLabelSettings(viz: VizInstance): PointLabelSettings;
61
+ /** A row's `labelPosition`, with anything unrecognized read as `"auto"`. */
62
+ export declare function labelPositionOf(viz: VizInstance, d: DataPoint, i: number): LabelPosition;
63
+ /** One circle on a chart, and its label. */
64
+ export interface CircleLabelItem<K> {
65
+ /** What the result is keyed by (the scene datum or layout node). */
66
+ key: K;
67
+ /** The data row, and its index, handed to `labelPosition` and the label config. */
68
+ datum: DataPoint;
69
+ index: number;
70
+ x: number;
71
+ y: number;
72
+ r: number;
73
+ /** The label text; anything but a string or number leaves the circle unlabeled (an obstacle only). */
74
+ text?: unknown;
75
+ /** How an inside label wraps (default: the circle itself, unpadded). */
76
+ inside?: InsideLabelBox & {
77
+ font?: Pick<LabelFont, "family" | "weight">;
78
+ };
79
+ }
80
+ /** A label's placement, with the mode it was placed in and its text. */
81
+ export type CircleLabelLayout = CircleLabelPlacement & {
82
+ mode: LabelPosition;
83
+ text: string;
84
+ };
85
+ /**
86
+ Places every labeled circle's label (see `placeCircleLabels`), reading
87
+ each row's `labelPosition` and the chart's `pointLabelConfig`. An
88
+ `"auto"` label counts as fitting inside when it fits at
89
+ `pointLabelConfig.fontMin`.
90
+ @param viz The chart.
91
+ @param items Every circle, labeled or not.
92
+ @param bounds The box labels must stay in, in the circles' space.
93
+ */
94
+ export declare function layoutCircleLabels<K>(viz: VizInstance, items: readonly CircleLabelItem<K>[], bounds: Bounds): Map<K, CircleLabelLayout>;
95
+ /** The text anchor that keeps a label flush against its circle. */
96
+ export declare function sideAnchor(side: LabelSide): "start" | "middle" | "end";
97
+ /** A label to draw beside its circle. */
98
+ export interface OutsideLabel {
99
+ /** The id the label's scene key is built from (`${id}_0`). */
100
+ id: string;
101
+ /** The scene datum the label carries (hover and active match on it). */
102
+ datum: DataPoint;
103
+ text: string;
104
+ side: LabelSide;
105
+ box: CircleLabelBox;
106
+ }
107
+ /**
108
+ Text nodes for labels placed beside their circles: one line each, in the
109
+ chart's ink (`backgroundInk`) at `pointLabelConfig.fontSize`, flush
110
+ against the circle, and inert to the pointer.
111
+ @param viz The chart.
112
+ @param labels The labels, each with its placed box.
113
+ @param config TextBox config layered under `pointLabelConfig` (such as a
114
+ `fontOpacity` that follows the shapes).
115
+ */
116
+ export declare function emitOutsideLabels(viz: VizInstance, labels: readonly OutsideLabel[], config?: Record<string, unknown>): SceneNode[];
117
+ /**
118
+ Splits laid-out labels into the ones drawn beside their circles, with the
119
+ id and scene datum each takes.
120
+ */
121
+ export declare function outsideLabels<K>(layout: Map<K, CircleLabelLayout>, describe: (key: K) => {
122
+ id: string;
123
+ datum: DataPoint;
124
+ }): OutsideLabel[];
125
+ /**
126
+ The font size floor of an inside label: `pointLabelConfig.fontMin` when it
127
+ was placed in `"auto"` mode (so it never shrinks below the size it was
128
+ judged to fit at), else its own.
129
+ */
130
+ export declare function insideFontMin(viz: VizInstance, placed: CircleLabelLayout | undefined, own: number): number;
@@ -41,3 +41,12 @@ export declare function colorScaleBucketPredicate(viz: VizInstance, bucketColor:
41
41
  colorScale.
42
42
  */
43
43
  export declare function activeBucketColors(viz: VizInstance, predicate: (d: DataPoint, i: number) => boolean): Set<unknown> | null;
44
+ /**
45
+ The first of the colorScale's rows in each bucket, keyed by bucket color,
46
+ with its index: the row a bucket's swatch takes the chart's shape styles
47
+ from. Null without a colorScale to read.
48
+ */
49
+ export declare function colorScaleBucketRows(viz: VizInstance): Map<unknown, {
50
+ row: DataPoint;
51
+ i: number;
52
+ }> | null;
@@ -0,0 +1,32 @@
1
+ import type { SceneEvent, SceneNode } from "@d3plus/render";
2
+ import type { VizInstance } from "../viz/vizTypes.js";
3
+ /**
4
+ The colorScale value of a hovered scene node: its datum unwrapped to the
5
+ source row (as the shapes' fill unwraps it), read through the chart's
6
+ `colorScale`. Null for chrome (legend, axes, the colorScale itself), a
7
+ node without a row, or a row without a finite value.
8
+ @param viz The chart.
9
+ @param node The hovered scene node.
10
+ */
11
+ export declare function colorScaleHoverValue(viz: VizInstance, node: SceneNode | undefined): number | null;
12
+ /**
13
+ Updates the colorScale's hover mark for a pointer event, repainting only
14
+ when the marked value changes. Moves are ignored while a transition is
15
+ in flight; leaving the chart always clears the mark.
16
+ @param viz The chart.
17
+ @param event The pointer event.
18
+ */
19
+ export declare function handleColorScaleHover(viz: VizInstance, event: SceneEvent): void;
20
+ /**
21
+ The swatch to keep lit for the colorScale's hovered value when the chart
22
+ has no hover predicate of its own (shape hover is off, as on Geomap,
23
+ Calendar, or past `dataCutoff`): the value's bucket color, and the
24
+ opacity the other swatches dim to (`hoverOpacity`, or 0.5 when that is
25
+ 1). Null when the chart's own hover drives the highlight, nothing is
26
+ marked, `hoverMark` is off, or the scale isn't drawn as swatches.
27
+ @param viz The chart.
28
+ */
29
+ export declare function hoveredSwatch(viz: VizInstance): {
30
+ color: unknown;
31
+ dimOpacity: number;
32
+ } | null;
@@ -0,0 +1,35 @@
1
+ /**
2
+ The value the chart's colorScale reads from a row: the chart's own
3
+ `colorScale` for its data rows, and, on the node-link charts, each link's
4
+ numeric `linkColor` value for its link rows (see `linkColorScaleRows`).
5
+ */
6
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ type Accessor = (d: DataPoint, i: number) => unknown;
9
+ /** Whether `v` is a number the colorScale can place. */
10
+ export declare function isScaleValue(v: unknown): v is number;
11
+ /**
12
+ Notes a drawn link datum's numeric `linkColor` value, so the colorScale
13
+ reads it for that link (hovering it marks the value on the colorScale,
14
+ and hovering a colorScale bucket highlights the links in it).
15
+ */
16
+ export declare function noteLinkValue(viz: VizInstance, datum: object, value: number): void;
17
+ /**
18
+ The `links` entries whose `linkColor` value is a number: the rows the
19
+ chart's colorScale adds to its own. Empty when `linkColor` isn't a key or
20
+ accessor, or no link has a numeric value.
21
+ */
22
+ export declare function linkColorScaleRows(viz: VizInstance): DataPoint[];
23
+ /**
24
+ The accessor the chart's colorScale reads values with: the chart's own
25
+ `colorScale`, which also reads each link row's numeric `linkColor`
26
+ value when it has links colored by number. Undefined when neither
27
+ gives the colorScale anything to show.
28
+ */
29
+ export declare function colorScaleValue(viz: VizInstance): Accessor | undefined;
30
+ /**
31
+ The color the chart's colorScale gives `value`: the scale's color for it,
32
+ or the scale's last color while it has no domain yet.
33
+ */
34
+ export declare function colorScaleColor(viz: VizInstance, value: unknown): unknown;
35
+ export {};
@@ -0,0 +1,105 @@
1
+ /**
2
+ Arrowheads on curved edge ends. On a curve, the tangent at the tip and
3
+ the curve a few pixels back point different ways, so a head aimed along
4
+ the tangent leaves the stroke's end off its axis. Here a head is aimed
5
+ along the chord from where its base sits on the path to its tip, and the
6
+ stroke follows the path up to the base, then runs straight along that
7
+ chord to end inside the head (see `arrowTrim`). The join at the base is
8
+ under the head, so the stroke reads smooth.
9
+
10
+ The path is a polyline (a sampled curve, or projected points such as a
11
+ map's) or a cubic Bézier curve.
12
+ */
13
+ import type { DataPoint } from "@d3plus/data";
14
+ import type { SceneNode } from "@d3plus/render";
15
+ import type { EdgeArrowTrims } from "./edgeArrows.js";
16
+ import type { Point } from "./polyline.js";
17
+ type Cubic = [Point, Point, Point, Point];
18
+ /** One arrowed end of an edge: its head's tip and direction, its base on the path, and where the stroke ends. */
19
+ export interface ArrowedEnd {
20
+ tip: Point;
21
+ /** The head's direction, from its base to its tip, in radians. */
22
+ angle: number;
23
+ /** Where the head's base sits on the path. */
24
+ base: Point;
25
+ /** Where the stroke ends: on the head's axis, `trim` back from its tip. */
26
+ cut: Point;
27
+ }
28
+ /**
29
+ The point `distance` pixels back along a polyline from its last point
30
+ (its first point when the polyline is shorter than that). Pass the
31
+ points reversed for a distance from the first point.
32
+ */
33
+ export declare function pathPointBack(points: readonly Point[], distance: number): Point;
34
+ /** A cubic Bézier curve as a polyline of `steps` chords. */
35
+ export declare function cubicPolyline(curve: Cubic, steps?: number): Point[];
36
+ /** The direction (radians) of the chord from `base` to `tip`. */
37
+ export declare function chordAngle(base: Point, tip: Point): number;
38
+ /**
39
+ A head at `tip` aimed along the chord from `base` (where its base sits
40
+ on the path), and the stroke's end `trim` back from the tip on that
41
+ chord.
42
+ */
43
+ export declare function arrowAlongChord(tip: Point, base: Point, trim: number): ArrowedEnd;
44
+ /**
45
+ A cubic edge's visible stroke and its arrowed ends: each head's tip sits
46
+ `tipBack` pixels back along the curve from its end, its base `size`
47
+ further back, and the stroke runs along the curve between the bases,
48
+ then straight along each head's axis to its `cut`.
49
+ @param curve The edge, from its source end to its target end.
50
+ @param trims The edge's arrow ends, size, and stroke trims (see `edgeArrowTrims`).
51
+ @param tipBack How far back along the curve each end's tip sits.
52
+ */
53
+ export declare function cubicArrowEdge(curve: Cubic, trims: EdgeArrowTrims, tipBack?: {
54
+ source: number;
55
+ target: number;
56
+ }): {
57
+ d: string;
58
+ source?: ArrowedEnd;
59
+ target?: ArrowedEnd;
60
+ };
61
+ /**
62
+ A polyline edge's visible stroke and its arrowed ends: each head's tip
63
+ sits `tipBack` pixels back along the polyline from its end, its base
64
+ `size` further back, and the stroke follows the polyline between the
65
+ bases, then runs straight along each head's axis to its `cut`.
66
+ @param points The edge, from its source end to its target end: one
67
+ polyline, or the runs of a path cut into pieces (a map projection's),
68
+ whose first run starts at the source and last run ends at the target.
69
+ @param trims The edge's arrow ends, size, and stroke trims (see `edgeArrowTrims`).
70
+ @param tipBack How far back along the polyline each end's tip sits.
71
+ */
72
+ export declare function polylineArrowEdge(points: Point[] | Point[][], trims: EdgeArrowTrims, tipBack?: {
73
+ source: number;
74
+ target: number;
75
+ }): {
76
+ d: string;
77
+ source?: ArrowedEnd;
78
+ target?: ArrowedEnd;
79
+ };
80
+ /**
81
+ A path `body` (starting with its own `M`) extended straight along each
82
+ arrowed end's axis: from the source head's `cut` to the body's start,
83
+ and from the body's end to the target head's `cut`.
84
+ */
85
+ export declare function chordEndsPathD(body: string, source?: ArrowedEnd, target?: ArrowedEnd): string;
86
+ /**
87
+ The head nodes for an edge's arrowed ends, keyed `${keyPrefix}-t` and
88
+ `${keyPrefix}-s`, or by `keys`.
89
+ */
90
+ export declare function chordArrowNodes(opts: {
91
+ ends: {
92
+ source?: ArrowedEnd;
93
+ target?: ArrowedEnd;
94
+ };
95
+ size: number;
96
+ datum: DataPoint;
97
+ keyPrefix: string;
98
+ keys?: {
99
+ source: string;
100
+ target: string;
101
+ };
102
+ fill?: string;
103
+ opacity?: number;
104
+ }): SceneNode[];
105
+ export {};
@@ -1,5 +1,6 @@
1
1
  /**
2
- Shared arrowhead geometry for edge charts (Network, Rings, Sankey).
2
+ Shared arrowhead geometry for edge charts (Network, Rings, ArcDiagram,
3
+ Geomap, Gantt).
3
4
 
4
5
  Arrowheads are drawn as filled-triangle `path` scene nodes rather than SVG
5
6
  `marker-end`, because d3plus renders to both SVG and Canvas and Canvas has no
@@ -42,11 +43,81 @@ export declare function straightArrowTip(fromX: number, fromY: number, toX: numb
42
43
  y: number;
43
44
  angle: number;
44
45
  };
46
+ /**
47
+ The arrowhead size for an edge drawn `strokeWidth` pixels wide when
48
+ `arrowSize` isn't set: three times the stroke for thin edges, growing no
49
+ larger than 12 pixels from a 4px stroke on, but never under 1.5 times the
50
+ stroke (so the head stays wider than its line), and at least 6 pixels.
51
+ */
52
+ export declare function defaultArrowSize(strokeWidth: number): number;
45
53
  /**
46
54
  Resolve the arrowhead size from the `arrowSize` config (a number or per-edge
47
- accessor), falling back to a size derived from the edge's stroke width.
55
+ accessor), falling back to `defaultArrowSize` for the edge's stroke width.
48
56
  */
49
57
  export declare function arrowSizeFor(arrowSize: unknown, d: DataPoint, i: number, strokeWidth: number): number;
58
+ /**
59
+ How far back from an arrowhead's tip its edge's stroke ends, so the
60
+ stroke's square (butt) end sits inside the head: the head is `1.2 × d`
61
+ wide at `d` pixels from its tip, so this is where it is as wide as the
62
+ stroke, at least halfway along the head and at most its base.
63
+ */
64
+ export declare function arrowTrim(size: number, strokeWidth: number): number;
65
+ /** An edge's arrowheads: which ends carry one, their size, and the stroke trim at each. */
66
+ export interface EdgeArrowTrims {
67
+ ends: ArrowEnds;
68
+ size: number;
69
+ /** How far the stroke ends back from each end's arrow tip (0 without an arrow). */
70
+ source: number;
71
+ target: number;
72
+ }
73
+ /** Resolves an edge's `arrows`/`arrowSize` into its arrowhead ends, size, and stroke trims. */
74
+ export declare function edgeArrowTrims(opts: {
75
+ arrows: ArrowValue;
76
+ arrowSize: unknown;
77
+ strokeWidth?: number;
78
+ datum: DataPoint;
79
+ i: number;
80
+ }): EdgeArrowTrims;
81
+ type Point = [number, number];
82
+ /**
83
+ A straight segment from `a` to `b`, shortened by `start` pixels at `a`
84
+ and `end` pixels at `b`. When the two overlap, it collapses to the point
85
+ between them.
86
+ */
87
+ export declare function trimSegment(a: Point, b: Point, start: number, end: number): [Point, Point];
88
+ /**
89
+ A cubic Bézier curve shortened along its own length by `start` pixels at
90
+ its first end and `end` pixels at its last: the same curve, cut short,
91
+ so the ends keep their direction. When the two cuts meet, it collapses
92
+ to the point where they do.
93
+ @param steps The number of chords the curve's length is measured in.
94
+ */
95
+ export declare function trimCubic(curve: [Point, Point, Point, Point], start: number, end: number, steps?: number): [Point, Point, Point, Point];
96
+ /** A cubic Bézier curve's SVG path. */
97
+ export declare function cubicPathD([p0, p1, p2, p3]: [
98
+ Point,
99
+ Point,
100
+ Point,
101
+ Point
102
+ ]): string;
103
+ /**
104
+ The visible stroke of a straight, center-to-center edge between nodes
105
+ of radius `source.r` and `target.r`: cut short inside each arrowhead
106
+ (whose tip sits a pixel off the node's edge, see `straightArrowTip`).
107
+ The full center-to-center path stays the edge's hit area.
108
+ */
109
+ export declare function straightEdgeD(source: {
110
+ x: number;
111
+ y: number;
112
+ r?: number;
113
+ }, target: {
114
+ x: number;
115
+ y: number;
116
+ r?: number;
117
+ }, trims: {
118
+ source: number;
119
+ target: number;
120
+ }): string;
50
121
  /**
51
122
  Emit arrowhead nodes for a straight, center-to-center edge between two nodes
52
123
  (radii `source.r`/`target.r`), insetting each tip to the node boundary.
@@ -90,3 +161,4 @@ export interface ArrowNodeOpts {
90
161
  arrow paired with its edge.
91
162
  */
92
163
  export declare function arrowNode(opts: ArrowNodeOpts): SceneNode;
164
+ export {};
@@ -0,0 +1,86 @@
1
+ /**
2
+ Force-directed edge bundling (Holten & van Wijk, 2009). Each straight
3
+ edge is split into points, and each point is pulled toward the matching
4
+ points of the edges compatible with it (edges running the same way, at
5
+ a similar length, near it, and in view of it), while a spring along the
6
+ edge keeps it smooth. Over a few cycles the points double and the step
7
+ halves, so edges gather into bundles that fan out at their ends.
8
+
9
+ Pure geometry in screen space. The simulation runs on the edges scaled
10
+ to a fixed size, so its settings behave the same at any chart size, and
11
+ a cache keyed by the edges' positions and the settings lets a redraw
12
+ reuse it.
13
+ */
14
+ import type { Point } from "./polyline.js";
15
+ /** An edge as its two ends, source then target. */
16
+ export type Segment = readonly [Point, Point];
17
+ /** The `linkBundleConfig` settings (see `EDGE_BUNDLE_DEFAULTS`). */
18
+ export interface EdgeBundleOptions {
19
+ /** How closely a path keeps to its bundle: 0 draws it straight, 1 fully bundled. */
20
+ strength: number;
21
+ /** How many times the points along each edge double. */
22
+ cycles: number;
23
+ /** Simulation steps in the first cycle; each later cycle takes two thirds as many. */
24
+ iterations: number;
25
+ /** The compatibility (0–1) two edges need to pull on each other. */
26
+ compatibility: number;
27
+ /** Whether the bundled points are joined by a smooth curve (else by straight lines). */
28
+ smoothing: boolean;
29
+ }
30
+ export declare const EDGE_BUNDLE_DEFAULTS: EdgeBundleOptions;
31
+ /** |cos| of the angle between two edges: 1 parallel, 0 perpendicular. */
32
+ export declare function angleCompatibility(p: Segment, q: Segment): number;
33
+ /** How alike two edges' lengths are: 1 for equal lengths, toward 0 as they differ. */
34
+ export declare function scaleCompatibility(p: Segment, q: Segment): number;
35
+ /** How near two edges' midpoints are, relative to their average length. */
36
+ export declare function positionCompatibility(p: Segment, q: Segment): number;
37
+ /** The smaller of each edge's visibility from the other (see Holten & van Wijk). */
38
+ export declare function visibilityCompatibility(p: Segment, q: Segment): number;
39
+ /** Two edges' compatibility, 0–1: the product of the four measures. */
40
+ export declare function edgeCompatibility(p: Segment, q: Segment): number;
41
+ /**
42
+ The largest ratio between two edges' lengths whose scale compatibility
43
+ still reaches `threshold` (Infinity for a threshold of 0 or less).
44
+ */
45
+ export declare function maxLengthRatio(threshold: number): number;
46
+ /**
47
+ Each edge's compatible edges, as compressed rows: edge `e`'s neighbors
48
+ are `neighbors[offsets[e]]` up to `neighbors[offsets[e + 1]]`, and each
49
+ one's `weights` entry is its compatibility, negative when the two edges
50
+ run opposite ways. Only pairs reaching `threshold` are kept; a grid over
51
+ the edges' midpoints skips pairs too far apart to reach it.
52
+ */
53
+ export interface CompatibilityGraph {
54
+ offsets: Int32Array;
55
+ neighbors: Int32Array;
56
+ weights: Float32Array;
57
+ }
58
+ /** The compatible pairs among `edges` (see `CompatibilityGraph`). */
59
+ export declare function compatibilityGraph(edges: readonly Segment[], threshold: number): CompatibilityGraph;
60
+ /**
61
+ `segments + 1` points spaced evenly along a polyline's length, from its
62
+ first point to its last.
63
+ */
64
+ export declare function subdividePolyline(points: Point[], segments: number): Point[];
65
+ /** Cached simulations, by `edgeBundleKey`, and how many have run. */
66
+ export interface EdgeBundleCache {
67
+ entries: Map<string, Point[][]>;
68
+ runs: number;
69
+ }
70
+ /** A new, empty cache for `bundleEdges`. */
71
+ export declare function edgeBundleCache(): EdgeBundleCache;
72
+ /** The settings with every missing or invalid entry at its default. */
73
+ export declare function edgeBundleOptions(options?: Partial<EdgeBundleOptions>): EdgeBundleOptions;
74
+ /**
75
+ The cache key for bundling `edges` with `options`: the edges' ends to a
76
+ tenth of a pixel, and the settings the simulation reads.
77
+ */
78
+ export declare function edgeBundleKey(edges: readonly Segment[], options: EdgeBundleOptions): string;
79
+ /**
80
+ Bundles `edges` (see the module notes) and returns each one's path as a
81
+ polyline from its source to its target: the simulated points pulled
82
+ toward the straight edge by `1 - strength`, and joined by a smooth
83
+ curve when `smoothing` is on. An edge of no length stays as its two
84
+ ends.
85
+ */
86
+ export declare function bundleEdges(edges: readonly Segment[], options?: Partial<EdgeBundleOptions>, cache?: EdgeBundleCache): Point[][];
@@ -0,0 +1,29 @@
1
+ /**
2
+ Turns a bundled edge's control points into the polyline it draws as:
3
+ straightened by the bundle's strength (as d3's `curveBundle.beta`
4
+ does), then optionally rounded into a B-spline and thinned to the
5
+ points that shape it.
6
+ */
7
+ import type { Point } from "./polyline.js";
8
+ /**
9
+ Each point pulled toward the straight line between the polyline's ends,
10
+ to `strength` of the way from that line (0) to where it was (1).
11
+ */
12
+ export declare function straightenPolyline(points: Point[], strength: number): Point[];
13
+ /**
14
+ The uniform cubic B-spline through a polyline's control points, ends
15
+ clamped so it starts and ends on them, sampled about every `spacing`
16
+ pixels (between 1 and 8 samples a span).
17
+ */
18
+ export declare function bsplinePolyline(points: Point[], spacing?: number): Point[];
19
+ /**
20
+ The points of a polyline that keep its shape to within `tolerance`
21
+ pixels (Ramer–Douglas–Peucker), its ends always kept.
22
+ */
23
+ export declare function simplifyPolyline(points: Point[], tolerance: number): Point[];
24
+ /**
25
+ A bundled edge's drawn polyline: its control points straightened by
26
+ `strength`, rounded into a B-spline when `smoothing` is on, and thinned
27
+ to within a quarter pixel.
28
+ */
29
+ export declare function smoothBundle(points: Point[], strength: number, smoothing: boolean): Point[];
@@ -13,7 +13,8 @@
13
13
 
14
14
  Idempotent: calling it again returns the existing nodes. Mutates the
15
15
  viz instance with `_container` / `_zoomGroup` (and the Network
16
- variant also wires the hitArea click handler).
16
+ variant also wires the hitArea click handler, and `_backgroundClick` for
17
+ the Canvas renderer).
17
18
 
18
19
  The helper stays as long as d3-zoom owns event binding and Geomap's
19
20
  tile-loading mounts `<g>` elements directly. An eventual fully
@@ -39,5 +40,22 @@ interface SetupOpts {
39
40
  /** Geomap-only: ocean fill color (also used as the svg background). */
40
41
  ocean?: string;
41
42
  }
43
+ /**
44
+ Clears a Network or ArcDiagram's click focus: its active nodes and its
45
+ zoom. Returns whether there was a focus to clear.
46
+ @param viz The chart.
47
+ */
48
+ export declare function clearGraphFocus(viz: Viz): boolean;
49
+ /**
50
+ Whether a point lies within an area, edges included.
51
+ @param point The point.
52
+ @param area The area.
53
+ */
54
+ export declare function withinArea([x, y]: [number, number], area: {
55
+ x: number;
56
+ y: number;
57
+ width: number;
58
+ height: number;
59
+ }): boolean;
42
60
  export declare function ensureZoomDom(viz: Viz, opts: SetupOpts): void;
43
61
  export {};
@@ -126,6 +126,14 @@ export declare function zoomControlsInset(viz: VizInstance, top: number, right:
126
126
  or content starts below the panel's height.
127
127
  */
128
128
  export declare function topLeftControlsInset(viz: VizInstance, top: number, left: number): number;
129
+ /**
130
+ How far a left or right legend/colorScale starting `top` px down the
131
+ chart, its outer edge `edge` px in from the chart's edge on that side,
132
+ must drop to start below the corner control panel on its side: the
133
+ top-left panel for `"left"`, the zoom controls for `"right"`. Zero when
134
+ that panel isn't showing, is narrower than `edge`, or ends above `top`.
135
+ */
136
+ export declare function sideControlsDrop(viz: VizInstance, position: string | false, top: number, edge: number): number;
129
137
  /**
130
138
  The combined left+right corner-panel insets for content starting `top`
131
139
  px down the chart, plus the single symmetric amount CENTERED content
@@ -3,7 +3,8 @@ import type { FeatureModule } from "./features.js";
3
3
  import type Legend from "../../components/Legend/Legend.js";
4
4
  import type { VizInstance } from "../viz/vizTypes.js";
5
5
  import type { InsetOrient } from "./insetState.js";
6
- interface LegendData {
6
+ /** The legend's rolled-up entries, with the key and paint accessors its render reuses. */
7
+ export interface LegendData {
7
8
  legendData: DataPoint[];
8
9
  legendKey: (d: DataPoint, i: number) => string;
9
10
  getAttr: (d: DataPoint, i: number, attr: string) => string;
@@ -13,7 +14,8 @@ interface LegendData {
13
14
  `viz._legendDepth` (the lowest groupBy level whose values are unique) and
14
15
  `viz._legendCategories` (see `legendCategory.ts`), then sorts it.
15
16
  Returns the `legendData` array plus the `fill`/`getAttr` accessors the
16
- render step reuses.
17
+ render step reuses. A legend set to a constant false (`legend(false)`)
18
+ gets no entries, and its depth and categories stay as they were.
17
19
  */
18
20
  export declare function buildLegendData(viz: VizInstance): LegendData;
19
21
  /**
@@ -47,4 +49,3 @@ export declare function paintLegendInset(viz: VizInstance, orient: InsetOrient,
47
49
  scene composition for Legend happens via Viz.toScene's `components` array.
48
50
  */
49
51
  export declare const legendFeature: FeatureModule;
50
- export {};
@@ -0,0 +1,34 @@
1
+ /**
2
+ How the legend groups rows into entries: by the color each row encodes,
3
+ its opacity and its texture.
4
+ */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ import type { VizInstance } from "../viz/vizTypes.js";
7
+ /** The functions that read a row's legend paint and key. */
8
+ export interface LegendKeys {
9
+ /** A paint attribute (`fill`, `opacity`, …) from the row's shapeConfig; a Line's fill is its stroke. */
10
+ getAttr: (d: DataPoint, i: number, attr: string) => string;
11
+ /** The row's color encoding input, or undefined without a color accessor. */
12
+ colorOf: (d: DataPoint, i: number) => unknown;
13
+ /** The row's entry key, given its color encoding. */
14
+ keyOf: (d: DataPoint, i: number, c: unknown) => string;
15
+ }
16
+ /**
17
+ The legend's key functions for a chart.
18
+ @param viz The chart.
19
+ */
20
+ export declare function legendKeys(viz: VizInstance): LegendKeys;
21
+ /**
22
+ The rows the legend rolls up: `_legendData`, less the rows a colorScale
23
+ colors.
24
+ @param viz The chart.
25
+ */
26
+ export declare function legendRows(viz: VizInstance): DataPoint[];
27
+ /**
28
+ How many entries the legend has (the number `buildLegendData` rolls its
29
+ rows into), counting no further than `limit + 1`: enough to tell whether
30
+ there are more than `limit`. A legend set to a constant false has none.
31
+ @param viz The chart.
32
+ @param limit The count past which to stop.
33
+ */
34
+ export declare function legendEntryCount(viz: VizInstance, limit?: number): number;