@d3plus/core 4.12.0 → 4.13.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 (839) hide show
  1. package/es/index.js +2 -2
  2. package/es/internal.js +155 -21
  3. package/es/src/charts/Alluvial/emit.js +3 -2
  4. package/es/src/charts/ArcDiagram/applyLayout.js +17 -10
  5. package/es/src/charts/ArcDiagram/arcGeometry.js +21 -8
  6. package/es/src/charts/ArcDiagram/arcLoops.js +5 -2
  7. package/es/src/charts/ArcDiagram/arcNodeBox.js +89 -0
  8. package/es/src/charts/ArcDiagram/emit.js +56 -27
  9. package/es/src/charts/ArcDiagram/events.js +10 -6
  10. package/es/src/charts/ArcDiagram/index.js +1 -1
  11. package/es/src/charts/BarChart/index.js +11 -0
  12. package/es/src/charts/BoxWhisker/extras.js +95 -0
  13. package/es/src/charts/BoxWhisker/index.js +77 -6
  14. package/es/src/charts/BoxWhisker/outliers.js +3 -2
  15. package/es/src/charts/BoxWhisker/summary.js +14 -3
  16. package/es/src/charts/BoxWhisker/tooltip.js +114 -29
  17. package/es/src/charts/BubbleChart/emit.js +9 -5
  18. package/es/src/charts/BubbleMatrix/colorDefaults.js +58 -0
  19. package/es/src/charts/BubbleMatrix/index.js +52 -0
  20. package/es/src/charts/Bullet/emit.js +3 -2
  21. package/es/src/charts/BumpChart/areaBump.js +175 -0
  22. package/es/src/charts/BumpChart/index.js +84 -18
  23. package/es/src/charts/Calendar/applyLayout.js +1 -1
  24. package/es/src/charts/Calendar/calendarDates.js +21 -7
  25. package/es/src/charts/Calendar/emit.js +3 -2
  26. package/es/src/charts/Calendar/index.js +14 -1
  27. package/es/src/charts/Candlestick/index.js +2 -1
  28. package/es/src/charts/Candlestick/periods.js +52 -29
  29. package/es/src/charts/Candlestick/tooltip.js +5 -7
  30. package/es/src/charts/Chord/emit.js +3 -2
  31. package/es/src/charts/ConnectedScatter/index.js +39 -0
  32. package/es/src/charts/CyclePlot/cycleFacet.js +162 -0
  33. package/es/src/charts/CyclePlot/cycleMeans.js +54 -0
  34. package/es/src/charts/CyclePlot/cyclePeriods.js +99 -0
  35. package/es/src/charts/CyclePlot/cycleTooltip.js +67 -0
  36. package/es/src/charts/CyclePlot/index.js +197 -0
  37. package/es/src/charts/DensityPlot/densityCurves.js +139 -0
  38. package/es/src/charts/DensityPlot/densityPoint.js +10 -0
  39. package/es/src/charts/DensityPlot/index.js +235 -0
  40. package/es/src/charts/DensityPlot/rug.js +144 -0
  41. package/es/src/charts/DotPlot/dotLayout.js +165 -0
  42. package/es/src/charts/DotPlot/facetSize.js +40 -0
  43. package/es/src/charts/DotPlot/index.js +173 -0
  44. package/es/src/charts/DotPlot/placements.js +121 -0
  45. package/es/src/charts/DotPlot/tooltip.js +68 -0
  46. package/es/src/charts/Dumbbell/arrowGrays.js +46 -0
  47. package/es/src/charts/Dumbbell/categoryChange.js +124 -0
  48. package/es/src/charts/Dumbbell/changeEmit.js +291 -0
  49. package/es/src/charts/Dumbbell/changes.js +87 -0
  50. package/es/src/charts/Dumbbell/connectors.js +46 -0
  51. package/es/src/charts/Dumbbell/emit.js +51 -50
  52. package/es/src/charts/Dumbbell/gapSort.js +2 -1
  53. package/es/src/charts/Dumbbell/index.js +121 -5
  54. package/es/src/charts/Funnel/emit.js +3 -2
  55. package/es/src/charts/Gantt/applyLayout.js +31 -9
  56. package/es/src/charts/Gantt/criticalPath.js +202 -0
  57. package/es/src/charts/Gantt/emit.js +49 -15
  58. package/es/src/charts/Gantt/ganttCalendar.js +54 -0
  59. package/es/src/charts/Gantt/ganttCritical.js +106 -0
  60. package/es/src/charts/Gantt/ganttDecor.js +183 -60
  61. package/es/src/charts/Gantt/ganttSlack.js +14 -0
  62. package/es/src/charts/Gantt/ganttTooltip.js +91 -36
  63. package/es/src/charts/Gantt/index.js +59 -10
  64. package/es/src/charts/Gauge/emit.js +3 -2
  65. package/es/src/charts/Geomap/applyLayout.js +177 -19
  66. package/es/src/charts/Geomap/cartogram.js +50 -0
  67. package/es/src/charts/Geomap/cartogramContiguous.js +196 -0
  68. package/es/src/charts/Geomap/cartogramFields.js +63 -0
  69. package/es/src/charts/Geomap/cartogramLabels.js +109 -0
  70. package/es/src/charts/Geomap/cartogramLayout.js +186 -0
  71. package/es/src/charts/Geomap/cartogramLegend.js +73 -0
  72. package/es/src/charts/Geomap/cartogramRelax.js +251 -0
  73. package/es/src/charts/Geomap/densityEmit.js +93 -0
  74. package/es/src/charts/Geomap/densityFields.js +69 -0
  75. package/es/src/charts/Geomap/densityLayout.js +90 -0
  76. package/es/src/charts/Geomap/densityTooltip.js +98 -0
  77. package/es/src/charts/Geomap/dotDensity.js +157 -0
  78. package/es/src/charts/Geomap/dotDensityLayout.js +116 -0
  79. package/es/src/charts/Geomap/dotRenderer.js +49 -0
  80. package/es/src/charts/Geomap/drillDown.js +216 -0
  81. package/es/src/charts/Geomap/drillEmit.js +64 -0
  82. package/es/src/charts/Geomap/drillEvents.js +108 -0
  83. package/es/src/charts/Geomap/emit.js +64 -42
  84. package/es/src/charts/Geomap/flowEmit.js +27 -11
  85. package/es/src/charts/Geomap/flowEvents.js +3 -1
  86. package/es/src/charts/Geomap/flowFields.js +2 -2
  87. package/es/src/charts/Geomap/flowLinks.js +18 -10
  88. package/es/src/charts/Geomap/geoHexbin.js +144 -0
  89. package/es/src/charts/Geomap/geoHexbinZoom.js +110 -0
  90. package/es/src/charts/Geomap/index.js +71 -116
  91. package/es/src/charts/Geomap/pointCluster.js +246 -0
  92. package/es/src/charts/Geomap/pointClusterEmit.js +385 -0
  93. package/es/src/charts/Geomap/pointClusterLayout.js +170 -0
  94. package/es/src/charts/Geomap/pointClusterLinks.js +95 -0
  95. package/es/src/charts/Geomap/pointClusterZoom.js +253 -0
  96. package/es/src/charts/Geomap/pointLabels.js +12 -4
  97. package/es/src/charts/Geomap/pointRows.js +25 -0
  98. package/es/src/charts/Geomap/tileGrid.js +468 -0
  99. package/es/src/charts/Geomap/tileState.js +41 -0
  100. package/es/src/charts/Geomap/topojsonFluent.js +96 -0
  101. package/es/src/charts/Geomap/topojsonLevels.js +16 -0
  102. package/es/src/charts/Hexbin/contourLabels.js +25 -17
  103. package/es/src/charts/Hexbin/index.js +2 -1
  104. package/es/src/charts/Histogram/binData.js +5 -1
  105. package/es/src/charts/Histogram/index.js +4 -26
  106. package/es/src/charts/HorizonChart/emit.js +147 -0
  107. package/es/src/charts/HorizonChart/horizonBands.js +117 -0
  108. package/es/src/charts/HorizonChart/horizonColors.js +30 -0
  109. package/es/src/charts/HorizonChart/hover.js +147 -0
  110. package/es/src/charts/HorizonChart/index.js +220 -0
  111. package/es/src/charts/HorizonChart/measure.js +91 -0
  112. package/es/src/charts/HorizonChart/rowFilter.js +250 -0
  113. package/es/src/charts/HorizonChart/state.js +64 -0
  114. package/es/src/charts/Icicle/emit.js +3 -2
  115. package/es/src/charts/KPI/applyLayout.js +119 -0
  116. package/es/src/charts/KPI/delta.js +74 -0
  117. package/es/src/charts/KPI/emit.js +303 -0
  118. package/es/src/charts/KPI/index.js +192 -0
  119. package/es/src/charts/KPI/series.js +67 -0
  120. package/es/src/charts/KPI/tileLayout.js +134 -0
  121. package/es/src/charts/Lollipop/emit.js +2 -1
  122. package/es/src/charts/Marimekko/index.js +2 -1
  123. package/es/src/charts/Matrix/applyLayout.js +10 -4
  124. package/es/src/charts/Matrix/bubbles.js +133 -0
  125. package/es/src/charts/Matrix/emit.js +68 -25
  126. package/es/src/charts/Matrix/index.js +45 -4
  127. package/es/src/charts/Network/applyLayout.js +173 -82
  128. package/es/src/charts/Network/bundle.js +26 -6
  129. package/es/src/charts/Network/circleLayout.js +281 -0
  130. package/es/src/charts/Network/containNodes.js +72 -0
  131. package/es/src/charts/Network/emit.js +78 -18
  132. package/es/src/charts/Network/forceLayout.js +111 -0
  133. package/es/src/charts/Network/graph.js +45 -6
  134. package/es/src/charts/Network/index.js +111 -2
  135. package/es/src/charts/Network/liveForce.js +312 -0
  136. package/es/src/charts/Network/livePositions.js +180 -0
  137. package/es/src/charts/Network/networkDrag.js +156 -0
  138. package/es/src/charts/Pack/emit.js +3 -2
  139. package/es/src/charts/Pack/index.js +0 -14
  140. package/es/src/charts/ParallelCoordinates/emit.js +3 -2
  141. package/es/src/charts/Pareto/color.js +46 -0
  142. package/es/src/charts/Pareto/hover.js +54 -0
  143. package/es/src/charts/Pareto/index.js +170 -0
  144. package/es/src/charts/Pareto/labels.js +91 -0
  145. package/es/src/charts/Pareto/order.js +61 -0
  146. package/es/src/charts/Pareto/paretoSteps.js +84 -0
  147. package/es/src/charts/Pareto/state.js +158 -0
  148. package/es/src/charts/Parliament/index.js +68 -0
  149. package/es/src/charts/Pie/emit.js +3 -2
  150. package/es/src/charts/Plot/areaEnter.js +5 -3
  151. package/es/src/charts/Plot/areaLabelsAlong.js +10 -2
  152. package/es/src/charts/Plot/aspectRatio.js +92 -0
  153. package/es/src/charts/Plot/axisHover.js +4 -2
  154. package/es/src/charts/Plot/axisHoverAnchors.js +2 -1
  155. package/es/src/charts/Plot/axisHoverScene.js +138 -5
  156. package/es/src/charts/Plot/barConfidence.js +7 -6
  157. package/es/src/charts/Plot/barHitArea.js +121 -7
  158. package/es/src/charts/Plot/barLabelConfidence.js +50 -0
  159. package/es/src/charts/Plot/barLabelFit.js +2 -1
  160. package/es/src/charts/Plot/barWidth.js +10 -5
  161. package/es/src/charts/Plot/baselineBreak.js +15 -6
  162. package/es/src/charts/Plot/baselineDomain.js +13 -4
  163. package/es/src/charts/Plot/circleLabels.js +26 -16
  164. package/es/src/charts/Plot/confidenceAxes.js +100 -0
  165. package/es/src/charts/Plot/confidenceConfig.js +7 -2
  166. package/es/src/charts/Plot/confidenceTooltip.js +47 -4
  167. package/es/src/charts/Plot/connectGapsScene.js +2 -1
  168. package/es/src/charts/Plot/discreteDomain.js +27 -5
  169. package/es/src/charts/Plot/discreteSpan.js +10 -1
  170. package/es/src/charts/Plot/domainClip.js +74 -44
  171. package/es/src/charts/Plot/downsample.js +26 -0
  172. package/es/src/charts/Plot/draw.js +15 -2
  173. package/es/src/charts/Plot/fillBetween.js +2 -1
  174. package/es/src/charts/Plot/forecast.js +8 -4
  175. package/es/src/charts/Plot/forecastScene.js +6 -5
  176. package/es/src/charts/Plot/index.js +49 -18
  177. package/es/src/charts/Plot/inferDiscrete.js +72 -0
  178. package/es/src/charts/Plot/jitter.js +50 -0
  179. package/es/src/charts/Plot/labelPlacement.js +4 -3
  180. package/es/src/charts/Plot/lineBands.js +6 -1
  181. package/es/src/charts/Plot/lineLabelEmit.js +4 -3
  182. package/es/src/charts/Plot/lineLabelSides.js +8 -0
  183. package/es/src/charts/Plot/lineLabelsAlong.js +45 -31
  184. package/es/src/charts/Plot/marginalHover.js +141 -0
  185. package/es/src/charts/Plot/marginalLayout.js +102 -0
  186. package/es/src/charts/Plot/marginalPaint.js +105 -0
  187. package/es/src/charts/Plot/marginalScene.js +272 -0
  188. package/es/src/charts/Plot/marginalSeries.js +73 -0
  189. package/es/src/charts/Plot/marginalStats.js +219 -0
  190. package/es/src/charts/Plot/openDomainEnds.js +60 -0
  191. package/es/src/charts/Plot/orderPath.js +137 -0
  192. package/es/src/charts/Plot/orderPathScene.js +253 -0
  193. package/es/src/charts/Plot/outlierDetect.js +179 -0
  194. package/es/src/charts/Plot/outlierLabels.js +327 -0
  195. package/es/src/charts/Plot/outlierLines.js +93 -0
  196. package/es/src/charts/Plot/outlierScene.js +308 -0
  197. package/es/src/charts/Plot/outlierTooltip.js +69 -0
  198. package/es/src/charts/Plot/periodLabels.js +27 -0
  199. package/es/src/charts/Plot/pipeline.js +62 -24
  200. package/es/src/charts/Plot/pipelineAxisLayout.js +9 -7
  201. package/es/src/charts/Plot/pipelineDomains.js +64 -27
  202. package/es/src/charts/Plot/pipelineScales.js +37 -28
  203. package/es/src/charts/Plot/plotBreaks.js +38 -18
  204. package/es/src/charts/Plot/plotFacet.js +3 -1
  205. package/es/src/charts/Plot/plotInit.js +59 -3
  206. package/es/src/charts/Plot/plotLevels.js +183 -0
  207. package/es/src/charts/Plot/plotRangeBreaks.js +46 -9
  208. package/es/src/charts/Plot/plotShapes.js +60 -0
  209. package/es/src/charts/Plot/pointConfidence.js +186 -0
  210. package/es/src/charts/Plot/pointKey.js +10 -0
  211. package/es/src/charts/Plot/referenceDomains.js +11 -6
  212. package/es/src/charts/Plot/shapeAccessors.js +52 -0
  213. package/es/src/charts/Plot/shapeDefaults.js +32 -17
  214. package/es/src/charts/Plot/sharedHover.js +40 -12
  215. package/es/src/charts/Plot/sharedHoverScene.js +49 -13
  216. package/es/src/charts/Plot/sharedTooltip.js +55 -22
  217. package/es/src/charts/Plot/stackEnter.js +7 -3
  218. package/es/src/charts/Plot/stackLegendOrder.js +5 -2
  219. package/es/src/charts/Plot/stackNeutral.js +154 -0
  220. package/es/src/charts/Plot/stackShareTooltip.js +2 -1
  221. package/es/src/charts/Plot/stackThreshold.js +2 -1
  222. package/es/src/charts/Plot/swarm.js +8 -5
  223. package/es/src/charts/Plot/timeNestKeys.js +37 -0
  224. package/es/src/charts/Plot/trendLabels.js +45 -18
  225. package/es/src/charts/Plot/trendLines.js +78 -34
  226. package/es/src/charts/Plot/trendMovingAverage.js +135 -0
  227. package/es/src/charts/Plot/trendProjection.js +18 -6
  228. package/es/src/charts/Plot/trendScene.js +4 -1
  229. package/es/src/charts/Plot/trendTooltip.js +75 -20
  230. package/es/src/charts/PolarArea/emit.js +3 -2
  231. package/es/src/charts/Priestley/applyLayout.js +9 -5
  232. package/es/src/charts/Priestley/emit.js +3 -2
  233. package/es/src/charts/Priestley/timeAxis.js +13 -5
  234. package/es/src/charts/Radar/emit.js +3 -2
  235. package/es/src/charts/RadialArea/index.js +51 -0
  236. package/es/src/charts/RadialBar/emit.js +3 -2
  237. package/es/src/charts/RadialLine/angles.js +117 -0
  238. package/es/src/charts/RadialLine/applyLayout.js +204 -0
  239. package/es/src/charts/RadialLine/emit.js +66 -0
  240. package/es/src/charts/RadialLine/index.js +228 -0
  241. package/es/src/charts/RadialLine/paths.js +55 -0
  242. package/es/src/charts/RadialLine/points.js +80 -0
  243. package/es/src/charts/RadialLine/series.js +84 -0
  244. package/es/src/charts/RadialLine/seriesLabelNodes.js +116 -0
  245. package/es/src/charts/RadialLine/seriesLabels.js +91 -0
  246. package/es/src/charts/RadialLine/spokes.js +32 -0
  247. package/es/src/charts/RadialMatrix/emit.js +3 -2
  248. package/es/src/charts/RadialTree/index.js +33 -0
  249. package/es/src/charts/Rings/applyLayout.js +22 -6
  250. package/es/src/charts/Rings/emit.js +43 -23
  251. package/es/src/charts/Rings/index.js +1 -1
  252. package/es/src/charts/Rings/ringsCurves.js +10 -8
  253. package/es/src/charts/Rings/ringsLoops.js +4 -2
  254. package/es/src/charts/Rings/ringsSizing.js +21 -13
  255. package/es/src/charts/Sankey/applyLayout.js +4 -0
  256. package/es/src/charts/Sankey/circularLayout.js +14 -6
  257. package/es/src/charts/Sankey/emit.js +3 -2
  258. package/es/src/charts/Sankey/index.js +43 -0
  259. package/es/src/charts/Sankey/sankeyDrag.js +225 -0
  260. package/es/src/charts/Sankey/sankeyLayout.js +12 -0
  261. package/es/src/charts/Scatter/index.js +3 -2
  262. package/es/src/charts/ScatterMatrix/binEmit.js +59 -0
  263. package/es/src/charts/ScatterMatrix/index.js +253 -0
  264. package/es/src/charts/ScatterMatrix/matrixData.js +161 -0
  265. package/es/src/charts/ScatterMatrix/matrixFacet.js +76 -0
  266. package/es/src/charts/ScatterMatrix/matrixHover.js +36 -0
  267. package/es/src/charts/ScatterMatrix/matrixTooltip.js +45 -0
  268. package/es/src/charts/StripPlot/index.js +53 -0
  269. package/es/src/charts/Sunburst/emit.js +3 -2
  270. package/es/src/charts/TileGridMap/index.js +29 -0
  271. package/es/src/charts/Tree/applyLayout.js +91 -18
  272. package/es/src/charts/Tree/emit.js +56 -3
  273. package/es/src/charts/Tree/index.js +24 -3
  274. package/es/src/charts/Tree/nodeHeight.js +58 -0
  275. package/es/src/charts/Tree/radialLabels.js +61 -0
  276. package/es/src/charts/Tree/radialLayout.js +210 -0
  277. package/es/src/charts/Treemap/emit.js +3 -2
  278. package/es/src/charts/Venn/applyLayout.js +176 -0
  279. package/es/src/charts/Venn/circles.js +192 -0
  280. package/es/src/charts/Venn/ellipseFrame.js +57 -0
  281. package/es/src/charts/Venn/emit.js +142 -0
  282. package/es/src/charts/Venn/index.js +178 -0
  283. package/es/src/charts/Venn/nelderMead.js +59 -0
  284. package/es/src/charts/Venn/tooltip.js +22 -0
  285. package/es/src/charts/Venn/vennData.js +99 -0
  286. package/es/src/charts/Venn/vennEllipses.js +291 -0
  287. package/es/src/charts/Venn/vennFit.js +169 -0
  288. package/es/src/charts/Venn/vennLayout.js +252 -0
  289. package/es/src/charts/Venn/vennRegions.js +133 -0
  290. package/es/src/charts/Violin/emit.js +2 -1
  291. package/es/src/charts/Violin/index.js +2 -1
  292. package/es/src/charts/Waffle/applyLayout.js +45 -22
  293. package/es/src/charts/Waffle/arcEmit.js +153 -0
  294. package/es/src/charts/Waffle/arcLayout.js +122 -0
  295. package/es/src/charts/Waffle/arcStage.js +79 -0
  296. package/es/src/charts/Waffle/emit.js +9 -4
  297. package/es/src/charts/Waffle/index.js +88 -4
  298. package/es/src/charts/Waffle/tooltip.js +7 -2
  299. package/es/src/charts/Waterfall/connectors.js +5 -3
  300. package/es/src/charts/Waterfall/state.js +2 -1
  301. package/es/src/charts/WordCloud/applyLayout.js +157 -0
  302. package/es/src/charts/WordCloud/cloudLayout.js +128 -0
  303. package/es/src/charts/WordCloud/emit.js +96 -0
  304. package/es/src/charts/WordCloud/fontScale.js +34 -0
  305. package/es/src/charts/WordCloud/glyphMask.js +298 -0
  306. package/es/src/charts/WordCloud/index.js +174 -0
  307. package/es/src/charts/WordCloud/occupancy.js +99 -0
  308. package/es/src/charts/WordCloud/rotation.js +44 -0
  309. package/es/src/charts/WordCloud/size.js +15 -0
  310. package/es/src/charts/WordCloud/spiral.js +72 -0
  311. package/es/src/charts/definition/applyDefinition.js +6 -1
  312. package/es/src/charts/definition/declaresField.js +14 -0
  313. package/es/src/charts/definition/makeChart.js +10 -2
  314. package/es/src/charts/drawSteps/bottomRightControls.js +1 -1
  315. package/es/src/charts/drawSteps/bottomRightControlsMarkup.js +1 -1
  316. package/es/src/charts/drawSteps/gestureHover.js +10 -6
  317. package/es/src/charts/drawSteps/leavesSurface.js +12 -0
  318. package/es/src/charts/drawSteps/minimap.js +1 -1
  319. package/es/src/charts/drawSteps/selectActions.js +105 -0
  320. package/es/src/charts/drawSteps/selectGesture.js +318 -0
  321. package/es/src/charts/drawSteps/selectRegion.js +222 -0
  322. package/es/src/charts/drawSteps/selectState.js +118 -0
  323. package/es/src/charts/drawSteps/topLeftControls.js +4 -1
  324. package/es/src/charts/drawSteps/zoomControls.js +59 -19
  325. package/es/src/charts/drawSteps/zoomControlsMarkup.js +212 -39
  326. package/es/src/charts/drawSteps/zoomControlsMenu.js +140 -0
  327. package/es/src/charts/drawSteps/zoomDrag.js +3 -1
  328. package/es/src/charts/events/mouseleave.js +6 -3
  329. package/es/src/charts/events/mousemove.legend.js +10 -5
  330. package/es/src/charts/events/mousemove.shape.js +15 -6
  331. package/es/src/charts/facet/drawFacets.js +61 -22
  332. package/es/src/charts/facet/facetConfig.js +3 -1
  333. package/es/src/charts/facet/facetData.js +10 -2
  334. package/es/src/charts/facet/facetGrid.js +5 -1
  335. package/es/src/charts/facet/facetGutter.js +36 -7
  336. package/es/src/charts/facet/facetLayout.js +136 -0
  337. package/es/src/charts/facet/facetLayouts.js +574 -0
  338. package/es/src/charts/facet/facetScene.js +10 -3
  339. package/es/src/charts/features/annotationFrame.js +8 -3
  340. package/es/src/charts/features/axes.js +4 -2
  341. package/es/src/charts/features/axesFinal.js +92 -8
  342. package/es/src/charts/features/axesMeasure.js +7 -4
  343. package/es/src/charts/features/bareRegion.js +24 -0
  344. package/es/src/charts/features/boxGrid.js +39 -0
  345. package/es/src/charts/features/centerLabel.js +36 -17
  346. package/es/src/charts/features/circleLabelPlacement.js +288 -83
  347. package/es/src/charts/features/circleLabels.js +66 -14
  348. package/es/src/charts/features/colorScaleHover.js +7 -2
  349. package/es/src/charts/features/colorScaleTooltip.js +6 -21
  350. package/es/src/charts/features/colorScaleTop.js +12 -2
  351. package/es/src/charts/features/colorScaleValue.js +10 -1
  352. package/es/src/charts/features/curvedArrows.js +46 -28
  353. package/es/src/charts/features/edgeArrows.js +48 -18
  354. package/es/src/charts/features/emitHelpers.js +7 -2
  355. package/es/src/charts/features/features.js +25 -5
  356. package/es/src/charts/features/featuresColorScale.js +7 -4
  357. package/es/src/charts/features/featuresLegend.js +20 -0
  358. package/es/src/charts/features/hoverTicks.js +12 -7
  359. package/es/src/charts/features/keyHold.js +115 -0
  360. package/es/src/charts/features/keyTooltip.js +91 -0
  361. package/es/src/charts/features/labelLayering.js +149 -0
  362. package/es/src/charts/features/labelSlots.js +112 -0
  363. package/es/src/charts/features/linkInteraction.js +4 -1
  364. package/es/src/charts/features/linkLabelPath.js +2 -39
  365. package/es/src/charts/features/nodeDrag.js +175 -0
  366. package/es/src/charts/features/nodeKeys.js +117 -0
  367. package/es/src/charts/features/nodeOutline.js +41 -0
  368. package/es/src/charts/features/pathLabelBends.js +191 -0
  369. package/es/src/charts/features/plotAnnotations.js +8 -5
  370. package/es/src/charts/features/plotPaint.js +45 -13
  371. package/es/src/charts/features/rectNodeSize.js +41 -0
  372. package/es/src/charts/features/ringLabels.js +3 -1
  373. package/es/src/charts/features/selfLoops.js +33 -23
  374. package/es/src/charts/features/shapeEmit.js +104 -32
  375. package/es/src/charts/features/sharedFields.js +10 -5
  376. package/es/src/charts/features/spokeLabels.js +178 -0
  377. package/es/src/charts/features/swatchPaint.js +68 -0
  378. package/es/src/charts/features/thresholdMembers.js +8 -12
  379. package/es/src/charts/features/tooltipRows.js +76 -0
  380. package/es/src/charts/features/tooltipSwatch.js +81 -24
  381. package/es/src/charts/features/xAxisConfig.js +2 -1
  382. package/es/src/charts/helpers/densityChart.js +2 -7
  383. package/es/src/charts/helpers/valueTitle.js +13 -1
  384. package/es/src/charts/index.js +17 -0
  385. package/es/src/charts/partition/interaction.js +2 -2
  386. package/es/src/charts/pipeline/insetPlacement.js +13 -6
  387. package/es/src/charts/pipeline/preDrawData.js +80 -11
  388. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  389. package/es/src/charts/pipeline/stages.js +3 -2
  390. package/es/src/charts/pipeline/vizPreDraw.js +4 -0
  391. package/es/src/charts/plotBuffers/Circle.js +3 -2
  392. package/es/src/charts/plotBuffers/Line.js +6 -5
  393. package/es/src/charts/plotBuffers/Rect.js +3 -2
  394. package/es/src/charts/plotBuffers/Tick.js +12 -0
  395. package/es/src/charts/plotBuffers/defaultBuffers.js +3 -1
  396. package/es/src/charts/plotBuffers/rectLikeBuffer.js +4 -3
  397. package/es/src/charts/viz/Viz.js +32 -18
  398. package/es/src/charts/viz/VizBase.js +39 -38
  399. package/es/src/charts/viz/appendRows.js +90 -0
  400. package/es/src/charts/viz/dataChanged.js +19 -0
  401. package/es/src/charts/viz/discrete.js +9 -0
  402. package/es/src/charts/viz/focusTargets.js +25 -5
  403. package/es/src/charts/viz/groupByLevels.js +48 -0
  404. package/es/src/charts/viz/groupRow.js +27 -0
  405. package/es/src/charts/viz/hoverBand.js +40 -0
  406. package/es/src/charts/viz/interactionOpacity.js +134 -29
  407. package/es/src/charts/viz/keyboardNav.js +39 -9
  408. package/es/src/charts/viz/liftRaised.js +84 -0
  409. package/es/src/charts/viz/nearestHover.js +9 -2
  410. package/es/src/charts/viz/setCursor.js +12 -0
  411. package/es/src/charts/viz/simpleHover.js +3 -4
  412. package/es/src/charts/viz/userClick.js +11 -0
  413. package/es/src/charts/viz/vizDefaults.js +10 -0
  414. package/es/src/charts/viz/vizFields.js +7 -0
  415. package/es/src/charts/viz/vizTypes.js +1 -1
  416. package/es/src/components/Axis/Axis.js +85 -12
  417. package/es/src/components/Axis/AxisBottom.js +1 -0
  418. package/es/src/components/Axis/AxisLeft.js +1 -0
  419. package/es/src/components/Axis/AxisRight.js +1 -0
  420. package/es/src/components/Axis/AxisTop.js +1 -0
  421. package/es/src/components/Axis/axisDefaults.js +7 -0
  422. package/es/src/components/Axis/axisEndLabels.js +4 -1
  423. package/es/src/components/Axis/axisLabelSize.js +40 -16
  424. package/es/src/components/Axis/axisLabelThinning.js +69 -6
  425. package/es/src/components/Axis/axisLayout.js +5 -0
  426. package/es/src/components/Axis/axisLayoutLabels.js +11 -5
  427. package/es/src/components/Axis/axisLayoutScale.js +71 -25
  428. package/es/src/components/Axis/axisLevels.js +271 -0
  429. package/es/src/components/Axis/axisLimit.js +6 -0
  430. package/es/src/components/Axis/axisMinorTicks.js +280 -0
  431. package/es/src/components/Axis/axisPeriods.js +144 -0
  432. package/es/src/components/Axis/axisRangeBreaks.js +19 -10
  433. package/es/src/components/Axis/axisRender.js +71 -29
  434. package/es/src/components/Axis/axisRounding.js +24 -2
  435. package/es/src/components/Axis/axisScaleType.js +55 -0
  436. package/es/src/components/Axis/axisScene.js +90 -5
  437. package/es/src/components/Axis/axisTickLookups.js +30 -0
  438. package/es/src/components/Axis/axisTooltipTargets.js +23 -0
  439. package/es/src/components/Axis/labelSizeSession.js +23 -0
  440. package/es/src/components/Axis/rangeBreaks.js +10 -4
  441. package/es/src/components/Axis/timeValues.js +116 -19
  442. package/es/src/components/ColorScale/ColorScale.js +1 -0
  443. package/es/src/components/ColorScale/colorScaleScale.js +139 -41
  444. package/es/src/components/Legend/Legend.js +1 -0
  445. package/es/src/components/SizeLegend/SizeLegend.js +20 -1
  446. package/es/src/components/TextBox.js +1 -0
  447. package/es/src/components/Timeline/Timeline.js +11 -3
  448. package/es/src/components/Timeline/timelineRender.js +23 -13
  449. package/es/src/components/Tooltip.js +8 -1
  450. package/es/src/components/tooltipDom.js +73 -14
  451. package/es/src/fluent.js +77 -10
  452. package/es/src/shapes/Area.js +32 -1
  453. package/es/src/shapes/Bar.js +22 -1
  454. package/es/src/shapes/Box.js +72 -13
  455. package/es/src/shapes/Circle.js +1 -0
  456. package/es/src/shapes/Image.js +8 -1
  457. package/es/src/shapes/Line.js +45 -1
  458. package/es/src/shapes/Path.js +1 -0
  459. package/es/src/shapes/Rect.js +1 -0
  460. package/es/src/shapes/Shape.js +29 -8
  461. package/es/src/shapes/Tick.js +54 -0
  462. package/es/src/shapes/Whisker.js +1 -0
  463. package/es/src/shapes/boxExtraShapes.js +72 -0
  464. package/es/src/shapes/boxExtras.js +212 -0
  465. package/es/src/shapes/boxStyle.js +38 -5
  466. package/es/src/shapes/buildLabelData.js +2 -0
  467. package/es/src/shapes/downsample.js +150 -0
  468. package/es/src/shapes/hitAreaNode.js +6 -2
  469. package/es/src/shapes/index.js +1 -0
  470. package/es/src/shapes/pathSeries.js +51 -0
  471. package/es/src/utils/BaseClass.js +59 -57
  472. package/es/src/utils/jitter.js +33 -0
  473. package/es/src/utils/resetSetters.js +66 -0
  474. package/package.json +10 -10
  475. package/types/index.d.ts +5 -4
  476. package/types/internal.d.ts +253 -27
  477. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +7 -3
  478. package/types/src/charts/ArcDiagram/arcLoops.d.ts +3 -1
  479. package/types/src/charts/ArcDiagram/arcNodeBox.d.ts +60 -0
  480. package/types/src/charts/ArcDiagram/emit.d.ts +5 -4
  481. package/types/src/charts/BoxWhisker/extras.d.ts +41 -0
  482. package/types/src/charts/BoxWhisker/summary.d.ts +1 -1
  483. package/types/src/charts/BoxWhisker/tooltip.d.ts +33 -4
  484. package/types/src/charts/BubbleChart/emit.d.ts +3 -3
  485. package/types/src/charts/BubbleMatrix/colorDefaults.d.ts +19 -0
  486. package/types/src/charts/BubbleMatrix/index.d.ts +18 -0
  487. package/types/src/charts/BumpChart/areaBump.d.ts +86 -0
  488. package/types/src/charts/BumpChart/index.d.ts +19 -1
  489. package/types/src/charts/Calendar/calendarDates.d.ts +8 -1
  490. package/types/src/charts/Candlestick/periods.d.ts +19 -8
  491. package/types/src/charts/ConnectedScatter/index.d.ts +17 -0
  492. package/types/src/charts/CyclePlot/cycleFacet.d.ts +61 -0
  493. package/types/src/charts/CyclePlot/cycleMeans.d.ts +32 -0
  494. package/types/src/charts/CyclePlot/cyclePeriods.d.ts +37 -0
  495. package/types/src/charts/CyclePlot/cycleTooltip.d.ts +47 -0
  496. package/types/src/charts/CyclePlot/index.d.ts +75 -0
  497. package/types/src/charts/DensityPlot/densityCurves.d.ts +84 -0
  498. package/types/src/charts/DensityPlot/densityPoint.d.ts +16 -0
  499. package/types/src/charts/DensityPlot/index.d.ts +33 -0
  500. package/types/src/charts/DensityPlot/rug.d.ts +57 -0
  501. package/types/src/charts/DotPlot/dotLayout.d.ts +95 -0
  502. package/types/src/charts/DotPlot/facetSize.d.ts +33 -0
  503. package/types/src/charts/DotPlot/index.d.ts +22 -0
  504. package/types/src/charts/DotPlot/placements.d.ts +28 -0
  505. package/types/src/charts/DotPlot/tooltip.d.ts +27 -0
  506. package/types/src/charts/Dumbbell/arrowGrays.d.ts +33 -0
  507. package/types/src/charts/Dumbbell/categoryChange.d.ts +66 -0
  508. package/types/src/charts/Dumbbell/changeEmit.d.ts +71 -0
  509. package/types/src/charts/Dumbbell/changes.d.ts +64 -0
  510. package/types/src/charts/Dumbbell/connectors.d.ts +43 -0
  511. package/types/src/charts/Dumbbell/emit.d.ts +17 -19
  512. package/types/src/charts/Dumbbell/index.d.ts +6 -2
  513. package/types/src/charts/Gantt/applyLayout.d.ts +14 -1
  514. package/types/src/charts/Gantt/criticalPath.d.ts +100 -0
  515. package/types/src/charts/Gantt/emit.d.ts +17 -1
  516. package/types/src/charts/Gantt/ganttCalendar.d.ts +37 -0
  517. package/types/src/charts/Gantt/ganttCritical.d.ts +53 -0
  518. package/types/src/charts/Gantt/ganttDecor.d.ts +32 -2
  519. package/types/src/charts/Gantt/ganttRows.d.ts +2 -0
  520. package/types/src/charts/Gantt/ganttSlack.d.ts +21 -0
  521. package/types/src/charts/Gantt/ganttTooltip.d.ts +35 -15
  522. package/types/src/charts/Gantt/index.d.ts +12 -6
  523. package/types/src/charts/Geomap/applyLayout.d.ts +19 -0
  524. package/types/src/charts/Geomap/cartogram.d.ts +58 -0
  525. package/types/src/charts/Geomap/cartogramContiguous.d.ts +59 -0
  526. package/types/src/charts/Geomap/cartogramFields.d.ts +16 -0
  527. package/types/src/charts/Geomap/cartogramLabels.d.ts +48 -0
  528. package/types/src/charts/Geomap/cartogramLayout.d.ts +71 -0
  529. package/types/src/charts/Geomap/cartogramLegend.d.ts +36 -0
  530. package/types/src/charts/Geomap/cartogramRelax.d.ts +29 -0
  531. package/types/src/charts/Geomap/densityEmit.d.ts +29 -0
  532. package/types/src/charts/Geomap/densityFields.d.ts +27 -0
  533. package/types/src/charts/Geomap/densityLayout.d.ts +49 -0
  534. package/types/src/charts/Geomap/densityTooltip.d.ts +48 -0
  535. package/types/src/charts/Geomap/dotDensity.d.ts +80 -0
  536. package/types/src/charts/Geomap/dotDensityLayout.d.ts +97 -0
  537. package/types/src/charts/Geomap/dotRenderer.d.ts +27 -0
  538. package/types/src/charts/Geomap/drillDown.d.ts +128 -0
  539. package/types/src/charts/Geomap/drillEmit.d.ts +37 -0
  540. package/types/src/charts/Geomap/drillEvents.d.ts +33 -0
  541. package/types/src/charts/Geomap/emit.d.ts +7 -0
  542. package/types/src/charts/Geomap/flowEmit.d.ts +5 -4
  543. package/types/src/charts/Geomap/flowLinks.d.ts +12 -1
  544. package/types/src/charts/Geomap/geoHexbin.d.ts +91 -0
  545. package/types/src/charts/Geomap/geoHexbinZoom.d.ts +76 -0
  546. package/types/src/charts/Geomap/index.d.ts +7 -0
  547. package/types/src/charts/Geomap/pointCluster.d.ts +108 -0
  548. package/types/src/charts/Geomap/pointClusterEmit.d.ts +106 -0
  549. package/types/src/charts/Geomap/pointClusterLayout.d.ts +123 -0
  550. package/types/src/charts/Geomap/pointClusterLinks.d.ts +21 -0
  551. package/types/src/charts/Geomap/pointClusterZoom.d.ts +89 -0
  552. package/types/src/charts/Geomap/pointLabels.d.ts +21 -3
  553. package/types/src/charts/Geomap/pointRows.d.ts +24 -0
  554. package/types/src/charts/Geomap/tileGrid.d.ts +98 -0
  555. package/types/src/charts/Geomap/tileState.d.ts +18 -0
  556. package/types/src/charts/Geomap/topojsonFluent.d.ts +9 -0
  557. package/types/src/charts/Geomap/topojsonLevels.d.ts +14 -0
  558. package/types/src/charts/Hexbin/contourLabels.d.ts +6 -5
  559. package/types/src/charts/Hexbin/settings.d.ts +7 -1
  560. package/types/src/charts/Histogram/binData.d.ts +6 -0
  561. package/types/src/charts/HorizonChart/emit.d.ts +20 -0
  562. package/types/src/charts/HorizonChart/horizonBands.d.ts +42 -0
  563. package/types/src/charts/HorizonChart/horizonColors.d.ts +25 -0
  564. package/types/src/charts/HorizonChart/hover.d.ts +52 -0
  565. package/types/src/charts/HorizonChart/index.d.ts +32 -0
  566. package/types/src/charts/HorizonChart/measure.d.ts +24 -0
  567. package/types/src/charts/HorizonChart/rowFilter.d.ts +88 -0
  568. package/types/src/charts/HorizonChart/state.d.ts +71 -0
  569. package/types/src/charts/KPI/applyLayout.d.ts +64 -0
  570. package/types/src/charts/KPI/delta.d.ts +62 -0
  571. package/types/src/charts/KPI/emit.d.ts +55 -0
  572. package/types/src/charts/KPI/index.d.ts +34 -0
  573. package/types/src/charts/KPI/series.d.ts +45 -0
  574. package/types/src/charts/KPI/tileLayout.d.ts +90 -0
  575. package/types/src/charts/Matrix/applyLayout.d.ts +2 -1
  576. package/types/src/charts/Matrix/bubbles.d.ts +87 -0
  577. package/types/src/charts/Matrix/emit.d.ts +3 -2
  578. package/types/src/charts/Matrix/index.d.ts +2 -1
  579. package/types/src/charts/Network/applyLayout.d.ts +24 -0
  580. package/types/src/charts/Network/bundle.d.ts +23 -16
  581. package/types/src/charts/Network/circleLayout.d.ts +149 -0
  582. package/types/src/charts/Network/containNodes.d.ts +35 -0
  583. package/types/src/charts/Network/emit.d.ts +20 -0
  584. package/types/src/charts/Network/forceLayout.d.ts +49 -0
  585. package/types/src/charts/Network/graph.d.ts +18 -2
  586. package/types/src/charts/Network/liveForce.d.ts +133 -0
  587. package/types/src/charts/Network/livePositions.d.ts +90 -0
  588. package/types/src/charts/Network/networkDrag.d.ts +55 -0
  589. package/types/src/charts/Pareto/color.d.ts +21 -0
  590. package/types/src/charts/Pareto/hover.d.ts +38 -0
  591. package/types/src/charts/Pareto/index.d.ts +22 -0
  592. package/types/src/charts/Pareto/labels.d.ts +40 -0
  593. package/types/src/charts/Pareto/order.d.ts +30 -0
  594. package/types/src/charts/Pareto/paretoSteps.d.ts +65 -0
  595. package/types/src/charts/Pareto/state.d.ts +93 -0
  596. package/types/src/charts/Parliament/index.d.ts +18 -0
  597. package/types/src/charts/Plot/areaLabelsAlong.d.ts +7 -0
  598. package/types/src/charts/Plot/aspectRatio.d.ts +68 -0
  599. package/types/src/charts/Plot/axisHover.d.ts +2 -0
  600. package/types/src/charts/Plot/axisHoverScene.d.ts +44 -1
  601. package/types/src/charts/Plot/barConfidence.d.ts +14 -1
  602. package/types/src/charts/Plot/barHitArea.d.ts +34 -7
  603. package/types/src/charts/Plot/barLabelConfidence.d.ts +25 -0
  604. package/types/src/charts/Plot/baselineBreak.d.ts +2 -1
  605. package/types/src/charts/Plot/baselineDomain.d.ts +5 -0
  606. package/types/src/charts/Plot/circleLabels.d.ts +8 -7
  607. package/types/src/charts/Plot/confidenceAxes.d.ts +63 -0
  608. package/types/src/charts/Plot/confidenceTooltip.d.ts +22 -0
  609. package/types/src/charts/Plot/discreteDomain.d.ts +13 -2
  610. package/types/src/charts/Plot/discreteSpan.d.ts +5 -0
  611. package/types/src/charts/Plot/domainClip.d.ts +15 -5
  612. package/types/src/charts/Plot/downsample.d.ts +16 -0
  613. package/types/src/charts/Plot/index.d.ts +17 -8
  614. package/types/src/charts/Plot/inferDiscrete.d.ts +31 -0
  615. package/types/src/charts/Plot/jitter.d.ts +45 -0
  616. package/types/src/charts/Plot/lineLabelSides.d.ts +19 -0
  617. package/types/src/charts/Plot/lineLabelsAlong.d.ts +19 -6
  618. package/types/src/charts/Plot/marginalHover.d.ts +26 -0
  619. package/types/src/charts/Plot/marginalLayout.d.ts +95 -0
  620. package/types/src/charts/Plot/marginalPaint.d.ts +54 -0
  621. package/types/src/charts/Plot/marginalScene.d.ts +67 -0
  622. package/types/src/charts/Plot/marginalSeries.d.ts +38 -0
  623. package/types/src/charts/Plot/marginalStats.d.ts +115 -0
  624. package/types/src/charts/Plot/openDomainEnds.d.ts +25 -0
  625. package/types/src/charts/Plot/orderPath.d.ts +100 -0
  626. package/types/src/charts/Plot/orderPathScene.d.ts +49 -0
  627. package/types/src/charts/Plot/outlierDetect.d.ts +87 -0
  628. package/types/src/charts/Plot/outlierLabels.d.ts +103 -0
  629. package/types/src/charts/Plot/outlierLines.d.ts +30 -0
  630. package/types/src/charts/Plot/outlierScene.d.ts +103 -0
  631. package/types/src/charts/Plot/outlierTooltip.d.ts +44 -0
  632. package/types/src/charts/Plot/periodLabels.d.ts +14 -0
  633. package/types/src/charts/Plot/pipeline.d.ts +2 -1
  634. package/types/src/charts/Plot/plotBreaks.d.ts +21 -6
  635. package/types/src/charts/Plot/plotInit.d.ts +7 -25
  636. package/types/src/charts/Plot/plotLevels.d.ts +120 -0
  637. package/types/src/charts/Plot/plotRangeBreaks.d.ts +28 -2
  638. package/types/src/charts/Plot/plotShapes.d.ts +42 -0
  639. package/types/src/charts/Plot/pointConfidence.d.ts +73 -0
  640. package/types/src/charts/Plot/pointKey.d.ts +9 -0
  641. package/types/src/charts/Plot/referenceDomains.d.ts +2 -1
  642. package/types/src/charts/Plot/shapeAccessors.d.ts +24 -0
  643. package/types/src/charts/Plot/sharedHover.d.ts +5 -0
  644. package/types/src/charts/Plot/sharedTooltip.d.ts +24 -6
  645. package/types/src/charts/Plot/stackEnter.d.ts +1 -1
  646. package/types/src/charts/Plot/stackLegendOrder.d.ts +4 -1
  647. package/types/src/charts/Plot/stackNeutral.d.ts +85 -0
  648. package/types/src/charts/Plot/swarm.d.ts +8 -4
  649. package/types/src/charts/Plot/timeNestKeys.d.ts +20 -0
  650. package/types/src/charts/Plot/trendLabels.d.ts +15 -6
  651. package/types/src/charts/Plot/trendLines.d.ts +40 -8
  652. package/types/src/charts/Plot/trendMovingAverage.d.ts +78 -0
  653. package/types/src/charts/Plot/trendProjection.d.ts +4 -2
  654. package/types/src/charts/Plot/trendTooltip.d.ts +24 -2
  655. package/types/src/charts/Priestley/timeAxis.d.ts +6 -3
  656. package/types/src/charts/RadialArea/index.d.ts +17 -0
  657. package/types/src/charts/RadialLine/angles.d.ts +67 -0
  658. package/types/src/charts/RadialLine/applyLayout.d.ts +70 -0
  659. package/types/src/charts/RadialLine/emit.d.ts +13 -0
  660. package/types/src/charts/RadialLine/index.d.ts +28 -0
  661. package/types/src/charts/RadialLine/paths.d.ts +37 -0
  662. package/types/src/charts/RadialLine/points.d.ts +43 -0
  663. package/types/src/charts/RadialLine/series.d.ts +63 -0
  664. package/types/src/charts/RadialLine/seriesLabelNodes.d.ts +26 -0
  665. package/types/src/charts/RadialLine/seriesLabels.d.ts +80 -0
  666. package/types/src/charts/RadialLine/spokes.d.ts +15 -0
  667. package/types/src/charts/RadialTree/index.d.ts +16 -0
  668. package/types/src/charts/Rings/emit.d.ts +6 -5
  669. package/types/src/charts/Rings/ringsCurves.d.ts +10 -14
  670. package/types/src/charts/Rings/ringsGraph.d.ts +3 -0
  671. package/types/src/charts/Rings/ringsSizing.d.ts +5 -2
  672. package/types/src/charts/Sankey/circularLayout.d.ts +3 -0
  673. package/types/src/charts/Sankey/sankeyDrag.d.ts +112 -0
  674. package/types/src/charts/Sankey/sankeyLayout.d.ts +8 -0
  675. package/types/src/charts/Scatter/index.d.ts +3 -2
  676. package/types/src/charts/ScatterMatrix/binEmit.d.ts +22 -0
  677. package/types/src/charts/ScatterMatrix/index.d.ts +80 -0
  678. package/types/src/charts/ScatterMatrix/matrixData.d.ts +93 -0
  679. package/types/src/charts/ScatterMatrix/matrixFacet.d.ts +32 -0
  680. package/types/src/charts/ScatterMatrix/matrixHover.d.ts +21 -0
  681. package/types/src/charts/ScatterMatrix/matrixTooltip.d.ts +32 -0
  682. package/types/src/charts/StripPlot/index.d.ts +16 -0
  683. package/types/src/charts/TileGridMap/index.d.ts +14 -0
  684. package/types/src/charts/Tree/index.d.ts +2 -2
  685. package/types/src/charts/Tree/nodeHeight.d.ts +41 -0
  686. package/types/src/charts/Tree/radialLabels.d.ts +24 -0
  687. package/types/src/charts/Tree/radialLayout.d.ts +129 -0
  688. package/types/src/charts/Venn/applyLayout.d.ts +91 -0
  689. package/types/src/charts/Venn/circles.d.ts +87 -0
  690. package/types/src/charts/Venn/ellipseFrame.d.ts +37 -0
  691. package/types/src/charts/Venn/emit.d.ts +36 -0
  692. package/types/src/charts/Venn/index.d.ts +30 -0
  693. package/types/src/charts/Venn/nelderMead.d.ts +28 -0
  694. package/types/src/charts/Venn/tooltip.d.ts +8 -0
  695. package/types/src/charts/Venn/vennData.d.ts +56 -0
  696. package/types/src/charts/Venn/vennEllipses.d.ts +93 -0
  697. package/types/src/charts/Venn/vennFit.d.ts +39 -0
  698. package/types/src/charts/Venn/vennLayout.d.ts +52 -0
  699. package/types/src/charts/Venn/vennRegions.d.ts +58 -0
  700. package/types/src/charts/Waffle/applyLayout.d.ts +4 -1
  701. package/types/src/charts/Waffle/arcEmit.d.ts +45 -0
  702. package/types/src/charts/Waffle/arcLayout.d.ts +82 -0
  703. package/types/src/charts/Waffle/arcStage.d.ts +60 -0
  704. package/types/src/charts/Waffle/emit.d.ts +2 -1
  705. package/types/src/charts/Waffle/index.d.ts +8 -2
  706. package/types/src/charts/Waffle/tooltip.d.ts +7 -2
  707. package/types/src/charts/Waterfall/connectors.d.ts +3 -2
  708. package/types/src/charts/WordCloud/applyLayout.d.ts +51 -0
  709. package/types/src/charts/WordCloud/cloudLayout.d.ts +95 -0
  710. package/types/src/charts/WordCloud/emit.d.ts +27 -0
  711. package/types/src/charts/WordCloud/fontScale.d.ts +20 -0
  712. package/types/src/charts/WordCloud/glyphMask.d.ts +95 -0
  713. package/types/src/charts/WordCloud/index.d.ts +31 -0
  714. package/types/src/charts/WordCloud/occupancy.d.ts +59 -0
  715. package/types/src/charts/WordCloud/rotation.d.ts +31 -0
  716. package/types/src/charts/WordCloud/size.d.ts +16 -0
  717. package/types/src/charts/WordCloud/spiral.d.ts +47 -0
  718. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  719. package/types/src/charts/definition/declaresField.d.ts +9 -0
  720. package/types/src/charts/definition/makeChart.d.ts +2 -2
  721. package/types/src/charts/drawSteps/gestureHover.d.ts +2 -2
  722. package/types/src/charts/drawSteps/leavesSurface.d.ts +11 -0
  723. package/types/src/charts/drawSteps/selectActions.d.ts +58 -0
  724. package/types/src/charts/drawSteps/selectGesture.d.ts +60 -0
  725. package/types/src/charts/drawSteps/selectRegion.d.ts +86 -0
  726. package/types/src/charts/drawSteps/selectState.d.ts +51 -0
  727. package/types/src/charts/drawSteps/zoomControls.d.ts +17 -7
  728. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +94 -21
  729. package/types/src/charts/drawSteps/zoomControlsMenu.d.ts +30 -0
  730. package/types/src/charts/drawSteps/zoomDrag.d.ts +2 -0
  731. package/types/src/charts/facet/drawFacets.d.ts +6 -3
  732. package/types/src/charts/facet/facetConfig.d.ts +35 -1
  733. package/types/src/charts/facet/facetData.d.ts +8 -2
  734. package/types/src/charts/facet/facetGrid.d.ts +12 -0
  735. package/types/src/charts/facet/facetGutter.d.ts +19 -5
  736. package/types/src/charts/facet/facetLayout.d.ts +79 -0
  737. package/types/src/charts/facet/facetLayouts.d.ts +21 -0
  738. package/types/src/charts/facet/facetScene.d.ts +4 -1
  739. package/types/src/charts/features/annotationFrame.d.ts +2 -0
  740. package/types/src/charts/features/axesFinal.d.ts +5 -2
  741. package/types/src/charts/features/bareRegion.d.ts +18 -0
  742. package/types/src/charts/features/boxGrid.d.ts +28 -0
  743. package/types/src/charts/features/centerLabel.d.ts +16 -2
  744. package/types/src/charts/features/circleLabelPlacement.d.ts +81 -11
  745. package/types/src/charts/features/circleLabels.d.ts +33 -3
  746. package/types/src/charts/features/colorScaleHover.d.ts +3 -2
  747. package/types/src/charts/features/colorScaleTooltip.d.ts +4 -9
  748. package/types/src/charts/features/colorScaleValue.d.ts +6 -0
  749. package/types/src/charts/features/curvedArrows.d.ts +28 -12
  750. package/types/src/charts/features/edgeArrows.d.ts +40 -30
  751. package/types/src/charts/features/emitHelpers.d.ts +6 -1
  752. package/types/src/charts/features/featuresColorScale.d.ts +6 -0
  753. package/types/src/charts/features/hoverTicks.d.ts +5 -2
  754. package/types/src/charts/features/keyHold.d.ts +41 -0
  755. package/types/src/charts/features/keyTooltip.d.ts +44 -0
  756. package/types/src/charts/features/labelLayering.d.ts +38 -0
  757. package/types/src/charts/features/labelSlots.d.ts +53 -0
  758. package/types/src/charts/features/linkLabelPath.d.ts +0 -7
  759. package/types/src/charts/features/nodeDrag.d.ts +51 -0
  760. package/types/src/charts/features/nodeKeys.d.ts +53 -0
  761. package/types/src/charts/features/nodeOutline.d.ts +34 -0
  762. package/types/src/charts/features/pathLabelBends.d.ts +78 -0
  763. package/types/src/charts/features/plotAnnotations.d.ts +2 -1
  764. package/types/src/charts/features/plotPaint.d.ts +5 -0
  765. package/types/src/charts/features/rectNodeSize.d.ts +42 -0
  766. package/types/src/charts/features/ringLabels.d.ts +3 -1
  767. package/types/src/charts/features/selfLoops.d.ts +10 -9
  768. package/types/src/charts/features/shapeEmit.d.ts +2 -0
  769. package/types/src/charts/features/sharedFields.d.ts +8 -4
  770. package/types/src/charts/features/spokeLabels.d.ts +123 -0
  771. package/types/src/charts/features/swatchPaint.d.ts +58 -0
  772. package/types/src/charts/features/thresholdMembers.d.ts +6 -6
  773. package/types/src/charts/features/tooltipRows.d.ts +50 -0
  774. package/types/src/charts/features/tooltipSwatch.d.ts +25 -11
  775. package/types/src/charts/helpers/valueTitle.d.ts +7 -0
  776. package/types/src/charts/index.d.ts +17 -0
  777. package/types/src/charts/pipeline/preDrawData.d.ts +26 -0
  778. package/types/src/charts/plotBuffers/Circle.d.ts +2 -1
  779. package/types/src/charts/plotBuffers/Rect.d.ts +2 -1
  780. package/types/src/charts/plotBuffers/Tick.d.ts +9 -0
  781. package/types/src/charts/plotBuffers/defaultBuffers.d.ts +2 -0
  782. package/types/src/charts/viz/VizBase.d.ts +32 -1
  783. package/types/src/charts/viz/appendRows.d.ts +49 -0
  784. package/types/src/charts/viz/dataChanged.d.ts +11 -0
  785. package/types/src/charts/viz/discrete.d.ts +19 -0
  786. package/types/src/charts/viz/focusTargets.d.ts +15 -1
  787. package/types/src/charts/viz/groupByLevels.d.ts +36 -0
  788. package/types/src/charts/viz/groupRow.d.ts +6 -0
  789. package/types/src/charts/viz/hoverBand.d.ts +28 -0
  790. package/types/src/charts/viz/interactionOpacity.d.ts +23 -2
  791. package/types/src/charts/viz/keyboardNav.d.ts +13 -0
  792. package/types/src/charts/viz/liftRaised.d.ts +23 -0
  793. package/types/src/charts/viz/setCursor.d.ts +12 -0
  794. package/types/src/charts/viz/simpleHover.d.ts +3 -3
  795. package/types/src/charts/viz/userClick.d.ts +8 -0
  796. package/types/src/charts/viz/vizFields.d.ts +7 -0
  797. package/types/src/charts/viz/vizTypes.d.ts +116 -2
  798. package/types/src/components/Axis/Axis.d.ts +35 -0
  799. package/types/src/components/Axis/axisDefaults.d.ts +2 -0
  800. package/types/src/components/Axis/axisLabelSize.d.ts +3 -3
  801. package/types/src/components/Axis/axisLabelThinning.d.ts +19 -1
  802. package/types/src/components/Axis/axisLayoutScale.d.ts +14 -2
  803. package/types/src/components/Axis/axisLevels.d.ts +137 -0
  804. package/types/src/components/Axis/axisMinorTicks.d.ts +83 -0
  805. package/types/src/components/Axis/axisPeriods.d.ts +45 -0
  806. package/types/src/components/Axis/axisRangeBreaks.d.ts +6 -2
  807. package/types/src/components/Axis/axisRounding.d.ts +15 -1
  808. package/types/src/components/Axis/axisScaleType.d.ts +32 -0
  809. package/types/src/components/Axis/axisScene.d.ts +15 -7
  810. package/types/src/components/Axis/axisTickLookups.d.ts +26 -0
  811. package/types/src/components/Axis/axisTooltipTargets.d.ts +16 -4
  812. package/types/src/components/Axis/labelSizeSession.d.ts +16 -0
  813. package/types/src/components/Axis/rangeBreaks.d.ts +6 -2
  814. package/types/src/components/Axis/timeValues.d.ts +48 -2
  815. package/types/src/components/ColorScale/colorScaleScale.d.ts +45 -0
  816. package/types/src/components/Tooltip.d.ts +11 -2
  817. package/types/src/components/tooltipDom.d.ts +24 -0
  818. package/types/src/fluent.d.ts +30 -1
  819. package/types/src/shapes/Bar.d.ts +7 -0
  820. package/types/src/shapes/Box.d.ts +15 -0
  821. package/types/src/shapes/Shape.d.ts +11 -0
  822. package/types/src/shapes/Tick.d.ts +20 -0
  823. package/types/src/shapes/boxExtraShapes.d.ts +40 -0
  824. package/types/src/shapes/boxExtras.d.ts +85 -0
  825. package/types/src/shapes/boxStyle.d.ts +25 -4
  826. package/types/src/shapes/downsample.d.ts +68 -0
  827. package/types/src/shapes/hitAreaNode.d.ts +2 -1
  828. package/types/src/shapes/index.d.ts +1 -0
  829. package/types/src/shapes/pathSeries.d.ts +35 -0
  830. package/types/src/shapes/shapeConfig.d.ts +70 -2
  831. package/types/src/utils/BaseClass.d.ts +18 -4
  832. package/types/src/utils/D3plusConfig.d.ts +991 -85
  833. package/types/src/utils/index.d.ts +1 -1
  834. package/types/src/utils/jitter.d.ts +23 -0
  835. package/types/src/utils/resetSetters.d.ts +23 -0
  836. package/umd/d3plus-core.full.js +98950 -68731
  837. package/umd/d3plus-core.full.min.js +2 -2
  838. package/umd/d3plus-core.js +77484 -48545
  839. package/umd/d3plus-core.min.js +2 -2
@@ -5,6 +5,7 @@
5
5
  to its node record.
6
6
  */ import { min } from "d3-array";
7
7
  import { zoomTransform } from "d3-zoom";
8
+ import { computeTimeFilter, timelessPass } from "../pipeline/preDrawData.js";
8
9
  import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
9
10
  /** A node record as a link end. */ export const graphLinkEnd = (n)=>({
10
11
  data: n.data,
@@ -17,20 +18,54 @@ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
17
18
  viz.schema.nodeGroupBy.length - 1
18
19
  ])](d, i)}`;
19
20
  }
21
+ /**
22
+ Whether a `nodes` or `links` row is in the period the timeline selects
23
+ (the chart's `timeFilter`, or the one it starts on): a row with no
24
+ `time` value is in every period. Undefined without `time`.
25
+ */ export function graphPeriod(v) {
26
+ if (!v.schema.time) return undefined;
27
+ const filter = v.schema.timeFilter || computeTimeFilter(v);
28
+ return filter ? timelessPass(v, filter) : undefined;
29
+ }
30
+ /** The `links` in the selected period (see `graphPeriod`), each with its index in `links`. */ function periodLinks(v) {
31
+ const links = v.schema.links.map((link, i)=>({
32
+ link,
33
+ i
34
+ }));
35
+ const period = graphPeriod(v);
36
+ return period ? links.filter(({ link, i })=>period(link, i)) : links;
37
+ }
38
+ /**
39
+ The ids of a small-multiple panel's own rows (see `facet`), or
40
+ undefined outside a panel: a panel draws only the nodes its rows stand
41
+ for, so `nodes` and `links` shared by every panel don't pull in the
42
+ other panels' nodes.
43
+ */ export function panelNodeIds(v) {
44
+ if (v._facetStep !== "panel") return undefined;
45
+ const data = v._filteredData ?? [];
46
+ return new Set(data.map((d, i)=>graphNodeId(v, d, i)));
47
+ }
20
48
  /**
21
49
  The chart's node rows: `nodes` when set, else one row per data row and
22
50
  one per link end no data row stands for (the link's own object, or
23
51
  `{id}` for an id), so a chart given only `data` and `links` still draws
24
- its nodes, linked or not.
52
+ its nodes, linked or not. A small-multiple panel keeps only the rows
53
+ its own data rows stand for (see `panelNodeIds`).
25
54
  */ export function graphNodeRows(v) {
26
55
  const nodes = v.schema.nodes;
27
- if (nodes.length) return nodes;
56
+ const period = graphPeriod(v);
57
+ const panel = panelNodeIds(v);
58
+ if (nodes.length) {
59
+ const rows = period ? nodes.filter(period) : nodes;
60
+ return panel ? rows.filter((d, i)=>panel.has(graphNodeId(v, d, i))) : rows;
61
+ }
28
62
  const data = v._filteredData;
29
63
  const rows = [
30
64
  ...data
31
65
  ];
66
+ if (panel) return rows;
32
67
  const ids = new Set(data.map((d, i)=>graphNodeId(v, d, i)));
33
- for (const l of v.schema.links)for (const end of [
68
+ for (const { link: l } of periodLinks(v))for (const end of [
34
69
  l.source,
35
70
  l.target
36
71
  ]){
@@ -87,7 +122,9 @@ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
87
122
  that matches no node is undefined. A link whose ends both resolve gets its
88
123
  datum, which `linkSize` receives (with the link's index). Stashes the id → node lookup on
89
124
  `v.ctx.nodeLookup` and the id → neighbor nodes lookup on
90
- `v.ctx.linkLookup` (a link from a node to itself adds no neighbor).
125
+ `v.ctx.linkLookup` (a link from a node to itself adds no neighbor). A
126
+ link outside the timeline's selected period (see `graphPeriod`) resolves
127
+ neither end.
91
128
  */ export function resolveGraphLinks(v, nodes) {
92
129
  const nodeLookup = nodes.reduce((obj, d)=>{
93
130
  obj[d.id] = d;
@@ -97,10 +134,12 @@ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
97
134
  const nodeByOriginal = new Map();
98
135
  for (const n of nodes)nodeByOriginal.set(n.node, n);
99
136
  const endpoint = (ref, referenceType)=>referenceType === "number" ? nodeByOriginal.get(v.schema.nodes[ref]) : referenceType === "string" ? nodeLookup[ref] : nodeLookup[ref.id];
137
+ const shown = new Set(periodLinks(v).map(({ i })=>i));
100
138
  const links = v.schema.links.map((l, i)=>{
101
139
  const referenceType = typeof l.source;
102
- const source = endpoint(l.source, referenceType);
103
- const target = endpoint(l.target, referenceType);
140
+ // A link outside the selected period resolves no ends.
141
+ const source = shown.has(i) ? endpoint(l.source, referenceType) : undefined;
142
+ const target = shown.has(i) ? endpoint(l.target, referenceType) : undefined;
104
143
  if (!source || !target) return {
105
144
  size: v.schema.linkSize(l, i),
106
145
  source,
@@ -28,6 +28,12 @@ import { polylineBox } from "../features/polyline.js";
28
28
  import { isSelfLoopMark, unionBox } from "../features/selfLoops.js";
29
29
  import { loaderFormatFields } from "../viz/loaderFormat.js";
30
30
  import { clusterFields, installClusters } from "./clusters.js";
31
+ import { runChartDraw } from "../pipeline/runChartDraw.js";
32
+ import { bindNodeDrag, unbindNodeDrag } from "../features/nodeDrag.js";
33
+ import { FORCE_LIVE_DEFAULT, networkLive, stopLive } from "./liveForce.js";
34
+ import { deferPinnedClicks, networkNodeDrag, nudgeNetworkNode, unpinNetworkNode } from "./networkDrag.js";
35
+ import { installNodeKeys } from "../features/nodeKeys.js";
36
+ /** The node keys' instructions, read after keyboard navigation's own. */ const NETWORK_KEY_INSTRUCTIONS = "Hold Shift and use the arrow keys to move the focused node, and Shift+Backspace to unpin it.";
31
37
  const getNodeId = graphNodeId;
32
38
  /** The laid-out links, from the last layout. */ const networkLinks = (viz)=>viz.ctx.networkCtx?.links ?? [];
33
39
  /**
@@ -50,6 +56,19 @@ const getNodeId = graphNodeId;
50
56
  yDomain[1] = Math.max(yDomain[1], y1);
51
57
  }
52
58
  }
59
+ /** The data, `nodes`, and `links` rows that have a `time` value. */ function networkTimeRows(viz) {
60
+ const time = viz.schema.time;
61
+ if (!time) return viz._data;
62
+ const rows = [
63
+ viz._data,
64
+ viz.schema.nodes,
65
+ viz.schema.links
66
+ ].flatMap((r)=>Array.isArray(r) ? r : []);
67
+ return rows.filter((d, i)=>{
68
+ const t = time(d, i);
69
+ return t !== undefined && t !== null && t !== "";
70
+ });
71
+ }
53
72
  /** Installs the `click.shape` handler that focuses/zooms a node + its links. */ function setupNetworkClickShape(viz, v) {
54
73
  viz.schema.on["click.shape"] = (d, i, x, event)=>{
55
74
  viz._tooltipClass.data([]).render();
@@ -244,6 +263,8 @@ export const networkDef = {
244
263
  sizeLegendScale: (viz, { width, height })=>networkSizeLegendScale(viz, width, height),
245
264
  emit: networkEmit,
246
265
  insetRegion: sceneInsetRegion,
266
+ // `nodes` and `links` rows with a `time` value join the data's periods.
267
+ timeRows: networkTimeRows,
247
268
  // Network mounts its own zoom surface (with a background hitArea whose
248
269
  // click handler closes over class state); `chartTransform` (default
249
270
  // margin-origin) is fine for the scene.
@@ -258,6 +279,25 @@ export const networkDef = {
258
279
  // Default x/y accessors for nodes (Network reads node coords directly).
259
280
  viz._x = accessor("x");
260
281
  viz._y = accessor("y");
282
+ // A frame of the live simulation, or a dragged node, re-lays the chart
283
+ // out at the nodes' new positions.
284
+ networkLive(viz).relayout = ()=>runChartDraw(viz, networkDef, applyNetworkLayout);
285
+ const drag = networkNodeDrag(viz);
286
+ deferPinnedClicks(viz);
287
+ const draggable = ()=>viz.schema.nodeDrag !== false && viz.schema.layout !== "circle" && !viz._facetPanels?.length;
288
+ installNodeKeys(viz, {
289
+ nodeAt: (key)=>drag.nodeAt({
290
+ key
291
+ }),
292
+ nudge: (id, by)=>nudgeNetworkNode(viz, id, by),
293
+ reset: (id)=>unpinNetworkNode(viz, id),
294
+ enabled: draggable,
295
+ messages: {
296
+ nudge: "{0} moved and pinned",
297
+ reset: "{0} unpinned"
298
+ },
299
+ instructions: NETWORK_KEY_INSTRUCTIONS
300
+ });
261
301
  // Wrap _draw to also call ensureZoomDom (Network needs a DOM zoom group).
262
302
  const supDraw = v._draw.bind(viz);
263
303
  v._draw = function(callback) {
@@ -269,8 +309,15 @@ export const networkDef = {
269
309
  height,
270
310
  duration: effectiveDuration(viz)
271
311
  });
312
+ bindNodeDrag(viz, drag, draggable);
272
313
  return result;
273
314
  };
315
+ const supDestroy = v.destroy.bind(viz);
316
+ v.destroy = function() {
317
+ stopLive(viz);
318
+ unbindNodeDrag(viz);
319
+ return supDestroy();
320
+ };
274
321
  },
275
322
  // Small-multiple panels as close to square as the grid allows.
276
323
  facet: {
@@ -279,6 +326,7 @@ export const networkDef = {
279
326
  // Nodes (and loops, which sit within reach of their node) are points for
280
327
  // `hoverDistance`; links keep exact hit-testing.
281
328
  pointMark: (_viz, node)=>isPointShape(node) || isSelfLoopMark(node),
329
+ selectMark: (_viz, node)=>isPointShape(node),
282
330
  ctx: {},
283
331
  fields: [
284
332
  /**
@@ -295,15 +343,55 @@ export const networkDef = {
295
343
  The arrowhead size in pixels, or an accessor function returning one
296
344
  per link. Defaults to three times the link's stroke width, at least 6
297
345
  and at most 12 pixels, but never under 1.5 times the stroke width so
298
- the head stays wider than its line. The line stops inside the head.
346
+ the head stays wider than its line. The line stops at the head's base.
299
347
  @type {number | function}
300
348
  */ {
301
349
  key: "arrowSize"
302
350
  },
303
351
  ...clusterFields(),
352
+ /**
353
+ Keeps the force simulation running after the chart draws, so the
354
+ layout settles in view and the other nodes react while one is
355
+ dragged, when the network has at most this many nodes. `true` runs
356
+ it live at any size, `false` never. Larger networks are laid out
357
+ before they draw. Nodes with an `x` and `y` in the data stay where
358
+ the data puts them, and a viewer who asks for reduced motion (see
359
+ `reducedMotion`) gets the laid-out network without the motion.
360
+ @type {number | boolean}
361
+ */ {
362
+ key: "forceLive",
363
+ default: FORCE_LIVE_DEFAULT
364
+ },
304
365
  ...linkStyleFields(),
305
366
  ...linkBundleFields(),
306
367
  ...loaderFormatFields("links", "nodes"),
368
+ /**
369
+ How the nodes are placed. `"force"` (the default) places them at
370
+ their `x` and `y`, or by a force simulation when any node has none.
371
+ `"circle"` spaces them evenly around a circle, ordered by cluster
372
+ (or top-level group) and then most connected first (see
373
+ `nodeSort`), with links bowing in toward the center and each label
374
+ turned outward along its node's spoke past the circle. A node's
375
+ loops point outward. With `linkBundle`, the bundled paths replace
376
+ the bowed ones.
377
+ @type {"force" | "circle"}
378
+ */ {
379
+ key: "layout",
380
+ default: "force"
381
+ },
382
+ /**
383
+ How far links bow in toward the center when `layout` is
384
+ `"circle"`, from `0` (straight lines) to `1` (each link curves
385
+ through the center's pull, as a chord diagram's do). It sets the
386
+ share of the way from the middle of a link's chord to the center
387
+ that its curve's control point sits. Defaults to `0.5`, which keeps
388
+ links between neighbors near the rim and lets long ones cross the
389
+ middle. Bundled links (`linkBundle`) ignore it.
390
+ @type {number}
391
+ */ {
392
+ key: "linkBow",
393
+ default: 0.5
394
+ },
307
395
  {
308
396
  key: "links",
309
397
  default: []
@@ -339,6 +427,15 @@ export const networkDef = {
339
427
  key: "noDataMessage",
340
428
  default: false
341
429
  },
430
+ /**
431
+ Lets the viewer drag the nodes (with the `"force"` layout). A dropped
432
+ node stays where it is dropped, and a double-click lets it go. While
433
+ the simulation runs live (see `forceLive`) the other nodes react to
434
+ the dragged one.
435
+ */ {
436
+ key: "nodeDrag",
437
+ default: true
438
+ },
342
439
  {
343
440
  key: "nodeGroupBy",
344
441
  default: [
@@ -346,6 +443,17 @@ export const networkDef = {
346
443
  ]
347
444
  },
348
445
  /**
446
+ The order of the nodes around the circle when `layout` is
447
+ `"circle"`: `"data"` (their order in `nodes`), `"label"`
448
+ (alphabetical), `"group"` (by cluster or top-level group, then by
449
+ label), `"degree"` (most connected first), or a comparator function
450
+ receiving two node rows. Defaults to each cluster (or top-level
451
+ group) together, largest first, its most connected nodes first.
452
+ @type {"data" | "label" | "group" | "degree" | function}
453
+ */ {
454
+ key: "nodeSort"
455
+ },
456
+ /**
349
457
  How many links a node's tooltip lists under its number of
350
458
  connections, strongest first: a number, or `false` for none. Defaults
351
459
  to 3 when the links differ in `linkSize`, and none otherwise.
@@ -365,7 +473,8 @@ export const networkDef = {
365
473
  },
366
474
  /**
367
475
  The maximum pixel radius used when sizing nodes. Defaults to half the
368
- distance between the two closest nodes.
476
+ distance between the two closest nodes, and, when Network lays the
477
+ nodes out itself, no more than a twelfth of the chart's smaller side.
369
478
  @type {number}
370
479
  */ {
371
480
  key: "sizeMax"
@@ -0,0 +1,312 @@
1
+ /**
2
+ Network's remembered layout and live force simulation.
3
+
4
+ A Network remembers where it drew each node. When the nodes or links
5
+ change (a new timeline period, say), the nodes it drew before keep their
6
+ places, new ones enter beside a linked neighbor (see `seedPositions`), and
7
+ a force simulation settles the change. Nodes dropped by a drag stay
8
+ pinned where they were dropped.
9
+
10
+ At or under `forceLive` nodes the simulation keeps running after the
11
+ chart paints, one tick per animation frame, re-laying out and repainting
12
+ the chart until it cools, so the layout visibly settles and reacts to a
13
+ dragged node. Larger networks (or reduced motion) settle a change at
14
+ once, before they paint.
15
+
16
+ @module
17
+ */ import { forceCollide, forceLink, forceManyBody, forceSimulation, forceX, forceY } from "d3-force";
18
+ import { motionReduced } from "../viz/reducedMotion.js";
19
+ import { fitDataPositions, graphKey, linkSpacing, rescalePositions, seedPositions } from "./livePositions.js";
20
+ /** The node count `forceLive` defaults to. */ export const FORCE_LIVE_DEFAULT = 200;
21
+ /** How fast a live simulation cools: about 150 ticks from its start to rest. */ const ALPHA_DECAY = 0.04;
22
+ /** The heat a live simulation starts with on its first draw. */ const START_ALPHA = 0.5;
23
+ /** The heat a change (new nodes or links) restarts the simulation with. */ const CHANGE_ALPHA = 0.3;
24
+ /** The heat a dragged node keeps the simulation at. */ const DRAG_ALPHA = 0.3;
25
+ /** How many ticks a large network settles a change in, before it paints. */ const QUICK_TICKS = 120;
26
+ /**
27
+ The share of the chart area kept clear around the nodes the data places
28
+ when only some have an `x`/`y`, so the simulated ones fit around them.
29
+ */ const DATA_INSET = 0.1;
30
+ /** The room kept between a node and the chart's edge, for its hover outline. */ const EDGE_PAD = 3;
31
+ /** The chart's remembered layout, created on first use. */ export function networkLive(viz) {
32
+ let state = viz.ctx.networkLive;
33
+ if (!state) viz.ctx.networkLive = state = {
34
+ positions: new Map(),
35
+ pinned: new Map()
36
+ };
37
+ return state;
38
+ }
39
+ /**
40
+ Whether a network of `count` nodes runs its simulation live: at most
41
+ `forceLive` nodes (`true` for any number, `false` for never), in a
42
+ browser, with motion allowed.
43
+ @param viz The chart.
44
+ @param count The number of nodes.
45
+ */ export function liveForceOn(viz, count) {
46
+ const setting = viz.schema.forceLive;
47
+ if (setting === false || !count) return false;
48
+ const cap = setting === true ? Infinity : typeof setting === "number" ? setting : FORCE_LIVE_DEFAULT;
49
+ return count <= cap && !viz._ssr && typeof requestAnimationFrame === "function" && typeof document !== "undefined" && !motionReduced(viz);
50
+ }
51
+ /**
52
+ A force simulation over `nodes` in the chart's pixel space, stopped (it
53
+ is ticked by hand): links pull to `spacing` apart (or just clear of both
54
+ nodes), nodes push each other off and don't overlap, and a weak pull
55
+ toward the middle keeps unlinked groups in view.
56
+ @param nodes The nodes, at their starting positions.
57
+ @param links The links, by node ids.
58
+ @param bounds The chart area.
59
+ @param spacing The distance linked nodes settle at.
60
+ */ export function networkSimulation(nodes, links, bounds, spacing) {
61
+ const reach = (n)=>Math.max(n.rx, n.ry);
62
+ return forceSimulation(nodes).stop().alphaDecay(ALPHA_DECAY).force("link", forceLink(links).id((d)=>d.id).distance((l)=>Math.max(spacing, reach(l.source) + reach(l.target) + 4))).force("charge", forceManyBody().strength(-spacing).distanceMax(spacing * 6)).force("collide", forceCollide((n)=>reach(n) + 2)).force("x", forceX(bounds.width / 2).strength(0.03)).force("y", forceY(bounds.height / 2).strength(0.03));
63
+ }
64
+ /**
65
+ Keeps every free node inside the chart area, `pad` pixels clear of its
66
+ edges (a node too big to fit sits in the middle). Fixed nodes stay put.
67
+ @param nodes The simulated nodes.
68
+ @param bounds The chart area.
69
+ @param pad The room kept at each edge.
70
+ */ export function containLive(nodes, bounds, pad = EDGE_PAD) {
71
+ const clamp = (v, half, size)=>{
72
+ const lo = half + pad;
73
+ const hi = size - half - pad;
74
+ return lo > hi ? size / 2 : Math.max(lo, Math.min(hi, v));
75
+ };
76
+ for (const n of nodes){
77
+ if (n.fx !== undefined && n.fx !== null) continue;
78
+ n.x = clamp(n.x ?? 0, n.rx, bounds.width);
79
+ n.y = clamp(n.y ?? 0, n.ry, bounds.height);
80
+ }
81
+ }
82
+ /** Builds the simulation for this draw's nodes, starting at `positions`. */ function buildSimulation(nodes, links, positions, fixed, bounds) {
83
+ const simNodes = nodes.map((n)=>{
84
+ const at = fixed.get(n.id) ?? positions.get(n.id);
85
+ const half = (size)=>(size ?? n.r * 2) / 2;
86
+ return {
87
+ id: n.id,
88
+ x: at.x,
89
+ y: at.y,
90
+ rx: half(n.width),
91
+ ry: half(n.height),
92
+ ...fixed.has(n.id) ? {
93
+ fx: at.x,
94
+ fy: at.y
95
+ } : {}
96
+ };
97
+ });
98
+ const ids = new Set(nodes.map((n)=>n.id));
99
+ const simLinks = links.flatMap((l)=>l.source && l.target && l.source !== l.target && ids.has(l.source.id) && ids.has(l.target.id) ? [
100
+ {
101
+ source: l.source.id,
102
+ target: l.target.id
103
+ }
104
+ ] : []);
105
+ // Spaced as the precomputed layout spaces linked nodes.
106
+ const spacing = linkSpacing(nodes, links);
107
+ const sim = networkSimulation(simNodes, simLinks, bounds, spacing);
108
+ containLive(simNodes, bounds);
109
+ return sim;
110
+ }
111
+ /** The pinned nodes still in the graph. */ function fixedPositions(state, nodes) {
112
+ const ids = new Set(nodes.map((n)=>n.id));
113
+ const fixed = new Map();
114
+ for (const [id, p] of state.pinned)if (ids.has(id)) fixed.set(id, p);
115
+ return fixed;
116
+ }
117
+ /** Moves the remembered positions (and the simulation) into a resized chart area. */ function resize(state, bounds) {
118
+ if (!state.bounds) return;
119
+ const from = state.bounds;
120
+ if (from.width === bounds.width && from.height === bounds.height) return;
121
+ state.positions = rescalePositions(state.positions, from, bounds);
122
+ state.pinned = rescalePositions(state.pinned, from, bounds);
123
+ }
124
+ /**
125
+ Places this draw's nodes (see the module notes), writing each node's
126
+ `x`/`y` (and `fx`/`fy`). The nodes arrive at their precomputed layout's
127
+ positions, fitted to the chart area. Returns whether any node ended up
128
+ elsewhere, so the caller leaves the positions as they are rather than
129
+ refitting them. Small multiples lay each panel out afresh instead.
130
+ @param viz The chart.
131
+ @param nodes The nodes, at their precomputed positions.
132
+ @param links The links.
133
+ @param bounds The chart area.
134
+ @param dataCoords The `x`/`y` the data gives each node that has one.
135
+ */ export function placeNetworkNodes(viz, nodes, links, bounds, dataCoords) {
136
+ if (viz._facetStep) return false;
137
+ const state = networkLive(viz);
138
+ resize(state, bounds);
139
+ state.bounds = bounds;
140
+ if (state.frameDraw && state.sim) {
141
+ applyPositions(nodes, state.positions);
142
+ return true;
143
+ }
144
+ const hot = state.sim && state.sim.alpha() >= state.sim.alphaMin();
145
+ const heat = state.sim?.alpha() ?? 0;
146
+ stopLiveLoop(viz);
147
+ state.sim = undefined;
148
+ const key = graphKey(nodes, links);
149
+ const first = state.key === undefined;
150
+ const changed = !first && key !== state.key;
151
+ state.key = key;
152
+ // A new graph's precomputed places (see `rememberPositions`).
153
+ if (first || changed) state.laid = new Map(nodes.map((n)=>[
154
+ n.id,
155
+ {
156
+ x: n.x ?? 0,
157
+ y: n.y ?? 0
158
+ }
159
+ ]));
160
+ // With every node placed by the data there is nothing to simulate.
161
+ const allData = dataCoords.size > 0 && dataCoords.size === nodes.length;
162
+ const live = liveForceOn(viz, nodes.length) && !allData;
163
+ const fixed = fixedPositions(state, nodes);
164
+ if (live && dataCoords.size) {
165
+ const pad = Math.max(Math.max(0, ...nodes.map((n)=>n.r)) + EDGE_PAD, Math.min(bounds.width, bounds.height) * DATA_INSET);
166
+ for (const [id, p] of fitDataPositions(dataCoords, bounds, pad))if (!fixed.has(id)) fixed.set(id, p);
167
+ }
168
+ // Once the layout differs from the precomputed one (a live simulation, a
169
+ // dropped node, or a change it settled), the nodes start where they were.
170
+ const custom = live || fixed.size > 0 || changed || !!state.custom && !first;
171
+ const seeded = seedPositions(nodes, links, custom && !first ? state.positions : new Map()).positions;
172
+ for (const [id, p] of fixed)seeded.set(id, p);
173
+ if (live) {
174
+ const sim = buildSimulation(nodes, links, seeded, fixed, bounds);
175
+ const alpha = first ? START_ALPHA : changed ? CHANGE_ALPHA : hot ? heat : 0;
176
+ sim.alpha(alpha);
177
+ state.sim = sim;
178
+ for (const n of sim.nodes())seeded.set(n.id, {
179
+ x: n.x,
180
+ y: n.y
181
+ });
182
+ if (alpha >= sim.alphaMin()) scheduleFrame(viz);
183
+ } else if (changed && nodes.some((n)=>state.positions.has(n.id))) {
184
+ // A large network settles the change before it paints.
185
+ const sim = buildSimulation(nodes, links, seeded, fixed, bounds);
186
+ sim.alpha(CHANGE_ALPHA);
187
+ for(let i = 0; i < QUICK_TICKS; i++)sim.tick();
188
+ containLive(sim.nodes(), bounds);
189
+ for (const n of sim.nodes())seeded.set(n.id, {
190
+ x: n.x,
191
+ y: n.y
192
+ });
193
+ }
194
+ state.custom = custom;
195
+ if (!custom) return false;
196
+ applyPositions(nodes, seeded);
197
+ return true;
198
+ }
199
+ /** Writes each node's position. */ function applyPositions(nodes, positions) {
200
+ for (const n of nodes){
201
+ const p = positions.get(n.id);
202
+ if (!p) continue;
203
+ n.x = n.fx = p.x;
204
+ n.y = n.fy = p.y;
205
+ }
206
+ }
207
+ /**
208
+ Remembers where each node was drawn, and — while the layout is the
209
+ precomputed one — where each node's laid-out place is.
210
+ */ export function rememberPositions(viz, nodes) {
211
+ if (viz._facetStep) return;
212
+ const state = networkLive(viz);
213
+ state.positions = new Map(nodes.map((n)=>[
214
+ n.id,
215
+ {
216
+ x: n.x ?? 0,
217
+ y: n.y ?? 0
218
+ }
219
+ ]));
220
+ // Drawn as laid out (kept inside the chart): where an unpinned node returns.
221
+ if (!state.custom) state.laid = new Map(state.positions);
222
+ }
223
+ /** Asks for the next frame of the live loop. */ export function scheduleFrame(viz) {
224
+ const state = networkLive(viz);
225
+ if (state.frame !== undefined || typeof requestAnimationFrame !== "function") return;
226
+ state.frame = requestAnimationFrame(()=>liveFrame(viz));
227
+ }
228
+ /**
229
+ Asks for the chart to be re-laid out at the remembered positions on the
230
+ next frame: the next tick of the live loop, or a plain repaint.
231
+ */ export function scheduleRedraw(viz) {
232
+ const state = networkLive(viz);
233
+ if (state.sim) {
234
+ scheduleFrame(viz);
235
+ return;
236
+ }
237
+ if (state.frame !== undefined) return;
238
+ if (typeof requestAnimationFrame !== "function") {
239
+ redrawPositions(viz);
240
+ return;
241
+ }
242
+ state.frame = requestAnimationFrame(()=>{
243
+ state.frame = undefined;
244
+ redrawPositions(viz);
245
+ });
246
+ }
247
+ /** Cancels the live loop's pending frame. */ export function stopLiveLoop(viz) {
248
+ const state = viz.ctx.networkLive;
249
+ if (state?.frame === undefined) return;
250
+ if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(state.frame);
251
+ state.frame = undefined;
252
+ }
253
+ /** Stops the live simulation and its loop (chart teardown). */ export function stopLive(viz) {
254
+ stopLiveLoop(viz);
255
+ const state = viz.ctx.networkLive;
256
+ if (!state) return;
257
+ state.sim = undefined;
258
+ clearTimeout(state.clickTimer);
259
+ }
260
+ /** Re-lays the chart out at the remembered positions and repaints it at once. */ export function redrawPositions(viz) {
261
+ const state = networkLive(viz);
262
+ if (!state.relayout || !viz._sceneRenderer) return;
263
+ state.frameDraw = true;
264
+ try {
265
+ state.relayout();
266
+ } finally{
267
+ state.frameDraw = false;
268
+ }
269
+ viz._drawSceneToTarget(0);
270
+ }
271
+ /**
272
+ One frame of the live loop: a tick of the simulation, then the chart
273
+ re-laid out and repainted at the new positions. It waits out an animated
274
+ transition (so it doesn't cut one short) and stops once the simulation
275
+ cools, unless a node is being dragged, or when the chart has no scene.
276
+ */ function liveFrame(viz) {
277
+ const state = networkLive(viz);
278
+ state.frame = undefined;
279
+ const sim = state.sim;
280
+ if (!sim || !viz._sceneRenderer || !state.bounds) return;
281
+ if (viz._transitionEndsAt && Date.now() < viz._transitionEndsAt) {
282
+ scheduleFrame(viz);
283
+ return;
284
+ }
285
+ sim.tick();
286
+ containLive(sim.nodes(), state.bounds);
287
+ for (const n of sim.nodes())state.positions.set(n.id, {
288
+ x: n.x ?? 0,
289
+ y: n.y ?? 0
290
+ });
291
+ redrawPositions(viz);
292
+ if (state.dragging !== undefined || sim.alpha() >= sim.alphaMin()) scheduleFrame(viz);
293
+ }
294
+ /** Heats the live simulation for a drag, or cools it again after. */ export function dragHeat(viz, dragging) {
295
+ const sim = networkLive(viz).sim;
296
+ if (!sim) return;
297
+ sim.alphaTarget(dragging ? DRAG_ALPHA : 0);
298
+ if (dragging) sim.alpha(Math.max(sim.alpha(), DRAG_ALPHA));
299
+ scheduleFrame(viz);
300
+ }
301
+ /**
302
+ Re-heats the live simulation (after a node is let go), or — without
303
+ one — repaints the chart at the remembered positions.
304
+ */ export function reheat(viz) {
305
+ const sim = networkLive(viz).sim;
306
+ if (!sim) {
307
+ redrawPositions(viz);
308
+ return;
309
+ }
310
+ sim.alpha(Math.max(sim.alpha(), CHANGE_ALPHA));
311
+ scheduleFrame(viz);
312
+ }