@d3plus/core 4.10.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +162 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +132 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +204 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +3 -3
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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
+ }
@@ -0,0 +1,239 @@
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
+ */ import { extent } from "d3-array";
12
+ import * as scales from "d3-scale";
13
+ import { forgetLinkNodes, makeLinkDatum, publishLinkGraph, setLinkValue } from "../features/linkInteraction.js";
14
+ import { bundleLinkPaths } from "../features/linkBundle.js";
15
+ import { clipsToCircle, coordinateVisible, featureAnchor, flowArc, greatCircleCut, isLonLat, polylineBox, polylinePath, toLonLat } from "./flowGeometry.js";
16
+ /**
17
+ What a link end refers to: a coordinate, an id (as a string), or null
18
+ for anything else.
19
+ */ export function linkEndRef(ref) {
20
+ if (isLonLat(ref)) return [
21
+ ref[0],
22
+ ref[1]
23
+ ];
24
+ if (typeof ref === "string") return ref;
25
+ if (typeof ref === "number" && Number.isFinite(ref)) return `${ref}`;
26
+ if (ref && typeof ref === "object" && "id" in ref) {
27
+ const id = ref.id;
28
+ if (typeof id === "string" || typeof id === "number") return `${id}`;
29
+ }
30
+ return null;
31
+ }
32
+ /** A coordinate's name: its longitude and latitude, in the chart's locale. */ export function coordinateLabel(coord, locale) {
33
+ let format;
34
+ try {
35
+ const f = new Intl.NumberFormat(locale || undefined, {
36
+ maximumFractionDigits: 2
37
+ });
38
+ format = (n)=>f.format(n);
39
+ } catch {
40
+ format = (n)=>`${Math.round(n * 100) / 100}`;
41
+ }
42
+ return `${format(coord[0])}, ${format(coord[1])}`;
43
+ }
44
+ /**
45
+ Builds the resolver that turns a link end into the place it names on the
46
+ map (see the module notes), or null when it names nothing.
47
+ */ export function flowEndResolver(v, input) {
48
+ const points = new Map();
49
+ input.pointData.forEach((d, i)=>{
50
+ const coord = toLonLat(v.schema.point(d, i));
51
+ if (!coord) return;
52
+ const id = `${v._id(d, i)}`;
53
+ if (points.has(id)) return;
54
+ const r = input.pointR(d, i);
55
+ points.set(id, {
56
+ data: d,
57
+ i,
58
+ id,
59
+ coord,
60
+ shape: "Circle",
61
+ r: Number.isFinite(r) ? r : 0
62
+ });
63
+ });
64
+ const shapes = new Map();
65
+ input.topoData.forEach((row, i)=>{
66
+ const id = `${row.id}`;
67
+ if (!shapes.has(id)) shapes.set(id, {
68
+ row,
69
+ i
70
+ });
71
+ });
72
+ const anchors = new Map();
73
+ const coords = new Map();
74
+ const locale = v.schema.locale;
75
+ return (ref)=>{
76
+ const key = linkEndRef(ref);
77
+ if (key === null) return null;
78
+ if (typeof key !== "string") {
79
+ const id = key.join(",");
80
+ if (!coords.has(id)) coords.set(id, {
81
+ data: {
82
+ point: key
83
+ },
84
+ i: 0,
85
+ id,
86
+ label: coordinateLabel(key, locale),
87
+ coord: key,
88
+ r: 0
89
+ });
90
+ return coords.get(id);
91
+ }
92
+ const point = points.get(key);
93
+ if (point) return point;
94
+ if (!anchors.has(key)) {
95
+ const shape = shapes.get(key);
96
+ const coord = shape ? featureAnchor(shape.row.feature) : null;
97
+ anchors.set(key, shape && coord ? {
98
+ // The datum the shape is drawn with, so hovering it finds its links.
99
+ data: shape.row.data ?? shape.row,
100
+ i: shape.i,
101
+ id: key,
102
+ coord,
103
+ shape: "Path",
104
+ r: 0
105
+ } : null);
106
+ }
107
+ return anchors.get(key);
108
+ };
109
+ }
110
+ /**
111
+ The `[longitude, latitude]` ends of `links`, which the map's initial fit
112
+ takes in when it frames coordinate points.
113
+ */ export function flowLinkCoordinates(links) {
114
+ if (!Array.isArray(links)) return [];
115
+ const out = [];
116
+ for (const link of links){
117
+ if (!link || typeof link !== "object") continue;
118
+ for (const ref of [
119
+ link.source,
120
+ link.target
121
+ ])if (isLonLat(ref)) out.push([
122
+ ref[0],
123
+ ref[1]
124
+ ]);
125
+ }
126
+ return out;
127
+ }
128
+ /**
129
+ Link stroke widths from their `linkSize` values: scaled by the
130
+ continuous d3-scale `scaleName` onto `[min, max]` pixels when the values
131
+ differ, else each value as is. A missing value takes `min`.
132
+ */ export function flowLinkWidths(sizes, { scale, min, max }) {
133
+ const values = sizes.map((s)=>typeof s === "number" && Number.isFinite(s) ? s : undefined);
134
+ const [lo, hi] = extent(values.filter((s)=>s !== undefined));
135
+ if (lo === undefined || hi === undefined || lo === hi) return values.map((s)=>s ?? min);
136
+ const name = `${scale || "sqrt"}`;
137
+ const factory = scales[`scale${name.charAt(0).toUpperCase()}${name.slice(1)}`];
138
+ const make = factory ?? scales.scaleSqrt;
139
+ const fn = make().domain([
140
+ lo,
141
+ hi
142
+ ]).range([
143
+ min,
144
+ Math.max(min, max)
145
+ ]);
146
+ return values.map((s)=>s === undefined ? min : fn(s));
147
+ }
148
+ /** The box around a path's points, read from its `d`. */ function pathBox(d) {
149
+ const n = (d.match(/-?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?/gi) ?? []).map(Number);
150
+ const points = [];
151
+ for(let k = 0; k + 1 < n.length; k += 2)points.push([
152
+ n[k],
153
+ n[k + 1]
154
+ ]);
155
+ return points.length ? polylineBox(points) : [
156
+ [
157
+ 0,
158
+ 0
159
+ ],
160
+ [
161
+ 0,
162
+ 0
163
+ ]
164
+ ];
165
+ }
166
+ /**
167
+ Bundles the links when `linkBundle` is on (see `bundleEdges`), on a flat
168
+ map only: each link the projection draws unbroken, both ends shown,
169
+ takes a bundled path between its two ends. Links on a globe, or ones
170
+ the projection cuts, keep their paths.
171
+ */ export function bundleFlowLinks(v, links, projection, path) {
172
+ if (!v.schema.linkBundle || clipsToCircle(projection)) return;
173
+ const shown = links.filter((l)=>l.points && l.sourceAt && l.targetAt && !greatCircleCut(l.source.coord, l.target.coord, projection, path));
174
+ if (!shown.length) return;
175
+ const paths = bundleLinkPaths(v, shown.map((l)=>[
176
+ l.points[0],
177
+ l.points[l.points.length - 1]
178
+ ]));
179
+ shown.forEach((l, k)=>{
180
+ l.points = paths[k];
181
+ l.d = polylinePath(paths[k]);
182
+ l.box = polylineBox(paths[k]);
183
+ });
184
+ }
185
+ /**
186
+ Resolves, sizes, and shapes the chart's `links` for this draw, and
187
+ publishes them for tooltips and hover (see `publishLinkGraph`).
188
+ */ export function geomapFlowLinks(v, input) {
189
+ if (v._facetStep !== "panel") forgetLinkNodes(v);
190
+ const raw = Array.isArray(v.schema.links) ? v.schema.links : [];
191
+ const resolve = flowEndResolver(v, input);
192
+ const projection = v.schema.projection;
193
+ // On a globe a bowed arc would leave the disc, so links follow the sphere.
194
+ const drawnAt = (coord)=>{
195
+ const p = coordinateVisible(input.path, coord) ? projection(coord) : null;
196
+ return p && Number.isFinite(p[0]) && Number.isFinite(p[1]) ? p : null;
197
+ };
198
+ const curve = clipsToCircle(projection) ? 0 : Number(v.schema.linkCurve) || 0;
199
+ const drawn = [];
200
+ raw.forEach((row, index)=>{
201
+ if (!row || typeof row !== "object") return;
202
+ const source = resolve(row.source);
203
+ const target = resolve(row.target);
204
+ if (!source || !target) return;
205
+ const arc = flowArc(source.coord, target.coord, projection, input.path, curve);
206
+ if (!arc) return;
207
+ drawn.push({
208
+ datum: makeLinkDatum(row, source, target, index),
209
+ index,
210
+ source,
211
+ target,
212
+ ...arc,
213
+ sourceAt: drawnAt(source.coord),
214
+ targetAt: drawnAt(target.coord),
215
+ box: arc.points ? polylineBox(arc.points) : pathBox(arc.d)
216
+ });
217
+ });
218
+ bundleFlowLinks(v, drawn, projection, input.path);
219
+ // Sized over the links drawn.
220
+ const linkSize = v.schema.linkSize;
221
+ const widths = flowLinkWidths(drawn.map((l)=>setLinkValue(l.datum, linkSize(l.datum, l.index))), {
222
+ scale: v.schema.linkSizeScale,
223
+ min: Number(v.schema.linkSizeMin) || 0,
224
+ max: Number(v.schema.linkSizeMax) || 0
225
+ });
226
+ const links = drawn.map((l, k)=>({
227
+ ...l,
228
+ size: widths[k]
229
+ }));
230
+ const ends = new Map();
231
+ for (const link of links)for (const end of [
232
+ link.source,
233
+ link.target
234
+ ])if (end.shape) ends.set(end.id, end);
235
+ publishLinkGraph(v, links.map((l)=>l.datum), [
236
+ ...ends.values()
237
+ ]);
238
+ return links;
239
+ }