@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
@@ -0,0 +1,178 @@
1
+ /**
2
+ Venn — sets drawn as overlapping circles, one region per row: a set's
3
+ circle, or the area where its sets overlap.
4
+
5
+ Implementation files in this folder:
6
+ - `circles.ts` — circle geometry: shared areas and their outlines.
7
+ - `nelderMead.ts` — the minimizer the layout and label spots use.
8
+ - `vennLayout.ts` — the area-proportional and classic layouts.
9
+ - `vennFit.ts` — orientation, packing apart sets that don't overlap,
10
+ and fitting the circles to the chart area.
11
+ - `vennEllipses.ts` — the classic four- and five-set ellipses, drawn
12
+ as polygons, their intersections and label spots.
13
+ - `vennRegions.ts` — label spots and exclusive counts.
14
+ - `vennData.ts` — reading rows, hidden sets, and blended region colors.
15
+ - `applyLayout.ts` — chart-specific `TransformStage`.
16
+ - `emit.ts` — region paths and their labels.
17
+ */ import { formatAbbreviate } from "@d3plus/format";
18
+ import accessor from "../../utils/accessor.js";
19
+ import constant from "../../utils/constant.js";
20
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
21
+ import { makeChart } from "../definition/makeChart.js";
22
+ import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
23
+ import { chartBackground } from "../viz/backgroundInk.js";
24
+ import { shapeHoverEnabled } from "../viz/shapeHover.js";
25
+ import { applyVennLayout } from "./applyLayout.js";
26
+ import { vennEmit } from "./emit.js";
27
+ import { SET_SEPARATOR, blendedFill, coversSets, mergeSets, rowSets, vennRows } from "./vennData.js";
28
+ import { vennTooltipRows } from "./tooltip.js";
29
+ /** A string key reads that field; a function is used as is. */ const optionalField = (v)=>typeof v === "function" ? v : fieldAccessor(v);
30
+ /**
31
+ The `sets` accessor: a function as is, or a key read as a field, with
32
+ the key kept so rows merge their sets under it as lists (see
33
+ `mergeSets`).
34
+ */ const setsAccessor = (v)=>typeof v === "function" ? v : Object.assign(fieldAccessor(v), {
35
+ setsKey: v
36
+ });
37
+ /**
38
+ Hovering a region (or a set in the legend) highlights it with every
39
+ region inside it: a set's circle with all of its overlaps, an overlap
40
+ with the smaller overlaps within it.
41
+ */ function installVennHover(viz) {
42
+ const base = viz.schema.on.mouseenter;
43
+ viz.schema.on.mouseenter = function(d, i) {
44
+ const sets = rowSets(viz, d, i);
45
+ if (!sets.length || viz._hoverBucket || !shapeHoverEnabled(viz)) return base.call(viz, d, i);
46
+ viz._hoverBucket = false;
47
+ viz.hover((h, x)=>coversSets(rowSets(viz, h, x), sets));
48
+ };
49
+ }
50
+ export const vennDef = {
51
+ name: "Venn",
52
+ layoutStage: applyVennLayout,
53
+ emit: vennEmit,
54
+ insetRegion: sceneInsetRegion,
55
+ thresholdFunction: (viz, data, all)=>vennRows(viz, data, all),
56
+ setup: (viz)=>{
57
+ const fill = viz.schema.shapeConfig.fill;
58
+ viz.schema.shapeConfig.fill = blendedFill(viz, fill);
59
+ installVennHover(viz);
60
+ },
61
+ facet: {
62
+ aspect: 1
63
+ },
64
+ ctx: {},
65
+ fields: [
66
+ {
67
+ key: "groupBy",
68
+ factory: (viz)=>[
69
+ (d, i)=>{
70
+ const sets = rowSets(viz, d, i);
71
+ return sets.length === 1 ? sets[0] : sets.join(SET_SEPARATOR);
72
+ }
73
+ ]
74
+ },
75
+ {
76
+ key: "label",
77
+ coerce: "const",
78
+ factory: (viz)=>(d, i)=>rowSets(viz, d, i).join(SET_SEPARATOR)
79
+ },
80
+ /**
81
+ What the count in each region's label means: `"exclusive"` counts
82
+ the items in that region and none of the smaller regions drawn
83
+ inside it (so the counts across the diagram add up to the whole),
84
+ `"inclusive"` shows each row's own size, every item in all of its
85
+ sets. Tooltips show both.
86
+ @type {"exclusive" | "inclusive"}
87
+ */ {
88
+ key: "labelCounts",
89
+ default: "exclusive"
90
+ },
91
+ {
92
+ key: "legendSort",
93
+ default: ()=>0
94
+ },
95
+ /**
96
+ When `true`, each set is a circle whose area matches its size and
97
+ each overlap's area matches its row's size, as closely as circles
98
+ allow (exact for two sets, close for three, approximate beyond).
99
+ Sets that share nothing are drawn apart, and a set inside another
100
+ inside its circle. When `false`, the sets take the textbook
101
+ arrangement, whatever their sizes, in which every combination of
102
+ sets has a region: equal circles side by side for two sets or in a
103
+ triangle for three, Venn's four ellipses, Grünbaum's five
104
+ symmetric ellipses, and a ring of equal circles for six or more
105
+ (where not every combination can appear).
106
+ */ {
107
+ key: "proportional",
108
+ default: true
109
+ },
110
+ /**
111
+ The accessor function or key for the sets each row stands for: an
112
+ array of set names (`["A", "B"]` for where A and B overlap) or a
113
+ single name for a set on its own.
114
+ @type {string | function}
115
+ */ {
116
+ key: "sets",
117
+ default: "sets",
118
+ coerce: setsAccessor,
119
+ onSet: (viz, value)=>{
120
+ const key = value.setsKey;
121
+ if (key) viz.schema.aggs[key] = mergeSets;
122
+ }
123
+ },
124
+ /**
125
+ The accessor function or key for each row's size: the count of
126
+ items in every one of its sets (a set's whole size for a single
127
+ set, the size of the overlap for several).
128
+ @type {string | function}
129
+ */ {
130
+ key: "value",
131
+ default: accessor("size"),
132
+ coerce: optionalField
133
+ },
134
+ /**
135
+ Formats each size shown in labels and tooltips, as
136
+ `(value, datum) => string`. Defaults to the locale's abbreviated
137
+ number format.
138
+ */ {
139
+ key: "valueFormat",
140
+ factory: (viz)=>(n)=>formatAbbreviate(n, viz.schema.locale)
141
+ },
142
+ /** Zooming and panning don't help read a Venn diagram, so they're off by default. */ {
143
+ key: "zoom",
144
+ default: false
145
+ },
146
+ {
147
+ key: "shape",
148
+ default: constant("Path"),
149
+ coerce: "const"
150
+ },
151
+ {
152
+ key: "shapeConfig",
153
+ merge: true,
154
+ factory: (viz)=>({
155
+ // A line in the chart's background color between regions, so
156
+ // every region reads as its own shape.
157
+ stroke: ()=>chartBackground(viz),
158
+ strokeWidth: 2
159
+ })
160
+ },
161
+ {
162
+ key: "tooltipConfig",
163
+ merge: true,
164
+ factory: (viz)=>({
165
+ tbody: (d, i)=>vennTooltipRows(viz, d, i)
166
+ })
167
+ }
168
+ ]
169
+ };
170
+ /**
171
+ Creates a Venn diagram from an array of rows, each naming one or more
172
+ sets (`sets`) and a size (`value`): a row with one set is that set's
173
+ circle, a row with several is the area where those sets overlap. By
174
+ default circles and overlaps are sized to their values (an Euler
175
+ diagram when sets don't overlap); `proportional: false` draws the
176
+ classic equal circles. Each region is labeled with its count, and
177
+ hovering one shows its exact intersection.
178
+ */ export default makeChart(vennDef);
@@ -0,0 +1,59 @@
1
+ /**
2
+ A Nelder–Mead simplex minimizer, for the Venn layout's loss and its
3
+ label placement. Deterministic: the same start always finds the same
4
+ minimum.
5
+ */ /** Options for {@link nelderMead}. */ /** `a * p + b * q`, coordinate by coordinate. */ function mix(a, p, b, q) {
6
+ return p.map((v, k)=>a * v + b * q[k]);
7
+ }
8
+ /**
9
+ Finds a local minimum of `f` near `x0` by the Nelder–Mead method:
10
+ reflecting, expanding, contracting and shrinking a simplex of
11
+ `x0.length + 1` points until it settles.
12
+ @param f The function to minimize.
13
+ @param x0 The starting point.
14
+ @param options Step and tolerance limits.
15
+ */ export function nelderMead(f, x0, options = {}) {
16
+ const n = x0.length;
17
+ if (!n) return {
18
+ x: [],
19
+ fx: f([])
20
+ };
21
+ const maxIterations = options.maxIterations ?? n * 200;
22
+ const minErrorDelta = options.minErrorDelta ?? 1e-6;
23
+ const minTolerance = options.minTolerance ?? 1e-5;
24
+ const vertex = (x)=>({
25
+ x,
26
+ fx: f(x)
27
+ });
28
+ const simplex = [
29
+ vertex(x0.slice())
30
+ ];
31
+ for(let i = 0; i < n; i++){
32
+ const point = x0.slice();
33
+ point[i] = point[i] ? point[i] * 1.05 : 0.001;
34
+ simplex.push(vertex(point));
35
+ }
36
+ for(let iteration = 0; iteration < maxIterations; iteration++){
37
+ simplex.sort((a, b)=>a.fx - b.fx);
38
+ let spread = 0;
39
+ for(let k = 0; k < n; k++)spread = Math.max(spread, Math.abs(simplex[0].x[k] - simplex[1].x[k]));
40
+ if (Math.abs(simplex[0].fx - simplex[n].fx) < minErrorDelta && spread < minTolerance) break;
41
+ const centroid = new Array(n).fill(0);
42
+ for(let i = 0; i < n; i++)for(let k = 0; k < n; k++)centroid[k] += simplex[i].x[k] / n;
43
+ const worst = simplex[n];
44
+ const reflected = vertex(mix(2, centroid, -1, worst.x));
45
+ if (reflected.fx < simplex[0].fx) {
46
+ const expanded = vertex(mix(3, centroid, -2, worst.x));
47
+ simplex[n] = expanded.fx < reflected.fx ? expanded : reflected;
48
+ } else if (reflected.fx >= simplex[n - 1].fx) {
49
+ const contracted = reflected.fx > worst.fx ? vertex(mix(0.5, centroid, 0.5, worst.x)) : vertex(mix(1.5, centroid, -0.5, worst.x));
50
+ if (contracted.fx < Math.min(reflected.fx, worst.fx)) simplex[n] = contracted;
51
+ else for(let i = 1; i <= n; i++)simplex[i] = vertex(mix(0.5, simplex[0].x, 0.5, simplex[i].x));
52
+ } else simplex[n] = reflected;
53
+ }
54
+ simplex.sort((a, b)=>a.fx - b.fx);
55
+ return {
56
+ x: simplex[0].x,
57
+ fx: simplex[0].fx
58
+ };
59
+ }
@@ -0,0 +1,22 @@
1
+ /**
2
+ Venn's tooltip rows: a region's size (every item in all of its sets),
3
+ then, when smaller regions lie inside it, the count in it alone.
4
+ */ import { exclusiveCounts } from "./applyLayout.js";
5
+ import { rowSize, sourceRow } from "./vennData.js";
6
+ /** The tooltip rows for a region's row. */ export function vennTooltipRows(viz, d, i) {
7
+ if (!d) return [];
8
+ const row = sourceRow(d);
9
+ const format = viz.schema.valueFormat;
10
+ const size = rowSize(viz, row, i);
11
+ const rows = [];
12
+ if (Number.isFinite(size)) rows.push([
13
+ viz.schema.translate("Value"),
14
+ `${format(size, row)}`
15
+ ]);
16
+ const only = exclusiveCounts(viz).get(row);
17
+ if (only !== undefined && Number.isFinite(only) && only !== size) rows.push([
18
+ viz.schema.translate("Only in This Region"),
19
+ `${format(only, row)}`
20
+ ]);
21
+ return rows;
22
+ }
@@ -0,0 +1,99 @@
1
+ /**
2
+ Reading Venn rows: the sets a row names, its size, the row that stands
3
+ for one set, and the colors of regions where sets overlap.
4
+ */ import { lab } from "d3-color";
5
+ import { colorAssign } from "@d3plus/color";
6
+ import { linkedColorDefaults } from "../viz/linkGroup.js";
7
+ /** What joins set names in a region's default label ("A ∩ B"). */ export const SET_SEPARATOR = " \u2229 ";
8
+ /**
9
+ A row's set names as a list: an array of names as given, a lone name
10
+ as a list of one, and anything else as no sets. Merged rows hold a lone
11
+ set as a plain value, so both forms read the same.
12
+ */ export function setList(value) {
13
+ const list = Array.isArray(value) ? value : value == null ? [] : [
14
+ value
15
+ ];
16
+ return [
17
+ ...new Set(list.filter((v)=>typeof v === "string" || typeof v === "number").map((v)=>`${v}`))
18
+ ];
19
+ }
20
+ /**
21
+ Merges rows' sets into one list of every set they name, so a merged
22
+ row of one set still holds a list (`["A"]`), not a lone name.
23
+ */ export function mergeSets(rows, accessor) {
24
+ return setList(rows.flatMap((d)=>setList(accessor(d))));
25
+ }
26
+ /** Unwraps a scene datum (a label's or a merged row's wrapper) to its source row. */ export function sourceRow(d) {
27
+ let row = d;
28
+ while(row && row.__d3plus__ && row.data)row = row.data;
29
+ return row;
30
+ }
31
+ /** The set names a row stands for, through the chart's `sets` accessor. */ export function rowSets(viz, d, i) {
32
+ const sets = viz.schema.sets;
33
+ if (!d || typeof sets !== "function") return [];
34
+ return setList(sets(sourceRow(d), i));
35
+ }
36
+ /** A row's size, through the chart's `value` accessor (NaN when it has none). */ export function rowSize(viz, d, i) {
37
+ const value = viz.schema.value;
38
+ const v = typeof value === "function" ? value(d, i) : undefined;
39
+ return v == null || v === "" ? NaN : Number(v);
40
+ }
41
+ /** Whether `outer` names every set in `inner`. */ export function coversSets(outer, inner) {
42
+ return inner.length > 0 && inner.every((s)=>outer.includes(s));
43
+ }
44
+ /** The drawn row that stands for the set `name` alone, if any. */ export function setRow(viz, name) {
45
+ const rows = viz._filteredData ?? [];
46
+ for(let i = 0; i < rows.length; i++){
47
+ const sets = rowSets(viz, rows[i], i);
48
+ if (sets.length === 1 && sets[0] === name) return {
49
+ row: rows[i],
50
+ i
51
+ };
52
+ }
53
+ return undefined;
54
+ }
55
+ /**
56
+ The color where `colors` overlap: their average in CIELAB, so the mix
57
+ sits between them the way the eye blends them. Colors that don't parse
58
+ are left out; with none left, undefined.
59
+ */ export function blendColors(colors) {
60
+ const parsed = colors.filter((c)=>typeof c === "string").map((c)=>lab(c)).filter((c)=>Number.isFinite(c.l));
61
+ if (!parsed.length) return undefined;
62
+ const mean = (k)=>parsed.reduce((s, c)=>s + (Number.isFinite(c[k]) ? c[k] : 0), 0) / parsed.length;
63
+ return lab(mean("l"), mean("a"), mean("b")).formatHex();
64
+ }
65
+ /**
66
+ Wraps a fill accessor so a region where sets overlap takes the blend of
67
+ those sets' fills (each read from the row that stands for the set
68
+ alone, or the color the set's name is assigned when it has no row of
69
+ its own). A region of one set, and any fill a colorScale gives, are
70
+ left as `fill` has them.
71
+ */ export function blendedFill(viz, fill) {
72
+ return (d, i)=>{
73
+ const sets = rowSets(viz, d, i);
74
+ if (sets.length < 2 || viz.schema.colorScale) return fill(d, i);
75
+ return blendColors(sets.map((name)=>{
76
+ const found = setRow(viz, name);
77
+ return found ? fill(found.row, found.i) : colorAssign(name, linkedColorDefaults(viz));
78
+ }));
79
+ };
80
+ }
81
+ /**
82
+ The rows a Venn draws, or (given the same list twice) the rows its
83
+ legend lists. The legend lists each set on its own. A drawn region
84
+ leaves out every set the legend hides, and when the legend shows only
85
+ some sets, the regions within them: their circles and the overlaps
86
+ among them. With small multiples, whose `all` spans every panel, a
87
+ panel keeps to its own rows, so it leaves out the overlaps among the
88
+ shown sets.
89
+ */ export function vennRows(viz, data, all) {
90
+ if (all && data === all) return data.filter((d, i)=>rowSets(viz, d, i).length === 1);
91
+ const hidden = (viz._hidden ?? []).map(String);
92
+ const solo = (viz._solo ?? []).map(String);
93
+ const source = solo.length && all && !viz.schema.facet ? all : data;
94
+ return source.filter((d, i)=>{
95
+ const sets = rowSets(viz, d, i);
96
+ if (sets.some((s)=>hidden.includes(s))) return false;
97
+ return !solo.length || sets.every((s)=>solo.includes(s));
98
+ });
99
+ }
@@ -0,0 +1,291 @@
1
+ /**
2
+ The classic ellipse diagrams that show every combination of four or
3
+ five sets: Venn's four ellipses and Grünbaum's five rotationally
4
+ symmetric ellipses. Each ellipse is drawn as a fine polygon, so the
5
+ area its sets share is an intersection of convex polygons (clipped one
6
+ against the next), and a region's label goes at the point deepest
7
+ inside the part of it no other ellipse covers.
8
+ */ import { polygonArea, polygonContains } from "d3-polygon";
9
+ import { nelderMead } from "./nelderMead.js";
10
+ /** How many sides each ellipse's polygon has. */ export const ELLIPSE_SEGMENTS = 240;
11
+ const DEGREE = Math.PI / 180;
12
+ /**
13
+ Venn's four ellipses, left to right: two tilted one way, two the other,
14
+ the middle two sharing a center, so all fifteen combinations appear,
15
+ each as one piece. The offsets, shape and tilt are the ones that give
16
+ the smallest region the most room.
17
+ */ export const FOUR_ELLIPSES = [
18
+ {
19
+ x: -0.3,
20
+ y: 0.3,
21
+ rx: 1,
22
+ ry: 0.65,
23
+ rotation: 50 * DEGREE
24
+ },
25
+ {
26
+ x: 0,
27
+ y: 0,
28
+ rx: 1,
29
+ ry: 0.65,
30
+ rotation: 50 * DEGREE
31
+ },
32
+ {
33
+ x: 0,
34
+ y: 0,
35
+ rx: 1,
36
+ ry: 0.65,
37
+ rotation: -50 * DEGREE
38
+ },
39
+ {
40
+ x: 0.3,
41
+ y: 0.3,
42
+ rx: 1,
43
+ ry: 0.65,
44
+ rotation: -50 * DEGREE
45
+ }
46
+ ];
47
+ /**
48
+ Grünbaum's five congruent ellipses, each turned a fifth of a circle
49
+ from the last around a common center (the first above it), so all
50
+ thirty-one combinations appear. The offset, shape and twist are the
51
+ ones that give the smallest region the most room.
52
+ */ export const FIVE_ELLIPSES = Array.from({
53
+ length: 5
54
+ }, (_, k)=>{
55
+ const angle = -Math.PI / 2 + k * 2 * Math.PI / 5;
56
+ return {
57
+ x: 0.15 * Math.cos(angle),
58
+ y: 0.15 * Math.sin(angle),
59
+ rx: 1,
60
+ ry: 0.7,
61
+ rotation: angle + 30 * DEGREE
62
+ };
63
+ });
64
+ /**
65
+ The classic ellipses for `names`, keyed by name in order: four or five
66
+ sets, and undefined for any other count.
67
+ */ export function classicEllipses(names) {
68
+ const base = names.length === 4 ? FOUR_ELLIPSES : names.length === 5 ? FIVE_ELLIPSES : undefined;
69
+ if (!base) return undefined;
70
+ return Object.fromEntries(names.map((s, k)=>[
71
+ s,
72
+ {
73
+ ...base[k]
74
+ }
75
+ ]));
76
+ }
77
+ /** An ellipse's outline as a polygon of `segments` points. */ export function ellipsePolygon(e, segments = ELLIPSE_SEGMENTS) {
78
+ const cos = Math.cos(e.rotation);
79
+ const sin = Math.sin(e.rotation);
80
+ return Array.from({
81
+ length: segments
82
+ }, (_, k)=>{
83
+ const t = k / segments * 2 * Math.PI;
84
+ const u = e.rx * Math.cos(t);
85
+ const v = e.ry * Math.sin(t);
86
+ return [
87
+ e.x + u * cos - v * sin,
88
+ e.y + u * sin + v * cos
89
+ ];
90
+ });
91
+ }
92
+ /**
93
+ The polygon with its points in the order whose interior lies to the
94
+ left of each edge by the cross product (`polygonArea`, which counts
95
+ the other way round, is then negative).
96
+ */ function positive(p) {
97
+ return polygonArea(p) > 0 ? p.slice().reverse() : p;
98
+ }
99
+ /** Where segment `a`–`b` crosses the line through `c`–`d`. */ function crossing(a, b, c, d) {
100
+ const r = [
101
+ b[0] - a[0],
102
+ b[1] - a[1]
103
+ ];
104
+ const s = [
105
+ d[0] - c[0],
106
+ d[1] - c[1]
107
+ ];
108
+ const den = r[0] * s[1] - r[1] * s[0];
109
+ const t = den ? ((c[0] - a[0]) * s[1] - (c[1] - a[1]) * s[0]) / den : 0;
110
+ return [
111
+ a[0] + t * r[0],
112
+ a[1] + t * r[1]
113
+ ];
114
+ }
115
+ /**
116
+ The part of `subject` inside the convex polygon `clip`
117
+ (Sutherland–Hodgman), or an empty list when they don't overlap.
118
+ */ export function clipConvex(subject, clip) {
119
+ const edges = positive(clip);
120
+ let out = subject.slice();
121
+ const side = (c, d, p)=>(d[0] - c[0]) * (p[1] - c[1]) - (d[1] - c[1]) * (p[0] - c[0]);
122
+ for(let i = 0; i < edges.length && out.length; i++){
123
+ const c = edges[i];
124
+ const d = edges[(i + 1) % edges.length];
125
+ const input = out;
126
+ out = [];
127
+ for(let j = 0; j < input.length; j++){
128
+ const p = input[j];
129
+ const q = input[(j + 1) % input.length];
130
+ const pIn = side(c, d, p) >= 0;
131
+ const qIn = side(c, d, q) >= 0;
132
+ if (pIn) out.push(p);
133
+ if (pIn !== qIn) out.push(crossing(p, q, c, d));
134
+ }
135
+ }
136
+ return out.length >= 3 ? out : [];
137
+ }
138
+ /** The area every polygon shares (each convex), as a polygon; empty when they share none. */ export function polygonIntersection(polygons) {
139
+ if (!polygons.length) return [];
140
+ let shared = positive(polygons[0]);
141
+ for (const p of polygons.slice(1)){
142
+ shared = clipConvex(shared, p);
143
+ if (!shared.length) return [];
144
+ }
145
+ return Math.abs(polygonArea(shared)) > 1e-9 ? shared : [];
146
+ }
147
+ /** The distance from `p` to the nearest edge of `polygon`. */ export function edgeDistance(p, polygon) {
148
+ let best = Infinity;
149
+ for(let i = 0; i < polygon.length; i++){
150
+ const a = polygon[i];
151
+ const b = polygon[(i + 1) % polygon.length];
152
+ const dx = b[0] - a[0];
153
+ const dy = b[1] - a[1];
154
+ const len = dx * dx + dy * dy;
155
+ const t = len ? Math.max(0, Math.min(1, ((p[0] - a[0]) * dx + (p[1] - a[1]) * dy) / len)) : 0;
156
+ best = Math.min(best, Math.hypot(p[0] - a[0] - t * dx, p[1] - a[1] - t * dy));
157
+ }
158
+ return best;
159
+ }
160
+ /**
161
+ How far `p` is from the nearest edge of the region inside every
162
+ `inside` polygon and outside every `outside` polygon: positive inside
163
+ the region, negative outside it.
164
+ */ export function polygonMargin(p, inside, outside) {
165
+ let margin = Infinity;
166
+ for (const poly of inside){
167
+ const d = edgeDistance(p, poly);
168
+ margin = Math.min(margin, polygonContains(poly, p) ? d : -d);
169
+ }
170
+ for (const poly of outside){
171
+ const d = edgeDistance(p, poly);
172
+ margin = Math.min(margin, polygonContains(poly, p) ? -d : d);
173
+ }
174
+ return margin;
175
+ }
176
+ /**
177
+ The point deepest inside the region within every `inside` polygon and
178
+ outside every `outside` one, with its margin: the best of a grid over
179
+ the polygons' shared area, then refined. When that region is empty,
180
+ the deepest point of the shared area instead, with a margin of 0.
181
+ */ export function polygonLabelSpot(inside, outside) {
182
+ const shared = polygonIntersection(inside);
183
+ if (!shared.length) return {
184
+ x: 0,
185
+ y: 0,
186
+ margin: 0
187
+ };
188
+ const xs = shared.map((p)=>p[0]);
189
+ const ys = shared.map((p)=>p[1]);
190
+ const [x0, x1] = [
191
+ Math.min(...xs),
192
+ Math.max(...xs)
193
+ ];
194
+ const [y0, y1] = [
195
+ Math.min(...ys),
196
+ Math.max(...ys)
197
+ ];
198
+ const steps = 16;
199
+ let start = [
200
+ (x0 + x1) / 2,
201
+ (y0 + y1) / 2
202
+ ];
203
+ let best = -Infinity;
204
+ for(let i = 0; i <= steps; i++)for(let j = 0; j <= steps; j++){
205
+ const p = [
206
+ x0 + (x1 - x0) * i / steps,
207
+ y0 + (y1 - y0) * j / steps
208
+ ];
209
+ const m = polygonMargin(p, inside, outside);
210
+ if (m > best) {
211
+ best = m;
212
+ start = p;
213
+ }
214
+ }
215
+ const { x } = nelderMead((p)=>-polygonMargin([
216
+ p[0],
217
+ p[1]
218
+ ], inside, outside), start, {
219
+ maxIterations: 300,
220
+ minErrorDelta: 1e-10
221
+ });
222
+ const margin = polygonMargin([
223
+ x[0],
224
+ x[1]
225
+ ], inside, outside);
226
+ if (margin > 0) return {
227
+ x: x[0],
228
+ y: x[1],
229
+ margin
230
+ };
231
+ if (outside.length) return {
232
+ ...polygonLabelSpot(inside, []),
233
+ margin: 0
234
+ };
235
+ return {
236
+ x: x[0],
237
+ y: x[1],
238
+ margin: 0
239
+ };
240
+ }
241
+ /** An SVG path through a polygon's points. */ export function polygonPath(polygon) {
242
+ if (!polygon.length) return "";
243
+ return `M${polygon.map((p)=>`${p[0]},${p[1]}`).join("L")}Z`;
244
+ }
245
+ /** The box around every point given. */ export function pointBounds(points) {
246
+ let x0 = Infinity, x1 = -Infinity, y0 = Infinity, y1 = -Infinity;
247
+ for (const [x, y] of points){
248
+ x0 = Math.min(x0, x);
249
+ x1 = Math.max(x1, x);
250
+ y0 = Math.min(y0, y);
251
+ y1 = Math.max(y1, y);
252
+ }
253
+ return {
254
+ x0,
255
+ x1,
256
+ y0,
257
+ y1
258
+ };
259
+ }
260
+ /**
261
+ The scale and shift that fit `bounds` inside a `width` × `height` box
262
+ less `padding` on every side, centered, keeping its proportions.
263
+ */ export function fitBounds(bounds, width, height, padding = 0) {
264
+ const { x0, x1, y0, y1 } = bounds;
265
+ const w = Math.max(0, width - 2 * padding);
266
+ const h = Math.max(0, height - 2 * padding);
267
+ const scale = x1 > x0 && y1 > y0 ? Math.min(w / (x1 - x0), h / (y1 - y0)) : 0;
268
+ return {
269
+ scale,
270
+ dx: padding + (w - (x1 - x0) * scale) / 2 - x0 * scale,
271
+ dy: padding + (h - (y1 - y0) * scale) / 2 - y0 * scale
272
+ };
273
+ }
274
+ /** A point moved by a fit. */ export function fitPoint([x, y], fit) {
275
+ return [
276
+ x * fit.scale + fit.dx,
277
+ y * fit.scale + fit.dy
278
+ ];
279
+ }
280
+ /**
281
+ Scales and centers polygons to fit inside a `width` × `height` box less
282
+ `padding` on every side, keeping their proportions.
283
+ */ export function fitPolygons(polygons, width, height, padding = 0) {
284
+ const all = Object.values(polygons).flat();
285
+ if (!all.length) return {};
286
+ const fit = fitBounds(pointBounds(all), width, height, padding);
287
+ return Object.fromEntries(Object.entries(polygons).map(([s, poly])=>[
288
+ s,
289
+ poly.map((p)=>fitPoint(p, fit))
290
+ ]));
291
+ }