@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,207 @@
1
+ /**
2
+ The Gantt's inert scene nodes: the label column's text, each group's
3
+ summary bracket, the dependency arrows, and the "today" line. None of
4
+ them take the pointer or keyboard focus.
5
+ */ import { arrowNode } from "../features/edgeArrows.js";
6
+ import { referenceLineNodes } from "../features/referenceAnnotations.js";
7
+ import { backgroundInk } from "../viz/backgroundInk.js";
8
+ import { LABEL_INDENT, LABEL_PADDING } from "./applyLayout.js";
9
+ import { bracketPath, elbowRoute } from "./ganttGeometry.js";
10
+ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
11
+ /** Reads `dependencyConfig`, with the chart's ink as the default color. */ export function dependencyStyle(viz) {
12
+ const cfg = viz.schema.dependencyConfig ?? {};
13
+ return {
14
+ stroke: cfg.stroke || backgroundInk(viz),
15
+ strokeWidth: num(cfg.strokeWidth, 1),
16
+ strokeOpacity: num(cfg.strokeOpacity, 0.55),
17
+ arrowSize: Math.max(2, num(cfg.arrowSize, 6))
18
+ };
19
+ }
20
+ /** The label column's text: one node per row with a fitted label. */ export function labelNodes(layout, marks) {
21
+ const { font } = layout;
22
+ const byRow = new Map(marks.map((m)=>[
23
+ m.row,
24
+ m
25
+ ]));
26
+ const out = [];
27
+ layout.rows.forEach((row, k)=>{
28
+ const fitted = layout.labels[k];
29
+ if (!fitted || !fitted.lines.length) return;
30
+ const group = row.kind === "group";
31
+ const indent = !group && row.indent ? LABEL_INDENT : 0;
32
+ const top = layout.cy[k] - fitted.lines.length * font.lineHeight / 2;
33
+ const mark = byRow.get(k);
34
+ out.push({
35
+ type: "text",
36
+ key: `gantt-label-${row.key}`,
37
+ interactive: false,
38
+ ...mark ? {
39
+ datum: mark.data,
40
+ index: mark.i
41
+ } : {},
42
+ x: 0,
43
+ y: 0,
44
+ transform: {
45
+ x: LABEL_PADDING + indent,
46
+ y: top
47
+ },
48
+ lines: fitted.lines.map((text, i)=>({
49
+ text,
50
+ x: 0,
51
+ y: font.lineHeight * (i + 0.5),
52
+ width: fitted.widths[i]
53
+ })),
54
+ font: {
55
+ family: font.family,
56
+ size: font.size,
57
+ weight: group ? 600 : 400,
58
+ anchor: "start",
59
+ baseline: "middle"
60
+ },
61
+ paint: {
62
+ fill: font.color
63
+ }
64
+ });
65
+ });
66
+ return out;
67
+ }
68
+ /** Each group header's summary bracket, from its first start to its last end. */ export function groupNodes(viz, layout) {
69
+ const fill = backgroundInk(viz);
70
+ const out = [];
71
+ layout.rows.forEach((row, k)=>{
72
+ if (row.kind !== "group") return;
73
+ const x0 = layout.x(row.start), x1 = Math.max(layout.x(row.end), x0 + 1);
74
+ out.push({
75
+ type: "path",
76
+ key: `gantt-${row.key}`,
77
+ interactive: false,
78
+ d: bracketPath(x0, x1, layout.cy[k], Math.max(2, layout.band * 0.4)),
79
+ paint: {
80
+ fill,
81
+ fillOpacity: 0.6
82
+ }
83
+ });
84
+ });
85
+ return out;
86
+ }
87
+ /** Where a dependency leaves a task: its bar's right edge or its diamond's right tip. */ export function taskEnd(mark, r) {
88
+ return [
89
+ mark.milestone ? mark.x1 + r : mark.x1,
90
+ mark.cy
91
+ ];
92
+ }
93
+ /** Where a dependency enters a task: its bar's left edge or its diamond's left tip. */ export function taskStart(mark, r) {
94
+ return [
95
+ mark.milestone ? mark.x1 - r : mark.x0,
96
+ mark.cy
97
+ ];
98
+ }
99
+ /**
100
+ One elbow line and arrowhead per dependency whose predecessor is drawn,
101
+ from the predecessor's end to the dependent's start. Each carries both
102
+ tasks as interaction points, so hovering either keeps it lit while the
103
+ rest dim.
104
+ */ export function dependencyNodes(viz, layout, marks, r) {
105
+ const style = dependencyStyle(viz);
106
+ const byId = new Map(marks.map((m)=>[
107
+ m.id,
108
+ m
109
+ ]));
110
+ const stub = Math.max(8, style.arrowSize + 4);
111
+ const out = [];
112
+ for (const mark of marks){
113
+ for (const id of mark.dependencies){
114
+ const pred = byId.get(id);
115
+ if (!pred || pred === mark) continue;
116
+ const from = taskEnd(pred, r), to = taskStart(mark, r);
117
+ const route = elbowRoute(from, to, stub, layout.step);
118
+ const points = route.slice();
119
+ const last = points.length - 1;
120
+ points[last] = [
121
+ to[0] - style.arrowSize * 0.8,
122
+ to[1]
123
+ ];
124
+ const key = `gantt-dependency-${pred.id}-${mark.id}`;
125
+ const interactionPoints = [
126
+ {
127
+ x: from[0],
128
+ y: from[1],
129
+ datum: pred.data,
130
+ index: pred.i
131
+ },
132
+ {
133
+ x: to[0],
134
+ y: to[1],
135
+ datum: mark.data,
136
+ index: mark.i
137
+ }
138
+ ];
139
+ out.push({
140
+ type: "line",
141
+ key,
142
+ interactive: false,
143
+ points,
144
+ curve: "linear",
145
+ interactionPoints,
146
+ paint: {
147
+ fill: "none",
148
+ stroke: style.stroke,
149
+ strokeWidth: style.strokeWidth,
150
+ strokeOpacity: style.strokeOpacity
151
+ }
152
+ });
153
+ const arrow = arrowNode({
154
+ key: `${key}-arrow`,
155
+ datum: mark.data,
156
+ x: to[0],
157
+ y: to[1],
158
+ angle: 0,
159
+ size: style.arrowSize,
160
+ fill: style.stroke
161
+ });
162
+ out.push({
163
+ ...arrow,
164
+ datum: undefined,
165
+ interactionPoints,
166
+ paint: {
167
+ ...arrow.paint,
168
+ fillOpacity: style.strokeOpacity
169
+ }
170
+ });
171
+ }
172
+ }
173
+ return out;
174
+ }
175
+ /** The time `today` marks: now for `true`, the value given otherwise, or null when off. */ export function todayValue(today, now = ()=>new Date()) {
176
+ if (today === true) return now();
177
+ if (today === false || today === undefined || today === null || today === "") return null;
178
+ return today;
179
+ }
180
+ /**
181
+ The "today" line across the rows at `today`, styled by `todayConfig` and
182
+ labeled with the translated "Today" unless `todayConfig.label` says
183
+ otherwise. Nothing when `today` is off or falls outside the time axis.
184
+ */ export function todayNodes(viz, layout) {
185
+ const value = todayValue(viz.schema.today);
186
+ if (value === null) return [];
187
+ const cfg = viz.schema.todayConfig ?? {};
188
+ const annotation = {
189
+ label: viz.schema.translate("Today"),
190
+ fontSize: 11,
191
+ labelPosition: "end",
192
+ strokeOpacity: 0.85,
193
+ strokeWidth: 1.5,
194
+ ...cfg,
195
+ shape: "ReferenceLine",
196
+ x: value
197
+ };
198
+ return referenceLineNodes(viz, annotation, {
199
+ plot: layout.plot,
200
+ axes: {
201
+ x: {
202
+ scale: (v)=>layout.x(v),
203
+ time: layout.time
204
+ }
205
+ }
206
+ }, "gantt-today");
207
+ }
@@ -0,0 +1,107 @@
1
+ /**
2
+ Pure Gantt geometry: the milestone diamond, a bar's progress split, a
3
+ group's summary bracket, the elbow route of a dependency arrow, and the
4
+ label column's width.
5
+ */ /** A point, `[x, y]`. */ const round = (n)=>Math.round(n * 100) / 100;
6
+ /**
7
+ The SVG path of a diamond centered on `(cx, cy)`, `r` from its center to
8
+ each tip.
9
+ */ export function diamondPath(cx, cy, r) {
10
+ return `M${round(cx)},${round(cy - r)}L${round(cx + r)},${round(cy)}L${round(cx)},${round(cy + r)}L${round(cx - r)},${round(cy)}Z`;
11
+ }
12
+ /**
13
+ Splits a bar into its done part (from its start) and the rest, by the
14
+ share of it `progress` covers (clamped to 0–1).
15
+ @param x The bar's left edge.
16
+ @param width The bar's width.
17
+ @param progress The share done.
18
+ */ export function progressSplit(x, width, progress) {
19
+ const p = Math.max(0, Math.min(1, progress));
20
+ const done = width * p;
21
+ return {
22
+ done: {
23
+ x,
24
+ width: done
25
+ },
26
+ rest: {
27
+ x: x + done,
28
+ width: width - done
29
+ }
30
+ };
31
+ }
32
+ /**
33
+ The SVG path of a group's summary bracket: a bar from `x0` to `x1`
34
+ centered on `cy`, `h` tall, with a pointed foot hanging below each end.
35
+ */ export function bracketPath(x0, x1, cy, h) {
36
+ const top = cy - h / 2, bottom = cy + h / 2;
37
+ const foot = Math.min(h, Math.max(0, (x1 - x0) / 2));
38
+ return `M${round(x0)},${round(top)}H${round(x1)}V${round(bottom + foot)}L${round(x1 - foot)},${round(bottom)}H${round(x0 + foot)}L${round(x0)},${round(bottom + foot)}Z`;
39
+ }
40
+ /**
41
+ The route of a dependency arrow from a predecessor's end (`from`) to a
42
+ dependent's start (`to`): right `stub` pixels, then down (or up) to the
43
+ dependent's row, then right into its start. When the dependent starts
44
+ too close to (or before) the predecessor's end for that, the route turns
45
+ down (or up) to the edge of the predecessor's row (`step / 2` away),
46
+ runs back left to `stub` before the dependent's start, and drops to its
47
+ row from there. Points on one row join straight.
48
+ @param from The predecessor's end.
49
+ @param to The dependent's start.
50
+ @param stub The length of the first and last legs.
51
+ @param step The distance between neighboring row centers.
52
+ */ export function elbowRoute(from, to, stub, step) {
53
+ const [x0, y0] = from, [x1, y1] = to;
54
+ if (y0 === y1 && x1 >= x0) return [
55
+ from,
56
+ to
57
+ ];
58
+ const turn = x0 + stub;
59
+ if (x1 - x0 >= 2 * stub) return [
60
+ from,
61
+ [
62
+ turn,
63
+ y0
64
+ ],
65
+ [
66
+ turn,
67
+ y1
68
+ ],
69
+ to
70
+ ];
71
+ const dir = y1 > y0 ? 1 : -1;
72
+ const mid = y0 + dir * step / 2;
73
+ const back = x1 - stub;
74
+ return [
75
+ from,
76
+ [
77
+ turn,
78
+ y0
79
+ ],
80
+ [
81
+ turn,
82
+ mid
83
+ ],
84
+ [
85
+ back,
86
+ mid
87
+ ],
88
+ [
89
+ back,
90
+ y1
91
+ ],
92
+ to
93
+ ];
94
+ }
95
+ /**
96
+ The label column's width: the widest label plus padding on both sides,
97
+ at most `limit` (a share of the chart's `width` when below 1, else
98
+ pixels). Zero when there are no labels or no room.
99
+ @param widest The widest label's width (with its indent).
100
+ @param width The chart's width.
101
+ @param limit The `labelWidth` setting.
102
+ @param padding The space on each side of the labels.
103
+ */ export function labelColumnWidth(widest, width, limit, padding) {
104
+ if (!(widest > 0) || !(limit > 0)) return 0;
105
+ const most = limit <= 1 ? width * limit : limit;
106
+ return Math.max(0, Math.min(Math.ceil(widest + padding * 2), most));
107
+ }
@@ -0,0 +1,85 @@
1
+ /**
2
+ The Gantt's label column text: the label font, and each label wrapped to
3
+ the column's width over as many lines as its row holds, the last line
4
+ ending in an ellipsis when the label doesn't fit.
5
+ */ import { textWidth } from "@d3plus/dom";
6
+ import { fontFamilyStringify, textWrap } from "@d3plus/text";
7
+ import { resolveAccessor } from "../features/emitHelpers.js";
8
+ import { backgroundInk } from "../viz/backgroundInk.js";
9
+ /** The label font size, in pixels, unless `taskLabelConfig` sets one. */ export const LABEL_FONT_SIZE = 12;
10
+ /** Reads `taskLabelConfig`, with the chart's font and ink as defaults. */ export function ganttLabelFont(viz) {
11
+ const cfg = viz.schema.taskLabelConfig ?? {};
12
+ const size = resolveAccessor(cfg.fontSize, {}, 0);
13
+ const family = resolveAccessor(cfg.fontFamily, {}, 0) ?? viz.schema.fontFamily;
14
+ const fontSize = typeof size === "number" && size > 0 ? size : LABEL_FONT_SIZE;
15
+ return {
16
+ family: fontFamilyStringify(family),
17
+ size: fontSize,
18
+ color: resolveAccessor(cfg.fontColor, {}, 0) ?? backgroundInk(viz),
19
+ lineHeight: Math.round(fontSize * 1.2)
20
+ };
21
+ }
22
+ /** The width of `text` in the label font. */ export function labelWidth(text, font, weight = 400) {
23
+ return text ? textWidth(text, {
24
+ "font-family": font.family,
25
+ "font-size": font.size,
26
+ "font-weight": weight
27
+ }) : 0;
28
+ }
29
+ /**
30
+ Ends `text` in an ellipsis, dropping characters until it fits `width`.
31
+ @param text The line.
32
+ @param width The room it has.
33
+ @param measure Measures a line.
34
+ */ export function ellipsize(text, width, measure) {
35
+ let t = text.trimEnd();
36
+ while(t.length){
37
+ const candidate = `${t}…`;
38
+ if (measure(candidate) <= width) return candidate;
39
+ t = t.slice(0, -1).trimEnd();
40
+ }
41
+ return "";
42
+ }
43
+ /**
44
+ Wraps a label to `width`, over at most `maxLines` lines, ending the last
45
+ in an ellipsis when the label doesn't fit.
46
+ @param text The label.
47
+ @param width The room each line has.
48
+ @param maxLines The most lines it may take.
49
+ @param font The label font.
50
+ @param weight The font weight.
51
+ */ export function fitLabel(text, width, maxLines, font, weight = 400) {
52
+ const measure = (t)=>labelWidth(t, font, weight);
53
+ if (!text || width <= 0 || maxLines < 1) return {
54
+ lines: [],
55
+ widths: []
56
+ };
57
+ const wrap = textWrap().fontFamily(font.family).fontSize(font.size).fontWeight(weight).lineHeight(font.lineHeight).width(width).height(font.lineHeight * maxLines).maxLines(maxLines)(text);
58
+ const lines = wrap.lines.filter((l)=>l !== "");
59
+ const shown = lines.join(" ").replace(/\s+/g, " ").trim();
60
+ const whole = text.replace(/\s+/g, " ").trim();
61
+ if (!lines.length) {
62
+ const only = ellipsize(whole, width, measure);
63
+ return only ? {
64
+ lines: [
65
+ only
66
+ ],
67
+ widths: [
68
+ measure(only)
69
+ ]
70
+ } : {
71
+ lines: [],
72
+ widths: []
73
+ };
74
+ }
75
+ if (wrap.truncated || shown.length < whole.length || measure(lines[lines.length - 1]) > width) {
76
+ const last = lines.length - 1;
77
+ const rest = whole.slice(lines.slice(0, last).join(" ").length + (last ? 1 : 0));
78
+ lines[last] = ellipsize(rest, width, measure);
79
+ if (!lines[last]) lines.pop();
80
+ }
81
+ return {
82
+ lines,
83
+ widths: lines.map(measure)
84
+ };
85
+ }
@@ -0,0 +1,111 @@
1
+ /**
2
+ Pure helpers that turn a Gantt's data rows into its row list: reading
3
+ each task's milestone flag, progress, and dependencies, ordering tasks
4
+ by `taskSort`, and grouping them under `group` header rows.
5
+ */ /**
6
+ Whether a task draws as a milestone: when its `milestone` value is
7
+ truthy, or, without one, when it starts and ends at the same time.
8
+ @param start The task's start.
9
+ @param end The task's end.
10
+ @param flag The task's `milestone` value.
11
+ */ export function isMilestone(start, end, flag) {
12
+ if (flag !== undefined && flag !== null && flag !== "") return !!flag;
13
+ return +start === +end;
14
+ }
15
+ /**
16
+ A `progress` value as a share from 0 to 1: a number is read as a
17
+ fraction (`0.6`), a string ending in `%` as a percent (`"60%"`), clamped
18
+ to 0–1. Anything else is undefined.
19
+ @param value The raw value.
20
+ */ export function normalizeProgress(value) {
21
+ let n;
22
+ if (typeof value === "number") n = value;
23
+ else if (typeof value === "string" && value.trim().endsWith("%")) n = parseFloat(value) / 100;
24
+ else if (typeof value === "string" && value.trim() !== "") n = Number(value);
25
+ else return undefined;
26
+ if (!Number.isFinite(n)) return undefined;
27
+ return Math.max(0, Math.min(1, n));
28
+ }
29
+ /**
30
+ A `dependencies` value as a list of task ids: an array, or a string of
31
+ comma-separated ids. Anything else is no dependencies.
32
+ @param value The raw value.
33
+ */ export function dependencyIds(value) {
34
+ const list = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : typeof value === "number" ? [
35
+ value
36
+ ] : [];
37
+ const ids = list.filter((v)=>v !== undefined && v !== null).map((v)=>`${v}`.trim()).filter((v)=>v !== "");
38
+ return Array.from(new Set(ids));
39
+ }
40
+ /**
41
+ Orders tasks by `taskSort`: `"data"` keeps their order, `"start"` sorts
42
+ by start (then end), and a function compares their data rows. Ties keep
43
+ data order.
44
+ @param tasks The tasks.
45
+ @param sort The `taskSort` setting.
46
+ */ export function sortTasks(tasks, sort) {
47
+ const byIndex = (a, b)=>a.i - b.i;
48
+ if (typeof sort === "function") return [
49
+ ...tasks
50
+ ].sort((a, b)=>sort(a.data, b.data) || byIndex(a, b));
51
+ if (sort === "start") return [
52
+ ...tasks
53
+ ].sort((a, b)=>+a.start - +b.start || +a.end - +b.end || byIndex(a, b));
54
+ return [
55
+ ...tasks
56
+ ].sort(byIndex);
57
+ }
58
+ /**
59
+ The chart's rows, top to bottom. Tasks are ordered by `sort`; when any
60
+ task has a group, each group gets a header row (spanning its tasks'
61
+ earliest start to latest end) followed by its tasks, the groups in the
62
+ order their first task appears. Tasks without a group stay in place
63
+ among the groups, without a header.
64
+ @param tasks The tasks.
65
+ @param sort The `taskSort` setting.
66
+ */ export function ganttRows(tasks, sort) {
67
+ const sorted = sortTasks(tasks, sort);
68
+ const taskRow = (task, indent)=>({
69
+ kind: "task",
70
+ key: `task-${task.id}`,
71
+ task,
72
+ indent
73
+ });
74
+ if (!sorted.some((t)=>t.group !== undefined)) return sorted.map((t)=>taskRow(t, false));
75
+ const groups = new Map();
76
+ const order = [];
77
+ for (const task of sorted){
78
+ if (task.group === undefined) {
79
+ order.push(task);
80
+ continue;
81
+ }
82
+ const list = groups.get(task.group);
83
+ if (list) list.push(task);
84
+ else {
85
+ groups.set(task.group, [
86
+ task
87
+ ]);
88
+ order.push(task.group);
89
+ }
90
+ }
91
+ const rows = [];
92
+ for (const entry of order){
93
+ if (typeof entry !== "string") {
94
+ rows.push(taskRow(entry, false));
95
+ continue;
96
+ }
97
+ const members = groups.get(entry);
98
+ rows.push({
99
+ kind: "group",
100
+ key: `group-${entry}`,
101
+ label: entry,
102
+ start: earliest(members.map((t)=>t.start)),
103
+ end: latest(members.map((t)=>t.end)),
104
+ tasks: members
105
+ });
106
+ members.forEach((t)=>rows.push(taskRow(t, true)));
107
+ }
108
+ return rows;
109
+ }
110
+ const earliest = (values)=>values.reduce((a, b)=>+b < +a ? b : a);
111
+ const latest = (values)=>values.reduce((a, b)=>+b > +a ? b : a);
@@ -0,0 +1,136 @@
1
+ /**
2
+ What a Gantt task reads as in its tooltip and aria label: its start,
3
+ end, duration, and progress (or a milestone's date), in the chart's
4
+ locale and translated.
5
+ */ import { timeFormatLocale } from "d3-time-format";
6
+ import { dateFullFormatter, formatAbbreviate } from "@d3plus/format";
7
+ import { normalizeRangeBreaks, visibleBetween } from "../../components/Axis/rangeBreaks.js";
8
+ import { calendarTimeLocale } from "../Calendar/calendarFormat.js";
9
+ import { isTimeAxis, parseTime, rowTime } from "../Priestley/timeAxis.js";
10
+ import { isMilestone, normalizeProgress } from "./ganttRows.js";
11
+ /** A day, in milliseconds. */ const DAY = 864e5;
12
+ /**
13
+ Formats starts and ends: dates in the chart's locale, at the precision
14
+ the given dates step by (see `formatDateFull`), or numbers abbreviated.
15
+ @param viz The chart.
16
+ @param values The dates the chart draws, which set the precision.
17
+ */ export function timeFormatter(viz, values) {
18
+ if (!isTimeAxis(viz)) return (v)=>formatAbbreviate(Number(v), viz.schema.locale);
19
+ const dates = Array.from(new Set(values.map(Number))).sort((a, b)=>a - b).map((t)=>new Date(t));
20
+ const locale = timeFormatLocale(calendarTimeLocale(viz.schema.locale));
21
+ const format = dateFullFormatter(dates, locale.format);
22
+ return (v)=>format(v instanceof Date ? v : new Date(v));
23
+ }
24
+ /**
25
+ The time axis's `rangeBreaks` rules (from `axisConfig`) when they hide
26
+ whole days (weekends, weekdays, dates, or explicit ranges), else none: a
27
+ rule hiding hours of every day leaves no whole days to count.
28
+ @param viz The chart.
29
+ */ export function ganttDayBreaks(viz) {
30
+ const config = viz.schema.axisConfig;
31
+ const rules = normalizeRangeBreaks(config?.rangeBreaks);
32
+ return rules.some((r)=>typeof r === "object" && "hours" in r) ? [] : rules;
33
+ }
34
+ /**
35
+ A task's duration: whole (or tenths of) days on a time axis, translated
36
+ ("12 days"), else the difference of its end and start. When the axis's
37
+ `rangeBreaks` hide whole days (see `ganttDayBreaks`), only the days left
38
+ showing count ("8 working days").
39
+ */ export function ganttDuration(viz, start, end) {
40
+ const span = +end - +start;
41
+ if (!isTimeAxis(viz)) return formatAbbreviate(span, viz.schema.locale);
42
+ const rules = ganttDayBreaks(viz);
43
+ const shown = rules.length ? visibleBetween(rules, +start, +end) : span;
44
+ const days = Math.round(shown / DAY * 10) / 10;
45
+ const unit = viz.schema.translate(`${rules.length ? "working " : ""}${days === 1 ? "day" : "days"}`);
46
+ return `${dayCount(days, viz.schema.locale)} ${unit}`;
47
+ }
48
+ /** A day count in a locale, with at most one decimal. */ export function dayCount(days, locale) {
49
+ try {
50
+ return new Intl.NumberFormat(typeof locale === "string" ? locale : "en-US", {
51
+ maximumFractionDigits: 1
52
+ }).format(days);
53
+ } catch {
54
+ return `${days}`;
55
+ }
56
+ }
57
+ /** A share from 0 to 1 as a whole percent. */ export const percent = (share)=>`${Math.round(share * 100)}%`;
58
+ /**
59
+ Reads a row's start, end, milestone flag, and progress. A missing start
60
+ or end takes the other's value, and reversed times are swapped; null
61
+ when both are missing.
62
+ */ export function taskTimes(viz, d, i) {
63
+ const time = isTimeAxis(viz);
64
+ let start = parseTime(rowTime(viz, "start", d, i), time);
65
+ let end = parseTime(rowTime(viz, "end", d, i), time);
66
+ if (start === null && end === null) return null;
67
+ start ??= end;
68
+ end ??= start;
69
+ if (+end < +start) [start, end] = [
70
+ end,
71
+ start
72
+ ];
73
+ const milestoneFn = viz.schema.milestone;
74
+ const progressFn = viz.schema.progress;
75
+ return {
76
+ start: start,
77
+ end: end,
78
+ milestone: isMilestone(start, end, typeof milestoneFn === "function" ? milestoneFn(d, i) : undefined),
79
+ progress: normalizeProgress(typeof progressFn === "function" ? progressFn(d, i) : undefined)
80
+ };
81
+ }
82
+ /** The layout's start/end formatter, or one built from this row alone. */ function formatFor(viz, values) {
83
+ const layout = viz.ctx.gantt;
84
+ return layout?.format ?? timeFormatter(viz, values);
85
+ }
86
+ /**
87
+ The tooltip rows for a task: Start, End, Duration, and Progress, or a
88
+ milestone's date and Progress, each label translated.
89
+ */ export function ganttTooltipRows(viz, d, i) {
90
+ const task = taskTimes(viz, d, i);
91
+ if (!task) return [];
92
+ const t = (s)=>viz.schema.translate(s);
93
+ const format = formatFor(viz, [
94
+ task.start,
95
+ task.end
96
+ ]);
97
+ const rows = task.milestone ? [
98
+ [
99
+ t("Milestone"),
100
+ format(task.end)
101
+ ]
102
+ ] : [
103
+ [
104
+ t("Start"),
105
+ format(task.start)
106
+ ],
107
+ [
108
+ t("End"),
109
+ format(task.end)
110
+ ],
111
+ [
112
+ t("Duration"),
113
+ ganttDuration(viz, task.start, task.end)
114
+ ]
115
+ ];
116
+ if (task.progress !== undefined) rows.push([
117
+ t("Progress"),
118
+ percent(task.progress)
119
+ ]);
120
+ return rows;
121
+ }
122
+ /**
123
+ A task's aria label: its name and span (or a milestone's date), and its
124
+ progress, such as `"Design, Jan 8, 2024 - Jan 19, 2024, Progress 60%."`.
125
+ */ export function ganttAriaLabel(viz, d, i) {
126
+ const name = `${viz._drawLabel(d, i) ?? ""}`;
127
+ const task = taskTimes(viz, d, i);
128
+ if (!task) return `${name}.`;
129
+ const format = formatFor(viz, [
130
+ task.start,
131
+ task.end
132
+ ]);
133
+ const when = task.milestone ? `${viz.schema.translate("Milestone")} ${format(task.end)}` : `${format(task.start)} - ${format(task.end)}`;
134
+ const progress = task.progress === undefined ? "" : `, ${viz.schema.translate("Progress")} ${percent(task.progress)}`;
135
+ return `${name}, ${when}${progress}.`;
136
+ }