@d3plus/core 4.11.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 (988) hide show
  1. package/es/index.js +2 -2
  2. package/es/internal.js +167 -23
  3. package/es/src/charts/Alluvial/emit.js +5 -4
  4. package/es/src/charts/Alluvial/index.js +7 -1
  5. package/es/src/charts/Alluvial/titles.js +24 -4
  6. package/es/src/charts/ArcDiagram/applyLayout.js +17 -10
  7. package/es/src/charts/ArcDiagram/arcGeometry.js +21 -8
  8. package/es/src/charts/ArcDiagram/arcLoops.js +5 -2
  9. package/es/src/charts/ArcDiagram/arcNodeBox.js +89 -0
  10. package/es/src/charts/ArcDiagram/emit.js +81 -38
  11. package/es/src/charts/ArcDiagram/events.js +16 -8
  12. package/es/src/charts/ArcDiagram/index.js +3 -1
  13. package/es/src/charts/BarChart/index.js +14 -10
  14. package/es/src/charts/BoxWhisker/extras.js +95 -0
  15. package/es/src/charts/BoxWhisker/index.js +77 -6
  16. package/es/src/charts/BoxWhisker/outliers.js +3 -2
  17. package/es/src/charts/BoxWhisker/summary.js +14 -3
  18. package/es/src/charts/BoxWhisker/tooltip.js +114 -29
  19. package/es/src/charts/BubbleChart/emit.js +9 -5
  20. package/es/src/charts/BubbleMatrix/colorDefaults.js +58 -0
  21. package/es/src/charts/BubbleMatrix/index.js +52 -0
  22. package/es/src/charts/Bullet/emit.js +3 -2
  23. package/es/src/charts/BumpChart/areaBump.js +175 -0
  24. package/es/src/charts/BumpChart/index.js +84 -18
  25. package/es/src/charts/Calendar/applyLayout.js +1 -1
  26. package/es/src/charts/Calendar/calendarDates.js +21 -7
  27. package/es/src/charts/Calendar/emit.js +3 -2
  28. package/es/src/charts/Calendar/index.js +16 -1
  29. package/es/src/charts/Candlestick/index.js +6 -11
  30. package/es/src/charts/Candlestick/periods.js +52 -29
  31. package/es/src/charts/Candlestick/tooltip.js +5 -7
  32. package/es/src/charts/Chord/emit.js +3 -2
  33. package/es/src/charts/ConnectedScatter/index.js +39 -0
  34. package/es/src/charts/CyclePlot/cycleFacet.js +162 -0
  35. package/es/src/charts/CyclePlot/cycleMeans.js +54 -0
  36. package/es/src/charts/CyclePlot/cyclePeriods.js +99 -0
  37. package/es/src/charts/CyclePlot/cycleTooltip.js +67 -0
  38. package/es/src/charts/CyclePlot/index.js +197 -0
  39. package/es/src/charts/DensityPlot/densityCurves.js +139 -0
  40. package/es/src/charts/DensityPlot/densityPoint.js +10 -0
  41. package/es/src/charts/DensityPlot/index.js +235 -0
  42. package/es/src/charts/DensityPlot/rug.js +144 -0
  43. package/es/src/charts/DotPlot/dotLayout.js +165 -0
  44. package/es/src/charts/DotPlot/facetSize.js +40 -0
  45. package/es/src/charts/DotPlot/index.js +173 -0
  46. package/es/src/charts/DotPlot/placements.js +121 -0
  47. package/es/src/charts/DotPlot/tooltip.js +68 -0
  48. package/es/src/charts/Dumbbell/arrowGrays.js +46 -0
  49. package/es/src/charts/Dumbbell/categoryChange.js +124 -0
  50. package/es/src/charts/Dumbbell/changeEmit.js +291 -0
  51. package/es/src/charts/Dumbbell/changes.js +87 -0
  52. package/es/src/charts/Dumbbell/connectors.js +46 -0
  53. package/es/src/charts/Dumbbell/emit.js +51 -50
  54. package/es/src/charts/Dumbbell/gapSort.js +2 -1
  55. package/es/src/charts/Dumbbell/index.js +121 -5
  56. package/es/src/charts/Funnel/emit.js +3 -2
  57. package/es/src/charts/Gantt/applyLayout.js +33 -13
  58. package/es/src/charts/Gantt/criticalPath.js +202 -0
  59. package/es/src/charts/Gantt/emit.js +49 -15
  60. package/es/src/charts/Gantt/ganttCalendar.js +54 -0
  61. package/es/src/charts/Gantt/ganttCritical.js +106 -0
  62. package/es/src/charts/Gantt/ganttDecor.js +183 -60
  63. package/es/src/charts/Gantt/ganttSlack.js +14 -0
  64. package/es/src/charts/Gantt/ganttTooltip.js +91 -36
  65. package/es/src/charts/Gantt/index.js +59 -10
  66. package/es/src/charts/Gauge/emit.js +3 -2
  67. package/es/src/charts/Geomap/applyLayout.js +177 -19
  68. package/es/src/charts/Geomap/cartogram.js +50 -0
  69. package/es/src/charts/Geomap/cartogramContiguous.js +196 -0
  70. package/es/src/charts/Geomap/cartogramFields.js +63 -0
  71. package/es/src/charts/Geomap/cartogramLabels.js +109 -0
  72. package/es/src/charts/Geomap/cartogramLayout.js +186 -0
  73. package/es/src/charts/Geomap/cartogramLegend.js +73 -0
  74. package/es/src/charts/Geomap/cartogramRelax.js +251 -0
  75. package/es/src/charts/Geomap/densityEmit.js +93 -0
  76. package/es/src/charts/Geomap/densityFields.js +69 -0
  77. package/es/src/charts/Geomap/densityLayout.js +90 -0
  78. package/es/src/charts/Geomap/densityTooltip.js +98 -0
  79. package/es/src/charts/Geomap/dotDensity.js +157 -0
  80. package/es/src/charts/Geomap/dotDensityLayout.js +116 -0
  81. package/es/src/charts/Geomap/dotRenderer.js +49 -0
  82. package/es/src/charts/Geomap/drillDown.js +216 -0
  83. package/es/src/charts/Geomap/drillEmit.js +64 -0
  84. package/es/src/charts/Geomap/drillEvents.js +108 -0
  85. package/es/src/charts/Geomap/emit.js +64 -42
  86. package/es/src/charts/Geomap/flowEmit.js +36 -15
  87. package/es/src/charts/Geomap/flowEvents.js +3 -1
  88. package/es/src/charts/Geomap/flowFields.js +2 -2
  89. package/es/src/charts/Geomap/flowLinks.js +18 -10
  90. package/es/src/charts/Geomap/geoHexbin.js +144 -0
  91. package/es/src/charts/Geomap/geoHexbinZoom.js +110 -0
  92. package/es/src/charts/Geomap/index.js +71 -116
  93. package/es/src/charts/Geomap/pointCluster.js +246 -0
  94. package/es/src/charts/Geomap/pointClusterEmit.js +385 -0
  95. package/es/src/charts/Geomap/pointClusterLayout.js +170 -0
  96. package/es/src/charts/Geomap/pointClusterLinks.js +95 -0
  97. package/es/src/charts/Geomap/pointClusterZoom.js +253 -0
  98. package/es/src/charts/Geomap/pointLabels.js +12 -4
  99. package/es/src/charts/Geomap/pointRows.js +25 -0
  100. package/es/src/charts/Geomap/tileGrid.js +468 -0
  101. package/es/src/charts/Geomap/tileState.js +41 -0
  102. package/es/src/charts/Geomap/topojsonFluent.js +96 -0
  103. package/es/src/charts/Geomap/topojsonLevels.js +16 -0
  104. package/es/src/charts/Hexbin/contourLabels.js +25 -17
  105. package/es/src/charts/Hexbin/index.js +4 -1
  106. package/es/src/charts/Histogram/binData.js +5 -1
  107. package/es/src/charts/Histogram/index.js +4 -26
  108. package/es/src/charts/HorizonChart/emit.js +147 -0
  109. package/es/src/charts/HorizonChart/horizonBands.js +117 -0
  110. package/es/src/charts/HorizonChart/horizonColors.js +30 -0
  111. package/es/src/charts/HorizonChart/hover.js +147 -0
  112. package/es/src/charts/HorizonChart/index.js +220 -0
  113. package/es/src/charts/HorizonChart/measure.js +91 -0
  114. package/es/src/charts/HorizonChart/rowFilter.js +250 -0
  115. package/es/src/charts/HorizonChart/state.js +64 -0
  116. package/es/src/charts/Icicle/emit.js +3 -2
  117. package/es/src/charts/Icicle/index.js +3 -1
  118. package/es/src/charts/KPI/applyLayout.js +119 -0
  119. package/es/src/charts/KPI/delta.js +74 -0
  120. package/es/src/charts/KPI/emit.js +303 -0
  121. package/es/src/charts/KPI/index.js +192 -0
  122. package/es/src/charts/KPI/series.js +67 -0
  123. package/es/src/charts/KPI/tileLayout.js +134 -0
  124. package/es/src/charts/Lollipop/emit.js +2 -1
  125. package/es/src/charts/Marimekko/index.js +2 -1
  126. package/es/src/charts/Matrix/applyLayout.js +29 -12
  127. package/es/src/charts/Matrix/bubbles.js +133 -0
  128. package/es/src/charts/Matrix/emit.js +68 -25
  129. package/es/src/charts/Matrix/index.js +64 -5
  130. package/es/src/charts/Network/applyLayout.js +206 -84
  131. package/es/src/charts/Network/bundle.js +29 -8
  132. package/es/src/charts/Network/circleLayout.js +281 -0
  133. package/es/src/charts/Network/containNodes.js +72 -0
  134. package/es/src/charts/Network/emit.js +109 -50
  135. package/es/src/charts/Network/forceLayout.js +111 -0
  136. package/es/src/charts/Network/graph.js +76 -8
  137. package/es/src/charts/Network/graphFluent.js +5 -3
  138. package/es/src/charts/Network/index.js +117 -3
  139. package/es/src/charts/Network/liveForce.js +312 -0
  140. package/es/src/charts/Network/livePositions.js +180 -0
  141. package/es/src/charts/Network/networkDrag.js +156 -0
  142. package/es/src/charts/Pack/applyLayout.js +16 -5
  143. package/es/src/charts/Pack/emit.js +18 -10
  144. package/es/src/charts/Pack/groupRows.js +61 -0
  145. package/es/src/charts/Pack/index.js +3 -14
  146. package/es/src/charts/Pack/neutralPaint.js +20 -0
  147. package/es/src/charts/Pack/nodeNames.js +35 -0
  148. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  149. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  150. package/es/src/charts/ParallelCoordinates/emit.js +3 -2
  151. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  152. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  153. package/es/src/charts/Pareto/color.js +46 -0
  154. package/es/src/charts/Pareto/hover.js +54 -0
  155. package/es/src/charts/Pareto/index.js +170 -0
  156. package/es/src/charts/Pareto/labels.js +91 -0
  157. package/es/src/charts/Pareto/order.js +61 -0
  158. package/es/src/charts/Pareto/paretoSteps.js +84 -0
  159. package/es/src/charts/Pareto/state.js +158 -0
  160. package/es/src/charts/Parliament/index.js +68 -0
  161. package/es/src/charts/Pie/emit.js +12 -3
  162. package/es/src/charts/Pie/index.js +10 -0
  163. package/es/src/charts/Plot/areaEnter.js +70 -0
  164. package/es/src/charts/Plot/areaLabelsAlong.js +10 -2
  165. package/es/src/charts/Plot/aspectRatio.js +92 -0
  166. package/es/src/charts/Plot/axisHover.js +4 -2
  167. package/es/src/charts/Plot/axisHoverAnchors.js +2 -1
  168. package/es/src/charts/Plot/axisHoverScene.js +138 -5
  169. package/es/src/charts/Plot/barConfidence.js +7 -6
  170. package/es/src/charts/Plot/barHitArea.js +121 -7
  171. package/es/src/charts/Plot/barLabelConfidence.js +50 -0
  172. package/es/src/charts/Plot/barLabelFit.js +2 -1
  173. package/es/src/charts/Plot/barWidth.js +10 -5
  174. package/es/src/charts/Plot/baselineBreak.js +15 -6
  175. package/es/src/charts/Plot/baselineDomain.js +13 -4
  176. package/es/src/charts/Plot/circleLabels.js +26 -16
  177. package/es/src/charts/Plot/confidenceAxes.js +100 -0
  178. package/es/src/charts/Plot/confidenceConfig.js +7 -2
  179. package/es/src/charts/Plot/confidenceTooltip.js +47 -4
  180. package/es/src/charts/Plot/connectGapsScene.js +2 -1
  181. package/es/src/charts/Plot/discreteDomain.js +27 -5
  182. package/es/src/charts/Plot/discreteSpan.js +10 -1
  183. package/es/src/charts/Plot/domainClip.js +74 -44
  184. package/es/src/charts/Plot/downsample.js +26 -0
  185. package/es/src/charts/Plot/draw.js +41 -14
  186. package/es/src/charts/Plot/fillBetween.js +2 -1
  187. package/es/src/charts/Plot/forecast.js +8 -4
  188. package/es/src/charts/Plot/forecastScene.js +6 -5
  189. package/es/src/charts/Plot/index.js +52 -27
  190. package/es/src/charts/Plot/inferDiscrete.js +72 -0
  191. package/es/src/charts/Plot/jitter.js +50 -0
  192. package/es/src/charts/Plot/labelPlacement.js +4 -3
  193. package/es/src/charts/Plot/lineBands.js +6 -1
  194. package/es/src/charts/Plot/lineLabelEmit.js +4 -3
  195. package/es/src/charts/Plot/lineLabelSides.js +8 -0
  196. package/es/src/charts/Plot/lineLabelsAlong.js +45 -31
  197. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  198. package/es/src/charts/Plot/marginalHover.js +141 -0
  199. package/es/src/charts/Plot/marginalLayout.js +102 -0
  200. package/es/src/charts/Plot/marginalPaint.js +105 -0
  201. package/es/src/charts/Plot/marginalScene.js +272 -0
  202. package/es/src/charts/Plot/marginalSeries.js +73 -0
  203. package/es/src/charts/Plot/marginalStats.js +219 -0
  204. package/es/src/charts/Plot/openDomainEnds.js +60 -0
  205. package/es/src/charts/Plot/orderPath.js +137 -0
  206. package/es/src/charts/Plot/orderPathScene.js +253 -0
  207. package/es/src/charts/Plot/outlierDetect.js +179 -0
  208. package/es/src/charts/Plot/outlierLabels.js +327 -0
  209. package/es/src/charts/Plot/outlierLines.js +93 -0
  210. package/es/src/charts/Plot/outlierScene.js +308 -0
  211. package/es/src/charts/Plot/outlierTooltip.js +69 -0
  212. package/es/src/charts/Plot/periodLabels.js +27 -0
  213. package/es/src/charts/Plot/pipeline.js +62 -24
  214. package/es/src/charts/Plot/pipelineAxisLayout.js +9 -7
  215. package/es/src/charts/Plot/pipelineDomains.js +64 -27
  216. package/es/src/charts/Plot/pipelineScales.js +37 -28
  217. package/es/src/charts/Plot/plotBreaks.js +38 -18
  218. package/es/src/charts/Plot/plotFacet.js +3 -1
  219. package/es/src/charts/Plot/plotInit.js +65 -3
  220. package/es/src/charts/Plot/plotLevels.js +183 -0
  221. package/es/src/charts/Plot/plotRangeBreaks.js +46 -9
  222. package/es/src/charts/Plot/plotShapes.js +60 -0
  223. package/es/src/charts/Plot/pointConfidence.js +186 -0
  224. package/es/src/charts/Plot/pointKey.js +10 -0
  225. package/es/src/charts/Plot/referenceDomains.js +11 -6
  226. package/es/src/charts/Plot/shapeAccessors.js +52 -0
  227. package/es/src/charts/Plot/shapeDefaults.js +32 -17
  228. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  229. package/es/src/charts/Plot/sharedHover.js +42 -13
  230. package/es/src/charts/Plot/sharedHoverScene.js +49 -13
  231. package/es/src/charts/Plot/sharedTooltip.js +68 -25
  232. package/es/src/charts/Plot/stackEnter.js +7 -3
  233. package/es/src/charts/Plot/stackLegendOrder.js +5 -2
  234. package/es/src/charts/Plot/stackNeutral.js +154 -0
  235. package/es/src/charts/Plot/stackShareTooltip.js +2 -1
  236. package/es/src/charts/Plot/stackThreshold.js +2 -1
  237. package/es/src/charts/Plot/swarm.js +8 -5
  238. package/es/src/charts/Plot/timeNestKeys.js +37 -0
  239. package/es/src/charts/Plot/trendLabels.js +45 -18
  240. package/es/src/charts/Plot/trendLines.js +78 -34
  241. package/es/src/charts/Plot/trendMovingAverage.js +135 -0
  242. package/es/src/charts/Plot/trendProjection.js +18 -6
  243. package/es/src/charts/Plot/trendScene.js +4 -1
  244. package/es/src/charts/Plot/trendTooltip.js +75 -20
  245. package/es/src/charts/PolarArea/emit.js +3 -2
  246. package/es/src/charts/PolarArea/index.js +2 -1
  247. package/es/src/charts/Priestley/applyLayout.js +20 -12
  248. package/es/src/charts/Priestley/emit.js +3 -2
  249. package/es/src/charts/Priestley/index.js +0 -2
  250. package/es/src/charts/Priestley/timeAxis.js +24 -13
  251. package/es/src/charts/Pyramid/gutter.js +52 -16
  252. package/es/src/charts/Pyramid/index.js +55 -7
  253. package/es/src/charts/Pyramid/scene.js +4 -4
  254. package/es/src/charts/Radar/applyLayout.js +31 -33
  255. package/es/src/charts/Radar/axisDecorations.js +29 -17
  256. package/es/src/charts/Radar/curvedLabels.js +43 -2
  257. package/es/src/charts/Radar/emit.js +33 -17
  258. package/es/src/charts/Radar/index.js +41 -2
  259. package/es/src/charts/Radar/points.js +85 -0
  260. package/es/src/charts/RadialArea/index.js +51 -0
  261. package/es/src/charts/RadialBar/emit.js +9 -3
  262. package/es/src/charts/RadialBar/index.js +10 -0
  263. package/es/src/charts/RadialLine/angles.js +117 -0
  264. package/es/src/charts/RadialLine/applyLayout.js +204 -0
  265. package/es/src/charts/RadialLine/emit.js +66 -0
  266. package/es/src/charts/RadialLine/index.js +228 -0
  267. package/es/src/charts/RadialLine/paths.js +55 -0
  268. package/es/src/charts/RadialLine/points.js +80 -0
  269. package/es/src/charts/RadialLine/series.js +84 -0
  270. package/es/src/charts/RadialLine/seriesLabelNodes.js +116 -0
  271. package/es/src/charts/RadialLine/seriesLabels.js +91 -0
  272. package/es/src/charts/RadialLine/spokes.js +32 -0
  273. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  274. package/es/src/charts/RadialMatrix/emit.js +3 -2
  275. package/es/src/charts/RadialMatrix/index.js +15 -2
  276. package/es/src/charts/RadialTree/index.js +33 -0
  277. package/es/src/charts/Rings/applyLayout.js +28 -151
  278. package/es/src/charts/Rings/emit.js +120 -60
  279. package/es/src/charts/Rings/index.js +28 -5
  280. package/es/src/charts/Rings/ringsCurves.js +158 -0
  281. package/es/src/charts/Rings/ringsLoops.js +4 -2
  282. package/es/src/charts/Rings/ringsParallel.js +20 -3
  283. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  284. package/es/src/charts/Rings/ringsSizing.js +82 -51
  285. package/es/src/charts/Sankey/applyLayout.js +22 -4
  286. package/es/src/charts/Sankey/circularLayout.js +14 -6
  287. package/es/src/charts/Sankey/emit.js +3 -2
  288. package/es/src/charts/Sankey/index.js +50 -1
  289. package/es/src/charts/Sankey/sankeyDrag.js +225 -0
  290. package/es/src/charts/Sankey/sankeyLayout.js +12 -0
  291. package/es/src/charts/Scatter/index.js +3 -2
  292. package/es/src/charts/ScatterMatrix/binEmit.js +59 -0
  293. package/es/src/charts/ScatterMatrix/index.js +253 -0
  294. package/es/src/charts/ScatterMatrix/matrixData.js +161 -0
  295. package/es/src/charts/ScatterMatrix/matrixFacet.js +76 -0
  296. package/es/src/charts/ScatterMatrix/matrixHover.js +36 -0
  297. package/es/src/charts/ScatterMatrix/matrixTooltip.js +45 -0
  298. package/es/src/charts/StripPlot/index.js +53 -0
  299. package/es/src/charts/Sunburst/emit.js +12 -3
  300. package/es/src/charts/Sunburst/index.js +13 -1
  301. package/es/src/charts/TileGridMap/index.js +29 -0
  302. package/es/src/charts/Tree/applyLayout.js +135 -32
  303. package/es/src/charts/Tree/emit.js +61 -8
  304. package/es/src/charts/Tree/index.js +34 -15
  305. package/es/src/charts/Tree/keys.js +33 -0
  306. package/es/src/charts/Tree/nodeHeight.js +58 -0
  307. package/es/src/charts/Tree/nodeLabel.js +15 -0
  308. package/es/src/charts/Tree/radialLabels.js +61 -0
  309. package/es/src/charts/Tree/radialLayout.js +210 -0
  310. package/es/src/charts/Treemap/emit.js +3 -2
  311. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  312. package/es/src/charts/Venn/applyLayout.js +176 -0
  313. package/es/src/charts/Venn/circles.js +192 -0
  314. package/es/src/charts/Venn/ellipseFrame.js +57 -0
  315. package/es/src/charts/Venn/emit.js +142 -0
  316. package/es/src/charts/Venn/index.js +178 -0
  317. package/es/src/charts/Venn/nelderMead.js +59 -0
  318. package/es/src/charts/Venn/tooltip.js +22 -0
  319. package/es/src/charts/Venn/vennData.js +99 -0
  320. package/es/src/charts/Venn/vennEllipses.js +291 -0
  321. package/es/src/charts/Venn/vennFit.js +169 -0
  322. package/es/src/charts/Venn/vennLayout.js +252 -0
  323. package/es/src/charts/Venn/vennRegions.js +133 -0
  324. package/es/src/charts/Violin/emit.js +2 -1
  325. package/es/src/charts/Violin/index.js +2 -1
  326. package/es/src/charts/Waffle/applyLayout.js +45 -22
  327. package/es/src/charts/Waffle/arcEmit.js +153 -0
  328. package/es/src/charts/Waffle/arcLayout.js +122 -0
  329. package/es/src/charts/Waffle/arcStage.js +79 -0
  330. package/es/src/charts/Waffle/emit.js +9 -4
  331. package/es/src/charts/Waffle/index.js +88 -4
  332. package/es/src/charts/Waffle/tooltip.js +7 -2
  333. package/es/src/charts/Waterfall/connectors.js +5 -3
  334. package/es/src/charts/Waterfall/state.js +2 -1
  335. package/es/src/charts/WordCloud/applyLayout.js +157 -0
  336. package/es/src/charts/WordCloud/cloudLayout.js +128 -0
  337. package/es/src/charts/WordCloud/emit.js +96 -0
  338. package/es/src/charts/WordCloud/fontScale.js +34 -0
  339. package/es/src/charts/WordCloud/glyphMask.js +298 -0
  340. package/es/src/charts/WordCloud/index.js +174 -0
  341. package/es/src/charts/WordCloud/occupancy.js +99 -0
  342. package/es/src/charts/WordCloud/rotation.js +44 -0
  343. package/es/src/charts/WordCloud/size.js +15 -0
  344. package/es/src/charts/WordCloud/spiral.js +72 -0
  345. package/es/src/charts/definition/applyDefinition.js +6 -1
  346. package/es/src/charts/definition/declaresField.js +14 -0
  347. package/es/src/charts/definition/makeChart.js +15 -3
  348. package/es/src/charts/drawSteps/bottomRightControls.js +1 -1
  349. package/es/src/charts/drawSteps/bottomRightControlsMarkup.js +1 -1
  350. package/es/src/charts/drawSteps/gestureHover.js +10 -6
  351. package/es/src/charts/drawSteps/leavesSurface.js +12 -0
  352. package/es/src/charts/drawSteps/minimap.js +5 -21
  353. package/es/src/charts/drawSteps/selectActions.js +105 -0
  354. package/es/src/charts/drawSteps/selectGesture.js +318 -0
  355. package/es/src/charts/drawSteps/selectRegion.js +222 -0
  356. package/es/src/charts/drawSteps/selectState.js +118 -0
  357. package/es/src/charts/drawSteps/topLeftControls.js +4 -1
  358. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  359. package/es/src/charts/drawSteps/zoomControls.js +90 -37
  360. package/es/src/charts/drawSteps/zoomControlsMarkup.js +228 -36
  361. package/es/src/charts/drawSteps/zoomControlsMenu.js +140 -0
  362. package/es/src/charts/drawSteps/zoomDrag.js +190 -0
  363. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  364. package/es/src/charts/events/click.legend.js +4 -2
  365. package/es/src/charts/events/click.shape.js +5 -3
  366. package/es/src/charts/events/mouseenter.js +6 -16
  367. package/es/src/charts/events/mouseleave.js +15 -5
  368. package/es/src/charts/events/mousemove.legend.js +35 -34
  369. package/es/src/charts/events/mousemove.shape.js +53 -44
  370. package/es/src/charts/facet/drawFacets.js +61 -22
  371. package/es/src/charts/facet/facetConfig.js +3 -1
  372. package/es/src/charts/facet/facetData.js +10 -2
  373. package/es/src/charts/facet/facetGrid.js +5 -1
  374. package/es/src/charts/facet/facetGutter.js +36 -7
  375. package/es/src/charts/facet/facetLayout.js +136 -0
  376. package/es/src/charts/facet/facetLayouts.js +574 -0
  377. package/es/src/charts/facet/facetScene.js +10 -3
  378. package/es/src/charts/features/annotationFrame.js +8 -3
  379. package/es/src/charts/features/axes.js +19 -6
  380. package/es/src/charts/features/axesFinal.js +99 -10
  381. package/es/src/charts/features/axesMeasure.js +31 -10
  382. package/es/src/charts/features/axisTooltip.js +138 -0
  383. package/es/src/charts/features/bareRegion.js +24 -0
  384. package/es/src/charts/features/boxGrid.js +39 -0
  385. package/es/src/charts/features/centerLabel.js +196 -0
  386. package/es/src/charts/features/circleLabelPlacement.js +288 -83
  387. package/es/src/charts/features/circleLabels.js +66 -14
  388. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  389. package/es/src/charts/features/colorScaleBucket.js +18 -0
  390. package/es/src/charts/features/colorScaleHover.js +35 -5
  391. package/es/src/charts/features/colorScaleLimit.js +73 -0
  392. package/es/src/charts/features/colorScaleTooltip.js +62 -0
  393. package/es/src/charts/features/colorScaleTop.js +71 -0
  394. package/es/src/charts/features/colorScaleValue.js +10 -1
  395. package/es/src/charts/features/curvedArrows.js +74 -23
  396. package/es/src/charts/features/depthKey.js +26 -0
  397. package/es/src/charts/features/edgeArrows.js +107 -18
  398. package/es/src/charts/features/emitHelpers.js +7 -2
  399. package/es/src/charts/features/features.js +25 -5
  400. package/es/src/charts/features/featuresColorScale.js +64 -20
  401. package/es/src/charts/features/featuresLegend.js +20 -0
  402. package/es/src/charts/features/hoverTicks.js +46 -0
  403. package/es/src/charts/features/idleQueue.js +72 -0
  404. package/es/src/charts/features/keyHold.js +115 -0
  405. package/es/src/charts/features/keyTooltip.js +91 -0
  406. package/es/src/charts/features/labelLayering.js +149 -0
  407. package/es/src/charts/features/labelSlots.js +112 -0
  408. package/es/src/charts/features/linkInteraction.js +62 -7
  409. package/es/src/charts/features/linkLabelPath.js +2 -39
  410. package/es/src/charts/features/networkMeasures.js +241 -0
  411. package/es/src/charts/features/nodeDrag.js +175 -0
  412. package/es/src/charts/features/nodeKeys.js +117 -0
  413. package/es/src/charts/features/nodeOutline.js +41 -0
  414. package/es/src/charts/features/nodeStats.js +309 -0
  415. package/es/src/charts/features/pathLabelBends.js +191 -0
  416. package/es/src/charts/features/plotAnnotations.js +8 -5
  417. package/es/src/charts/features/plotEndLabels.js +28 -7
  418. package/es/src/charts/features/plotPaint.js +52 -13
  419. package/es/src/charts/features/rectNodeSize.js +41 -0
  420. package/es/src/charts/features/ringLabels.js +3 -1
  421. package/es/src/charts/features/selfLoops.js +33 -23
  422. package/es/src/charts/features/shapeEmit.js +110 -32
  423. package/es/src/charts/features/sharedFields.js +10 -5
  424. package/es/src/charts/features/spokeLabels.js +178 -0
  425. package/es/src/charts/features/swatchPaint.js +68 -0
  426. package/es/src/charts/features/textHalo.js +3 -2
  427. package/es/src/charts/features/thresholdMembers.js +8 -12
  428. package/es/src/charts/features/tooltipRows.js +76 -0
  429. package/es/src/charts/features/tooltipSwatch.js +81 -24
  430. package/es/src/charts/features/xAxisConfig.js +2 -1
  431. package/es/src/charts/helpers/densityChart.js +2 -7
  432. package/es/src/charts/helpers/valueTitle.js +13 -1
  433. package/es/src/charts/index.js +17 -0
  434. package/es/src/charts/partition/chartFields.js +12 -3
  435. package/es/src/charts/partition/interaction.js +10 -5
  436. package/es/src/charts/pipeline/insetPlacement.js +19 -7
  437. package/es/src/charts/pipeline/preDrawData.js +80 -11
  438. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  439. package/es/src/charts/pipeline/stages.js +3 -2
  440. package/es/src/charts/pipeline/vizPreDraw.js +4 -0
  441. package/es/src/charts/plotBuffers/Circle.js +3 -2
  442. package/es/src/charts/plotBuffers/Line.js +6 -5
  443. package/es/src/charts/plotBuffers/Rect.js +3 -2
  444. package/es/src/charts/plotBuffers/Tick.js +12 -0
  445. package/es/src/charts/plotBuffers/defaultBuffers.js +3 -1
  446. package/es/src/charts/plotBuffers/rectLikeBuffer.js +4 -3
  447. package/es/src/charts/polar/chrome.js +81 -9
  448. package/es/src/charts/polar/config.js +4 -0
  449. package/es/src/charts/polar/wedgeLayout.js +2 -1
  450. package/es/src/charts/viz/Viz.js +56 -33
  451. package/es/src/charts/viz/VizBase.js +78 -42
  452. package/es/src/charts/viz/appendRows.js +90 -0
  453. package/es/src/charts/viz/backgroundInk.js +10 -0
  454. package/es/src/charts/viz/dataChanged.js +19 -0
  455. package/es/src/charts/viz/discrete.js +9 -0
  456. package/es/src/charts/viz/emphasis.js +14 -0
  457. package/es/src/charts/viz/fillStroke.js +10 -0
  458. package/es/src/charts/viz/focusTargets.js +25 -5
  459. package/es/src/charts/viz/groupByLevels.js +48 -0
  460. package/es/src/charts/viz/groupRow.js +27 -0
  461. package/es/src/charts/viz/hoverBand.js +40 -0
  462. package/es/src/charts/viz/interactionOpacity.js +240 -52
  463. package/es/src/charts/viz/keyboardNav.js +39 -9
  464. package/es/src/charts/viz/liftRaised.js +84 -0
  465. package/es/src/charts/viz/nearestHover.js +9 -2
  466. package/es/src/charts/viz/reportDrawError.js +15 -0
  467. package/es/src/charts/viz/setCursor.js +41 -0
  468. package/es/src/charts/viz/simpleHover.js +3 -4
  469. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  470. package/es/src/charts/viz/userClick.js +45 -0
  471. package/es/src/charts/viz/vizDataPolling.js +0 -1
  472. package/es/src/charts/viz/vizDefaults.js +23 -34
  473. package/es/src/charts/viz/vizFields.js +13 -1
  474. package/es/src/charts/viz/vizRender.js +35 -5
  475. package/es/src/charts/viz/vizTypes.js +1 -1
  476. package/es/src/charts/viz/vizVisibility.js +12 -2
  477. package/es/src/components/Axis/Axis.js +114 -14
  478. package/es/src/components/Axis/AxisBottom.js +1 -0
  479. package/es/src/components/Axis/AxisLeft.js +1 -0
  480. package/es/src/components/Axis/AxisRight.js +1 -0
  481. package/es/src/components/Axis/AxisTop.js +1 -0
  482. package/es/src/components/Axis/axisBreak.js +29 -7
  483. package/es/src/components/Axis/axisDefaults.js +18 -0
  484. package/es/src/components/Axis/axisEndLabels.js +4 -1
  485. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  486. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  487. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  488. package/es/src/components/Axis/axisLabelSize.js +195 -0
  489. package/es/src/components/Axis/axisLabelThinning.js +167 -10
  490. package/es/src/components/Axis/axisLayout.js +76 -46
  491. package/es/src/components/Axis/axisLayoutLabels.js +93 -145
  492. package/es/src/components/Axis/axisLayoutScale.js +79 -34
  493. package/es/src/components/Axis/axisLevels.js +271 -0
  494. package/es/src/components/Axis/axisLimit.js +33 -0
  495. package/es/src/components/Axis/axisMaxSize.js +39 -0
  496. package/es/src/components/Axis/axisMinorTicks.js +280 -0
  497. package/es/src/components/Axis/axisPeriods.js +144 -0
  498. package/es/src/components/Axis/axisRangeBreaks.js +19 -10
  499. package/es/src/components/Axis/axisRender.js +90 -36
  500. package/es/src/components/Axis/axisRounding.js +38 -1
  501. package/es/src/components/Axis/axisScaleType.js +55 -0
  502. package/es/src/components/Axis/axisScene.js +100 -6
  503. package/es/src/components/Axis/axisTickLookups.js +30 -0
  504. package/es/src/components/Axis/axisTitle.js +53 -0
  505. package/es/src/components/Axis/axisTooltipTargets.js +151 -0
  506. package/es/src/components/Axis/labelSizeSession.js +23 -0
  507. package/es/src/components/Axis/rangeBreaks.js +10 -4
  508. package/es/src/components/Axis/timeValues.js +116 -19
  509. package/es/src/components/ColorScale/ColorScale.js +63 -18
  510. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  511. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  512. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  513. package/es/src/components/ColorScale/colorScaleScale.js +139 -41
  514. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  515. package/es/src/components/Legend/Legend.js +11 -2
  516. package/es/src/components/Legend/legendCut.js +108 -0
  517. package/es/src/components/Legend/legendRender.js +38 -13
  518. package/es/src/components/SizeLegend/SizeLegend.js +20 -1
  519. package/es/src/components/TextBox.js +6 -2
  520. package/es/src/components/Timeline/Timeline.js +11 -3
  521. package/es/src/components/Timeline/timelineRender.js +25 -14
  522. package/es/src/components/Tooltip.js +8 -1
  523. package/es/src/components/textBoxScene.js +3 -0
  524. package/es/src/components/textEllipsis.js +7 -0
  525. package/es/src/components/tooltipDom.js +80 -18
  526. package/es/src/fluent.js +124 -9
  527. package/es/src/shapes/Area.js +32 -1
  528. package/es/src/shapes/Bar.js +22 -1
  529. package/es/src/shapes/Box.js +72 -13
  530. package/es/src/shapes/Circle.js +1 -0
  531. package/es/src/shapes/Image.js +8 -1
  532. package/es/src/shapes/Line.js +45 -1
  533. package/es/src/shapes/Path.js +1 -0
  534. package/es/src/shapes/Rect.js +1 -0
  535. package/es/src/shapes/Shape.js +29 -8
  536. package/es/src/shapes/Tick.js +54 -0
  537. package/es/src/shapes/Whisker.js +1 -0
  538. package/es/src/shapes/boxExtraShapes.js +72 -0
  539. package/es/src/shapes/boxExtras.js +212 -0
  540. package/es/src/shapes/boxStyle.js +38 -5
  541. package/es/src/shapes/buildLabelData.js +2 -0
  542. package/es/src/shapes/downsample.js +150 -0
  543. package/es/src/shapes/hitAreaNode.js +6 -2
  544. package/es/src/shapes/index.js +1 -0
  545. package/es/src/shapes/pathSeries.js +51 -0
  546. package/es/src/utils/BaseClass.js +59 -52
  547. package/es/src/utils/configValue.js +9 -0
  548. package/es/src/utils/jitter.js +33 -0
  549. package/es/src/utils/resetSetters.js +66 -0
  550. package/package.json +10 -10
  551. package/types/index.d.ts +5 -4
  552. package/types/internal.d.ts +272 -29
  553. package/types/src/charts/Alluvial/titles.d.ts +16 -3
  554. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +7 -3
  555. package/types/src/charts/ArcDiagram/arcLoops.d.ts +3 -1
  556. package/types/src/charts/ArcDiagram/arcNodeBox.d.ts +60 -0
  557. package/types/src/charts/ArcDiagram/emit.d.ts +6 -4
  558. package/types/src/charts/ArcDiagram/events.d.ts +2 -1
  559. package/types/src/charts/BoxWhisker/extras.d.ts +41 -0
  560. package/types/src/charts/BoxWhisker/summary.d.ts +1 -1
  561. package/types/src/charts/BoxWhisker/tooltip.d.ts +33 -4
  562. package/types/src/charts/BubbleChart/emit.d.ts +3 -3
  563. package/types/src/charts/BubbleMatrix/colorDefaults.d.ts +19 -0
  564. package/types/src/charts/BubbleMatrix/index.d.ts +18 -0
  565. package/types/src/charts/BumpChart/areaBump.d.ts +86 -0
  566. package/types/src/charts/BumpChart/index.d.ts +19 -1
  567. package/types/src/charts/Calendar/calendarDates.d.ts +8 -1
  568. package/types/src/charts/Candlestick/periods.d.ts +19 -8
  569. package/types/src/charts/ConnectedScatter/index.d.ts +17 -0
  570. package/types/src/charts/CyclePlot/cycleFacet.d.ts +61 -0
  571. package/types/src/charts/CyclePlot/cycleMeans.d.ts +32 -0
  572. package/types/src/charts/CyclePlot/cyclePeriods.d.ts +37 -0
  573. package/types/src/charts/CyclePlot/cycleTooltip.d.ts +47 -0
  574. package/types/src/charts/CyclePlot/index.d.ts +75 -0
  575. package/types/src/charts/DensityPlot/densityCurves.d.ts +84 -0
  576. package/types/src/charts/DensityPlot/densityPoint.d.ts +16 -0
  577. package/types/src/charts/DensityPlot/index.d.ts +33 -0
  578. package/types/src/charts/DensityPlot/rug.d.ts +57 -0
  579. package/types/src/charts/DotPlot/dotLayout.d.ts +95 -0
  580. package/types/src/charts/DotPlot/facetSize.d.ts +33 -0
  581. package/types/src/charts/DotPlot/index.d.ts +22 -0
  582. package/types/src/charts/DotPlot/placements.d.ts +28 -0
  583. package/types/src/charts/DotPlot/tooltip.d.ts +27 -0
  584. package/types/src/charts/Dumbbell/arrowGrays.d.ts +33 -0
  585. package/types/src/charts/Dumbbell/categoryChange.d.ts +66 -0
  586. package/types/src/charts/Dumbbell/changeEmit.d.ts +71 -0
  587. package/types/src/charts/Dumbbell/changes.d.ts +64 -0
  588. package/types/src/charts/Dumbbell/connectors.d.ts +43 -0
  589. package/types/src/charts/Dumbbell/emit.d.ts +17 -19
  590. package/types/src/charts/Dumbbell/index.d.ts +6 -2
  591. package/types/src/charts/Gantt/applyLayout.d.ts +14 -1
  592. package/types/src/charts/Gantt/criticalPath.d.ts +100 -0
  593. package/types/src/charts/Gantt/emit.d.ts +17 -1
  594. package/types/src/charts/Gantt/ganttCalendar.d.ts +37 -0
  595. package/types/src/charts/Gantt/ganttCritical.d.ts +53 -0
  596. package/types/src/charts/Gantt/ganttDecor.d.ts +32 -2
  597. package/types/src/charts/Gantt/ganttRows.d.ts +2 -0
  598. package/types/src/charts/Gantt/ganttSlack.d.ts +21 -0
  599. package/types/src/charts/Gantt/ganttTooltip.d.ts +35 -15
  600. package/types/src/charts/Gantt/index.d.ts +12 -6
  601. package/types/src/charts/Geomap/applyLayout.d.ts +19 -0
  602. package/types/src/charts/Geomap/cartogram.d.ts +58 -0
  603. package/types/src/charts/Geomap/cartogramContiguous.d.ts +59 -0
  604. package/types/src/charts/Geomap/cartogramFields.d.ts +16 -0
  605. package/types/src/charts/Geomap/cartogramLabels.d.ts +48 -0
  606. package/types/src/charts/Geomap/cartogramLayout.d.ts +71 -0
  607. package/types/src/charts/Geomap/cartogramLegend.d.ts +36 -0
  608. package/types/src/charts/Geomap/cartogramRelax.d.ts +29 -0
  609. package/types/src/charts/Geomap/densityEmit.d.ts +29 -0
  610. package/types/src/charts/Geomap/densityFields.d.ts +27 -0
  611. package/types/src/charts/Geomap/densityLayout.d.ts +49 -0
  612. package/types/src/charts/Geomap/densityTooltip.d.ts +48 -0
  613. package/types/src/charts/Geomap/dotDensity.d.ts +80 -0
  614. package/types/src/charts/Geomap/dotDensityLayout.d.ts +97 -0
  615. package/types/src/charts/Geomap/dotRenderer.d.ts +27 -0
  616. package/types/src/charts/Geomap/drillDown.d.ts +128 -0
  617. package/types/src/charts/Geomap/drillEmit.d.ts +37 -0
  618. package/types/src/charts/Geomap/drillEvents.d.ts +33 -0
  619. package/types/src/charts/Geomap/emit.d.ts +7 -0
  620. package/types/src/charts/Geomap/flowEmit.d.ts +6 -4
  621. package/types/src/charts/Geomap/flowLinks.d.ts +12 -1
  622. package/types/src/charts/Geomap/geoHexbin.d.ts +91 -0
  623. package/types/src/charts/Geomap/geoHexbinZoom.d.ts +76 -0
  624. package/types/src/charts/Geomap/index.d.ts +7 -0
  625. package/types/src/charts/Geomap/pointCluster.d.ts +108 -0
  626. package/types/src/charts/Geomap/pointClusterEmit.d.ts +106 -0
  627. package/types/src/charts/Geomap/pointClusterLayout.d.ts +123 -0
  628. package/types/src/charts/Geomap/pointClusterLinks.d.ts +21 -0
  629. package/types/src/charts/Geomap/pointClusterZoom.d.ts +89 -0
  630. package/types/src/charts/Geomap/pointLabels.d.ts +21 -3
  631. package/types/src/charts/Geomap/pointRows.d.ts +24 -0
  632. package/types/src/charts/Geomap/tileGrid.d.ts +98 -0
  633. package/types/src/charts/Geomap/tileState.d.ts +18 -0
  634. package/types/src/charts/Geomap/topojsonFluent.d.ts +9 -0
  635. package/types/src/charts/Geomap/topojsonLevels.d.ts +14 -0
  636. package/types/src/charts/Hexbin/contourLabels.d.ts +6 -5
  637. package/types/src/charts/Hexbin/settings.d.ts +7 -1
  638. package/types/src/charts/Histogram/binData.d.ts +6 -0
  639. package/types/src/charts/HorizonChart/emit.d.ts +20 -0
  640. package/types/src/charts/HorizonChart/horizonBands.d.ts +42 -0
  641. package/types/src/charts/HorizonChart/horizonColors.d.ts +25 -0
  642. package/types/src/charts/HorizonChart/hover.d.ts +52 -0
  643. package/types/src/charts/HorizonChart/index.d.ts +32 -0
  644. package/types/src/charts/HorizonChart/measure.d.ts +24 -0
  645. package/types/src/charts/HorizonChart/rowFilter.d.ts +88 -0
  646. package/types/src/charts/HorizonChart/state.d.ts +71 -0
  647. package/types/src/charts/KPI/applyLayout.d.ts +64 -0
  648. package/types/src/charts/KPI/delta.d.ts +62 -0
  649. package/types/src/charts/KPI/emit.d.ts +55 -0
  650. package/types/src/charts/KPI/index.d.ts +34 -0
  651. package/types/src/charts/KPI/series.d.ts +45 -0
  652. package/types/src/charts/KPI/tileLayout.d.ts +90 -0
  653. package/types/src/charts/Matrix/applyLayout.d.ts +5 -2
  654. package/types/src/charts/Matrix/bubbles.d.ts +87 -0
  655. package/types/src/charts/Matrix/emit.d.ts +3 -2
  656. package/types/src/charts/Matrix/index.d.ts +2 -1
  657. package/types/src/charts/Network/applyLayout.d.ts +35 -0
  658. package/types/src/charts/Network/bundle.d.ts +24 -15
  659. package/types/src/charts/Network/circleLayout.d.ts +149 -0
  660. package/types/src/charts/Network/containNodes.d.ts +35 -0
  661. package/types/src/charts/Network/emit.d.ts +20 -0
  662. package/types/src/charts/Network/forceLayout.d.ts +49 -0
  663. package/types/src/charts/Network/graph.d.ts +29 -5
  664. package/types/src/charts/Network/liveForce.d.ts +133 -0
  665. package/types/src/charts/Network/livePositions.d.ts +90 -0
  666. package/types/src/charts/Network/networkDrag.d.ts +55 -0
  667. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  668. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  669. package/types/src/charts/Pack/index.d.ts +3 -0
  670. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  671. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  672. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  673. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  674. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  675. package/types/src/charts/Pareto/color.d.ts +21 -0
  676. package/types/src/charts/Pareto/hover.d.ts +38 -0
  677. package/types/src/charts/Pareto/index.d.ts +22 -0
  678. package/types/src/charts/Pareto/labels.d.ts +40 -0
  679. package/types/src/charts/Pareto/order.d.ts +30 -0
  680. package/types/src/charts/Pareto/paretoSteps.d.ts +65 -0
  681. package/types/src/charts/Pareto/state.d.ts +93 -0
  682. package/types/src/charts/Parliament/index.d.ts +18 -0
  683. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  684. package/types/src/charts/Plot/areaLabelsAlong.d.ts +7 -0
  685. package/types/src/charts/Plot/aspectRatio.d.ts +68 -0
  686. package/types/src/charts/Plot/axisHover.d.ts +2 -0
  687. package/types/src/charts/Plot/axisHoverScene.d.ts +44 -1
  688. package/types/src/charts/Plot/barConfidence.d.ts +14 -1
  689. package/types/src/charts/Plot/barHitArea.d.ts +34 -7
  690. package/types/src/charts/Plot/barLabelConfidence.d.ts +25 -0
  691. package/types/src/charts/Plot/baselineBreak.d.ts +2 -1
  692. package/types/src/charts/Plot/baselineDomain.d.ts +5 -0
  693. package/types/src/charts/Plot/circleLabels.d.ts +8 -7
  694. package/types/src/charts/Plot/confidenceAxes.d.ts +63 -0
  695. package/types/src/charts/Plot/confidenceTooltip.d.ts +22 -0
  696. package/types/src/charts/Plot/discreteDomain.d.ts +13 -2
  697. package/types/src/charts/Plot/discreteSpan.d.ts +5 -0
  698. package/types/src/charts/Plot/domainClip.d.ts +15 -5
  699. package/types/src/charts/Plot/downsample.d.ts +16 -0
  700. package/types/src/charts/Plot/index.d.ts +20 -17
  701. package/types/src/charts/Plot/inferDiscrete.d.ts +31 -0
  702. package/types/src/charts/Plot/jitter.d.ts +45 -0
  703. package/types/src/charts/Plot/lineLabelSides.d.ts +19 -0
  704. package/types/src/charts/Plot/lineLabelsAlong.d.ts +19 -6
  705. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  706. package/types/src/charts/Plot/marginalHover.d.ts +26 -0
  707. package/types/src/charts/Plot/marginalLayout.d.ts +95 -0
  708. package/types/src/charts/Plot/marginalPaint.d.ts +54 -0
  709. package/types/src/charts/Plot/marginalScene.d.ts +67 -0
  710. package/types/src/charts/Plot/marginalSeries.d.ts +38 -0
  711. package/types/src/charts/Plot/marginalStats.d.ts +115 -0
  712. package/types/src/charts/Plot/openDomainEnds.d.ts +25 -0
  713. package/types/src/charts/Plot/orderPath.d.ts +100 -0
  714. package/types/src/charts/Plot/orderPathScene.d.ts +49 -0
  715. package/types/src/charts/Plot/outlierDetect.d.ts +87 -0
  716. package/types/src/charts/Plot/outlierLabels.d.ts +103 -0
  717. package/types/src/charts/Plot/outlierLines.d.ts +30 -0
  718. package/types/src/charts/Plot/outlierScene.d.ts +103 -0
  719. package/types/src/charts/Plot/outlierTooltip.d.ts +44 -0
  720. package/types/src/charts/Plot/periodLabels.d.ts +14 -0
  721. package/types/src/charts/Plot/pipeline.d.ts +2 -1
  722. package/types/src/charts/Plot/plotBreaks.d.ts +21 -6
  723. package/types/src/charts/Plot/plotInit.d.ts +7 -25
  724. package/types/src/charts/Plot/plotLevels.d.ts +120 -0
  725. package/types/src/charts/Plot/plotRangeBreaks.d.ts +28 -2
  726. package/types/src/charts/Plot/plotShapes.d.ts +42 -0
  727. package/types/src/charts/Plot/pointConfidence.d.ts +73 -0
  728. package/types/src/charts/Plot/pointKey.d.ts +9 -0
  729. package/types/src/charts/Plot/referenceDomains.d.ts +2 -1
  730. package/types/src/charts/Plot/shapeAccessors.d.ts +24 -0
  731. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  732. package/types/src/charts/Plot/sharedHover.d.ts +5 -0
  733. package/types/src/charts/Plot/sharedTooltip.d.ts +31 -7
  734. package/types/src/charts/Plot/stackEnter.d.ts +1 -1
  735. package/types/src/charts/Plot/stackLegendOrder.d.ts +4 -1
  736. package/types/src/charts/Plot/stackNeutral.d.ts +85 -0
  737. package/types/src/charts/Plot/swarm.d.ts +8 -4
  738. package/types/src/charts/Plot/timeNestKeys.d.ts +20 -0
  739. package/types/src/charts/Plot/trendLabels.d.ts +15 -6
  740. package/types/src/charts/Plot/trendLines.d.ts +40 -8
  741. package/types/src/charts/Plot/trendMovingAverage.d.ts +78 -0
  742. package/types/src/charts/Plot/trendProjection.d.ts +4 -2
  743. package/types/src/charts/Plot/trendTooltip.d.ts +24 -2
  744. package/types/src/charts/Priestley/timeAxis.d.ts +13 -7
  745. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  746. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  747. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  748. package/types/src/charts/Radar/axisDecorations.d.ts +5 -2
  749. package/types/src/charts/Radar/curvedLabels.d.ts +35 -0
  750. package/types/src/charts/Radar/emit.d.ts +5 -2
  751. package/types/src/charts/Radar/index.d.ts +7 -2
  752. package/types/src/charts/Radar/points.d.ts +50 -0
  753. package/types/src/charts/RadialArea/index.d.ts +17 -0
  754. package/types/src/charts/RadialLine/angles.d.ts +67 -0
  755. package/types/src/charts/RadialLine/applyLayout.d.ts +70 -0
  756. package/types/src/charts/RadialLine/emit.d.ts +13 -0
  757. package/types/src/charts/RadialLine/index.d.ts +28 -0
  758. package/types/src/charts/RadialLine/paths.d.ts +37 -0
  759. package/types/src/charts/RadialLine/points.d.ts +43 -0
  760. package/types/src/charts/RadialLine/series.d.ts +63 -0
  761. package/types/src/charts/RadialLine/seriesLabelNodes.d.ts +26 -0
  762. package/types/src/charts/RadialLine/seriesLabels.d.ts +80 -0
  763. package/types/src/charts/RadialLine/spokes.d.ts +15 -0
  764. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  765. package/types/src/charts/RadialTree/index.d.ts +16 -0
  766. package/types/src/charts/Rings/emit.d.ts +28 -5
  767. package/types/src/charts/Rings/index.d.ts +4 -2
  768. package/types/src/charts/Rings/ringsCurves.d.ts +46 -0
  769. package/types/src/charts/Rings/ringsGraph.d.ts +32 -5
  770. package/types/src/charts/Rings/ringsParallel.d.ts +4 -2
  771. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  772. package/types/src/charts/Rings/ringsSizing.d.ts +41 -11
  773. package/types/src/charts/Sankey/circularLayout.d.ts +3 -0
  774. package/types/src/charts/Sankey/sankeyDrag.d.ts +112 -0
  775. package/types/src/charts/Sankey/sankeyLayout.d.ts +8 -0
  776. package/types/src/charts/Scatter/index.d.ts +3 -2
  777. package/types/src/charts/ScatterMatrix/binEmit.d.ts +22 -0
  778. package/types/src/charts/ScatterMatrix/index.d.ts +80 -0
  779. package/types/src/charts/ScatterMatrix/matrixData.d.ts +93 -0
  780. package/types/src/charts/ScatterMatrix/matrixFacet.d.ts +32 -0
  781. package/types/src/charts/ScatterMatrix/matrixHover.d.ts +21 -0
  782. package/types/src/charts/ScatterMatrix/matrixTooltip.d.ts +32 -0
  783. package/types/src/charts/StripPlot/index.d.ts +16 -0
  784. package/types/src/charts/TileGridMap/index.d.ts +14 -0
  785. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  786. package/types/src/charts/Tree/index.d.ts +2 -2
  787. package/types/src/charts/Tree/keys.d.ts +25 -0
  788. package/types/src/charts/Tree/nodeHeight.d.ts +41 -0
  789. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  790. package/types/src/charts/Tree/radialLabels.d.ts +24 -0
  791. package/types/src/charts/Tree/radialLayout.d.ts +129 -0
  792. package/types/src/charts/Venn/applyLayout.d.ts +91 -0
  793. package/types/src/charts/Venn/circles.d.ts +87 -0
  794. package/types/src/charts/Venn/ellipseFrame.d.ts +37 -0
  795. package/types/src/charts/Venn/emit.d.ts +36 -0
  796. package/types/src/charts/Venn/index.d.ts +30 -0
  797. package/types/src/charts/Venn/nelderMead.d.ts +28 -0
  798. package/types/src/charts/Venn/tooltip.d.ts +8 -0
  799. package/types/src/charts/Venn/vennData.d.ts +56 -0
  800. package/types/src/charts/Venn/vennEllipses.d.ts +93 -0
  801. package/types/src/charts/Venn/vennFit.d.ts +39 -0
  802. package/types/src/charts/Venn/vennLayout.d.ts +52 -0
  803. package/types/src/charts/Venn/vennRegions.d.ts +58 -0
  804. package/types/src/charts/Waffle/applyLayout.d.ts +4 -1
  805. package/types/src/charts/Waffle/arcEmit.d.ts +45 -0
  806. package/types/src/charts/Waffle/arcLayout.d.ts +82 -0
  807. package/types/src/charts/Waffle/arcStage.d.ts +60 -0
  808. package/types/src/charts/Waffle/emit.d.ts +2 -1
  809. package/types/src/charts/Waffle/index.d.ts +8 -2
  810. package/types/src/charts/Waffle/tooltip.d.ts +7 -2
  811. package/types/src/charts/Waterfall/connectors.d.ts +3 -2
  812. package/types/src/charts/WordCloud/applyLayout.d.ts +51 -0
  813. package/types/src/charts/WordCloud/cloudLayout.d.ts +95 -0
  814. package/types/src/charts/WordCloud/emit.d.ts +27 -0
  815. package/types/src/charts/WordCloud/fontScale.d.ts +20 -0
  816. package/types/src/charts/WordCloud/glyphMask.d.ts +95 -0
  817. package/types/src/charts/WordCloud/index.d.ts +31 -0
  818. package/types/src/charts/WordCloud/occupancy.d.ts +59 -0
  819. package/types/src/charts/WordCloud/rotation.d.ts +31 -0
  820. package/types/src/charts/WordCloud/size.d.ts +16 -0
  821. package/types/src/charts/WordCloud/spiral.d.ts +47 -0
  822. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  823. package/types/src/charts/definition/declaresField.d.ts +9 -0
  824. package/types/src/charts/definition/makeChart.d.ts +3 -3
  825. package/types/src/charts/drawSteps/gestureHover.d.ts +2 -2
  826. package/types/src/charts/drawSteps/leavesSurface.d.ts +11 -0
  827. package/types/src/charts/drawSteps/selectActions.d.ts +58 -0
  828. package/types/src/charts/drawSteps/selectGesture.d.ts +60 -0
  829. package/types/src/charts/drawSteps/selectRegion.d.ts +86 -0
  830. package/types/src/charts/drawSteps/selectState.d.ts +51 -0
  831. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  832. package/types/src/charts/drawSteps/zoomControls.d.ts +32 -7
  833. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +104 -16
  834. package/types/src/charts/drawSteps/zoomControlsMenu.d.ts +30 -0
  835. package/types/src/charts/drawSteps/zoomDrag.d.ts +73 -0
  836. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  837. package/types/src/charts/facet/drawFacets.d.ts +6 -3
  838. package/types/src/charts/facet/facetConfig.d.ts +35 -1
  839. package/types/src/charts/facet/facetData.d.ts +8 -2
  840. package/types/src/charts/facet/facetGrid.d.ts +12 -0
  841. package/types/src/charts/facet/facetGutter.d.ts +19 -5
  842. package/types/src/charts/facet/facetLayout.d.ts +79 -0
  843. package/types/src/charts/facet/facetLayouts.d.ts +21 -0
  844. package/types/src/charts/facet/facetScene.d.ts +4 -1
  845. package/types/src/charts/features/annotationFrame.d.ts +2 -0
  846. package/types/src/charts/features/axesFinal.d.ts +5 -2
  847. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  848. package/types/src/charts/features/bareRegion.d.ts +18 -0
  849. package/types/src/charts/features/boxGrid.d.ts +28 -0
  850. package/types/src/charts/features/centerLabel.d.ts +89 -0
  851. package/types/src/charts/features/circleLabelPlacement.d.ts +81 -11
  852. package/types/src/charts/features/circleLabels.d.ts +33 -3
  853. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  854. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  855. package/types/src/charts/features/colorScaleHover.d.ts +14 -3
  856. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  857. package/types/src/charts/features/colorScaleTooltip.d.ts +38 -0
  858. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  859. package/types/src/charts/features/colorScaleValue.d.ts +6 -0
  860. package/types/src/charts/features/curvedArrows.d.ts +42 -12
  861. package/types/src/charts/features/depthKey.d.ts +19 -0
  862. package/types/src/charts/features/edgeArrows.d.ts +68 -31
  863. package/types/src/charts/features/emitHelpers.d.ts +6 -1
  864. package/types/src/charts/features/featuresColorScale.d.ts +6 -0
  865. package/types/src/charts/features/hoverTicks.d.ts +33 -0
  866. package/types/src/charts/features/idleQueue.d.ts +46 -0
  867. package/types/src/charts/features/keyHold.d.ts +41 -0
  868. package/types/src/charts/features/keyTooltip.d.ts +44 -0
  869. package/types/src/charts/features/labelLayering.d.ts +38 -0
  870. package/types/src/charts/features/labelSlots.d.ts +53 -0
  871. package/types/src/charts/features/linkInteraction.d.ts +13 -4
  872. package/types/src/charts/features/linkLabelPath.d.ts +0 -7
  873. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  874. package/types/src/charts/features/nodeDrag.d.ts +51 -0
  875. package/types/src/charts/features/nodeKeys.d.ts +53 -0
  876. package/types/src/charts/features/nodeOutline.d.ts +34 -0
  877. package/types/src/charts/features/nodeStats.d.ts +93 -0
  878. package/types/src/charts/features/pathLabelBends.d.ts +78 -0
  879. package/types/src/charts/features/plotAnnotations.d.ts +2 -1
  880. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  881. package/types/src/charts/features/plotPaint.d.ts +5 -0
  882. package/types/src/charts/features/rectNodeSize.d.ts +42 -0
  883. package/types/src/charts/features/ringLabels.d.ts +3 -1
  884. package/types/src/charts/features/selfLoops.d.ts +10 -9
  885. package/types/src/charts/features/shapeEmit.d.ts +2 -0
  886. package/types/src/charts/features/sharedFields.d.ts +8 -4
  887. package/types/src/charts/features/spokeLabels.d.ts +123 -0
  888. package/types/src/charts/features/swatchPaint.d.ts +58 -0
  889. package/types/src/charts/features/textHalo.d.ts +4 -3
  890. package/types/src/charts/features/thresholdMembers.d.ts +6 -6
  891. package/types/src/charts/features/tooltipRows.d.ts +50 -0
  892. package/types/src/charts/features/tooltipSwatch.d.ts +25 -11
  893. package/types/src/charts/helpers/valueTitle.d.ts +7 -0
  894. package/types/src/charts/index.d.ts +17 -0
  895. package/types/src/charts/partition/chartFields.d.ts +6 -1
  896. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  897. package/types/src/charts/pipeline/preDrawData.d.ts +26 -0
  898. package/types/src/charts/plotBuffers/Circle.d.ts +2 -1
  899. package/types/src/charts/plotBuffers/Rect.d.ts +2 -1
  900. package/types/src/charts/plotBuffers/Tick.d.ts +9 -0
  901. package/types/src/charts/plotBuffers/defaultBuffers.d.ts +2 -0
  902. package/types/src/charts/polar/chrome.d.ts +19 -6
  903. package/types/src/charts/viz/Viz.d.ts +10 -3
  904. package/types/src/charts/viz/VizBase.d.ts +63 -3
  905. package/types/src/charts/viz/appendRows.d.ts +49 -0
  906. package/types/src/charts/viz/backgroundInk.d.ts +8 -0
  907. package/types/src/charts/viz/dataChanged.d.ts +11 -0
  908. package/types/src/charts/viz/discrete.d.ts +19 -0
  909. package/types/src/charts/viz/emphasis.d.ts +17 -0
  910. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  911. package/types/src/charts/viz/focusTargets.d.ts +15 -1
  912. package/types/src/charts/viz/groupByLevels.d.ts +36 -0
  913. package/types/src/charts/viz/groupRow.d.ts +6 -0
  914. package/types/src/charts/viz/hoverBand.d.ts +28 -0
  915. package/types/src/charts/viz/interactionOpacity.d.ts +23 -2
  916. package/types/src/charts/viz/keyboardNav.d.ts +13 -0
  917. package/types/src/charts/viz/liftRaised.d.ts +23 -0
  918. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  919. package/types/src/charts/viz/setCursor.d.ts +38 -0
  920. package/types/src/charts/viz/simpleHover.d.ts +3 -3
  921. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  922. package/types/src/charts/viz/userClick.d.ts +43 -0
  923. package/types/src/charts/viz/vizFields.d.ts +12 -0
  924. package/types/src/charts/viz/vizTypes.d.ts +132 -2
  925. package/types/src/charts/viz/vizVisibility.d.ts +7 -0
  926. package/types/src/components/Axis/Axis.d.ts +68 -3
  927. package/types/src/components/Axis/axisBreak.d.ts +19 -3
  928. package/types/src/components/Axis/axisDefaults.d.ts +14 -0
  929. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  930. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  931. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  932. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  933. package/types/src/components/Axis/axisLabelThinning.d.ts +57 -3
  934. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  935. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  936. package/types/src/components/Axis/axisLayoutScale.d.ts +16 -2
  937. package/types/src/components/Axis/axisLevels.d.ts +137 -0
  938. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  939. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  940. package/types/src/components/Axis/axisMinorTicks.d.ts +83 -0
  941. package/types/src/components/Axis/axisPeriods.d.ts +45 -0
  942. package/types/src/components/Axis/axisRangeBreaks.d.ts +6 -2
  943. package/types/src/components/Axis/axisRounding.d.ts +22 -0
  944. package/types/src/components/Axis/axisScaleType.d.ts +32 -0
  945. package/types/src/components/Axis/axisScene.d.ts +15 -7
  946. package/types/src/components/Axis/axisTickLookups.d.ts +26 -0
  947. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  948. package/types/src/components/Axis/axisTooltipTargets.d.ts +94 -0
  949. package/types/src/components/Axis/labelSizeSession.d.ts +16 -0
  950. package/types/src/components/Axis/rangeBreaks.d.ts +6 -2
  951. package/types/src/components/Axis/timeValues.d.ts +48 -2
  952. package/types/src/components/ColorScale/ColorScale.d.ts +21 -11
  953. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  954. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  955. package/types/src/components/ColorScale/colorScaleScale.d.ts +45 -0
  956. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  957. package/types/src/components/Legend/Legend.d.ts +5 -0
  958. package/types/src/components/Legend/legendCut.d.ts +31 -0
  959. package/types/src/components/Legend/legendRender.d.ts +6 -1
  960. package/types/src/components/TextBox.d.ts +4 -0
  961. package/types/src/components/Tooltip.d.ts +11 -2
  962. package/types/src/components/textEllipsis.d.ts +6 -0
  963. package/types/src/components/tooltipDom.d.ts +24 -0
  964. package/types/src/fluent.d.ts +48 -1
  965. package/types/src/shapes/Bar.d.ts +7 -0
  966. package/types/src/shapes/Box.d.ts +15 -0
  967. package/types/src/shapes/Shape.d.ts +11 -0
  968. package/types/src/shapes/Tick.d.ts +20 -0
  969. package/types/src/shapes/boxExtraShapes.d.ts +40 -0
  970. package/types/src/shapes/boxExtras.d.ts +85 -0
  971. package/types/src/shapes/boxStyle.d.ts +25 -4
  972. package/types/src/shapes/downsample.d.ts +68 -0
  973. package/types/src/shapes/emitLabels.d.ts +1 -1
  974. package/types/src/shapes/hitAreaNode.d.ts +2 -1
  975. package/types/src/shapes/index.d.ts +1 -0
  976. package/types/src/shapes/pathSeries.d.ts +35 -0
  977. package/types/src/shapes/shapeConfig.d.ts +70 -2
  978. package/types/src/utils/BaseClass.d.ts +18 -4
  979. package/types/src/utils/D3plusConfig.d.ts +1458 -676
  980. package/types/src/utils/configValue.d.ts +8 -0
  981. package/types/src/utils/index.d.ts +1 -1
  982. package/types/src/utils/jitter.d.ts +23 -0
  983. package/types/src/utils/resetSetters.d.ts +23 -0
  984. package/types/umd-entry.d.ts +4 -0
  985. package/umd/d3plus-core.full.js +109828 -74615
  986. package/umd/d3plus-core.full.min.js +2 -2
  987. package/umd/d3plus-core.js +90460 -56685
  988. package/umd/d3plus-core.min.js +2 -2
@@ -8,6 +8,7 @@ import { axisName } from "../Plot/sharedTooltip.js";
8
8
  import { ohlcAccessors } from "./aggregate.js";
9
9
  import { candleChange, readOhlc } from "./ohlc.js";
10
10
  import { formatPeriod, periodDate } from "./periods.js";
11
+ import { configUtc } from "../../components/Axis/timeValues.js";
11
12
  import { formatVolume, readVolume } from "./volume.js";
12
13
  /**
13
14
  A price as the tooltip shows it: two decimals for values of 1 or more
@@ -16,11 +17,7 @@ import { formatVolume, readVolume } from "./volume.js";
16
17
  @param value The price.
17
18
  @param locale The chart's locale.
18
19
  */ export function formatPrice(value, locale) {
19
- if (Math.abs(value) < 1) return formatAbbreviate(value, locale, ".3~g");
20
- // formatAbbreviate drops trailing zeros; put the cents back.
21
- const decimal = formatAbbreviate(1.5, locale, ".1f").charAt(1);
22
- const [whole, cents = ""] = formatAbbreviate(value, locale, ",.2f").split(decimal);
23
- return `${whole}${decimal}${cents.padEnd(2, "0")}`;
20
+ return formatAbbreviate(value, locale, Math.abs(value) < 1 ? ".3~g" : ",.2f");
24
21
  }
25
22
  /**
26
23
  A fractional change as a signed percentage, e.g. `0.0123` as `"+1.23%"`.
@@ -37,9 +34,10 @@ import { formatVolume, readVolume } from "./volume.js";
37
34
  /** A row's period: through the x axis's `tickFormat` when set, else as a full date. */ function periodText(viz, d, i) {
38
35
  const raw = viz._x ? viz._x(d, i) : undefined;
39
36
  const tickFormat = viz._xConfig?.tickFormat;
40
- const value = periodDate(raw);
37
+ const utc = configUtc(viz._xConfig);
38
+ const value = periodDate(raw, utc);
41
39
  if (typeof tickFormat === "function") return String(tickFormat(value));
42
- return value instanceof Date ? formatPeriod(value) : String(raw ?? "");
40
+ return value instanceof Date ? formatPeriod(value, utc) : String(raw ?? "");
43
41
  }
44
42
  /**
45
43
  The tooltip rows for one period: its date, then Open, High, Low, Close,
@@ -13,6 +13,7 @@ import { clearRingLabels, ringLabelFont, ringLabelNodes } from "../features/ring
13
13
  import { ringLabelPosition } from "../features/ringLabels.js";
14
14
  import { backgroundInk } from "../viz/backgroundInk.js";
15
15
  import { chordLabelFontSize } from "./labels.js";
16
+ import { pairLabels } from "../features/labelLayering.js";
16
17
  /**
17
18
  The group labels the layout stage placed: curved ones along the ring,
18
19
  and the rest along their spokes, in the chart's ink. A spoke label that
@@ -125,7 +126,7 @@ import { chordLabelFontSize } from "./labels.js";
125
126
  ...ribbonImages
126
127
  ];
127
128
  }
128
- export const chordEmit = ({ viz })=>{
129
+ export const chordEmit = pairLabels(({ viz })=>{
129
130
  const c = viz.ctx.chordCtx;
130
131
  if (!c) return [];
131
132
  const out = [];
@@ -157,4 +158,4 @@ export const chordEmit = ({ viz })=>{
157
158
  // Group labels: curved along the ring, or along their spokes.
158
159
  if (arcData.length) out.push(...chordLabels(viz, arcData));
159
160
  return out;
160
- };
161
+ });
@@ -0,0 +1,39 @@
1
+ /**
2
+ ConnectedScatter — Scatter joining each series' points in order, with
3
+ arrowheads along the path and its first and last points labeled.
4
+ */ import { makeChart } from "../definition/makeChart.js";
5
+ import { coerceOrder, DATA_ORDER } from "../Plot/orderPath.js";
6
+ import { orderTooltipRows } from "../Plot/orderPathScene.js";
7
+ import Scatter from "../Scatter/index.js";
8
+ export const connectedScatterDef = {
9
+ name: "ConnectedScatter",
10
+ paintDriven: true,
11
+ ctx: {},
12
+ fields: [
13
+ /**
14
+ Accessor function or string key for the field that orders each
15
+ series' path, such as a year. Defaults to the order of the data.
16
+ @type {string | function}
17
+ */ {
18
+ key: "order",
19
+ default: DATA_ORDER,
20
+ coerce: coerceOrder
21
+ },
22
+ {
23
+ key: "tooltipConfig",
24
+ merge: true,
25
+ factory: (viz)=>({
26
+ tbody: (d, i)=>orderTooltipRows(viz, d, i)
27
+ })
28
+ }
29
+ ]
30
+ };
31
+ /**
32
+ Creates a connected scatterplot from an array of data: each row draws as
33
+ a point at its `x` and `y` values, and a line joins each series' points
34
+ in `order` (a field such as a year; the data's order by default), so the
35
+ line traces the path two measures took together. Arrowheads along the
36
+ line show its direction (`pathArrows`), and its first and last points are
37
+ labeled with their order values (`pathLabels`). Hover a point for its
38
+ row.
39
+ */ export default makeChart(connectedScatterDef, Scatter);
@@ -0,0 +1,162 @@
1
+ /**
2
+ CyclePlot's panels: Plot's small-multiple hooks, with room inside each
3
+ panel's ends (enough, when it can be, for the first and last cycles'
4
+ labels), each panel's x axis labeling only its first and last cycle,
5
+ and the inner panels' y axes reduced to the line between neighboring
6
+ panels, so the panels touch.
7
+
8
+ @module
9
+ */ import { textWidth } from "@d3plus/dom";
10
+ import { fontFamilyStringify } from "@d3plus/text";
11
+ import { plotFacetPanel, sharePlotScales } from "../Plot/plotFacet.js";
12
+ /** The room inside each end of a panel, as a fraction of the span of cycles it plots. */ export const CYCLE_INSET = 0.1;
13
+ /** The most room inside each end of a panel CyclePlot makes for the end labels. */ export const CYCLE_INSET_MAX = 0.5;
14
+ /** The space kept clear around each end label, in pixels. */ export const END_LABEL_GAP = 6;
15
+ /** An axis's default tick label size (see `Axis`). */ const AXIS_FONT_SIZE = 12;
16
+ /** An axis's default tick length and label padding (see `Axis`). */ const AXIS_TICK_SIZE = 8;
17
+ const AXIS_PADDING = 5;
18
+ /**
19
+ `domain` widened at each end by `fraction` of its span, keeping Dates as
20
+ Dates. A domain without a span (a single cycle) is returned as is.
21
+ */ export function insetDomain(domain, fraction) {
22
+ if (!domain || domain.length !== 2) return domain;
23
+ const [lo, hi] = domain.map(Number);
24
+ const pad = (hi - lo) * fraction;
25
+ if (!Number.isFinite(pad) || pad <= 0) return domain;
26
+ const out = [
27
+ lo - pad,
28
+ hi + pad
29
+ ];
30
+ return domain[0] instanceof Date ? out.map((v)=>new Date(v)) : out;
31
+ }
32
+ /** Where a cycle at the end of a domain widened by `inset` sits, as a fraction of the panel from its nearer end. */ const endPlace = (inset)=>inset / (1 + 2 * inset);
33
+ /**
34
+ The room inside each end of a panel (as `insetDomain`'s fraction) that
35
+ keeps the first and last cycles' labels, centered on their cycles,
36
+ inside a panel `width` pixels wide and apart from each other: at least
37
+ `CYCLE_INSET`, at most `CYCLE_INSET_MAX`. `fits` is false when no room
38
+ in that range does, and the panel draws no end labels.
39
+ @param width The panel's plot width, in pixels.
40
+ @param labels The two labels' widths, in pixels.
41
+ */ export function endLabelInset(width, labels) {
42
+ const [a, b] = labels;
43
+ if (!(width > 0)) return {
44
+ inset: CYCLE_INSET,
45
+ fits: false
46
+ };
47
+ const need = (Math.max(a, b) / 2 + END_LABEL_GAP) / width;
48
+ const most = Math.min(endPlace(CYCLE_INSET_MAX), (1 - ((a + b) / 2 + END_LABEL_GAP) / width) / 2);
49
+ const least = endPlace(CYCLE_INSET);
50
+ if (Math.max(least, need) > most) return {
51
+ inset: CYCLE_INSET,
52
+ fits: false
53
+ };
54
+ if (need <= least) return {
55
+ inset: CYCLE_INSET,
56
+ fits: true
57
+ };
58
+ return {
59
+ inset: need / (1 - 2 * need),
60
+ fits: true
61
+ };
62
+ }
63
+ /** The chart's cycle state, as its panels read it. */ const axisState = (viz)=>viz.ctx.cycle ?? {};
64
+ /** How wide `text` draws at the x axis's label style, in pixels. */ function labelWidth(viz, text) {
65
+ const label = viz._xConfig?.shapeConfig?.labelConfig;
66
+ const size = typeof label?.fontSize === "number" ? label.fontSize : AXIS_FONT_SIZE;
67
+ const own = label?.fontFamily;
68
+ const family = typeof own === "string" || Array.isArray(own) ? own : viz.schema.fontFamily;
69
+ return Number(textWidth(text, {
70
+ "font-family": fontFamilyStringify(family),
71
+ "font-size": size
72
+ }));
73
+ }
74
+ /**
75
+ The scales every panel shares (see `sharePlotScales`), with room inside
76
+ each panel's ends: enough for the first and last cycles' labels when it
77
+ can be (see `endLabelInset`), measured at the panels' size. Notes the
78
+ end cycles and, when they fit, their labels.
79
+ */ export function shareCycleScales(viz, panels) {
80
+ const scales = sharePlotScales(viz, panels);
81
+ const state = axisState(viz);
82
+ const ends = (scales.domains.x ?? []).filter((d)=>d instanceof Date);
83
+ let inset = CYCLE_INSET;
84
+ state.ends = ends.length === 2 && +ends[0] !== +ends[1] ? ends : undefined;
85
+ state.endLabels = undefined;
86
+ if (state.ends && state.endLabel) {
87
+ const texts = state.ends.map(state.endLabel);
88
+ const width = viz.schema.width - viz._margin.left - viz._margin.right;
89
+ const fit = endLabelInset(width, [
90
+ labelWidth(viz, texts[0]),
91
+ labelWidth(viz, texts[1])
92
+ ]);
93
+ inset = fit.inset;
94
+ if (fit.fits) state.endLabels = texts;
95
+ }
96
+ const domains = {
97
+ ...scales.domains
98
+ };
99
+ const padded = {
100
+ ...scales.padded
101
+ };
102
+ const x = insetDomain(domains.x, inset);
103
+ if (x) domains.x = x;
104
+ const px = insetDomain(padded.x, inset);
105
+ if (px) padded.x = px;
106
+ return {
107
+ ...scales,
108
+ domains,
109
+ padded
110
+ };
111
+ }
112
+ /**
113
+ The x axis config a panel draws with: ticks at the first and last
114
+ cycles, labeled when the panel labels its x axis and the labels fit,
115
+ unless the user's `xConfig` sets its own `ticks` or `labels`. Every key
116
+ is always set: the axis keeps config between draws.
117
+ */ export function cycleXConfig(config, user, state, labeled) {
118
+ const c = config || {};
119
+ if (user && (user.ticks !== undefined || user.labels !== undefined)) return c;
120
+ const ends = state.ends ?? [];
121
+ const format = state.endLabel;
122
+ return {
123
+ ...c,
124
+ labels: labeled && state.endLabels ? ends : [],
125
+ ticks: ends,
126
+ ...format && user?.tickFormat === undefined ? {
127
+ tickFormat: (d)=>d instanceof Date || typeof d === "number" ? format(new Date(+d)) : `${d}`
128
+ } : {}
129
+ };
130
+ }
131
+ /**
132
+ The y axis config a panel draws with: an unlabeled panel's axis has no
133
+ ticks and no padding, so its line is the edge it shares with the panel
134
+ before it. Both keys are always set: the axis keeps config between
135
+ draws.
136
+ */ export function cycleYConfig(config, labeled) {
137
+ const c = config || {};
138
+ return {
139
+ ...c,
140
+ padding: labeled ? c.padding ?? AXIS_PADDING : 0,
141
+ tickSize: labeled ? c.tickSize ?? AXIS_TICK_SIZE : 0
142
+ };
143
+ }
144
+ /** Applies a panel's shared scales and axis labels (see `plotFacetPanel`), and its x and y axis configs; returns the undo. */ export function cycleFacetPanel(viz, ctx) {
145
+ const saved = viz._yConfig;
146
+ const savedX = viz._xConfig;
147
+ const undo = plotFacetPanel(viz, ctx);
148
+ viz._yConfig = cycleYConfig(viz._yConfig, ctx.labels.y);
149
+ viz._xConfig = cycleXConfig(viz._xConfig, savedX, axisState(viz), ctx.labels.x);
150
+ return ()=>{
151
+ undo();
152
+ const restored = cycleYConfig(saved, true);
153
+ viz._yAxis?.config({
154
+ padding: restored.padding,
155
+ tickSize: restored.tickSize
156
+ });
157
+ };
158
+ }
159
+ /** CyclePlot's small-multiple hooks, layered over Plot's. */ export const cycleFacetHooks = {
160
+ share: shareCycleScales,
161
+ panel: cycleFacetPanel
162
+ };
@@ -0,0 +1,54 @@
1
+ /**
2
+ CyclePlot's mean lines: each series' mean across the cycles of one
3
+ panel, drawn as a reference line across the panel.
4
+
5
+ @module
6
+ */ /**
7
+ The mean of each series' finite values, in the order the series first
8
+ appear. Series without a finite value are left out.
9
+ @param rows The panel's rows.
10
+ @param id Each row's series.
11
+ @param value Each row's value.
12
+ */ export function cycleMeans(rows, id, value) {
13
+ const sums = new Map();
14
+ rows.forEach((d, i)=>{
15
+ const v = Number(value(d, i));
16
+ if (!Number.isFinite(v)) return;
17
+ const key = `${id(d, i)}`;
18
+ const entry = sums.get(key);
19
+ if (entry) {
20
+ entry.sum += v;
21
+ entry.count += 1;
22
+ } else sums.set(key, {
23
+ sum: v,
24
+ count: 1,
25
+ row: d,
26
+ index: i
27
+ });
28
+ });
29
+ return Array.from(sums, ([key, e])=>({
30
+ id: key,
31
+ mean: e.sum / e.count,
32
+ row: e.row,
33
+ index: e.index
34
+ }));
35
+ }
36
+ /**
37
+ The reference lines a panel draws at each series' mean (none when `mean`
38
+ is off): in the chart's text color for a single series, else in each
39
+ series' color, styled by `meanConfig`.
40
+ */ export function cycleMeanLines(viz) {
41
+ if (viz.schema.mean === false || !viz._y) return [];
42
+ const means = cycleMeans(viz._filteredData || [], viz._id, viz._y);
43
+ const config = viz.schema.meanConfig ?? {};
44
+ const fill = viz.schema.shapeConfig.fill;
45
+ const colored = means.length > 1;
46
+ return means.map((m)=>({
47
+ strokeOpacity: 1,
48
+ ...colored ? {
49
+ stroke: typeof fill === "function" ? `${fill(m.row, m.index)}` : fill
50
+ } : {},
51
+ ...config,
52
+ y: m.mean
53
+ }));
54
+ }
@@ -0,0 +1,99 @@
1
+ /**
2
+ CyclePlot's periods: which season a date falls in (its panel), the
3
+ cycle it belongs to (its place along the panel's x axis), and the
4
+ panels' titles and order. Pure date math, in local time or UTC.
5
+
6
+ @module
7
+ */ import { timeDay, timeFriday, timeMonday, timeSaturday, timeSunday, timeThursday, timeTuesday, timeWednesday, timeYear, utcDay, utcFriday, utcMonday, utcSaturday, utcSunday, utcThursday, utcTuesday, utcWednesday, utcYear } from "d3-time";
8
+ import { timeFormatLocale } from "d3-time-format";
9
+ /** Every period CyclePlot draws, in the order the docs list them. */ export const CYCLE_PERIODS = [
10
+ "month",
11
+ "quarter",
12
+ "weekday",
13
+ "hour"
14
+ ];
15
+ /** A `period` setting as a CyclePlot period, defaulting to `"month"`. */ export function resolveCyclePeriod(value) {
16
+ return CYCLE_PERIODS.includes(value) ? value : "month";
17
+ }
18
+ /** How many seasons a period's cycle holds. */ export function cyclePeriodCount(period) {
19
+ return ({
20
+ month: 12,
21
+ quarter: 4,
22
+ weekday: 7,
23
+ hour: 24
24
+ })[period];
25
+ }
26
+ /**
27
+ The season `date` falls in: its month (0–11), quarter (0–3), weekday
28
+ (0 = Sunday … 6), or hour (0–23), read in UTC with `utc`.
29
+ */ export function cyclePeriodOf(date, period, utc = false) {
30
+ switch(period){
31
+ case "quarter":
32
+ return Math.floor((utc ? date.getUTCMonth() : date.getMonth()) / 3);
33
+ case "weekday":
34
+ return utc ? date.getUTCDay() : date.getDay();
35
+ case "hour":
36
+ return utc ? date.getUTCHours() : date.getHours();
37
+ default:
38
+ return utc ? date.getUTCMonth() : date.getMonth();
39
+ }
40
+ }
41
+ const LOCAL_WEEKS = [
42
+ timeSunday,
43
+ timeMonday,
44
+ timeTuesday,
45
+ timeWednesday,
46
+ timeThursday,
47
+ timeFriday,
48
+ timeSaturday
49
+ ];
50
+ const UTC_WEEKS = [
51
+ utcSunday,
52
+ utcMonday,
53
+ utcTuesday,
54
+ utcWednesday,
55
+ utcThursday,
56
+ utcFriday,
57
+ utcSaturday
58
+ ];
59
+ /**
60
+ The start of the cycle `date` belongs to, which places it along its
61
+ panel's x axis: its year (for months and quarters), its week starting on
62
+ `weekStart` (0 = Sunday … 6, for weekdays), or its day (for hours).
63
+ */ export function cycleStartOf(date, period, utc = false, weekStart = 1) {
64
+ if (period === "weekday") return (utc ? UTC_WEEKS : LOCAL_WEEKS)[(weekStart % 7 + 7) % 7].floor(date);
65
+ if (period === "hour") return (utc ? utcDay : timeDay).floor(date);
66
+ return (utc ? utcYear : timeYear).floor(date);
67
+ }
68
+ /**
69
+ The seasons in panel order: months, quarters, and hours from the first,
70
+ weekdays from `weekStart` (0 = Sunday … 6).
71
+ */ export function cyclePeriodOrder(period, weekStart = 1) {
72
+ const count = cyclePeriodCount(period);
73
+ const start = period === "weekday" ? (weekStart % 7 + 7) % 7 : 0;
74
+ return Array.from({
75
+ length: count
76
+ }, (_, i)=>(start + i) % count);
77
+ }
78
+ /**
79
+ A season's short name, for a panel title, in a d3-time-format locale:
80
+ `"Jan"`, `"Q1"`, `"Mon"`, or an hour (`"1 PM"` where the locale writes
81
+ times with AM/PM, else `"13:00"`).
82
+ */ export function cyclePeriodLabel(index, period, locale) {
83
+ if (period === "quarter") return `${locale.quarter}${index + 1}`;
84
+ if (period === "weekday") return locale.shortDays[index] ?? `${index}`;
85
+ if (period === "hour") {
86
+ const format = timeFormatLocale(locale).utcFormat(locale.time.includes("%p") ? "%-I %p" : "%-H:00");
87
+ return format(new Date(Date.UTC(2000, 0, 1, index)));
88
+ }
89
+ return locale.shortMonths[index] ?? `${index}`;
90
+ }
91
+ /**
92
+ A cycle's label at the end of a panel's x axis, in a d3-time-format
93
+ locale: its year for months and quarters (`"1949"`), else its first
94
+ day (`"Jan 2"`), for weeks and days.
95
+ */ export function cycleEndLabel(cycle, period, locale, utc = false) {
96
+ const formats = timeFormatLocale(locale);
97
+ const spec = period === "month" || period === "quarter" ? "%Y" : "%b %-d";
98
+ return (utc ? formats.utcFormat(spec) : formats.format(spec))(cycle);
99
+ }
@@ -0,0 +1,67 @@
1
+ /**
2
+ CyclePlot's tooltips: a point's date in its season and cycle (rather
3
+ than the cycle its panel's x axis places it at), and the mean of its
4
+ series in its panel.
5
+
6
+ @module
7
+ */ import { timeFormatLocale } from "d3-time-format";
8
+ import { unwrapRow } from "../features/shareKey.js";
9
+ import { axisValue } from "../Plot/sharedTooltip.js";
10
+ import { cycleMeans } from "./cycleMeans.js";
11
+ import { cyclePeriodLabel, cyclePeriodOf } from "./cyclePeriods.js";
12
+ /**
13
+ A date as its season in its cycle, in a d3-time-format locale: a month
14
+ or quarter with its year (`"Jul 1955"`, `"Q3 1955"`), or a weekday or
15
+ hour with its date (`"Mon 1/2/2023"`, `"1/2/2023 1 PM"`).
16
+ */ export function cycleDateLabel(date, period, locale, utc = false) {
17
+ const formats = timeFormatLocale(locale);
18
+ const format = (spec)=>(utc ? formats.utcFormat(spec) : formats.format(spec))(date);
19
+ const season = cyclePeriodLabel(cyclePeriodOf(date, period, utc), period, locale);
20
+ if (period === "weekday") return `${season} ${format(locale.date)}`;
21
+ if (period === "hour") return `${format(locale.date)} ${season}`;
22
+ return `${season} ${format("%Y")}`;
23
+ }
24
+ /** Whether a row belongs to no series (data without `groupBy`). */ export function noSeries(viz, d, i) {
25
+ const id = viz._id(d, i);
26
+ return id === undefined || id === null || `${id}` === "undefined";
27
+ }
28
+ /**
29
+ The mean of `d`'s series over the rows of its panel (its season), or
30
+ undefined without one.
31
+ */ export function cycleRowMean(viz, ctx, d, i) {
32
+ const season = ctx.season(d, i);
33
+ if (season === undefined || !viz._y) return undefined;
34
+ const id = `${viz._id(d, i)}`;
35
+ const rows = (viz._filteredData || []).filter((r, k)=>ctx.season(r, k) === season && `${viz._id(r, k)}` === id);
36
+ return cycleMeans(rows, viz._id, viz._y)[0]?.mean;
37
+ }
38
+ /** The tooltip's title: the series' name, or the point's date when the data has no series. */ export function cycleTooltipTitle(viz, ctx, datum, i) {
39
+ const d = unwrapRow(datum);
40
+ if (!noSeries(viz, d, i)) return viz._drawLabel(d, i);
41
+ const date = ctx.date(d, i);
42
+ return date ? cycleDateLabel(date, ctx.period, ctx.locale, ctx.utc) : "";
43
+ }
44
+ /**
45
+ The x value a tooltip shows for a row: its date in its season and cycle
46
+ (see `cycleDateLabel`), or null for a row of no series, whose title is
47
+ its date. Undefined for other axes, or a row without a date.
48
+ */ export function cycleAxisLabel(viz, ctx, axis, datum, i) {
49
+ if (axis !== "x") return undefined;
50
+ const d = unwrapRow(datum);
51
+ const date = ctx.date(d, i);
52
+ if (!date) return undefined;
53
+ return noSeries(viz, d, i) ? null : cycleDateLabel(date, ctx.period, ctx.locale, ctx.utc);
54
+ }
55
+ /**
56
+ The rows a tooltip adds after the point's x and y values: its series'
57
+ mean in its panel (none with `mean` off).
58
+ */ export function cycleTooltipRows(viz, ctx, datum, i) {
59
+ if (viz.schema.mean === false) return [];
60
+ const mean = cycleRowMean(viz, ctx, unwrapRow(datum), i);
61
+ return mean === undefined ? [] : [
62
+ [
63
+ viz.schema.translate("Mean"),
64
+ axisValue(viz, "y", mean)
65
+ ]
66
+ ];
67
+ }
@@ -0,0 +1,197 @@
1
+ /**
2
+ CyclePlot — a LinePlot split into one touching panel per season (a
3
+ month, quarter, weekday, or hour), each plotting that season across the
4
+ cycles in the data, with a line at its mean.
5
+ */ import { assign, date } from "@d3plus/dom";
6
+ import { mean } from "d3-array";
7
+ import { findWeekStart, locale as timeLocales } from "@d3plus/locales";
8
+ import { makeChart } from "../definition/makeChart.js";
9
+ import LinePlot from "../LinePlot/index.js";
10
+ import { chartUtc } from "../Plot/plotRangeBreaks.js";
11
+ import { cycleFacetHooks } from "./cycleFacet.js";
12
+ import { cycleMeanLines } from "./cycleMeans.js";
13
+ import { cycleAxisLabel, cycleTooltipRows, cycleTooltipTitle } from "./cycleTooltip.js";
14
+ import { cycleEndLabel, cyclePeriodLabel, cyclePeriodOf, cyclePeriodOrder, cycleStartOf, resolveCyclePeriod } from "./cyclePeriods.js";
15
+ /** The mean of the values `value` reads from `rows`: how rows in the same season and cycle merge by default. */ export function meanAgg(rows, value) {
16
+ return mean(rows, (d)=>{
17
+ const v = value(d);
18
+ return typeof v === "number" ? v : undefined;
19
+ });
20
+ }
21
+ /** The chart's cycle state. */ const cycleState = (viz)=>viz.ctx.cycle;
22
+ /**
23
+ A row's date: its `x` value (the first one, for rows merged across the
24
+ same cycle), parsed in UTC with `utc`.
25
+ */ export function cycleDate(value, utc) {
26
+ const v = Array.isArray(value) ? value[0] : value;
27
+ if (v === undefined || v === null || v === "") return undefined;
28
+ const parsed = date(v, {
29
+ utc
30
+ });
31
+ return parsed instanceof Date && !isNaN(+parsed) ? parsed : undefined;
32
+ }
33
+ /** The time locale a chart names its seasons in. */ const timeLocaleOf = (viz)=>timeLocales[viz.schema.locale] ?? timeLocales["en-US"];
34
+ /** A panel's title: its season's short name in the chart's locale. */ export function cycleTitle(viz, value) {
35
+ return cyclePeriodLabel(Number(value), cycleState(viz).period, timeLocaleOf(viz));
36
+ }
37
+ /** Orders two panels by their seasons' place in the cycle (weekdays from the locale's first). */ export function cycleCompare(viz, a, b) {
38
+ const { period, weekStart } = cycleState(viz);
39
+ const order = cyclePeriodOrder(period, weekStart);
40
+ return order.indexOf(Number(a)) - order.indexOf(Number(b));
41
+ }
42
+ /** What CyclePlot's tooltips read from the chart (see `cycleTooltip.ts`). */ export function cycleTooltipContext(viz) {
43
+ const state = cycleState(viz);
44
+ return {
45
+ date: (d, i)=>cycleDate(state.source(d, i), state.utc),
46
+ season: state.facet,
47
+ period: state.period,
48
+ locale: timeLocaleOf(viz),
49
+ utc: state.utc
50
+ };
51
+ }
52
+ /**
53
+ Reads this draw's period, time zone, and week start, points `x` and
54
+ `facet` at each row's cycle and season, and averages the rows that
55
+ share both (see `meanAgg`) unless `aggs` sets the `y` key's merge.
56
+ */ export function prepareCycle(viz) {
57
+ const state = cycleState(viz);
58
+ if (viz._x !== state.cycleX && viz._x) state.source = viz._x;
59
+ state.period = resolveCyclePeriod(viz.schema.period);
60
+ state.utc = chartUtc(viz);
61
+ state.weekStart = findWeekStart(`${viz.schema.locale ?? ""}`);
62
+ const locale = timeLocaleOf(viz);
63
+ const { period, utc } = state;
64
+ state.endLabel = (cycle)=>cycleEndLabel(cycle, period, locale, utc);
65
+ state.ends = state.endLabels = undefined;
66
+ viz._x = state.cycleX;
67
+ viz.schema.facet = state.facet;
68
+ // Rows in the same season and cycle average, unless `aggs` says otherwise.
69
+ const key = viz._yKey;
70
+ const aggs = viz.schema.aggs;
71
+ if (typeof key === "string" && (!(key in aggs) || aggs[key] === meanAgg)) aggs[key] = meanAgg;
72
+ }
73
+ /**
74
+ The chart's `color`, with a row of no series (data without `groupBy`)
75
+ taking the first color of the chart's categorical palette.
76
+ */ export function cycleColor(viz, base) {
77
+ return (d, i)=>{
78
+ const c = base(d, i);
79
+ if (c !== undefined && c !== null) return c;
80
+ return viz.schema.colorDefaults.scale.range()[0];
81
+ };
82
+ }
83
+ export const cyclePlotDef = {
84
+ name: "CyclePlot",
85
+ paintDriven: true,
86
+ facet: cycleFacetHooks,
87
+ setup: (viz)=>{
88
+ const state = {
89
+ source: viz._x,
90
+ period: "month",
91
+ utc: false,
92
+ weekStart: 1,
93
+ cycleX: (d, i)=>{
94
+ const t = cycleDate(state.source(d, i), state.utc);
95
+ return t ? cycleStartOf(t, state.period, state.utc, state.weekStart) : NaN;
96
+ },
97
+ facet: (d, i)=>{
98
+ const t = cycleDate(state.source(d, i), state.utc);
99
+ return t ? cyclePeriodOf(t, state.period, state.utc) : undefined;
100
+ }
101
+ };
102
+ viz.ctx.cycle = state;
103
+ // The x axis places each cycle along its panel, labeling only the first
104
+ // and last (see `cycleFacet.ts`); the panel titles name the seasons.
105
+ viz._xConfig = assign({}, viz._xConfig ?? {}, {
106
+ padding: 0,
107
+ scale: "time"
108
+ });
109
+ // The y axis keeps its title beside its labels in a narrow first panel.
110
+ viz._yConfig = assign({}, viz._yConfig ?? {}, {
111
+ maxSize: Infinity
112
+ });
113
+ viz.schema.color = cycleColor(viz, viz.schema.color);
114
+ // The x axis plots every period of `time`, through its cycles.
115
+ viz._timeOnDiscrete = true;
116
+ viz._plotReferenceLines = ()=>cycleMeanLines(viz);
117
+ // Tooltips show each point's date, not the cycle it sits at.
118
+ viz._tooltipAxisLabel = (axis, d, i)=>cycleAxisLabel(viz, cycleTooltipContext(viz), axis, d, i);
119
+ viz.schema.facetConfig = {
120
+ padding: 0,
121
+ rows: 1,
122
+ sort: (a, b)=>cycleCompare(viz, a, b),
123
+ title: (value)=>cycleTitle(viz, value)
124
+ };
125
+ const preDraw = viz._preDraw.bind(viz);
126
+ viz._preDraw = ()=>{
127
+ prepareCycle(viz);
128
+ preDraw();
129
+ };
130
+ },
131
+ ctx: {},
132
+ fields: [
133
+ /** CyclePlot badges only the y axis on hover: the panel titles name the seasons. */ {
134
+ key: "axisHover",
135
+ default: "y"
136
+ },
137
+ /** CyclePlot names its series in the legend: lines in narrow panels leave no room to label them. */ {
138
+ key: "lineLabels",
139
+ default: false
140
+ },
141
+ /**
142
+ Draws a line across each panel at each series' mean over the
143
+ panel's cycles. On by default.
144
+ */ {
145
+ key: "mean",
146
+ default: true
147
+ },
148
+ /**
149
+ Styles the `mean` lines like a `referenceLines` entry:
150
+ `stroke` (the chart's text color for one series, else each
151
+ series' color), `strokeOpacity` (`1`), `strokeWidth`, `dash`,
152
+ `label`, and `layer`.
153
+ @type {ReferenceLineConfig}
154
+ */ {
155
+ key: "meanConfig",
156
+ merge: true,
157
+ default: {}
158
+ },
159
+ /**
160
+ The season each panel shows, read from each row's `x` date:
161
+ `"month"` (the default; one panel per month, plotted across the
162
+ years), `"quarter"` (across the years), `"weekday"` (across the
163
+ weeks, from the first day of the locale's week), or `"hour"`
164
+ (across the days).
165
+ @type {"month" | "quarter" | "weekday" | "hour"}
166
+ */ {
167
+ key: "period",
168
+ default: "month"
169
+ },
170
+ {
171
+ key: "tooltipConfig",
172
+ merge: true,
173
+ factory: (viz)=>({
174
+ title: (d, i)=>cycleTooltipTitle(viz, cycleTooltipContext(viz), d, i),
175
+ tbody: (d, i)=>cycleTooltipRows(viz, cycleTooltipContext(viz), d, i)
176
+ })
177
+ }
178
+ ]
179
+ };
180
+ /**
181
+ Creates a cycle plot (a seasonal subseries plot) from an array of data:
182
+ a LinePlot split into one panel per season, set side by side with no
183
+ gap between them. Each panel plots one season across the cycles in the
184
+ data, such as every January across the years, so a reader can compare
185
+ the seasons and see how each one changed. Each row's `x` value is its
186
+ date, and `period` picks the season: `"month"` (the default),
187
+ `"quarter"`, `"weekday"` (from the first day of the locale's week), or
188
+ `"hour"`. Rows in the same season and cycle merge into their mean (set
189
+ `aggs` for the `y` key to merge them otherwise). The panels share one y
190
+ axis, labeled on the left, each x axis labels its first and last cycle
191
+ (when both fit without overlapping), and each
192
+ draws a line at its mean (see `mean` and `meanConfig`). The panel titles
193
+ name the seasons in the chart's locale; read the dates in UTC with
194
+ `xConfig: {utc: true}`. The panels are small multiples whose `facet` is
195
+ the season, so `facetConfig` adjusts them (its `padding`, `title`, and
196
+ `titleConfig`).
197
+ */ export default makeChart(cyclePlotDef, LinePlot);