@d3plus/core 4.10.0 → 4.12.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 (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -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 +176 -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 +101 -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 +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  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/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -1,6 +1,5 @@
1
1
  /* eslint no-cond-assign: 0*/ import { zoomTransform } from "d3-zoom";
2
2
  import { assign } from "@d3plus/dom";
3
- import { constant } from "../../utils/index.js";
4
3
  import { fieldAccessor } from "../../utils/fieldAccessor.js";
5
4
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
6
5
  import { baselineValue, setBaseline } from "./baselineDomain.js";
@@ -19,7 +18,9 @@ import Viz from "../viz/Viz.js";
19
18
  import { plotInsetRegion } from "./insetRegion.js";
20
19
  import { plotFacetHooks } from "./plotFacet.js";
21
20
  import { plotStackThreshold, plotStackThresholdLegend } from "./stackThreshold.js";
21
+ import { isPointShape } from "../viz/nearestHover.js";
22
22
  import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
23
+ import { displayName } from "../../utils/displayName.js";
23
24
  /** A y-axis config patch with its `domain` array reversed (y scales run top-down). */ function reverseDomain(patch) {
24
25
  const domain = patch?.domain;
25
26
  return Array.isArray(domain) ? {
@@ -30,6 +31,7 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
30
31
  /**
31
32
  Creates an x/y plot based on an array of data.
32
33
  */ export default class Plot extends Viz {
34
+ static _displayName = "Plot";
33
35
  _trendLine = plotDef.defaults.trendLine;
34
36
  _trendLineConfig = trendLineDefaults();
35
37
  /**
@@ -175,6 +177,13 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
175
177
  }
176
178
  return super._interactionDatum(pick, event);
177
179
  }
180
+ /**
181
+ A Plot's point marks are its Circle and Rect shapes (scatter and
182
+ bubble points, Beeswarm circles), for `hoverDistance`.
183
+ @private
184
+ */ _pointMark(node) {
185
+ return isPointShape(node);
186
+ }
178
187
  /**
179
188
  Picks the interaction point closest to a surface-local cursor position
180
189
  along the discrete axis. `event.point` is post-zoom surface space while the
@@ -264,9 +273,7 @@ import { defaultBuffers } from "../plotBuffers/defaultBuffers.js";
264
273
  return true;
265
274
  }
266
275
  /**
267
- Allows drawing custom shapes to be used as annotations in the provided x/y plot. This method accepts custom config objects for the [Shape](http://d3plus.org/docs/#Shape) class, either a single config object or an array of config objects. Each config object requires an additional parameter, the "shape", which denotes which [Shape](http://d3plus.org/docs/#Shape) sub-class to use ([Rect](http://d3plus.org/docs/#Rect), [Line](http://d3plus.org/docs/#Line), etc).
268
-
269
- Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present.
276
+ Custom shapes drawn as annotations on the plot: a [Shape](http://d3plus.org/docs/#Shape) config object, or an array of them, each with a `shape` key naming the Shape class to use (`"Rect"`, `"Line"`, …) and an optional `layer`, `"back"` (the default) or `"front"`. Three more kinds draw chart notes: `"Callout"` (wrapped text joined to a data point by a connector; see `CalloutAnnotation`), and `"ReferenceLine"` and `"ReferenceBand"` (what `referenceLines` and `referenceBands` expand into).
270
277
  */ annotations(_) {
271
278
  return arguments.length ? (this._annotations = _ instanceof Array ? _ : [
272
279
  _
@@ -278,7 +285,7 @@ Additionally, each config object can also contain an optional "layer" key, which
278
285
  return arguments.length ? (this._axisPersist = _, this) : this._axisPersist;
279
286
  }
280
287
  /**
281
- Starts the value axis (the x axis for horizontal charts) at a value: `baseline(n)` renders exactly like `yDomain([n])` (or `xDomain([n])`). Bars, areas, and stems still grow from the chart's own `0` in the Plots that draw from one (such as BarChart, AreaPlot, Histogram, and Lollipop), so with `baselineBreak` on (their default) the axis breaks back to a `0` tick and bars run through the break, with its gap cut across them, and with it off the axis stretches down to `0`. As with `yDomain([n])`, only `n` is pinned: the far end comes from the data and is rounded where the axis would round it with no domain set (left at the data when the axis config's `rounding` is "none"), and marks for values past `n` stop at the axis's edge. When every value sits at or below `n`, it ends the axis instead, like `yDomain([undefined, n])`. A bound given in `yDomain`/`xDomain` wins. Returns the chart's own baseline when none is set.
288
+ Starts the value axis at a value, like `yDomain([n])` (or `xDomain([n])` for horizontal charts); the far end comes from the data. Bars, areas, and stems still grow from `0`, so with `baselineBreak` on the axis breaks back to a `0` tick. A bound in `yDomain`/`xDomain` wins. Returns the chart's own baseline when none is set.
282
289
  */ baseline(_) {
283
290
  return arguments.length ? (setBaseline(this, _), this) : baselineValue(this);
284
291
  }
@@ -305,9 +312,7 @@ Additionally, each config object can also contain an optional "layer" key, which
305
312
  return this._buffer;
306
313
  }
307
314
  /**
308
- The confidence interval as an array of [lower, upper] bounds. Lines draw it as a shaded band; bars draw an error bar per bar, from the lower to the upper bound with a cap at each end (a stacked bar's bounds keep their distance from its value, measured from the bar's stacked end). Either bound may be `false` for a one-sided interval, and a row without a bound pinches the band onto its line. The value axis widens to fit the bounds, and tooltips list them (see `confidenceConfig.tooltip`). Pass `false` to turn the interval off.
309
-
310
- Pass an array of bands, outermost first, to draw nested bands around each line (a fan): each band is a `[lower, upper]` pair or `[lower, upper, label]`, or a `{lower, upper, label}` object, and `confidenceConfig.bandOpacity` shades them from the widest (lightest) to the narrowest (darkest). Tooltips list each band's range under its label ("Band 1", "Band 2", … when unlabeled), and bars draw the first band's error bar.
315
+ The confidence interval as `[lower, upper]` bounds (keys or accessors): lines draw a shaded band, bars an error bar. Either bound may be `false` for a one-sided interval, and the value axis widens to fit. Pass an array of bands, outermost first (`[lower, upper, label]` or `{lower, upper, label}`), to draw nested bands (a fan). `false` turns it off.
311
316
 
312
317
  @example <caption>Can be called with accessor functions or static keys:</caption>
313
318
  var data = {id: "alpha", value: 10, lci: 9, hci: 11};
@@ -330,13 +335,13 @@ Additionally, each config object can also contain an optional "layer" key, which
330
335
  return this;
331
336
  }
332
337
  /**
333
- Configuration object for shapes rendered as confidence intervals. A line's band is an Area, filled with the line's color at half opacity. A bar's error bar is a Path styled by `stroke` (default a shade darker than the bar), `strokeWidth` (default `2`), `strokeDasharray`, `strokeOpacity`, and `capWidth`: the length of each end cap, in pixels or as a percentage string of the bar's thickness (default `"50%"`). Keys nested under `Area` or `Bar` apply only to that shape's interval. With several bands, `bandOpacity` sets how each band looks where it is the innermost band drawn: an array ramps from the outermost band to the innermost (default `[0.15, 0.6]`), a number gives every band that opacity, and either replaces `fillOpacity`. `tooltip` (default `true`) lists the bounds in tooltips: a "Lower Bound" and "Upper Bound" row for a single mark, and a range after each series' value in a shared tooltip; set it to `false` to leave them out. Accepted keys: any key the Area or Path shape takes at the top level, plus `bandOpacity`, `capWidth`, `tooltip`, `Area` (Area keys), and `Bar` (Path keys and `capWidth`); any other key logs a warning.
338
+ Styles the confidence intervals: a line's band takes Area keys (filled with the line's color), and a bar's error bar takes Path keys (`stroke`, `strokeWidth`, …) plus `capWidth`, in pixels or a percentage of the bar (default `"50%"`). Keys under `Area` or `Bar` apply to that shape only. `bandOpacity` ramps nested bands' opacity (default `[0.15, 0.6]`), and `tooltip: false` leaves the bounds out of tooltips.
334
339
 
335
340
  @example
336
341
  .confidenceConfig({Bar: {stroke: "#333", capWidth: 8}, tooltip: false})
337
342
  */ confidenceConfig(_) {
338
343
  if (!arguments.length) return this._confidenceConfig;
339
- validateConfidenceConfig(this.constructor.name, _);
344
+ validateConfidenceConfig(displayName(this), _);
340
345
  this._confidenceConfig = mergeConfigBag(this, "confidenceConfig", _, this._confidenceConfig);
341
346
  return this;
342
347
  }
@@ -355,11 +360,6 @@ Additionally, each config object can also contain an optional "layer" key, which
355
360
  */ labelConnectorConfig(_) {
356
361
  return arguments.length ? (this._labelConnectorConfig = mergeConfigBag(this, "labelConnectorConfig", _, this._labelConnectorConfig), this) : this._labelConnectorConfig;
357
362
  }
358
- /**
359
- The behavior to be used when calculating the position and size of each shape's label(s). The value passed can either be the _String_ name of the behavior to be used for all shapes, or an accessor _Function_ that will be provided each data point and will be expected to return the behavior to be used for that data point. The availability and options for this method depend on the default logic for each Shape. As an example, the values "outside" or "inside" can be set for Bar shapes, whose "auto" default will calculate the best position dynamically based on the available space.
360
- */ labelPosition(_) {
361
- return arguments.length ? (this._labelPosition = typeof _ === "function" ? _ : constant(_), this) : this._labelPosition;
362
- }
363
363
  /**
364
364
  Paint for the shared tooltip's crosshair guide line (`stroke`,
365
365
  `strokeWidth`, `strokeDasharray`, `strokeOpacity`, …). Merged into the
@@ -426,8 +426,10 @@ Stacked charts always fit one line to the stack totals.
426
426
  - a value accessor, or a `{value, order}` config, to rank series by an
427
427
  aggregate of any data field.
428
428
 
429
- Unknown named strings warn and fall back to `"descending"`. If *value*
430
- is not specified, returns the current stack order.
429
+ Unknown named strings warn and fall back to `"descending"`. The
430
+ default legend lists the series in the order they stack, from the
431
+ baseline outward. If *value* is not specified, returns the current
432
+ stack order.
431
433
  */ stackOrder(_) {
432
434
  return arguments.length ? (this._stackOrder = resolveStackOrder(_), this) : this._stackOrder;
433
435
  }
@@ -23,7 +23,7 @@
23
23
  // Force all Stacked Bars to use "inside" labels.
24
24
  if (this.schema.stacked) return false;
25
25
  // Detect user "outside" or "inside" override.
26
- const labelPosition = this._labelPosition(d, i);
26
+ const labelPosition = this.schema.labelPosition(d, i);
27
27
  if (labelPosition === "outside") return true;
28
28
  else if (labelPosition === "inside") return false;
29
29
  // Run "auto" logic based on available space, against the non-discrete axis.
@@ -0,0 +1,82 @@
1
+ /**
2
+ The Line shape's label config for a Plot's `lineLabels`: the text and
3
+ bounds of each line's labels past its right end, its left end, or both,
4
+ after their collisions have been bumped apart (see
5
+ `features/lineLabels.ts`).
6
+
7
+ @module
8
+ */ import { max } from "d3-array";
9
+ import { formatAbbreviate } from "@d3plus/format";
10
+ import { lineLabelKey, lineLabelText, rowLineLabelSides } from "./lineLabelSides.js";
11
+ /**
12
+ The text one measured label shows: the series name (and its value), or,
13
+ where the plot had no room for every label, `"+N more"` on the last that
14
+ fit and nothing on the rest.
15
+ */ function entryText(inputs, measure, d, i) {
16
+ const { viz } = inputs;
17
+ if (measure.hidden) return false;
18
+ if (measure.collapsed) return `+${formatAbbreviate(measure.collapsed, viz.schema.locale)} ${viz.schema.translate("more")}`;
19
+ // A label shortened to fit its room keeps its shortened name.
20
+ const name = measure.name !== undefined ? measure.name : inputs.name === undefined || inputs.name === null ? viz._drawLabel(d, i) : typeof inputs.name === "function" ? inputs.name(d, i) : inputs.name;
21
+ return measure.valueText === undefined ? name : lineLabelText(name, measure.valueText);
22
+ }
23
+ /** The labels a line shows, left end first. */ function lineEntries(inputs, d, i) {
24
+ const { viz, labelWidths } = inputs;
25
+ if (!rowLineLabelSides(viz.schema.lineLabels, d.data, d.i).length) return [];
26
+ const entries = [];
27
+ for (const side of [
28
+ "start",
29
+ "end"
30
+ ]){
31
+ const measure = labelWidths.find((l)=>l.id === d.id && (l.side ?? "end") === side);
32
+ if (!measure) continue;
33
+ const text = entryText(inputs, measure, d, i);
34
+ if (text !== false) entries.push({
35
+ side,
36
+ text,
37
+ measure
38
+ });
39
+ }
40
+ return entries;
41
+ }
42
+ /**
43
+ The bounds of a line's label past its `side` end: right of its rightmost
44
+ point (`largest` wide, text starting there) or left of its leftmost point
45
+ (text ending there), as tall as a quarter of the chart and centered on
46
+ the label's bumped y.
47
+ */ export function lineLabelBox(points, side, largest, chartHeight, bumpedY) {
48
+ const [firstX, firstY] = points[0];
49
+ const [edgeX, edgeY] = points.reduce((a, b)=>side === "end" ? b[0] >= a[0] ? b : a : b[0] < a[0] ? b : a);
50
+ const height = chartHeight / 4;
51
+ const mod = bumpedY ? edgeY - bumpedY : 0;
52
+ return {
53
+ x: edgeX - firstX - (side === "start" ? largest : 0),
54
+ y: edgeY - firstY - height / 2 - mod,
55
+ width: largest,
56
+ height
57
+ };
58
+ }
59
+ /**
60
+ The Line shape's `label` and `labelBounds` for its line labels, and the
61
+ `textAnchor` that right-aligns the labels left of a line. A line with
62
+ one label keeps a single label; one labeled at both ends takes two.
63
+ */ export function lineLabelConfig(inputs) {
64
+ const { viz, labelWidths, largestLabel, labelPositions } = inputs;
65
+ const largestStart = max(labelWidths.filter((l)=>l.side === "start"), (l)=>l.labelWidth) ?? 0;
66
+ const sidesById = new Map();
67
+ const pick = (list)=>list.length === 1 ? list[0] : list;
68
+ return {
69
+ label: (d, i)=>{
70
+ const entries = lineEntries(inputs, d, i);
71
+ sidesById.set(d.id, entries.map((e)=>e.side));
72
+ return entries.length ? pick(entries.map((e)=>e.text)) : false;
73
+ },
74
+ labelBounds: (d, i, s)=>pick(lineEntries(inputs, d, i).map(({ side })=>lineLabelBox(s.points, side, side === "start" ? largestStart : largestLabel, viz.schema.height, labelPositions[lineLabelKey(side, d.id)]))),
75
+ textAnchor: (base)=>(d, i)=>{
76
+ const rec = d.l === undefined ? d.data : d;
77
+ const id = rec?.data?.id;
78
+ if (sidesById.get(id)?.[rec?.l] === "start") return "end";
79
+ return typeof base === "function" ? base(d, i) : base;
80
+ }
81
+ };
82
+ }
@@ -0,0 +1,51 @@
1
+ /**
2
+ Pure helpers behind a Plot's `lineLabels` and `lineLabelConfig`: which
3
+ ends of a line take a label, and the value text a label can carry.
4
+
5
+ @module
6
+ */ /**
7
+ The ends a `lineLabels` value labels, left end first: `true` and `"end"`
8
+ label the right end, `"start"` the left end, `"both"` both, and
9
+ `"along"` (a label along the line) or anything falsy neither.
10
+ */ export function lineLabelSides(value) {
11
+ if (value === "along") return [];
12
+ if (value === "both") return [
13
+ "start",
14
+ "end"
15
+ ];
16
+ if (value === "start") return [
17
+ "start"
18
+ ];
19
+ return value ? [
20
+ "end"
21
+ ] : [];
22
+ }
23
+ /**
24
+ The ends `setting` labels for row `d` (index `i`): a function setting is
25
+ called with the row, any other setting applies to every row.
26
+ */ export function rowLineLabelSides(setting, d, i) {
27
+ return lineLabelSides(typeof setting === "function" ? setting(d, i) : setting);
28
+ }
29
+ /**
30
+ Whether `setting` runs row `d`'s series name along its line (`"along"`)
31
+ instead of at an end.
32
+ */ export function rowLabelsAlong(setting, d, i) {
33
+ return (typeof setting === "function" ? setting(d, i) : setting) === "along";
34
+ }
35
+ /**
36
+ A line label's value text, or `undefined` when `config` leaves values
37
+ off: `valueFormat` when set, else `format` (the y axis's own).
38
+ */ export function lineLabelValue(config, value, d, i, format) {
39
+ if (!config?.value || value === undefined || value === null) return undefined;
40
+ const text = config.valueFormat ? config.valueFormat(value, d, i) : format(value);
41
+ return text === undefined || text === null || text === "" ? undefined : `${text}`;
42
+ }
43
+ /** A line label's text: the series name, followed by its value when there is one. */ export function lineLabelText(name, value) {
44
+ return value === undefined ? `${name}` : `${name} ${value}`;
45
+ }
46
+ /**
47
+ The key a label's bumped position is stored under: the series id for the
48
+ right end, prefixed for the left end so the two ends never share one.
49
+ */ export function lineLabelKey(side, id) {
50
+ return side === "start" ? `start:${id}` : `${id}`;
51
+ }
@@ -0,0 +1,65 @@
1
+ /**
2
+ Spreads a column of labels apart so none overlap, each as close to the
3
+ position it labels as the others allow.
4
+
5
+ @module
6
+ */ /** A run of labels that touch, placed as one. */ /**
7
+ Positions for labels centered on `desired` (sorted top to bottom), each
8
+ `sizes[i]` tall, so that no two overlap and every label stays within
9
+ `bounds` (the range its center may take). Touching labels move as a
10
+ group, centered on where they want to be, so each moves as little as the
11
+ others allow. Labels that need more room than `bounds` holds are packed
12
+ from its top and run past its bottom.
13
+ */ export function spreadLabelPositions(desired, sizes, bounds) {
14
+ const n = desired.length;
15
+ if (!n) return [];
16
+ // offsets[i]: label i's center below the first label's, packed tight.
17
+ const offsets = [
18
+ 0
19
+ ];
20
+ for(let i = 1; i < n; i++)offsets.push(offsets[i - 1] + (sizes[i - 1] + sizes[i]) / 2);
21
+ const offsetFrom = (c, i)=>offsets[i] - offsets[c.start];
22
+ const bestTop = (c)=>{
23
+ let sum = 0;
24
+ for(let i = c.start; i <= c.end; i++)sum += desired[i] - offsetFrom(c, i);
25
+ return sum / (c.end - c.start + 1);
26
+ };
27
+ const clusters = [];
28
+ for(let i = 0; i < n; i++){
29
+ let c = {
30
+ start: i,
31
+ end: i,
32
+ top: desired[i]
33
+ };
34
+ for(;;){
35
+ const prev = clusters[clusters.length - 1];
36
+ if (!prev) break;
37
+ const prevBottom = prev.top + offsetFrom(prev, prev.end);
38
+ const gap = (sizes[prev.end] + sizes[c.start]) / 2;
39
+ if (c.top >= prevBottom + gap) break;
40
+ clusters.pop();
41
+ c = {
42
+ start: prev.start,
43
+ end: c.end,
44
+ top: 0
45
+ };
46
+ c.top = bestTop(c);
47
+ }
48
+ clusters.push(c);
49
+ }
50
+ const out = [];
51
+ for (const c of clusters)for(let i = c.start; i <= c.end; i++)out.push(c.top + offsetFrom(c, i));
52
+ // Keep the column inside the bounds: push down from the top, then up from
53
+ // the bottom, then down again, so a column too tall to fit starts at the top.
54
+ const [lo, hi] = [
55
+ Math.min(...bounds),
56
+ Math.max(...bounds)
57
+ ];
58
+ out[0] = Math.max(out[0], lo);
59
+ for(let i = 1; i < n; i++)out[i] = Math.max(out[i], out[i - 1] + (sizes[i - 1] + sizes[i]) / 2);
60
+ out[n - 1] = Math.min(out[n - 1], hi);
61
+ for(let i = n - 2; i >= 0; i--)out[i] = Math.min(out[i], out[i + 1] - (sizes[i] + sizes[i + 1]) / 2);
62
+ out[0] = Math.max(out[0], lo);
63
+ for(let i = 1; i < n; i++)out[i] = Math.max(out[i], out[i - 1] + (sizes[i - 1] + sizes[i]) / 2);
64
+ return out;
65
+ }
@@ -0,0 +1,282 @@
1
+ /**
2
+ Line labels along their lines (`lineLabels: "along"`): each series' name
3
+ runs along its own line, following its curve, on the stretch a scored
4
+ search finds flattest and clearest of the other lines and labels. The
5
+ text reads upright, and a series with no clear stretch goes unlabeled.
6
+ */ import { fontExists, textWidth } from "@d3plus/dom";
7
+ import { fontFamily as defaultFontFamily } from "@d3plus/text";
8
+ import { samplePath } from "@d3plus/render";
9
+ import { shapeConfigFor } from "../features/emitHelpers.js";
10
+ import { offsetPolyline, polylineD, PolylineRuler, uprightPoints } from "../features/pathLabelGeometry.js";
11
+ import { PATH_LABEL_FONT_SIZE, pathLabelNodes } from "../features/pathLabels.js";
12
+ import { rowLabelsAlong } from "./lineLabelSides.js";
13
+ /**
14
+ Obstacle points, bucketed by cell for nearest-distance lookups. Each
15
+ point may carry a tag, so a lookup can ignore the points of the line a
16
+ label sits on.
17
+ */ export class PointGrid {
18
+ cell;
19
+ cells = new Map();
20
+ /** @param cell The cell size: lookups see obstacles this far away. */ constructor(cell){
21
+ this.cell = cell;
22
+ }
23
+ /** A cell's key: its column and row, packed into one number. */ static key(cx, cy) {
24
+ return cx * 1048576 + cy;
25
+ }
26
+ /**
27
+ Adds obstacle points.
28
+ @param points The points.
29
+ @param tag A tag `nearest` can ignore them by.
30
+ */ add(points, tag = -1) {
31
+ for (const [x, y] of points){
32
+ const k = PointGrid.key(Math.floor(x / this.cell), Math.floor(y / this.cell));
33
+ const list = this.cells.get(k);
34
+ if (list) list.push([
35
+ x,
36
+ y,
37
+ tag
38
+ ]);
39
+ else this.cells.set(k, [
40
+ [
41
+ x,
42
+ y,
43
+ tag
44
+ ]
45
+ ]);
46
+ }
47
+ }
48
+ /**
49
+ The distance from `p` to its nearest obstacle within one cell, or `Infinity`.
50
+ @param p The point.
51
+ @param ignore A tag whose points are left out.
52
+ */ nearest(p, ignore) {
53
+ const cx = Math.floor(p[0] / this.cell), cy = Math.floor(p[1] / this.cell);
54
+ let best = Infinity;
55
+ for(let dx = -1; dx <= 1; dx++)for(let dy = -1; dy <= 1; dy++){
56
+ const list = this.cells.get(PointGrid.key(cx + dx, cy + dy));
57
+ if (!list) continue;
58
+ for (const [x, y, tag] of list){
59
+ if (tag !== -1 && tag === ignore) continue;
60
+ const ex = p[0] - x, ey = p[1] - y;
61
+ const d = ex * ex + ey * ey;
62
+ if (d < best) best = d;
63
+ }
64
+ }
65
+ return Math.sqrt(best);
66
+ }
67
+ }
68
+ /**
69
+ Points every `step` pixels along a polyline.
70
+ @param points The polyline.
71
+ @param step The spacing.
72
+ */ export function resample(points, step) {
73
+ const ruler = new PolylineRuler(points);
74
+ const out = [];
75
+ for(let s = 0; s <= ruler.length; s += step){
76
+ const p = ruler.at(s);
77
+ if (p) out.push(p);
78
+ }
79
+ return out;
80
+ }
81
+ /**
82
+ How much a stretch bends: the sum of its turns, in radians.
83
+ @param points The stretch.
84
+ */ export function curvature(points) {
85
+ let total = 0;
86
+ let prev = null;
87
+ for(let i = 1; i < points.length; i++){
88
+ const dx = points[i][0] - points[i - 1][0], dy = points[i][1] - points[i - 1][1];
89
+ if (!dx && !dy) continue;
90
+ const angle = Math.atan2(dy, dx);
91
+ if (prev !== null) {
92
+ let turn = Math.abs(angle - prev);
93
+ if (turn > Math.PI) turn = 2 * Math.PI - turn;
94
+ total += turn;
95
+ }
96
+ prev = angle;
97
+ }
98
+ return total;
99
+ }
100
+ /**
101
+ The points a label along `points` would cover: its baseline and two rows
102
+ above it, up to its letters' height.
103
+ @param points The upright stretch.
104
+ @param ctx The font size and lift.
105
+ */ export function labelBand(points, ctx) {
106
+ return BAND_ROWS.flatMap((f)=>bandRow(points, ctx, f));
107
+ }
108
+ /** The rows of a label's band, as fractions of its font size above its baseline. */ const BAND_ROWS = [
109
+ 0,
110
+ 0.35,
111
+ 0.7
112
+ ];
113
+ /** One row of a label's band (see `labelBand`). */ function bandRow(points, ctx, f) {
114
+ const step = Math.max(2, ctx.fontSize / 2);
115
+ return resample(offsetPolyline(points, ctx.lift + f * ctx.fontSize), step);
116
+ }
117
+ /**
118
+ A stretch's score, lower being better: how much it bends and slopes, less
119
+ a bonus for room around its label (up to `roomReach`, weighted by
120
+ `roomWeight`); null when its label would leave the
121
+ plot or come within `minClearance` of an obstacle (another line or
122
+ label, or the edges of the band it runs in).
123
+ @param points The upright stretch.
124
+ @param ctx The obstacles, plot area, and font.
125
+ */ export function scoreStretch(points, ctx) {
126
+ const { rect, minClearance = 2 } = ctx;
127
+ let clearance = Infinity;
128
+ // Row by row, so a blocked stretch stops at its first blocked row.
129
+ for (const f of BAND_ROWS)for (const p of bandRow(points, ctx, f)){
130
+ if (p[0] < rect.x0 || p[0] > rect.x1 || p[1] < rect.y0 || p[1] > rect.y1) return null;
131
+ clearance = Math.min(clearance, ctx.grid.nearest(p, ctx.ignore));
132
+ if (clearance < minClearance) return null;
133
+ }
134
+ const [x0, y0] = points[0];
135
+ const [x1, y1] = points[points.length - 1];
136
+ const slope = Math.abs(Math.atan2(y1 - y0, x1 - x0));
137
+ const { roomReach = ctx.fontSize, roomWeight = 0.5 } = ctx;
138
+ const room = Math.min(clearance, roomReach) / roomReach;
139
+ return curvature(points) * 2 + slope * 0.5 - room * roomWeight;
140
+ }
141
+ /**
142
+ The best-scoring stretch of `length` pixels along any of a line's
143
+ pieces, upright, with where it lies, or null when every stretch is
144
+ blocked or too bent.
145
+ @param pieces The line's pieces (where its data has gaps), in pixels.
146
+ @param length The stretch's length.
147
+ @param ctx The obstacles, plot area, and font.
148
+ @param allow Which stretches may be taken, by their piece and start.
149
+ */ export function bestStretchAt(pieces, length, ctx, allow) {
150
+ let best = null;
151
+ let bestScore = Infinity;
152
+ const step = Math.max(4, ctx.fontSize / 2);
153
+ const maxTurn = ctx.maxTurn ?? Math.PI / 2;
154
+ for(let index = 0; index < pieces.length; index++){
155
+ const ruler = new PolylineRuler(pieces[index]);
156
+ for(let from = 0; from + length <= ruler.length; from += step){
157
+ if (allow && !allow(from, index)) continue;
158
+ const stretch = uprightPoints(ruler.trim(from, from + length), ctx.steep);
159
+ // A label can't follow a line that doubles back under it.
160
+ if (curvature(stretch) > maxTurn) continue;
161
+ const score = scoreStretch(stretch, ctx);
162
+ if (score !== null && score < bestScore) {
163
+ bestScore = score;
164
+ best = {
165
+ points: stretch,
166
+ piece: index,
167
+ from
168
+ };
169
+ }
170
+ }
171
+ }
172
+ return best;
173
+ }
174
+ /**
175
+ The best-scoring stretch of `length` pixels along any of a line's
176
+ pieces, upright, or null when every stretch is blocked or too bent.
177
+ @param pieces The line's pieces (where its data has gaps), in pixels.
178
+ @param length The stretch's length.
179
+ @param ctx The obstacles, plot area, and font.
180
+ */ export function bestStretch(pieces, length, ctx) {
181
+ return bestStretchAt(pieces, length, ctx)?.points ?? null;
182
+ }
183
+ /** Every drawn Line's pieces, sampled into points, with the offsets of the groups around it. */ function seriesLines(nodes) {
184
+ const out = [];
185
+ const visit = (node, ox, oy)=>{
186
+ const t = node.transform ?? {};
187
+ const x = ox + (t.x ?? 0), y = oy + (t.y ?? 0);
188
+ if (node.type === "group") node.children.forEach((c)=>visit(c, x, y));
189
+ const row = node.datum;
190
+ if (node.type !== "path" || node.shapeType !== "Line" || `${node.key}`.endsWith("::hit") || row?.shape !== "Line") return;
191
+ // Each moveto starts a piece of its own (a gap in the data).
192
+ const pieces = (node.d.match(/M[^M]*/g) ?? []).map((d)=>samplePath(d).points.map(([px, py])=>[
193
+ px + x,
194
+ py + y
195
+ ])).filter((points)=>points.length > 1);
196
+ const stroke = node.paint?.stroke;
197
+ out.push({
198
+ row,
199
+ key: `${node.key}`,
200
+ color: `${stroke ?? "#444"}`,
201
+ pieces
202
+ });
203
+ };
204
+ nodes.forEach((n)=>visit(n, 0, 0));
205
+ return out;
206
+ }
207
+ /**
208
+ The label font a shape's labelConfig sets, as plain values.
209
+ @param viz The chart.
210
+ @param shape The shape whose labelConfig to read.
211
+ */ export function labelFont(viz, shape = "Line") {
212
+ const config = shapeConfigFor(viz, shape).labelConfig ?? {};
213
+ const out = {};
214
+ for (const key of [
215
+ "fontFamily",
216
+ "fontSize",
217
+ "fontWeight"
218
+ ])if (config[key] !== undefined && typeof config[key] !== "function") out[key] = config[key];
219
+ return out;
220
+ }
221
+ /**
222
+ The labels for every series `lineLabels` runs along its line, placed one
223
+ by one so each stays clear of the lines and the labels before it. A
224
+ plot (or panel) with a single line labels none. Counts the lines and
225
+ labels into `viz._alongStats`, for the legend (see `alongLegend.ts`).
226
+ @param viz The chart.
227
+ @param marks The plot's drawn marks, its Lines among them.
228
+ @param rect The plot area.
229
+ */ export function emitAlongLabels(viz, marks, rect) {
230
+ const setting = viz.schema.lineLabels;
231
+ if (!setting) return [];
232
+ const lines = seriesLines(marks);
233
+ const along = lines.filter((l)=>rowLabelsAlong(setting, l.row.data ?? l.row, l.row.i ?? 0));
234
+ const stats = viz._alongStats;
235
+ if (stats) {
236
+ stats.series += lines.length;
237
+ stats.requested += along.length;
238
+ }
239
+ // A lone line needs no name.
240
+ if (!along.length || lines.length < 2) return [];
241
+ const font = labelFont(viz);
242
+ const fontSize = font.fontSize ?? PATH_LABEL_FONT_SIZE;
243
+ const style = {
244
+ "font-family": fontExists(font.fontFamily ?? defaultFontFamily),
245
+ "font-size": fontSize,
246
+ "font-weight": font.fontWeight ?? 600
247
+ };
248
+ const grid = new PointGrid(fontSize);
249
+ for (const line of lines)for (const piece of line.pieces)grid.add(resample(piece, 2));
250
+ const ctx = {
251
+ grid,
252
+ rect,
253
+ fontSize,
254
+ lift: 3.5
255
+ };
256
+ // A series drawn as several lines (observed and predicted, say) is named
257
+ // once: its later lines count as named when an earlier one was.
258
+ const named = new Set();
259
+ const labels = along.flatMap((line)=>{
260
+ const text = `${viz._drawLabel(line.row, line.row.i ?? 0)}`;
261
+ if (named.has(text)) {
262
+ if (stats) stats.placed++;
263
+ return [];
264
+ }
265
+ const length = textWidth(text, style) + fontSize;
266
+ const stretch = bestStretch(line.pieces, length, ctx);
267
+ if (!stretch) return [];
268
+ grid.add(labelBand(stretch, ctx));
269
+ named.add(text);
270
+ if (stats) stats.placed++;
271
+ return [
272
+ {
273
+ key: `line-label-along-${line.key}`,
274
+ text,
275
+ d: polylineD(offsetPolyline(stretch, ctx.lift)),
276
+ color: line.color,
277
+ anchor: "middle"
278
+ }
279
+ ];
280
+ });
281
+ return pathLabelNodes(viz, labels, font);
282
+ }
@@ -0,0 +1,19 @@
1
+ /**
2
+ A unique scene key for each line marker. A marker is its series and its
3
+ discrete value, or its x/y position when the chart has no discrete axis;
4
+ a series that repeats one of those numbers its repeats, so no two markers
5
+ share a key (the renderer keeps one node per key, which would give every
6
+ marker that shares one the last one's datum).
7
+ @param values The markers' points.
8
+ @param discrete The chart's discrete axis, if any.
9
+ */ export function lineMarkerKeys(values, discrete) {
10
+ const seen = new Map();
11
+ const keys = new Map();
12
+ for (const d of values){
13
+ const base = discrete ? `${d.id}_${d.discrete}` : `${d.id}_${d.x}_${d.y}`;
14
+ const n = seen.get(base) ?? 0;
15
+ seen.set(base, n + 1);
16
+ keys.set(d, n ? `${base}_${n}` : base);
17
+ }
18
+ return keys;
19
+ }