@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,171 @@
1
+ /**
2
+ ArcDiagram's node labels: one line each, on the side of the line away
3
+ from the arcs (under it when arcs take both sides, over a halo). Labels
4
+ that are too wide for their slot turn to -45°, then to -90° when even
5
+ that crowds, and when neighbors are closer than a line of text only
6
+ every few labels draw. Rotating keeps every label directly under its
7
+ node, in node order, which reads better along a dense line than
8
+ scattering labels into free space around each circle.
9
+ */ import { rtl } from "@d3plus/dom";
10
+ import { emitLabels } from "../../shapes/emitLabels.js";
11
+ import constant from "../../utils/constant.js";
12
+ import { backgroundInk, chartBackground } from "../viz/backgroundInk.js";
13
+ import { textHalo } from "../features/textHalo.js";
14
+ import { pointLabelSettings } from "../features/circleLabels.js";
15
+ const SIN45 = Math.SQRT1_2;
16
+ /**
17
+ Fits labels to node spacing: flat when the widest fits its slot, -45°
18
+ when neighbors sit far enough apart for slanted lines, else -90°. When
19
+ even upright lines crowd (vertical lines take flat labels only), every
20
+ `step`-th label draws.
21
+ @param maxWidth The widest label, in pixels.
22
+ @param spacing The distance between neighboring nodes.
23
+ @param lineHeight A label's line height.
24
+ */ export function fitLabels(maxWidth, spacing, lineHeight, orient) {
25
+ const step = (need)=>spacing >= need ? 1 : Math.ceil(need / Math.max(spacing, 1e-6));
26
+ if (orient === "vertical") return {
27
+ angle: 0,
28
+ step: step(lineHeight)
29
+ };
30
+ if (maxWidth <= spacing) return {
31
+ angle: 0,
32
+ step: 1
33
+ };
34
+ if (spacing * SIN45 >= lineHeight) return {
35
+ angle: -45,
36
+ step: 1
37
+ };
38
+ return {
39
+ angle: -90,
40
+ step: step(lineHeight)
41
+ };
42
+ }
43
+ /**
44
+ How far a label reaches out from the line (`depth`) and along it past its
45
+ node (`spread`), at `width` pixels wide and `angle` degrees.
46
+ */ export function labelReach(angle, width, lineHeight, orient) {
47
+ if (orient === "vertical") return {
48
+ depth: width,
49
+ spread: lineHeight / 2
50
+ };
51
+ if (angle === 0) return {
52
+ depth: lineHeight,
53
+ spread: width / 2
54
+ };
55
+ if (angle === -90) return {
56
+ depth: width,
57
+ spread: lineHeight / 2
58
+ };
59
+ return {
60
+ depth: (width + lineHeight / 2) * SIN45,
61
+ spread: (width + lineHeight / 2) * SIN45
62
+ };
63
+ }
64
+ /**
65
+ The widest a label may be so it reaches no more than `maxDepth` out from
66
+ the line (rotated or vertical-line labels only; flat labels on a
67
+ horizontal line are one line tall at any width).
68
+ */ export function labelWidthLimit(angle, maxDepth, lineHeight, orient) {
69
+ if (orient === "horizontal" && angle === 0) return Infinity;
70
+ if (orient === "horizontal" && angle === -45) return Math.max(0, maxDepth / SIN45 - lineHeight / 2);
71
+ return Math.max(0, maxDepth);
72
+ }
73
+ /**
74
+ Places a label at one node. `side` is the side of the line the labels
75
+ take ("below" is under a horizontal line or left of a vertical one);
76
+ `gap` is the distance from the line to the label's near edge.
77
+ */ export function placeArcLabel(opts) {
78
+ const { at, base, gap, width, spacing, lineHeight, angle, side } = opts;
79
+ const out = side === "below" ? 1 : -1;
80
+ const common = {
81
+ id: opts.id,
82
+ datum: opts.datum,
83
+ text: opts.text,
84
+ angle
85
+ };
86
+ if (opts.orient === "vertical") {
87
+ // "below" sits left of the line, where text ends at the node.
88
+ return {
89
+ ...common,
90
+ x: base - out * gap,
91
+ y: at,
92
+ box: {
93
+ x: side === "below" ? -width : 0,
94
+ y: -lineHeight / 2,
95
+ width,
96
+ height: lineHeight
97
+ },
98
+ anchor: side === "below" ? "end" : "start",
99
+ verticalAlign: "middle"
100
+ };
101
+ }
102
+ const y = base + out * gap;
103
+ if (angle === 0) return {
104
+ ...common,
105
+ x: at,
106
+ y,
107
+ box: {
108
+ x: -spacing / 2,
109
+ y: side === "below" ? 0 : -lineHeight,
110
+ width: spacing,
111
+ height: lineHeight
112
+ },
113
+ anchor: "middle",
114
+ verticalAlign: side === "below" ? "top" : "bottom"
115
+ };
116
+ // Rotated: labels under the line end at their node and run down-left;
117
+ // labels over it start at their node and run up-right.
118
+ return {
119
+ ...common,
120
+ x: at,
121
+ y,
122
+ box: {
123
+ x: side === "below" ? -width : 0,
124
+ y: -lineHeight / 2,
125
+ width,
126
+ height: lineHeight
127
+ },
128
+ anchor: side === "below" ? "end" : "start",
129
+ verticalAlign: "middle"
130
+ };
131
+ }
132
+ /** The anchor TextBox draws an anchor with, flipped right to left. */ const textAnchor = (anchor)=>anchor !== "middle" && rtl() ? anchor === "start" ? "end" : "start" : anchor;
133
+ /**
134
+ Text nodes for placed labels: one line each in the chart's ink at
135
+ `pointLabelConfig.fontSize`, inert to the pointer. With `halo`, each
136
+ draws over a halo in the chart's background (see `textHalo`), which
137
+ keeps it readable where arcs pass behind it.
138
+ */ export function emitArcLabels(viz, labels, halo = false) {
139
+ if (!labels.length) return [];
140
+ const settings = pointLabelSettings(viz);
141
+ const byId = new Map(labels.map((l)=>[
142
+ `${l.id}_0`,
143
+ l
144
+ ]));
145
+ const of = (rec)=>byId.get(String(rec.id));
146
+ const nodes = emitLabels({
147
+ data: labels,
148
+ label: (d)=>d.text,
149
+ labelBounds: (d)=>({
150
+ ...d.box
151
+ }),
152
+ x: (d)=>d.x,
153
+ y: (d)=>d.y,
154
+ aes: constant({}),
155
+ rotate: (d)=>d.angle,
156
+ id: (d)=>d.id,
157
+ datum: (d)=>d.datum,
158
+ labelConfig: {
159
+ fontColor: ()=>backgroundInk(viz),
160
+ fontResize: false,
161
+ fontSize: settings.fontSize,
162
+ lineHeight: settings.fontSize * 1.2,
163
+ padding: 0,
164
+ pointerEvents: "none",
165
+ textAnchor: (rec)=>textAnchor(of(rec)?.anchor ?? "middle"),
166
+ verticalAlign: (rec)=>of(rec)?.verticalAlign ?? "middle",
167
+ ...settings.text
168
+ }
169
+ });
170
+ return halo ? textHalo(nodes, chartBackground(viz), Math.max(2, Math.round(settings.fontSize / 4))) : nodes;
171
+ }
@@ -0,0 +1,78 @@
1
+ /**
2
+ ArcDiagram's loops: a link from a node to itself draws as a small loop on
3
+ the arcs' side of the line, pointing straight out from it.
4
+ */ import { layoutSelfLoops, selfLoopExtent, selfLoopReach } from "../features/selfLoops.js";
5
+ /** The side of the line a node's loops take: the arcs' side ("above" with `"both"`). */ export function loopSide(side) {
6
+ return side === "below" ? "below" : "above";
7
+ }
8
+ /**
9
+ How far a hairline loop on a node of radius `r` reaches out from it: as
10
+ a Network loop does (see `selfLoopReach`), and at least 30% of the
11
+ `spacing` between nodes (up to 40 pixels), so it reads at a glance. Its
12
+ stroke grows outward from there (see `selfLoopGeometry`).
13
+ */ export function arcLoopReach(r, spacing) {
14
+ return Math.max(selfLoopReach(r), Math.min(Math.max(0, spacing) * 0.3, 40));
15
+ }
16
+ /** The direction (radians) loops point on `side` of a line running `orient`. */ export function loopAngle(side, orient) {
17
+ if (orient === "vertical") return side === "above" ? 0 : Math.PI;
18
+ return side === "above" ? -Math.PI / 2 : Math.PI / 2;
19
+ }
20
+ /**
21
+ The laid-out loops (links from a node to themselves), on the arcs' side
22
+ of the line, pointing straight out from it. A node's loops fan out side
23
+ by side.
24
+ */ export function placeLoops(loops, nodes, geometry) {
25
+ const { spacing, ...arc } = geometry;
26
+ const nodeById = new Map(nodes.map((n)=>[
27
+ n.id,
28
+ n
29
+ ]));
30
+ const known = loops.filter((l)=>nodeById.has(l.id));
31
+ const placed = layoutSelfLoops(known, {
32
+ node: (l)=>nodeById.get(l.id),
33
+ angle: ()=>loopAngle(geometry.side, geometry.orient),
34
+ reach: (l)=>arcLoopReach(nodeById.get(l.id).r, spacing),
35
+ strokeWidth: (l)=>l.size
36
+ });
37
+ return known.flatMap((l)=>{
38
+ const node = nodeById.get(l.id);
39
+ const loop = placed.get(l);
40
+ if (!loop) return [];
41
+ const at = geometry.orient === "horizontal" ? node.x : node.y;
42
+ return [
43
+ {
44
+ datum: l.datum,
45
+ source: node,
46
+ target: node,
47
+ size: l.size,
48
+ index: l.index,
49
+ arc: {
50
+ ...arc,
51
+ from: at,
52
+ to: at
53
+ },
54
+ d: loop.d,
55
+ loop
56
+ }
57
+ ];
58
+ });
59
+ }
60
+ /**
61
+ How far the loops reach out from the line, past their nodes' centers,
62
+ on each side (all of them sit on `loopSide(side)`).
63
+ @param loops Each loop's node id and stroke width.
64
+ @param radii Each node's radius, by id.
65
+ */ export function arcLoopRoom(loops, radii, spacing, side) {
66
+ let room = 0;
67
+ for (const l of loops){
68
+ const r = radii.get(l.id) ?? 0;
69
+ room = Math.max(room, r + selfLoopExtent(arcLoopReach(r, spacing), l.size));
70
+ }
71
+ return loopSide(side) === "above" ? {
72
+ above: room,
73
+ below: 0
74
+ } : {
75
+ above: 0,
76
+ below: room
77
+ };
78
+ }
@@ -0,0 +1,178 @@
1
+ /**
2
+ `arcDiagramEmit` — ArcDiagram's scene: the arcs (longest first), a wider
3
+ transparent hit path over each so thin arcs are easy to point at, their
4
+ arrowheads, the nodes, and the node labels.
5
+ */ import { edgeArrowTrims } from "../features/edgeArrows.js";
6
+ import { backgroundImageNode } from "../features/backgroundImageEmit.js";
7
+ import { paintFromShapeConfig, shapeConfigFor } from "../features/emitHelpers.js";
8
+ import { linkAriaLabel, linkHitPath } from "../features/linkInteraction.js";
9
+ import { linkColorResolver } from "../features/linkColor.js";
10
+ import { emitLinkLabels } from "../features/linkLabels.js";
11
+ import { curvePoints, trimToNodes } from "../features/linkLabelPath.js";
12
+ import { arcApex, arcArrowEdge, arcPathD } from "./arcGeometry.js";
13
+ import { chordArrowNodes } from "../features/curvedArrows.js";
14
+ import { emitArcLabels } from "./arcLabels.js";
15
+ import { selfLoopArrows, selfLoopD } from "../features/selfLoops.js";
16
+ /** A node's paint, from the node shape's config. */ function nodePaint(config, n) {
17
+ return paintFromShapeConfig(config, n.data, n.i);
18
+ }
19
+ /** Where an arc's label goes: its highest point (a loop's far point), running with the line. */ export function arcLabelAnchor(link) {
20
+ if (link.loop) return link.loop.apex;
21
+ const [x, y] = arcApex(link.arc);
22
+ return {
23
+ x,
24
+ y,
25
+ angle: link.arc.orient === "vertical" ? Math.PI / 2 : 0
26
+ };
27
+ }
28
+ /**
29
+ The curve an arc's label follows: the arc between the edges of its two
30
+ nodes, or the loop.
31
+ */ export function arcLabelPath(link) {
32
+ if (link.loop) return curvePoints(link.loop.d);
33
+ return trimToNodes(curvePoints(arcPathD(link.arc)), link.source.r, link.target.r);
34
+ }
35
+ /** The arc labels, at the top of each arc, clear of every node. */ function arcLinkLabels(viz, c) {
36
+ return emitLinkLabels(viz, c.links.map((link, i)=>({
37
+ key: arcLinkKey(link),
38
+ link,
39
+ i,
40
+ anchor: arcLabelAnchor(link),
41
+ path: arcLabelPath(link),
42
+ priority: link.size
43
+ })), {
44
+ circles: c.nodes.map((n)=>({
45
+ x: n.x,
46
+ y: n.y,
47
+ r: n.r
48
+ }))
49
+ });
50
+ }
51
+ /** An arc's scene key. */ const arcLinkKey = (link)=>`arc-link-${link.source.id}-${link.target.id}-${link.index}`;
52
+ /** Arrowheads at an arc's (or loop's) selected ends, each pointing along it into its node. */ function arcArrows(viz, link, stroke, key) {
53
+ const datum = link.datum;
54
+ if (link.loop) return selfLoopArrows({
55
+ arrows: viz.schema.arrows,
56
+ arrowSize: viz.schema.arrowSize,
57
+ strokeWidth: link.size,
58
+ datum,
59
+ i: link.index,
60
+ keyPrefix: key,
61
+ fill: stroke,
62
+ loop: link.loop
63
+ });
64
+ const trims = arcTrims(viz, link);
65
+ if (!trims.ends.source && !trims.ends.target) return [];
66
+ return chordArrowNodes({
67
+ ends: arcArrowEdge(link.arc, trims, arcInsets(link)),
68
+ size: trims.size,
69
+ datum,
70
+ keyPrefix: key,
71
+ fill: stroke
72
+ });
73
+ }
74
+ /**
75
+ An arc's (or loop's) visible stroke: along it up to each arrowhead's
76
+ base, then along the head's axis to end inside it (see `arcArrowEdge`),
77
+ whose tips sit a pixel out past the nodes.
78
+ */ export function arcVisibleD(viz, link) {
79
+ const trims = arcTrims(viz, link);
80
+ if (!trims.source && !trims.target) return link.d;
81
+ if (link.loop) return selfLoopD(link.loop, trims);
82
+ return arcArrowEdge(link.arc, trims, arcInsets(link)).d;
83
+ }
84
+ /** An arc's arrow ends, size, and stroke trims. */ const arcTrims = (viz, link)=>edgeArrowTrims({
85
+ arrows: viz.schema.arrows,
86
+ arrowSize: viz.schema.arrowSize,
87
+ strokeWidth: link.size,
88
+ datum: link.datum,
89
+ i: link.index
90
+ });
91
+ /** How far out from the line each of an arc's arrow tips sits: a pixel past its node. */ const arcInsets = (link)=>({
92
+ source: link.source.r + 1,
93
+ target: link.target.r + 1
94
+ });
95
+ /** The arcs, their hit paths, and their arrowheads. */ function emitArcs(viz, c) {
96
+ const linkColor = linkColorResolver(viz);
97
+ const arcs = [];
98
+ const hits = [];
99
+ const arrows = [];
100
+ for (const link of c.links){
101
+ const datum = link.datum;
102
+ const paint = paintFromShapeConfig(c.linkConfig, datum, link.index);
103
+ paint.fill = "none";
104
+ paint.strokeWidth = link.size;
105
+ const stroke = linkColor(datum, link);
106
+ if (stroke) paint.stroke = stroke;
107
+ const key = arcLinkKey(link);
108
+ arcs.push({
109
+ type: "path",
110
+ key,
111
+ d: arcVisibleD(viz, link),
112
+ datum,
113
+ index: link.index,
114
+ paint,
115
+ aria: {
116
+ label: linkAriaLabel(viz, datum)
117
+ }
118
+ });
119
+ hits.push(linkHitPath(key, link.d, datum, link.size));
120
+ arrows.push(...arcArrows(viz, link, typeof paint.stroke === "string" ? paint.stroke : undefined, `arc-arrow-${link.source.id}-${link.target.id}-${link.index}`));
121
+ }
122
+ return [
123
+ ...arcs,
124
+ ...hits,
125
+ ...arrows,
126
+ ...arcLinkLabels(viz, c)
127
+ ];
128
+ }
129
+ /** One node's Circle (or Rect, with `shape: "Rect"`). */ function nodeMark(viz, n, config) {
130
+ const paint = nodePaint(config, n);
131
+ // Nodes keep a constant screen stroke as the chart zooms.
132
+ if (paint.vectorEffect === undefined) paint.vectorEffect = "non-scaling-stroke";
133
+ const sizeFn = viz._size;
134
+ const sized = sizeFn ? `, ${sizeFn(n.data, n.i)}` : "";
135
+ const base = {
136
+ datum: n.data,
137
+ index: n.i,
138
+ paint,
139
+ aria: {
140
+ label: `${n.label}${sized}.`
141
+ }
142
+ };
143
+ if (n.shape === "Rect") {
144
+ const side = n.r * 2;
145
+ return {
146
+ type: "rect",
147
+ key: `arc-node-${n.id}`,
148
+ x: n.x - n.r,
149
+ y: n.y - n.r,
150
+ width: side,
151
+ height: side,
152
+ ...base
153
+ };
154
+ }
155
+ return {
156
+ type: "circle",
157
+ key: `arc-node-${n.id}`,
158
+ cx: n.x,
159
+ cy: n.y,
160
+ r: n.r,
161
+ ...base
162
+ };
163
+ }
164
+ export const arcDiagramEmit = ({ viz })=>{
165
+ const c = viz.ctx.arcCtx;
166
+ if (!c) return [];
167
+ const out = emitArcs(viz, c);
168
+ const images = [];
169
+ for (const n of c.nodes){
170
+ const config = shapeConfigFor(viz, n.shape === "Rect" ? "Rect" : "Circle");
171
+ const node = nodeMark(viz, n, config);
172
+ out.push(node);
173
+ const image = backgroundImageNode(config, node, n.data, n.i);
174
+ if (image) images.push(image);
175
+ }
176
+ out.push(...images, ...emitArcLabels(viz, c.labels, c.labelHalo));
177
+ return out;
178
+ };
@@ -0,0 +1,144 @@
1
+ /**
2
+ ArcDiagram's pointer handlers. Hovering a node highlights it, its
3
+ neighbors, and the arcs between them; hovering an arc highlights it and
4
+ its two ends. Clicking a node or arc focuses the same set and zooms to it
5
+ (clicking it again, or the background, resets), and clicking a legend
6
+ item focuses its nodes, as Network does.
7
+ */ import { isLinkDatum, linkMeta } from "../features/linkInteraction.js";
8
+ import { graphNodeId, zoomToNodeBounds } from "../Network/graph.js";
9
+ import { arcBox } from "./arcGeometry.js";
10
+ /**
11
+ What hovering (or focusing) `d` highlights, and the box around it: for a
12
+ node, it, its neighbors, and their arcs; for an arc, it and its two ends.
13
+ Null when `d` is neither.
14
+ */ export function arcFocus(viz, d, i) {
15
+ const c = viz.ctx.arcCtx;
16
+ if (!c) return null;
17
+ const nodeId = (h, hi)=>graphNodeId(viz, h, hi);
18
+ let ids;
19
+ let arcs;
20
+ let match;
21
+ const meta = linkMeta(d);
22
+ if (meta) {
23
+ ids = new Set([
24
+ meta.source.id,
25
+ meta.target.id
26
+ ]);
27
+ match = (l)=>l.index === meta.index;
28
+ arcs = c.links.filter(match);
29
+ } else {
30
+ const id = nodeId(d, i);
31
+ const lookup = viz.ctx.nodeLookup;
32
+ if (!lookup || !lookup[id]) return null;
33
+ match = (l)=>l.source.id === id || l.target.id === id;
34
+ arcs = c.links.filter(match);
35
+ ids = new Set([
36
+ id,
37
+ ...arcs.flatMap((l)=>[
38
+ l.source.id,
39
+ l.target.id
40
+ ])
41
+ ]);
42
+ }
43
+ const indices = new Set(arcs.map((l)=>l.index));
44
+ const predicate = (h, hi)=>{
45
+ const m = linkMeta(h);
46
+ return m ? indices.has(m.index) : ids.has(nodeId(h, hi));
47
+ };
48
+ return {
49
+ predicate,
50
+ box: focusBox(c, ids, arcs)
51
+ };
52
+ }
53
+ /** The box around a set of nodes and arcs. */ function focusBox(c, ids, arcs) {
54
+ const boxes = c.nodes.filter((n)=>ids.has(n.id)).map((n)=>[
55
+ [
56
+ n.x - n.r,
57
+ n.y - n.r
58
+ ],
59
+ [
60
+ n.x + n.r,
61
+ n.y + n.r
62
+ ]
63
+ ]).concat(arcs.map((l)=>l.loop ? l.loop.box : arcBox(l.arc)));
64
+ return [
65
+ [
66
+ Math.min(...boxes.map((b)=>b[0][0])),
67
+ Math.min(...boxes.map((b)=>b[0][1]))
68
+ ],
69
+ [
70
+ Math.max(...boxes.map((b)=>b[1][0])),
71
+ Math.max(...boxes.map((b)=>b[1][1]))
72
+ ]
73
+ ];
74
+ }
75
+ /** Zooms to a focus box. */ const zoomTo = (viz, box)=>zoomToNodeBounds(viz, [
76
+ box[0][0],
77
+ box[1][0]
78
+ ], [
79
+ box[0][1],
80
+ box[1][1]
81
+ ]);
82
+ /** A stable id for a focused row, so a second click on it resets. */ const focusId = (viz, d, i)=>isLinkDatum(d) ? `link:${linkMeta(d).index}` : graphNodeId(viz, d, i);
83
+ /** Installs ArcDiagram's hover, click, and legend-click handlers. */ export function setupArcEvents(viz) {
84
+ const v = viz;
85
+ viz.schema.on.mouseenter = ()=>undefined;
86
+ viz.schema.on["mouseleave.shape"] = ()=>{
87
+ v.hover(false);
88
+ };
89
+ const defaultMouseMove = viz.schema.on["mousemove.shape"];
90
+ viz.schema.on["mousemove.shape"] = (d, i, x, event)=>{
91
+ defaultMouseMove(d, i, x, event);
92
+ const focus = arcFocus(viz, d, i);
93
+ if (focus) v.hover(focus.predicate);
94
+ };
95
+ viz.schema.on["click.shape"] = (d, i)=>{
96
+ viz._tooltipClass.data([]).render();
97
+ const id = focusId(viz, d, i);
98
+ if (viz._focus !== undefined && viz._focus === id) {
99
+ v.active(false);
100
+ viz._focus = undefined;
101
+ viz._zoomToBounds(null);
102
+ return;
103
+ }
104
+ const focus = arcFocus(viz, d, i);
105
+ if (!focus) return;
106
+ v.hover(false);
107
+ v.active(focus.predicate);
108
+ viz._focus = id;
109
+ zoomTo(viz, focus.box);
110
+ };
111
+ viz.schema.on["click.legend"] = (d, i)=>{
112
+ const c = viz.ctx.arcCtx;
113
+ if (!c) return;
114
+ const idList = viz._ids(d, i);
115
+ const id = `legend:${idList[idList.length - 1]}`;
116
+ if (viz._focus === id) {
117
+ v.active(false);
118
+ viz._focus = undefined;
119
+ viz._zoomToBounds(null);
120
+ return;
121
+ }
122
+ // A legend item stands for every node whose row it groups.
123
+ const key = (h, hi)=>{
124
+ const ids = viz._ids(h, hi);
125
+ return `${ids[idList.length - 1]}`;
126
+ };
127
+ // A legend item that merges several ids (such as a cluster) has them all.
128
+ const merged = viz._id(d, i);
129
+ const wanted = new Set((Array.isArray(merged) ? merged : [
130
+ idList[idList.length - 1]
131
+ ]).map(String));
132
+ const ids = new Set(c.nodes.filter((n)=>wanted.has(key(n.data, n.i))).map((n)=>n.id));
133
+ if (!ids.size) return;
134
+ const arcs = c.links.filter((l)=>ids.has(l.source.id) && ids.has(l.target.id));
135
+ const indices = new Set(arcs.map((l)=>l.index));
136
+ v.hover(false);
137
+ v.active((h, hi)=>{
138
+ const m = linkMeta(h);
139
+ return m ? indices.has(m.index) : wanted.has(key(h, hi));
140
+ });
141
+ viz._focus = id;
142
+ zoomTo(viz, focusBox(c, ids, arcs));
143
+ };
144
+ }