@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
@@ -1,11 +1,10 @@
1
1
  /**
2
2
  Light/dark basemaps. `tileUrl` and `ocean` accept either one value or a
3
- `{light, dark}` pair; a pair resolves against the chart's backdrop each
4
- draw, and the chart redraws when that backdrop flips.
3
+ `{light, dark}` pair; a pair resolves against the chart's theme each
4
+ draw (see `theme`), and an `"auto"` chart redraws when its page flips.
5
5
 
6
6
  @module
7
- */ import { lab } from "d3-color";
8
- /** Esri's Canvas basemaps: muted, nearly label-free bases for data overlays. */ export const DEFAULT_TILE_URL = {
7
+ */ /** A value, or one per page theme. */ /** Esri's Canvas basemaps: muted, nearly label-free bases for data overlays. */ export const DEFAULT_TILE_URL = {
9
8
  light: "https://server.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Base/MapServer/tile/{z}/{y}/{x}",
10
9
  dark: "https://server.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Dark_Gray_Base/MapServer/tile/{z}/{y}/{x}"
11
10
  };
@@ -17,47 +16,3 @@ const isPair = (value)=>typeof value === "object" && value !== null && "light" i
17
16
  /** Picks a themed value's light or dark side. */ export function resolveThemed(value, dark) {
18
17
  return isPair(value) ? dark ? value.dark : value.light : value;
19
18
  }
20
- /** Whether a Geomap has any themed value that depends on the backdrop. */ export function isThemed(viz) {
21
- return isPair(viz.schema.tileUrl) || isPair(viz.schema.ocean);
22
- }
23
- /**
24
- Whether the chart sits on a dark backdrop: the first non-transparent
25
- background among its ancestors, or — when none sets one — the browser's
26
- own page canvas, which is dark only when the page opts into a dark
27
- `color-scheme` and the system prefers dark. Server renders are light.
28
- */ export function pageIsDark(viz) {
29
- if (viz._ssr || typeof window === "undefined" || typeof getComputedStyle !== "function") return false;
30
- let node = viz._select?.node() ?? null;
31
- while(node){
32
- const bg = getComputedStyle(node).backgroundColor;
33
- if (bg && bg !== "transparent" && bg !== "rgba(0, 0, 0, 0)") return lab(bg).l < 50;
34
- node = node.parentElement;
35
- }
36
- const scheme = getComputedStyle(document.documentElement).colorScheme || "";
37
- if (!scheme.includes("dark")) return false;
38
- if (!scheme.includes("light")) return true;
39
- return typeof matchMedia === "function" && matchMedia("(prefers-color-scheme: dark)").matches;
40
- }
41
- /**
42
- Redraws the chart when its backdrop changes theme: on a system theme
43
- change, or when the page flips a theme class/attribute/style on <html>
44
- or <body> (how most theme toggles work). Installed once per chart, and
45
- only while it uses a `{light, dark}` pair.
46
- */ export function watchPageTheme(viz) {
47
- if (viz._themeWatch || viz._ssr || typeof window === "undefined") return;
48
- const check = ()=>{
49
- const host = viz._select?.node();
50
- if (!host || !host.isConnected) return;
51
- if (isThemed(viz) && pageIsDark(viz) !== viz._basemapDark) viz.render?.();
52
- };
53
- const media = typeof matchMedia === "function" ? matchMedia("(prefers-color-scheme: dark)") : null;
54
- media?.addEventListener?.("change", check);
55
- const observer = typeof MutationObserver === "function" ? new MutationObserver(check) : null;
56
- for (const el of [
57
- document.documentElement,
58
- document.body
59
- ])if (el) observer?.observe(el, {
60
- attributes: true
61
- });
62
- viz._themeWatch = true;
63
- }
@@ -1,11 +1,13 @@
1
1
  /**
2
- `geomapEmit` — country Paths + point Circles using `geomapCtx`
3
- stashed on `viz.ctx`. Emits flat SceneNodes directly (no transient
2
+ `geomapEmit` — country Paths, links, and point Circles using
3
+ `geomapCtx` stashed on `viz.ctx`. Emits flat SceneNodes directly (no transient
4
4
  Shape compute pass).
5
5
  */ import { chartBounds } from "../features/chartGeometry.js";
6
6
  import { paintFromShapeConfig, shapeConfigFor } from "../features/emitHelpers.js";
7
7
  import { backgroundImageNodes } from "../features/backgroundImageEmit.js";
8
8
  import { resolveThemed } from "./basemapTheme.js";
9
+ import { geomapPointLabels } from "./pointLabels.js";
10
+ import { emitFlowLabels, emitFlowLinks } from "./flowEmit.js";
9
11
  /**
10
12
  The ocean rect and basemap tiles, for a server render or a small-multiples
11
13
  panel (empty otherwise).
@@ -98,6 +100,9 @@ export const geomapEmit = ({ viz })=>{
98
100
  ];
99
101
  }));
100
102
  }
103
+ const links = c.flowLinks ?? [];
104
+ out.push(...emitFlowLinks(viz, links));
105
+ const circles = [];
101
106
  if (c.pointData && c.pointData.length) {
102
107
  const circleConfig = shapeConfigFor(viz, "Circle");
103
108
  const points = c.pointSort ? [
@@ -107,6 +112,11 @@ export const geomapEmit = ({ viz })=>{
107
112
  for(let i = 0; i < points.length; i++){
108
113
  const d = points[i];
109
114
  const paint = paintFromShapeConfig(circleConfig, d, i);
115
+ circles.push({
116
+ x: c.pointX(d, i),
117
+ y: c.pointY(d, i),
118
+ r: c.pointR(d, i)
119
+ });
110
120
  // Origin-centered geometry with the projected position in `transform`,
111
121
  // matching how Shape-emitted Circle marks are placed (cx/cy = 0, group
112
122
  // transform positions the mark). The motion-trail layer reads a mark's
@@ -145,6 +155,13 @@ export const geomapEmit = ({ viz })=>{
145
155
  points[k],
146
156
  k
147
157
  ]));
158
+ out.push(...geomapPointLabels(viz, {
159
+ points,
160
+ pointR: c.pointR,
161
+ pointX: c.pointX,
162
+ pointY: c.pointY
163
+ }, circleConfig));
148
164
  }
165
+ out.push(...emitFlowLabels(viz, links, circles));
149
166
  return out;
150
167
  };
@@ -0,0 +1,137 @@
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
+ */ import { interpolateRgb } from "d3-interpolate";
8
+ import { chordArrowNodes, polylineArrowEdge } from "../features/curvedArrows.js";
9
+ import { edgeArrowTrims, emphasizedArrowEdge, scaledArrowSize, scaledStrokeWidth } from "../features/edgeArrows.js";
10
+ import { linkColorResolver } from "../features/linkColor.js";
11
+ import { linkAriaLabel, linkHitPath } from "../features/linkInteraction.js";
12
+ import { emitLinkLabels } from "../features/linkLabels.js";
13
+ import { backgroundInk, chartBackground } from "../viz/backgroundInk.js";
14
+ import { pathRuns, polylineMidpoint } from "./flowGeometry.js";
15
+ /** A link's scene key. */ export const flowLinkKey = (link)=>`geomap-link-${link.source.id}-${link.target.id}-${link.index}`;
16
+ /**
17
+ The color of links `linkColor` doesn't color: halfway between the
18
+ chart's background and its text color, a gray that reads over both the
19
+ land and the water of a light or dark map.
20
+ */ export function flowLinkGray(viz) {
21
+ return interpolateRgb(chartBackground(viz), backgroundInk(viz))(0.5);
22
+ }
23
+ /** The link's paint: `linkColor` (else `flowLinkGray`) at its width. */ function flowLinkPaint(viz, link, color, gray) {
24
+ return {
25
+ fill: "none",
26
+ stroke: color(link.datum, link) ?? gray,
27
+ strokeWidth: link.size,
28
+ strokeOpacity: 0.85,
29
+ strokeLinecap: "round"
30
+ };
31
+ }
32
+ /** Whether the run starts (within a pixel) at `at`. */ const startsAt = (run, at)=>!!run && !!at && Math.hypot(run[0][0] - at[0], run[0][1] - at[1]) <= 1;
33
+ /**
34
+ A link's visible stroke and its arrowheads. Each head's tip sits on the
35
+ path, clear of the point at its end, and is aimed along the chord from
36
+ its base (`size` further back along the path) to its tip; the stroke
37
+ follows the path to each base, then runs straight along that chord to
38
+ end inside the head (see `polylineArrowEdge`). A head goes only on an
39
+ end the projection draws. `scale` widens the stroke (see
40
+ `emphasizedArrowEdge`).
41
+ */ export function flowArrowEdge(viz, link, fill, scale = 1) {
42
+ const trims = edgeArrowTrims({
43
+ arrows: viz.schema.arrows,
44
+ arrowSize: scaledArrowSize(viz.schema.arrowSize, scale),
45
+ strokeWidth: scaledStrokeWidth(link.size, scale),
46
+ datum: link.datum,
47
+ i: link.index
48
+ });
49
+ if (!trims.ends.source && !trims.ends.target) return {
50
+ d: link.d,
51
+ arrows: []
52
+ };
53
+ const runs = pathRuns(link.d);
54
+ const last = runs[runs.length - 1];
55
+ const inset = (r)=>r ? r + 1 : 0;
56
+ // The first run leaves the source and the last reaches the target, when
57
+ // the projection draws them.
58
+ const ends = {
59
+ source: trims.ends.source && startsAt(runs[0], link.sourceAt),
60
+ target: trims.ends.target && startsAt(last ? [
61
+ ...last
62
+ ].reverse() : undefined, link.targetAt)
63
+ };
64
+ const { d, source, target } = polylineArrowEdge(runs, {
65
+ ...trims,
66
+ ends
67
+ }, {
68
+ source: inset(link.source.r),
69
+ target: inset(link.target.r)
70
+ });
71
+ return {
72
+ d,
73
+ arrows: chordArrowNodes({
74
+ ends: {
75
+ source,
76
+ target
77
+ },
78
+ size: trims.size,
79
+ datum: link.datum,
80
+ keyPrefix: `${flowLinkKey(link)}-arrow`,
81
+ fill
82
+ })
83
+ };
84
+ }
85
+ /** The links, their hit paths, and their arrowheads, in that order. */ export function emitFlowLinks(viz, links) {
86
+ if (!links.length) return [];
87
+ const color = linkColorResolver(viz);
88
+ const gray = flowLinkGray(viz);
89
+ const paths = [];
90
+ const hits = [];
91
+ const arrows = [];
92
+ // Widest first, so a thin link stays visible over a wide one.
93
+ const order = [
94
+ ...links
95
+ ].sort((a, b)=>b.size - a.size || a.index - b.index);
96
+ for (const link of order){
97
+ const paint = flowLinkPaint(viz, link, color, gray);
98
+ const key = flowLinkKey(link);
99
+ const fill = typeof paint.stroke === "string" ? paint.stroke : undefined;
100
+ const edge = emphasizedArrowEdge((scale)=>flowArrowEdge(viz, link, fill, scale));
101
+ // A stroke ending inside its head ends square, so no cap pokes past it.
102
+ if (edge.arrows.length) paint.strokeLinecap = "butt";
103
+ paths.push({
104
+ type: "path",
105
+ key,
106
+ d: edge.d,
107
+ ...edge.emphasis ? {
108
+ emphasis: edge.emphasis
109
+ } : {},
110
+ datum: link.datum,
111
+ index: link.index,
112
+ paint,
113
+ aria: {
114
+ label: linkAriaLabel(viz, link.datum)
115
+ }
116
+ });
117
+ hits.push(linkHitPath(key, link.d, link.datum, link.size));
118
+ arrows.push(...edge.arrows);
119
+ }
120
+ return [
121
+ ...paths,
122
+ ...hits,
123
+ ...arrows
124
+ ];
125
+ }
126
+ /** The link labels, at the middle of each link, clear of the points. */ export function emitFlowLabels(viz, links, circles) {
127
+ return emitLinkLabels(viz, links.map((link, i)=>({
128
+ key: flowLinkKey(link),
129
+ link: link.datum,
130
+ i,
131
+ anchor: link.points ? polylineMidpoint(link.points) : null,
132
+ path: link.points,
133
+ priority: link.size
134
+ })), {
135
+ circles
136
+ });
137
+ }
@@ -0,0 +1,86 @@
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
+ */ import { clearLinkFocus, focusLink, installFocusBackgroundClick } from "../features/linkFocus.js";
8
+ import { isLinkDatum, linkHighlight, linkMeta, nodeHighlight } from "../features/linkInteraction.js";
9
+ import { setLoaderValue } from "../viz/loaderFormat.js";
10
+ import { simpleHover } from "../viz/simpleHover.js";
11
+ /** The box around a drawn link, or null when it isn't drawn. */ export function flowLinkBox(viz, d) {
12
+ const index = linkMeta(d)?.index;
13
+ const links = viz.ctx.geomapCtx?.flowLinks ?? [];
14
+ const link = links.find((l)=>l.index === index);
15
+ return link ? link.box : null;
16
+ }
17
+ /**
18
+ What hovering `d` emphasizes: a link and its two ends, or a mark that
19
+ ends links and those links. Null for anything else.
20
+ */ export function flowHoverPredicate(viz, d) {
21
+ const nodeKey = (h, hi)=>`${viz._id(h, hi)}`;
22
+ if (isLinkDatum(d)) return linkHighlight(viz, d, nodeKey);
23
+ return nodeHighlight(viz, d, nodeKey);
24
+ }
25
+ /** Installs `links` and the link hover, click, and focus handlers. */ export function setupGeomapLinks(viz) {
26
+ const v = viz;
27
+ /**
28
+ Lines between places on the map, each drawn along the great circle
29
+ between its two ends (lifted into an arc by `linkCurve`). Each link's
30
+ `source` and `target` is a `[longitude, latitude]` coordinate, or the
31
+ id of a row in the data (or of a topojson feature): a row with a
32
+ coordinate `point` links from that point, and any other id from the
33
+ centroid of its topojson shape. Accepts an array of links, or a
34
+ URL/filepath to load them from. `linksFormat` transforms them; a
35
+ function passed as a second argument sets it.
36
+ @type {object[] | string}
37
+ */ v.links = function() {
38
+ if (arguments.length) {
39
+ // eslint-disable-next-line prefer-rest-params
40
+ setLoaderValue(this, "links", arguments);
41
+ return this;
42
+ }
43
+ return this.schema.links;
44
+ };
45
+ installFocusBackgroundClick(viz);
46
+ const on = viz.schema.on;
47
+ let hovering = false;
48
+ const move = on["mousemove.shape"];
49
+ on["mousemove.shape"] = (d, i, x, event)=>{
50
+ move?.(d, i, x, event);
51
+ const predicate = flowHoverPredicate(viz, d);
52
+ if (predicate) {
53
+ hovering = true;
54
+ // Geomap's own hover is off (`hoverOpacity: 1`), so set the predicate
55
+ // directly; the scene emphasizes the matches.
56
+ simpleHover.call(viz, predicate);
57
+ }
58
+ };
59
+ const leave = on["mouseleave.shape"];
60
+ on["mouseleave.shape"] = (d, i, x, event)=>{
61
+ leave?.(d, i, x, event);
62
+ if (!hovering) return;
63
+ hovering = false;
64
+ simpleHover.call(viz, false);
65
+ };
66
+ const click = on["click.shape"];
67
+ on["click.shape"] = (d, i, x, event)=>{
68
+ if (isLinkDatum(d)) {
69
+ event?.stopPropagation?.();
70
+ focusLink(viz, d, {
71
+ nodeKey: (h, hi)=>`${viz._id(h, hi)}`,
72
+ box: flowLinkBox(viz, d)
73
+ });
74
+ return;
75
+ }
76
+ if (clearLinkFocus(viz)) return;
77
+ return click?.(d, i, x, event);
78
+ };
79
+ // The ocean beneath an SVG map takes the clicks between marks.
80
+ const draw = viz._draw.bind(viz);
81
+ viz._draw = function(callback) {
82
+ const result = draw(callback);
83
+ viz._container?.select("rect.d3plus-geomap-ocean").on("click.linkFocus", ()=>clearLinkFocus(viz));
84
+ return result;
85
+ };
86
+ }
@@ -0,0 +1,91 @@
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
+ */ import constant from "../../utils/constant.js";
5
+ import { linkBundleFields, linkSizeMaxField, linkStyleFields } from "../features/linkFields.js";
6
+ import { linkTooltipConfig } from "../features/linkInteraction.js";
7
+ /** Geomap's link fields. */ export function geomapLinkFields() {
8
+ return [
9
+ /**
10
+ Draws arrowheads on the links: `true` (or `"target"`) at each link's
11
+ target end, `"source"` at its source end, `"both"`, or `false` for
12
+ none. Also accepts an accessor function returning one of those per
13
+ link.
14
+ @type {boolean | "target" | "source" | "both" | function}
15
+ */ {
16
+ key: "arrows",
17
+ default: false
18
+ },
19
+ /**
20
+ The arrowhead size in pixels, or an accessor function returning one
21
+ per link. Defaults to three times the link's stroke width (at least
22
+ 6), held to 12 pixels on wide links but never under one and a half
23
+ times the stroke, so the head stays wider than its line.
24
+ @type {number | function}
25
+ */ {
26
+ key: "arrowSize"
27
+ },
28
+ ...linkStyleFields(),
29
+ ...linkBundleFields(),
30
+ {
31
+ key: "links",
32
+ default: []
33
+ },
34
+ /**
35
+ How far each link bows into an arc, as a share of the distance
36
+ between its ends: `0` draws the plain great-circle path, and the
37
+ default `0.2` lifts its middle by a fifth of that distance, to the
38
+ left of the link's direction (a negative value bows to the right),
39
+ so links running both ways between two places stay apart. On a
40
+ flat map, a link whose great circle the projection cuts (across the
41
+ antimeridian, or between `"geoAlbersUsa"`'s insets) is drawn on the
42
+ screen between its two ends instead, bowed the same way, so it
43
+ crosses the map rather than leaving by one edge. On a projection that
44
+ clips to a circle (a globe, such as `"geoOrthographic"`), links
45
+ follow the great circle without the lift, which would leave the
46
+ sphere.
47
+ @type {number}
48
+ */ {
49
+ key: "linkCurve",
50
+ default: 0.2
51
+ },
52
+ /**
53
+ The thickness of each link: a pixel number used for every link, or
54
+ an accessor function whose values are scaled between `linkSizeMin`
55
+ and `linkSizeMax` (see `linkSizeScale`). The function receives each
56
+ link, with `source` and `target` set to the data at its ends, and
57
+ its index in `links`.
58
+ @type {number | function}
59
+ */ {
60
+ key: "linkSize",
61
+ default: constant(2),
62
+ coerce: (v)=>typeof v === "function" ? v : constant(v)
63
+ },
64
+ /** The widest link, in pixels, when `linkSize` values differ. */ linkSizeMaxField(10),
65
+ /** The thinnest link, in pixels, when `linkSize` values differ. */ {
66
+ key: "linkSizeMin",
67
+ default: 1
68
+ },
69
+ /**
70
+ The type of [continuous d3-scale](https://github.com/d3/d3-scale#continuous-scales)
71
+ used to size links (e.g. `"linear"`, `"sqrt"`, `"log"`).
72
+ */ {
73
+ key: "linkSizeScale",
74
+ default: "sqrt"
75
+ },
76
+ /**
77
+ How many links a point's or shape's tooltip lists under its number
78
+ of connections, strongest first: a number, or `false` for none.
79
+ Defaults to 3 when the links differ in `linkSize`, and none
80
+ otherwise.
81
+ @type {number | false}
82
+ */ {
83
+ key: "nodeTooltipLinks"
84
+ },
85
+ {
86
+ key: "tooltipConfig",
87
+ merge: true,
88
+ factory: (viz)=>linkTooltipConfig(viz)
89
+ }
90
+ ];
91
+ }
@@ -0,0 +1,225 @@
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
+ */ import { geoArea, geoCentroid, geoDistance, geoInterpolate } from "d3-geo";
6
+ import { polylinePath } from "../features/polyline.js";
7
+ export { polylineAt, polylineBox, polylineLength, polylineMidpoint, polylinePath, trimPolyline } from "../features/polyline.js";
8
+ /** Whether `v` is a `[longitude, latitude]` pair of finite numbers. */ export function isLonLat(v) {
9
+ return Array.isArray(v) && v.length === 2 && typeof v[0] === "number" && typeof v[1] === "number" && Number.isFinite(v[0]) && Number.isFinite(v[1]) && Math.abs(v[1]) <= 90;
10
+ }
11
+ /**
12
+ A row's `point` value as a coordinate: a pair whose two entries read as
13
+ finite numbers (CSV data gives strings), or null.
14
+ */ export function toLonLat(v) {
15
+ if (!Array.isArray(v) || v.length < 2) return null;
16
+ const c = [
17
+ Number(v[0]),
18
+ Number(v[1])
19
+ ];
20
+ return isLonLat(c) ? c : null;
21
+ }
22
+ /**
23
+ The point a link to a geographic feature ends at: the centroid of the
24
+ feature's largest polygon (so a country's link meets its mainland, not a
25
+ point between its islands), or of the whole geometry when it isn't a
26
+ MultiPolygon. Null when the feature has no geometry.
27
+ */ export function featureAnchor(feature) {
28
+ const geometry = feature?.geometry;
29
+ if (!geometry) return null;
30
+ let part = geometry;
31
+ if (geometry.type === "MultiPolygon") {
32
+ const polygons = geometry.coordinates;
33
+ let best = -1;
34
+ for (const coordinates of polygons){
35
+ const polygon = {
36
+ type: "Polygon",
37
+ coordinates
38
+ };
39
+ const area = sphericalArea(polygon);
40
+ if (area > best) {
41
+ best = area;
42
+ part = polygon;
43
+ }
44
+ }
45
+ }
46
+ let c = geoCentroid(part);
47
+ // A ring wound the wrong way encloses the rest of the sphere, whose
48
+ // centroid is the antipode of the shape's.
49
+ if (geoArea(part) > 2 * Math.PI) c = [
50
+ c[0] > 0 ? c[0] - 180 : c[0] + 180,
51
+ -c[1]
52
+ ];
53
+ return isLonLat(c) ? c : null;
54
+ }
55
+ /** A shape's area on the unit sphere, whichever way its rings wind. */ function sphericalArea(object) {
56
+ const area = geoArea(object);
57
+ return Math.min(area, 4 * Math.PI - area);
58
+ }
59
+ /** `count + 1` evenly spaced points along the great circle from `a` to `b`. */ export function greatCircle(a, b, count) {
60
+ const interpolate = geoInterpolate(a, b);
61
+ const n = Math.max(1, Math.round(count));
62
+ return Array.from({
63
+ length: n + 1
64
+ }, (_, k)=>interpolate(k / n));
65
+ }
66
+ /**
67
+ Lifts a polyline into an arc: each point moves off the straight line
68
+ between its ends, most at the middle, by `curve` times that line's
69
+ length, to the left of the direction of travel (right for a negative
70
+ `curve`). The ends stay put.
71
+ */ export function liftPolyline(points, curve) {
72
+ if (!curve || points.length < 2) return points.slice();
73
+ const [x0, y0] = points[0];
74
+ const [x1, y1] = points[points.length - 1];
75
+ const length = Math.hypot(x1 - x0, y1 - y0);
76
+ if (!length) return points.slice();
77
+ // On screen (y down), the left of travel is the direction rotated -90°.
78
+ const nx = (y1 - y0) / length;
79
+ const ny = -(x1 - x0) / length;
80
+ const last = points.length - 1;
81
+ return points.map(([x, y], k)=>{
82
+ const t = k / last;
83
+ const h = 4 * t * (1 - t) * curve * length;
84
+ return [
85
+ x + nx * h,
86
+ y + ny * h
87
+ ];
88
+ });
89
+ }
90
+ /** The numbers in a path string, in order. */ function pathNumbers(d) {
91
+ return (d.match(/-?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?/gi) ?? []).map(Number);
92
+ }
93
+ /**
94
+ Whether d3-geo drew a line as one unbroken run from `a` to `b`: one
95
+ subpath, starting and ending (within a pixel) at the two points.
96
+ */ export function unbrokenPath(d, a, b) {
97
+ if ((d.match(/M/g) ?? []).length !== 1) return false;
98
+ const n = pathNumbers(d);
99
+ if (n.length < 4) return false;
100
+ const near = (x, y, p)=>Math.abs(x - p[0]) <= 1 && Math.abs(y - p[1]) <= 1;
101
+ return near(n[0], n[1], a) && near(n[n.length - 2], n[n.length - 1], b);
102
+ }
103
+ /**
104
+ Whether the projection cuts the great circle from `a` to `b` (across
105
+ the antimeridian, between geoAlbersUsa's insets, past a globe's horizon,
106
+ or anywhere else it breaks or shortens the line), so it isn't drawn as
107
+ one run from one end to the other.
108
+ */ export function greatCircleCut(a, b, projection, path) {
109
+ const straight = path({
110
+ type: "LineString",
111
+ coordinates: [
112
+ a,
113
+ b
114
+ ]
115
+ });
116
+ const pa = finitePoint(projection(a));
117
+ const pb = finitePoint(projection(b));
118
+ return !straight || !pa || !pb || !unbrokenPath(straight, pa, pb);
119
+ }
120
+ /**
121
+ A link drawn on the screen between two projected points: the straight
122
+ line between them, bowed by `curve` the way `liftPolyline` bows it.
123
+ */ export function screenArc(pa, pb, curve = 0) {
124
+ const chord = Math.hypot(pb[0] - pa[0], pb[1] - pa[1]);
125
+ const count = Math.min(128, Math.max(16, Math.ceil(chord / 4)));
126
+ const line = Array.from({
127
+ length: count + 1
128
+ }, (_, k)=>{
129
+ const t = k / count;
130
+ return [
131
+ pa[0] + (pb[0] - pa[0]) * t,
132
+ pa[1] + (pb[1] - pa[1]) * t
133
+ ];
134
+ });
135
+ const drawn = liftPolyline(line, curve);
136
+ return {
137
+ d: polylinePath(drawn),
138
+ points: drawn
139
+ };
140
+ }
141
+ /**
142
+ A link's path between two coordinates: the great circle between them
143
+ through the map's projection, lifted into an arc by `curve` (see
144
+ `liftPolyline`) when the projection draws it unbroken.
145
+
146
+ When the projection cuts the great circle, a flat map draws the link on
147
+ the screen between its two ends instead (see `screenArc`), so it
148
+ crosses the map rather than leaving by one edge and coming back by the
149
+ other. A globe (see `clipsToCircle`), or a flat map hiding one of the
150
+ ends, draws it as d3-geo clips it, without the lift. Null when the two
151
+ places are the same or the projection hides the whole path.
152
+ */ export function flowArc(a, b, projection, path, curve = 0) {
153
+ if (!geoDistance(a, b)) return null;
154
+ const straight = path({
155
+ type: "LineString",
156
+ coordinates: [
157
+ a,
158
+ b
159
+ ]
160
+ });
161
+ if (!straight) return null;
162
+ const pa = finitePoint(projection(a));
163
+ const pb = finitePoint(projection(b));
164
+ const flat = !clipsToCircle(projection);
165
+ const shown = (p)=>coordinateVisible(path, p);
166
+ const onScreen = ()=>flat && pa && pb && shown(a) && shown(b) ? screenArc(pa, pb, curve) : null;
167
+ if (!pa || !pb || !unbrokenPath(straight, pa, pb)) return onScreen() ?? {
168
+ d: straight,
169
+ points: null
170
+ };
171
+ const chord = Math.hypot(pb[0] - pa[0], pb[1] - pa[1]);
172
+ const count = Math.min(128, Math.max(16, Math.ceil(chord / 4)));
173
+ const points = [];
174
+ for (const p of greatCircle(a, b, count)){
175
+ const q = finitePoint(projection(p));
176
+ if (!q) return onScreen() ?? {
177
+ d: straight,
178
+ points: null
179
+ };
180
+ points.push(q);
181
+ }
182
+ const drawn = curve ? liftPolyline(points, curve) : points;
183
+ return {
184
+ d: curve ? polylinePath(drawn) : straight,
185
+ points: drawn
186
+ };
187
+ }
188
+ /** A projected point as a pair of finite numbers, or null. */ function finitePoint(q) {
189
+ return q && Number.isFinite(q[0]) && Number.isFinite(q[1]) ? [
190
+ q[0],
191
+ q[1]
192
+ ] : null;
193
+ }
194
+ /**
195
+ The runs of a path's `d` made of moves and lines (as d3-geo draws a
196
+ line, and `polylinePath` writes one): one polyline per `M`.
197
+ */ export function pathRuns(d) {
198
+ const runs = [];
199
+ for (const [, command, args] of d.matchAll(/([ML])([^ML]*)/gi)){
200
+ const n = (args.match(/-?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?/gi) ?? []).map(Number);
201
+ if (command.toUpperCase() === "M" || !runs.length) runs.push([]);
202
+ const run = runs[runs.length - 1];
203
+ for(let k = 0; k + 1 < n.length; k += 2)run.push([
204
+ n[k],
205
+ n[k + 1]
206
+ ]);
207
+ }
208
+ return runs.filter((run)=>run.length > 1);
209
+ }
210
+ /**
211
+ Whether a projection clips the sphere to a circle (a globe, or any
212
+ projection with a `clipAngle`), where a bowed arc would leave the disc.
213
+ */ export function clipsToCircle(projection) {
214
+ const clipAngle = projection?.clipAngle;
215
+ if (typeof clipAngle !== "function") return false;
216
+ const angle = clipAngle.call(projection);
217
+ // An unset clip angle reads as 0 (clipping only at the antimeridian).
218
+ return typeof angle === "number" && Number.isFinite(angle) && angle > 0;
219
+ }
220
+ /** Whether the projection draws a coordinate, read through its clipping stream. */ export function coordinateVisible(path, coord) {
221
+ return !!path({
222
+ type: "Point",
223
+ coordinates: coord
224
+ });
225
+ }