@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,27 @@
1
+ /**
2
+ `wordCloudEmit` — each placed word as a text node, over a transparent
3
+ rect covering its text box that takes the pointer, keyboard focus, and
4
+ selection for it (text isn't a data mark on its own).
5
+ */
6
+ import type { ChartEmit } from "../definition/ChartDefinition.js";
7
+ import type { WordCloudWord } from "./applyLayout.js";
8
+ /** The shape class words fire `"<event>.Text"` handlers and read `shapeConfig.Text` as. */
9
+ export declare const WORD_SHAPE = "Text";
10
+ /**
11
+ The rect a word's pointer events, focus, and selection land on: its
12
+ unrotated text box around its anchor.
13
+ @param word The placed word.
14
+ */
15
+ export declare function wordBox(word: Pick<WordCloudWord, "metrics">): {
16
+ x: number;
17
+ y: number;
18
+ width: number;
19
+ height: number;
20
+ };
21
+ /**
22
+ A word's accessible name: its text and its value.
23
+ @param word The placed word.
24
+ @param locale The chart's locale, for the value.
25
+ */
26
+ export declare function wordAriaLabel(word: Pick<WordCloudWord, "text" | "value">, locale: string): string;
27
+ export declare const wordCloudEmit: ChartEmit;
@@ -0,0 +1,20 @@
1
+ /**
2
+ WordCloud's font sizes: each word's value mapped onto `fontMin`–`fontMax`.
3
+ */
4
+ /** How values map onto font sizes: `"sqrt"`, `"linear"`, or `"log"`. */
5
+ export type FontScaleKind = "sqrt" | "linear" | "log";
6
+ /**
7
+ Coerces a `fontScale` setting, falling back to `"sqrt"`.
8
+ @param value The setting.
9
+ */
10
+ export declare function fontScaleKind(value: unknown): FontScaleKind;
11
+ /**
12
+ The font size, in pixels, for each value: the smallest value draws at
13
+ `min`, the largest at `max`, and the ones between by `kind` (with
14
+ `"sqrt"`, a word's ink area grows about in step with its value). When
15
+ every value is the same, every word draws at `max`.
16
+ @param values Every word's value (each positive and finite).
17
+ @param range The smallest and largest font sizes.
18
+ @param kind How values map between them.
19
+ */
20
+ export declare function wordFontSize(values: number[], range: [number, number], kind?: FontScaleKind): (value: number) => number;
@@ -0,0 +1,95 @@
1
+ /**
2
+ Rasterizes WordCloud's words into glyph masks: each word is drawn at its
3
+ font, size, and angle onto an offscreen canvas, many to a sheet, and the
4
+ alpha of its pixels read back into a 1-bit `GlyphSprite`. Where no canvas
5
+ is available, each word is measured instead and its mask fills its
6
+ rotated text box.
7
+ */
8
+ import type { GlyphSprite } from "./occupancy.js";
9
+ /** One word to rasterize. */
10
+ export interface GlyphWord {
11
+ text: string;
12
+ /** The CSS font-family list. */
13
+ family: string;
14
+ weight: number | string;
15
+ /** The font size in pixels. */
16
+ size: number;
17
+ /** The angle in degrees, clockwise. */
18
+ rotate: number;
19
+ /** Extra pixels of clearance kept around the word's ink. */
20
+ padding: number;
21
+ }
22
+ /** A word's unrotated text box, from its anchor (its baseline center). */
23
+ export interface GlyphMetrics {
24
+ /** The advance width. */
25
+ width: number;
26
+ /** The ink's height above the baseline. */
27
+ ascent: number;
28
+ /** The ink's depth below the baseline. */
29
+ descent: number;
30
+ }
31
+ /** A rasterized word: its mask, and the text box it was measured with. */
32
+ export interface WordGlyph {
33
+ sprite: GlyphSprite;
34
+ metrics: GlyphMetrics;
35
+ }
36
+ /** The 2D canvas surface the rasterizer draws on. */
37
+ type Context = CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
38
+ /**
39
+ A 2D context on a new `width` × `height` canvas: an `OffscreenCanvas`
40
+ where there is one (browsers, workers, and Node under `@d3plus/ssr`),
41
+ else a `<canvas>` from the document, else null.
42
+ @param width The canvas's width.
43
+ @param height The canvas's height.
44
+ */
45
+ export declare function glyphContext(width: number, height: number): Context | null;
46
+ /**
47
+ Counts a web font load (see `glyphFontLoads`). Runs whenever a font
48
+ d3plus measured text in finishes loading.
49
+ */
50
+ export declare function markFontsLoaded(): void;
51
+ /**
52
+ How many times a web font words were measured in has loaded, so a layout
53
+ rasterized in a fallback font can tell it is stale.
54
+ */
55
+ export declare function glyphFontLoads(): number;
56
+ /**
57
+ The 2D context words are rasterized on: one sheet-sized canvas, made
58
+ once and reused (see `glyphContext`), or null where there is no canvas.
59
+ */
60
+ export declare function sharedGlyphContext(): Context | null;
61
+ /** The CSS font shorthand for `word`. */
62
+ export declare function glyphFont(word: Pick<GlyphWord, "family" | "weight" | "size">): string;
63
+ /**
64
+ The axis-aligned box, around the word's anchor, that its padded text box
65
+ covers once turned by its angle.
66
+ @param metrics The word's unrotated text box.
67
+ @param word The word's angle and padding.
68
+ */
69
+ export declare function rotatedBox(metrics: GlyphMetrics, word: Pick<GlyphWord, "rotate" | "padding">): {
70
+ x0: number;
71
+ y0: number;
72
+ x1: number;
73
+ y1: number;
74
+ };
75
+ /**
76
+ A word's text box without a canvas: its width from `textWidth`, else an
77
+ estimate, and the ascent and descent of a typical Latin face.
78
+ @param word The word.
79
+ */
80
+ export declare function estimateMetrics(word: GlyphWord): GlyphMetrics;
81
+ /**
82
+ Masks that fill each word's rotated text box: the fallback where no
83
+ canvas can rasterize the glyphs.
84
+ @param words The words.
85
+ */
86
+ export declare function boxGlyphs(words: GlyphWord[]): WordGlyph[];
87
+ /**
88
+ Rasterizes `words` into glyph masks on a canvas, or, without one, into
89
+ masks that fill their measured text boxes (see `boxGlyphs`).
90
+ @param words The words, each at its font, size, angle, and padding.
91
+ @param context A 2D context to draw on, or null to measure the words
92
+ instead. Defaults to the shared canvas (see `sharedGlyphContext`).
93
+ */
94
+ export declare function rasterizeWords(words: GlyphWord[], context?: Context | null): WordGlyph[];
95
+ export {};
@@ -0,0 +1,31 @@
1
+ /**
2
+ WordCloud — one word per row, its font size by value, packed glyph-tight
3
+ around the middle of the chart area.
4
+
5
+ Implementation files in this folder:
6
+ - `applyLayout.ts` — chart-specific `TransformStage`.
7
+ - `emit.ts` — each word's text node and the rect that takes its events.
8
+ - `cloudLayout.ts` — spiral placement and the shrink-to-fit loop.
9
+ - `glyphMask.ts` — rasterizes words into 1-bit glyph masks.
10
+ - `occupancy.ts` — the masks and the occupancy bitmap they collide on.
11
+ - `spiral.ts` — the Archimedean and rectangular spirals.
12
+ - `fontScale.ts` — values to font sizes.
13
+ - `rotation.ts` — seeded hashing and each word's angle.
14
+ */
15
+ import type { DataDrivenChartDefinition } from "../definition/ChartDefinition.js";
16
+ import type { VizInstance } from "../viz/vizTypes.js";
17
+ /** The tooltip's rows: the word's summed value, then its share of the drawn words. */
18
+ export declare function wordCloudTooltipRows(viz: VizInstance): unknown[][];
19
+ export declare const wordCloudDef: DataDrivenChartDefinition;
20
+ /**
21
+ Draws a word cloud: one word per row, its font size set by its value
22
+ (`size`), packed around the middle of the chart, largest first, each word
23
+ fitted against the glyphs of the words before it so small words nest in
24
+ the gaps of large ones. The layout is the same on every draw. When the
25
+ words don't all fit, every font size shrinks until they do. Color the
26
+ words by `groupBy` or `colorScale`; hover a word to see its value and
27
+ share. Words under `threshold` of the total (0.01% by default) merge
28
+ into one.
29
+ */
30
+ declare const _default: new () => any;
31
+ export default _default;
@@ -0,0 +1,59 @@
1
+ /**
2
+ WordCloud's collision test: words as 1-bit glyph masks, packed 32
3
+ pixels to a word, and the chart area as an occupancy bitmap they are
4
+ stamped into once placed.
5
+ */
6
+ /**
7
+ A word's rasterized glyphs: a 1-bit mask of the pixels its ink (and
8
+ padding) covers, `cols` 32-pixel words per row.
9
+ */
10
+ export interface GlyphSprite {
11
+ /** The mask's width in pixels, a multiple of 32. */
12
+ width: number;
13
+ /** The ink's width in pixels (at most `width`). */
14
+ inkWidth: number;
15
+ /** The mask's height in pixels. */
16
+ height: number;
17
+ /** 32-pixel words per row (`width / 32`). */
18
+ cols: number;
19
+ /** Row-major bits, most significant bit leftmost. */
20
+ mask: Uint32Array;
21
+ /** The mask's top-left corner, from the word's anchor (its baseline center). */
22
+ x0: number;
23
+ y0: number;
24
+ }
25
+ /**
26
+ A sprite whose mask fills a `width` × `height` box: a word measured
27
+ without rasterizing it.
28
+ @param width The box's width in pixels.
29
+ @param height The box's height in pixels.
30
+ @param x0 The box's left edge, from the word's anchor.
31
+ @param y0 The box's top edge, from the word's anchor.
32
+ */
33
+ export declare function boxSprite(width: number, height: number, x0: number, y0: number): GlyphSprite;
34
+ /**
35
+ The chart area as a bitmap of the pixels placed words cover.
36
+ */
37
+ export declare class OccupancyBoard {
38
+ readonly width: number;
39
+ readonly height: number;
40
+ /** 32-pixel words per row, plus one so a shifted sprite never reads past a row. */
41
+ readonly cols: number;
42
+ readonly bits: Uint32Array;
43
+ /**
44
+ @param width The area's width in pixels.
45
+ @param height The area's height in pixels.
46
+ */
47
+ constructor(width: number, height: number);
48
+ /** Whether `sprite`, with its top-left at (x, y), lies inside the area. */
49
+ inside(sprite: GlyphSprite, x: number, y: number): boolean;
50
+ /**
51
+ Whether `sprite`, with its top-left at the whole pixel (x, y), covers
52
+ any pixel already taken. The sprite must lie inside the area.
53
+ */
54
+ collides(sprite: GlyphSprite, x: number, y: number): boolean;
55
+ /** Marks the pixels `sprite` covers, with its top-left at (x, y), as taken. */
56
+ place(sprite: GlyphSprite, x: number, y: number): void;
57
+ /** Whether the pixel at (x, y) is taken. */
58
+ taken(x: number, y: number): boolean;
59
+ }
@@ -0,0 +1,31 @@
1
+ /**
2
+ WordCloud's deterministic per-word choices: a seeded string hash and the
3
+ angle each word takes from `rotate`.
4
+ */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ /**
7
+ A 32-bit FNV-1a hash of `text`, as an unsigned integer. The same text
8
+ and seed always give the same hash, so choices drawn from it repeat
9
+ across draws.
10
+ @param text The string to hash (a word's id).
11
+ @param seed Varies the hash, so separate choices about one word don't
12
+ follow each other.
13
+ */
14
+ export declare function hashString(text: string, seed?: number): number;
15
+ /**
16
+ A number in [0, 1) drawn from `text`'s hash.
17
+ @param text The string to hash.
18
+ @param seed Varies the draw.
19
+ */
20
+ export declare function hashUnit(text: string, seed?: number): number;
21
+ /**
22
+ The angle, in degrees, a word is drawn at: `rotate` as a number, one of
23
+ an array of angles picked by the hash of the word's id (so a word keeps
24
+ its angle from draw to draw), or an accessor's return value. Anything
25
+ else, or a non-finite angle, draws the word horizontally.
26
+ @param rotate The chart's `rotate` setting.
27
+ @param d The word's row.
28
+ @param i The row's index.
29
+ @param id The word's id, hashed to pick from an array.
30
+ */
31
+ export declare function wordRotation(rotate: unknown, d: DataPoint, i: number, id: string): number;
@@ -0,0 +1,16 @@
1
+ /**
2
+ WordCloud's value accessor, `size`, which it stores on `viz._size` as
3
+ Plot and Network store theirs.
4
+ */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ import type { VizInstance } from "../viz/vizTypes.js";
7
+ /** A word's value accessor. */
8
+ export type SizeFn = (d: DataPoint, i?: number) => number;
9
+ /** The default `size`: each row's `value`. */
10
+ export declare const defaultSize: SizeFn;
11
+ /**
12
+ Each word's value, read through the chart's current `size` (so a later
13
+ `size` applies to rows already wrapped in tooltips and the legend).
14
+ @param viz The chart.
15
+ */
16
+ export declare function wordSize(viz: VizInstance): SizeFn;
@@ -0,0 +1,47 @@
1
+ /**
2
+ The paths WordCloud walks outward from a word's start, looking for a
3
+ spot where it fits.
4
+ */
5
+ /** The spiral a word walks: `"archimedean"` or `"rectangular"`. */
6
+ export type SpiralKind = "archimedean" | "rectangular";
7
+ /** A spiral's options. */
8
+ export interface SpiralOptions {
9
+ /** The area's width over its height, so the spiral fills it evenly. */
10
+ aspect?: number;
11
+ /** The angle, in radians, the spiral starts out at. */
12
+ phase?: number;
13
+ /** `1` to turn clockwise (on screen), `-1` counterclockwise. */
14
+ direction?: 1 | -1;
15
+ }
16
+ /** The step, in pixels, between consecutive points along the spiral. */
17
+ export declare const SPIRAL_STEP = 2;
18
+ /** The gap, in pixels, between the spiral's turns (along its shorter axis). */
19
+ export declare const SPIRAL_SPACING = 4;
20
+ /**
21
+ Coerces a `spiral` setting, falling back to `"archimedean"`.
22
+ @param value The setting.
23
+ */
24
+ export declare function spiralKind(value: unknown): SpiralKind;
25
+ /**
26
+ An Archimedean spiral: `point(n)` is the n-th point's offset from the
27
+ start, `[dx, dy]`, with consecutive points about `SPIRAL_STEP` pixels
28
+ apart (so the walk samples the far turns as finely as the near ones) and
29
+ the turns `SPIRAL_SPACING` pixels apart, stretched along x by `aspect`.
30
+ @param options The spiral's aspect, phase, and direction.
31
+ */
32
+ export declare function archimedeanSpiral(options?: SpiralOptions): (n: number) => [number, number];
33
+ /**
34
+ A rectangular spiral: `point(n)` walks around ever larger rectangles,
35
+ `SPIRAL_SPACING` pixels a step along y (and `aspect` times that along x),
36
+ turning a corner after 1, 1, 2, 2, 3, 3, … steps. Its points come back
37
+ in order, so call it with n = 0, 1, 2, ….
38
+ @param options The spiral's aspect and direction (its phase picks which
39
+ way it heads first, in quarter turns).
40
+ */
41
+ export declare function rectangularSpiral(options?: SpiralOptions): (n: number) => [number, number];
42
+ /**
43
+ The spiral of `kind`.
44
+ @param kind Which spiral.
45
+ @param options Its aspect, phase, and direction.
46
+ */
47
+ export declare function makeSpiral(kind: SpiralKind, options?: SpiralOptions): (n: number) => [number, number];
@@ -59,6 +59,13 @@ interface ChartDefinitionBase {
59
59
  links). Return null to show the data.
60
60
  */
61
61
  tableData?: (viz: VizInstance) => DataPoint[] | null;
62
+ /**
63
+ Optional rows whose `time` values the timeline lists and the starting
64
+ period is picked from, in place of the chart's data: for a chart whose
65
+ marks also come from rows outside it that carry a time (Network's
66
+ `nodes` and `links`).
67
+ */
68
+ timeRows?: (viz: VizInstance) => DataPoint[];
62
69
  /**
63
70
  Optional shape a colorScale row draws as, when it isn't the row's
64
71
  `shape`: the `shapeConfig` key the colorScale's bucket swatches take
@@ -72,6 +79,12 @@ interface ChartDefinitionBase {
72
79
  data-driven chart; Circle and Rect shapes for the Plot family).
73
80
  */
74
81
  pointMark?: (viz: VizInstance, node: SceneNode) => boolean;
82
+ /**
83
+ Optional test for the data marks a box or lasso selection picks (see
84
+ `selectMode`), for a chart whose scene holds marks that aren't its
85
+ rows (a Network's links). Without one, every data mark is selectable.
86
+ */
87
+ selectMark?: (viz: VizInstance, node: SceneNode) => boolean;
75
88
  /**
76
89
  Optional `groupBy` level a shape's row stands for, for a chart that
77
90
  draws several levels at once (a Sunburst's rings). The `tooltip`
@@ -0,0 +1,9 @@
1
+ /**
2
+ Whether a chart's own definition, or that of a chart it specializes
3
+ (see `makeChart`'s `Base`), declares the config field `key`, as
4
+ BumpChart's declares `discrete`. A chart that declares a field lays out
5
+ around it itself.
6
+ @param viz The chart.
7
+ @param key The config field.
8
+ */
9
+ export declare function declaresField(viz: object, key: string): boolean;
@@ -6,8 +6,8 @@
6
6
  `applyDefinition(this, def)`, its `_draw` runs the shared Viz pipeline
7
7
  then the chart's own layout stage via `runChartDraw`, and its
8
8
  `_thresholdFunction` / `_thresholdLegend` / `_sizeLegendScale` / `_insetRegion` /
9
- `_tableData` / `_colorScaleShape` / `_pointMark` / `_shapeDepth` delegate to `def.thresholdFunction` /
10
- `def.sizeLegendScale` / `def.insetRegion` / `def.tableData` / `def.colorScaleShape` /
9
+ `_tableData` / `_timeRows` / `_colorScaleShape` / `_pointMark` / `_shapeDepth` delegate to `def.thresholdFunction` /
10
+ `def.sizeLegendScale` / `def.insetRegion` / `def.tableData` / `def.timeRows` / `def.colorScaleShape` /
11
11
  `def.pointMark` / `def.shapeDepth` if
12
12
  present (else to the base chart's), `_facetHooks` layers `def.facet` over the base chart's, and
13
13
  `toScene` passes the base chart's scene through `def.decorateScene`.
@@ -16,8 +16,8 @@ type Point = [number, number];
16
16
  export declare function clientPoint(event: Event | null | undefined): Point | null;
17
17
  /**
18
18
  Whether a zoom gesture's source event moves the chart: a wheel, a touch
19
- move, or a mouse move away from where the press began. Programmatic zooms
20
- (no source event) and the press itself don't.
19
+ move, or a mouse or pointer move away from where the press began.
20
+ Programmatic zooms (no source event) and the press itself don't.
21
21
  @param press The press's client position, if the gesture began with one.
22
22
  @param source The event behind a d3-zoom "zoom" event.
23
23
  */
@@ -0,0 +1,11 @@
1
+ import type { SceneEvent } from "@d3plus/render";
2
+ import type { VizInstance } from "../viz/vizTypes.js";
3
+ /**
4
+ Whether a routed "mouseleave" leaves the whole chart: one the pointer
5
+ makes off the drawing surface, or the one a moving zoom gesture sends
6
+ (see `gestureHover.ts`), as opposed to the leave that crossing from one
7
+ node to the next fires ahead of its move.
8
+ @param viz The chart.
9
+ @param event The routed scene event.
10
+ */
11
+ export declare function leavesSurface(viz: Pick<VizInstance, "_gestureHover">, event: SceneEvent): boolean;
@@ -0,0 +1,58 @@
1
+ /**
2
+ Setting and clearing a chart's box or lasso selection: storing it,
3
+ repainting, announcing it to screen readers, and firing the chart's
4
+ `select` event.
5
+
6
+ @module
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { SceneEvent } from "@d3plus/render";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ import type { SelectPredicate } from "./selectState.js";
12
+ /** What a chart's selection can be set to: rows, a predicate, or nothing. */
13
+ export type SelectionValue = DataPoint[] | SelectPredicate | false | null;
14
+ /** Whether `viz` is the chart a viewer last selected in. */
15
+ export declare function lastSelectedChart(viz: VizInstance): boolean;
16
+ /** The rows a chart's selection holds among its marks (see `selectedRows`). */
17
+ export declare function currentSelection(viz: VizInstance): DataPoint[];
18
+ /** Whether a chart has a selection. */
19
+ export declare function hasSelection(viz: VizInstance): boolean;
20
+ /**
21
+ Stores a chart's selection and repaints: a predicate as given, rows as
22
+ a predicate matching them (and the series they belong to, see
23
+ `seriesRows`), or nothing for an empty array, `false`, or `null`.
24
+ @param viz The chart.
25
+ @param value The selection.
26
+ */
27
+ export declare function setSelection(viz: VizInstance, value: SelectionValue): void;
28
+ /**
29
+ A viewer's selection: combines `rows` with the current selection (see
30
+ `combineRows`), stores it, announces it, and fires the `select` event.
31
+ Returns the rows selected.
32
+ @param viz The chart.
33
+ @param rows The rows the gesture picked.
34
+ @param mode Replace the selection, add to it, or toggle the rows in it.
35
+ @param event The pointer or keyboard event behind the gesture.
36
+ */
37
+ export declare function selectRows(viz: VizInstance, rows: DataPoint[], mode: "replace" | "add" | "toggle", event?: Event | null): DataPoint[];
38
+ /**
39
+ A viewer clears the selection (Escape, or a click on no mark): clears
40
+ it, announces it, and fires the `select` event with no rows. Returns
41
+ false when there was nothing to clear.
42
+ @param viz The chart.
43
+ @param event The event behind it.
44
+ */
45
+ export declare function clearSelection(viz: VizInstance, event?: Event | null): boolean;
46
+ /**
47
+ A click on a chart mark while a select tool is on (or a keyboard Enter
48
+ on a focused mark) selects that mark's row, or with Shift toggles it in
49
+ the selection. Returns true for a click on a chart mark while a tool is
50
+ on, so the click goes no further (the chart's own click action, such as
51
+ drilling down, is skipped); a click on a mark the selection can't pick
52
+ then counts as a click on no mark, which clears the selection.
53
+ @param viz The chart.
54
+ @param event The routed pointer event.
55
+ @param row The row the clicked mark stands for.
56
+ @param legend Whether the mark is a legend entry (left to the legend).
57
+ */
58
+ export declare function selectClick(viz: VizInstance, event: SceneEvent, row: unknown, legend: boolean): boolean;
@@ -0,0 +1,60 @@
1
+ /**
2
+ The pointer gesture of box and lasso selection. While a select tool is
3
+ on (see `selectMode` and the zoom-control buttons), a drag over the
4
+ chart area draws a box or a lasso instead of panning, and releasing it
5
+ selects the marks inside (see `selectRegion.ts`); Shift adds them to
6
+ the selection. A press that doesn't drag is a click: on a mark it
7
+ selects that mark (see `selectClick`), and on no mark it clears the
8
+ selection. Escape cancels a drag in progress, and otherwise clears the
9
+ selection of the chart last selected in.
10
+
11
+ Pointer events drive it, so a mouse, a pen, and one finger all draw.
12
+ While a tool is on, the drawing surface takes every touch
13
+ (`touch-action: none`), and d3-zoom leaves single presses to it (see
14
+ `zoomGestureFilter`), so a wheel or a pinch still zooms.
15
+
16
+ @module
17
+ */
18
+ import type { FocusTarget } from "../viz/focusTargets.js";
19
+ import type { VizInstance } from "../viz/vizTypes.js";
20
+ import type { Box, Point } from "./zoomDrag.js";
21
+ /** The class of the layer the box or lasso draws in. */
22
+ export declare const SELECT_LAYER = "d3plus-select-brush";
23
+ /** The pointer surface a chart selects on, and the press in progress. */
24
+ export interface SelectSurfaceState {
25
+ /** The element the press listener is bound to. */
26
+ el: Element;
27
+ /** The latest press that didn't drag, until its click resolves. */
28
+ press?: {
29
+ clicked: boolean;
30
+ };
31
+ /** Whether this set the surface's `touch-action`. */
32
+ touch?: boolean;
33
+ /** The window the Escape listener is bound to. */
34
+ view?: Window;
35
+ }
36
+ /** The chart area, in surface coordinates. */
37
+ export declare function chartArea(viz: VizInstance): Box;
38
+ /**
39
+ The box a selection starting at `at` stays within: the chart area, or
40
+ within a small-multiples panel, that panel's chart area as it shows
41
+ (zoomed along with the picture).
42
+ @param viz The chart.
43
+ @param at The press, in surface coordinates.
44
+ */
45
+ export declare function selectArea(viz: VizInstance, at: Point): Box;
46
+ /**
47
+ The chart's data marks as they show on its surface: its scene under the
48
+ zoom and chart transforms and clipped to the chart area (the way
49
+ `Viz.toScene` composes it), before hover or selection dimming.
50
+ */
51
+ export declare function chartTargets(viz: VizInstance): FocusTarget[];
52
+ /**
53
+ Brings a chart's selecting surface in line with it after a paint: syncs
54
+ the select tool with `selectMode`, binds the press listener to the
55
+ surface (rebinding when the renderer replaces it), has the surface take
56
+ every touch while a tool is on, and listens for Escape.
57
+ @param viz The chart.
58
+ @param unbind Removes every listener (the chart is being destroyed).
59
+ */
60
+ export declare function syncSelectSurface(viz: VizInstance, unbind?: boolean): void;
@@ -0,0 +1,86 @@
1
+ /**
2
+ The geometry of box and lasso selection: the region a drag draws, and
3
+ which of a chart's marks fall inside it.
4
+
5
+ @module
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { Bounds } from "@d3plus/math";
9
+ import type { FocusTarget } from "../viz/focusTargets.js";
10
+ import type { Box, Point } from "./zoomDrag.js";
11
+ /** The kinds of region a drag draws: a box, or a freehand lasso. */
12
+ export type SelectTool = "box" | "lasso";
13
+ /** A drawn region, in surface coordinates. */
14
+ export interface SelectRegion {
15
+ tool: SelectTool;
16
+ /** The region's outline (a box's four corners, or the lasso's path). */
17
+ points: Point[];
18
+ }
19
+ /** How far (px) the pointer moves before a lasso takes another point. */
20
+ export declare const LASSO_STEP = 3;
21
+ /** A box's outline, clockwise from its top-left corner. */
22
+ export declare function boxPolygon([[x0, y0], [x1, y1]]: Box): Point[];
23
+ /**
24
+ The region a drag from `start` through `path` draws, clamped to `area`:
25
+ the box `start` and the last point span, or the lasso through every
26
+ point.
27
+ @param tool Which region to draw.
28
+ @param start Where the drag began.
29
+ @param path The points the pointer has moved through since.
30
+ @param area The box the region stays within (the chart area or a panel).
31
+ */
32
+ export declare function dragRegion(tool: SelectTool, start: Point, path: Point[], area: Box): SelectRegion;
33
+ /**
34
+ Adds `point` to a lasso's path unless it lies within `LASSO_STEP` of the
35
+ last one, which keeps a slow drag from piling up points.
36
+ @param path The lasso's points so far (changed in place).
37
+ @param point The pointer's position.
38
+ */
39
+ export declare function extendLasso(path: Point[], point: Point): Point[];
40
+ /** An SVG path string for a region's outline, closed. */
41
+ export declare function regionPath(region: SelectRegion): string;
42
+ /** The axis-aligned box around a region. */
43
+ export declare function regionBox(region: SelectRegion): Box;
44
+ /** Whether a point lies inside a region (a box's edges included). */
45
+ export declare function regionContains(region: SelectRegion, point: Point): boolean;
46
+ /**
47
+ Whether a box overlaps a region: a corner of either lies inside the
48
+ other, or their edges cross.
49
+ @param b The box, as `{x, y, width, height}`.
50
+ @param region The region.
51
+ */
52
+ export declare function boundsTouchRegion(b: Bounds, region: SelectRegion): boolean;
53
+ /**
54
+ The vertical extent of a polygon along the line `x`: the lowest and
55
+ highest points where its edges cross it, or null where it doesn't
56
+ reach.
57
+ @param polygon The polygon's outline.
58
+ @param x Where to slice it.
59
+ */
60
+ export declare function polygonSlice(polygon: Point[], x: number): [number, number] | null;
61
+ /**
62
+ Whether a mark falls inside a region: a bar or other rectangle when any
63
+ part of it overlaps the region, a point of an Area when the area's
64
+ height at that point crosses it, and every other mark (a point, a point
65
+ of a Line, a path) when its center does.
66
+ @param target The mark, as keyboard navigation reads it off the scene.
67
+ @param region The region.
68
+ @param outline For a point of an Area, the area's outline in surface coordinates.
69
+ */
70
+ export declare function targetInRegion(target: FocusTarget, region: SelectRegion, outline?: Point[]): boolean;
71
+ /** The source row a datum wraps (`datum.data ?? datum`). */
72
+ export declare function sourceRow(datum: unknown): DataPoint | undefined;
73
+ /** A mark a region selects: its row, and for a series point, its series' row. */
74
+ export interface RegionHit {
75
+ row: DataPoint;
76
+ /** The row of the Line or Area a selected point belongs to. */
77
+ series?: DataPoint;
78
+ }
79
+ /**
80
+ The marks among `targets` that fall inside a region (see
81
+ `targetInRegion`): one hit per mark, or per point of a Line or Area,
82
+ carrying the row it stands for.
83
+ @param targets The chart's marks (see `focusTargets`).
84
+ @param region The region.
85
+ */
86
+ export declare function regionHits(targets: FocusTarget[], region: SelectRegion): RegionHit[];