@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
@@ -1,15 +1,19 @@
1
1
  /**
2
2
  Gantt — a project schedule: one labeled row per task, its bar running
3
3
  from its start to its end over a time axis, with milestones, phases,
4
- dependency arrows, progress, and a "today" line.
4
+ dependency arrows and their critical path, progress, and a "today"
5
+ line.
5
6
 
6
7
  Implementation files in this folder:
7
8
  - `ganttRows.ts` — pure: task fields, ordering, and group rows.
9
+ - `criticalPath.ts` — pure: the critical path method.
8
10
  - `ganttGeometry.ts` — pure: diamonds, progress, brackets, elbows.
9
11
  - `ganttLabels.ts` — the label column's font and fitted labels.
10
12
  - `ganttTooltip.ts` — task times, tooltip rows, and aria labels.
13
+ - `ganttCritical.ts` — the drawn tasks' critical path, in working time.
14
+ - `ganttSlack.ts` — each task's slack, for its tooltip.
11
15
  - `applyLayout.ts` — chart-specific `TransformStage`.
12
- - `ganttDecor.ts` — labels, brackets, dependencies, "today".
16
+ - `ganttDecor.ts` — labels, brackets, dependencies, key, "today".
13
17
  - `emit.ts` — the scene nodes of each task.
14
18
  */ import { mean } from "d3-array";
15
19
  import { Axis } from "../../components/index.js";
@@ -55,8 +59,9 @@ export const ganttDef = {
55
59
  /**
56
60
  The time axis along the top of the rows (`orient: "bottom"` moves it
57
61
  under them). It reads dates by default (`scale: "time"`); a
58
- `rangeBreaks` setting such as `"weekends"` hides those times, and a
59
- task's Duration then counts only the working days left showing.
62
+ `rangeBreaks` setting such as `"weekends"` hides those times. A
63
+ task's Duration counts working days, leaving out the locale's weekend
64
+ and the whole days `rangeBreaks` hide (see `criticalPathConfig`).
60
65
  */ {
61
66
  key: "axisConfig",
62
67
  merge: true,
@@ -65,6 +70,46 @@ export const ganttDef = {
65
70
  }
66
71
  },
67
72
  /**
73
+ Finds and emphasizes the critical path: the chain of `dependencies`
74
+ that sets the project's finish. It takes each task's dates as given,
75
+ and works back from the latest end to find how late each task could
76
+ start without delaying it; a task's slack is how much later that is
77
+ than its start, in working days: the locale's weekend (Saturday and
78
+ Sunday in `en-US`, Friday and Saturday in `ar-SA`), and any whole
79
+ days `rangeBreaks` hide (such as holidays), count as no time, so a
80
+ task ending on a Friday and its dependent starting on Monday hand off
81
+ with no slack. Tasks with no slack, or less when a dependent starts before
82
+ they end, are critical: they're outlined in their own color, their
83
+ arrows draw bold, and every other task is muted. Tied chains are all
84
+ critical. The tooltip lists each task's Slack (in working days) and
85
+ Latest start, and a key in the label column's corner names the bold
86
+ arrows. Dependencies naming tasks that aren't drawn are skipped. On
87
+ (`true`) by default, it draws only when a critical dependency joins
88
+ two drawn tasks, so a chart without dependencies (or whose
89
+ dependencies never chain to the finish) looks the same; a cycle draws
90
+ nothing and logs a warning. `false` turns it off.
91
+ @type {boolean}
92
+ */ {
93
+ key: "criticalPath",
94
+ default: true
95
+ },
96
+ /**
97
+ Styles the critical path: `stroke` (the dependency arrows' color by
98
+ default), `strokeWidth` (twice theirs), `strokeOpacity` (1), and
99
+ `arrowSize` for its arrows; `barStroke` (each task's own color;
100
+ `false` for none) and `barStrokeWidth` (2) for the outline of its
101
+ tasks; `mutedOpacity` (0.35) for the tasks off it; the key's `label`
102
+ (the translated "Critical path"; `false` for no key); and
103
+ `workingDays` (`true`), which leaves the locale's weekend out of
104
+ slack and each task's Duration (`false` counts it, leaving out only
105
+ the days `rangeBreaks` hide).
106
+ @type {{stroke, strokeWidth, strokeOpacity, arrowSize, barStroke, barStrokeWidth, mutedOpacity, label, workingDays}}
107
+ */ {
108
+ key: "criticalPathConfig",
109
+ merge: true,
110
+ default: {}
111
+ },
112
+ /**
68
113
  Accessor function or string key for each task's predecessors: the ids
69
114
  (by `groupBy`) of the tasks it waits on, as an array or a
70
115
  comma-separated string. Each draws an arrow from the predecessor's end
@@ -122,8 +167,10 @@ export const ganttDef = {
122
167
  },
123
168
  /**
124
169
  Accessor function or string key for whether a task is a milestone,
125
- drawn as a diamond at its `end`. Without one, a task that starts and
126
- ends at the same time is a milestone.
170
+ drawn as a diamond at its `start` (the start of that day, when it
171
+ names a whole day). A milestone on a whole day takes predecessors
172
+ finishing any time that day with no slack. Without one, a task that
173
+ starts and ends at the same time is a milestone.
127
174
  @type {string | function | false}
128
175
  */ {
129
176
  key: "milestone",
@@ -212,8 +259,10 @@ export const ganttDef = {
212
259
  };
213
260
  /**
214
261
  Creates a Gantt chart from an array of tasks: one labeled row per task,
215
- its bar running from `start` to `end` over a time axis. Tasks can be
216
- grouped into phases (`group`), drawn as milestones (`milestone`), linked
217
- by dependency arrows (`dependencies`), and filled by their `progress`,
218
- with an optional `today` line.
262
+ its bar running from `start` to `end` over a time axis (through the end
263
+ of the day, when `end` names a whole day such as `"2024-03-08"`). Tasks
264
+ can be grouped into phases (`group`), drawn as milestones (`milestone`),
265
+ linked by dependency arrows (`dependencies`) with their critical path
266
+ emphasized (`criticalPath`), and filled by their `progress`, with an
267
+ optional `today` line.
219
268
  */ export default makeChart(ganttDef);
@@ -14,6 +14,7 @@ import { hasName } from "./applyLayout.js";
14
14
  import { dialLayout } from "./dialLayout.js";
15
15
  import { emitDialLabels, emitDialParts } from "./emitDial.js";
16
16
  import { needlePath, toDegrees } from "./gaugeGeometry.js";
17
+ import { pairLabels } from "../features/labelLayering.js";
17
18
  /** The width of the background-colored outline that separates each needle from the dial. */ export const NEEDLE_OUTLINE = 1.5;
18
19
  /**
19
20
  The colors a dial is drawn in when `axisConfig` doesn't set them, read
@@ -153,7 +154,7 @@ import { needlePath, toDegrees } from "./gaugeGeometry.js";
153
154
  hub
154
155
  ];
155
156
  }
156
- export const gaugeEmit = ({ viz, shapeData })=>{
157
+ export const gaugeEmit = pairLabels(({ viz, shapeData })=>{
157
158
  const rows = shapeData ?? [];
158
159
  const shared = viz.ctx.gauge;
159
160
  if (!rows.length || !shared || !(shared.radius > 0)) return [];
@@ -211,4 +212,4 @@ export const gaugeEmit = ({ viz, shapeData })=>{
211
212
  children
212
213
  }
213
214
  ];
214
- };
215
+ });
@@ -11,6 +11,17 @@ import { flowLinkCoordinates, geomapFlowLinks } from "./flowLinks.js";
11
11
  import { clipsToCircle, coordinateVisible, toLonLat } from "./flowGeometry.js";
12
12
  import { cachedPaths, fitExtentOnce, topoFeatures } from "./geoCache.js";
13
13
  import { globeHome } from "./globeRotate.js";
14
+ import { geomapCartogram } from "./cartogramLayout.js";
15
+ import { drawnCartogramScale, estimateCartogramScale, setCartogramLegend } from "./cartogramLegend.js";
16
+ import { geomapDensity, geomapRegionRows } from "./densityLayout.js";
17
+ import { geoHexbinSettings } from "./geoHexbin.js";
18
+ import { geoZoom } from "./geoHexbinZoom.js";
19
+ import { geomapPointClusters } from "./pointClusterLayout.js";
20
+ import { drillBounds, fitTopojson, geomapDrillLayout, levelFeatures, topojsonAt, topojsonKeyAt } from "./drillDown.js";
21
+ import { drillKey } from "./drillDown.js";
22
+ import { geomapTopojson } from "./topojsonLevels.js";
23
+ import { geomapTileGrid, regionsReshaped, tileGridOf, tileGridRegions } from "./tileGrid.js";
24
+ import { isPointRow } from "./pointRows.js";
14
25
  /** Reduces fit features, trimming far-flung MultiPolygon parts via path geometry. */ function reduceExtentFeatures(features, path) {
15
26
  return features.reduce((arr, raw)=>{
16
27
  const d = raw;
@@ -99,7 +110,7 @@ import { globeHome } from "./globeRotate.js";
99
110
  };
100
111
  }
101
112
  /** The rows drawn as points: those whose `point` accessor returns coordinates. */ export function geomapPointData(v) {
102
- return v._filteredData.filter((d, i)=>v.schema.point(d, i) instanceof Array);
113
+ return v._filteredData.filter((d, i)=>isPointRow(v, d, i));
103
114
  }
104
115
  /** The point radius scale: `pointSizeScale` over the points' `pointSize` extent, onto `[pointSizeMin, pointSizeMax]`. */ export function geomapPointSizeScale(v, pointData) {
105
116
  const scaleName = `scale${v.schema.pointSizeScale.charAt(0).toUpperCase()}${v.schema.pointSizeScale.slice(1)}`;
@@ -122,14 +133,14 @@ import { globeHome } from "./globeRotate.js";
122
133
  /**
123
134
  Picks the features (or, without any, the coordinate points and the
124
135
  coordinate ends of `links`) the projection fits, onto `ctx.extentBounds`.
125
- */ function fitExtentBounds(v, ctx, coordData, path, pointData, r) {
136
+ */ function fitExtentBounds(v, ctx, fit, path, pointData, r) {
126
137
  // The point-radius padding belongs with the extent it was computed for,
127
138
  // so a later draw that reuses the cached extent fits the same way.
128
139
  ctx.effectivePadding = undefined;
129
- const fitData = v.schema.fitObject ? topoFeatures(v.schema.fitObject, v.schema.fitKey) : coordData;
140
+ const fitData = fit.data;
130
141
  ctx.extentBounds = {
131
142
  type: "FeatureCollection",
132
- features: v.schema.fitFilter ? fitData.features.filter(v.schema.fitFilter) : fitData.features.slice()
143
+ features: v.schema.fitFilter && !fit.drilled ? fitData.features.filter(v.schema.fitFilter) : fitData.features.slice()
133
144
  };
134
145
  ctx.extentBounds.features = reduceExtentFeatures(ctx.extentBounds.features, path);
135
146
  const linkCoords = flowLinkCoordinates(v.schema.links);
@@ -137,6 +148,44 @@ import { globeHome } from "./globeRotate.js";
137
148
  applyPointExtentBounds(v, ctx, pointData, r, linkCoords);
138
149
  }
139
150
  }
151
+ /**
152
+ Whether a drill-down zooms the map to the regions drilled into (see
153
+ `drillEvents.ts`). A map that can't zoom (`zoom` off, small multiples,
154
+ a server render) fits its projection to them instead.
155
+ */ export function drillZooms(v) {
156
+ return Boolean(v.schema.zoom) && !v._ssr && !v._facetPanels && !v._facetStep;
157
+ }
158
+ /**
159
+ The features the projection fits, and a key naming them: the regions
160
+ drilled into on a map that can't zoom to them, else `fitObject`, else
161
+ the first level of a `topojson` list (so every drill keeps one home
162
+ view), else the drawn topojson.
163
+ */ function fitCollection(v, coordData, drill) {
164
+ const collection = (features)=>({
165
+ type: "FeatureCollection",
166
+ features
167
+ });
168
+ if (drill && !drillZooms(v)) {
169
+ const active = drill.regions.filter((region)=>region.active);
170
+ return {
171
+ data: collection(active.map((region)=>region.feature)),
172
+ drilled: true,
173
+ key: `${drill.drill.depth}:${active.map((region)=>region.id).join("|")}`
174
+ };
175
+ }
176
+ if (v.schema.fitObject) return {
177
+ data: topoFeatures(v.schema.fitObject, v.schema.fitKey),
178
+ drilled: false,
179
+ key: ""
180
+ };
181
+ const topojson = geomapTopojson(v);
182
+ const home = Array.isArray(topojson) ? fitTopojson(topojson) : null;
183
+ return {
184
+ data: home ? collection(levelFeatures(v, home.depth)) : coordData,
185
+ drilled: false,
186
+ key: ""
187
+ };
188
+ }
140
189
  /**
141
190
  Fits the projection to `ctx.extentBounds` (or the whole sphere)
142
191
  within the chart area, less its padding. A globe the user has turned is
@@ -170,25 +219,103 @@ import { globeHome } from "./globeRotate.js";
170
219
  });
171
220
  if (live) v.schema.projection.rotate(live);
172
221
  }
222
+ /** Each cartogram shape as a link end, by region id: its center and radius. */ export function cartogramAnchors(shapes) {
223
+ const out = new Map();
224
+ for (const [id, shape] of shapes)out.set(`${id}`, {
225
+ at: [
226
+ shape.x,
227
+ shape.y
228
+ ],
229
+ r: shape.r
230
+ });
231
+ return out;
232
+ }
233
+ /**
234
+ The point size legend's scale, before the map is laid out: a
235
+ cartogram's shapes' sizes, none for a tile grid or bins, else the
236
+ points' radii.
237
+ @param v The Geomap.
238
+ @param available The room the legend may take.
239
+ */ export function geomapSizeLegendScale(v, available) {
240
+ // A tile grid's equal tiles have no sizes to show.
241
+ if (!tileGridOf(v) && setCartogramLegend(v)) return estimateCartogramScale(v, available);
242
+ if (regionsReshaped(v) || geoHexbinSettings(v)) return null;
243
+ const pointData = geomapPointData(v);
244
+ return pointData.length ? geomapPointSizeScale(v, pointData) : null;
245
+ }
246
+ /** The box a cartogram's shapes fit: the map area, less `projectionPadding`. */ function cartogramBounds(v, width, height) {
247
+ const p = v.schema.projectionPadding;
248
+ return [
249
+ p.left,
250
+ p.top,
251
+ width - p.right,
252
+ height - p.bottom
253
+ ];
254
+ }
255
+ /**
256
+ The regions' tile-grid tiles, or else their cartogram shapes, or null
257
+ on the map. A cartogram's size legend shows its shapes' sizes (a tile
258
+ grid's tiles are all one size).
259
+ */ function reshapeRegions(v, regions, input) {
260
+ const tiles = geomapTileGrid(v, regions, input.bounds);
261
+ const cartogram = tiles ?? geomapCartogram(v, regions, input);
262
+ if (!tiles && setCartogramLegend(v) && cartogram) v._sizeLegendFinal = drawnCartogramScale(v, regions, cartogram);
263
+ else if (cartogram) v._sizeLegendFinal = null;
264
+ return cartogram;
265
+ }
266
+ /**
267
+ The clusters of the points drawn, or null (see `geomapPointClusters`).
268
+ Clustered points keep their pixel size through zoom, so a map that
269
+ zooms to the regions it drilled into clusters its points from the
270
+ start. A pending repaint of the last layout's clusters has nothing left
271
+ to drop.
272
+ */ function layoutClusters(v, ctx, visible, pointR, drilled) {
273
+ const last = ctx.geomapCtx?.cluster;
274
+ if (last) clearTimeout(last.timer);
275
+ const cluster = geomapPointClusters(v, visible, pointR, geoZoom(v).k, drilled && drillZooms(v));
276
+ v._pointsHoldSize = Boolean(cluster);
277
+ return cluster;
278
+ }
279
+ /**
280
+ What a draw knows about its drill: the regions at the drilled level,
281
+ the ids drawn below them, and the view a drill zooms to.
282
+ */ function drillScene(drill, topoData, path, [width, height]) {
283
+ return {
284
+ regions: drill.regions,
285
+ childIds: new Set(topoData.map((d)=>`${d.id}`)),
286
+ bounds: drillBounds(drill.regions, (f)=>path.bounds(f)),
287
+ key: drillKey(drill, width, height)
288
+ };
289
+ }
290
+ /**
291
+ The features of the topojson drawn at the chart's depth (see
292
+ `topojsonAt`), after `topojsonFilter`.
293
+ */ function levelCoordData(v) {
294
+ const depth = v._drawDepth ?? 0;
295
+ const topo = topojsonAt(geomapTopojson(v), depth);
296
+ const coordData = topo ? topoFeatures(topo, topojsonKeyAt(v.schema.topojsonKey, depth)) : {
297
+ type: "FeatureCollection",
298
+ features: []
299
+ };
300
+ if (v.schema.topojsonFilter) coordData.features = coordData.features.filter(v.schema.topojsonFilter);
301
+ return coordData;
302
+ }
173
303
  export const applyGeomapLayout = ({ viz })=>{
174
304
  const v = viz;
175
305
  const ctx = viz.ctx;
176
306
  const { width, height } = chartBounds(v);
177
- const coordData = v.schema.topojson ? topoFeatures(v.schema.topojson, v.schema.topojsonKey) : {
178
- type: "FeatureCollection",
179
- features: []
180
- };
307
+ const coordData = levelCoordData(v);
181
308
  ctx.coordData = coordData;
182
- if (v.schema.topojsonFilter) coordData.features = coordData.features.filter(v.schema.topojsonFilter);
183
309
  const path = d3GeoCore.geoPath().projection(v.schema.projection);
184
310
  ctx.path = path;
185
311
  const pointData = geomapPointData(v);
186
- const pathData = v._filteredData.filter((d, i)=>!(v.schema.point(d, i) instanceof Array)).reduce((obj, d, i)=>{
187
- obj[v._id(d, i)] = d;
188
- return obj;
189
- }, {});
190
- const topoData = coordData.features.reduce((arr, feature)=>{
312
+ const { rows: regionRows, data: pathData } = geomapRegionRows(v);
313
+ // Drilled into a region, the map draws only its children: the regions
314
+ // with rows (which the drill's filter has narrowed to the region's).
315
+ const drill = geomapDrillLayout(v);
316
+ const features = coordData.features.reduce((arr, feature)=>{
191
317
  const id = v.schema.topojsonId(feature);
318
+ if (drill && !pathData[id]) return arr;
192
319
  arr.push({
193
320
  __d3plus__: true,
194
321
  data: pathData[id],
@@ -196,26 +323,57 @@ export const applyGeomapLayout = ({ viz })=>{
196
323
  id
197
324
  });
198
325
  return arr;
199
- }, []);
326
+ }, []); // A tile grid without a topojson draws a tile for each cell of its layout.
327
+ const grid = tileGridOf(v);
328
+ const topoData = grid && !features.length ? tileGridRegions(grid, pathData) : features;
200
329
  const r = geomapPointSizeScale(v, pointData);
201
- v._sizeLegendFinal = pointData.length ? r : null;
202
- if (!v._zoomSet || !ctx.extentBounds) fitExtentBounds(v, ctx, coordData, path, pointData, r);
330
+ // Binned points draw no circles to size.
331
+ const binned = Boolean(geoHexbinSettings(v));
332
+ v._sizeLegendFinal = pointData.length && !binned ? r : null;
333
+ const fit = fitCollection(v, coordData, drill);
334
+ if (!v._zoomSet || !ctx.extentBounds || (ctx.fitDrill ?? "") !== fit.key) {
335
+ fitExtentBounds(v, ctx, fit, path, pointData, r);
336
+ ctx.fitDrill = fit.key;
337
+ }
203
338
  // A globe being dragged keeps the scale it was fitted at.
204
339
  if (!v._globeDragging) fitProjection(v, ctx, width, height);
205
340
  ctx.geomapWidth = width;
206
341
  ctx.geomapHeight = height;
207
342
  const featurePath = cachedPaths(v.schema.projection, path);
208
343
  const pointR = (d, i)=>r(v.schema.pointSize(d, i));
344
+ // A cartogram or tile grid draws its regions only: coordinate points have
345
+ // no place on it.
346
+ const cartogram = reshapeRegions(v, topoData, {
347
+ pathD: (region)=>featurePath(region.feature),
348
+ area: (region)=>path.area(region.feature),
349
+ bounds: cartogramBounds(v, width, height)
350
+ });
351
+ const visible = cartogram ? [] : visiblePointData(v, pointData, path);
352
+ const cluster = binned ? null : layoutClusters(v, ctx, visible, pointR, Boolean(drill));
353
+ const density = geomapDensity(v, {
354
+ regions: topoData,
355
+ rows: regionRows,
356
+ pathD: (region)=>featurePath(region.feature),
357
+ points: visible
358
+ });
209
359
  ctx.geomapCtx = {
360
+ density,
361
+ cartogram,
210
362
  flowLinks: geomapFlowLinks(v, {
211
363
  pointData,
212
364
  topoData: topoData,
213
365
  pointR,
214
- path: path
366
+ path: path,
367
+ anchors: cartogram ? cartogramAnchors(cartogram) : undefined
215
368
  }),
216
369
  topoData,
370
+ drill: drill && drillScene(drill, topoData, path, [
371
+ width,
372
+ height
373
+ ]),
217
374
  pathFn: (d)=>featurePath(d.feature),
218
- pointData: visiblePointData(v, pointData, path),
375
+ pointData: binned ? [] : visible,
376
+ cluster,
219
377
  pointR,
220
378
  pointSort: (a, b)=>v.schema.pointSize(b) - v.schema.pointSize(a),
221
379
  pointX: (d, i)=>v.schema.projection(v.schema.point(d, i))[0],
@@ -0,0 +1,50 @@
1
+ /**
2
+ Dorling and Demers cartogram shapes: each region drawn as a circle
3
+ (Dorling) or square (Demers) whose area stands for its value (see
4
+ `cartogramRelax.ts` for where they land).
5
+
6
+ @module
7
+ */ /** The cartogram kinds Geomap draws. */ /**
8
+ The radius (or, for squares, half the side) of each value's shape, with
9
+ the shapes' areas adding up to `area` and each in proportion to its
10
+ value. A value that isn't a positive number gets 0.
11
+ @param values Each region's value.
12
+ @param area The total area the shapes take.
13
+ @param square Squares (Demers) rather than circles (Dorling).
14
+ @param total The value the whole `area` stands for; defaults to the sum of `values`.
15
+ */ export function cartogramRadii(values, area, square, total) {
16
+ const positive = values.map((v)=>Number.isFinite(v) && v > 0 ? v : 0);
17
+ const sum = total ?? positive.reduce((a, b)=>a + b, 0);
18
+ if (!sum || !(area > 0)) return positive.map(()=>0);
19
+ return positive.map((v)=>{
20
+ const a = v / sum * area;
21
+ return square ? Math.sqrt(a) / 2 : Math.sqrt(a / Math.PI);
22
+ });
23
+ }
24
+ /** The points around a circle drawn as a cartogram shape. */ const CIRCLE_POINTS = 64;
25
+ /**
26
+ A circle as polygon path data, so it can morph to and from a region's
27
+ outline (see `morphPathD` in `@d3plus/render`).
28
+ @param x The center x.
29
+ @param y The center y.
30
+ @param r The radius.
31
+ */ export function circlePathD(x, y, r) {
32
+ let d = "";
33
+ for(let i = 0; i < CIRCLE_POINTS; i++){
34
+ const a = i / CIRCLE_POINTS * 2 * Math.PI - Math.PI / 2;
35
+ d += `${i ? "L" : "M"}${round(x + r * Math.cos(a))},${round(y + r * Math.sin(a))}`;
36
+ }
37
+ return `${d}Z`;
38
+ }
39
+ /**
40
+ A square centered on `(x, y)`, `2h` on a side, as polygon path data.
41
+ @param x The center x.
42
+ @param y The center y.
43
+ @param h Half the side.
44
+ */ export function squarePathD(x, y, h) {
45
+ const x0 = round(x - h), x1 = round(x + h), y0 = round(y - h), y1 = round(y + h);
46
+ return `M${x0},${y0}L${x1},${y0}L${x1},${y1}L${x0},${y1}Z`;
47
+ }
48
+ /** A coordinate rounded to a thousandth of a pixel, as d3-geo writes them. */ function round(v) {
49
+ return Math.round(v * 1000) / 1000;
50
+ }
@@ -0,0 +1,196 @@
1
+ /**
2
+ The contiguous cartogram: every region's outline stretched until its
3
+ area stands for its value, while neighbors keep their shared borders,
4
+ by Dougenik, Chrisman and Niemeyer's iterative distortion (1985). Each
5
+ pass pushes every point of the map away from the centers of regions
6
+ that need to grow and toward those that need to shrink; a point is
7
+ moved by where it lies alone, so the points two regions share move
8
+ together and their border stays shared.
9
+
10
+ @module
11
+ */ /** The most distortion passes, by default. */ export const CONTIGUOUS_ITERATIONS = 12;
12
+ /** The area error every region must be within to stop early, by default: 1%. */ export const CONTIGUOUS_TOLERANCE = 0.01;
13
+ /** The force sums a pass works out exactly before turning to a grid, by default. */ export const CONTIGUOUS_BUDGET = 1e7;
14
+ /**
15
+ The most a region's size error (its area against the area it should
16
+ have, the larger over the smaller) counts toward slowing a pass. Every
17
+ pass moves points by less the larger the regions' mean error, so a few
18
+ regions thousands of times off (a city county) would otherwise hold a
19
+ whole map of counties still.
20
+ */ const SIZE_ERROR_CAP = 10;
21
+ /**
22
+ The largest area error among the regions with a value: how far each
23
+ one's share of the map's area is from its value's share, as a share of
24
+ the latter.
25
+ */ export function largestError(shapes, values, valued, valueTotal) {
26
+ const area = shapes.reduce((s, r)=>s + r.area, 0);
27
+ let worst = 0;
28
+ shapes.forEach((s, i)=>{
29
+ if (!valued[i]) return;
30
+ const target = values[i] / valueTotal;
31
+ worst = Math.max(worst, Math.abs(s.area / area - target) / target);
32
+ });
33
+ return worst;
34
+ }
35
+ /** A region's area and its center (signed rings: holes take away). */ function regionCentroid(rings) {
36
+ let area = 0, cx = 0, cy = 0;
37
+ for (const ring of rings){
38
+ for(let i = 0, n = ring.length; i < n; i++){
39
+ const [x0, y0] = ring[i], [x1, y1] = ring[(i + 1) % n];
40
+ const cross = x0 * y1 - x1 * y0;
41
+ area += cross;
42
+ cx += (x0 + x1) * cross;
43
+ cy += (y0 + y1) * cross;
44
+ }
45
+ }
46
+ if (!area) {
47
+ const pts = rings.flat();
48
+ const n = pts.length || 1;
49
+ return {
50
+ area: 0,
51
+ x: pts.reduce((s, p)=>s + p[0], 0) / n,
52
+ y: pts.reduce((s, p)=>s + p[1], 0) / n
53
+ };
54
+ }
55
+ return {
56
+ area: Math.abs(area / 2),
57
+ x: cx / (3 * area),
58
+ y: cy / (3 * area)
59
+ };
60
+ }
61
+ /** The push the regions give a point at `(px, py)`, scaled by `reduce`. */ function pushAt(forces, px, py, reduce) {
62
+ const { x, y, r, mass } = forces;
63
+ let dx = 0, dy = 0;
64
+ for(let j = 0; j < x.length; j++){
65
+ const ox = px - x[j], oy = py - y[j];
66
+ const d = Math.sqrt(ox * ox + oy * oy);
67
+ const rj = r[j];
68
+ if (!d || !rj) continue;
69
+ const f = d > rj ? mass[j] * rj / d : mass[j] * (d * d / (rj * rj)) * (4 - 3 * d / rj);
70
+ dx += f * ox / d;
71
+ dy += f * oy / d;
72
+ }
73
+ return [
74
+ dx * reduce,
75
+ dy * reduce
76
+ ];
77
+ }
78
+ /**
79
+ The pushes on a grid of about `nodes` points over the box `[x0, y0,
80
+ x1, y1]`, read at any point between its nodes (bilinearly), so a point
81
+ still moves by where it lies alone.
82
+ */ function pushField(forces, box, nodes, reduce) {
83
+ const [x0, y0, x1, y1] = box;
84
+ const w = Math.max(x1 - x0, 1e-9), h = Math.max(y1 - y0, 1e-9);
85
+ const step = Math.sqrt(w * h / Math.max(nodes, 4));
86
+ const nx = Math.max(2, Math.ceil(w / step) + 1), ny = Math.max(2, Math.ceil(h / step) + 1);
87
+ const sx = w / (nx - 1), sy = h / (ny - 1);
88
+ const gx = new Float64Array(nx * ny), gy = new Float64Array(nx * ny);
89
+ for(let i = 0; i < nx; i++)for(let j = 0; j < ny; j++){
90
+ const [dx, dy] = pushAt(forces, x0 + i * sx, y0 + j * sy, reduce);
91
+ gx[i * ny + j] = dx;
92
+ gy[i * ny + j] = dy;
93
+ }
94
+ return (px, py)=>{
95
+ const fx = Math.min(nx - 1, Math.max(0, (px - x0) / sx)), fy = Math.min(ny - 1, Math.max(0, (py - y0) / sy));
96
+ const i = Math.min(nx - 2, Math.floor(fx)), j = Math.min(ny - 2, Math.floor(fy));
97
+ const tx = fx - i, ty = fy - j;
98
+ const a = i * ny + j, b = (i + 1) * ny + j;
99
+ const lerp = (g)=>(g[a] * (1 - tx) + g[b] * tx) * (1 - ty) + (g[a + 1] * (1 - tx) + g[b + 1] * tx) * ty;
100
+ return [
101
+ lerp(gx),
102
+ lerp(gy)
103
+ ];
104
+ };
105
+ }
106
+ /**
107
+ Each region's rings, distorted so its area stands for its value and
108
+ shared borders stay shared. The map keeps its total area; a region
109
+ whose value isn't a positive number keeps the mean density, so it
110
+ neither grows nor shrinks against the rest. Each output ring has the
111
+ points of its input ring, so the two morph point by point.
112
+ @param regions Each region's projected rings and value.
113
+ @param options The most passes, the error that stops them early, and the work a pass does exactly.
114
+ */ export function contiguousCartogram(regions, options = {}) {
115
+ const iterations = options.iterations ?? CONTIGUOUS_ITERATIONS;
116
+ const tolerance = options.tolerance ?? CONTIGUOUS_TOLERANCE;
117
+ const budget = options.budget ?? CONTIGUOUS_BUDGET;
118
+ // Every distinct point once, so the points regions share move as one.
119
+ const index = new Map();
120
+ const xs = [], ys = [];
121
+ const refs = regions.map((region)=>region.rings.map((ring)=>ring.map(([x, y])=>{
122
+ const key = `${x},${y}`;
123
+ let k = index.get(key);
124
+ if (k === undefined) {
125
+ k = xs.length;
126
+ index.set(key, k);
127
+ xs.push(x);
128
+ ys.push(y);
129
+ }
130
+ return k;
131
+ })));
132
+ const ringsNow = ()=>refs.map((rings)=>rings.map((ring)=>ring.map((k)=>[
133
+ xs[k],
134
+ ys[k]
135
+ ])));
136
+ const start = regions.map((r)=>regionCentroid(r.rings).area);
137
+ const total = start.reduce((a, b)=>a + b, 0);
138
+ const valued = regions.map((r)=>Number.isFinite(r.value) && r.value > 0);
139
+ const valueSum = regions.reduce((s, r, i)=>s + (valued[i] ? r.value : 0), 0);
140
+ const valuedArea = start.reduce((s, a, i)=>s + (valued[i] ? a : 0), 0);
141
+ if (!total || !valueSum) return ringsNow();
142
+ // A region without a value stands for what its area holds at the mean density.
143
+ const values = regions.map((r, i)=>valued[i] ? r.value : start[i] * valueSum / (valuedArea || total));
144
+ const valueTotal = values.reduce((a, b)=>a + b, 0);
145
+ for(let pass = 0; pass < iterations; pass++){
146
+ const rings = ringsNow();
147
+ const shapes = rings.map(regionCentroid);
148
+ const m = shapes.length;
149
+ const forces = {
150
+ x: new Float64Array(m),
151
+ y: new Float64Array(m),
152
+ r: new Float64Array(m),
153
+ mass: new Float64Array(m)
154
+ };
155
+ let error = 0;
156
+ shapes.forEach((s, i)=>{
157
+ const desired = values[i] / valueTotal * total;
158
+ const r = Math.sqrt(s.area / Math.PI);
159
+ forces.x[i] = s.x;
160
+ forces.y[i] = s.y;
161
+ forces.r[i] = r;
162
+ forces.mass[i] = Math.sqrt(desired / Math.PI) - r;
163
+ error += Math.min(SIZE_ERROR_CAP, Math.max(s.area, desired) / Math.max(Math.min(s.area, desired), 1e-9));
164
+ });
165
+ if (largestError(shapes, values, valued, valueTotal) < tolerance) break;
166
+ const reduce = 1 / (1 + error / shapes.length);
167
+ const n = xs.length;
168
+ if (n * m <= budget) {
169
+ for(let k = 0; k < n; k++){
170
+ const [dx, dy] = pushAt(forces, xs[k], ys[k], reduce);
171
+ xs[k] += dx;
172
+ ys[k] += dy;
173
+ }
174
+ } else {
175
+ let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;
176
+ for(let k = 0; k < n; k++){
177
+ x0 = Math.min(x0, xs[k]);
178
+ x1 = Math.max(x1, xs[k]);
179
+ y0 = Math.min(y0, ys[k]);
180
+ y1 = Math.max(y1, ys[k]);
181
+ }
182
+ const field = pushField(forces, [
183
+ x0,
184
+ y0,
185
+ x1,
186
+ y1
187
+ ], budget / m, reduce);
188
+ for(let k = 0; k < n; k++){
189
+ const [dx, dy] = field(xs[k], ys[k]);
190
+ xs[k] += dx;
191
+ ys[k] += dy;
192
+ }
193
+ }
194
+ }
195
+ return ringsNow();
196
+ }