@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,179 @@
1
+ /**
2
+ Where annotation positions land in a Plot's pixels: values in data units
3
+ map through the axis scales (dates parsed, categories matched), and
4
+ `"plot"` positions read as fractions of the plot area.
5
+ */ import { date } from "@d3plus/dom";
6
+ /** Whether an axis runs vertically. */ export const isVertical = (axis)=>axis[0] === "y";
7
+ /** A comparable key for an axis value: a date's time, or the value's string. */ const valueKey = (v)=>v instanceof Date ? `${+v}` : `${v}`;
8
+ /**
9
+ The pixel position of `value` on `axis`, or NaN when it has none: the
10
+ axis is missing, the value is not one of a category axis's categories,
11
+ or it does not parse. A `"plot"` value is a fraction of the plot area
12
+ (`0` at the left or bottom edge, `1` at the right or top).
13
+ @param frame The plot area and its axes.
14
+ @param axis The axis the value is on.
15
+ @param value The value, in data units or as a fraction.
16
+ @param ref How the value is read.
17
+ */ export function axisPixel(frame, axis, value, ref = "data") {
18
+ if (value === undefined || value === null || value === "") return NaN;
19
+ const { plot } = frame;
20
+ if (ref === "plot") {
21
+ const f = Number(value);
22
+ if (!Number.isFinite(f)) return NaN;
23
+ return isVertical(axis) ? plot.y1 - f * (plot.y1 - plot.y0) : plot.x0 + f * (plot.x1 - plot.x0);
24
+ }
25
+ const a = frame.axes[axis];
26
+ if (!a) return NaN;
27
+ const v = a.time ? date(value) : value;
28
+ if (v === false || v === undefined) return NaN;
29
+ if (a.categories) {
30
+ const key = valueKey(v);
31
+ if (!a.categories.some((c)=>valueKey(c) === key)) return betweenCategories(a, v);
32
+ }
33
+ const px = a.scale(v);
34
+ return typeof px === "number" && Number.isFinite(px) ? px : NaN;
35
+ }
36
+ /** A number for a numeric category or date, or NaN. */ const numeric = (v)=>v instanceof Date ? +v : typeof v === "number" ? v : NaN;
37
+ /**
38
+ The pixel position of a number (or date) that is not itself a category
39
+ on an axis of numeric categories: interpolated between the categories on
40
+ either side of it, or NaN outside them or among non-numeric categories.
41
+ @param a The axis.
42
+ @param value The value.
43
+ */ export function betweenCategories(a, value) {
44
+ const v = numeric(value);
45
+ const cats = a.categories || [];
46
+ if (!Number.isFinite(v) || !cats.length) return NaN;
47
+ const points = cats.map((c)=>[
48
+ numeric(c),
49
+ a.scale(c)
50
+ ]).sort((p, q)=>p[0] - q[0]);
51
+ if (points.some(([n, px])=>!Number.isFinite(n) || !Number.isFinite(px))) return NaN;
52
+ for(let i = 1; i < points.length; i++){
53
+ const [n0, p0] = points[i - 1], [n1, p1] = points[i];
54
+ if (v >= n0 && v <= n1) return p0 + (v - n0) / (n1 - n0) * (p1 - p0);
55
+ }
56
+ return NaN;
57
+ }
58
+ /**
59
+ Half the pixel distance between neighboring categories on a category
60
+ axis whose categories fill slots (bars; half the plot's extent along it
61
+ when it has one category), or `0` on any other axis.
62
+ @param frame The plot area and its axes.
63
+ @param axis The axis.
64
+ */ export function categoryHalfStep(frame, axis) {
65
+ const a = frame.axes[axis];
66
+ if (!a || !a.slots || !a.categories || !a.categories.length) return 0;
67
+ const pixels = a.categories.map((c)=>a.scale(c)).filter((p)=>Number.isFinite(p)).sort((p, q)=>p - q);
68
+ let gap = Infinity;
69
+ for(let i = 1; i < pixels.length; i++){
70
+ const d = pixels[i] - pixels[i - 1];
71
+ if (d > 0.5 && d < gap) gap = d;
72
+ }
73
+ if (Number.isFinite(gap)) return gap / 2;
74
+ const { plot } = frame;
75
+ return (isVertical(axis) ? plot.y1 - plot.y0 : plot.x1 - plot.x0) / 2;
76
+ }
77
+ /**
78
+ The pixel extent `[lo, hi]` between two values on an axis, or null when
79
+ either has no position. On a category axis of bars it takes in each end
80
+ category's whole slot.
81
+ @param frame The plot area and its axes.
82
+ @param axis The axis the values are on.
83
+ @param values The two values.
84
+ @param ref How the values are read.
85
+ */ export function axisSpan(frame, axis, values, ref = "data") {
86
+ const a = axisPixel(frame, axis, values[0], ref);
87
+ const b = axisPixel(frame, axis, values[1], ref);
88
+ if (!Number.isFinite(a) || !Number.isFinite(b)) return null;
89
+ const half = ref === "data" ? categoryHalfStep(frame, axis) : 0;
90
+ return [
91
+ Math.min(a, b) - half,
92
+ Math.max(a, b) + half
93
+ ];
94
+ }
95
+ /**
96
+ Clips a pixel extent to `[min, max]`, or null when nothing of it is left.
97
+ @param span The extent.
98
+ @param min The lower bound.
99
+ @param max The upper bound.
100
+ */ export function clipSpan(span, min, max) {
101
+ const lo = Math.max(span[0], min), hi = Math.min(span[1], max);
102
+ return hi - lo >= 0.5 ? [
103
+ lo,
104
+ hi
105
+ ] : null;
106
+ }
107
+ /**
108
+ Whether a pixel point lies in the plot area, give or take `tolerance`.
109
+ @param point The point.
110
+ @param plot The plot area.
111
+ @param tolerance Pixels of slack on each side.
112
+ */ export function inPlot([x, y], plot, tolerance = 0.5) {
113
+ return x >= plot.x0 - tolerance && x <= plot.x1 + tolerance && y >= plot.y0 - tolerance && y <= plot.y1 + tolerance;
114
+ }
115
+ /**
116
+ The pixel position of an annotation row's anchor: its `x` (or `x2`, on
117
+ that axis) and `y` (or `y2`), or NaN coordinates when it has none.
118
+ @param frame The plot area and its axes.
119
+ @param d The row.
120
+ @param xRef How its x value is read.
121
+ @param yRef How its y value is read.
122
+ */ export function anchorPoint(frame, d, xRef = "data", yRef = "data") {
123
+ const xAxis = d.x === undefined && d.x2 !== undefined ? "x2" : "x";
124
+ const yAxis = d.y === undefined && d.y2 !== undefined ? "y2" : "y";
125
+ return [
126
+ axisPixel(frame, xAxis, d[xAxis], xRef),
127
+ axisPixel(frame, yAxis, d[yAxis], yRef)
128
+ ];
129
+ }
130
+ /** Category-like axis scales, whose values must match a category. */ const CATEGORY_SCALES = new Set([
131
+ "band",
132
+ "ordinal",
133
+ "point"
134
+ ]);
135
+ /** The mapping frame of one rendered axis. */ function axisFrame(axis, scale, time, slots) {
136
+ if (!axis || !axis._d3Scale) return undefined;
137
+ const type = axis.schema.scale;
138
+ const frame = {
139
+ scale,
140
+ time: time || type === "time"
141
+ };
142
+ if (CATEGORY_SCALES.has(type)) {
143
+ frame.categories = axis._d3Scale.domain();
144
+ if (slots) frame.slots = true;
145
+ }
146
+ return frame;
147
+ }
148
+ /**
149
+ The annotation frame of a painted Plot: its plot area in content pixels
150
+ and its rendered axes. `x2`/`y2` are present only when the chart plots
151
+ on them, and `slots` marks a bar chart, whose categories fill slots
152
+ along its discrete axis.
153
+ @param viz The chart.
154
+ @param measured The axis functions and ranges `renderAxes` solved.
155
+ */ export function plotAnnotationFrame(viz, measured) {
156
+ const { x, y, xRange, yRange, x2Height } = measured;
157
+ const ys = [
158
+ yRange[0],
159
+ yRange[1]
160
+ ].map((v)=>v - x2Height);
161
+ const plot = {
162
+ x0: Math.min(xRange[0], xRange[1]),
163
+ y0: Math.min(ys[0], ys[1]),
164
+ x1: Math.max(xRange[0], xRange[1]),
165
+ y1: Math.max(ys[0], ys[1])
166
+ };
167
+ const discrete = viz.schema.discrete || "x";
168
+ const slots = (axis)=>!!measured.slots && axis[0] === discrete;
169
+ const axes = {
170
+ x: axisFrame(viz._xAxis, (v)=>x(v), !!viz._xTime, slots("x")),
171
+ y: axisFrame(viz._yAxis, (v)=>y(v), !!viz._yTime, slots("y"))
172
+ };
173
+ if (measured.x2Exists) axes.x2 = axisFrame(viz._x2Axis, (v)=>x(v, "x2"), !!viz._x2Time, slots("x2"));
174
+ if (measured.y2Exists) axes.y2 = axisFrame(viz._y2Axis, (v)=>y(v, "y2"), !!viz._y2Time, slots("y2"));
175
+ return {
176
+ plot,
177
+ axes
178
+ };
179
+ }
@@ -0,0 +1,83 @@
1
+ /**
2
+ Text for callouts and reference labels: the theme-aware text style, the
3
+ label wrapped to a width, and the text node that draws it.
4
+ */ import { fontFamilyStringify, textWrap } from "@d3plus/text";
5
+ import { backgroundInk } from "../viz/backgroundInk.js";
6
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
7
+ /**
8
+ The text style for an annotation: each key from `config` (through `pick`,
9
+ which may read a row), else the defaults: the chart's text color for its
10
+ background and font family, 12px, weight 400, a 1.3 line height, and
11
+ a 150px wrap width.
12
+ @param viz The chart.
13
+ @param pick Reads one style key.
14
+ */ export function annotationTextStyle(viz, pick) {
15
+ const fontSize = num(pick("fontSize"), 12);
16
+ const family = pick("fontFamily") ?? viz.schema.fontFamily;
17
+ return {
18
+ fontColor: pick("fontColor") || backgroundInk(viz),
19
+ fontFamily: typeof family === "string" || Array.isArray(family) ? fontFamilyStringify(family) : "sans-serif",
20
+ fontSize,
21
+ fontWeight: pick("fontWeight") ?? 400,
22
+ lineHeight: num(pick("lineHeight"), Math.round(fontSize * 1.3)),
23
+ maxWidth: Math.max(1, num(pick("maxWidth"), 150))
24
+ };
25
+ }
26
+ /**
27
+ Wraps `text` at the style's `maxWidth`, measuring each line.
28
+ @param text The label.
29
+ @param style The text style.
30
+ */ export function wrapAnnotationText(text, style) {
31
+ const wrap = textWrap().fontFamily(style.fontFamily).fontSize(style.fontSize).fontWeight(style.fontWeight).lineHeight(style.lineHeight).width(style.maxWidth).height(Number.MAX_SAFE_INTEGER)(text);
32
+ const lines = [];
33
+ const widths = [];
34
+ wrap.lines.forEach((line, i)=>{
35
+ if (line === "") return;
36
+ lines.push(line);
37
+ widths.push(wrap.widths[i] ?? 0);
38
+ });
39
+ return {
40
+ lines,
41
+ widths,
42
+ width: widths.length ? Math.ceil(Math.max(...widths)) : 0,
43
+ height: lines.length * style.lineHeight,
44
+ lineHeight: style.lineHeight
45
+ };
46
+ }
47
+ /**
48
+ The text node that draws a wrapped label whose block's top edge sits at
49
+ `y`, lined up against `x` by `align` (its left edge, center, or right
50
+ edge). Inert: annotations take no pointer or keyboard focus.
51
+ @param block The wrapped label.
52
+ @param style Its text style.
53
+ @param at Where the block goes, and its key.
54
+ */ export function annotationTextNode(block, style, at) {
55
+ return {
56
+ type: "text",
57
+ key: at.key,
58
+ interactive: false,
59
+ x: 0,
60
+ y: 0,
61
+ transform: {
62
+ x: at.x,
63
+ y: at.y
64
+ },
65
+ lines: block.lines.map((text, i)=>({
66
+ text,
67
+ x: 0,
68
+ y: block.lineHeight * (i + 0.5),
69
+ width: block.widths[i]
70
+ })),
71
+ font: {
72
+ family: style.fontFamily,
73
+ size: style.fontSize,
74
+ weight: style.fontWeight,
75
+ anchor: at.align,
76
+ baseline: "middle"
77
+ },
78
+ paint: {
79
+ fill: style.fontColor,
80
+ opacity: at.opacity ?? 1
81
+ }
82
+ };
83
+ }
@@ -0,0 +1,10 @@
1
+ /**
2
+ The config shapes of a Plot's callout annotations, reference lines, and
3
+ reference bands.
4
+ */ /**
5
+ A shaded span across the plot between two values: give `x` (a vertical
6
+ band) or `y` (a horizontal one) as `[start, end]`, or `x2`/`y2`. On a
7
+ category axis the band covers each end category's whole slot; on a
8
+ continuous or time axis its ends widen the axis domain, unless the user
9
+ set that end of the domain.
10
+ */ export { };
@@ -19,7 +19,8 @@
19
19
  */ import { select } from "d3-selection";
20
20
  import { stylize } from "@d3plus/dom";
21
21
  import { chartBounds } from "./chartGeometry.js";
22
- import { attributionStyleDarkDefault, attributionStyleDefault } from "../viz/vizDefaults.js";
22
+ import { attributionStyleDefault } from "../viz/vizDefaults.js";
23
+ import { themeOverlayStyle } from "../viz/vizTheme.js";
23
24
  /** An "i" in a circle, drawn like the zoom-control icons (see `zoomControlsMarkup.ts`). */ const INFO_ICON = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" style="width:12px;height:12px;display:block"><circle cx="12" cy="12" r="10"/><line x1="12" y1="11" x2="12" y2="17"/><line x1="12" y1="7" x2="12" y2="7.01"/></svg>';
24
25
  /** Markup for a mount-function icon — see `zoomControlsMarkup.ts`'s `iconSlot`. */ const CUSTOM_ICON_SLOT = '<span class="d3plus-attribution-icon" style="display:inline-block;width:12px;height:12px;vertical-align:middle;flex-shrink:0"></span>';
25
26
  /** The toggle button's glyph markup: a custom override, or the built-in "i". */ function toggleIcon(viz) {
@@ -50,15 +51,6 @@ import { attributionStyleDarkDefault, attributionStyleDefault } from "../viz/viz
50
51
  node.style.borderRadius = open ? "3px 0 0 0" : "3px 0 0 0";
51
52
  node.style.padding = open ? "4px 6px" : "2px";
52
53
  }
53
- /** Swaps each entry still at its light default for the dark default. */ function darkAttributionStyle(style) {
54
- const light = attributionStyleDefault;
55
- const dark = attributionStyleDarkDefault;
56
- const out = {
57
- ...style
58
- };
59
- for (const key of Object.keys(dark))if (out[key] === light[key]) out[key] = dark[key];
60
- return out;
61
- }
62
54
  export const attributionFeature = {
63
55
  name: "attribution",
64
56
  configFields: [
@@ -72,7 +64,10 @@ export const attributionFeature = {
72
64
  ] : []);
73
65
  const attrEnter = attr.enter().append("div").attr("class", "d3plus-attribution");
74
66
  attr.exit().remove();
75
- const style = viz._basemapDark ? darkAttributionStyle(viz.schema.attributionStyle) : viz.schema.attributionStyle;
67
+ const style = themeOverlayStyle(viz, viz.schema.attributionStyle, attributionStyleDefault, {
68
+ background: (o)=>o.background,
69
+ color: (o)=>o.text
70
+ });
76
71
  attr = attr.merge(attrEnter).style("position", "absolute").style("right", `${viz._margin.right}px`).style("bottom", `${viz._margin.bottom}px`).call(stylize, style);
77
72
  // Rewrite the markup — and remount a custom icon — only when it actually
78
73
  // changed (the credit text, locale, theme, or icon override), the same
@@ -62,8 +62,9 @@ import { solveFinalAxes } from "./axesFinal.js";
62
62
  // `_chartScene` (the chart-cells group already applies `_chartTransform`).
63
63
  // Axes are scene-only: `renderMode("compute")` renders into a detached svg
64
64
  // and `axis.toScene()` produces the visible output.
65
+ // The y axis hugs the plot, or sits left of the lines' left-end labels.
65
66
  const yW = yWidth;
66
- const xTrans = xOffsetLeft > yW ? xOffsetLeft - yW : 0;
67
+ const xTrans = Math.max(0, xOffsetLeft - yW - (pCtx.startLabelSpace ?? 0)) || 0;
67
68
  const axisAbsoluteTransforms = {
68
69
  x: {
69
70
  x: viz._margin.left,
@@ -47,12 +47,14 @@ import { plotAxisConfig } from "../Plot/baselineBreak.js";
47
47
  }
48
48
  const yBounds = yTest.outerBounds();
49
49
  const yWidth = yBounds.width ? yBounds.width + yTest.padding() : undefined;
50
+ const { startLabelSpace } = pCtx;
50
51
  const xOffsetLeft = max([
51
52
  0,
52
53
  yWidth,
53
54
  xTestRange[0],
54
55
  x2TestRange[0],
55
- viz._plotMinLeft?.()
56
+ viz._plotMinLeft?.(),
57
+ startLabelSpace && (yWidth ?? 0) + startLabelSpace
56
58
  ]);
57
59
  if (y2Exists) {
58
60
  y2Test.config(yC).domain(y2Domain).gridSize(0).height(height).range(yRange).width(width - max([
@@ -49,7 +49,7 @@ import { buildXConfig } from "./xAxisConfig.js";
49
49
  xRangeMax
50
50
  ]).ticks(xTicks).width(width).config(xC).config(plotAxisConfig(viz, "x")).config(xOverrides).scale(xConfigScale).measure();
51
51
  }
52
- const { labelWidths, largestLabel, xRangeMax: measuredXRangeMax } = measureLineLabels();
52
+ const { labelWidths, largestLabel, xRangeMax: measuredXRangeMax, startLabelSpace = 0 } = measureLineLabels();
53
53
  if (measuredXRangeMax !== undefined) xRangeMax = measuredXRangeMax;
54
54
  if (showX && xRangeMax) {
55
55
  xTest.domain(xDomain).height(height).maxSize(height / 2).range([
@@ -66,14 +66,15 @@ import { buildXConfig } from "./xAxisConfig.js";
66
66
  return {
67
67
  labelWidths,
68
68
  largestLabel,
69
- xRangeMax
69
+ xRangeMax,
70
+ startLabelSpace
70
71
  };
71
72
  }
72
73
  /**
73
74
  Measure the x/x2 test axes and solve the coupled four-side offsets.
74
75
  */ function measureXTestAxes(viz, inputs, xC, yWidth, y2Width, measureLineLabels, ends) {
75
76
  const { xTest, x2Test, yTest, showX, showY, x2Exists, height, width } = inputs;
76
- const { labelWidths, largestLabel, xRangeMax } = measureXTestPasses(viz, inputs, xC, measureLineLabels, ends);
77
+ const { labelWidths, largestLabel, xRangeMax, startLabelSpace = 0 } = measureXTestPasses(viz, inputs, xC, measureLineLabels, ends);
77
78
  const xTestRange = xTest._getRange();
78
79
  const x2TestRange = x2Test._getRange();
79
80
  const x2Bounds = x2Test.outerBounds();
@@ -83,7 +84,8 @@ import { buildXConfig } from "./xAxisConfig.js";
83
84
  yWidth,
84
85
  xTestRange[0],
85
86
  x2TestRange[0],
86
- viz._plotMinLeft?.()
87
+ viz._plotMinLeft?.(),
88
+ startLabelSpace && (yWidth ?? 0) + startLabelSpace
87
89
  ]);
88
90
  const yLabelConfig = yTest.shapeConfig().labelConfig;
89
91
  const topOffset = (showY ? yLabelConfig.fontSize() / 2 : 0) + (viz._plotInsetTop ?? 0);
@@ -103,6 +105,7 @@ import { buildXConfig } from "./xAxisConfig.js";
103
105
  xRangeMax,
104
106
  labelWidths,
105
107
  largestLabel,
108
+ startLabelSpace,
106
109
  xTestRange,
107
110
  x2TestRange,
108
111
  x2Height,
@@ -0,0 +1,121 @@
1
+ /**
2
+ A callout's geometry in pixels: its box offset from the anchor and kept
3
+ inside the plot, the connector from the box's edge to the anchor, and the
4
+ arrowhead at the anchor.
5
+ */ /**
6
+ A `width` × `height` box centered `dx`/`dy` pixels from the anchor.
7
+ @param anchor The anchor.
8
+ @param size The box's size.
9
+ @param dx The horizontal offset of its center.
10
+ @param dy The vertical offset of its center.
11
+ */ export function offsetBox(anchor, size, dx, dy) {
12
+ return {
13
+ x: anchor[0] + dx - size.width / 2,
14
+ y: anchor[1] + dy - size.height / 2,
15
+ width: size.width,
16
+ height: size.height
17
+ };
18
+ }
19
+ /** Moves a `[start, size]` stretch inside `[min, max]`, keeping it at `min` when it is wider. */ const clampStretch = (start, size, min, max)=>Math.max(min, Math.min(start, max - size));
20
+ /**
21
+ Moves a box the least distance that puts it inside the plot area; a box
22
+ larger than the plot keeps to its top-left corner.
23
+ @param box The box.
24
+ @param plot The plot area.
25
+ */ export function clampBox(box, plot) {
26
+ return {
27
+ ...box,
28
+ x: clampStretch(box.x, box.width, plot.x0, plot.x1),
29
+ y: clampStretch(box.y, box.height, plot.y0, plot.y1)
30
+ };
31
+ }
32
+ /**
33
+ Where the connector runs: `from` the point the line from the box's center
34
+ to the anchor leaves the box, `to` the anchor (pulled back toward the box
35
+ by `standoff`). Null when the anchor is inside the box or the connector
36
+ would be shorter than a pixel.
37
+ @param box The callout box.
38
+ @param anchor The anchor.
39
+ @param standoff The gap to leave before the anchor.
40
+ */ export function connectorEndpoints(box, anchor, standoff = 0) {
41
+ const cx = box.x + box.width / 2, cy = box.y + box.height / 2;
42
+ const vx = anchor[0] - cx, vy = anchor[1] - cy;
43
+ const tx = vx ? box.width / 2 / Math.abs(vx) : Infinity;
44
+ const ty = vy ? box.height / 2 / Math.abs(vy) : Infinity;
45
+ const t = Math.min(tx, ty);
46
+ if (!(t < 1)) return null;
47
+ const from = [
48
+ cx + vx * t,
49
+ cy + vy * t
50
+ ];
51
+ const length = Math.hypot(anchor[0] - from[0], anchor[1] - from[1]);
52
+ const pull = Math.min(Math.max(standoff, 0), length);
53
+ const k = length ? pull / length : 0;
54
+ const to = [
55
+ anchor[0] - (anchor[0] - from[0]) * k,
56
+ anchor[1] - (anchor[1] - from[1]) * k
57
+ ];
58
+ if (Math.hypot(to[0] - from[0], to[1] - from[1]) < 1) return null;
59
+ return {
60
+ from,
61
+ to
62
+ };
63
+ }
64
+ /**
65
+ The three corners of an arrowhead `size` pixels long with its tip at
66
+ `tip`, pointing along the line from `from`: the tip, then its base's two
67
+ corners.
68
+ @param from The line's start.
69
+ @param tip The arrow's tip.
70
+ @param size The arrowhead's length (its base is as wide).
71
+ */ export function arrowheadPoints(from, tip, size) {
72
+ const length = Math.hypot(tip[0] - from[0], tip[1] - from[1]) || 1;
73
+ const ux = (tip[0] - from[0]) / length, uy = (tip[1] - from[1]) / length;
74
+ const bx = tip[0] - ux * size, by = tip[1] - uy * size;
75
+ const half = size / 2;
76
+ return [
77
+ tip,
78
+ [
79
+ bx - uy * half,
80
+ by + ux * half
81
+ ],
82
+ [
83
+ bx + uy * half,
84
+ by - ux * half
85
+ ]
86
+ ];
87
+ }
88
+ /**
89
+ Where a point moves along the line from `from` by `distance` pixels back
90
+ from its end (the arrow's base, where the connector stops).
91
+ @param from The line's start.
92
+ @param to The line's end.
93
+ @param distance How far back from `to`.
94
+ */ export function pullBack(from, to, distance) {
95
+ const length = Math.hypot(to[0] - from[0], to[1] - from[1]);
96
+ if (!length) return to;
97
+ const k = Math.min(distance, length) / length;
98
+ return [
99
+ to[0] - (to[0] - from[0]) * k,
100
+ to[1] - (to[1] - from[1]) * k
101
+ ];
102
+ }
103
+ /** Whether a point lies inside a box. */ const contains = (box, [x, y])=>x >= box.x && x <= box.x + box.width && y >= box.y && y <= box.y + box.height;
104
+ /**
105
+ Where a callout's box goes: centered `dx`/`dy` from the anchor and, when
106
+ `clamp` is on, moved inside the plot area. A box that clamping pushes
107
+ over its own anchor tries the opposite offset instead, and keeps it when
108
+ that leaves the anchor clear.
109
+ @param anchor The anchor.
110
+ @param size The box's size.
111
+ @param offset The box center's offset from the anchor.
112
+ @param plot The plot area.
113
+ @param clamp Whether the box stays inside the plot area.
114
+ */ export function placeCalloutBox(anchor, size, [dx, dy], plot, clamp = true) {
115
+ const box = offsetBox(anchor, size, dx, dy);
116
+ if (!clamp) return box;
117
+ const clamped = clampBox(box, plot);
118
+ if (!contains(clamped, anchor) || contains(box, anchor)) return clamped;
119
+ const flipped = clampBox(offsetBox(anchor, size, -dx, -dy), plot);
120
+ return contains(flipped, anchor) ? clamped : flipped;
121
+ }
@@ -0,0 +1,155 @@
1
+ /**
2
+ The scene of a callout annotation: per row, a connector from the box to
3
+ the anchor, an arrowhead or dot at the anchor, the box, and its wrapped
4
+ text, all inert.
5
+ */ import { parseDash } from "../../shapes/Shape.js";
6
+ import { chartBackground } from "../viz/backgroundInk.js";
7
+ import { anchorPoint, inPlot } from "./annotationFrame.js";
8
+ import { annotationTextNode, annotationTextStyle, wrapAnnotationText } from "./annotationText.js";
9
+ import { arrowheadPoints, connectorEndpoints, placeCalloutBox, pullBack } from "./calloutLayout.js";
10
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
11
+ /** Whether a color setting turns its paint off. */ const off = (v)=>v === false || v === "none";
12
+ /**
13
+ Reads one style key for a callout row: an accessor on the annotation
14
+ called with the row, else the row's own value, else the annotation's.
15
+ @param annotation The callout annotation.
16
+ @param d The row.
17
+ @param i The row's index.
18
+ */ export function calloutPicker(annotation, d, i) {
19
+ return (key)=>{
20
+ const own = annotation[key];
21
+ if (typeof own === "function") return own(d, i);
22
+ return d[key] !== undefined ? d[key] : own;
23
+ };
24
+ }
25
+ /** The box's rect, or null when it has neither fill nor border. */ function boxNode(viz, pick, box, key, ink) {
26
+ const fill = pick("fill"), stroke = pick("stroke");
27
+ if (off(fill) && off(stroke)) return null;
28
+ const paint = off(fill) ? {
29
+ fill: "none"
30
+ } : {
31
+ fill: fill || chartBackground(viz),
32
+ fillOpacity: num(pick("fillOpacity"), 1)
33
+ };
34
+ if (!off(stroke)) {
35
+ paint.stroke = stroke || ink;
36
+ paint.strokeWidth = num(pick("strokeWidth"), 1);
37
+ paint.strokeOpacity = num(pick("strokeOpacity"), 0.25);
38
+ }
39
+ return {
40
+ type: "rect",
41
+ key,
42
+ interactive: false,
43
+ ...box,
44
+ rx: num(pick("rx"), 3),
45
+ paint
46
+ };
47
+ }
48
+ /** The connector line and its anchor marker, or nothing when it is off or too short. */ function connectorNodes(pick, box, anchor, key, ink) {
49
+ if (pick("connector") === false) return [];
50
+ const ends = connectorEndpoints(box, anchor, num(pick("standoff"), 0));
51
+ if (!ends) return [];
52
+ const color = pick("connectorStroke") || ink;
53
+ const opacity = num(pick("connectorStrokeOpacity"), 1);
54
+ const marker = pick("marker") ?? "arrow";
55
+ const size = Math.max(0, num(pick("markerSize"), 6));
56
+ const width = num(pick("connectorStrokeWidth"), 1);
57
+ const out = [];
58
+ const end = marker === "arrow" && size ? pullBack(ends.from, ends.to, size) : ends.to;
59
+ const paint = {
60
+ fill: "none",
61
+ stroke: color,
62
+ strokeWidth: width,
63
+ strokeOpacity: opacity
64
+ };
65
+ const dash = parseDash(pick("connectorStrokeDasharray"));
66
+ if (dash) paint.strokeDasharray = dash;
67
+ out.push({
68
+ type: "line",
69
+ key: `${key}-connector`,
70
+ interactive: false,
71
+ points: [
72
+ ends.from,
73
+ end
74
+ ],
75
+ curve: "linear",
76
+ paint
77
+ });
78
+ if (marker === "arrow" && size) {
79
+ const [tip, a, b] = arrowheadPoints(ends.from, ends.to, size);
80
+ out.push({
81
+ type: "path",
82
+ key: `${key}-marker`,
83
+ interactive: false,
84
+ d: `M${tip[0]},${tip[1]}L${a[0]},${a[1]}L${b[0]},${b[1]}Z`,
85
+ paint: {
86
+ fill: color,
87
+ opacity
88
+ }
89
+ });
90
+ } else if (marker === "dot" && size) out.push({
91
+ type: "circle",
92
+ key: `${key}-marker`,
93
+ interactive: false,
94
+ cx: ends.to[0],
95
+ cy: ends.to[1],
96
+ r: size / 2,
97
+ paint: {
98
+ fill: color,
99
+ opacity
100
+ }
101
+ });
102
+ return out;
103
+ }
104
+ /**
105
+ The scene nodes of one callout row, or nothing when it has no label or
106
+ its anchor lies outside the plot area (a zoom that pans it out of view).
107
+ @param viz The chart.
108
+ @param annotation The callout annotation.
109
+ @param frame The plot area and its axes.
110
+ @param row The row, its index, and its key.
111
+ */ export function calloutRowNodes(viz, annotation, frame, row) {
112
+ const pick = calloutPicker(annotation, row.d, row.i);
113
+ const anchor = anchorPoint(frame, row.d, annotation.xRef, annotation.yRef);
114
+ if (!anchor.every(Number.isFinite) || !inPlot(anchor, frame.plot)) return [];
115
+ const text = pick("label");
116
+ if (text === undefined || text === null || text === false || text === "") return [];
117
+ const style = annotationTextStyle(viz, pick);
118
+ const block = wrapAnnotationText(`${text}`, style);
119
+ if (!block.lines.length) return [];
120
+ const padding = Math.max(0, num(pick("padding"), 6));
121
+ const box = placeCalloutBox(anchor, {
122
+ width: block.width + padding * 2,
123
+ height: block.height + padding * 2
124
+ }, [
125
+ num(pick("dx"), 0),
126
+ num(pick("dy"), -40)
127
+ ], frame.plot, pick("clamp") !== false);
128
+ const align = pick("textAlign") || "middle";
129
+ const textX = align === "start" ? box.x + padding : align === "end" ? box.x + box.width - padding : box.x + box.width / 2;
130
+ const ink = style.fontColor;
131
+ const out = connectorNodes(pick, box, anchor, row.key, ink);
132
+ const rect = boxNode(viz, pick, box, `${row.key}-box`, ink);
133
+ if (rect) out.push(rect);
134
+ out.push(annotationTextNode(block, style, {
135
+ key: `${row.key}-label`,
136
+ x: textX,
137
+ y: box.y + padding,
138
+ align
139
+ }));
140
+ return out;
141
+ }
142
+ /**
143
+ The scene nodes of a callout annotation's rows.
144
+ @param viz The chart.
145
+ @param annotation The callout annotation.
146
+ @param frame The plot area and its axes.
147
+ @param key The annotation's key, which prefixes its nodes'.
148
+ */ export function calloutNodes(viz, annotation, frame, key) {
149
+ const data = Array.isArray(annotation.data) ? annotation.data : [];
150
+ return data.flatMap((d, i)=>calloutRowNodes(viz, annotation, frame, {
151
+ d,
152
+ i,
153
+ key: `${key}-${i}`
154
+ }));
155
+ }
@@ -55,7 +55,7 @@
55
55
 
56
56
  Width and height are the margin-adjusted chart-area dimensions —
57
57
  callers usually have them on hand from `chartBounds(viz)` or from
58
- fields a stage stashed (e.g. `_pieWidth` / `_radialMatrixWidth`).
58
+ fields a stage stashed (e.g. `_radialMatrixWidth`).
59
59
  */ export function centerChartTransform(viz, width, height) {
60
60
  return {
61
61
  x: viz._margin.left + width / 2,