@d3plus/core 4.10.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 (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  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 +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 +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  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 +162 -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 +132 -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 +204 -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 +3 -3
  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/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,232 @@
1
+ /**
2
+ Polyline geometry for labels drawn along a line (trend line labels, line
3
+ labels that follow their series): trimming a line to the plot, keeping
4
+ its text upright, lifting it clear of the stroke, and the path `d` a
5
+ TextBox `textPath` follows.
6
+ */ /** A point in pixels. */ /**
7
+ The polyline's length.
8
+ @param points The polyline.
9
+ */ export function polylineLength(points) {
10
+ let total = 0;
11
+ for(let i = 1; i < points.length; i++)total += Math.hypot(points[i][0] - points[i - 1][0], points[i][1] - points[i - 1][1]);
12
+ return total;
13
+ }
14
+ /**
15
+ The polyline in the direction its text reads upright: left to right, or
16
+ bottom to top when it runs (near enough) straight up or down. A line
17
+ running right to left in screen space (a reversed axis, or a fit along
18
+ the y axis) is reversed, so its text never reads upside down.
19
+ @param points The polyline.
20
+ @param steep How far across, for each pixel up or down, a line can run
21
+ and still read bottom to top. Defaults to `0.02`.
22
+ */ export function uprightPoints(points, steep = 0.02) {
23
+ if (points.length < 2) return points;
24
+ const [x0, y0] = points[0];
25
+ const [x1, y1] = points[points.length - 1];
26
+ const dx = x1 - x0, dy = y1 - y0;
27
+ const upright = Math.abs(dx) < Math.abs(dy) * steep;
28
+ return (upright ? dy > 0 : dx < 0) ? [
29
+ ...points
30
+ ].reverse() : points;
31
+ }
32
+ /**
33
+ The polyline moved `distance` pixels to its left (above a line running
34
+ left to right), each vertex along the average of its segments' normals.
35
+ @param points The polyline.
36
+ @param distance How far to move it.
37
+ */ export function offsetPolyline(points, distance) {
38
+ if (points.length < 2 || !distance) return points;
39
+ const normal = (a, b)=>{
40
+ const len = Math.hypot(b[0] - a[0], b[1] - a[1]) || 1;
41
+ return [
42
+ (b[1] - a[1]) / len,
43
+ -(b[0] - a[0]) / len
44
+ ];
45
+ };
46
+ // Each segment's normal, shared by the vertices at its ends.
47
+ const normals = points.slice(1).map((p, i)=>normal(points[i], p));
48
+ return points.map((p, i)=>{
49
+ const before = i > 0 ? normals[i - 1] : null;
50
+ const after = i < points.length - 1 ? normals[i] : null;
51
+ const n = before && after ? [
52
+ before[0] + after[0],
53
+ before[1] + after[1]
54
+ ] : before ?? after;
55
+ const len = Math.hypot(n[0], n[1]) || 1;
56
+ return [
57
+ p[0] + n[0] / len * distance,
58
+ p[1] + n[1] / len * distance
59
+ ];
60
+ });
61
+ }
62
+ /**
63
+ The stretch of the polyline from `from` to `to` pixels along it, its ends
64
+ interpolated.
65
+ @param points The polyline.
66
+ @param from The distance along it where the stretch starts.
67
+ @param to The distance along it where the stretch ends.
68
+ */ export function trimPolyline(points, from, to) {
69
+ const out = [];
70
+ let walked = 0;
71
+ for(let i = 1; i < points.length; i++){
72
+ const [ax, ay] = points[i - 1];
73
+ const [bx, by] = points[i];
74
+ const len = Math.hypot(bx - ax, by - ay);
75
+ const next = walked + len;
76
+ const at = (s)=>{
77
+ const t = len ? (s - walked) / len : 0;
78
+ return [
79
+ ax + (bx - ax) * t,
80
+ ay + (by - ay) * t
81
+ ];
82
+ };
83
+ if (next >= from && walked <= to) {
84
+ if (!out.length) out.push(at(Math.max(from, walked)));
85
+ if (next <= to) out.push([
86
+ bx,
87
+ by
88
+ ]);
89
+ else {
90
+ out.push(at(to));
91
+ break;
92
+ }
93
+ }
94
+ walked = next;
95
+ }
96
+ return out;
97
+ }
98
+ /**
99
+ A polyline with the distance along it to each of its points, for taking
100
+ many stretches or samples of it in one pass: `trim` and `at` give what
101
+ `trimPolyline` does, but start from the first segment the stretch
102
+ reaches instead of the polyline's first point. Walking forward is
103
+ cheapest; a shorter distance than the last searches back.
104
+ */ export class PolylineRuler {
105
+ points;
106
+ /** The polyline's length. */ length;
107
+ /** The distance along the polyline to each point. */ cum;
108
+ /** The segment (its end point's index) the last lookup stopped at. */ i = 1;
109
+ /** @param points The polyline. */ constructor(points){
110
+ this.points = points;
111
+ const cum = [
112
+ 0
113
+ ];
114
+ let walked = 0;
115
+ for(let i = 1; i < points.length; i++){
116
+ walked += Math.hypot(points[i][0] - points[i - 1][0], points[i][1] - points[i - 1][1]);
117
+ cum.push(walked);
118
+ }
119
+ this.cum = cum;
120
+ this.length = walked;
121
+ }
122
+ /** The first segment ending `distance` or more along the polyline (`points.length` when none does). */ seek(distance) {
123
+ const { cum } = this;
124
+ const n = this.points.length;
125
+ let i = this.i;
126
+ if (i > 1 && cum[i - 1] >= distance) {
127
+ let lo = 1, hi = i - 1;
128
+ while(lo < hi){
129
+ const mid = lo + hi >> 1;
130
+ if (cum[mid] >= distance) hi = mid;
131
+ else lo = mid + 1;
132
+ }
133
+ i = lo;
134
+ }
135
+ while(i < n && cum[i] < distance)i++;
136
+ this.i = i;
137
+ return i;
138
+ }
139
+ /**
140
+ The stretch from `from` to `to` pixels along the polyline, the same
141
+ points `trimPolyline` gives.
142
+ @param from The distance along it where the stretch starts.
143
+ @param to The distance along it where the stretch ends.
144
+ */ trim(from, to) {
145
+ const { points, cum } = this;
146
+ const out = [];
147
+ // Every segment before the first one reaching `from` adds nothing.
148
+ for(let i = this.seek(from); i < points.length; i++){
149
+ const [ax, ay] = points[i - 1];
150
+ const [bx, by] = points[i];
151
+ const len = Math.hypot(bx - ax, by - ay);
152
+ const walked = cum[i - 1];
153
+ const next = cum[i];
154
+ const at = (s)=>{
155
+ const t = len ? (s - walked) / len : 0;
156
+ return [
157
+ ax + (bx - ax) * t,
158
+ ay + (by - ay) * t
159
+ ];
160
+ };
161
+ if (next >= from && walked <= to) {
162
+ if (!out.length) out.push(at(Math.max(from, walked)));
163
+ if (next <= to) out.push([
164
+ bx,
165
+ by
166
+ ]);
167
+ else {
168
+ out.push(at(to));
169
+ break;
170
+ }
171
+ }
172
+ }
173
+ return out;
174
+ }
175
+ /**
176
+ The point `distance` pixels along the polyline, as `trimPolyline`'s
177
+ first point for a stretch from there to there, or undefined past its
178
+ end.
179
+ @param distance The distance along it.
180
+ */ at(distance) {
181
+ const i = this.seek(distance);
182
+ if (i >= this.points.length || !(this.cum[i - 1] <= distance)) return undefined;
183
+ const [ax, ay] = this.points[i - 1];
184
+ const [bx, by] = this.points[i];
185
+ const len = Math.hypot(bx - ax, by - ay);
186
+ const walked = this.cum[i - 1];
187
+ const t = len ? (Math.max(distance, walked) - walked) / len : 0;
188
+ return [
189
+ ax + (bx - ax) * t,
190
+ ay + (by - ay) * t
191
+ ];
192
+ }
193
+ }
194
+ /**
195
+ The longest run of consecutive points inside `rect`: the part of a line a
196
+ label can sit on where the plot's domains don't cut it off.
197
+ @param points The polyline.
198
+ @param rect The plot area.
199
+ */ export function visibleRun(points, rect) {
200
+ const inside = ([x, y])=>x >= rect.x0 - 0.5 && x <= rect.x1 + 0.5 && y >= rect.y0 - 0.5 && y <= rect.y1 + 0.5;
201
+ let best = [];
202
+ let run = [];
203
+ for (const p of points){
204
+ if (Number.isFinite(p[0]) && Number.isFinite(p[1]) && inside(p)) run.push(p);
205
+ else run = [];
206
+ if (polylineLength(run) > polylineLength(best)) best = run.slice();
207
+ }
208
+ return best;
209
+ }
210
+ /**
211
+ The SVG path `d` through a polyline's points.
212
+ @param points The polyline.
213
+ */ export function polylineD(points) {
214
+ const r = (n)=>Math.round(n * 100) / 100;
215
+ return points.map(([x, y], i)=>`${i ? "L" : "M"}${r(x)},${r(y)}`).join("");
216
+ }
217
+ /**
218
+ The plot area's edges from its x and y ranges, the y range shifted up by
219
+ the top x axis's height, as the plot's clip reads them.
220
+ @param xRange The x range in pixels.
221
+ @param yRange The y range in pixels.
222
+ @param x2Height The top x axis's height.
223
+ */ export function plotEdges(xRange, yRange, x2Height = 0) {
224
+ const xs = xRange.slice(0, 2).map(Number);
225
+ const ys = yRange.slice(0, 2).map((r)=>Number(r) - x2Height);
226
+ return {
227
+ x0: Math.min(...xs),
228
+ y0: Math.min(...ys),
229
+ x1: Math.max(...xs),
230
+ y1: Math.max(...ys)
231
+ };
232
+ }
@@ -0,0 +1,50 @@
1
+ /**
2
+ Labels drawn along a line with a TextBox `textPath`: in their line's
3
+ color, legible on the chart's background, over a halo of that background,
4
+ and inert (no hover, click, or keyboard stop). A label given its mark's
5
+ datum dims and highlights with that mark.
6
+ */ import TextBox from "../../components/TextBox.js";
7
+ import { legibleOn } from "../../utils/themeInk.js";
8
+ import { chartBackground } from "../viz/backgroundInk.js";
9
+ import { textHalo } from "./textHalo.js";
10
+ /** The label font size when a config sets none. */ export const PATH_LABEL_FONT_SIZE = 11;
11
+ /**
12
+ The scene nodes for labels along paths, each cut short with an ellipsis
13
+ when its path is too short for it.
14
+ @param viz The chart, for its theme, background, and locale.
15
+ @param labels The labels.
16
+ @param config TextBox config laid over the defaults.
17
+ @param options Whether the text takes a halo.
18
+ */ export function pathLabelNodes(viz, labels, config = {}, options = {}) {
19
+ if (!labels.length) return [];
20
+ const dark = Boolean(viz._theme?.dark);
21
+ const box = new TextBox().renderMode("compute").locale(viz.schema.locale).data(labels.map((l)=>({
22
+ ...l,
23
+ id: l.key
24
+ }))).config({
25
+ fontSize: PATH_LABEL_FONT_SIZE,
26
+ fontWeight: 600,
27
+ fontColor: (d)=>legibleOn(d.color, dark),
28
+ text: (d)=>d.text,
29
+ textAnchor: (d)=>d.anchor,
30
+ textPath: (d)=>d.d,
31
+ truncateWord: true,
32
+ x: 0,
33
+ y: 0,
34
+ ...config
35
+ });
36
+ const scene = box.toScene().children;
37
+ const nodes = options.halo === false ? scene : textHalo(scene, chartBackground(viz), 3);
38
+ return nodes.map((node)=>{
39
+ const label = node.datum;
40
+ return {
41
+ ...node,
42
+ interactive: false,
43
+ datum: label?.datum,
44
+ index: label?.index ?? node.index,
45
+ aria: {
46
+ hidden: true
47
+ }
48
+ };
49
+ });
50
+ }
@@ -4,6 +4,9 @@
4
4
  shapes, and grouped into inert, stably-keyed scene groups.
5
5
  */ import { markSharedConfig } from "../../utils/configWarnings.js";
6
6
  import { makeShape } from "./emitHelpers.js";
7
+ import { effectiveDuration } from "../viz/reducedMotion.js";
8
+ import { calloutNodes } from "./calloutScene.js";
9
+ import { expandReferenceBands, expandReferenceLines, REFERENCE_BAND, REFERENCE_LINE, referenceBandNodes, referenceLineNodes } from "./referenceAnnotations.js";
7
10
  /**
8
11
  Annotations are decorative chrome, not data marks. Stamp their scene nodes
9
12
  `interactive: false` so the renderer's hit-test skips them: they fire no
@@ -61,7 +64,7 @@ import { makeShape } from "./emitHelpers.js";
61
64
  const config = Object.assign({}, annotation);
62
65
  delete config.shape;
63
66
  delete config.layer;
64
- const inst = makeShape(annotation.shape).renderMode("compute").duration(viz.schema.duration).config(config).config(markSharedConfig({
67
+ const inst = makeShape(annotation.shape).renderMode("compute").duration(effectiveDuration(viz)).config(config).config(markSharedConfig({
65
68
  x: (d)=>d.x2 ? x(d.x2, "x2") : x(d.x),
66
69
  x0: viz.schema.discrete === "x" ? (d)=>d.x2 ? x(d.x2, "x2") : x(d.x) : x(domains.x[0]),
67
70
  x1: viz.schema.discrete === "x" ? null : (d)=>d.x2 ? x(d.x2, "x2") : x(d.x),
@@ -72,27 +75,63 @@ import { makeShape } from "./emitHelpers.js";
72
75
  inst.render();
73
76
  return inst;
74
77
  }
78
+ /** The annotation kinds drawn straight into the scene rather than through a Shape class. */ const SCENE_ANNOTATIONS = {
79
+ Callout: calloutNodes,
80
+ [REFERENCE_BAND]: referenceBandNodes,
81
+ [REFERENCE_LINE]: referenceLineNodes
82
+ };
83
+ /**
84
+ The layer an annotation draws in: its own `layer`, else `"front"` for a
85
+ callout and `"back"` for everything else.
86
+ @param annotation The annotation.
87
+ */ export function annotationLayer(annotation) {
88
+ return annotation.layer || (annotation.shape === "Callout" ? "front" : "back");
89
+ }
90
+ /**
91
+ Every annotation a Plot draws: its `referenceBands`, then its
92
+ `referenceLines` (so lines draw over bands), then its own `annotations`.
93
+ @param viz The chart.
94
+ */ export function plotAnnotationList(viz) {
95
+ const own = viz._annotations || [];
96
+ return [
97
+ ...expandReferenceBands(viz.schema.referenceBands),
98
+ ...expandReferenceLines(viz.schema.referenceLines),
99
+ ...own.filter((d)=>!!d && typeof d.shape === "string")
100
+ ];
101
+ }
75
102
  /**
76
103
  Renders back/front annotations, pushing back-layer scenes onto `out` and
77
- returning the front-layer shape instances for later absorption.
78
- */ export function emitAnnotations(viz, out, x, y, domains, yOffset) {
79
- // Annotations run in `renderMode("compute")` and their scenes are
80
- // absorbed into `_chartScene`. Layering: "back" annotations absorb here
81
- // (before the main shape loop below); "front" annotations queue and
82
- // absorb AFTER the shape loop, giving back → shapes → front.
83
- const frontAnnotationShapes = [];
84
- const renderAnnotation = (annotation)=>renderPlotAnnotation(viz, annotation, x, y, domains, yOffset);
104
+ returning the front-layer groups, which the caller places above the data
105
+ shapes. A back-layer reference line or band's label joins the front
106
+ groups, so the data never covers it.
107
+ */ export function emitAnnotations(viz, out, axes, domains, yOffset) {
108
+ // Shape annotations run in `renderMode("compute")` and their scenes are
109
+ // absorbed into `_chartScene`; callouts and reference lines and bands
110
+ // build their nodes straight from the frame. Layering: "back" groups
111
+ // push here (before the main shape loop), "front" groups return to be
112
+ // pushed AFTER the shape loop, giving back → shapes → front.
113
+ const { x, y, frame } = axes;
114
+ const front = [];
115
+ const all = plotAnnotationList(viz);
85
116
  Object.keys(viz._previousAnnotations).forEach((layer)=>{
86
- const annotationData = viz._annotations.filter((d)=>layer === "back" && !d.layer || d.layer === layer);
87
- const annotationShapes = annotationData.map((d)=>d.shape);
117
+ const annotationData = all.filter((d)=>annotationLayer(d) === layer);
88
118
  annotationData.forEach((annotation, i)=>{
89
- const inst = renderAnnotation(annotation);
90
- if (layer === "front") frontAnnotationShapes.push(inst);
91
- else {
92
- const group = collectAnnotationGroup(inst, `annotation-${layer}-${i}`);
93
- if (group) out.push(group);
119
+ const key = `annotation-${layer}-${i}`;
120
+ const sceneKind = SCENE_ANNOTATIONS[annotation.shape];
121
+ if (!sceneKind) {
122
+ const group = collectAnnotationGroup(renderPlotAnnotation(viz, annotation, x, y, domains, yOffset), key);
123
+ if (group) (layer === "front" ? front : out).push(group);
124
+ return;
94
125
  }
126
+ const nodes = sceneKind(viz, annotation, frame, key);
127
+ // A reference line or band behind the data keeps its label above it.
128
+ const lift = layer === "back" && annotation.shape !== "Callout";
129
+ const group = annotationSceneGroup(lift ? nodes.filter((n)=>n.type !== "text") : nodes, key);
130
+ if (group) (layer === "front" ? front : out).push(group);
131
+ const labels = lift && annotationSceneGroup(nodes.filter((n)=>n.type === "text"), `${key}-labels`);
132
+ if (labels) front.push(labels);
95
133
  });
134
+ const annotationShapes = annotationData.map((d)=>d.shape).filter((shape)=>!SCENE_ANNOTATIONS[shape]);
96
135
  // Exits: render with empty data in compute mode so their scenes go
97
136
  // empty; no DOM to clean up.
98
137
  const exitAnnotations = viz._previousAnnotations[layer].filter((d)=>!annotationShapes.includes(d));
@@ -101,5 +140,17 @@ import { makeShape } from "./emitHelpers.js";
101
140
  });
102
141
  viz._previousAnnotations[layer] = annotationShapes;
103
142
  });
104
- return frontAnnotationShapes;
143
+ return front;
144
+ }
145
+ /** Wraps scene-built annotation nodes in their own inert, stably-keyed group, or null when there are none. */ function annotationSceneGroup(children, key) {
146
+ if (!children.length) return null;
147
+ const group = {
148
+ type: "group",
149
+ key,
150
+ children
151
+ };
152
+ markAnnotationsInert([
153
+ group
154
+ ]);
155
+ return group;
105
156
  }
@@ -16,12 +16,20 @@ import { breakLineNodes, maskBreaks } from "../Plot/plotBreaks.js";
16
16
  import { clipToPlotArea } from "../Plot/domainClip.js";
17
17
  import { collectComputed, makeShape } from "./emitHelpers.js";
18
18
  import { emitLineLabelConnectors } from "./lineLabels.js";
19
- import { collectAnnotationGroup, emitAnnotations } from "./plotAnnotations.js";
19
+ import { emitAnnotations } from "./plotAnnotations.js";
20
+ import { plotAnnotationFrame } from "./annotationFrame.js";
21
+ import { placeReferenceLabels } from "./referenceLabelPlacement.js";
22
+ import { markBoxes } from "./sceneBounds.js";
20
23
  import { emitShape } from "./shapeEmit.js";
21
24
  import { barHitsFirst } from "../Plot/barHitArea.js";
22
25
  import { emitTrendLines } from "../Plot/trendScene.js";
26
+ import { emitTrendLabels } from "../Plot/trendLabels.js";
27
+ import { emitAlongLabels } from "../Plot/lineLabelsAlong.js";
28
+ import { emitAreaLabels } from "../Plot/areaLabelsAlong.js";
29
+ import { plotEdges } from "./pathLabelGeometry.js";
23
30
  import { emitForecast, forecastRows } from "../Plot/forecastScene.js";
24
31
  import { markSharedConfig } from "../../utils/configWarnings.js";
32
+ import { effectiveDuration } from "../viz/reducedMotion.js";
25
33
  /**
26
34
  Emits the background Rect into `out` (prepended) when a non-transparent
27
35
  `backgroundConfig.fill` is set; no-op otherwise.
@@ -55,7 +63,7 @@ import { markSharedConfig } from "../../utils/configWarnings.js";
55
63
  const discrete = viz.schema.discrete || "x";
56
64
  return markSharedConfig({
57
65
  discrete: viz.schema.discrete,
58
- duration: viz.schema.duration,
66
+ duration: effectiveDuration(viz),
59
67
  label: (d)=>viz._drawLabel(d.data, d.i),
60
68
  x: (d)=>d.x2 !== undefined ? x(d.x2, "x2") : x(d.x),
61
69
  x0: discrete === "x" ? (d)=>d.x2 ? x(d.x2, "x2") : x(d.x) : x(typeof viz.schema.baseline === "number" ? viz.schema.baseline : domains.x[0]),
@@ -113,7 +121,8 @@ import { markSharedConfig } from "../../utils/configWarnings.js";
113
121
  barLabelsOnAxis: pCtx.barLabelsOnAxis,
114
122
  insetBottom: mCtx.insetBottom ?? 0,
115
123
  x2Height: pCtx.x2Height,
116
- zoomRanges: pCtx.zoomRanges
124
+ zoomRanges: pCtx.zoomRanges,
125
+ missingRows: pCtx.missingRows
117
126
  };
118
127
  out.push(...barHitsFirst(shapeData.flatMap(([key, values])=>emitShape({
119
128
  ...shapeCtx,
@@ -216,9 +225,23 @@ const isGridNode = (node)=>typeof node.key === "string" && node.key.startsWith("
216
225
  x2Height: pCtx.x2Height
217
226
  }));
218
227
  out.push(...emitLineLabelConnectors(viz, labelWidths));
219
- const frontAnnotationShapes = emitAnnotations(viz, out, x, y, domains, yOffset);
220
- // The forecast backdrop, rule and label sit behind the data marks.
221
228
  const forecast = forecastRows(shapeData);
229
+ const frame = plotAnnotationFrame(viz, {
230
+ x,
231
+ y,
232
+ xRange,
233
+ yRange,
234
+ x2Height: pCtx.x2Height,
235
+ x2Exists: pCtx.x2Exists,
236
+ y2Exists: pCtx.y2Exists,
237
+ slots: forecast.slots
238
+ });
239
+ const frontAnnotations = emitAnnotations(viz, out, {
240
+ x,
241
+ y,
242
+ frame
243
+ }, domains, yOffset);
244
+ // The forecast backdrop, rule and label sit behind the data marks.
222
245
  out.push(...emitForecast(viz, forecast.rows, {
223
246
  x,
224
247
  y,
@@ -240,6 +263,12 @@ const isGridNode = (node)=>typeof node.key === "string" && node.key.startsWith("
240
263
  // plot's axes, clear of the plot's clips and masks.
241
264
  const shapeAxes = takeAxisNodes(marks, shapesStart);
242
265
  if (viz._plotUnderlay) marks.splice(shapesStart, 0, ...viz._plotUnderlay(marks.slice(shapesStart), x, y));
266
+ // Labels along the lines and the stacked bands sit above the marks.
267
+ const edges = plotEdges(xRange, yRange, pCtx.x2Height);
268
+ // Trend labels go last, to clear the line labels.
269
+ marks.push(...emitAlongLabels(viz, marks, edges));
270
+ marks.push(...emitAreaLabels(viz, marks, edges));
271
+ marks.push(...emitTrendLabels(viz, x, y, edges, marks));
243
272
  // The plot area reaches down through any room reserved under the value
244
273
  // axis's range (see `_plotInsetBottom`), so marks drawn there stay.
245
274
  const clipRange = [
@@ -253,12 +282,9 @@ const isGridNode = (node)=>typeof node.key === "string" && node.key.startsWith("
253
282
  yOffset
254
283
  }));
255
284
  emitShapeExits(viz, shapeData, shapeConfig);
256
- // Absorb queued front annotations AFTER the shape loop so they render
257
- // above shapes.
258
- frontAnnotationShapes.forEach((inst, i)=>{
259
- const group = collectAnnotationGroup(inst, `annotation-front-${i}`);
260
- if (group) out.push(group);
261
- });
285
+ // Front annotations go AFTER the shape loop so they render above shapes,
286
+ // with reference labels moved clear of the data labels.
287
+ out.push(...placeReferenceLabels(frontAnnotations, markBoxes(marks, undefined, notText, true), frame.plot));
262
288
  // A zoomable plot keeps everything but the axes in one stably-keyed group
263
289
  // that clips to the plot rect while zoomed (see `Plot/plotZoom.ts`), so
264
290
  // rescaled shapes can't paint over the axes. The group is emitted
@@ -292,6 +318,7 @@ const isGridNode = (node)=>typeof node.key === "string" && node.key.startsWith("
292
318
  ] : []
293
319
  ];
294
320
  }
321
+ /** Whether a node is neither a group nor text, so `markBoxes` skips it when collecting label boxes. */ const notText = (node)=>node.type !== "group" && node.type !== "text";
295
322
  /** Removes the axis-tagged nodes from `nodes` (from index `start` on) and returns them. */ function takeAxisNodes(nodes, start) {
296
323
  const axes = [];
297
324
  for(let i = nodes.length - 1; i >= start; i--)if (nodes[i].interactionGroup === "axis") axes.unshift(...nodes.splice(i, 1));
@@ -0,0 +1,129 @@
1
+ /**
2
+ Measuring and drawing polylines: a sampled curve, a map's projected
3
+ link, or a bundled edge, as a list of `[x, y]` points.
4
+ */ const round = (n)=>Math.round(n * 100) / 100;
5
+ /** A polyline as a path `d`. */ export function polylinePath(points) {
6
+ return points.map(([x, y], k)=>`${k ? "L" : "M"}${round(x)},${round(y)}`).join("");
7
+ }
8
+ /**
9
+ A polyline shortened along its length by `start` pixels at its first
10
+ end and `end` at its last. When the cuts meet, it collapses to the
11
+ point where they do.
12
+ */ export function trimPolyline(points, start, end) {
13
+ const length = polylineLength(points);
14
+ const s = Math.max(0, start);
15
+ const e = Math.max(0, end);
16
+ if (!s && !e) return points.slice();
17
+ if (s + e >= length) {
18
+ const at = polylineAt(points, length * s / (s + e || 1));
19
+ return [
20
+ [
21
+ at.x,
22
+ at.y
23
+ ],
24
+ [
25
+ at.x,
26
+ at.y
27
+ ]
28
+ ];
29
+ }
30
+ const out = [];
31
+ let walked = 0;
32
+ const first = polylineAt(points, s);
33
+ const last = polylineAt(points, length - e);
34
+ out.push([
35
+ first.x,
36
+ first.y
37
+ ]);
38
+ for(let k = 1; k < points.length - 1; k++){
39
+ walked += Math.hypot(points[k][0] - points[k - 1][0], points[k][1] - points[k - 1][1]);
40
+ if (walked > s && walked < length - e) out.push(points[k]);
41
+ }
42
+ out.push([
43
+ last.x,
44
+ last.y
45
+ ]);
46
+ return out;
47
+ }
48
+ /** A polyline's length. */ export function polylineLength(points) {
49
+ let length = 0;
50
+ for(let k = 1; k < points.length; k++)length += Math.hypot(points[k][0] - points[k - 1][0], points[k][1] - points[k - 1][1]);
51
+ return length;
52
+ }
53
+ /**
54
+ The point `distance` along a polyline from its start (clamped to its
55
+ ends), and the direction the polyline runs there, in radians.
56
+ */ export function polylineAt(points, distance) {
57
+ const last = points.length - 1;
58
+ let left = Math.max(0, distance);
59
+ for(let k = 1; k <= last; k++){
60
+ const [x0, y0] = points[k - 1];
61
+ const [x1, y1] = points[k];
62
+ const step = Math.hypot(x1 - x0, y1 - y0);
63
+ if (!step) continue;
64
+ const angle = Math.atan2(y1 - y0, x1 - x0);
65
+ if (left <= step || k === last) {
66
+ const t = Math.min(1, left / step);
67
+ return {
68
+ x: x0 + (x1 - x0) * t,
69
+ y: y0 + (y1 - y0) * t,
70
+ angle
71
+ };
72
+ }
73
+ left -= step;
74
+ }
75
+ const [x, y] = points[0] ?? [
76
+ 0,
77
+ 0
78
+ ];
79
+ return {
80
+ x,
81
+ y,
82
+ angle: 0
83
+ };
84
+ }
85
+ /** The middle of a polyline's length, and its direction there. */ export function polylineMidpoint(points) {
86
+ return polylineAt(points, polylineLength(points) / 2);
87
+ }
88
+ /** The box around a polyline, as `[[x0, y0], [x1, y1]]`. */ export function polylineBox(points) {
89
+ const xs = points.map((p)=>p[0]);
90
+ const ys = points.map((p)=>p[1]);
91
+ return [
92
+ [
93
+ Math.min(...xs),
94
+ Math.min(...ys)
95
+ ],
96
+ [
97
+ Math.max(...xs),
98
+ Math.max(...ys)
99
+ ]
100
+ ];
101
+ }
102
+ /**
103
+ How far along a polyline, from its first point, it first gets `radius`
104
+ pixels away from that point: where it leaves a circle of that radius
105
+ around its start. The polyline's whole length when it never does.
106
+ */ export function polylineReach(points, radius) {
107
+ if (!points.length || radius <= 0) return 0;
108
+ const [cx, cy] = points[0];
109
+ let walked = 0;
110
+ for(let k = 1; k < points.length; k++){
111
+ const [x0, y0] = points[k - 1];
112
+ const [x1, y1] = points[k];
113
+ const dx = x1 - x0;
114
+ const dy = y1 - y0;
115
+ const step = Math.hypot(dx, dy);
116
+ if (Math.hypot(x1 - cx, y1 - cy) >= radius && step) {
117
+ // Where the segment crosses the circle: |p0 + t·d − c| = radius.
118
+ const fx = x0 - cx;
119
+ const fy = y0 - cy;
120
+ const a = dx * dx + dy * dy;
121
+ const b = 2 * (fx * dx + fy * dy);
122
+ const c = fx * fx + fy * fy - radius * radius;
123
+ const t = (-b + Math.sqrt(Math.max(0, b * b - 4 * a * c))) / (2 * a);
124
+ return walked + Math.min(1, Math.max(0, t)) * step;
125
+ }
126
+ walked += step;
127
+ }
128
+ return walked;
129
+ }