@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,90 @@
1
+ import { date } from "@d3plus/dom";
2
+ import { vizDiscrete } from "./discrete.js";
3
+ const MS = {
4
+ ms: 1,
5
+ millisecond: 1,
6
+ s: 1e3,
7
+ sec: 1e3,
8
+ second: 1e3,
9
+ m: 6e4,
10
+ min: 6e4,
11
+ minute: 6e4,
12
+ h: 36e5,
13
+ hr: 36e5,
14
+ hour: 36e5,
15
+ d: 864e5,
16
+ day: 864e5,
17
+ w: 6048e5,
18
+ week: 6048e5
19
+ };
20
+ /**
21
+ The milliseconds a time span names (`"5 minutes"`, `"90s"`, `"300000ms"`,
22
+ `"1.5 hours"`), or null when it isn't one. Units run from milliseconds
23
+ to weeks, singular, plural, or abbreviated (`ms`, `s`/`sec`, `m`/`min`,
24
+ `h`/`hr`, `d`, `w`).
25
+ @param span The span.
26
+ */ export function parseTimeSpan(span) {
27
+ const match = /^\s*(\d*\.?\d+)\s*([a-z]+)\s*$/i.exec(span);
28
+ if (!match) return null;
29
+ const unit = match[2].toLowerCase();
30
+ const ms = Object.hasOwn(MS, unit) ? MS[unit] : unit.endsWith("s") && Object.hasOwn(MS, unit.slice(0, -1)) ? MS[unit.slice(0, -1)] : undefined;
31
+ return ms === undefined ? null : Number(match[1]) * ms;
32
+ }
33
+ /**
34
+ The rows a window keeps, oldest first: the latest `window` rows for a
35
+ row count, or those whose `time` falls within a span of the latest
36
+ time. A row whose time can't be read is kept. Every row for a missing,
37
+ `false`, or unreadable window.
38
+ @param rows The rows, oldest first.
39
+ @param window The window.
40
+ @param time Reads a row's time, for a time span.
41
+ */ export function windowRows(rows, window, time) {
42
+ if (typeof window === "number") return window >= 0 && window < rows.length ? rows.slice(rows.length - Math.floor(window)) : rows;
43
+ if (typeof window !== "string" || !time) return rows;
44
+ const span = parseTimeSpan(window);
45
+ if (span === null) return rows;
46
+ const times = rows.map((d, i)=>{
47
+ const t = date(time(d, i));
48
+ return t instanceof Date ? +t : NaN;
49
+ });
50
+ let latest = -Infinity;
51
+ for (const t of times)if (t > latest) latest = t;
52
+ if (!Number.isFinite(latest)) return rows;
53
+ const from = latest - span;
54
+ return rows.filter((_, i)=>!(times[i] < from));
55
+ }
56
+ /**
57
+ The accessor a time-span window reads: the chart's `time`, else its
58
+ discrete axis's value (a LinePlot's `x`), else none.
59
+ @private
60
+ */ export function appendTime(viz) {
61
+ if (typeof viz.schema.time === "function") return viz.schema.time;
62
+ const axis = vizDiscrete(viz);
63
+ const fn = axis && viz[`_${axis}`];
64
+ return typeof fn === "function" ? fn : null;
65
+ }
66
+ /**
67
+ Adds rows to a chart's data, drops those outside the window, and
68
+ schedules one redraw for the next animation frame, however many appends
69
+ land before it. A timeline the user hasn't brushed re-defaults, so it
70
+ follows the latest period, as a polled update does.
71
+ @param viz The chart.
72
+ @param rows A row or rows to add, oldest first.
73
+ @param options The window to keep.
74
+ @private
75
+ */ export function appendData(viz, rows, options = {}) {
76
+ const added = (Array.isArray(rows) ? rows : [
77
+ rows
78
+ ]).filter((d)=>d != null);
79
+ viz._data = windowRows((viz._data ?? []).concat(added), options.window, appendTime(viz));
80
+ if (!viz.schema.timeFilter) viz._timelineSelection = false;
81
+ const host = viz;
82
+ if (host._appendDraw) return;
83
+ host._appendDraw = true;
84
+ const draw = ()=>{
85
+ host._appendDraw = false;
86
+ viz.render?.();
87
+ };
88
+ if (typeof requestAnimationFrame === "function") requestAnimationFrame(draw);
89
+ else setTimeout(draw, 0);
90
+ }
@@ -0,0 +1,19 @@
1
+ /**
2
+ Whether a new `data` value differs from the one it replaces. The same
3
+ value, or arrays of the same rows, are unchanged; arrays of different
4
+ lengths differ without comparing their rows, and others compare row by
5
+ row (as JSON) until one differs, so a stream of updates rarely reads
6
+ more than its first row.
7
+ @param next The new value.
8
+ @param prev The value it replaces.
9
+ @private
10
+ */ export function dataChanged(next, prev) {
11
+ if (next === prev) return false;
12
+ if (!Array.isArray(next) || !Array.isArray(prev)) return JSON.stringify(next) !== JSON.stringify(prev);
13
+ if (next.length !== prev.length) return true;
14
+ for(let i = 0; i < next.length; i++){
15
+ if (next[i] === prev[i]) continue;
16
+ if (JSON.stringify(next[i]) !== JSON.stringify(prev[i])) return true;
17
+ }
18
+ return false;
19
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ A chart's discrete axis: its `discrete` setting, else the axis a Plot
3
+ inferred from its data (see `_discrete`).
4
+ */ /** What `vizDiscrete` reads of a chart. */ /**
5
+ The discrete axis a chart draws with: its `discrete` setting, else the
6
+ one its last draw inferred (a Plot infers one from text values, see
7
+ `Plot/inferDiscrete.ts`). Typed as the chart's `discrete` setting is.
8
+ @param viz The chart.
9
+ */ export const vizDiscrete = (viz)=>viz.schema.discrete ?? viz._discrete;
@@ -12,7 +12,8 @@ import { MARK_TYPES } from "./sceneRows.js";
12
12
  /** Interaction groups that are chart chrome rather than data marks. */ const CHROME_GROUPS = new Set([
13
13
  "axis",
14
14
  "timeline",
15
- "trend"
15
+ "trend",
16
+ "marginal"
16
17
  ]);
17
18
  /** Whether a node (and everything inside it) is out of keyboard reach. */ function skipped(node) {
18
19
  const n = node;
@@ -114,8 +115,11 @@ const finite = (b)=>[
114
115
  clip hides (a zoomed chart's off-screen marks). A Line or Area node
115
116
  becomes one target per point, and a row drawn by several nodes counts
116
117
  once.
118
+ A chart's `tabStop` test adds its Tab stops wherever they are, chrome
119
+ included.
117
120
  @param nodes The scene root's children (`viz._paintedScene.root.children`).
118
- */ export function focusTargets(nodes) {
121
+ @param tabStop The chart's Tab stop test, if it has one.
122
+ */ export function focusTargets(nodes, tabStop) {
119
123
  const lists = {
120
124
  shape: [],
121
125
  legend: []
@@ -124,8 +128,21 @@ const finite = (b)=>[
124
128
  const group = ROOT_GROUPS[String(top.key)];
125
129
  if (!group) continue;
126
130
  const seen = new Set();
127
- const walk = (node, chain, clips)=>{
128
- if (skipped(node)) return;
131
+ const ancestors = [];
132
+ // Inside chrome, only the chart's Tab stops are visited.
133
+ const walk = (node, chain, clips, chrome = false)=>{
134
+ const label = tabStop?.(node, ancestors);
135
+ if (label !== undefined) {
136
+ const target = markTarget(node, chain, group);
137
+ if (target && clips.every((c)=>inside(target.center, c))) lists[group].push({
138
+ ...target,
139
+ tab: true,
140
+ label
141
+ });
142
+ return;
143
+ }
144
+ const skip = skipped(node);
145
+ if (skip && !(tabStop && node.type === "group")) return;
129
146
  if (node.type === "group") {
130
147
  const next = node.transform ? [
131
148
  ...chain,
@@ -136,9 +153,12 @@ const finite = (b)=>[
136
153
  ...clips,
137
154
  mapBox(clip, mapper(next))
138
155
  ] : clips;
139
- for (const child of node.children)walk(child, next, inner);
156
+ ancestors.push(node);
157
+ for (const child of node.children)walk(child, next, inner, chrome || skip);
158
+ ancestors.pop();
140
159
  return;
141
160
  }
161
+ if (chrome) return;
142
162
  if (!MARK_TYPES.has(node.type) || node.datum === undefined) return;
143
163
  if (node.paint?.opacity === 0) return;
144
164
  const visible = (t)=>clips.every((c)=>inside(t.center, c));
@@ -0,0 +1,48 @@
1
+ /**
2
+ A function in `groupBy` reads a row's fields, but merging rows (for the
3
+ legend, a Treemap's group headers, a threshold bucket, …) sums their
4
+ numbers and lists their strings, so the function read on a merged row
5
+ can name another group. Each merged row keeps the value the function
6
+ gave its rows, under a key of its own (`groupLevelKey`), and the
7
+ accessor `groupBy` installs reads it back.
8
+ */ import { unique } from "@d3plus/data";
9
+ import { INTERNAL_KEY_PREFIX } from "../features/shareKey.js";
10
+ /** The row key a merged row keeps groupBy level `level`'s value under. */ export const groupLevelKey = (level)=>`${INTERNAL_KEY_PREFIX}GroupBy${level}`;
11
+ /** The accessors `groupLevelAccessor` made. */ const levelAccessors = new WeakSet();
12
+ /** One value when every item is the same, else the unique items. */ function collapse(values) {
13
+ const flat = unique(values.flat());
14
+ return flat.length === 1 ? flat[0] : flat;
15
+ }
16
+ /**
17
+ The accessor `groupBy` installs for a function at level `level`: the
18
+ value a merged row kept for the level, else the function's.
19
+ @param fn The user's function.
20
+ @param level Its groupBy level.
21
+ */ export function groupLevelAccessor(fn, level) {
22
+ const key = groupLevelKey(level);
23
+ const accessor = (d, i)=>d && typeof d === "object" && key in d ? d[key] : fn(d, i);
24
+ levelAccessors.add(accessor);
25
+ return accessor;
26
+ }
27
+ /**
28
+ The `aggs` entry that merges a level's kept values: the one they share,
29
+ else the unique ones.
30
+ @param rows The rows being merged.
31
+ @param value Reads a row's kept value.
32
+ */ export function groupLevelAgg(rows, value) {
33
+ return collapse(rows.map(value));
34
+ }
35
+ /**
36
+ Keeps on `merged` the value each function in `groupBy` gives `leaves`,
37
+ the rows it merges.
38
+ @param groupBy The chart's groupBy accessors.
39
+ @param merged The merged row.
40
+ @param leaves The rows it merges.
41
+ @param index Each leaf's index in the chart's data.
42
+ */ export function keepGroupLevels(groupBy, merged, leaves, index) {
43
+ if (leaves.includes(merged)) return;
44
+ groupBy.forEach((accessor, level)=>{
45
+ if (!levelAccessors.has(accessor)) return;
46
+ merged[groupLevelKey(level)] = collapse(leaves.map((leaf)=>accessor(leaf, index(leaf))));
47
+ });
48
+ }
@@ -33,3 +33,30 @@
33
33
  /** Whether `rows` hold any row outside the group at `path`, so zooming into it narrows the view. */ export function groupNarrows(groupBy, path, rows) {
34
34
  return rows.some((d, i)=>!inGroup(groupBy, path, d, i));
35
35
  }
36
+ /** A key, or a merged row's keys, as a list. */ const keyList = (v)=>Array.isArray(v) ? v : [
37
+ v
38
+ ];
39
+ /**
40
+ Whether a row shares a key with any of `rows` at every `groupBy` level
41
+ down to `depth` (a merged row holds each key in its array): the legend
42
+ entry a chart's lit marks belong to.
43
+ */ export function sharesGroup(groupBy, depth, rows) {
44
+ const levels = groupBy.slice(0, depth + 1);
45
+ const keysOf = (d, i)=>{
46
+ const row = unwrap(d);
47
+ if (!row) return undefined;
48
+ const keys = levels.map((g)=>keyList(g(row, i)).filter((k)=>k != null));
49
+ return keys.every((k)=>k.length) ? keys : undefined;
50
+ };
51
+ const paths = new Map();
52
+ rows.forEach((d, i)=>{
53
+ const keys = keysOf(d, i);
54
+ if (keys) paths.set(JSON.stringify(keys), keys);
55
+ });
56
+ return (d, i)=>{
57
+ const keys = keysOf(d, i);
58
+ if (!keys) return false;
59
+ for (const path of paths.values())if (path.every((p, j)=>p.some((k)=>keys[j].includes(k)))) return true;
60
+ return false;
61
+ };
62
+ }
@@ -0,0 +1,40 @@
1
+ /**
2
+ Which bar's hover band shows: the row the pointer or keyboard focus rests
3
+ on, while it rests on a chart mark (a bar or its slot), with or without
4
+ hover styling. A change repaints the chart when its scene draws bands.
5
+
6
+ @module
7
+ */ import { setCursor } from "./setCursor.js";
8
+ /** Whether a scene (or any node inside it) draws a hover band. */ export function drawsBands(nodes) {
9
+ return (nodes ?? []).some((n)=>n.hoverPaint !== undefined || drawsBands(n.children));
10
+ }
11
+ /** The scenes known to draw bands, read once each. */ const banded = new WeakMap();
12
+ /** The row whose band the pointer or keyboard focus calls for, if any. */ export function hoverBandRow(viz) {
13
+ const pick = viz._lastScenePick;
14
+ return pick && !pick.isLegend ? pick.d : undefined;
15
+ }
16
+ /** Shows the band of `row`, repainting a chart that draws bands when asked. */ function showBand(viz, row, repaint) {
17
+ if (row === viz._hoverBandRow) return;
18
+ viz._hoverBandRow = row;
19
+ const scene = viz._chartScene;
20
+ if (!repaint || !scene) return;
21
+ if (!banded.has(scene)) banded.set(scene, drawsBands(scene));
22
+ if (banded.get(scene)) viz._scheduleSceneRepaint?.();
23
+ }
24
+ /**
25
+ Records the row whose band shows (`_hoverBandRow`) and repaints the
26
+ chart when it changes, if the chart's scene draws bands.
27
+ @param viz The chart.
28
+ */ export function syncHoverBand(viz) {
29
+ showBand(viz, hoverBandRow(viz), true);
30
+ }
31
+ /**
32
+ The pointer leaves a mark: the default cursor and no band, at once.
33
+ While a transition holds the leave handlers, the band goes without a
34
+ repaint, which would cut the transition short.
35
+ @param viz The chart.
36
+ */ export function leaveMark(viz) {
37
+ setCursor(viz, "auto");
38
+ const moving = !!viz._transitionEndsAt && Date.now() < viz._transitionEndsAt;
39
+ showBand(viz, undefined, !moving);
40
+ }
@@ -11,10 +11,12 @@
11
11
  import { colorGrayscale } from "@d3plus/color";
12
12
  import { activeBucketColors } from "../features/colorScaleBucket.js";
13
13
  import { hoveredSwatch } from "../features/colorScaleHover.js";
14
+ import { SWATCH_OUTLINE } from "../features/swatchPaint.js";
14
15
  import { datumValues } from "../features/hoverTicks.js";
15
16
  import { STROKE_EMPHASIS } from "./emphasis.js";
17
+ import { sharesGroup } from "./groupRow.js";
18
+ import { liftRaised, RAISE_Z } from "./liftRaised.js";
16
19
  import { MARK_TYPES } from "./sceneRows.js";
17
- /** z value that floats a hovered/highlighted node above its (z-less, i.e. 0) siblings. */ const HOVER_RAISE_Z = 1e6;
18
20
  /**
19
21
  Emphasizes a matched mark's stroke on hover/active — the v3 `hoverStyle` /
20
22
  `activeStyle` look (a thicker, darker outline). v4 paints from the scene
@@ -23,8 +25,10 @@ import { MARK_TYPES } from "./sceneRows.js";
23
25
  0/absent width as 1, matching the shape defaults; see `STROKE_EMPHASIS`).
24
26
  A path with an `emphasis` takes its `d` for the kind, and a filled glyph
25
27
  (an arrowhead) darkens its fill instead, so it stays the color of its
26
- edge's stroke. Non-mark nodes (labels, groups) are untouched.
27
- */ function emphasizeStroke(node, kind) {
28
+ edge's stroke. A legend swatch (`swatch`) keeps its 1px outline width and
29
+ takes only the darker color. Non-mark nodes (labels, groups) are
30
+ untouched.
31
+ */ function emphasizeStroke(node, kind, swatch = false) {
28
32
  const { darken, width } = STROKE_EMPHASIS[kind];
29
33
  const paint = {
30
34
  ...node.paint ?? {}
@@ -51,12 +55,39 @@ import { MARK_TYPES } from "./sceneRows.js";
51
55
  const c = color(base);
52
56
  if (c) paint.stroke = c.darker(darken).formatHex();
53
57
  const w = typeof paint.strokeWidth === "number" && paint.strokeWidth ? paint.strokeWidth : 1;
54
- paint.strokeWidth = w * width;
58
+ paint.strokeWidth = swatch ? SWATCH_OUTLINE : w * width;
55
59
  return {
56
60
  ...shaped,
57
61
  paint
58
62
  };
59
63
  }
64
+ /**
65
+ A node with a `hoverPaint` (a bar's hit area), with it laid over its
66
+ paint while the pointer or keyboard rests on its row (`_hoverBandRow`):
67
+ the bar under the pointer, not every row a hover lights (a series, a
68
+ stacked column, a legend entry). Never dimmed or raised, the band stays
69
+ behind the marks.
70
+ */ function hoverBand(node, viz) {
71
+ const row = viz._hoverBandRow;
72
+ return row !== undefined && nodeMatches(node, (d)=>d === row) ? {
73
+ ...node,
74
+ paint: {
75
+ ...node.paint,
76
+ ...node.hoverPaint
77
+ }
78
+ } : node;
79
+ }
80
+ /** Shows the hover bands under a node, with no other interaction set. */ function bandsIn(viz) {
81
+ const walk = (node)=>{
82
+ if (node.hoverPaint) return hoverBand(node, viz);
83
+ const kids = node.children;
84
+ return kids && kids.length ? {
85
+ ...node,
86
+ children: kids.map(walk)
87
+ } : node;
88
+ };
89
+ return walk;
90
+ }
60
91
  /**
61
92
  Reads the interaction predicate + treatment off a viz, or null when nothing
62
93
  is set. Precedence: transient `hover`, then `active`, then the standing
@@ -66,10 +97,21 @@ import { MARK_TYPES } from "./sceneRows.js";
66
97
  const hover = typeof viz._hover === "function" ? viz._hover : null;
67
98
  const active = typeof viz._active === "function" ? viz._active : null;
68
99
  const highlight = typeof viz._highlight === "function" ? viz._highlight : null;
69
- if (!hover && !active && !highlight) return null;
100
+ const selection = typeof viz._selection === "function" ? viz._selection : null;
101
+ if (!hover && !active && !highlight && !selection) return null;
70
102
  const sc = viz.schema.shapeConfig ?? {};
71
103
  let hoverOpacity = typeof sc.hoverOpacity === "number" ? sc.hoverOpacity : 0.5;
72
104
  const activeOpacity = typeof sc.activeOpacity === "number" ? sc.activeOpacity : 0.25;
105
+ // A selection holds its marks lit while the pointer moves over the chart:
106
+ // a hovered mark only takes the hover outline. `active` still wins.
107
+ if (selection && !active) return {
108
+ predicate: selection,
109
+ dimOpacity: activeOpacity,
110
+ gray: false,
111
+ kind: "select",
112
+ activePredicate: null,
113
+ hoverPredicate: hover
114
+ };
73
115
  const gray = !hover && !active;
74
116
  // A colorScale bucket hover must dim the non-matching marks to read as a
75
117
  // highlight, even on charts (Geomap) that set hoverOpacity:1 to keep a plain
@@ -78,7 +120,6 @@ import { MARK_TYPES } from "./sceneRows.js";
78
120
  return {
79
121
  predicate: hover ?? active ?? highlight,
80
122
  dimOpacity: hover ? hoverOpacity : active ? activeOpacity : 1,
81
- isHover: !!hover,
82
123
  gray,
83
124
  kind: hover ? "hover" : active ? "active" : "highlight",
84
125
  // The active predicate is exposed even when hover wins the dim pass, so a
@@ -173,6 +214,16 @@ import { MARK_TYPES } from "./sceneRows.js";
173
214
  return matchesChain(predicate, d, typeof d.i === "number" ? d.i : k);
174
215
  });
175
216
  }
217
+ /**
218
+ The rows of a matched multi-point mark's `points` that `predicate`
219
+ matches. A mark with a datum of its own (a Line or Area, whose datum is
220
+ its points' merged aggregate) matched as a whole, so it gives every
221
+ point's row when no single point matches.
222
+ */ export function pointRows(points, predicate, whole) {
223
+ const rows = points.map((p)=>p.datum);
224
+ const own = rows.filter((d, k)=>matchesChain(predicate, d, typeof d.i === "number" ? d.i : k));
225
+ return own.length || !whole ? own : rows;
226
+ }
176
227
  /** Each `field` the scene's `hoverMatch` labels ask about. */ function hoverFields(nodes, out = new Set()) {
177
228
  for (const node of nodes){
178
229
  if (node.hoverMatch) out.add(node.hoverMatch.field);
@@ -183,8 +234,9 @@ import { MARK_TYPES } from "./sceneRows.js";
183
234
  }
184
235
  /**
185
236
  The values the marks `predicate` matches hold under each of `fields`
186
- (as strings), for the `hoverMatch` labels. Chrome is skipped: axis and
187
- timeline subtrees, and the labels themselves.
237
+ (as strings), for the `hoverMatch` labels, read off a multi-point mark's
238
+ points (see `pointRows`). Chrome is skipped: axis and timeline subtrees,
239
+ and the labels themselves.
188
240
  */ function matchedValues(nodes, predicate, fields) {
189
241
  const out = new Map([
190
242
  ...fields
@@ -200,8 +252,9 @@ import { MARK_TYPES } from "./sceneRows.js";
200
252
  if (group === "axis" || group === "timeline" || node.hoverMatch) return;
201
253
  if (nodeMatches(node, predicate)) {
202
254
  if (node.hoverKeys) add(node.hoverKeys);
203
- if (node.datum) add(node.datum);
204
- else for (const p of node.interactionPoints ?? [])if (matchesChain(predicate, p.datum, 0)) add(p.datum);
255
+ const points = node.interactionPoints ?? [];
256
+ if (points.length) pointRows(points, predicate, !!node.datum).forEach(add);
257
+ else add(node.datum);
205
258
  }
206
259
  const kids = node.children;
207
260
  if (kids) kids.forEach(walk);
@@ -209,6 +262,35 @@ import { MARK_TYPES } from "./sceneRows.js";
209
262
  nodes.forEach(walk);
210
263
  return out;
211
264
  }
265
+ /** The rows of the marks in `nodes` that `predicate` matches, chrome skipped. */ function matchedRows(nodes, predicate) {
266
+ const rows = [];
267
+ const walk = (node)=>{
268
+ const group = node.interactionGroup;
269
+ if (group === "axis" || group === "timeline" || node.hoverMatch) return;
270
+ if (nodeMatches(node, predicate)) {
271
+ const datum = node.datum;
272
+ if (datum) rows.push(datum.data ?? datum);
273
+ else for (const p of node.interactionPoints ?? [])if (matchesChain(predicate, p.datum, 0)) rows.push(p.datum);
274
+ }
275
+ const kids = node.children;
276
+ if (kids) kids.forEach(walk);
277
+ };
278
+ nodes.forEach(walk);
279
+ return rows;
280
+ }
281
+ /**
282
+ `predicate` for a legend: an entry also matches while a mark in `marks`
283
+ that `predicate` matches belongs to it (see `sharesGroup`), so a hover on
284
+ a chart's own rows (a nested node, a merged group row) reaches the entry
285
+ its group falls under.
286
+ */ function followMarks(viz, predicate, marks) {
287
+ let member;
288
+ return (d, i)=>{
289
+ if (predicate(d, i)) return true;
290
+ member ??= sharesGroup(viz.schema.groupBy, viz._legendDepth ?? 0, matchedRows(marks, predicate));
291
+ return member(d, i);
292
+ };
293
+ }
212
294
  /** The values `rows` hold under each of `fields` (see `_hoverFocus`). */ function focusValues(rows, fields) {
213
295
  return new Map([
214
296
  ...fields
@@ -217,13 +299,27 @@ import { MARK_TYPES } from "./sceneRows.js";
217
299
  new Set(rows.flatMap((r)=>datumValues(r, f)))
218
300
  ]));
219
301
  }
220
- export function applyInteractionOpacity(nodes, viz) {
302
+ /**
303
+ Dims a legend's entries the way `applyInteractionOpacity` dims chart
304
+ marks, keeping an entry lit while a lit mark in the chart's scene
305
+ belongs to it.
306
+ */ export function applyLegendOpacity(legend, viz) {
307
+ return applyInteractionOpacity([
308
+ legend
309
+ ], viz, viz._chartScene ?? [])[0];
310
+ }
311
+ /**
312
+ Dims the nodes the chart's predicate leaves out. Given `marks`, `nodes`
313
+ are a legend's (see `applyLegendOpacity`), whose emphasized swatches keep
314
+ their 1px outline.
315
+ */ export function applyInteractionOpacity(nodes, viz, marks) {
221
316
  // Precedence (hover → active → highlight) and the dim-vs-gray treatment are
222
317
  // resolved once in dimSettings; picking one source avoids ambiguous
223
318
  // compounding when several are momentarily set.
224
319
  const settings = dimSettings(viz);
225
- if (!settings) return nodes;
226
- const { predicate, dimOpacity, isHover, gray, kind, activePredicate } = settings;
320
+ if (!settings) return viz._hoverBandRow === undefined ? nodes : nodes.map(bandsIn(viz));
321
+ const { dimOpacity, gray, kind, activePredicate, hoverPredicate } = settings;
322
+ const predicate = marks ? followMarks(viz, settings.predicate, marks) : settings.predicate;
227
323
  const fields = hoverFields(nodes);
228
324
  const focus = viz._hoverFocus;
229
325
  const values = !fields.size ? null : focus && kind === "hover" && focus.hover === viz._hover ? focusValues(focus.rows, fields) : matchedValues(nodes, predicate, fields);
@@ -236,7 +332,9 @@ export function applyInteractionOpacity(nodes, viz) {
236
332
  ...paint
237
333
  };
238
334
  if (typeof paint.fill === "string") next2.fill = colorGrayscale(paint.fill);
239
- if (typeof paint.stroke === "string") next2.stroke = colorGrayscale(paint.stroke);
335
+ // A text halo's stroke is the chart's background, not the mark's color.
336
+ const halo = node.type === "text" && node.halo;
337
+ if (typeof paint.stroke === "string" && !halo) next2.stroke = colorGrayscale(paint.stroke);
240
338
  return {
241
339
  ...node,
242
340
  paint: next2
@@ -255,6 +353,7 @@ export function applyInteractionOpacity(nodes, viz) {
255
353
  const { field, value } = node.hoverMatch;
256
354
  return values?.get(field)?.has(String(value)) ? node : fade(node);
257
355
  };
356
+ /** A hover band shows whatever else is active, highlighted or selected. */ const band = (node)=>hoverBand(node, viz);
258
357
  /** Chrome keeps full opacity, all but its `hoverMatch` labels. */ const chrome = (node)=>{
259
358
  if (node.hoverMatch) return label(node);
260
359
  const kids = node.children;
@@ -270,6 +369,7 @@ export function applyInteractionOpacity(nodes, viz) {
270
369
  const group = node.interactionGroup;
271
370
  if (group === "axis" || group === "timeline") return chrome(node);
272
371
  if (node.hoverMatch) return label(node);
372
+ if (node.hoverPaint) return band(node);
273
373
  let next = node;
274
374
  const matched = nodeMatches(node, predicate);
275
375
  if (matched !== null) {
@@ -281,24 +381,28 @@ export function applyInteractionOpacity(nodes, viz) {
281
381
  // (not labels/groups). Highlight keeps its color-vs-gray treatment and
282
382
  // adds no outline. An active node keeps the stronger active stroke even
283
383
  // while hovered, rather than dropping to the thinner hover stroke.
284
- if (kind !== "highlight" && MARK_TYPES.has(node.type)) {
384
+ if (kind === "select") {
385
+ if (hoverPredicate && MARK_TYPES.has(node.type) && nodeMatches(node, hoverPredicate)) next = emphasizeStroke(node, "hover", !!marks);
386
+ } else if (kind !== "highlight" && MARK_TYPES.has(node.type)) {
285
387
  const active = kind === "active" || (activePredicate ? nodeMatches(node, activePredicate) === true : false);
286
- next = emphasizeStroke(node, active ? "active" : "hover");
287
- }
288
- if (isHover) {
289
- // Raise the hovered node above its siblings. Both renderers paint by
290
- // ascending `z`; restore is automatic — the next repaint rebuilds the
291
- // scene with no `z`. A matched mark's data label matches too (see
292
- // `matchesChain`), so it's raised with its mark and, emitted after it,
293
- // still paints on top. Only for hover: highlight relies on
294
- // color-vs-gray, not z-order.
295
- next = {
296
- ...next,
297
- z: HOVER_RAISE_Z
298
- };
388
+ next = emphasizeStroke(node, active ? "active" : "hover", !!marks);
299
389
  }
390
+ // Raise the matched node above its siblings. Both renderers paint by
391
+ // ascending `z`; restore is automatic — the next repaint rebuilds the
392
+ // scene with no `z`. A matched mark's data label matches too (see
393
+ // `matchesChain`), so it's raised with its mark and, emitted after it,
394
+ // still paints on top.
395
+ next = {
396
+ ...next,
397
+ z: RAISE_Z
398
+ };
300
399
  }
301
400
  }
401
+ // A label drawn outside its shape stays over the raised marks.
402
+ if (node.aboveRaised) next = {
403
+ ...next,
404
+ z: RAISE_Z + 1
405
+ };
302
406
  const kids = next.children;
303
407
  if (kids && kids.length) {
304
408
  next = {
@@ -308,5 +412,6 @@ export function applyInteractionOpacity(nodes, viz) {
308
412
  }
309
413
  return next;
310
414
  };
311
- return nodes.map(walk);
415
+ // A raised mark inside a Plot's clip groups comes out in front of them.
416
+ return liftRaised(nodes.map(walk));
312
417
  }