@d3plus/core 4.10.0 → 4.12.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 (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -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 +176 -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 +101 -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 +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  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/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,36 @@
1
+ /**
2
+ Geomap's links as scene nodes: each link's path (ending inside its
3
+ arrowheads), a wider transparent hit path over the whole path so thin
4
+ links are easy to point at, its arrowheads, and its label. The links sit above the topojson shapes and below the coordinate
5
+ points, so a link runs into the point at its end and the points stay on
6
+ top to hover.
7
+ */
8
+ import type { SceneNode } from "@d3plus/render";
9
+ import type { LabelCircle } from "../features/circleLabelPlacement.js";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ import type { FlowLink } from "./flowLinks.js";
12
+ /** A link's scene key. */
13
+ export declare const flowLinkKey: (link: FlowLink) => string;
14
+ /**
15
+ The color of links `linkColor` doesn't color: halfway between the
16
+ chart's background and its text color, a gray that reads over both the
17
+ land and the water of a light or dark map.
18
+ */
19
+ export declare function flowLinkGray(viz: VizInstance): string;
20
+ /**
21
+ A link's visible stroke and its arrowheads. Each head's tip sits on the
22
+ path, clear of the point at its end, and is aimed along the chord from
23
+ its base (`size` further back along the path) to its tip; the stroke
24
+ follows the path to each base, then runs straight along that chord to
25
+ end inside the head (see `polylineArrowEdge`). A head goes only on an
26
+ end the projection draws. `scale` widens the stroke (see
27
+ `emphasizedArrowEdge`).
28
+ */
29
+ export declare function flowArrowEdge(viz: VizInstance, link: FlowLink, fill: string | undefined, scale?: number): {
30
+ d: string;
31
+ arrows: SceneNode[];
32
+ };
33
+ /** The links, their hit paths, and their arrowheads, in that order. */
34
+ export declare function emitFlowLinks(viz: VizInstance, links: FlowLink[]): SceneNode[];
35
+ /** The link labels, at the middle of each link, clear of the points. */
36
+ export declare function emitFlowLabels(viz: VizInstance, links: FlowLink[], circles: LabelCircle[]): SceneNode[];
@@ -0,0 +1,20 @@
1
+ /**
2
+ Geomap's link interaction. Hovering a link emphasizes it and the marks
3
+ at its ends; hovering a point or shape that ends a link emphasizes its
4
+ links. Clicking a link focuses it (the rest of the map dims) and zooms
5
+ to it; clicking it again, any other mark, or the open ocean clears the
6
+ focus. Also installs `links`, which loads its rows like `topojson`.
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { FocusBox } from "../features/linkFocus.js";
10
+ import type { LinkDatum } from "../features/linkInteraction.js";
11
+ import type { VizInstance } from "../viz/vizTypes.js";
12
+ /** The box around a drawn link, or null when it isn't drawn. */
13
+ export declare function flowLinkBox(viz: VizInstance, d: LinkDatum): FocusBox | null;
14
+ /**
15
+ What hovering `d` emphasizes: a link and its two ends, or a mark that
16
+ ends links and those links. Null for anything else.
17
+ */
18
+ export declare function flowHoverPredicate(viz: VizInstance, d: DataPoint): ((h: DataPoint, i: number) => boolean) | null;
19
+ /** Installs `links` and the link hover, click, and focus handlers. */
20
+ export declare function setupGeomapLinks(viz: VizInstance): void;
@@ -0,0 +1,7 @@
1
+ /**
2
+ The config Geomap's links add: `links` and how they are sized, curved,
3
+ bundled, colored, labeled, and pointed, and the tooltips that read them.
4
+ */
5
+ import type { ConfigField } from "../../fluent.js";
6
+ /** Geomap's link fields. */
7
+ export declare function geomapLinkFields(): ConfigField[];
@@ -0,0 +1,91 @@
1
+ /**
2
+ Pure geometry for Geomap's links: which place a link end names, the
3
+ point a region's link ends at, and each link's path, a great circle
4
+ through the map's projection, optionally lifted into an arc.
5
+ */
6
+ import type { GeoPermissibleObjects } from "d3-geo";
7
+ import type { Point } from "../features/polyline.js";
8
+ export { polylineAt, polylineBox, polylineLength, polylineMidpoint, polylinePath, trimPolyline, } from "../features/polyline.js";
9
+ /** A point in the map's projected pixel space. */
10
+ export type { Point };
11
+ /** A geographic coordinate, `[longitude, latitude]` (d3's order). */
12
+ export type LonLat = [number, number];
13
+ /** Projects a coordinate to pixels, or null where the projection has none. */
14
+ export type Projector = (p: LonLat) => Point | null | undefined;
15
+ /** d3-geo's path generator for the map's projection. */
16
+ export type GeoPathFn = (object: GeoPermissibleObjects) => string | null;
17
+ /** A link's drawn path and the polyline its label follows. */
18
+ export interface FlowArc {
19
+ /** The path's `d`, from source to target (see `pathRuns` for its runs). */
20
+ d: string;
21
+ /**
22
+ The path as projected points, from source to target, or null when the
23
+ projection cuts the path (past a globe's horizon, or a clip edge).
24
+ */
25
+ points: Point[] | null;
26
+ }
27
+ /** Whether `v` is a `[longitude, latitude]` pair of finite numbers. */
28
+ export declare function isLonLat(v: unknown): v is LonLat;
29
+ /**
30
+ A row's `point` value as a coordinate: a pair whose two entries read as
31
+ finite numbers (CSV data gives strings), or null.
32
+ */
33
+ export declare function toLonLat(v: unknown): LonLat | null;
34
+ /**
35
+ The point a link to a geographic feature ends at: the centroid of the
36
+ feature's largest polygon (so a country's link meets its mainland, not a
37
+ point between its islands), or of the whole geometry when it isn't a
38
+ MultiPolygon. Null when the feature has no geometry.
39
+ */
40
+ export declare function featureAnchor(feature: unknown): LonLat | null;
41
+ /** `count + 1` evenly spaced points along the great circle from `a` to `b`. */
42
+ export declare function greatCircle(a: LonLat, b: LonLat, count: number): LonLat[];
43
+ /**
44
+ Lifts a polyline into an arc: each point moves off the straight line
45
+ between its ends, most at the middle, by `curve` times that line's
46
+ length, to the left of the direction of travel (right for a negative
47
+ `curve`). The ends stay put.
48
+ */
49
+ export declare function liftPolyline(points: Point[], curve: number): Point[];
50
+ /**
51
+ Whether d3-geo drew a line as one unbroken run from `a` to `b`: one
52
+ subpath, starting and ending (within a pixel) at the two points.
53
+ */
54
+ export declare function unbrokenPath(d: string, a: Point, b: Point): boolean;
55
+ /**
56
+ Whether the projection cuts the great circle from `a` to `b` (across
57
+ the antimeridian, between geoAlbersUsa's insets, past a globe's horizon,
58
+ or anywhere else it breaks or shortens the line), so it isn't drawn as
59
+ one run from one end to the other.
60
+ */
61
+ export declare function greatCircleCut(a: LonLat, b: LonLat, projection: Projector, path: GeoPathFn): boolean;
62
+ /**
63
+ A link drawn on the screen between two projected points: the straight
64
+ line between them, bowed by `curve` the way `liftPolyline` bows it.
65
+ */
66
+ export declare function screenArc(pa: Point, pb: Point, curve?: number): FlowArc;
67
+ /**
68
+ A link's path between two coordinates: the great circle between them
69
+ through the map's projection, lifted into an arc by `curve` (see
70
+ `liftPolyline`) when the projection draws it unbroken.
71
+
72
+ When the projection cuts the great circle, a flat map draws the link on
73
+ the screen between its two ends instead (see `screenArc`), so it
74
+ crosses the map rather than leaving by one edge and coming back by the
75
+ other. A globe (see `clipsToCircle`), or a flat map hiding one of the
76
+ ends, draws it as d3-geo clips it, without the lift. Null when the two
77
+ places are the same or the projection hides the whole path.
78
+ */
79
+ export declare function flowArc(a: LonLat, b: LonLat, projection: Projector, path: GeoPathFn, curve?: number): FlowArc | null;
80
+ /**
81
+ The runs of a path's `d` made of moves and lines (as d3-geo draws a
82
+ line, and `polylinePath` writes one): one polyline per `M`.
83
+ */
84
+ export declare function pathRuns(d: string): Point[][];
85
+ /**
86
+ Whether a projection clips the sphere to a circle (a globe, or any
87
+ projection with a `clipAngle`), where a bowed arc would leave the disc.
88
+ */
89
+ export declare function clipsToCircle(projection: unknown): boolean;
90
+ /** Whether the projection draws a coordinate, read through its clipping stream. */
91
+ export declare function coordinateVisible(path: GeoPathFn, coord: LonLat): boolean;
@@ -0,0 +1,97 @@
1
+ /**
2
+ Geomap's `links`: resolves each link's two ends to places on the map,
3
+ sizes the links from `linkSize`, and shapes each one's path.
4
+
5
+ A link end is either a `[longitude, latitude]` pair, drawn to that
6
+ coordinate, or an id (a string, a number, or an object with an `id`)
7
+ naming a row of the chart's data or a topojson feature. An id ends at
8
+ its row's coordinate point when the row has one (`point`), and otherwise
9
+ at the centroid of its topojson shape. Links with an end that names
10
+ nothing on the map are left out.
11
+ */
12
+ import type { DataPoint } from "@d3plus/data";
13
+ import type { LinkDatum, LinkEnd } from "../features/linkInteraction.js";
14
+ import type { VizInstance } from "../viz/vizTypes.js";
15
+ import type { GeoPathFn, LonLat, Point, Projector } from "./flowGeometry.js";
16
+ /** One end of a drawn link: the place it names, and the mark drawn there. */
17
+ export interface FlowEnd extends LinkEnd {
18
+ coord: LonLat;
19
+ /** The mark at the end: a coordinate point, a topojson shape, or none. */
20
+ shape?: "Circle" | "Path";
21
+ /** The radius of the point at the end, or 0. */
22
+ r: number;
23
+ }
24
+ /** A link as Geomap draws it. */
25
+ export interface FlowLink {
26
+ datum: LinkDatum;
27
+ /** The link's index in `links`. */
28
+ index: number;
29
+ source: FlowEnd;
30
+ target: FlowEnd;
31
+ /** The stroke width, in pixels. */
32
+ size: number;
33
+ d: string;
34
+ /** The path as projected points, or null where the projection cuts it. */
35
+ points: Point[] | null;
36
+ /** Where the source is drawn, or null when the projection hides it. */
37
+ sourceAt: Point | null;
38
+ /** Where the target is drawn, or null when the projection hides it. */
39
+ targetAt: Point | null;
40
+ /** The box around the drawn path. */
41
+ box: [Point, Point];
42
+ }
43
+ /** A drawn topojson shape, as Geomap's layout lists them. */
44
+ interface TopoRow {
45
+ data?: DataPoint;
46
+ feature: unknown;
47
+ id: string | number;
48
+ }
49
+ /** What `geomapFlowLinks` reads from Geomap's layout. */
50
+ export interface FlowLayoutInput {
51
+ pointData: DataPoint[];
52
+ topoData: TopoRow[];
53
+ pointR: (d: DataPoint, i: number) => number;
54
+ path: GeoPathFn;
55
+ }
56
+ /**
57
+ What a link end refers to: a coordinate, an id (as a string), or null
58
+ for anything else.
59
+ */
60
+ export declare function linkEndRef(ref: unknown): LonLat | string | null;
61
+ /** A coordinate's name: its longitude and latitude, in the chart's locale. */
62
+ export declare function coordinateLabel(coord: LonLat, locale?: string): string;
63
+ /**
64
+ Builds the resolver that turns a link end into the place it names on the
65
+ map (see the module notes), or null when it names nothing.
66
+ */
67
+ export declare function flowEndResolver(v: VizInstance, input: Omit<FlowLayoutInput, "path">): (ref: unknown) => FlowEnd | null;
68
+ /**
69
+ The `[longitude, latitude]` ends of `links`, which the map's initial fit
70
+ takes in when it frames coordinate points.
71
+ */
72
+ export declare function flowLinkCoordinates(links: unknown): LonLat[];
73
+ /**
74
+ Link stroke widths from their `linkSize` values: scaled by the
75
+ continuous d3-scale `scaleName` onto `[min, max]` pixels when the values
76
+ differ, else each value as is. A missing value takes `min`.
77
+ */
78
+ export declare function flowLinkWidths(sizes: unknown[], { scale, min, max }: {
79
+ scale?: string;
80
+ min: number;
81
+ max: number;
82
+ }): number[];
83
+ /** What `bundleFlowLinks` reads and rewrites on a drawn link. */
84
+ type BundledFlow = Pick<FlowLink, "source" | "target" | "d" | "points" | "sourceAt" | "targetAt" | "box">;
85
+ /**
86
+ Bundles the links when `linkBundle` is on (see `bundleEdges`), on a flat
87
+ map only: each link the projection draws unbroken, both ends shown,
88
+ takes a bundled path between its two ends. Links on a globe, or ones
89
+ the projection cuts, keep their paths.
90
+ */
91
+ export declare function bundleFlowLinks(v: VizInstance, links: BundledFlow[], projection: Projector, path: GeoPathFn): void;
92
+ /**
93
+ Resolves, sizes, and shapes the chart's `links` for this draw, and
94
+ publishes them for tooltips and hover (see `publishLinkGraph`).
95
+ */
96
+ export declare function geomapFlowLinks(v: VizInstance, input: FlowLayoutInput): FlowLink[];
97
+ export {};
@@ -0,0 +1,47 @@
1
+ /**
2
+ Geomap's caches across draws: the features of each topojson, the
3
+ projection fit, and each feature's projected path. A redraw with the same
4
+ topojson, chart size, and projection reuses them instead of streaming
5
+ every shape through the projection again.
6
+
7
+ @module
8
+ */
9
+ /** A GeoJSON FeatureCollection, as `topojson-client` returns one. */
10
+ export interface FeatureCollection {
11
+ type: string;
12
+ features: Record<string, unknown>[];
13
+ }
14
+ /** A d3-geo projection, as far as the caches read it. */
15
+ type Projection = ((point: [number, number]) => unknown) & Record<string, unknown>;
16
+ /**
17
+ The features of the object `key` names in `topo` (or its first object),
18
+ as `topojson-client`'s `feature`. The conversion is kept per topojson, so
19
+ each draw gets new feature objects around the same geometries.
20
+ */
21
+ export declare function topoFeatures(topo: Record<string, unknown>, key?: string): FeatureCollection;
22
+ /**
23
+ The state of `projection`: its settings and where it places a spread of
24
+ points. Two equal states draw the same paths (a projection with a setting
25
+ outside the list shows it in the points). Null when a setting can't be
26
+ read, which matches nothing.
27
+ */
28
+ export declare function projectionState(projection: Projection): string | null;
29
+ /**
30
+ Whether two GeoJSON values are the same: the same object, or arrays and
31
+ plain objects whose entries are the same, numbers compared exactly.
32
+ */
33
+ export declare function sameGeo(a: unknown, b: unknown): boolean;
34
+ /**
35
+ `projection.fitExtent(extent, object)`, skipped when the projection's
36
+ last fit was to the same extent and object and nothing about it has
37
+ changed since: fitting again would give the same scale and translate.
38
+ */
39
+ export declare function fitExtentOnce(projection: Projection & {
40
+ fitExtent: (extent: [[number, number], [number, number]], object: unknown) => unknown;
41
+ }, extent: [[number, number], [number, number]], object: unknown): void;
42
+ /**
43
+ `path(feature)` for each feature, kept by the feature's geometry while
44
+ `projection` stays in the same state (see `projectionState`).
45
+ */
46
+ export declare function cachedPaths(projection: Projection, path: (feature: unknown) => string | null): (feature: unknown) => string | null;
47
+ export {};
@@ -0,0 +1,41 @@
1
+ /**
2
+ Keyboard rotation for Geomap globes (projections that clip to a circle):
3
+ while the chart has keyboard focus, Shift and an arrow key turns the
4
+ globe a step of longitude (left and right) or latitude (up and down),
5
+ easing there unless motion is reduced. Holding the keys repeats the
6
+ step. Plain arrow keys still move between marks (`keyboardNav`).
7
+
8
+ @module
9
+ */
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ import type { Rotation } from "./globeRotate.js";
12
+ /** The degrees one key press turns a globe. */
13
+ export declare const GLOBE_KEY_STEP = 10;
14
+ /** The longest a key press eases for, in milliseconds. */
15
+ export declare const GLOBE_KEY_DURATION = 200;
16
+ /** The keys that turn a globe, as `aria-keyshortcuts` lists them. */
17
+ export declare const GLOBE_KEY_SHORTCUTS = "Shift+ArrowLeft Shift+ArrowRight Shift+ArrowUp Shift+ArrowDown";
18
+ /** The instructions read for a globe, after the mark-navigation ones. */
19
+ export declare const GLOBE_KEY_INSTRUCTIONS = "Hold Shift and use the arrow keys to rotate the globe.";
20
+ /**
21
+ The rotation that moves a globe's view `east` degrees of longitude and
22
+ `north` degrees of latitude. The view centers on `[-lambda, -phi]`, and
23
+ phi is clamped to ±90 so the view stops at a pole rather than flipping
24
+ over it.
25
+ */
26
+ export declare function rotateByStep(rotation: number[], east: number, north: number): Rotation;
27
+ /** The rotation a fraction `t` of the way from `a` to `b`, the short way round. */
28
+ export declare function rotationBetween(a: number[], b: number[], t: number): Rotation;
29
+ /**
30
+ How far a key moves a globe's view, `[east, north]` in degrees: Shift
31
+ and an arrow key, with no other modifier. Null for any other key.
32
+ */
33
+ export declare function globeKeyStep(event: Pick<KeyboardEvent, "key" | "shiftKey" | "altKey" | "ctrlKey" | "metaKey">): [number, number] | null;
34
+ /**
35
+ Installs the globe's keys on a Geomap as `viz._keyboardGesture`, which
36
+ keyboard navigation consults before moving between marks. A press
37
+ during an eased step adds to where that step is headed; a drag or the
38
+ zoom controls' reset turning the globe meanwhile ends it.
39
+ @param relayout Re-runs the map's layout and emit for the current projection.
40
+ */
41
+ export declare function installGlobeKeys(viz: VizInstance, relayout: () => void): void;
@@ -0,0 +1,70 @@
1
+ /**
2
+ Drag-to-rotate for Geomap globes (projections that clip to a circle,
3
+ such as `"geoOrthographic"`): a drag turns the globe under the pointer
4
+ rather than panning the zoom transform, while the wheel, pinch, and zoom
5
+ buttons still zoom. The rotation follows the pointer with versors
6
+ (quaternions), so the place grabbed stays under the pointer however the
7
+ globe is turned, without the gimbal flips of mapping the drag onto
8
+ longitude and latitude. A drag that starts off the globe turns it by
9
+ longitude and latitude instead; one dragged past the globe's edge keeps
10
+ the grabbed place on the horizon.
11
+ */
12
+ import type { ZoomTransform } from "d3-zoom";
13
+ import type { VizInstance } from "../viz/vizTypes.js";
14
+ import type { LonLat, Point } from "./flowGeometry.js";
15
+ /** A rotation as d3-geo's `[lambda, phi, gamma]`, in degrees. */
16
+ export type Rotation = [number, number, number];
17
+ /** A unit quaternion `[w, x, y, z]`. */
18
+ export type Versor = [number, number, number, number];
19
+ type Vec3 = [number, number, number];
20
+ /** A projection that rotates and inverts, as d3-geo's do. */
21
+ export interface RotatingProjection {
22
+ (p: LonLat): Point | null;
23
+ rotate(): number[];
24
+ rotate(r: number[]): RotatingProjection;
25
+ invert?: (p: Point) => LonLat | null;
26
+ scale(): number;
27
+ }
28
+ /** The unit quaternion for a rotation. */
29
+ export declare function versor([l, p, g]: number[]): Versor;
30
+ /** The rotation a unit quaternion stands for. */
31
+ export declare function versorRotation(q: Versor): Rotation;
32
+ /** A coordinate as a point on the unit sphere. */
33
+ export declare function cartesian([lon, lat]: LonLat): Vec3;
34
+ /** The quaternion turning the unit vector `a` onto `b`. */
35
+ export declare function versorDelta(a: Vec3, b: Vec3): Versor;
36
+ /** The product `a * b` of two quaternions. */
37
+ export declare function versorMultiply(a: Versor, b: Versor): Versor;
38
+ /**
39
+ The rotation that carries the place under `from` (with the globe turned
40
+ to `start`) to the pixel `to`. Off the globe, where a pixel names no
41
+ place, it turns the globe by longitude and latitude instead, a degree
42
+ per the pixels a degree spans at the globe's center. Leaves the
43
+ projection's rotation as it found it.
44
+ */
45
+ export declare function dragRotation(projection: RotatingProjection, start: number[], from: Point, to: Point): Rotation;
46
+ /**
47
+ A point on the zoom surface in the map's projected pixels: the zoom
48
+ `transform` undone, then the chart's own offset.
49
+ */
50
+ export declare function surfaceToMap(point: Point, transform: Pick<ZoomTransform, "x" | "y" | "k">, offset?: {
51
+ x?: number;
52
+ y?: number;
53
+ }): Point;
54
+ /** Whether `viz` is a globe drag can turn now. */
55
+ export declare function globeRotates(viz: VizInstance): boolean;
56
+ /**
57
+ The rotation a globe returns to, and fits its scale at: the configured
58
+ `projectionRotate`, else the one the projection had before it was first
59
+ dragged. Undefined for a globe that hasn't been turned.
60
+ */
61
+ export declare function globeHome(viz: VizInstance): number[] | undefined;
62
+ /**
63
+ Installs the globe drag on a Geomap: `viz._zoomGesture`, which the zoom
64
+ behavior consults on each gesture, rotating the projection on a drag
65
+ and re-laying the map out (with `relayout`) once per animation frame.
66
+ The zoom controls' reset turns the globe back to `globeHome`.
67
+ @param relayout Re-runs the map's layout and emit for the current projection.
68
+ */
69
+ export declare function installGlobeRotation(viz: VizInstance, relayout: () => void): void;
70
+ export {};
@@ -4,6 +4,9 @@
4
4
  Implementation files in this folder:
5
5
  - `applyLayout.ts` — topojson + projection + path/point compute.
6
6
  - `emit.ts` — country Paths + point Circles.
7
+ - `flowLinks.ts` / `flowGeometry.ts` — `links`: their ends, widths,
8
+ and great-circle paths; `flowEmit.ts` draws them, `flowEvents.ts`
9
+ wires their hover and click, and `flowFields.ts` declares their config.
7
10
  */
8
11
  import type { ChartDefinition } from "../definition/ChartDefinition.js";
9
12
  export declare const geomapDef: ChartDefinition;
@@ -0,0 +1,24 @@
1
+ /**
2
+ Labels of a Geomap's coordinate points: each sits inside its point when it
3
+ fits there, else beside it where there's room, else hides (see
4
+ `labelPosition`).
5
+
6
+ @module
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { SceneNode } from "@d3plus/render";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ /** A Geomap's projected points (see `geomapCtx`). */
12
+ export interface GeomapPoints {
13
+ points: DataPoint[];
14
+ pointR: (d: DataPoint, i: number) => number;
15
+ pointX: (d: DataPoint, i: number) => number;
16
+ pointY: (d: DataPoint, i: number) => number;
17
+ }
18
+ /**
19
+ The scene nodes of a Geomap's point labels, painted above the points.
20
+ @param viz The Geomap.
21
+ @param c The projected points, in the order they're drawn.
22
+ @param circleConfig The merged Circle shapeConfig.
23
+ */
24
+ export declare function geomapPointLabels(viz: VizInstance, c: GeomapPoints, circleConfig: Record<string, unknown>): SceneNode[];
@@ -0,0 +1,64 @@
1
+ /**
2
+ Hexbin's pure binning helpers: points in pixel space grouped into
3
+ hexagons (d3-hexbin) or squares of a fixed pixel size, each bin's
4
+ measure (a count, or a sum or mean of a value), and its outline.
5
+
6
+ @module
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ /** The bin shapes Hexbin draws. */
10
+ export type BinShape = "hex" | "square";
11
+ /** How a bin's measure is computed from its points. */
12
+ export type BinAgg = "count" | "sum" | "mean";
13
+ /** An observation placed in pixel space. */
14
+ export interface PixelPoint {
15
+ x: number;
16
+ y: number;
17
+ /** The user's row the point came from. */
18
+ row: DataPoint;
19
+ /** The value `sum`/`mean` bins aggregate (and density contours weigh by). */
20
+ weight?: number;
21
+ }
22
+ /** A bin of points: its grid key, its center in pixels, and its points. */
23
+ export interface PixelBin {
24
+ key: string;
25
+ cx: number;
26
+ cy: number;
27
+ points: PixelPoint[];
28
+ }
29
+ /** A bin's pixel bounds. */
30
+ export interface PixelBounds {
31
+ x0: number;
32
+ x1: number;
33
+ y0: number;
34
+ y1: number;
35
+ }
36
+ /**
37
+ Groups points into bins of a fixed pixel size: pointy-top hexagons of
38
+ radius `size`, or `size`-pixel squares. The grid is anchored at `origin`,
39
+ so a grid anchored to a data point moves with it when the view pans.
40
+ Points without finite coordinates are skipped, and only bins holding a
41
+ point are returned.
42
+ @param points The points, in pixels.
43
+ @param options `shape`, `size` (hexagon radius or square side, in
44
+ pixels), and the grid's `origin`.
45
+ */
46
+ export declare function binPoints(points: PixelPoint[], options: {
47
+ shape: BinShape;
48
+ size: number;
49
+ origin?: [number, number];
50
+ }): PixelBin[];
51
+ /**
52
+ A bin's pixel bounds: a hexagon's bounding box (it is `√3 × size` wide
53
+ and `2 × size` tall), or a square's sides.
54
+ */
55
+ export declare function binBounds(bin: Pick<PixelBin, "cx" | "cy">, shape: BinShape, size: number): PixelBounds;
56
+ /** A bin's outline as an absolute SVG path. */
57
+ export declare function binPath(bin: Pick<PixelBin, "cx" | "cy">, shape: BinShape, size: number): string;
58
+ /** The area one bin covers, in square pixels. */
59
+ export declare function binArea(shape: BinShape, size: number): number;
60
+ /**
61
+ A bin's measure: its point count, or the sum or mean of its points'
62
+ finite weights. A mean with no finite weight is `NaN`.
63
+ */
64
+ export declare function binMeasure(points: PixelPoint[], agg: BinAgg): number;
@@ -0,0 +1,18 @@
1
+ /**
2
+ Hexbin's axis buffer (see `Plot.buffer`): fits each axis to its numeric
3
+ observations and pads it by a bin, so the outermost bins sit inside the
4
+ plot.
5
+
6
+ @module
7
+ */
8
+ import type { D3Scale } from "../../utils/index.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ export declare function hexbinBuffer(this: VizInstance, { data, x, y, x2, y2, xScale, yScale, }: {
11
+ data: Record<string, unknown>[];
12
+ x: D3Scale;
13
+ y: D3Scale;
14
+ x2?: boolean;
15
+ y2?: boolean;
16
+ xScale?: string;
17
+ yScale?: string;
18
+ }): [D3Scale, D3Scale];
@@ -0,0 +1,95 @@
1
+ /**
2
+ Hexbin's contour labels: each labelled level's value written along its
3
+ contour lines, the way a topographic map labels elevation. Labels sit
4
+ centered on the line, read upright, break the line beneath them, and
5
+ keep clear of the other contours and labels; long rings take several,
6
+ `labelSpacing` apart, and dense levels are labelled every `labelStep`-th.
7
+
8
+ @module
9
+ */
10
+ import type { DataPoint } from "@d3plus/data";
11
+ import type { SceneNode } from "@d3plus/render";
12
+ import { type Pt } from "../features/pathLabelGeometry.js";
13
+ import { type StretchContext } from "../Plot/lineLabelsAlong.js";
14
+ import type { VizInstance } from "../viz/vizTypes.js";
15
+ import type { PlotFrame } from "./layers.js";
16
+ import { type HexbinSettings } from "./settings.js";
17
+ /** The labels' font size when `labelConfig` sets none. */
18
+ export declare const CONTOUR_LABEL_FONT_SIZE = 10;
19
+ /** With more levels than this, `labelStep: "auto"` labels every other level. */
20
+ export declare const CONTOUR_LABEL_MAX_LEVELS = 5;
21
+ /**
22
+ A contour path's rings as closed polylines (the last point repeats the
23
+ first).
24
+ @param d The contour's path: `M x,y L x,y … Z` per ring.
25
+ */
26
+ export declare function contourRings(d: string): Pt[][];
27
+ /**
28
+ How many levels apart labelled levels are (see `contourConfig.labelStep`):
29
+ a whole number of at least 1, or with `"auto"` (or anything else), 1
30
+ with up to `CONTOUR_LABEL_MAX_LEVELS` levels and 2 with more.
31
+ @param option The `labelStep` option.
32
+ @param count How many levels there are.
33
+ */
34
+ export declare function contourLabelStep(option: unknown, count: number): number;
35
+ /**
36
+ Which levels take labels: every `step`-th one, keeping the levels at
37
+ multiples of `step` times their spacing (the "index" contours), or
38
+ every `step`-th position, from the `step`-th lowest, when the levels
39
+ aren't evenly spaced from zero.
40
+ @param levels The levels, lowest first.
41
+ @param step How many levels apart labelled levels are (see `contourLabelStep`).
42
+ */
43
+ export declare function labelledLevels(levels: number[], step?: number): boolean[];
44
+ /**
45
+ The least distance between two labels' middles along one contour line,
46
+ in pixels (see `contourConfig.labelSpacing`): a positive number as
47
+ given, or with `"auto"` (or anything else), 20 ems or half the plot's
48
+ mean side, whichever is longer.
49
+ @param option The `labelSpacing` option.
50
+ @param fontSize The labels' font size.
51
+ @param frame The plot area.
52
+ */
53
+ export declare function contourLabelSpacing(option: unknown, fontSize: number, frame: Pick<PlotFrame, "width" | "height">): number;
54
+ /**
55
+ The distance between two points along a closed ring of length `total`,
56
+ whichever way round is shorter.
57
+ @param a How far along the ring the first point lies.
58
+ @param b How far along the ring the second point lies.
59
+ @param total The ring's length.
60
+ */
61
+ export declare function ringDistance(a: number, b: number, total: number): number;
62
+ /**
63
+ The points a placed label keeps other labels from: its band (see
64
+ `labelBand`), widened by half an em above and below, so stacked labels
65
+ on neighboring contours keep a gap between them.
66
+ @param points The label's upright stretch.
67
+ @param ctx The font size and lift.
68
+ */
69
+ export declare function paddedBand(points: Pt[], ctx: StretchContext): Pt[];
70
+ /**
71
+ The stretches labels along a closed ring take: as many as its length
72
+ allows at `spacing` pixels apart (at least one), each the best-scoring
73
+ stretch left that is clear of the obstacles and at least `spacing` along
74
+ the ring from the others. Each one's padded band (see `paddedBand`) is
75
+ added to the obstacles.
76
+ @param ring The closed ring.
77
+ @param length Each label's length.
78
+ @param ctx The obstacles (ignoring the ring's own points), plot area, and font.
79
+ @param spacing The least distance between two labels' middles along the ring (at least a label's length).
80
+ */
81
+ export declare function ringLabelStretches(ring: Pt[], length: number, ctx: StretchContext, spacing: number): Pt[][];
82
+ /**
83
+ The labels along a Hexbin's contour lines (`contourConfig.labels`): for
84
+ each labelled level, its formatted value along its rings, centered on
85
+ the line, upright, on a pad of the chart's background that breaks the
86
+ line beneath (when the contours are lines). Inert: no hover, click, or
87
+ keyboard stop.
88
+ @param viz The chart.
89
+ @param rows The contour rows, lowest level first.
90
+ @param nodes The contours' drawn nodes, for their colors.
91
+ @param frame The plot area.
92
+ @param settings The chart's resolved options.
93
+ @param obstacles Other lines to keep clear of, such as trend lines.
94
+ */
95
+ export declare function emitContourLabels(viz: VizInstance, rows: DataPoint[], nodes: SceneNode[], frame: PlotFrame, settings: HexbinSettings, obstacles?: Pt[][]): SceneNode[];