@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
@@ -4,13 +4,11 @@
4
4
  Implementation files in this folder:
5
5
  - `applyLayout.ts` — chart-specific `TransformStage`.
6
6
  - `emit.ts` — Rect + label scene nodes per band.
7
- */ import { min, max } from "d3-array";
8
- import accessor from "../../utils/accessor.js";
9
- import { fieldAccessor } from "../../utils/fieldAccessor.js";
10
- import { Axis } from "../../components/index.js";
7
+ */ import { Axis } from "../../components/index.js";
11
8
  import { makeChart } from "../definition/makeChart.js";
12
9
  import { applyPriestleyLayout } from "./applyLayout.js";
13
10
  import { priestleyEmit } from "./emit.js";
11
+ import { seedTimeAggs, timeFields } from "./timeAxis.js";
14
12
  export const priestleyDef = {
15
13
  name: "Priestley",
16
14
  layoutStage: applyPriestleyLayout,
@@ -20,10 +18,7 @@ export const priestleyDef = {
20
18
  // The default start/end accessors are functions, so the fields' `onSet`
21
19
  // can't infer a data key to register. Seed the band-edge reducers here so
22
20
  // the time domain spans min(start)…max(end) instead of summing them.
23
- setup: (viz)=>{
24
- if (!viz.schema.aggs.start) viz.schema.aggs.start = min;
25
- if (!viz.schema.aggs.end) viz.schema.aggs.end = max;
26
- },
21
+ setup: seedTimeAggs,
27
22
  ctx: {
28
23
  axis: new Axis().align("end").orient("bottom"),
29
24
  axisTest: new Axis().align("end").gridSize(0).orient("bottom")
@@ -52,33 +47,7 @@ export const priestleyDef = {
52
47
  scale: "time"
53
48
  }
54
49
  },
55
- /**
56
- Accessor function or string key for the end date of each data point. A
57
- key also aggregates grouped rows by their latest end.
58
- @type {string | function}
59
- */ {
60
- key: "end",
61
- default: accessor("end"),
62
- coerce: (v)=>typeof v === "function" ? v : fieldAccessor(v),
63
- onSet: (viz, v)=>{
64
- // String accessor → also seed a default aggregation (max) for that key.
65
- const key = typeof v === "function" ? null : v;
66
- if (key && !viz.schema.aggs[key]) viz.schema.aggs[key] = max;
67
- }
68
- },
69
- /**
70
- Accessor function or string key for the start date of each data point. A
71
- key also aggregates grouped rows by their earliest start.
72
- @type {string | function}
73
- */ {
74
- key: "start",
75
- default: accessor("start"),
76
- coerce: (v)=>typeof v === "function" ? v : fieldAccessor(v),
77
- onSet: (viz, v)=>{
78
- const key = typeof v === "function" ? null : v;
79
- if (key && !viz.schema.aggs[key]) viz.schema.aggs[key] = min;
80
- }
81
- },
50
+ ...timeFields(),
82
51
  {
83
52
  key: "shapeConfig",
84
53
  merge: true,
@@ -0,0 +1,100 @@
1
+ /**
2
+ Time helpers Priestley and Gantt share: the `start`/`end` accessor
3
+ fields, the min/max aggregation seeds they register, date parsing for a
4
+ time-scaled axis, and the time axis render that pushes the axis scene and
5
+ returns its scale.
6
+ */ import { min, max } from "d3-array";
7
+ import { date } from "@d3plus/dom";
8
+ import accessor from "../../utils/accessor.js";
9
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
10
+ /** Stores a function as given and wraps a data key in an accessor. */ const timeAccessor = (v)=>typeof v === "function" ? v : fieldAccessor(v);
11
+ /** Registers `agg` for a data key that has no aggregation yet. */ const seedAgg = (agg)=>(viz, v)=>{
12
+ const k = typeof v === "function" ? null : v;
13
+ if (k && !viz.schema.aggs[k]) viz.schema.aggs[k] = agg;
14
+ };
15
+ /** The `start` and `end` accessor fields. */ export function timeFields() {
16
+ return [
17
+ /**
18
+ Accessor function or string key for the end date of each data point. A
19
+ key also aggregates grouped rows by their latest end.
20
+ @type {string | function}
21
+ */ {
22
+ key: "end",
23
+ default: accessor("end"),
24
+ coerce: timeAccessor,
25
+ onSet: seedAgg(max)
26
+ },
27
+ /**
28
+ Accessor function or string key for the start date of each data point. A
29
+ key also aggregates grouped rows by their earliest start.
30
+ @type {string | function}
31
+ */ {
32
+ key: "start",
33
+ default: accessor("start"),
34
+ coerce: timeAccessor,
35
+ onSet: seedAgg(min)
36
+ }
37
+ ];
38
+ }
39
+ /**
40
+ Seeds the `start`/`end` reducers for the default accessors, which are
41
+ functions the fields' `onSet` can't read a data key from, so the time
42
+ domain spans min(start)…max(end) instead of summing them.
43
+ */ export function seedTimeAggs(viz) {
44
+ if (!viz.schema.aggs.start) viz.schema.aggs.start = min;
45
+ if (!viz.schema.aggs.end) viz.schema.aggs.end = max;
46
+ }
47
+ /** Whether the chart's `axisConfig` plots dates. */ export function isTimeAxis(viz) {
48
+ const axisConfig = viz.schema.axisConfig;
49
+ return axisConfig?.scale === "time";
50
+ }
51
+ /**
52
+ Reads a start or end value: parsed as a date on a time axis, else a
53
+ number. Missing or unparseable values return null.
54
+ */ export function parseTime(value, time) {
55
+ if (value === undefined || value === null || value === "") return null;
56
+ if (time) {
57
+ const d = date(value);
58
+ return d instanceof Date && !isNaN(+d) ? d : null;
59
+ }
60
+ const n = Number(value);
61
+ return Number.isFinite(n) ? n : null;
62
+ }
63
+ /** Applies the axis frame's size and domain, then `frame.config` and `axisConfig`. */ const configure = (viz, axis, frame)=>axis.config({
64
+ domain: frame.domain,
65
+ height: frame.height,
66
+ width: frame.width
67
+ }).config(frame.config ?? {}).config(viz.schema.axisConfig);
68
+ /**
69
+ Measures the chart's time axis (`viz.ctx.axisTest`) over `frame`: the
70
+ height its ticks and labels take, and its padding.
71
+ */ export function measureTimeAxis(viz, frame) {
72
+ const axisTest = viz.ctx.axisTest;
73
+ configure(viz, axisTest, frame).measure();
74
+ return {
75
+ height: axisTest.outerBounds().height,
76
+ padding: axisTest.schema.padding
77
+ };
78
+ }
79
+ /**
80
+ Renders the chart's time axis (`viz.ctx.axis`) over `frame`, pushes its
81
+ scene onto `viz._chartScene` (with any extra `group` fields), and returns
82
+ its scale.
83
+ */ export function renderTimeAxis(viz, frame, group = {}) {
84
+ const axis = viz.ctx.axis;
85
+ configure(viz, axis, frame).renderMode("compute").select(undefined).render();
86
+ const axisScene = axis.toScene();
87
+ if (axisScene) {
88
+ (viz._chartScene ||= []).push({
89
+ type: "group",
90
+ key: frame.key,
91
+ transform: frame.transform,
92
+ children: axisScene.children ?? [],
93
+ ...group
94
+ });
95
+ }
96
+ return axis._d3Scale;
97
+ }
98
+ /** Reads a row's raw start or end through the chart's accessor. */ export function rowTime(viz, key, d, i) {
99
+ return viz.schema[key](d, i);
100
+ }
@@ -8,9 +8,13 @@ import { formatAbbreviate } from "@d3plus/format";
8
8
  import { fontFamily as defaultFontFamily, fontFamilyStringify, textWrap } from "@d3plus/text";
9
9
  import TextBox from "../../components/TextBox.js";
10
10
  import { emitLabels, shapeLabelDefaults } from "../../shapes/emitLabels.js";
11
- import { paintFromShapeConfig, shapeConfigFor } from "../features/emitHelpers.js";
11
+ import { paintFromShapeConfig, resolveAccessor, shapeConfigFor } from "../features/emitHelpers.js";
12
+ import { textLineBoxes } from "../features/linkLabels.js";
13
+ import { clearRingLabels, ringLabelFont, ringLabelNodes } from "../features/ringLabelNodes.js";
14
+ import { ringLabelPosition } from "../features/ringLabels.js";
12
15
  import { backgroundInk } from "../viz/backgroundInk.js";
13
16
  import { RADAR_EDGE_GAP, RADAR_LABEL_MAX_LINES, RADAR_LABEL_PADDING, radarAxisLabelLayout } from "./axisLabels.js";
17
+ import { radarCurveLines, radarCurvedLayout, radarCurves } from "./curvedLabels.js";
14
18
  import { emitRadarLevelLabels, radarLevelLabels, radarRadius } from "./levels.js";
15
19
  import { emitRadarRings, radarRingStyle } from "./rings.js";
16
20
  const TAU = Math.PI * 2;
@@ -36,8 +40,10 @@ const TAU = Math.PI * 2;
36
40
  };
37
41
  /**
38
42
  Lays out the metric labels and the web radius. `outerPadding` "auto"
39
- sizes both from the measured labels; a number reserves that many pixels
40
- around the web and wraps labels to it.
43
+ curves every label along the web when they all fit, which leaves the web
44
+ the most room, and otherwise sizes both from the measured labels along
45
+ their spokes; a number reserves that many pixels around the web and
46
+ wraps labels to it. Either way, a label that fits along the web curves.
41
47
  */ export function radarPolarAxis(viz, axisData, width, height) {
42
48
  const total = axisData.length;
43
49
  const aggs = viz.schema.aggs;
@@ -54,14 +60,20 @@ const TAU = Math.PI * 2;
54
60
  lineHeight: font.lineHeight
55
61
  };
56
62
  });
57
- let radius;
58
- let boxes;
63
+ const room = Math.min(width, height) / 2 - RADAR_EDGE_GAP;
64
+ let radius = 0;
65
+ let boxes = inputs.map(()=>({
66
+ wrapWidth: 0
67
+ }));
68
+ let curves;
69
+ const allCurved = outerPadding === "auto" ? radarCurvedLayout(viz, inputs, room) : null;
70
+ if (allCurved) ({ radius, curves } = allCurved);
59
71
  if (typeof outerPadding === "number") {
60
72
  radius = Math.max(0, Math.min(width, height) / 2 - outerPadding);
61
73
  boxes = inputs.map(()=>({
62
74
  wrapWidth: outerPadding
63
75
  }));
64
- } else {
76
+ } else if (!curves) {
65
77
  const layout = radarAxisLabelLayout({
66
78
  labels: inputs,
67
79
  width: width - RADAR_EDGE_GAP * 2,
@@ -76,6 +88,8 @@ const TAU = Math.PI * 2;
76
88
  radius = layout.radius;
77
89
  boxes = layout.labels;
78
90
  }
91
+ const lines = radarCurveLines(inputs, radius, room);
92
+ curves ??= lines ? radarCurves(viz, inputs, radius, lines) : inputs.map(()=>null);
79
93
  const polarAxis = inputs.map(({ key, data, font, angle: radians }, i)=>{
80
94
  const hh = font.lineHeight * RADAR_LABEL_MAX_LINES;
81
95
  const ww = boxes[i].wrapWidth;
@@ -107,7 +121,8 @@ const TAU = Math.PI * 2;
107
121
  hh / 2
108
122
  ],
109
123
  x: radius * Math.cos(radians),
110
- y: radius * Math.sin(radians)
124
+ y: radius * Math.sin(radians),
125
+ labelCurve: curves[i] ?? undefined
111
126
  };
112
127
  }).sort((a, b)=>Number(a.key) - Number(b.key));
113
128
  return {
@@ -115,11 +130,24 @@ const TAU = Math.PI * 2;
115
130
  polarAxis
116
131
  };
117
132
  }
118
- /** Builds the metric labels and the spokes (non-interactive, datum-free). */ export function radarAxisNodes(viz, polarAxis) {
133
+ /**
134
+ The metric labels: curved ones along the web, and the rest along their
135
+ spokes. A spoke label that would cover a curved one is left out.
136
+ */ function radarAxisLabels(viz, polarAxis) {
119
137
  const axisConfig = viz.schema.axisConfig;
120
- const out = [];
121
- const labels = emitLabels({
122
- data: polarAxis,
138
+ const labelConfig = axisConfig.shapeConfig?.labelConfig ?? {};
139
+ const colorOf = (p)=>{
140
+ const color = resolveAccessor(labelConfig.fontColor, p.data, p.i);
141
+ return typeof color === "string" ? color : backgroundInk(viz);
142
+ };
143
+ const curved = ringLabelNodes(viz, polarAxis.flatMap((p)=>(p.labelCurve?.lines ?? []).map((line, k)=>({
144
+ key: `radar-axis-label-${p.id}${k ? `-${k}` : ""}`,
145
+ text: line.text,
146
+ fit: line.fit,
147
+ color: colorOf(p)
148
+ }))), ringLabelFont(labelConfig));
149
+ const straight = emitLabels({
150
+ data: polarAxis.filter((p)=>!p.labelCurve && ringLabelPosition(viz, p.data, p.i) !== "along"),
123
151
  label: (d)=>d.id,
124
152
  x: (d)=>d.x,
125
153
  y: (d)=>d.y,
@@ -127,8 +155,17 @@ const TAU = Math.PI * 2;
127
155
  rotate: (d)=>d.angle || 0,
128
156
  id: (d)=>d.id,
129
157
  labelBounds: (d)=>d.labelBounds,
130
- labelConfig: axisConfig.shapeConfig?.labelConfig ?? {}
158
+ labelConfig
131
159
  });
160
+ return [
161
+ ...curved,
162
+ ...clearRingLabels(straight, textLineBoxes(curved))
163
+ ];
164
+ }
165
+ /** Builds the metric labels and the spokes (non-interactive, datum-free). */ export function radarAxisNodes(viz, polarAxis) {
166
+ const axisConfig = viz.schema.axisConfig;
167
+ const out = [];
168
+ const labels = radarAxisLabels(viz, polarAxis);
132
169
  if (labels.length) out.push({
133
170
  type: "group",
134
171
  key: "radar-axis-labels",
@@ -0,0 +1,187 @@
1
+ /**
2
+ Radar metric labels along the web (see `labelPosition`): each metric's
3
+ name curves just outside the outer ring, centered on its spoke, in the
4
+ arc between the spokes on either side, wrapping onto a second curved
5
+ line when it is too long for one. Curved names need only a line or two
6
+ of room around the web, so when every name fits that way the web grows
7
+ into the band the spoke labels would need.
8
+ */ import { fontExists } from "@d3plus/dom";
9
+ import { fontFamily as defaultFontFamily, textWrap } from "@d3plus/text";
10
+ import { ringTextWidth } from "../features/ringLabelNodes.js";
11
+ import { ringLabelEnd, ringLabelFit, ringLabelPosition } from "../features/ringLabels.js";
12
+ /** The gap (px) between the outer ring and a curved metric label. */ export const RADAR_CURVE_PADDING = 5;
13
+ /** The lines a curved metric label may wrap onto. */ export const RADAR_CURVE_MAX_LINES = 2;
14
+ /** A label's line height: its font's, else 1.2em. */ const lineHeightOf = (l)=>l.font.lineHeight ?? l.font.fontSize * 1.2;
15
+ /**
16
+ The band (px) curved labels need around the web: `lines` of their
17
+ largest line height (the last one only its font size) and the padding
18
+ on either side.
19
+ @param labels The metric labels.
20
+ @param lines How many lines they take.
21
+ */ export function radarCurveBand(labels, lines = 1) {
22
+ const size = Math.max(0, ...labels.map((l)=>l.font.fontSize));
23
+ const lh = Math.max(0, ...labels.map(lineHeightOf));
24
+ return size + (lines - 1) * lh + RADAR_CURVE_PADDING * 2;
25
+ }
26
+ /** The ring segment a label's `j`th line (0 nearest the web) curves along. */ function lineArc(label, radius, j, n) {
27
+ const half = Math.PI / Math.max(1, n);
28
+ // Ring angles run clockwise from 12 o'clock, a spoke's from 3 o'clock.
29
+ const mid = label.angle + Math.PI / 2;
30
+ const inner = radius + j * lineHeightOf(label);
31
+ return {
32
+ innerRadius: inner,
33
+ outerRadius: inner + label.font.fontSize + RADAR_CURVE_PADDING * 2,
34
+ startAngle: mid - half,
35
+ endAngle: mid + half
36
+ };
37
+ }
38
+ /**
39
+ A label's lines curved along the web, nearest line `0` at `radius`: the
40
+ first line outermost where the text reads clockwise (the top half), so
41
+ it reads top to bottom, and innermost on the bottom half. Null when any
42
+ line doesn't fit whole.
43
+ */ function curveLines(label, lines, radius, n) {
44
+ const fit = (text, j)=>ringLabelFit(lineArc(label, radius, j, n), ringTextWidth(text, label.font), {
45
+ fontMin: label.font.fontSize,
46
+ fontMax: label.font.fontSize,
47
+ padding: RADAR_CURVE_PADDING,
48
+ align: "inner",
49
+ minRadius: 0,
50
+ truncate: false
51
+ });
52
+ const first = fit(lines[0], 0);
53
+ if (!first) return null;
54
+ const out = [];
55
+ for(let k = 0; k < lines.length; k++){
56
+ const j = first.clockwise ? lines.length - 1 - k : k;
57
+ const f = j === 0 ? first : fit(lines[k], j);
58
+ if (!f) return null;
59
+ out.push({
60
+ text: lines[k],
61
+ fit: f
62
+ });
63
+ }
64
+ return out.length ? {
65
+ lines: out
66
+ } : null;
67
+ }
68
+ /**
69
+ `text` wrapped onto `count` lines of as even a length as it allows: at
70
+ the narrowest width, down to half of `width`, that keeps it on `count`
71
+ lines.
72
+ @param wrap The wrapper, set to the label's font.
73
+ @param text The text.
74
+ @param width The width it fits on `count` lines.
75
+ @param count Its line count at `width`.
76
+ */ export function balancedLines(wrap, text, width, count) {
77
+ let best = wrap.width(width)(text).lines;
78
+ if (count < 2) return best;
79
+ let lo = width / 2;
80
+ let hi = width;
81
+ for(let step = 0; step < 8 && hi - lo > 1; step++){
82
+ const mid = (lo + hi) / 2;
83
+ const res = wrap.width(mid)(text);
84
+ if (!res.truncated && res.lines.length === count) {
85
+ hi = mid;
86
+ best = res.lines;
87
+ } else lo = mid;
88
+ }
89
+ return best;
90
+ }
91
+ /**
92
+ A label wrapped onto at most `maxLines` lines, each curved along the web,
93
+ or null when it doesn't fit whole that way. It wraps to the arc nearest
94
+ the web, a little narrower each try when a line still overruns.
95
+ */ function wrappedCurve(label, radius, n, maxLines) {
96
+ const { fontSize } = label.font;
97
+ const lh = lineHeightOf(label);
98
+ const arc = lineArc(label, radius, 0, n);
99
+ const inner = radius + RADAR_CURVE_PADDING;
100
+ let width = (arc.endAngle - arc.startAngle) * inner - ringLabelEnd(RADAR_CURVE_PADDING, fontSize) * 2;
101
+ const wrap = textWrap().fontFamily(fontExists(label.font.fontFamily ?? defaultFontFamily)).fontSize(fontSize).fontWeight(label.font.fontWeight ?? 400).lineHeight(lh).height(lh * maxLines).maxLines(maxLines);
102
+ for(let tries = 0; tries < 6 && width > fontSize; tries++){
103
+ const res = wrap.width(width)(label.text);
104
+ if (res.truncated || !res.lines.length) return null;
105
+ const curve = curveLines(label, balancedLines(wrap, label.text, width, res.lines.length), radius, n);
106
+ if (curve) return curve;
107
+ width *= 0.9;
108
+ }
109
+ return null;
110
+ }
111
+ /**
112
+ Each metric's label along the web at `radius`, or null where it doesn't
113
+ fit between its neighbors on `maxLines` lines or its `labelPosition`
114
+ keeps it on its spoke. One line is tried first. A label cut short with
115
+ an ellipsis (on one line) is allowed only when its `labelPosition` is
116
+ `"along"`.
117
+ @param viz The chart.
118
+ @param labels The metric labels, in spoke order.
119
+ @param radius The web's radius.
120
+ @param maxLines The lines a label may wrap onto.
121
+ */ export function radarCurves(viz, labels, radius, maxLines = 1) {
122
+ const n = labels.length;
123
+ return labels.map((label, i)=>{
124
+ const position = ringLabelPosition(viz, label.data, i);
125
+ if (position === "inside" || position === "outside" || !label.text) return null;
126
+ const whole = curveLines(label, [
127
+ label.text
128
+ ], radius, n);
129
+ if (whole) return whole;
130
+ const wrapped = maxLines > 1 ? wrappedCurve(label, radius, n, maxLines) : null;
131
+ if (wrapped || position !== "along") return wrapped;
132
+ const cut = ringLabelFit(lineArc(label, radius, 0, n), ringTextWidth(label.text, label.font), {
133
+ fontMin: label.font.fontSize,
134
+ fontMax: label.font.fontSize,
135
+ padding: RADAR_CURVE_PADDING,
136
+ align: "inner",
137
+ minRadius: 0
138
+ });
139
+ return cut ? {
140
+ lines: [
141
+ {
142
+ text: label.text,
143
+ fit: cut
144
+ }
145
+ ]
146
+ } : null;
147
+ });
148
+ }
149
+ /**
150
+ Whether every metric takes a curved label: each one fits along the web
151
+ (or is cut short, for `"along"`) or has no text.
152
+ @param labels The metric labels.
153
+ @param curves Each one's curve (see `radarCurves`).
154
+ */ export function radarAllCurved(labels, curves) {
155
+ return labels.every((l, k)=>curves[k] || !l.text);
156
+ }
157
+ /**
158
+ The lines a curved label may take at `radius` so it stays inside a
159
+ `width` × `height` area centered on the web: up to
160
+ `RADAR_CURVE_MAX_LINES`, or 0 when not even one fits.
161
+ @param labels The metric labels.
162
+ @param radius The web's radius.
163
+ @param room The room from the center to the area's nearest edge.
164
+ */ export function radarCurveLines(labels, radius, room) {
165
+ for(let lines = RADAR_CURVE_MAX_LINES; lines > 0; lines--)if (radius + radarCurveBand(labels, lines) <= room) return lines;
166
+ return 0;
167
+ }
168
+ /**
169
+ The web's radius and every metric's curved label when every name fits
170
+ along the web, which leaves the web the most room: on one line when
171
+ they all fit, else on up to `RADAR_CURVE_MAX_LINES`. Null when some
172
+ name doesn't fit either way.
173
+ @param viz The chart.
174
+ @param labels The metric labels, in spoke order.
175
+ @param room The room from the center to the area's nearest edge.
176
+ */ export function radarCurvedLayout(viz, labels, room) {
177
+ if (!labels.length) return null;
178
+ for(let lines = 1; lines <= RADAR_CURVE_MAX_LINES; lines++){
179
+ const radius = Math.max(0, room - radarCurveBand(labels, lines));
180
+ const curves = radarCurves(viz, labels, radius, lines);
181
+ if (radarAllCurved(labels, curves)) return {
182
+ radius,
183
+ curves
184
+ };
185
+ }
186
+ return null;
187
+ }
@@ -13,8 +13,7 @@ import { fieldAccessor } from "../../utils/fieldAccessor.js";
13
13
  import constant from "../../utils/constant.js";
14
14
  import { centerChartTransform, chartBounds } from "../features/chartGeometry.js";
15
15
  import { makeChart } from "../definition/makeChart.js";
16
- import { gridStroke } from "../../components/Axis/gridStroke.js";
17
- import { backgroundInk } from "../viz/backgroundInk.js";
16
+ import { backgroundInk, chartGridline } from "../viz/backgroundInk.js";
18
17
  import { applyRadarLayout } from "./applyLayout.js";
19
18
  import { radarEmit } from "./emit.js";
20
19
  export const radarDef = {
@@ -106,7 +105,7 @@ export const radarDef = {
106
105
  },
107
106
  // The inner rings: Plot's gridlines.
108
107
  gridConfig: {
109
- stroke: ()=>gridStroke(viz._select?.node(), viz.schema.colorDefaults),
108
+ stroke: ()=>chartGridline(viz),
110
109
  strokeWidth: 1
111
110
  },
112
111
  // The spokes and metric labels: Plot's ticks.
@@ -0,0 +1,111 @@
1
+ /**
2
+ RadialBar's curved track labels (see `labelPosition`): each track's name
3
+ runs along the track from its bar's start, inside the bar, or along the
4
+ empty track just past the bar's end when the bar is too short for it.
5
+ They name the tracks when the sweep leaves no room before its start for
6
+ the straight labels, and at any sweep for `"along"`.
7
+ */ import { colorContrast } from "@d3plus/color";
8
+ import { paintFromShapeConfig, resolveAccessor, shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
9
+ import { ringLabelNodes, ringTextWidth } from "../features/ringLabelNodes.js";
10
+ import { ringLabelEnd, ringLabelFit } from "../features/ringLabels.js";
11
+ import { backgroundInk } from "../viz/backgroundInk.js";
12
+ import { measureTrackLabels, radialBarCurvedRows } from "./trackLayout.js";
13
+ /**
14
+ Fits a track's label at `fontSize` along its track: inside the bar from
15
+ the bar's start, else on the track from the bar's end, as long as it
16
+ ends before the sweep does. Null when neither holds it whole.
17
+ @param bar The bar's arc.
18
+ @param sweepEnd Where the tracks end.
19
+ @param width The label's one-line width at a font size.
20
+ @param fontSize The label's font size.
21
+ */ export function radialBarLabelSpot(bar, sweepEnd, width, fontSize) {
22
+ const thickness = bar.outerRadius - bar.innerRadius;
23
+ const padding = Math.min(3, (thickness - fontSize) / 2);
24
+ if (padding < 0) return null;
25
+ const rm = (bar.innerRadius + bar.outerRadius) / 2;
26
+ const inner = rm - fontSize / 2;
27
+ if (!(inner > 0)) return null;
28
+ // The turn the text takes, measured where the track is narrowest.
29
+ const turn = (width(fontSize) + ringLabelEnd(padding, fontSize) * 2) / inner + 1e-6;
30
+ const at = (start)=>ringLabelFit({
31
+ ...bar,
32
+ startAngle: start,
33
+ endAngle: start + turn
34
+ }, width, {
35
+ fontMin: fontSize,
36
+ fontMax: fontSize,
37
+ padding,
38
+ minRadius: 0,
39
+ truncate: false
40
+ });
41
+ const span = bar.endAngle - bar.startAngle;
42
+ if (span >= turn) {
43
+ const fit = at(bar.startAngle);
44
+ if (fit) return {
45
+ fit,
46
+ inBar: true
47
+ };
48
+ }
49
+ if (bar.endAngle + turn <= sweepEnd + 1e-9) {
50
+ const fit = at(bar.endAngle);
51
+ if (fit) return {
52
+ fit,
53
+ inBar: false
54
+ };
55
+ }
56
+ return null;
57
+ }
58
+ /**
59
+ The curved labels for the tracks whose rows take one (see
60
+ `radialBarCurvedRows`), each in the color that reads on its bar or, past
61
+ the bar, on its track, unless the Path `labelConfig` sets a `fontColor`.
62
+ Counts the tracks and their labels into `viz._alongStats`, so labels
63
+ that name every track hide the default legend (see `alongLegend.ts`).
64
+ @param viz The chart.
65
+ @param wedges The bars, in track order.
66
+ @param frame The tracks' frame.
67
+ */ export function radialBarCurvedLabels(viz, wedges, frame) {
68
+ const rows = wedges.map((w)=>w.data);
69
+ const curved = radialBarCurvedRows(viz, rows);
70
+ // Every track counts toward whether the labels can stand in for the legend.
71
+ const stats = viz._alongStats;
72
+ if (stats) {
73
+ stats.series += wedges.length;
74
+ stats.requested += curved.filter(Boolean).length;
75
+ }
76
+ if (!curved.some(Boolean)) return [];
77
+ const thickness = wedges.length ? wedges[0].arc.outerRadius - wedges[0].arc.innerRadius : 0;
78
+ const measured = measureTrackLabels(viz, rows, thickness);
79
+ const sc = shapeConfigFor(viz, "Path");
80
+ const trackConfig = viz.schema.trackConfig ?? {};
81
+ const userColor = userLabelConfig(viz, "Path").fontColor;
82
+ const labels = [];
83
+ wedges.forEach((w, k)=>{
84
+ const label = measured[k];
85
+ if (!curved[k] || !label.text) return;
86
+ const font = {
87
+ fontFamily: label.font.fontFamily,
88
+ fontWeight: label.font.fontWeight
89
+ };
90
+ const spot = radialBarLabelSpot(w.arc, frame.end, ringTextWidth(label.text, font), label.size);
91
+ if (!spot) return;
92
+ const under = spot.inBar ? paintFromShapeConfig(sc, w.data, w.i).fill : viz.schema.track === false ? undefined : paintFromShapeConfig(trackConfig, w.data, w.i).fill;
93
+ const custom = resolveAccessor(userColor, w.data, w.i);
94
+ const color = typeof custom === "string" ? custom : typeof under === "string" ? colorContrast(under, viz.schema.colorDefaults) : backgroundInk(viz);
95
+ labels.push({
96
+ key: `radialbar-label-curved-${viz._ids(w.data, w.i).join("-")}`,
97
+ text: label.text,
98
+ fit: spot.fit,
99
+ color,
100
+ datum: w.data,
101
+ index: w.i
102
+ });
103
+ });
104
+ const first = measured[0]?.font;
105
+ const nodes = ringLabelNodes(viz, labels, first ? {
106
+ fontFamily: first.fontFamily,
107
+ fontWeight: first.fontWeight
108
+ } : {});
109
+ if (stats) stats.placed += nodes.length;
110
+ return nodes;
111
+ }
@@ -4,6 +4,7 @@
4
4
  */ import { formatAbbreviate } from "@d3plus/format";
5
5
  import { arcPath } from "@d3plus/render";
6
6
  import { polarWedgeNodes } from "../polar/config.js";
7
+ import { radialBarCurvedLabels } from "./curvedLabels.js";
7
8
  export const radialBarEmit = ({ viz, shapeData })=>{
8
9
  const wedges = shapeData ?? [];
9
10
  if (!wedges.length) return [];
@@ -31,8 +32,10 @@ export const radialBarEmit = ({ viz, shapeData })=>{
31
32
  };
32
33
  });
33
34
  const bars = polarWedgeNodes(viz, wedges, "radialbar", (w)=>`${viz._drawLabel(w.data, w.i)}, ${formatAbbreviate(w.value, viz.schema.locale)}.`);
35
+ const labels = angular ? [] : radialBarCurvedLabels(viz, wedges, frame);
34
36
  return [
35
37
  ...hits,
36
- ...bars
38
+ ...bars,
39
+ ...labels
37
40
  ];
38
41
  };