@d3plus/core 4.9.0 → 4.11.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +170 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +81 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +178 -0
  17. package/es/src/charts/ArcDiagram/events.js +144 -0
  18. package/es/src/charts/ArcDiagram/index.js +215 -0
  19. package/es/src/charts/BarChart/index.js +14 -2
  20. package/es/src/charts/BoxWhisker/index.js +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -10,11 +10,16 @@
10
10
  `vizDraw` via `runLayout(ctx, [...features])`.
11
11
  */ import { extent, sum } from "d3-array";
12
12
  import { unique } from "@d3plus/data";
13
- import { date, elem } from "@d3plus/dom";
13
+ import { date, elem, rtl as detectRTL } from "@d3plus/dom";
14
+ import { textBoxLines } from "../../components/textBoxScene.js";
14
15
  import { wholeWordFit, wholeWords } from "../../utils/wholeWords.js";
15
16
  import { zoomControlsBox, zoomControlsReach } from "../drawSteps/zoomControlsMarkup.js";
16
17
  import { getTopLeftContributions } from "../drawSteps/topLeftControls.js";
17
18
  import { topLeftControlsInset as topLeftControlsInsetRaw, topLeftControlsReach } from "../drawSteps/topLeftControlsMarkup.js";
19
+ import { effectiveDuration } from "../viz/reducedMotion.js";
20
+ import { timelineRangeBreaks } from "../Plot/plotRangeBreaks.js";
21
+ import { startingSelection } from "../pipeline/preDrawData.js";
22
+ import { classTimelineMode } from "../../components/Timeline/timelineMode.js";
18
23
  const VALID_POSITIONS = new Set([
19
24
  false,
20
25
  "top",
@@ -113,7 +118,7 @@ const VALID_POSITIONS = new Set([
113
118
  margin: claims
114
119
  };
115
120
  }
116
- /**
121
+ /* --------------------------- text-block features --------------------------- */ /** A TextBox `_textData()` row, as the text-block features read it. */ /**
117
122
  A little breathing room added to a NON-zero corner inset, on top of the
118
123
  exact pixel width the corner panel measured at. Without it, content
119
124
  insets to EXACTLY the corner box's edge — any tiny discrepancy between
@@ -144,6 +149,17 @@ const VALID_POSITIONS = new Set([
144
149
  const inset = topLeftControlsInsetRaw(viz, top, left, contributions);
145
150
  return inset > 0 ? inset + CORNER_INSET_GAP : 0;
146
151
  }
152
+ /**
153
+ How far a left or right legend/colorScale starting `top` px down the
154
+ chart, its outer edge `edge` px in from the chart's edge on that side,
155
+ must drop to start below the corner control panel on its side: the
156
+ top-left panel for `"left"`, the zoom controls for `"right"`. Zero when
157
+ that panel isn't showing, is narrower than `edge`, or ends above `top`.
158
+ */ export function sideControlsDrop(viz, position, top, edge) {
159
+ if (position === "right" && zoomControlsInset(viz, top, edge)) return zoomControlsReach(viz) - top;
160
+ if (position === "left" && topLeftControlsInset(viz, top, edge)) return topLeftControlsReach(viz, getTopLeftContributions(viz)) - top;
161
+ return 0;
162
+ }
147
163
  /**
148
164
  The combined left+right corner-panel insets for content starting `top`
149
165
  px down the chart, plus the single symmetric amount CENTERED content
@@ -289,11 +305,11 @@ const VALID_POSITIONS = new Set([
289
305
  // the title sat at the top of its claim regardless, reading noticeably
290
306
  // higher than the same-row zoom/back/search buttons beside it.
291
307
  const y = layoutMargin.top + drop + blockPadding;
292
- const lines = box.lines.map((str, i)=>({
293
- text: str,
294
- x: box.tA === "middle" ? width / 2 : box.tA === "end" ? width : 0,
295
- y: (i + 1) * lineHeight - (lineHeight - box.fS),
296
- width: box.widths?.[i] ?? 0
308
+ const rtl = detectRTL();
309
+ const placed = textBoxLines(box, width, rtl);
310
+ const lines = placed.lines.map((ln, i)=>({
311
+ ...ln,
312
+ y: (i + 1) * lineHeight - (lineHeight - box.fS)
297
313
  }));
298
314
  const panel = {
299
315
  type: "text",
@@ -304,8 +320,11 @@ const VALID_POSITIONS = new Set([
304
320
  font: {
305
321
  family: box.fF,
306
322
  size: box.fS,
307
- anchor: box.tA === "middle" || box.tA === "end" || box.tA === "start" ? box.tA : "start",
308
- baseline: "alphabetic"
323
+ anchor: placed.anchor,
324
+ baseline: "alphabetic",
325
+ ...rtl ? {
326
+ dir: "rtl"
327
+ } : {}
309
328
  },
310
329
  paint: {
311
330
  fill: box.fC,
@@ -405,14 +424,14 @@ const VALID_POSITIONS = new Set([
405
424
  condition: timelinePossible,
406
425
  enter: transform,
407
426
  parent: viz._select,
408
- duration: viz.schema.duration,
427
+ duration: effectiveDuration(viz),
409
428
  update: transform
410
429
  }).node();
411
430
  if (!timelinePossible) return {
412
431
  panel: null,
413
432
  margin: {}
414
433
  };
415
- const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(viz.schema.duration).height(viz.schema.height - layoutMargin.bottom).locale(viz.schema.locale).select(timelineGroup).ticks(ticks.sort((a, b)=>+a - +b)).width(viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right));
434
+ const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(effectiveDuration(viz)).height(viz.schema.height - layoutMargin.bottom).locale(viz.schema.locale).select(timelineGroup).ticks(ticks.sort((a, b)=>+a - +b)).width(viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right));
416
435
  // Clamp bound = the full time range (every tick); it never goes stale
417
436
  // mid-render. Clamping to `viz._filteredData`'s extent instead collapsed a
418
437
  // freshly-committed range down to the previous selection — the release
@@ -421,9 +440,10 @@ const VALID_POSITIONS = new Set([
421
440
  if (!viz._timelineSelection) {
422
441
  // First render only: default to the *filtered* extent, which the
423
442
  // synthesized default timeFilter pins to the latest period (see
424
- // vizPreDraw) — the historical default. `timelineDefault` overrides it.
425
- const filtered = extent((viz._filteredData || []).map(viz.schema.time).map((d)=>date(d)));
426
- viz._timelineSelection = viz.schema.timelineDefault || (filtered[0] ? filtered : fullExtent);
443
+ // vizPreDraw). `timelineDefault` or `timelineConfig.selection` overrides it.
444
+ // A row merged across periods holds each of their times.
445
+ const filtered = extent((viz._filteredData || []).flatMap((d, i)=>viz.schema.time(d, i)).map((d)=>date(d)));
446
+ viz._timelineSelection = startingSelection(viz) || (filtered[0] ? filtered : fullExtent);
427
447
  } else {
428
448
  if (viz._timelineSelection[0] < fullExtent[0]) viz._timelineSelection[0] = fullExtent[0];
429
449
  if (viz._timelineSelection[1] > fullExtent[1]) viz._timelineSelection[1] = fullExtent[1];
@@ -432,7 +452,16 @@ const VALID_POSITIONS = new Set([
432
452
  // Repaint the scene when playback toggles without moving the selection
433
453
  // (e.g. a manual pause), so the play/pause glyph refreshes immediately.
434
454
  timeline._onPlayToggle = ()=>viz._scheduleSceneRepaint();
435
- const config = viz.schema.timelineConfig;
455
+ // The timeline hides what its time axis hides, unless `timelineConfig`
456
+ // sets its own `rangeBreaks`.
457
+ const inherited = timelineRangeBreaks(viz);
458
+ timeline.rangeBreaks(inherited.length ? inherited : false);
459
+ // `timelineConfig.selection` is where the timeline starts (see
460
+ // `startingSelection`); after that the viewer's selection stands.
461
+ const config = {
462
+ ...viz.schema.timelineConfig
463
+ };
464
+ delete config.selection;
436
465
  timeline.config(config).on("brush", (s)=>{
437
466
  // Filter on "end", not on every brush move. Re-rendering the whole Viz
438
467
  // mid-drag re-creates the d3-brush (and starts a brush transition),
@@ -446,6 +475,7 @@ const VALID_POSITIONS = new Set([
446
475
  setTimeFilter(viz, s);
447
476
  if (config.on && config.on.end) config.on.end(s);
448
477
  }).render();
478
+ classTimelineMode(timelineGroup, "d3plus-viz-timeline", timeline._buttonBehaviorCurrent);
449
479
  return {
450
480
  panel: null,
451
481
  margin: {
@@ -8,14 +8,27 @@ import { merge } from "@d3plus/data";
8
8
  import { elem } from "@d3plus/dom";
9
9
  import { resolveSpec } from "../pipeline/resolveSpec.js";
10
10
  import { bottomRightClearance } from "../drawSteps/bottomRightControlsMarkup.js";
11
- import { sanitizePosition } from "./features.js";
11
+ import { sanitizePosition, sideControlsDrop } from "./features.js";
12
12
  import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
13
13
  import { facetKey } from "../facet/facetData.js";
14
+ import { colorScaleBucketRows } from "./colorScaleBucket.js";
15
+ import { colorScaleValue, linkColorScaleRows } from "./colorScaleValue.js";
16
+ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
17
+ import { effectiveDuration } from "../viz/reducedMotion.js";
14
18
  /**
15
19
  The colorScale's data: the chart's data rolled up per time/id (and per
16
20
  small-multiples panel, the values the panels color by), keeping rows with
17
- a colorScale value.
21
+ a colorScale value, then any links colored by number.
18
22
  */ function colorScaleData(viz) {
23
+ const links = linkColorScaleRows(viz);
24
+ if (typeof viz.schema.colorScale !== "function") return links;
25
+ const own = viz._colorScaleRows ? viz._colorScaleRows() : dataRows(viz);
26
+ return links.length ? [
27
+ ...own,
28
+ ...links
29
+ ] : own;
30
+ }
31
+ /** The chart's data rolled up per time/id/panel, keeping rows with a colorScale value. */ function dataRows(viz) {
19
32
  const facet = viz.schema.facet;
20
33
  const data = Array.from(rollup(viz._data, (leaves)=>merge(leaves, viz.schema.aggs), (d, i)=>`${viz.schema.time ? viz.schema.time(d, i) : "all"}-${facet ? facetKey(facet(d, i)) : "all"}-${viz._ids(d, i).join("_")}`).values());
21
34
  return data.filter((d, i)=>{
@@ -23,6 +36,40 @@ import { facetKey } from "../facet/facetData.js";
23
36
  return c !== undefined && c !== null;
24
37
  });
25
38
  }
39
+ /** The paint a bucket swatch takes from the chart's shapes: all but its fill. */ const SWATCH_STYLES = [
40
+ "fillOpacity",
41
+ "opacity",
42
+ "stroke",
43
+ "strokeDasharray",
44
+ "strokeLinecap",
45
+ "strokeOpacity",
46
+ "strokeWidth"
47
+ ];
48
+ /**
49
+ The `shapeConfig` that styles the colorScale's bucket swatches like the
50
+ chart's shapes, the way the legend's swatches are: each style resolves
51
+ from the chart's `shapeConfig` for the first row in the swatch's bucket
52
+ (any row, for a bucket without one), so a swatch's stroke is its shapes'
53
+ stroke. A Line row's swatch takes the shared styles, not the Line's own.
54
+ */ function bucketSwatchConfig(viz) {
55
+ // Read on first use: the buckets exist once the ColorScale builds its scale.
56
+ let rows;
57
+ const configs = new Map();
58
+ const style = (bucket, key)=>{
59
+ if (rows === undefined) rows = colorScaleBucketRows(viz);
60
+ const source = rows?.get(bucket.color) ?? rows?.values().next().value;
61
+ if (!source) return undefined;
62
+ const { row, i } = source;
63
+ const shape = viz._colorScaleShape(row, i);
64
+ const nest = shape === "Line" ? "" : shape;
65
+ if (!configs.has(nest)) configs.set(nest, shapeConfigFor(viz, nest));
66
+ return resolveAccessor(configs.get(nest)[key], row, i);
67
+ };
68
+ return Object.fromEntries(SWATCH_STYLES.map((key)=>[
69
+ key,
70
+ (d)=>style(d, key)
71
+ ]));
72
+ }
26
73
  /**
27
74
  Configures and lays out the chart's `_colorScaleClass` into `frame`. It
28
75
  always runs in compute mode: Viz.toScene composes its scene, so the
@@ -41,8 +88,13 @@ import { facetKey } from "../facet/facetData.js";
41
88
  duration: 0,
42
89
  update: transform
43
90
  }).node();
44
- if (!viz.schema.colorScale) return;
45
- viz._colorScaleClass.renderMode("compute").align(frame.align).duration(viz.schema.duration).data(colorScaleData(viz)).height(frame.height).locale(viz.schema.locale).orient(frame.orient).select(scaleGroup).value(viz.schema.colorScale).width(frame.width).config(viz.schema.colorScaleConfig).render();
91
+ const value = colorScaleValue(viz);
92
+ if (!value) return;
93
+ viz._colorScaleClass.renderMode("compute").align(frame.align).duration(effectiveDuration(viz)).data(colorScaleData(viz)).height(frame.height).locale(viz.schema.locale).orient(frame.orient).select(scaleGroup).value(value).width(frame.width).legendConfig({
94
+ shapeConfig: bucketSwatchConfig(viz)
95
+ })// Links colored by number are thin lines: keep the ramp's low end
96
+ // visible against a light background.
97
+ .ordinalRamp(linkColorScaleRows(viz).length > 0).config(viz.schema.colorScaleConfig).hover(false).render();
46
98
  }
47
99
  /** The colorScale's sanitized position side (false when hidden). */ function colorScalePosition(viz) {
48
100
  return sanitizePosition(viz.schema.colorScalePosition.bind(viz)(resolveSpec(viz)), viz);
@@ -53,7 +105,7 @@ import { facetKey } from "../facet/facetData.js";
53
105
  horizontally (`"row"`), sized against the chart area `area`. Returns its
54
106
  measured size, or null when it isn't showing.
55
107
  */ export function paintColorScaleInset(viz, orient, area) {
56
- const show = Boolean(viz.schema.colorScale) && colorScalePosition(viz) !== false && !viz.schema.colorScaleConfig.select;
108
+ const show = Boolean(colorScaleValue(viz)) && colorScalePosition(viz) !== false && !viz.schema.colorScaleConfig.select;
57
109
  const frame = insetFrame(orient, area);
58
110
  const maxSize = viz.schema.colorScaleMaxSize;
59
111
  paintColorScale(viz, {
@@ -108,13 +160,15 @@ import { facetKey } from "../facet/facetData.js";
108
160
  "top",
109
161
  "bottom"
110
162
  ].includes(position);
111
- const showColorScale = viz.schema.colorScale && position;
163
+ const showColorScale = colorScaleValue(viz) && position;
112
164
  const padding = viz.schema.colorScalePadding(viz) ? viz._padding : {
113
165
  top: 0,
114
166
  right: 0,
115
167
  bottom: 0,
116
168
  left: 0
117
169
  };
170
+ // A side colorScale starts below the corner control panel on its side.
171
+ const drop = sideControlsDrop(viz, position, layoutMargin.top, position === "left" ? layoutMargin.left : layoutMargin.right);
118
172
  // Share the bottom band with the bottom-right corner panel (size legend):
119
173
  // a bottom colorScale fits beside it, a side one ends above it.
120
174
  const corner = bottomRightClearance(viz, position, layoutMargin.bottom + padding.bottom, layoutMargin.right + padding.right);
@@ -123,14 +177,14 @@ import { facetKey } from "../facet/facetData.js";
123
177
  viz.schema.colorScaleMaxSize,
124
178
  availableWidth
125
179
  ]) : viz.schema.width - (layoutMargin.left + layoutMargin.right);
126
- const availableHeight = viz.schema.height - (layoutMargin.bottom + layoutMargin.top + padding.bottom + padding.top) - corner.drop;
180
+ const availableHeight = viz.schema.height - (layoutMargin.bottom + layoutMargin.top + padding.bottom + padding.top) - drop - corner.drop;
127
181
  const height = !wide ? min([
128
182
  viz.schema.colorScaleMaxSize,
129
183
  availableHeight
130
184
  ]) : viz.schema.height - (layoutMargin.bottom + layoutMargin.top);
131
185
  paintColorScale(viz, {
132
186
  x: wide ? layoutMargin.left + padding.left + (availableWidth - width) / 2 : layoutMargin.left,
133
- y: wide ? layoutMargin.top : layoutMargin.top + padding.top + (availableHeight - height) / 2,
187
+ y: wide ? layoutMargin.top : layoutMargin.top + padding.top + drop + (availableHeight - height) / 2,
134
188
  width,
135
189
  height,
136
190
  orient: position,
@@ -6,46 +6,34 @@
6
6
  */ import { merge } from "@d3plus/data";
7
7
  import { elem } from "@d3plus/dom";
8
8
  import { configPrep } from "../../utils/index.js";
9
- import { cornerPlacements, sanitizePosition, topLeftControlsInset, zoomControlsInset } from "./features.js";
9
+ import { constantValue } from "../../utils/constant.js";
10
+ import { cornerPlacements, sanitizePosition, sideControlsDrop } from "./features.js";
10
11
  import { bottomRightClearance } from "../drawSteps/bottomRightControlsMarkup.js";
11
- import { zoomControlsReach } from "../drawSteps/zoomControlsMarkup.js";
12
- import { getTopLeftContributions } from "../drawSteps/topLeftControls.js";
13
- import { topLeftControlsReach } from "../drawSteps/topLeftControlsMarkup.js";
14
12
  import { resolveSpec } from "../pipeline/resolveSpec.js";
15
13
  import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
16
14
  import { legendCategories, legendMergesIds } from "./legendCategory.js";
15
+ import { legendKeys, legendRows } from "./legendKeys.js";
16
+ import { effectiveDuration } from "../viz/reducedMotion.js";
17
17
  /**
18
18
  Rolls filtered legend data up by paint attributes, computes
19
19
  `viz._legendDepth` (the lowest groupBy level whose values are unique) and
20
20
  `viz._legendCategories` (see `legendCategory.ts`), then sorts it.
21
21
  Returns the `legendData` array plus the `fill`/`getAttr` accessors the
22
- render step reuses.
22
+ render step reuses. A legend set to a constant false (`legend(false)`)
23
+ gets no entries, and its depth and categories stay as they were.
23
24
  */ export function buildLegendData(viz) {
24
25
  // Source: `_legendData` from the rollupAndFilter pipeline stage — same
25
26
  // arg drawLegend received via `drawLegend.bind(this)(this._legendData)`.
26
- const data = viz._legendData || [];
27
- const getAttr = (d, i, attr)=>{
28
- const shape = viz.schema.shape(d, i);
29
- if (attr === "fill" && shape === "Line") attr = "stroke";
30
- const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
31
- return typeof value === "function" ? value.bind(viz)(d, i) : value;
32
- };
33
- // Legend grouping key: the color *encoding* input, so categories keep their
34
- // own entry even when two resolve to the same hex (#788), while
35
- // opacity/texture still split entries that differ on those secondary
36
- // encodings. Falls back to the resolved fill when there's no color accessor
37
- // to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
38
- const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
39
- const keyOf = (d, i, c)=>{
40
- const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
41
- return [
42
- colorKey,
43
- getAttr(d, i, "opacity"),
44
- getAttr(d, i, "texture")
45
- ].join("_");
46
- };
27
+ const { getAttr, colorOf, keyOf } = legendKeys(viz);
47
28
  const legendKey = (d, i)=>keyOf(d, i, colorOf(d, i));
48
- const rollupData = viz.schema.colorScale ? data.filter((d, i)=>viz.schema.colorScale(d, i) === undefined) : data;
29
+ // A legend set to a constant false never shows, so it needs no entries.
30
+ const never = constantValue(viz.schema.legend);
31
+ if (never && !never.value) return {
32
+ legendData: [],
33
+ legendKey,
34
+ getAttr
35
+ };
36
+ const rollupData = legendRows(viz);
49
37
  const groups = new Map();
50
38
  rollupData.forEach((d, i)=>{
51
39
  const c = colorOf(d, i);
@@ -78,7 +66,9 @@ import { legendCategories, legendMergesIds } from "./legendCategory.js";
78
66
  }
79
67
  // Entries that each merge several ids are labelled by their color category.
80
68
  viz._legendCategories = legendMergesIds(viz, legendData) ? legendCategories(entries) : undefined;
81
- legendData.sort(viz.schema.legendSort);
69
+ // A threshold bucket's entry comes last, whatever the sort.
70
+ const bucket = (d)=>d._isAggregation ? 1 : 0;
71
+ legendData.sort((a, b)=>bucket(a) - bucket(b) || viz.schema.legendSort(a, b));
82
72
  return {
83
73
  legendData,
84
74
  legendKey,
@@ -93,13 +83,12 @@ import { legendCategories, legendMergesIds } from "./legendCategory.js";
93
83
  (`insetRight`) and a side legend shortens to end above it (`shorten`).
94
84
  A top legend finds its own place beside them (see `paintTopLegend`).
95
85
  */ function legendCornerClearance(viz, position, layoutMargin, padding) {
96
- const dropRight = position === "right" && zoomControlsInset(viz, layoutMargin.top, layoutMargin.right) ? zoomControlsReach(viz) - layoutMargin.top : 0;
97
- const dropLeft = position === "left" && topLeftControlsInset(viz, layoutMargin.top, layoutMargin.left) ? topLeftControlsReach(viz, getTopLeftContributions(viz)) - layoutMargin.top : 0;
86
+ const drop = sideControlsDrop(viz, position, layoutMargin.top, position === "left" ? layoutMargin.left : layoutMargin.right);
98
87
  // The bottom-right corner panel (size legend): a bottom legend pulls its
99
88
  // right edge in beside it, a left/right legend stops short above it.
100
89
  const corner = bottomRightClearance(viz, position, layoutMargin.bottom + padding.bottom, layoutMargin.right + padding.right);
101
90
  return {
102
- drop: dropRight || dropLeft,
91
+ drop,
103
92
  insetRight: corner.inset,
104
93
  shorten: corner.drop
105
94
  };
@@ -131,7 +120,7 @@ import { legendCategories, legendMergesIds } from "./legendCategory.js";
131
120
  duration: 0,
132
121
  update: transform
133
122
  }).node();
134
- viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(viz.schema.duration).data(frame.visible ? legendData : []).height(frame.height).locale(viz.schema.locale).parent(viz).select(legendGroup).shape((d, i)=>{
123
+ viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(effectiveDuration(viz)).data(frame.visible ? legendData : []).height(frame.height).locale(viz.schema.locale).parent(viz).select(legendGroup).shape((d, i)=>{
135
124
  const shape = viz.schema.shape(d, i);
136
125
  return shape === "Circle" || shape === "Line" ? shape : "Rect";
137
126
  }).verticalAlign(frame.verticalAlign).width(frame.width).shapeConfig(configPrep.bind(viz)(viz.schema.shapeConfig, "legend")).shapeConfig({
@@ -0,0 +1,64 @@
1
+ /**
2
+ How the legend groups rows into entries: by the color each row encodes,
3
+ its opacity and its texture.
4
+ */ import { constantValue } from "../../utils/constant.js";
5
+ /**
6
+ The legend's key functions for a chart.
7
+ @param viz The chart.
8
+ */ export function legendKeys(viz) {
9
+ const getAttr = (d, i, attr)=>{
10
+ const shape = viz.schema.shape(d, i);
11
+ if (attr === "fill" && shape === "Line") attr = "stroke";
12
+ const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
13
+ return typeof value === "function" ? value.bind(viz)(d, i) : value;
14
+ };
15
+ // Legend grouping key: the color *encoding* input, so categories keep their
16
+ // own entry even when two resolve to the same hex (#788), while
17
+ // opacity/texture still split entries that differ on those secondary
18
+ // encodings. Falls back to the resolved fill when there's no color accessor
19
+ // to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
20
+ const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
21
+ const keyOf = (d, i, c)=>{
22
+ const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
23
+ return [
24
+ colorKey,
25
+ getAttr(d, i, "opacity"),
26
+ getAttr(d, i, "texture")
27
+ ].join("_");
28
+ };
29
+ return {
30
+ getAttr,
31
+ colorOf,
32
+ keyOf
33
+ };
34
+ }
35
+ /**
36
+ The rows the legend rolls up: `_legendData`, less the rows a colorScale
37
+ colors.
38
+ @param viz The chart.
39
+ */ export function legendRows(viz) {
40
+ const data = viz._legendData || [];
41
+ return viz.schema.colorScale ? data.filter((d, i)=>viz.schema.colorScale(d, i) === undefined) : data;
42
+ }
43
+ /**
44
+ How many entries the legend has (the number `buildLegendData` rolls its
45
+ rows into), counting no further than `limit + 1`: enough to tell whether
46
+ there are more than `limit`. A legend set to a constant false has none.
47
+ @param viz The chart.
48
+ @param limit The count past which to stop.
49
+ */ export function legendEntryCount(viz, limit = Infinity) {
50
+ const never = constantValue(viz.schema.legend);
51
+ if (never && !never.value) return 0;
52
+ const { colorOf, keyOf } = legendKeys(viz);
53
+ const keys = new Set();
54
+ const data = viz._legendData || [];
55
+ const scaled = Boolean(viz.schema.colorScale);
56
+ let j = 0;
57
+ for(let i = 0; i < data.length && keys.size <= limit; i++){
58
+ const d = data[i];
59
+ if (scaled && viz.schema.colorScale(d, i) !== undefined) continue;
60
+ keys.add(keyOf(d, j, colorOf(d, j)));
61
+ j++;
62
+ }
63
+ return keys.size;
64
+ }
@@ -2,82 +2,91 @@
2
2
  Line-label collision resolution + connector emit for the Plot paint phase.
3
3
 
4
4
  Plot's `lineLabels` feature draws a label at the end of each series line.
5
- When several series end at nearby y positions the labels overlap, so they
6
- are "bumped" apart into discrete y buckets; a thin connector line then
7
- links each bumped label back to its true series position.
5
+ When several series end at nearby y positions the labels would overlap,
6
+ so they are spread apart until none do; a thin connector line then
7
+ links each moved label back to its true series position.
8
+
9
+ Labels at a line's left end (`lineLabels: "start"` or `"both"`) are
10
+ placed the same way, apart from the right-end labels.
8
11
 
9
12
  The measure half (which series get labels + their widths) lives upstream
10
13
  as the `measurePlotLineLabels` pipeline stage. This module owns the two
11
14
  remaining pieces:
12
15
 
13
- - `bumpLineLabels` — resolve overlaps, returning the id→bumped-y map.
14
- - `emitLineLabelConnectors` — draw the connector lines for bumped labels.
16
+ - `bumpLineLabels` — resolve overlaps, returning the id→moved-y map.
17
+ - `emitLineLabelConnectors` — draw the connector lines for moved labels.
15
18
 
16
19
  This is Plot-family-specific (it depends on Line series + the rendered
17
20
  y-axis position function), not a generic cross-viz feature.
18
21
 
19
22
  @module
20
- */ import { groups, max, range } from "d3-array";
23
+ */ import { groups } from "d3-array";
21
24
  import { assign } from "@d3plus/dom";
25
+ import { lineLabelKey } from "../Plot/lineLabelSides.js";
26
+ import { spreadLabelPositions } from "../Plot/lineLabelSpread.js";
22
27
  import { collectComputed, makeShape } from "./emitHelpers.js";
28
+ /** A label's height, as a multiple of its font size, when spread apart. */ const LABEL_LINE_HEIGHT = 1.2;
23
29
  /**
24
- Resolve label overlaps within each x-group by bumping colliding labels
25
- into discrete y buckets (capped at 1/8 of the range so a label never
26
- travels too far from its series). Mutates each `LabelWidth`'s `newY`/
27
- `defaultY` in place and returns the id→bumped-y map the Line emitter and
28
- connector emit read. Must run AFTER the production y-axis has rendered —
29
- `bumpPrevious` reads `viz._yAxis._getPosition`.
30
- */ export function bumpLineLabels(viz, labelWidths, yRange) {
31
- let labelPositions = {};
32
- if (labelWidths) {
33
- groups(labelWidths, (d)=>d.xValue).forEach(([, values])=>{
34
- const minFontSize = max(values.map((d)=>d.fontSize));
35
- const yBuckets = range(yRange[0], yRange[1], minFontSize).reverse();
36
- const bumpLimit = (yRange[1] - yRange[0]) / 8;
37
- /***/ function bumpPrevious(d, i, arr) {
38
- if (!d.defaultY) d.defaultY = viz._yAxis._getPosition(d.value);
39
- if (i) {
40
- const prev = arr[i - 1];
41
- const { fontSize, padding } = d;
42
- const y = d.newY || d.defaultY;
43
- const prevY = prev.newY || prev.defaultY;
44
- if (y - fontSize / 2 - padding < prevY) {
45
- const newY = yBuckets.find((n)=>n < prevY);
46
- const change = d.defaultY - newY;
47
- if (change < bumpLimit) {
48
- prev.newY = newY;
49
- if (i) bumpPrevious(prev, i - 1, arr);
50
- }
51
- }
52
- }
30
+ Spreads one group of labels (one end, one x value) apart so none
31
+ overlap, each as close to its series as the others allow (see
32
+ `spreadLabelPositions`), and sets `newY` on each label that moved. When
33
+ the plot is too short for them all, the labels that fit keep their
34
+ places, the last of them reads "+N more" for itself and the rest
35
+ (`collapsed`), and the rest are hidden.
36
+ */ function spreadGroup(viz, values, yRange) {
37
+ const sorted = values.map((d)=>{
38
+ if (!d.defaultY) d.defaultY = viz._yAxis._getPosition(d.value);
39
+ return d;
40
+ }).sort((a, b)=>a.defaultY - b.defaultY);
41
+ const positions = spreadLabelPositions(sorted.map((d)=>d.defaultY), sorted.map((d)=>d.fontSize * LABEL_LINE_HEIGHT), yRange);
42
+ const bottom = Math.max(...yRange) + 0.5;
43
+ const fit = positions.filter((y)=>y <= bottom).length;
44
+ sorted.forEach((d, i)=>{
45
+ if (fit < sorted.length && i >= fit - 1) {
46
+ if (i === fit - 1) d.collapsed = sorted.length - i;
47
+ else {
48
+ d.hidden = true;
49
+ return;
53
50
  }
54
- values.forEach(bumpPrevious);
55
- });
56
- labelPositions = labelWidths.reduce((obj, d)=>{
57
- if (d.newY) obj[d.id] = d.newY;
58
- return obj;
59
- }, {});
60
- }
61
- return labelPositions;
51
+ }
52
+ if (Math.abs(positions[i] - d.defaultY) > 0.5) d.newY = positions[i];
53
+ });
54
+ }
55
+ /**
56
+ Resolve label overlaps within each x-group, each end of the lines on its
57
+ own: labels are spread apart until none overlap (see `spreadGroup`).
58
+ Mutates each `LabelWidth`'s `newY`/`defaultY` in place and returns the
59
+ moved-y map, keyed by `lineLabelKey`, that the Line emitter and
60
+ connector emit read. Must run AFTER the production y-axis has rendered:
61
+ it reads `viz._yAxis._getPosition`.
62
+ */ export function bumpLineLabels(viz, labelWidths, yRange) {
63
+ if (!labelWidths) return {};
64
+ groups(labelWidths, (d)=>d.side ?? "end", (d)=>d.xValue).forEach(([, xGroups])=>xGroups.forEach(([, values])=>spreadGroup(viz, values, yRange)));
65
+ return labelWidths.reduce((obj, d)=>{
66
+ if (d.newY) obj[lineLabelKey(d.side, d.id)] = d.newY;
67
+ return obj;
68
+ }, {});
62
69
  }
63
70
  /**
64
71
  Emit the connector lines for labels that were bumped (`newY` set). Each
65
72
  connector runs from the label's true series position to its bumped
66
- position. Returns the compute-mode scene nodes (empty when nothing was
73
+ position, rightward for a right-end label and leftward for a left-end one. Returns the compute-mode scene nodes (empty when nothing was
67
74
  bumped). Coords are relative to `_chartTransform`, which the chart-cells
68
75
  group applies.
69
76
  */ export function emitLineLabelConnectors(viz, labelWidths) {
70
- const labelConnectors = labelWidths.filter((d)=>d.newY !== undefined);
77
+ const labelConnectors = labelWidths.filter((d)=>d.newY !== undefined && !d.hidden);
71
78
  if (!labelConnectors.length) return [];
72
79
  const data = labelConnectors.map((d)=>assign({
73
80
  x: viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue),
74
81
  y: d.defaultY
75
82
  }, d)).concat(labelConnectors.map((d)=>assign({
76
- x: viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) + d.padding - 1,
83
+ x: d.side === "start" ? viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) - d.padding + 1 : viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) + d.padding - 1,
77
84
  y: d.newY || d.defaultY
78
85
  }, d)));
79
86
  const connectorLine = makeShape("Line").config({
80
87
  data: data,
88
+ // Each label's connector is its own line, the two ends of a series apart.
89
+ id: (d)=>d.side === "start" ? lineLabelKey("start", d.id) : d.id,
81
90
  stroke: (d)=>d.fontColor,
82
91
  x: (d)=>d.x,
83
92
  y: (d)=>d.y
@@ -0,0 +1,19 @@
1
+ /**
2
+ `linkBundle` for a chart's links: bundles their straight runs (see
3
+ `bundleEdges`) with the chart's `linkBundleConfig`, through a cache kept
4
+ on the chart, so a redraw with the links where they were reuses the
5
+ last bundling.
6
+ */ import { bundleEdges, edgeBundleCache } from "./edgeBundling.js";
7
+ /** The chart's bundling cache, created on first use. */ export function linkBundleCache(viz) {
8
+ const cache = viz.ctx.linkBundleCache;
9
+ if (cache) return cache;
10
+ const created = edgeBundleCache();
11
+ viz.ctx.linkBundleCache = created;
12
+ return created;
13
+ }
14
+ /**
15
+ Each edge's bundled path, from its source to its target, with the
16
+ chart's `linkBundleConfig`.
17
+ */ export function bundleLinkPaths(viz, edges) {
18
+ return bundleEdges(edges, viz.schema.linkBundleConfig ?? {}, linkBundleCache(viz));
19
+ }