@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,219 @@
1
+ /**
2
+ Gantt — a project schedule: one labeled row per task, its bar running
3
+ from its start to its end over a time axis, with milestones, phases,
4
+ dependency arrows, progress, and a "today" line.
5
+
6
+ Implementation files in this folder:
7
+ - `ganttRows.ts` — pure: task fields, ordering, and group rows.
8
+ - `ganttGeometry.ts` — pure: diamonds, progress, brackets, elbows.
9
+ - `ganttLabels.ts` — the label column's font and fitted labels.
10
+ - `ganttTooltip.ts` — task times, tooltip rows, and aria labels.
11
+ - `applyLayout.ts` — chart-specific `TransformStage`.
12
+ - `ganttDecor.ts` — labels, brackets, dependencies, "today".
13
+ - `emit.ts` — the scene nodes of each task.
14
+ */ import { mean } from "d3-array";
15
+ import { Axis } from "../../components/index.js";
16
+ import accessor from "../../utils/accessor.js";
17
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
18
+ import { makeChart } from "../definition/makeChart.js";
19
+ import { seedTimeAggs, timeFields } from "../Priestley/timeAxis.js";
20
+ import { applyGanttLayout } from "./applyLayout.js";
21
+ import { ganttEmit } from "./emit.js";
22
+ import { normalizeProgress } from "./ganttRows.js";
23
+ import { ganttTooltipRows } from "./ganttTooltip.js";
24
+ /**
25
+ Coerces a per-row option: a function is kept, a string becomes a data-key
26
+ accessor, and anything else turns it off.
27
+ */ export function taskAccessor(v) {
28
+ if (typeof v === "function") return v;
29
+ if (typeof v === "string" && v) return fieldAccessor(v);
30
+ return false;
31
+ }
32
+ /**
33
+ Averages grouped rows' progress (as `aggs` call it, with the rows and an
34
+ accessor), reading percent strings as fractions.
35
+ */ export function progressAgg(rows, value) {
36
+ return mean(rows.map((d)=>normalizeProgress(value(d))).filter((v)=>v !== undefined));
37
+ }
38
+ /** The `progress` field's `onSet`: a data key averages grouped rows' progress. */ const seedProgressAgg = (viz, v)=>{
39
+ const key = typeof v === "string" ? v : null;
40
+ if (key && !viz.schema.aggs[key]) viz.schema.aggs[key] = progressAgg;
41
+ };
42
+ export const ganttDef = {
43
+ name: "Gantt",
44
+ layoutStage: applyGanttLayout,
45
+ emit: ganttEmit,
46
+ setup: (viz)=>{
47
+ seedTimeAggs(viz);
48
+ if (!viz.schema.aggs.progress) viz.schema.aggs.progress = progressAgg;
49
+ },
50
+ ctx: {
51
+ axis: new Axis().align("start").orient("top"),
52
+ axisTest: new Axis().align("start").gridSize(0).orient("top")
53
+ },
54
+ fields: [
55
+ /**
56
+ The time axis along the top of the rows (`orient: "bottom"` moves it
57
+ under them). It reads dates by default (`scale: "time"`); a
58
+ `rangeBreaks` setting such as `"weekends"` hides those times, and a
59
+ task's Duration then counts only the working days left showing.
60
+ */ {
61
+ key: "axisConfig",
62
+ merge: true,
63
+ default: {
64
+ scale: "time"
65
+ }
66
+ },
67
+ /**
68
+ Accessor function or string key for each task's predecessors: the ids
69
+ (by `groupBy`) of the tasks it waits on, as an array or a
70
+ comma-separated string. Each draws an arrow from the predecessor's end
71
+ to this task's start.
72
+ @type {string | function | false}
73
+ */ {
74
+ key: "dependencies",
75
+ default: accessor("dependencies"),
76
+ coerce: taskAccessor
77
+ },
78
+ /**
79
+ Styles the dependency arrows: `stroke` (the chart's text color by
80
+ default), `strokeWidth` (1), `strokeOpacity` (0.55), and `arrowSize`
81
+ (6, in pixels).
82
+ @type {{stroke, strokeWidth, strokeOpacity, arrowSize}}
83
+ */ {
84
+ key: "dependencyConfig",
85
+ merge: true,
86
+ default: {}
87
+ },
88
+ ...timeFields(),
89
+ /**
90
+ Accessor function or string key for each task's group (such as its
91
+ project phase). Grouped tasks sit under a header row that names the
92
+ group, with a bracket spanning its tasks.
93
+ @type {string | function | false}
94
+ */ {
95
+ key: "group",
96
+ default: false,
97
+ coerce: taskAccessor
98
+ },
99
+ /**
100
+ The most the task label column on the left may take: a share of the
101
+ chart's width when 1 or below (`0.3` by default), else pixels. The
102
+ column fits the widest label up to it, wrapping or truncating longer
103
+ ones; `0` hides it.
104
+ */ {
105
+ key: "labelWidth",
106
+ default: 0.3
107
+ },
108
+ /**
109
+ Shows a legend only when its entries group the tasks (for example, a
110
+ `color` by phase), since every task is labeled in its row.
111
+ */ {
112
+ key: "legend",
113
+ coerce: "const",
114
+ factory: (viz)=>{
115
+ const base = viz.schema.legend;
116
+ return (config, arr)=>{
117
+ const rows = viz._filteredData ?? [];
118
+ if (arr.length >= rows.length) return false;
119
+ return base.call(viz, config, arr);
120
+ };
121
+ }
122
+ },
123
+ /**
124
+ Accessor function or string key for whether a task is a milestone,
125
+ drawn as a diamond at its `end`. Without one, a task that starts and
126
+ ends at the same time is a milestone.
127
+ @type {string | function | false}
128
+ */ {
129
+ key: "milestone",
130
+ default: accessor("milestone"),
131
+ coerce: taskAccessor
132
+ },
133
+ /**
134
+ The space between neighboring task bars, as a share of each row
135
+ (see d3's
136
+ [paddingInner](https://github.com/d3/d3-scale#band_paddingInner)).
137
+ */ {
138
+ key: "paddingInner",
139
+ default: 0.35
140
+ },
141
+ /**
142
+ The space above the first row and below the last, as a share of a row
143
+ (see d3's
144
+ [paddingOuter](https://github.com/d3/d3-scale#band_paddingOuter)).
145
+ */ {
146
+ key: "paddingOuter",
147
+ default: 0.2
148
+ },
149
+ /**
150
+ Accessor function or string key for each task's progress: a fraction
151
+ from 0 to 1 (`0.6`), or a percent string (`"60%"`). The done part of
152
+ the bar fills in the task's color and the rest in a paler shade; the
153
+ tooltip lists it. A milestone below 100% draws pale and outlined. A
154
+ key also averages grouped rows' progress.
155
+ @type {string | function | false}
156
+ */ {
157
+ key: "progress",
158
+ default: accessor("progress"),
159
+ coerce: taskAccessor,
160
+ onSet: seedProgressAgg
161
+ },
162
+ /**
163
+ The order of the tasks: `"data"` (default) keeps the data's order,
164
+ `"start"` sorts them by start, and a function compares two data rows.
165
+ Groups follow their first task.
166
+ @type {"data" | "start" | function}
167
+ */ {
168
+ key: "taskSort",
169
+ default: "data"
170
+ },
171
+ /**
172
+ Styles the task label column: `fontColor` (the chart's text color by
173
+ default), `fontFamily`, and `fontSize` (12).
174
+ @type {{fontColor, fontFamily, fontSize}}
175
+ */ {
176
+ key: "taskLabelConfig",
177
+ merge: true,
178
+ default: {}
179
+ },
180
+ /**
181
+ Draws a "today" line across the rows: `true` at the current time, or a
182
+ date (or anything the axis parses) to mark that time. Off (`false`) by
183
+ default. It only draws inside the time axis.
184
+ @type {boolean | Date | string | number}
185
+ */ {
186
+ key: "today",
187
+ default: false
188
+ },
189
+ /**
190
+ Styles the "today" line like a `referenceLines` entry: `stroke`,
191
+ `strokeWidth` (1.5), `strokeOpacity` (0.85), `dash`, and its `label`
192
+ (the translated "Today"; `false` for none), with the label's font
193
+ settings and `labelPosition`.
194
+ @type {ReferenceLineConfig}
195
+ */ {
196
+ key: "todayConfig",
197
+ merge: true,
198
+ default: {}
199
+ },
200
+ /** Lists each task's Start, End, Duration, and Progress in the tooltip body. */ {
201
+ key: "tooltipConfig",
202
+ merge: true,
203
+ factory: (viz)=>({
204
+ tbody: (d, i)=>ganttTooltipRows(viz, d, i)
205
+ })
206
+ },
207
+ /** Zooming doesn't help read a schedule's rows, so it's off by default. */ {
208
+ key: "zoom",
209
+ default: false
210
+ }
211
+ ]
212
+ };
213
+ /**
214
+ Creates a Gantt chart from an array of tasks: one labeled row per task,
215
+ its bar running from `start` to `end` over a time axis. Tasks can be
216
+ grouped into phases (`group`), drawn as milestones (`milestone`), linked
217
+ by dependency arrows (`dependencies`), and filled by their `progress`,
218
+ with an optional `today` line.
219
+ */ export default makeChart(ganttDef);
@@ -5,13 +5,12 @@
5
5
  */ import { extent, max, quantile } from "d3-array";
6
6
  import * as d3GeoCore from "d3-geo";
7
7
  import * as scales from "d3-scale";
8
- import { feature as topojsonFeature } from "topojson-client";
9
8
  import { pointDistance } from "@d3plus/math";
10
9
  import { chartBounds } from "../features/chartGeometry.js";
11
- function topo2feature(topo, key) {
12
- const k = key && topo.objects[key] ? key : Object.keys(topo.objects)[0];
13
- return topojsonFeature(topo, k);
14
- }
10
+ import { flowLinkCoordinates, geomapFlowLinks } from "./flowLinks.js";
11
+ import { clipsToCircle, coordinateVisible, toLonLat } from "./flowGeometry.js";
12
+ import { cachedPaths, fitExtentOnce, topoFeatures } from "./geoCache.js";
13
+ import { globeHome } from "./globeRotate.js";
15
14
  /** Reduces fit features, trimming far-flung MultiPolygon parts via path geometry. */ function reduceExtentFeatures(features, path) {
16
15
  return features.reduce((arr, raw)=>{
17
16
  const d = raw;
@@ -56,7 +55,10 @@ function topo2feature(topo, key) {
56
55
  return arr;
57
56
  }, []);
58
57
  }
59
- /** Builds projected-point extent bounds + padding when no fit features exist. */ function applyPointExtentBounds(v, ctx, pointData, r) {
58
+ /**
59
+ Builds projected-point extent bounds + padding when no fit features
60
+ exist, from the coordinate points and the coordinate ends of `links`.
61
+ */ function applyPointExtentBounds(v, ctx, pointData, r, linkCoords) {
60
62
  const bounds = [
61
63
  [
62
64
  undefined,
@@ -67,8 +69,10 @@ function topo2feature(topo, key) {
67
69
  undefined
68
70
  ]
69
71
  ];
70
- pointData.forEach((d, i)=>{
71
- const point = v.schema.projection(v.schema.point(d, i));
72
+ const coords = pointData.map((d, i)=>v.schema.point(d, i)).concat(linkCoords);
73
+ coords.forEach((coord)=>{
74
+ const point = v.schema.projection(coord);
75
+ if (!point) return;
72
76
  if (bounds[0][0] === void 0 || point[0] < bounds[0][0]) bounds[0][0] = point[0];
73
77
  if (bounds[1][0] === void 0 || point[0] > bounds[1][0]) bounds[1][0] = point[0];
74
78
  if (bounds[0][1] === void 0 || point[1] < bounds[0][1]) bounds[0][1] = point[1];
@@ -86,7 +90,7 @@ function topo2feature(topo, key) {
86
90
  }
87
91
  ]
88
92
  };
89
- const maxSize = max(pointData, (d, i)=>r(v.schema.pointSize(d, i)));
93
+ const maxSize = max(pointData, (d, i)=>r(v.schema.pointSize(d, i))) ?? 0;
90
94
  ctx.effectivePadding = {
91
95
  top: v.schema.projectionPadding.top + maxSize,
92
96
  right: v.schema.projectionPadding.right + maxSize,
@@ -104,11 +108,73 @@ function topo2feature(topo, key) {
104
108
  v.schema.pointSizeMax
105
109
  ]);
106
110
  }
111
+ /**
112
+ The coordinate points the fitted projection draws: those its clipping
113
+ keeps, read through d3-geo's path of each point (a projection alone
114
+ places points on the far side of a globe, or outside geoAlbersUsa's
115
+ insets, as if they were visible).
116
+ */ export function visiblePointData(v, pointData, path) {
117
+ return pointData.filter((d, i)=>{
118
+ const coord = toLonLat(v.schema.point(d, i));
119
+ return coord !== null && coordinateVisible(path, coord);
120
+ });
121
+ }
122
+ /**
123
+ Picks the features (or, without any, the coordinate points and the
124
+ coordinate ends of `links`) the projection fits, onto `ctx.extentBounds`.
125
+ */ function fitExtentBounds(v, ctx, coordData, path, pointData, r) {
126
+ // The point-radius padding belongs with the extent it was computed for,
127
+ // so a later draw that reuses the cached extent fits the same way.
128
+ ctx.effectivePadding = undefined;
129
+ const fitData = v.schema.fitObject ? topoFeatures(v.schema.fitObject, v.schema.fitKey) : coordData;
130
+ ctx.extentBounds = {
131
+ type: "FeatureCollection",
132
+ features: v.schema.fitFilter ? fitData.features.filter(v.schema.fitFilter) : fitData.features.slice()
133
+ };
134
+ ctx.extentBounds.features = reduceExtentFeatures(ctx.extentBounds.features, path);
135
+ const linkCoords = flowLinkCoordinates(v.schema.links);
136
+ if (!ctx.extentBounds.features.length && (pointData.length || linkCoords.length)) {
137
+ applyPointExtentBounds(v, ctx, pointData, r, linkCoords);
138
+ }
139
+ }
140
+ /**
141
+ Fits the projection to `ctx.extentBounds` (or the whole sphere)
142
+ within the chart area, less its padding. A globe the user has turned is
143
+ fitted at its home rotation (see `globeHome`) and turned back, so its
144
+ scale doesn't change with the side it shows.
145
+ */ function fitProjection(v, ctx, width, height) {
146
+ const effectivePadding = ctx.effectivePadding || v.schema.projectionPadding;
147
+ const home = clipsToCircle(v.schema.projection) ? globeHome(v) : undefined;
148
+ const live = home ? v.schema.projection.rotate() : undefined;
149
+ if (home) v.schema.projection.rotate(home);
150
+ fitExtentOnce(v.schema.projection, ctx.extentBounds.features.length ? [
151
+ [
152
+ effectivePadding.left,
153
+ effectivePadding.top
154
+ ],
155
+ [
156
+ width - effectivePadding.right,
157
+ height - effectivePadding.bottom
158
+ ]
159
+ ] : [
160
+ [
161
+ 0,
162
+ 0
163
+ ],
164
+ [
165
+ width,
166
+ height
167
+ ]
168
+ ], ctx.extentBounds.features.length ? ctx.extentBounds : {
169
+ type: "Sphere"
170
+ });
171
+ if (live) v.schema.projection.rotate(live);
172
+ }
107
173
  export const applyGeomapLayout = ({ viz })=>{
108
174
  const v = viz;
109
175
  const ctx = viz.ctx;
110
176
  const { width, height } = chartBounds(v);
111
- const coordData = v.schema.topojson ? topo2feature(v.schema.topojson, v.schema.topojsonKey) : {
177
+ const coordData = v.schema.topojson ? topoFeatures(v.schema.topojson, v.schema.topojsonKey) : {
112
178
  type: "FeatureCollection",
113
179
  features: []
114
180
  };
@@ -133,49 +199,24 @@ export const applyGeomapLayout = ({ viz })=>{
133
199
  }, []);
134
200
  const r = geomapPointSizeScale(v, pointData);
135
201
  v._sizeLegendFinal = pointData.length ? r : null;
136
- if (!v._zoomSet || !ctx.extentBounds) {
137
- // The point-radius padding belongs with the extent it was computed for,
138
- // so a later draw that reuses the cached extent fits the same way.
139
- ctx.effectivePadding = undefined;
140
- const fitData = v.schema.fitObject ? topo2feature(v.schema.fitObject, v.schema.fitKey) : coordData;
141
- ctx.extentBounds = {
142
- type: "FeatureCollection",
143
- features: v.schema.fitFilter ? fitData.features.filter(v.schema.fitFilter) : fitData.features.slice()
144
- };
145
- ctx.extentBounds.features = reduceExtentFeatures(ctx.extentBounds.features, path);
146
- if (!ctx.extentBounds.features.length && pointData.length) {
147
- applyPointExtentBounds(v, ctx, pointData, r);
148
- }
149
- }
150
- const effectivePadding = ctx.effectivePadding || v.schema.projectionPadding;
151
- v.schema.projection = v.schema.projection.fitExtent(ctx.extentBounds.features.length ? [
152
- [
153
- effectivePadding.left,
154
- effectivePadding.top
155
- ],
156
- [
157
- width - effectivePadding.right,
158
- height - effectivePadding.bottom
159
- ]
160
- ] : [
161
- [
162
- 0,
163
- 0
164
- ],
165
- [
166
- width,
167
- height
168
- ]
169
- ], ctx.extentBounds.features.length ? ctx.extentBounds : {
170
- type: "Sphere"
171
- });
202
+ if (!v._zoomSet || !ctx.extentBounds) fitExtentBounds(v, ctx, coordData, path, pointData, r);
203
+ // A globe being dragged keeps the scale it was fitted at.
204
+ if (!v._globeDragging) fitProjection(v, ctx, width, height);
172
205
  ctx.geomapWidth = width;
173
206
  ctx.geomapHeight = height;
207
+ const featurePath = cachedPaths(v.schema.projection, path);
208
+ const pointR = (d, i)=>r(v.schema.pointSize(d, i));
174
209
  ctx.geomapCtx = {
210
+ flowLinks: geomapFlowLinks(v, {
211
+ pointData,
212
+ topoData: topoData,
213
+ pointR,
214
+ path: path
215
+ }),
175
216
  topoData,
176
- pathFn: (d)=>path(d.feature),
177
- pointData,
178
- pointR: (d, i)=>r(v.schema.pointSize(d, i)),
217
+ pathFn: (d)=>featurePath(d.feature),
218
+ pointData: visiblePointData(v, pointData, path),
219
+ pointR,
179
220
  pointSort: (a, b)=>v.schema.pointSize(b) - v.schema.pointSize(a),
180
221
  pointX: (d, i)=>v.schema.projection(v.schema.point(d, i))[0],
181
222
  pointY: (d, i)=>v.schema.projection(v.schema.point(d, i))[1]
@@ -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,132 @@
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 } 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.
40
+ */ export function flowArrowEdge(viz, link, fill) {
41
+ const trims = edgeArrowTrims({
42
+ arrows: viz.schema.arrows,
43
+ arrowSize: viz.schema.arrowSize,
44
+ strokeWidth: link.size,
45
+ datum: link.datum,
46
+ i: link.index
47
+ });
48
+ if (!trims.ends.source && !trims.ends.target) return {
49
+ d: link.d,
50
+ arrows: []
51
+ };
52
+ const runs = pathRuns(link.d);
53
+ const last = runs[runs.length - 1];
54
+ const inset = (r)=>r ? r + 1 : 0;
55
+ // The first run leaves the source and the last reaches the target, when
56
+ // the projection draws them.
57
+ const ends = {
58
+ source: trims.ends.source && startsAt(runs[0], link.sourceAt),
59
+ target: trims.ends.target && startsAt(last ? [
60
+ ...last
61
+ ].reverse() : undefined, link.targetAt)
62
+ };
63
+ const { d, source, target } = polylineArrowEdge(runs, {
64
+ ...trims,
65
+ ends
66
+ }, {
67
+ source: inset(link.source.r),
68
+ target: inset(link.target.r)
69
+ });
70
+ return {
71
+ d,
72
+ arrows: chordArrowNodes({
73
+ ends: {
74
+ source,
75
+ target
76
+ },
77
+ size: trims.size,
78
+ datum: link.datum,
79
+ keyPrefix: `${flowLinkKey(link)}-arrow`,
80
+ fill
81
+ })
82
+ };
83
+ }
84
+ /** The links, their hit paths, and their arrowheads, in that order. */ export function emitFlowLinks(viz, links) {
85
+ if (!links.length) return [];
86
+ const color = linkColorResolver(viz);
87
+ const gray = flowLinkGray(viz);
88
+ const paths = [];
89
+ const hits = [];
90
+ const arrows = [];
91
+ // Widest first, so a thin link stays visible over a wide one.
92
+ const order = [
93
+ ...links
94
+ ].sort((a, b)=>b.size - a.size || a.index - b.index);
95
+ for (const link of order){
96
+ const paint = flowLinkPaint(viz, link, color, gray);
97
+ const key = flowLinkKey(link);
98
+ const edge = flowArrowEdge(viz, link, typeof paint.stroke === "string" ? paint.stroke : undefined);
99
+ // A stroke ending inside its head ends square, so no cap pokes past it.
100
+ if (edge.arrows.length) paint.strokeLinecap = "butt";
101
+ paths.push({
102
+ type: "path",
103
+ key,
104
+ d: edge.d,
105
+ datum: link.datum,
106
+ index: link.index,
107
+ paint,
108
+ aria: {
109
+ label: linkAriaLabel(viz, link.datum)
110
+ }
111
+ });
112
+ hits.push(linkHitPath(key, link.d, link.datum, link.size));
113
+ arrows.push(...edge.arrows);
114
+ }
115
+ return [
116
+ ...paths,
117
+ ...hits,
118
+ ...arrows
119
+ ];
120
+ }
121
+ /** The link labels, at the middle of each link, clear of the points. */ export function emitFlowLabels(viz, links, circles) {
122
+ return emitLinkLabels(viz, links.map((link, i)=>({
123
+ key: flowLinkKey(link),
124
+ link: link.datum,
125
+ i,
126
+ anchor: link.points ? polylineMidpoint(link.points) : null,
127
+ path: link.points,
128
+ priority: link.size
129
+ })), {
130
+ circles
131
+ });
132
+ }