@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
@@ -10,11 +10,16 @@
10
10
  `vizDraw` via `runLayout(ctx, [...features])`.
11
11
  */ import { extent, sum } from "d3-array";
12
12
  import { unique } from "@d3plus/data";
13
- import { date, elem } from "@d3plus/dom";
13
+ import { date, elem, rtl as detectRTL } from "@d3plus/dom";
14
+ import { textBoxLines } from "../../components/textBoxScene.js";
14
15
  import { wholeWordFit, wholeWords } from "../../utils/wholeWords.js";
15
16
  import { zoomControlsBox, zoomControlsReach } from "../drawSteps/zoomControlsMarkup.js";
16
17
  import { getTopLeftContributions } from "../drawSteps/topLeftControls.js";
17
18
  import { topLeftControlsInset as topLeftControlsInsetRaw, topLeftControlsReach } from "../drawSteps/topLeftControlsMarkup.js";
19
+ import { effectiveDuration } from "../viz/reducedMotion.js";
20
+ import { timelineRangeBreaks } from "../Plot/plotRangeBreaks.js";
21
+ import { startingSelection } from "../pipeline/preDrawData.js";
22
+ import { classTimelineMode } from "../../components/Timeline/timelineMode.js";
18
23
  const VALID_POSITIONS = new Set([
19
24
  false,
20
25
  "top",
@@ -113,7 +118,7 @@ const VALID_POSITIONS = new Set([
113
118
  margin: claims
114
119
  };
115
120
  }
116
- /**
121
+ /* --------------------------- text-block features --------------------------- */ /** A TextBox `_textData()` row, as the text-block features read it. */ /**
117
122
  A little breathing room added to a NON-zero corner inset, on top of the
118
123
  exact pixel width the corner panel measured at. Without it, content
119
124
  insets to EXACTLY the corner box's edge — any tiny discrepancy between
@@ -300,11 +305,11 @@ const VALID_POSITIONS = new Set([
300
305
  // the title sat at the top of its claim regardless, reading noticeably
301
306
  // higher than the same-row zoom/back/search buttons beside it.
302
307
  const y = layoutMargin.top + drop + blockPadding;
303
- const lines = box.lines.map((str, i)=>({
304
- text: str,
305
- x: box.tA === "middle" ? width / 2 : box.tA === "end" ? width : 0,
306
- y: (i + 1) * lineHeight - (lineHeight - box.fS),
307
- width: box.widths?.[i] ?? 0
308
+ const rtl = detectRTL();
309
+ const placed = textBoxLines(box, width, rtl);
310
+ const lines = placed.lines.map((ln, i)=>({
311
+ ...ln,
312
+ y: (i + 1) * lineHeight - (lineHeight - box.fS)
308
313
  }));
309
314
  const panel = {
310
315
  type: "text",
@@ -315,8 +320,11 @@ const VALID_POSITIONS = new Set([
315
320
  font: {
316
321
  family: box.fF,
317
322
  size: box.fS,
318
- anchor: box.tA === "middle" || box.tA === "end" || box.tA === "start" ? box.tA : "start",
319
- baseline: "alphabetic"
323
+ anchor: placed.anchor,
324
+ baseline: "alphabetic",
325
+ ...rtl ? {
326
+ dir: "rtl"
327
+ } : {}
320
328
  },
321
329
  paint: {
322
330
  fill: box.fC,
@@ -416,14 +424,14 @@ const VALID_POSITIONS = new Set([
416
424
  condition: timelinePossible,
417
425
  enter: transform,
418
426
  parent: viz._select,
419
- duration: viz.schema.duration,
427
+ duration: effectiveDuration(viz),
420
428
  update: transform
421
429
  }).node();
422
430
  if (!timelinePossible) return {
423
431
  panel: null,
424
432
  margin: {}
425
433
  };
426
- const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(viz.schema.duration).height(viz.schema.height - layoutMargin.bottom).locale(viz.schema.locale).select(timelineGroup).ticks(ticks.sort((a, b)=>+a - +b)).width(viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right));
434
+ const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(effectiveDuration(viz)).height(viz.schema.height - layoutMargin.bottom).locale(viz.schema.locale).select(timelineGroup).ticks(ticks.sort((a, b)=>+a - +b)).width(viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right));
427
435
  // Clamp bound = the full time range (every tick); it never goes stale
428
436
  // mid-render. Clamping to `viz._filteredData`'s extent instead collapsed a
429
437
  // freshly-committed range down to the previous selection — the release
@@ -432,10 +440,10 @@ const VALID_POSITIONS = new Set([
432
440
  if (!viz._timelineSelection) {
433
441
  // First render only: default to the *filtered* extent, which the
434
442
  // synthesized default timeFilter pins to the latest period (see
435
- // vizPreDraw) — the historical default. `timelineDefault` overrides it.
443
+ // vizPreDraw). `timelineDefault` or `timelineConfig.selection` overrides it.
436
444
  // A row merged across periods holds each of their times.
437
445
  const filtered = extent((viz._filteredData || []).flatMap((d, i)=>viz.schema.time(d, i)).map((d)=>date(d)));
438
- viz._timelineSelection = viz.schema.timelineDefault || (filtered[0] ? filtered : fullExtent);
446
+ viz._timelineSelection = startingSelection(viz) || (filtered[0] ? filtered : fullExtent);
439
447
  } else {
440
448
  if (viz._timelineSelection[0] < fullExtent[0]) viz._timelineSelection[0] = fullExtent[0];
441
449
  if (viz._timelineSelection[1] > fullExtent[1]) viz._timelineSelection[1] = fullExtent[1];
@@ -444,7 +452,16 @@ const VALID_POSITIONS = new Set([
444
452
  // Repaint the scene when playback toggles without moving the selection
445
453
  // (e.g. a manual pause), so the play/pause glyph refreshes immediately.
446
454
  timeline._onPlayToggle = ()=>viz._scheduleSceneRepaint();
447
- const config = viz.schema.timelineConfig;
455
+ // The timeline hides what its time axis hides, unless `timelineConfig`
456
+ // sets its own `rangeBreaks`.
457
+ const inherited = timelineRangeBreaks(viz);
458
+ timeline.rangeBreaks(inherited.length ? inherited : false);
459
+ // `timelineConfig.selection` is where the timeline starts (see
460
+ // `startingSelection`); after that the viewer's selection stands.
461
+ const config = {
462
+ ...viz.schema.timelineConfig
463
+ };
464
+ delete config.selection;
448
465
  timeline.config(config).on("brush", (s)=>{
449
466
  // Filter on "end", not on every brush move. Re-rendering the whole Viz
450
467
  // mid-drag re-creates the d3-brush (and starts a brush transition),
@@ -458,6 +475,7 @@ const VALID_POSITIONS = new Set([
458
475
  setTimeFilter(viz, s);
459
476
  if (config.on && config.on.end) config.on.end(s);
460
477
  }).render();
478
+ classTimelineMode(timelineGroup, "d3plus-viz-timeline", timeline._buttonBehaviorCurrent);
461
479
  return {
462
480
  panel: null,
463
481
  margin: {
@@ -12,12 +12,23 @@ import { sanitizePosition, sideControlsDrop } from "./features.js";
12
12
  import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
13
13
  import { facetKey } from "../facet/facetData.js";
14
14
  import { colorScaleBucketRows } from "./colorScaleBucket.js";
15
+ import { colorScaleValue, linkColorScaleRows } from "./colorScaleValue.js";
15
16
  import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
17
+ import { effectiveDuration } from "../viz/reducedMotion.js";
16
18
  /**
17
19
  The colorScale's data: the chart's data rolled up per time/id (and per
18
20
  small-multiples panel, the values the panels color by), keeping rows with
19
- a colorScale value.
21
+ a colorScale value, then any links colored by number.
20
22
  */ function colorScaleData(viz) {
23
+ const links = linkColorScaleRows(viz);
24
+ if (typeof viz.schema.colorScale !== "function") return links;
25
+ const own = viz._colorScaleRows ? viz._colorScaleRows() : dataRows(viz);
26
+ return links.length ? [
27
+ ...own,
28
+ ...links
29
+ ] : own;
30
+ }
31
+ /** The chart's data rolled up per time/id/panel, keeping rows with a colorScale value. */ function dataRows(viz) {
21
32
  const facet = viz.schema.facet;
22
33
  const data = Array.from(rollup(viz._data, (leaves)=>merge(leaves, viz.schema.aggs), (d, i)=>`${viz.schema.time ? viz.schema.time(d, i) : "all"}-${facet ? facetKey(facet(d, i)) : "all"}-${viz._ids(d, i).join("_")}`).values());
23
34
  return data.filter((d, i)=>{
@@ -77,10 +88,13 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
77
88
  duration: 0,
78
89
  update: transform
79
90
  }).node();
80
- if (!viz.schema.colorScale) return;
81
- viz._colorScaleClass.renderMode("compute").align(frame.align).duration(viz.schema.duration).data(colorScaleData(viz)).height(frame.height).locale(viz.schema.locale).orient(frame.orient).select(scaleGroup).value(viz.schema.colorScale).width(frame.width).legendConfig({
91
+ const value = colorScaleValue(viz);
92
+ if (!value) return;
93
+ viz._colorScaleClass.renderMode("compute").align(frame.align).duration(effectiveDuration(viz)).data(colorScaleData(viz)).height(frame.height).locale(viz.schema.locale).orient(frame.orient).select(scaleGroup).value(value).width(frame.width).legendConfig({
82
94
  shapeConfig: bucketSwatchConfig(viz)
83
- }).config(viz.schema.colorScaleConfig).hover(false).render();
95
+ })// Links colored by number are thin lines: keep the ramp's low end
96
+ // visible against a light background.
97
+ .ordinalRamp(linkColorScaleRows(viz).length > 0).config(viz.schema.colorScaleConfig).hover(false).render();
84
98
  }
85
99
  /** The colorScale's sanitized position side (false when hidden). */ function colorScalePosition(viz) {
86
100
  return sanitizePosition(viz.schema.colorScalePosition.bind(viz)(resolveSpec(viz)), viz);
@@ -91,7 +105,7 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
91
105
  horizontally (`"row"`), sized against the chart area `area`. Returns its
92
106
  measured size, or null when it isn't showing.
93
107
  */ export function paintColorScaleInset(viz, orient, area) {
94
- const show = Boolean(viz.schema.colorScale) && colorScalePosition(viz) !== false && !viz.schema.colorScaleConfig.select;
108
+ const show = Boolean(colorScaleValue(viz)) && colorScalePosition(viz) !== false && !viz.schema.colorScaleConfig.select;
95
109
  const frame = insetFrame(orient, area);
96
110
  const maxSize = viz.schema.colorScaleMaxSize;
97
111
  paintColorScale(viz, {
@@ -146,7 +160,7 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
146
160
  "top",
147
161
  "bottom"
148
162
  ].includes(position);
149
- const showColorScale = viz.schema.colorScale && position;
163
+ const showColorScale = colorScaleValue(viz) && position;
150
164
  const padding = viz.schema.colorScalePadding(viz) ? viz._padding : {
151
165
  top: 0,
152
166
  right: 0,
@@ -6,43 +6,34 @@
6
6
  */ import { merge } from "@d3plus/data";
7
7
  import { elem } from "@d3plus/dom";
8
8
  import { configPrep } from "../../utils/index.js";
9
+ import { constantValue } from "../../utils/constant.js";
9
10
  import { cornerPlacements, sanitizePosition, sideControlsDrop } from "./features.js";
10
11
  import { bottomRightClearance } from "../drawSteps/bottomRightControlsMarkup.js";
11
12
  import { resolveSpec } from "../pipeline/resolveSpec.js";
12
13
  import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
13
14
  import { legendCategories, legendMergesIds } from "./legendCategory.js";
15
+ import { legendKeys, legendRows } from "./legendKeys.js";
16
+ import { effectiveDuration } from "../viz/reducedMotion.js";
14
17
  /**
15
18
  Rolls filtered legend data up by paint attributes, computes
16
19
  `viz._legendDepth` (the lowest groupBy level whose values are unique) and
17
20
  `viz._legendCategories` (see `legendCategory.ts`), then sorts it.
18
21
  Returns the `legendData` array plus the `fill`/`getAttr` accessors the
19
- render step reuses.
22
+ render step reuses. A legend set to a constant false (`legend(false)`)
23
+ gets no entries, and its depth and categories stay as they were.
20
24
  */ export function buildLegendData(viz) {
21
25
  // Source: `_legendData` from the rollupAndFilter pipeline stage — same
22
26
  // arg drawLegend received via `drawLegend.bind(this)(this._legendData)`.
23
- const data = viz._legendData || [];
24
- const getAttr = (d, i, attr)=>{
25
- const shape = viz.schema.shape(d, i);
26
- if (attr === "fill" && shape === "Line") attr = "stroke";
27
- const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
28
- return typeof value === "function" ? value.bind(viz)(d, i) : value;
29
- };
30
- // Legend grouping key: the color *encoding* input, so categories keep their
31
- // own entry even when two resolve to the same hex (#788), while
32
- // opacity/texture still split entries that differ on those secondary
33
- // encodings. Falls back to the resolved fill when there's no color accessor
34
- // to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
35
- const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
36
- const keyOf = (d, i, c)=>{
37
- const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
38
- return [
39
- colorKey,
40
- getAttr(d, i, "opacity"),
41
- getAttr(d, i, "texture")
42
- ].join("_");
43
- };
27
+ const { getAttr, colorOf, keyOf } = legendKeys(viz);
44
28
  const legendKey = (d, i)=>keyOf(d, i, colorOf(d, i));
45
- const rollupData = viz.schema.colorScale ? data.filter((d, i)=>viz.schema.colorScale(d, i) === undefined) : data;
29
+ // A legend set to a constant false never shows, so it needs no entries.
30
+ const never = constantValue(viz.schema.legend);
31
+ if (never && !never.value) return {
32
+ legendData: [],
33
+ legendKey,
34
+ getAttr
35
+ };
36
+ const rollupData = legendRows(viz);
46
37
  const groups = new Map();
47
38
  rollupData.forEach((d, i)=>{
48
39
  const c = colorOf(d, i);
@@ -129,7 +120,7 @@ import { legendCategories, legendMergesIds } from "./legendCategory.js";
129
120
  duration: 0,
130
121
  update: transform
131
122
  }).node();
132
- viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(viz.schema.duration).data(frame.visible ? legendData : []).height(frame.height).locale(viz.schema.locale).parent(viz).select(legendGroup).shape((d, i)=>{
123
+ viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(effectiveDuration(viz)).data(frame.visible ? legendData : []).height(frame.height).locale(viz.schema.locale).parent(viz).select(legendGroup).shape((d, i)=>{
133
124
  const shape = viz.schema.shape(d, i);
134
125
  return shape === "Circle" || shape === "Line" ? shape : "Rect";
135
126
  }).verticalAlign(frame.verticalAlign).width(frame.width).shapeConfig(configPrep.bind(viz)(viz.schema.shapeConfig, "legend")).shapeConfig({
@@ -0,0 +1,64 @@
1
+ /**
2
+ How the legend groups rows into entries: by the color each row encodes,
3
+ its opacity and its texture.
4
+ */ import { constantValue } from "../../utils/constant.js";
5
+ /**
6
+ The legend's key functions for a chart.
7
+ @param viz The chart.
8
+ */ export function legendKeys(viz) {
9
+ const getAttr = (d, i, attr)=>{
10
+ const shape = viz.schema.shape(d, i);
11
+ if (attr === "fill" && shape === "Line") attr = "stroke";
12
+ const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
13
+ return typeof value === "function" ? value.bind(viz)(d, i) : value;
14
+ };
15
+ // Legend grouping key: the color *encoding* input, so categories keep their
16
+ // own entry even when two resolve to the same hex (#788), while
17
+ // opacity/texture still split entries that differ on those secondary
18
+ // encodings. Falls back to the resolved fill when there's no color accessor
19
+ // to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
20
+ const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
21
+ const keyOf = (d, i, c)=>{
22
+ const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
23
+ return [
24
+ colorKey,
25
+ getAttr(d, i, "opacity"),
26
+ getAttr(d, i, "texture")
27
+ ].join("_");
28
+ };
29
+ return {
30
+ getAttr,
31
+ colorOf,
32
+ keyOf
33
+ };
34
+ }
35
+ /**
36
+ The rows the legend rolls up: `_legendData`, less the rows a colorScale
37
+ colors.
38
+ @param viz The chart.
39
+ */ export function legendRows(viz) {
40
+ const data = viz._legendData || [];
41
+ return viz.schema.colorScale ? data.filter((d, i)=>viz.schema.colorScale(d, i) === undefined) : data;
42
+ }
43
+ /**
44
+ How many entries the legend has (the number `buildLegendData` rolls its
45
+ rows into), counting no further than `limit + 1`: enough to tell whether
46
+ there are more than `limit`. A legend set to a constant false has none.
47
+ @param viz The chart.
48
+ @param limit The count past which to stop.
49
+ */ export function legendEntryCount(viz, limit = Infinity) {
50
+ const never = constantValue(viz.schema.legend);
51
+ if (never && !never.value) return 0;
52
+ const { colorOf, keyOf } = legendKeys(viz);
53
+ const keys = new Set();
54
+ const data = viz._legendData || [];
55
+ const scaled = Boolean(viz.schema.colorScale);
56
+ let j = 0;
57
+ for(let i = 0; i < data.length && keys.size <= limit; i++){
58
+ const d = data[i];
59
+ if (scaled && viz.schema.colorScale(d, i) !== undefined) continue;
60
+ keys.add(keyOf(d, j, colorOf(d, j)));
61
+ j++;
62
+ }
63
+ return keys.size;
64
+ }
@@ -2,82 +2,91 @@
2
2
  Line-label collision resolution + connector emit for the Plot paint phase.
3
3
 
4
4
  Plot's `lineLabels` feature draws a label at the end of each series line.
5
- When several series end at nearby y positions the labels overlap, so they
6
- are "bumped" apart into discrete y buckets; a thin connector line then
7
- links each bumped label back to its true series position.
5
+ When several series end at nearby y positions the labels would overlap,
6
+ so they are spread apart until none do; a thin connector line then
7
+ links each moved label back to its true series position.
8
+
9
+ Labels at a line's left end (`lineLabels: "start"` or `"both"`) are
10
+ placed the same way, apart from the right-end labels.
8
11
 
9
12
  The measure half (which series get labels + their widths) lives upstream
10
13
  as the `measurePlotLineLabels` pipeline stage. This module owns the two
11
14
  remaining pieces:
12
15
 
13
- - `bumpLineLabels` — resolve overlaps, returning the id→bumped-y map.
14
- - `emitLineLabelConnectors` — draw the connector lines for bumped labels.
16
+ - `bumpLineLabels` — resolve overlaps, returning the id→moved-y map.
17
+ - `emitLineLabelConnectors` — draw the connector lines for moved labels.
15
18
 
16
19
  This is Plot-family-specific (it depends on Line series + the rendered
17
20
  y-axis position function), not a generic cross-viz feature.
18
21
 
19
22
  @module
20
- */ import { groups, max, range } from "d3-array";
23
+ */ import { groups } from "d3-array";
21
24
  import { assign } from "@d3plus/dom";
25
+ import { lineLabelKey } from "../Plot/lineLabelSides.js";
26
+ import { spreadLabelPositions } from "../Plot/lineLabelSpread.js";
22
27
  import { collectComputed, makeShape } from "./emitHelpers.js";
28
+ /** A label's height, as a multiple of its font size, when spread apart. */ const LABEL_LINE_HEIGHT = 1.2;
23
29
  /**
24
- Resolve label overlaps within each x-group by bumping colliding labels
25
- into discrete y buckets (capped at 1/8 of the range so a label never
26
- travels too far from its series). Mutates each `LabelWidth`'s `newY`/
27
- `defaultY` in place and returns the id→bumped-y map the Line emitter and
28
- connector emit read. Must run AFTER the production y-axis has rendered —
29
- `bumpPrevious` reads `viz._yAxis._getPosition`.
30
- */ export function bumpLineLabels(viz, labelWidths, yRange) {
31
- let labelPositions = {};
32
- if (labelWidths) {
33
- groups(labelWidths, (d)=>d.xValue).forEach(([, values])=>{
34
- const minFontSize = max(values.map((d)=>d.fontSize));
35
- const yBuckets = range(yRange[0], yRange[1], minFontSize).reverse();
36
- const bumpLimit = (yRange[1] - yRange[0]) / 8;
37
- /***/ function bumpPrevious(d, i, arr) {
38
- if (!d.defaultY) d.defaultY = viz._yAxis._getPosition(d.value);
39
- if (i) {
40
- const prev = arr[i - 1];
41
- const { fontSize, padding } = d;
42
- const y = d.newY || d.defaultY;
43
- const prevY = prev.newY || prev.defaultY;
44
- if (y - fontSize / 2 - padding < prevY) {
45
- const newY = yBuckets.find((n)=>n < prevY);
46
- const change = d.defaultY - newY;
47
- if (change < bumpLimit) {
48
- prev.newY = newY;
49
- if (i) bumpPrevious(prev, i - 1, arr);
50
- }
51
- }
52
- }
30
+ Spreads one group of labels (one end, one x value) apart so none
31
+ overlap, each as close to its series as the others allow (see
32
+ `spreadLabelPositions`), and sets `newY` on each label that moved. When
33
+ the plot is too short for them all, the labels that fit keep their
34
+ places, the last of them reads "+N more" for itself and the rest
35
+ (`collapsed`), and the rest are hidden.
36
+ */ function spreadGroup(viz, values, yRange) {
37
+ const sorted = values.map((d)=>{
38
+ if (!d.defaultY) d.defaultY = viz._yAxis._getPosition(d.value);
39
+ return d;
40
+ }).sort((a, b)=>a.defaultY - b.defaultY);
41
+ const positions = spreadLabelPositions(sorted.map((d)=>d.defaultY), sorted.map((d)=>d.fontSize * LABEL_LINE_HEIGHT), yRange);
42
+ const bottom = Math.max(...yRange) + 0.5;
43
+ const fit = positions.filter((y)=>y <= bottom).length;
44
+ sorted.forEach((d, i)=>{
45
+ if (fit < sorted.length && i >= fit - 1) {
46
+ if (i === fit - 1) d.collapsed = sorted.length - i;
47
+ else {
48
+ d.hidden = true;
49
+ return;
53
50
  }
54
- values.forEach(bumpPrevious);
55
- });
56
- labelPositions = labelWidths.reduce((obj, d)=>{
57
- if (d.newY) obj[d.id] = d.newY;
58
- return obj;
59
- }, {});
60
- }
61
- return labelPositions;
51
+ }
52
+ if (Math.abs(positions[i] - d.defaultY) > 0.5) d.newY = positions[i];
53
+ });
54
+ }
55
+ /**
56
+ Resolve label overlaps within each x-group, each end of the lines on its
57
+ own: labels are spread apart until none overlap (see `spreadGroup`).
58
+ Mutates each `LabelWidth`'s `newY`/`defaultY` in place and returns the
59
+ moved-y map, keyed by `lineLabelKey`, that the Line emitter and
60
+ connector emit read. Must run AFTER the production y-axis has rendered:
61
+ it reads `viz._yAxis._getPosition`.
62
+ */ export function bumpLineLabels(viz, labelWidths, yRange) {
63
+ if (!labelWidths) return {};
64
+ groups(labelWidths, (d)=>d.side ?? "end", (d)=>d.xValue).forEach(([, xGroups])=>xGroups.forEach(([, values])=>spreadGroup(viz, values, yRange)));
65
+ return labelWidths.reduce((obj, d)=>{
66
+ if (d.newY) obj[lineLabelKey(d.side, d.id)] = d.newY;
67
+ return obj;
68
+ }, {});
62
69
  }
63
70
  /**
64
71
  Emit the connector lines for labels that were bumped (`newY` set). Each
65
72
  connector runs from the label's true series position to its bumped
66
- position. Returns the compute-mode scene nodes (empty when nothing was
73
+ position, rightward for a right-end label and leftward for a left-end one. Returns the compute-mode scene nodes (empty when nothing was
67
74
  bumped). Coords are relative to `_chartTransform`, which the chart-cells
68
75
  group applies.
69
76
  */ export function emitLineLabelConnectors(viz, labelWidths) {
70
- const labelConnectors = labelWidths.filter((d)=>d.newY !== undefined);
77
+ const labelConnectors = labelWidths.filter((d)=>d.newY !== undefined && !d.hidden);
71
78
  if (!labelConnectors.length) return [];
72
79
  const data = labelConnectors.map((d)=>assign({
73
80
  x: viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue),
74
81
  y: d.defaultY
75
82
  }, d)).concat(labelConnectors.map((d)=>assign({
76
- x: viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) + d.padding - 1,
83
+ x: d.side === "start" ? viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) - d.padding + 1 : viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) + d.padding - 1,
77
84
  y: d.newY || d.defaultY
78
85
  }, d)));
79
86
  const connectorLine = makeShape("Line").config({
80
87
  data: data,
88
+ // Each label's connector is its own line, the two ends of a series apart.
89
+ id: (d)=>d.side === "start" ? lineLabelKey("start", d.id) : d.id,
81
90
  stroke: (d)=>d.fontColor,
82
91
  x: (d)=>d.x,
83
92
  y: (d)=>d.y
@@ -0,0 +1,19 @@
1
+ /**
2
+ `linkBundle` for a chart's links: bundles their straight runs (see
3
+ `bundleEdges`) with the chart's `linkBundleConfig`, through a cache kept
4
+ on the chart, so a redraw with the links where they were reuses the
5
+ last bundling.
6
+ */ import { bundleEdges, edgeBundleCache } from "./edgeBundling.js";
7
+ /** The chart's bundling cache, created on first use. */ export function linkBundleCache(viz) {
8
+ const cache = viz.ctx.linkBundleCache;
9
+ if (cache) return cache;
10
+ const created = edgeBundleCache();
11
+ viz.ctx.linkBundleCache = created;
12
+ return created;
13
+ }
14
+ /**
15
+ Each edge's bundled path, from its source to its target, with the
16
+ chart's `linkBundleConfig`.
17
+ */ export function bundleLinkPaths(viz, edges) {
18
+ return bundleEdges(edges, viz.schema.linkBundleConfig ?? {}, linkBundleCache(viz));
19
+ }
@@ -0,0 +1,72 @@
1
+ /**
2
+ `linkColor` on the node-link charts (Network, Rings, Sankey, ArcDiagram):
3
+ each link's stroke, from one of its end nodes or from a value on the
4
+ link. Arrowheads take their link's stroke.
5
+ */ import { colorAssign } from "@d3plus/color";
6
+ import { color } from "d3-color";
7
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
8
+ import { linkedColorDefaults } from "../viz/linkGroup.js";
9
+ import { colorScaleColor, isScaleValue, noteLinkValue } from "./colorScaleValue.js";
10
+ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
11
+ import { linkMeta } from "./linkInteraction.js";
12
+ /**
13
+ Stores a `linkColor` value: `"source"` and `"target"` as given, a falsy
14
+ value as `false`, a function as given, and any other string as a key
15
+ read from each link.
16
+ */ export function coerceLinkColor(value) {
17
+ if (!value) return false;
18
+ if (value === "source" || value === "target" || typeof value === "function") return value;
19
+ return fieldAccessor(value);
20
+ }
21
+ /**
22
+ The datum a drawn link carries (see `makeLinkDatum`), or the link itself
23
+ when it has none, and the link's index in `links` (else `i`).
24
+ */ export function linkRow(link, i) {
25
+ const row = link.datum ?? link;
26
+ return {
27
+ row,
28
+ index: linkMeta(row)?.index ?? i
29
+ };
30
+ }
31
+ /**
32
+ The color a link's value gives it: a number through the chart's
33
+ colorScale, a string as a literal color when it parses as one or as a
34
+ category in the chart's categorical palette (the way `color` colors
35
+ nodes), and nothing for any other value.
36
+ */ export function linkValueColor(viz, value) {
37
+ if (isScaleValue(value)) {
38
+ const c = colorScaleColor(viz, value);
39
+ return typeof c === "string" ? c : undefined;
40
+ }
41
+ if (typeof value !== "string" || value === "") return undefined;
42
+ if (color(value)) return value;
43
+ return colorAssign(value, linkedColorDefaults(viz));
44
+ }
45
+ /**
46
+ Builds the chart's link stroke resolver for one draw: given a link's
47
+ datum (and its drawn ends, for their shape kinds), the stroke
48
+ `linkColor` gives it, or undefined to keep the link's
49
+ `shapeConfig.Path` stroke. Links colored by number are noted for the
50
+ colorScale.
51
+ */ export function linkColorResolver(viz) {
52
+ const setting = viz.schema.linkColor;
53
+ if (!setting) return ()=>undefined;
54
+ if (setting === "source" || setting === "target") {
55
+ const configs = new Map();
56
+ return (datum, drawn)=>{
57
+ const end = linkMeta(datum)?.[setting];
58
+ if (!end) return undefined;
59
+ const kind = drawn?.[setting]?.shape;
60
+ const shape = typeof kind === "string" ? kind : "Circle";
61
+ if (!configs.has(shape)) configs.set(shape, shapeConfigFor(viz, shape));
62
+ const fill = resolveAccessor(configs.get(shape).fill, end.data, end.i);
63
+ return typeof fill === "string" ? fill : undefined;
64
+ };
65
+ }
66
+ if (typeof setting !== "function") return ()=>undefined;
67
+ return (datum)=>{
68
+ const value = setting(datum, linkMeta(datum)?.index ?? 0);
69
+ if (isScaleValue(value)) noteLinkValue(viz, datum, value);
70
+ return linkValueColor(viz, value);
71
+ };
72
+ }
@@ -0,0 +1,86 @@
1
+ /**
2
+ The link color and label config the node-link charts (Network, Rings,
3
+ Sankey, ArcDiagram) share, and the widest-link and link bundling fields
4
+ Network and Geomap share.
5
+ */ import { optionalAccessor } from "../viz/vizFields.js";
6
+ import { EDGE_BUNDLE_DEFAULTS } from "./edgeBundling.js";
7
+ import { coerceLinkColor } from "./linkColor.js";
8
+ import { LINK_LABEL_DEFAULTS } from "./linkLabels.js";
9
+ /** The `linkColor`, `linkLabel`, and `linkLabelConfig` fields. */ export function linkStyleFields() {
10
+ return [
11
+ /**
12
+ Colors each link: `"source"` or `"target"` takes that end node's
13
+ color, and a key or accessor function reads a value from each link
14
+ (receiving the link and its index in `links`). A number is colored
15
+ on the chart's colorScale, which then shows the links' values; a
16
+ string is a color when it parses as one, or else a category in the
17
+ chart's palette. `false` (the default) draws every link in the
18
+ theme's link gray.
19
+ @type {false | "source" | "target" | string | function}
20
+ */ {
21
+ key: "linkColor",
22
+ default: false,
23
+ coerce: coerceLinkColor
24
+ },
25
+ /**
26
+ Text drawn at the middle of each link: a key or accessor function
27
+ (receiving the link and its index in `links`). Numbers are
28
+ abbreviated in the chart's locale. Labels that would cover a node
29
+ or another label are hidden. Defaults to none.
30
+ @type {string | function}
31
+ */ {
32
+ key: "linkLabel",
33
+ coerce: optionalAccessor
34
+ },
35
+ /**
36
+ Styles the link labels: `rotate`, `"along"` (the default) to run
37
+ text along its link, kept upright, or `"horizontal"`; `fontSize`
38
+ (10); `padding`, the pad around the text (2); `backgroundOpacity`,
39
+ the opacity of that pad in the chart's background color (0.85);
40
+ `minRadius`, the tightest bend a curved label follows, as a radius
41
+ in ems (2); and any other TextBox setting, such as `fontColor`,
42
+ `fontFamily`, or `fontWeight`.
43
+ */ {
44
+ key: "linkLabelConfig",
45
+ merge: true,
46
+ default: {
47
+ ...LINK_LABEL_DEFAULTS
48
+ }
49
+ }
50
+ ];
51
+ }
52
+ /**
53
+ The `linkSizeMax` field: the widest link, in pixels, when `linkSize`
54
+ values differ. `fallback` is the chart's default; without one the
55
+ chart works the width out (see `linkWidthRange`).
56
+ */ export function linkSizeMaxField(fallback) {
57
+ return fallback === undefined ? {
58
+ key: "linkSizeMax"
59
+ } : {
60
+ key: "linkSizeMax",
61
+ default: fallback
62
+ };
63
+ }
64
+ /** The `linkBundle` and `linkBundleConfig` fields (Network and Geomap). */ export function linkBundleFields() {
65
+ return [
66
+ /**
67
+ Bundles the links: links running the same way near each other are
68
+ drawn pulled together, so the main flows read through the clutter.
69
+ Defaults to `false`.
70
+ @type {boolean}
71
+ */ {
72
+ key: "linkBundle",
73
+ default: false
74
+ },
75
+ /**
76
+ Tunes `linkBundle`: `strength` (0.85), `cycles` (6), `iterations`
77
+ (50), `compatibility` (0.4), and `smoothing` (true).
78
+ */ {
79
+ key: "linkBundleConfig",
80
+ merge: true,
81
+ default: {
82
+ ...EDGE_BUNDLE_DEFAULTS
83
+ }
84
+ }
85
+ ];
86
+ }