@d3plus/core 4.9.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +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 +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,222 @@
1
+ /**
2
+ Curved labels for ring segments (Pie and Donut slices, Sunburst arcs,
3
+ Chord groups, RadialBar tracks): text that runs along a circular arc
4
+ through the segment, reading upright, and the fit that finds how large it
5
+ can be. Angles are radians in d3-shape's convention (0 at 12 o'clock,
6
+ increasing clockwise), so a point at angle `a` and radius `r` sits at
7
+ `(r·sin a, −r·cos a)`.
8
+ */ import { largestFontSize } from "../partition/labelWords.js";
9
+ import { uprightPoints } from "./pathLabelGeometry.js";
10
+ const TAU = Math.PI * 2;
11
+ const EPSILON = 1e-6;
12
+ /** The room a curved label keeps from its segment's edges by default, in pixels: the padding straight labels keep inside their box. */ export const RING_LABEL_PADDING = 5;
13
+ /**
14
+ The room a curved label keeps at each end of its text: `padding`, but
15
+ never less than 0.3em, so the first and last letters stay clear of the
16
+ segment's ends.
17
+ @param padding The padding in pixels.
18
+ @param fontSize The font size.
19
+ */ export function ringLabelEnd(padding, fontSize) {
20
+ return Math.max(padding, 0.3 * fontSize);
21
+ }
22
+ /**
23
+ The point at angle `a` on a circle of radius `r`.
24
+ @param r The radius.
25
+ @param a The angle.
26
+ */ export function ringPoint(r, a) {
27
+ return [
28
+ r * Math.sin(a),
29
+ -r * Math.cos(a)
30
+ ];
31
+ }
32
+ /**
33
+ Whether text along the arc from `a0` to `a1` (clockwise) reads upright
34
+ running clockwise: on the top half it does, and on the bottom half it
35
+ runs the other way so it reads left to right. The arc's chord is parallel
36
+ to its tangent at the middle, so the upright test for a straight line
37
+ (`uprightPoints`) decides it.
38
+ @param a0 Where the arc starts.
39
+ @param a1 Where it ends, clockwise from `a0`.
40
+ */ export function ringReadsClockwise(a0, a1) {
41
+ const ends = [
42
+ ringPoint(1, a0),
43
+ ringPoint(1, a1)
44
+ ];
45
+ return uprightPoints(ends) === ends;
46
+ }
47
+ /**
48
+ The SVG path along a circle of radius `r` from angle `a0` to `a1`
49
+ (clockwise, under a full turn), drawn clockwise or, for text on the
50
+ bottom half, from `a1` back to `a0`.
51
+ @param r The radius.
52
+ @param a0 Where the arc starts.
53
+ @param a1 Where it ends, clockwise from `a0`.
54
+ @param clockwise Which way the path runs.
55
+ */ export function ringTextPath(r, a0, a1, clockwise) {
56
+ const round = (n)=>Math.round(n * 100) / 100;
57
+ const [from, to] = clockwise ? [
58
+ a0,
59
+ a1
60
+ ] : [
61
+ a1,
62
+ a0
63
+ ];
64
+ const [x0, y0] = ringPoint(r, from);
65
+ const [x1, y1] = ringPoint(r, to);
66
+ const large = a1 - a0 > Math.PI ? 1 : 0;
67
+ const R = round(r);
68
+ return `M${round(x0)},${round(y0)}A${R},${R} 0 ${large} ${clockwise ? 1 : 0} ${round(x1)},${round(y1)}`;
69
+ }
70
+ /** The glyphs' center radius across the ring at `fontSize`, or null when they don't fit across it. */ function bandCenter(arc, fontSize, padding, align) {
71
+ const lo = arc.innerRadius + padding + fontSize / 2;
72
+ const hi = arc.outerRadius - padding - fontSize / 2;
73
+ if (hi < lo - EPSILON) return null;
74
+ if (align === "outer") return hi;
75
+ if (align === "inner") return lo;
76
+ return (arc.innerRadius + arc.outerRadius) / 2;
77
+ }
78
+ /**
79
+ Fits a one-line label along a ring segment: the largest font size (from
80
+ `fontMax` down to `fontMin`) at which its glyphs fit across the ring and
81
+ its text along the arc, `padding` pixels clear of the ring's edges and
82
+ at least 0.3em clear of the segment's ends and pad (see `ringLabelEnd`).
83
+ When no size fits the whole text, it sits at `fontMin` and is cut
84
+ short with an ellipsis (unless `truncate` is false), as long as its arc
85
+ holds a few letters. Null when the label has no room. The glyphs span
86
+ 0.8em above the baseline to 0.2em below, so the baseline sits 0.3em
87
+ below (or, on the bottom half, above) their center.
88
+ @param arc The segment.
89
+ @param width The text's one-line width at a font size.
90
+ @param options The font range, padding, and where the glyphs sit.
91
+ */ export function ringLabelFit(arc, width, options = {}) {
92
+ const { fontMin = 8, fontMax = 24, padding = RING_LABEL_PADDING, endPadding = padding, align = "middle", minRadius = 2.5, maxTurn = Math.PI, truncate = true } = options;
93
+ const a0 = Math.min(arc.startAngle, arc.endAngle);
94
+ const span = Math.min(TAU, Math.abs(arc.endAngle - arc.startAngle));
95
+ if (!(span > 0) || !(arc.outerRadius > arc.innerRadius) || !(fontMin > 0)) return null;
96
+ // A whole disc has no ring for the text to follow.
97
+ if (arc.innerRadius <= 0 && span >= TAU - EPSILON) return null;
98
+ const mid = a0 + span / 2;
99
+ const clockwise = ringReadsClockwise(mid - 0.01, mid + 0.01);
100
+ const padRadius = Math.sqrt(arc.innerRadius ** 2 + arc.outerRadius ** 2);
101
+ const padLength = (arc.padAngle ?? 0) * padRadius;
102
+ /** The baseline radius and the turn the text may take, at `fontSize`. */ const room = (fontSize)=>{
103
+ const center = bandCenter(arc, fontSize, padding, align);
104
+ if (center === null) return null;
105
+ const radius = center + (clockwise ? -0.3 : 0.3) * fontSize;
106
+ if (radius < minRadius * fontSize) return null;
107
+ // The glyphs' inner edge is where the segment is narrowest.
108
+ const inner = center - fontSize / 2;
109
+ if (!(inner > 0)) return null;
110
+ const turn = Math.min(maxTurn, span - (padLength + ringLabelEnd(endPadding, fontSize) * 2) / inner, TAU - EPSILON);
111
+ return turn > 0 ? {
112
+ radius,
113
+ turn
114
+ } : null;
115
+ };
116
+ const fits = (fontSize)=>{
117
+ const r = room(fontSize);
118
+ return Boolean(r && width(fontSize) <= r.radius * r.turn + EPSILON);
119
+ };
120
+ let fontSize = largestFontSize(fits, fontMin, Math.max(fontMin, fontMax));
121
+ const truncated = fontSize === null;
122
+ if (truncated) {
123
+ if (!truncate) return null;
124
+ fontSize = fontMin;
125
+ }
126
+ const r = room(fontSize);
127
+ if (!r) return null;
128
+ const length = r.radius * r.turn;
129
+ // A cut-short label keeps room for a few letters and its ellipsis.
130
+ if (truncated && length < fontSize * 3) return null;
131
+ return {
132
+ d: ringTextPath(r.radius, mid - r.turn / 2, mid + r.turn / 2, clockwise),
133
+ fontSize: fontSize,
134
+ radius: r.radius,
135
+ clockwise,
136
+ length,
137
+ truncated
138
+ };
139
+ }
140
+ /**
141
+ Fits a label and a smaller second line beneath it (such as a slice's
142
+ share) along a ring segment: the largest font size at which both lines,
143
+ the second at three quarters of the first's size (never below
144
+ `fontMin`), fit across the ring and along the arc whole. "Beneath" is
145
+ toward the center on the top half and away from it on the bottom half,
146
+ where the text reads the other way round. Null when they don't both fit.
147
+ @param arc The segment.
148
+ @param width The first line's one-line width at a font size.
149
+ @param subWidth The second line's.
150
+ @param options The font range, padding, and where the lines sit.
151
+ */ export function ringLabelPair(arc, width, subWidth, options = {}) {
152
+ const { fontMin = 8, fontMax = 24, padding = RING_LABEL_PADDING, align = "middle" } = options;
153
+ const span = Math.abs(arc.endAngle - arc.startAngle);
154
+ const mid = Math.min(arc.startAngle, arc.endAngle) + span / 2;
155
+ const up = ringReadsClockwise(mid - 0.01, mid + 0.01) ? 1 : -1;
156
+ const place = (fontSize)=>{
157
+ const sub = Math.max(fontMin, Math.round(fontSize * 0.75));
158
+ const block = fontSize + sub * 1.3;
159
+ const center = bandCenter(arc, block, padding, align);
160
+ if (center === null) return null;
161
+ const line = (c, size, w)=>ringLabelFit({
162
+ ...arc,
163
+ innerRadius: c - size / 2,
164
+ outerRadius: c + size / 2
165
+ }, w, {
166
+ ...options,
167
+ fontMin: size,
168
+ fontMax: size,
169
+ padding: 0,
170
+ endPadding: options.endPadding ?? padding,
171
+ align: "middle",
172
+ truncate: false
173
+ });
174
+ const first = line(center + up * (block - fontSize) / 2, fontSize, width);
175
+ const second = line(center - up * (block - sub) / 2, sub, subWidth);
176
+ return first && second ? [
177
+ first,
178
+ second
179
+ ] : null;
180
+ };
181
+ const fontSize = largestFontSize((fs)=>Boolean(place(fs)), fontMin, Math.max(fontMin, fontMax));
182
+ return fontSize === null ? null : place(fontSize);
183
+ }
184
+ /**
185
+ Picks a segment's label for its `labelPosition`. `"inside"` and
186
+ `"outside"` keep the straight label; `"along"` keeps the curved one. Any
187
+ other value (`"auto"`) takes the curve when it shows the whole text and
188
+ the straight label doesn't, or shows it larger (or as large, when `ties`
189
+ is `"curved"`); else the straight label, when there is one; else a
190
+ cut-short curve.
191
+ @param position The segment's `labelPosition`.
192
+ @param straight The straight label, if it fits.
193
+ @param curved The curved label, if it fits.
194
+ @param ties Which label wins at the same font size. Defaults to `"straight"`.
195
+ */ export function chooseRingLabel(position, straight, curved, ties = "straight") {
196
+ if (position === "inside" || position === "outside") return straight ? "straight" : null;
197
+ if (position === "along") return curved ? "curved" : null;
198
+ const larger = (a, b)=>ties === "curved" ? a >= b : a > b;
199
+ if (curved && !curved.truncated && (!straight || straight.truncated || larger(curved.fontSize, straight.fontSize))) return "curved";
200
+ if (straight) return "straight";
201
+ return curved ? "curved" : null;
202
+ }
203
+ /**
204
+ A row's `labelPosition`.
205
+ @param viz The chart.
206
+ @param d The row.
207
+ @param i Its index.
208
+ */ export function ringLabelPosition(viz, d, i) {
209
+ const position = viz.schema.labelPosition;
210
+ return typeof position === "function" ? position(d, i) : position;
211
+ }
212
+ /**
213
+ Whether laid-out lines show less than the whole `text`: cut short with an
214
+ ellipsis, or a word broken across lines.
215
+ @param lines The laid-out lines' text.
216
+ @param text The label's text.
217
+ */ export function textBroken(lines, text) {
218
+ const words = (s)=>s.split(/\s+/).filter(Boolean);
219
+ const shown = lines.flatMap(words);
220
+ const whole = words(text);
221
+ return shown.length !== whole.length || shown.some((w, k)=>w !== whole[k]);
222
+ }
@@ -4,6 +4,7 @@
4
4
 
5
5
  @module
6
6
  */ import { path2polygon, pathBounds } from "@d3plus/math";
7
+ import { lineLeft, pathTextBoxes, rotatedBoxBounds } from "@d3plus/render";
7
8
  /** Maps a point through a node transform: rotate (about its anchor), scale, then translate. */ export function applyTransform([px, py], t) {
8
9
  if (!t) return [
9
10
  px,
@@ -34,21 +35,27 @@
34
35
  height: 0
35
36
  });
36
37
  /** One box per laid-out line of a text node, from its anchor, baseline, and font size. */ function textBoxes(node) {
38
+ if (node.path) return pathTextBoxes(node).map((box)=>{
39
+ const b = rotatedBoxBounds(box);
40
+ return {
41
+ ...b,
42
+ x: node.x + b.x,
43
+ y: node.y + b.y
44
+ };
45
+ });
37
46
  const size = node.font?.size ?? 0;
38
- const anchor = node.font?.anchor ?? "start";
39
47
  const baseline = node.font?.baseline ?? "alphabetic";
40
48
  const above = baseline === "hanging" ? 0 : baseline === "middle" ? size / 2 : size * 0.8;
41
49
  return (node.lines || []).filter((line)=>line.text && line.width).map((line)=>{
42
- const shift = anchor === "middle" ? line.width / 2 : anchor === "end" ? line.width : 0;
43
50
  return {
44
- x: node.x + line.x - shift,
51
+ x: node.x + lineLeft(line, node.font),
45
52
  y: node.y + line.y - above,
46
53
  width: line.width,
47
54
  height: size
48
55
  };
49
56
  });
50
57
  }
51
- /** Boxes of a node's own geometry, before its transform. Line/area series and paths contribute one box per outline point. */ function ownBoxes(node) {
58
+ /** Boxes of a node's own geometry, before its transform. Line/area series and paths contribute one box per outline point. */ export function ownBoxes(node) {
52
59
  switch(node.type){
53
60
  case "rect":
54
61
  case "image":
@@ -91,10 +98,23 @@
91
98
  return [];
92
99
  }
93
100
  }
94
- /** Composes a chain of transforms (outermost first) into one point mapper. */ function mapper(chain) {
101
+ /** Composes a chain of transforms (outermost first) into one point mapper. */ export function mapper(chain) {
95
102
  return (p)=>chain.reduceRight((q, t)=>applyTransform(q, t), p);
96
103
  }
97
- /** The axis-aligned box around a box mapped through `map`. */ function mapBox(b, map) {
104
+ /** The axis-aligned box around a box mapped through `map`. */ export function mapBox(b, map) {
105
+ // A point's four corners all map to the same place.
106
+ if (b.width === 0 && b.height === 0) {
107
+ const [x, y] = map([
108
+ b.x,
109
+ b.y
110
+ ]);
111
+ return {
112
+ x,
113
+ y,
114
+ width: x - x,
115
+ height: y - y
116
+ };
117
+ }
98
118
  const corners = [
99
119
  map([
100
120
  b.x,
@@ -0,0 +1,306 @@
1
+ /**
2
+ Self-loops on the node-link charts: a link whose source and target are
3
+ the same node draws as a teardrop loop outside the node. Pure geometry
4
+ (the loop's path, its far point, its ends, its box), the direction a
5
+ node's loops point, the fan that keeps several loops on one node apart,
6
+ and the loop's arrowheads.
7
+ */ import { cubicPathD, edgeArrowTrims } from "./edgeArrows.js";
8
+ import { chordArrowNodes, cubicArrowEdge } from "./curvedArrows.js";
9
+ import { linkMeta } from "./linkInteraction.js";
10
+ import { cubicPoint } from "./linkLabelGeometry.js";
11
+ /** Whether a link's two ends are the same node. */ export function isSelfLoop(link) {
12
+ return !!link.source && !!link.target && (link.source === link.target || link.source.id === link.target.id);
13
+ }
14
+ /**
15
+ Whether a scene node draws a link from a node to itself (or is its hit
16
+ path). Charts with nearest-point hover treat these as point marks: a
17
+ loop lies within reach of its node, so it would otherwise always lose
18
+ the pointer to it.
19
+ */ export function isSelfLoopMark(node) {
20
+ if (node.type !== "path") return false;
21
+ const meta = linkMeta(node.datum);
22
+ return !!meta && meta.source.id === meta.target.id;
23
+ }
24
+ /** A usable stroke width: finite and not negative, else none. */ const strokeWidthOf = (sw)=>Number.isFinite(sw) ? Math.max(0, sw) : 0;
25
+ /**
26
+ How far a hairline loop reaches past the edge of a node of radius `r`:
27
+ a little more than the radius, and at least 10 pixels. A stroked loop
28
+ is sized from it (see `selfLoopGeometry`).
29
+ */ export function selfLoopReach(r) {
30
+ return Math.max((Number.isFinite(r) ? r : 0) * 1.25, 10);
31
+ }
32
+ /**
33
+ How far a loop's outer edge reaches past its node's edge, for a loop of
34
+ `reach` (see `selfLoopReach`) drawn with a `strokeWidth` stroke.
35
+ */ export function selfLoopExtent(reach, strokeWidth = 0) {
36
+ return selfLoopOpening(reach, strokeWidth) + strokeWidthOf(strokeWidth);
37
+ }
38
+ /**
39
+ How far a loop's opening (inside its stroke) reaches past its node's
40
+ edge: a hairline loop's `reach`, plus one stroke width, so the opening
41
+ grows with the stroke and the arrowhead (which grows with the stroke
42
+ too) leaves it clear. The loop's line sits half a stroke further out.
43
+ */ export function selfLoopOpening(reach, strokeWidth = 0) {
44
+ return Math.max(0, reach) + strokeWidthOf(strokeWidth);
45
+ }
46
+ /** The widest a loop's ends spread on its node, either side of its direction (radians). */ const MAX_END_ANGLE = 1.2;
47
+ /**
48
+ The loop's four Bézier points, pointing along `angle` from `node`. The
49
+ opening's edge is a hairline loop reaching `selfLoopOpening` past the
50
+ node: its ends sit on the node's edge, close enough together for that
51
+ reach, and its control points put its middle that far out. The loop's
52
+ line runs half a stroke outside it all round (its ends further apart
53
+ along the node's edge, its middle and sides further out), so the
54
+ stroke's inner edge follows the opening rather than closing it.
55
+ */ function loopPoints(node, angle, reach, strokeWidth = 0) {
56
+ const r = Math.max(0, node.r || 0);
57
+ const half = strokeWidthOf(strokeWidth) / 2;
58
+ const opening = selfLoopOpening(reach, strokeWidth);
59
+ const ux = Math.cos(angle);
60
+ const uy = Math.sin(angle);
61
+ // Across the loop: from its source side to its target side.
62
+ const vx = -uy;
63
+ const vy = ux;
64
+ // The opening's half-angle between its two ends on the node's edge.
65
+ const s = r > 0 ? Math.min(0.5, Math.asin(Math.min(1, opening * 0.3 / r))) : 0;
66
+ const hairAcross = r * Math.sin(s);
67
+ // The line's ends, half a stroke further apart on each side.
68
+ const end = r > 0 ? Math.min(MAX_END_ANGLE, Math.asin(Math.min(1, (hairAcross + half) / r))) : 0;
69
+ const along = r * Math.cos(end);
70
+ const across = r * Math.sin(end);
71
+ // Control points far enough out that the curve's middle is half a stroke past the opening.
72
+ const far = (8 * (r + opening + half) - 2 * along) / 6;
73
+ // 1.5× the offset at the control points moves the curve's sides out by about the offset.
74
+ const wide = opening * 0.8 + hairAcross + half * 1.5;
75
+ const at = (a, b)=>[
76
+ node.x + ux * a + vx * b,
77
+ node.y + uy * a + vy * b
78
+ ];
79
+ return [
80
+ at(along, -across),
81
+ at(far, -wide),
82
+ at(far, wide),
83
+ at(along, across)
84
+ ];
85
+ }
86
+ /**
87
+ A loop on `node`, pointing out from it along `angle` (radians). A
88
+ hairline loop's far point sits `reach` pixels past the node's edge. A
89
+ loop with a `strokeWidth` stroke keeps an opening inside its stroke
90
+ that grows with it (see `selfLoopOpening`), and its outer edge reaches
91
+ `selfLoopExtent` past the node's edge. The loop leaves the node on one
92
+ side of `angle` and comes back on the other, clockwise on screen.
93
+ */ export function selfLoopGeometry(node, angle, reach, strokeWidth = 0) {
94
+ const [p0, p1, p2, p3] = loopPoints(node, angle, Math.max(0, reach), strokeWidth);
95
+ const pad = strokeWidthOf(strokeWidth) / 2;
96
+ const apexPoint = cubicPoint(p0, p1, p2, p3, 0.5);
97
+ const end = (from, to)=>{
98
+ const dx = to[0] - from[0];
99
+ const dy = to[1] - from[1];
100
+ const len = Math.hypot(dx, dy) || 1;
101
+ // A pixel outside the node's edge, as straight links' arrows sit.
102
+ return {
103
+ x: to[0] - dx / len,
104
+ y: to[1] - dy / len,
105
+ angle: Math.atan2(dy, dx)
106
+ };
107
+ };
108
+ const samples = Array.from({
109
+ length: 25
110
+ }, (_, k)=>cubicPoint(p0, p1, p2, p3, k / 24));
111
+ const xs = samples.map((p)=>p[0]);
112
+ const ys = samples.map((p)=>p[1]);
113
+ return {
114
+ d: cubicPathD([
115
+ p0,
116
+ p1,
117
+ p2,
118
+ p3
119
+ ]),
120
+ apex: {
121
+ x: apexPoint[0],
122
+ y: apexPoint[1],
123
+ angle: angle + Math.PI / 2
124
+ },
125
+ source: end(p1, p0),
126
+ target: end(p2, p3),
127
+ box: [
128
+ [
129
+ Math.min(...xs) - pad,
130
+ Math.min(...ys) - pad
131
+ ],
132
+ [
133
+ Math.max(...xs) + pad,
134
+ Math.max(...ys) + pad
135
+ ]
136
+ ],
137
+ angle,
138
+ points: [
139
+ p0,
140
+ p1,
141
+ p2,
142
+ p3
143
+ ]
144
+ };
145
+ }
146
+ /** How far back along a loop from its end each arrow tip sits: a pixel off the node's edge. */ const LOOP_TIP_BACK = {
147
+ source: 1,
148
+ target: 1
149
+ };
150
+ /**
151
+ A loop's visible stroke: along the loop up to the base of the arrowhead
152
+ at each end that has one (`trims`, see `edgeArrowTrims`), then straight
153
+ along the head's axis to end inside it (see `cubicArrowEdge`). The full
154
+ loop stays its hit area.
155
+ */ export function selfLoopD(loop, trims) {
156
+ if (!trims.ends.source && !trims.ends.target) return loop.d;
157
+ return cubicArrowEdge(loop.points, trims, LOOP_TIP_BACK).d;
158
+ }
159
+ /**
160
+ The angle (radians) a loop on `node` covers, seen from the node's center,
161
+ stroke included, with a little air either side: how much of the turn
162
+ around the node it takes in a fan.
163
+ */ export function selfLoopSpread(node, reach, strokeWidth = 0) {
164
+ const local = {
165
+ x: 0,
166
+ y: 0,
167
+ r: node.r
168
+ };
169
+ const sw = strokeWidthOf(strokeWidth);
170
+ const [p0, p1, p2, p3] = loopPoints(local, 0, Math.max(0, reach), sw);
171
+ let half = 0;
172
+ for(let k = 0; k <= 24; k++){
173
+ const [x, y] = cubicPoint(p0, p1, p2, p3, k / 24);
174
+ half = Math.max(half, Math.abs(Math.atan2(y, x)));
175
+ }
176
+ const stroke = Math.atan2(sw / 2, Math.max(0, node.r) + reach / 2);
177
+ // A little air between neighbors.
178
+ return (half + stroke) * 2 * 1.1;
179
+ }
180
+ /**
181
+ The directions for a fan of loops on one node, one per entry in
182
+ `spreads` (each the angle its loop covers, see `selfLoopSpread`), in
183
+ order around the node: neighbors sit half of each one's spread apart,
184
+ and the fan is centered on `angle`. When the fan needs more than a full
185
+ turn, every gap shrinks in proportion so the fan closes into one turn.
186
+ */ export function selfLoopAngles(angle, spreads) {
187
+ const count = spreads.length;
188
+ if (!count) return [];
189
+ const gaps = spreads.slice(1).map((s, k)=>(spreads[k] + s) / 2);
190
+ const span = gaps.reduce((sum, g)=>sum + g, 0);
191
+ // The whole turn the fan would take, closing back round to its first loop.
192
+ const ring = span + (spreads[0] + spreads[count - 1]) / 2;
193
+ const scale = count > 1 && ring > Math.PI * 2 ? Math.PI * 2 / ring : 1;
194
+ let at = angle - span * scale / 2;
195
+ return spreads.map((_, k)=>{
196
+ if (k) at += gaps[k - 1] * scale;
197
+ return at;
198
+ });
199
+ }
200
+ /**
201
+ The positions in a fan of `count`, from its middle outward: the middle
202
+ first, then alternating to either side.
203
+ */ export function fanOrder(count) {
204
+ const mid = Math.floor((count - 1) / 2);
205
+ const out = [];
206
+ for(let k = 0; out.length < count; k++){
207
+ const offset = k % 2 ? (k + 1) / 2 : -k / 2;
208
+ const slot = mid + offset;
209
+ if (slot >= 0 && slot < count) out.push(slot);
210
+ }
211
+ return out;
212
+ }
213
+ /**
214
+ The direction (radians) out of `origin` with the most room: the middle of
215
+ the widest gap between the directions to `points` (one point leaves the
216
+ whole turn, so the loop points straight away from it). Points on `origin`
217
+ are ignored; with none left, `fallback`.
218
+ */ export function widestGapAngle(origin, points, fallback) {
219
+ const angles = points.filter((p)=>p[0] !== origin[0] || p[1] !== origin[1]).map((p)=>Math.atan2(p[1] - origin[1], p[0] - origin[0])).sort((a, b)=>a - b);
220
+ if (!angles.length) return fallback;
221
+ let best = Math.PI * 2 - (angles[angles.length - 1] - angles[0]);
222
+ let start = angles[angles.length - 1];
223
+ for(let k = 1; k < angles.length; k++){
224
+ const gap = angles[k] - angles[k - 1];
225
+ if (gap > best + 1e-9) {
226
+ best = gap;
227
+ start = angles[k - 1];
228
+ }
229
+ }
230
+ const mid = start + best / 2;
231
+ return Math.atan2(Math.sin(mid), Math.cos(mid));
232
+ }
233
+ /**
234
+ The direction (radians) pointing from `center` out through `point`, or
235
+ `fallback` (straight up by default) when they coincide.
236
+ */ export function awayFromAngle(point, center, fallback = -Math.PI / 2) {
237
+ const dx = point[0] - center[0];
238
+ const dy = point[1] - center[1];
239
+ return dx || dy ? Math.atan2(dy, dx) : fallback;
240
+ }
241
+ /**
242
+ Lays out a set of loops: every node's loops share one hairline size (the
243
+ largest `reach` among them), each stroked by its own `strokeWidth`, and
244
+ fan out around the node's direction so they don't draw over each other,
245
+ the heaviest in the middle. Each loop takes as much of the fan as its
246
+ own stroke needs.
247
+ @param loops The loops, each a link from a node to itself.
248
+ @param opts `node` gives a loop's node (with an `id`), `angle` the
249
+ direction a node's loops point, `reach` how far a hairline loop reaches,
250
+ and `strokeWidth` (optional) its stroke.
251
+ */ export function layoutSelfLoops(loops, opts) {
252
+ const byNode = new Map();
253
+ for (const loop of loops){
254
+ const id = opts.node(loop).id;
255
+ if (!byNode.has(id)) byNode.set(id, []);
256
+ byNode.get(id).push(loop);
257
+ }
258
+ const out = new Map();
259
+ for (const group of byNode.values()){
260
+ const node = opts.node(group[0]);
261
+ if (![
262
+ node.x,
263
+ node.y
264
+ ].every(Number.isFinite)) continue;
265
+ const reach = Math.max(...group.map((l)=>opts.reach(l)));
266
+ // The heaviest loop takes the middle of the fan, where the most room is.
267
+ const heaviest = group.map((loop, k)=>({
268
+ loop,
269
+ k,
270
+ w: strokeWidthOf(opts.strokeWidth?.(loop) ?? 0)
271
+ })).sort((a, b)=>b.w - a.w || a.k - b.k);
272
+ const slots = fanOrder(group.length);
273
+ const bySlot = new Array(group.length);
274
+ heaviest.forEach((entry, k)=>bySlot[slots[k]] = entry);
275
+ const angles = selfLoopAngles(opts.angle(node), bySlot.map(({ w })=>selfLoopSpread(node, reach, w)));
276
+ bySlot.forEach(({ loop, w }, slot)=>out.set(loop, selfLoopGeometry(node, angles[slot], reach, w)));
277
+ }
278
+ return out;
279
+ }
280
+ /** The union of two boxes. */ export function unionBox(a, b) {
281
+ return [
282
+ [
283
+ Math.min(a[0][0], b[0][0]),
284
+ Math.min(a[0][1], b[0][1])
285
+ ],
286
+ [
287
+ Math.max(a[1][0], b[1][0]),
288
+ Math.max(a[1][1], b[1][1])
289
+ ]
290
+ ];
291
+ }
292
+ /**
293
+ Arrowheads for a loop at the ends `arrows` selects: at its target end
294
+ where it comes back into the node, at its source end where it leaves,
295
+ each aimed along the loop's chord from its base to its tip.
296
+ */ export function selfLoopArrows(opts) {
297
+ const trims = edgeArrowTrims(opts);
298
+ if (!trims.ends.source && !trims.ends.target) return [];
299
+ return chordArrowNodes({
300
+ ends: cubicArrowEdge(opts.loop.points, trims, LOOP_TIP_BACK),
301
+ size: trims.size,
302
+ datum: opts.datum,
303
+ keyPrefix: opts.keyPrefix,
304
+ fill: opts.fill
305
+ });
306
+ }