@d3plus/core 4.9.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 (687) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +170 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +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 +95 -4
  21. package/es/src/charts/BoxWhisker/outliers.js +68 -0
  22. package/es/src/charts/BoxWhisker/summary.js +83 -0
  23. package/es/src/charts/BoxWhisker/tooltip.js +122 -0
  24. package/es/src/charts/BubbleChart/emit.js +31 -0
  25. package/es/src/charts/BubbleChart/index.js +54 -0
  26. package/es/src/charts/Bullet/index.js +2 -1
  27. package/es/src/charts/BumpChart/index.js +5 -0
  28. package/es/src/charts/Calendar/emit.js +1 -1
  29. package/es/src/charts/Calendar/index.js +5 -3
  30. package/es/src/charts/Candlestick/aggregate.js +11 -1
  31. package/es/src/charts/Candlestick/buffer.js +6 -4
  32. package/es/src/charts/Candlestick/index.js +7 -6
  33. package/es/src/charts/Chord/applyLayout.js +56 -69
  34. package/es/src/charts/Chord/emit.js +55 -24
  35. package/es/src/charts/Chord/index.js +17 -12
  36. package/es/src/charts/Chord/labels.js +105 -0
  37. package/es/src/charts/Donut/index.js +5 -11
  38. package/es/src/charts/Dumbbell/index.js +2 -4
  39. package/es/src/charts/Funnel/index.js +2 -1
  40. package/es/src/charts/Gantt/applyLayout.js +162 -0
  41. package/es/src/charts/Gantt/emit.js +142 -0
  42. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  43. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  44. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  45. package/es/src/charts/Gantt/ganttRows.js +111 -0
  46. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  47. package/es/src/charts/Gantt/index.js +219 -0
  48. package/es/src/charts/Gauge/index.js +2 -1
  49. package/es/src/charts/Geomap/applyLayout.js +90 -49
  50. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  51. package/es/src/charts/Geomap/emit.js +19 -2
  52. package/es/src/charts/Geomap/flowEmit.js +132 -0
  53. package/es/src/charts/Geomap/flowEvents.js +86 -0
  54. package/es/src/charts/Geomap/flowFields.js +91 -0
  55. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  56. package/es/src/charts/Geomap/flowLinks.js +239 -0
  57. package/es/src/charts/Geomap/geoCache.js +180 -0
  58. package/es/src/charts/Geomap/globeKeys.js +131 -0
  59. package/es/src/charts/Geomap/globeRotate.js +208 -0
  60. package/es/src/charts/Geomap/index.js +60 -19
  61. package/es/src/charts/Geomap/pointLabels.js +107 -0
  62. package/es/src/charts/Hexbin/binning.js +103 -0
  63. package/es/src/charts/Hexbin/buffer.js +33 -0
  64. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  65. package/es/src/charts/Hexbin/contours.js +48 -0
  66. package/es/src/charts/Hexbin/emit.js +142 -0
  67. package/es/src/charts/Hexbin/index.js +204 -0
  68. package/es/src/charts/Hexbin/layers.js +212 -0
  69. package/es/src/charts/Hexbin/settings.js +86 -0
  70. package/es/src/charts/Hexbin/tooltip.js +77 -0
  71. package/es/src/charts/Histogram/binData.js +31 -4
  72. package/es/src/charts/Histogram/index.js +37 -16
  73. package/es/src/charts/Histogram/labels.js +18 -0
  74. package/es/src/charts/Icicle/index.js +3 -3
  75. package/es/src/charts/LinePlot/index.js +7 -0
  76. package/es/src/charts/Marimekko/index.js +7 -4
  77. package/es/src/charts/Matrix/index.js +3 -2
  78. package/es/src/charts/Network/applyLayout.js +138 -94
  79. package/es/src/charts/Network/bundle.js +81 -0
  80. package/es/src/charts/Network/clusterLabels.js +423 -0
  81. package/es/src/charts/Network/clusters.js +290 -0
  82. package/es/src/charts/Network/emit.js +253 -70
  83. package/es/src/charts/Network/graph.js +117 -0
  84. package/es/src/charts/Network/graphFluent.js +79 -0
  85. package/es/src/charts/Network/index.js +93 -108
  86. package/es/src/charts/Network/minNodeDistance.js +64 -0
  87. package/es/src/charts/Network/polygonRows.js +44 -0
  88. package/es/src/charts/Pack/index.js +7 -2
  89. package/es/src/charts/Pie/applyLayout.js +86 -27
  90. package/es/src/charts/Pie/arcFit.js +152 -0
  91. package/es/src/charts/Pie/curvedLabels.js +134 -0
  92. package/es/src/charts/Pie/emit.js +43 -96
  93. package/es/src/charts/Pie/index.js +66 -32
  94. package/es/src/charts/Pie/labelRoom.js +154 -0
  95. package/es/src/charts/Pie/outsideLabels.js +224 -0
  96. package/es/src/charts/Pie/outsideNodes.js +267 -0
  97. package/es/src/charts/Pie/pieLabels.js +137 -0
  98. package/es/src/charts/Pie/sectorBox.js +223 -0
  99. package/es/src/charts/Pie/straightLabels.js +96 -0
  100. package/es/src/charts/Pie/straightLayout.js +215 -0
  101. package/es/src/charts/Plot/alongLegend.js +76 -0
  102. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  103. package/es/src/charts/Plot/axisHover.js +180 -0
  104. package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
  105. package/es/src/charts/Plot/axisHoverScene.js +203 -0
  106. package/es/src/charts/Plot/axisValues.js +43 -0
  107. package/es/src/charts/Plot/barHitArea.js +81 -0
  108. package/es/src/charts/Plot/barLabelFit.js +123 -0
  109. package/es/src/charts/Plot/barWidth.js +61 -13
  110. package/es/src/charts/Plot/circleLabels.js +98 -0
  111. package/es/src/charts/Plot/confidenceConfig.js +2 -2
  112. package/es/src/charts/Plot/connectGaps.js +237 -0
  113. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  114. package/es/src/charts/Plot/draw.js +14 -4
  115. package/es/src/charts/Plot/fillBetween.js +2 -1
  116. package/es/src/charts/Plot/forecastScene.js +3 -4
  117. package/es/src/charts/Plot/index.js +42 -15
  118. package/es/src/charts/Plot/labelPlacement.js +10 -2
  119. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  120. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  121. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  122. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  123. package/es/src/charts/Plot/openDomainEnds.js +2 -5
  124. package/es/src/charts/Plot/pipeline.js +71 -22
  125. package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
  126. package/es/src/charts/Plot/pipelineDomains.js +23 -6
  127. package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
  128. package/es/src/charts/Plot/pipelineScales.js +40 -8
  129. package/es/src/charts/Plot/plotFacet.js +12 -1
  130. package/es/src/charts/Plot/plotInit.js +49 -5
  131. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  132. package/es/src/charts/Plot/plotZoom.js +15 -6
  133. package/es/src/charts/Plot/referenceDomains.js +133 -0
  134. package/es/src/charts/Plot/shapeDefaults.js +14 -9
  135. package/es/src/charts/Plot/sharedHoverScene.js +50 -31
  136. package/es/src/charts/Plot/sharedTooltip.js +19 -7
  137. package/es/src/charts/Plot/stackHelpers.js +13 -1
  138. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  139. package/es/src/charts/Plot/stackShareTooltip.js +9 -4
  140. package/es/src/charts/Plot/stackThreshold.js +154 -0
  141. package/es/src/charts/Plot/trendLabels.js +183 -0
  142. package/es/src/charts/Plot/trendLines.js +1 -0
  143. package/es/src/charts/Plot/trendScene.js +6 -3
  144. package/es/src/charts/Plot/trendTooltip.js +5 -1
  145. package/es/src/charts/PolarArea/index.js +5 -4
  146. package/es/src/charts/Priestley/applyLayout.js +14 -20
  147. package/es/src/charts/Priestley/index.js +4 -34
  148. package/es/src/charts/Priestley/timeAxis.js +100 -0
  149. package/es/src/charts/Pyramid/index.js +4 -2
  150. package/es/src/charts/Radar/axisDecorations.js +49 -12
  151. package/es/src/charts/Radar/curvedLabels.js +187 -0
  152. package/es/src/charts/Radar/index.js +5 -5
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +4 -1
  155. package/es/src/charts/RadialBar/index.js +18 -10
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/index.js +6 -9
  158. package/es/src/charts/Rings/applyLayout.js +41 -24
  159. package/es/src/charts/Rings/emit.js +174 -58
  160. package/es/src/charts/Rings/index.js +65 -30
  161. package/es/src/charts/Rings/ringsGraph.js +28 -9
  162. package/es/src/charts/Rings/ringsLoops.js +73 -0
  163. package/es/src/charts/Rings/ringsParallel.js +166 -0
  164. package/es/src/charts/Sankey/applyLayout.js +116 -39
  165. package/es/src/charts/Sankey/circularLayout.js +208 -0
  166. package/es/src/charts/Sankey/circularLinks.js +301 -0
  167. package/es/src/charts/Sankey/emit.js +164 -94
  168. package/es/src/charts/Sankey/index.js +75 -77
  169. package/es/src/charts/Sankey/labels.js +80 -0
  170. package/es/src/charts/Sankey/ribbons.js +88 -0
  171. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  172. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  173. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  174. package/es/src/charts/Scatter/index.js +25 -0
  175. package/es/src/charts/SlopeChart/index.js +116 -0
  176. package/es/src/charts/SlopeChart/slope.js +95 -0
  177. package/es/src/charts/Streamgraph/index.js +51 -0
  178. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  179. package/es/src/charts/Sunburst/emit.js +74 -63
  180. package/es/src/charts/Sunburst/index.js +3 -3
  181. package/es/src/charts/Tree/index.js +2 -6
  182. package/es/src/charts/Treemap/applyLayout.js +14 -1
  183. package/es/src/charts/Treemap/emit.js +8 -2
  184. package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
  185. package/es/src/charts/Treemap/groupHeaders.js +95 -0
  186. package/es/src/charts/Treemap/index.js +17 -7
  187. package/es/src/charts/Treemap/thresholdFunction.js +11 -9
  188. package/es/src/charts/Violin/inner.js +3 -5
  189. package/es/src/charts/Waffle/index.js +4 -2
  190. package/es/src/charts/Waffle/tooltip.js +6 -2
  191. package/es/src/charts/Waterfall/index.js +4 -2
  192. package/es/src/charts/definition/makeChart.js +20 -5
  193. package/es/src/charts/drawSteps/backControl.js +17 -5
  194. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  195. package/es/src/charts/drawSteps/minimap.js +6 -5
  196. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  197. package/es/src/charts/drawSteps/saveChart.js +176 -0
  198. package/es/src/charts/drawSteps/saveControl.js +148 -0
  199. package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
  200. package/es/src/charts/drawSteps/searchControls.js +2 -1
  201. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  202. package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
  203. package/es/src/charts/drawSteps/topLeftControls.js +3 -1
  204. package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
  205. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  206. package/es/src/charts/events/click.legend.js +7 -2
  207. package/es/src/charts/events/click.shape.js +38 -2
  208. package/es/src/charts/events/mouseenter.js +9 -0
  209. package/es/src/charts/events/mousemove.legend.js +3 -0
  210. package/es/src/charts/events/mousemove.shape.js +12 -4
  211. package/es/src/charts/facet/drawFacets.js +14 -5
  212. package/es/src/charts/facet/facetConfig.js +2 -2
  213. package/es/src/charts/facet/facetData.js +2 -2
  214. package/es/src/charts/features/annotationFrame.js +179 -0
  215. package/es/src/charts/features/annotationText.js +83 -0
  216. package/es/src/charts/features/annotationTypes.js +10 -0
  217. package/es/src/charts/features/attributionFeature.js +6 -11
  218. package/es/src/charts/features/axes.js +9 -7
  219. package/es/src/charts/features/axesFinal.js +26 -4
  220. package/es/src/charts/features/axesMeasure.js +61 -6
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/chartGeometry.js +1 -1
  224. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  225. package/es/src/charts/features/circleLabels.js +207 -0
  226. package/es/src/charts/features/colorScaleBucket.js +19 -1
  227. package/es/src/charts/features/colorScaleHover.js +70 -0
  228. package/es/src/charts/features/colorScaleValue.js +97 -0
  229. package/es/src/charts/features/curvedArrows.js +158 -0
  230. package/es/src/charts/features/edgeArrows.js +160 -4
  231. package/es/src/charts/features/edgeBundling.js +442 -0
  232. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  233. package/es/src/charts/features/ensureZoomDom.js +32 -8
  234. package/es/src/charts/features/features.js +45 -15
  235. package/es/src/charts/features/featuresColorScale.js +62 -8
  236. package/es/src/charts/features/featuresLegend.js +21 -32
  237. package/es/src/charts/features/legendKeys.js +64 -0
  238. package/es/src/charts/features/lineLabels.js +55 -46
  239. package/es/src/charts/features/linkBundle.js +19 -0
  240. package/es/src/charts/features/linkColor.js +72 -0
  241. package/es/src/charts/features/linkFields.js +86 -0
  242. package/es/src/charts/features/linkFocus.js +118 -0
  243. package/es/src/charts/features/linkInteraction.js +312 -0
  244. package/es/src/charts/features/linkKeys.js +20 -0
  245. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  246. package/es/src/charts/features/linkLabelPath.js +162 -0
  247. package/es/src/charts/features/linkLabels.js +340 -0
  248. package/es/src/charts/features/linkWidths.js +32 -0
  249. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  250. package/es/src/charts/features/pathLabels.js +50 -0
  251. package/es/src/charts/features/plotAnnotations.js +68 -17
  252. package/es/src/charts/features/plotPaint.js +42 -15
  253. package/es/src/charts/features/polyline.js +129 -0
  254. package/es/src/charts/features/referenceAnnotations.js +403 -0
  255. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  256. package/es/src/charts/features/ringLabelNodes.js +93 -0
  257. package/es/src/charts/features/ringLabels.js +222 -0
  258. package/es/src/charts/features/sceneBounds.js +26 -6
  259. package/es/src/charts/features/selfLoops.js +306 -0
  260. package/es/src/charts/features/shapeEmit.js +67 -30
  261. package/es/src/charts/features/shareKey.js +15 -0
  262. package/es/src/charts/features/sharedFields.js +15 -2
  263. package/es/src/charts/features/textHalo.js +29 -0
  264. package/es/src/charts/features/thresholdMembers.js +71 -0
  265. package/es/src/charts/helpers/densityChart.js +3 -1
  266. package/es/src/charts/helpers/valueTitle.js +6 -3
  267. package/es/src/charts/index.js +8 -0
  268. package/es/src/charts/partition/chartFields.js +6 -5
  269. package/es/src/charts/partition/hierarchy.js +2 -0
  270. package/es/src/charts/partition/interaction.js +9 -5
  271. package/es/src/charts/partition/zoom.js +7 -6
  272. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  273. package/es/src/charts/pipeline/preDrawData.js +77 -13
  274. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  275. package/es/src/charts/pipeline/vizDraw.js +40 -29
  276. package/es/src/charts/pipeline/vizPreDraw.js +29 -18
  277. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  278. package/es/src/charts/polar/config.js +2 -3
  279. package/es/src/charts/viz/Viz.js +82 -44
  280. package/es/src/charts/viz/VizBase.js +47 -19
  281. package/es/src/charts/viz/backgroundInk.js +13 -7
  282. package/es/src/charts/viz/dataPoller.js +52 -0
  283. package/es/src/charts/viz/focusRing.js +104 -0
  284. package/es/src/charts/viz/focusTargets.js +208 -0
  285. package/es/src/charts/viz/groupRow.js +35 -0
  286. package/es/src/charts/viz/history.js +74 -0
  287. package/es/src/charts/viz/interactionOpacity.js +19 -5
  288. package/es/src/charts/viz/keyboardNav.js +297 -0
  289. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  290. package/es/src/charts/viz/loaderFormat.js +114 -0
  291. package/es/src/charts/viz/missingFields.js +123 -0
  292. package/es/src/charts/viz/mountTarget.js +9 -0
  293. package/es/src/charts/viz/nearestHover.js +183 -0
  294. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  295. package/es/src/charts/viz/ordinalColor.js +14 -12
  296. package/es/src/charts/viz/pageTheme.js +83 -0
  297. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  298. package/es/src/charts/viz/pointVoronoi.js +124 -0
  299. package/es/src/charts/viz/reducedMotion.js +27 -0
  300. package/es/src/charts/viz/reportHandlerError.js +10 -0
  301. package/es/src/charts/viz/shapeClassTargets.js +18 -2
  302. package/es/src/charts/viz/simpleHover.js +2 -0
  303. package/es/src/charts/viz/vizClassName.js +31 -0
  304. package/es/src/charts/viz/vizDataPolling.js +172 -0
  305. package/es/src/charts/viz/vizDefaults.js +81 -23
  306. package/es/src/charts/viz/vizFields.js +53 -2
  307. package/es/src/charts/viz/vizRender.js +49 -28
  308. package/es/src/charts/viz/vizTheme.js +96 -0
  309. package/es/src/charts/viz/vizVisibility.js +14 -0
  310. package/es/src/components/Axis/Axis.js +34 -0
  311. package/es/src/components/Axis/AxisBottom.js +1 -0
  312. package/es/src/components/Axis/AxisLeft.js +1 -0
  313. package/es/src/components/Axis/AxisRight.js +1 -0
  314. package/es/src/components/Axis/AxisTop.js +1 -0
  315. package/es/src/components/Axis/axisBreak.js +4 -1
  316. package/es/src/components/Axis/axisDefaults.js +8 -10
  317. package/es/src/components/Axis/axisLabelAngle.js +175 -0
  318. package/es/src/components/Axis/axisLabelThinning.js +13 -4
  319. package/es/src/components/Axis/axisLayout.js +86 -19
  320. package/es/src/components/Axis/axisLayoutLabels.js +66 -13
  321. package/es/src/components/Axis/axisLayoutScale.js +10 -1
  322. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  323. package/es/src/components/Axis/axisRender.js +38 -9
  324. package/es/src/components/Axis/axisRounding.js +15 -4
  325. package/es/src/components/Axis/axisSlantWrap.js +39 -0
  326. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  327. package/es/src/components/Axis/powTicks.js +73 -0
  328. package/es/src/components/Axis/rangeBreaks.js +201 -0
  329. package/es/src/components/Axis/timeValues.js +19 -4
  330. package/es/src/components/ColorScale/ColorScale.js +42 -36
  331. package/es/src/components/ColorScale/bucketBounds.js +64 -0
  332. package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
  333. package/es/src/components/ColorScale/colorScaleRender.js +25 -1
  334. package/es/src/components/ColorScale/colorScaleScale.js +43 -24
  335. package/es/src/components/ColorScale/colorScaleType.js +26 -0
  336. package/es/src/components/Legend/Legend.js +3 -0
  337. package/es/src/components/Legend/legendConfig.js +2 -6
  338. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  339. package/es/src/components/TextBox.js +31 -65
  340. package/es/src/components/Timeline/Timeline.js +54 -54
  341. package/es/src/components/Timeline/brushSpan.js +78 -0
  342. package/es/src/components/Timeline/timelineConfig.js +27 -10
  343. package/es/src/components/Timeline/timelineMode.js +26 -0
  344. package/es/src/components/Timeline/timelineRender.js +51 -9
  345. package/es/src/components/Tooltip.js +28 -13
  346. package/es/src/components/fontStack.js +20 -0
  347. package/es/src/components/textBoxLayout.js +58 -21
  348. package/es/src/components/textBoxPath.js +73 -0
  349. package/es/src/components/textBoxScene.js +223 -0
  350. package/es/src/components/textBoxWords.js +70 -0
  351. package/es/src/shapes/Area.js +1 -0
  352. package/es/src/shapes/Bar.js +1 -0
  353. package/es/src/shapes/Box.js +67 -79
  354. package/es/src/shapes/Circle.js +1 -0
  355. package/es/src/shapes/Line.js +1 -0
  356. package/es/src/shapes/Path.js +1 -0
  357. package/es/src/shapes/Rect.js +1 -0
  358. package/es/src/shapes/Shape.js +1 -0
  359. package/es/src/shapes/Whisker.js +1 -0
  360. package/es/src/shapes/boxOutlierShape.js +19 -0
  361. package/es/src/shapes/boxStats.js +35 -0
  362. package/es/src/shapes/boxStyle.js +78 -0
  363. package/es/src/shapes/boxSummary.js +174 -0
  364. package/es/src/shapes/shapeStandalone.js +2 -0
  365. package/es/src/utils/BaseClass.js +44 -12
  366. package/es/src/utils/className.js +78 -0
  367. package/es/src/utils/configPrep.js +2 -1
  368. package/es/src/utils/configWarnings.js +25 -0
  369. package/es/src/utils/constant.js +13 -1
  370. package/es/src/utils/displayName.js +12 -0
  371. package/es/src/utils/fieldAccessor.js +31 -0
  372. package/es/src/utils/paintComponentScene.js +2 -0
  373. package/es/src/utils/theme.js +190 -0
  374. package/es/src/utils/themeInk.js +68 -0
  375. package/package.json +14 -10
  376. package/types/index.d.ts +8 -2
  377. package/types/internal.d.ts +253 -9
  378. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  379. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  380. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  381. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  382. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  383. package/types/src/charts/Alluvial/index.d.ts +27 -0
  384. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  385. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  386. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  387. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  388. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  389. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  390. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  391. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  392. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  393. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  394. package/types/src/charts/BoxWhisker/index.d.ts +3 -1
  395. package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
  396. package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
  397. package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
  398. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  399. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  400. package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
  401. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  402. package/types/src/charts/Chord/labels.d.ts +66 -0
  403. package/types/src/charts/Donut/index.d.ts +2 -1
  404. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  405. package/types/src/charts/Gantt/emit.d.ts +17 -0
  406. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  407. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  408. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  409. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  410. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  411. package/types/src/charts/Gantt/index.d.ts +36 -0
  412. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  413. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  414. package/types/src/charts/Geomap/emit.d.ts +2 -2
  415. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  416. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  417. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  418. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  419. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  420. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  421. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  422. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  423. package/types/src/charts/Geomap/index.d.ts +3 -0
  424. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  425. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  426. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  427. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  428. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  429. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  430. package/types/src/charts/Hexbin/index.d.ts +25 -0
  431. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  432. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  433. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  434. package/types/src/charts/Histogram/binData.d.ts +20 -1
  435. package/types/src/charts/Histogram/index.d.ts +3 -2
  436. package/types/src/charts/Histogram/labels.d.ts +7 -0
  437. package/types/src/charts/Marimekko/index.d.ts +2 -1
  438. package/types/src/charts/Network/bundle.d.ts +67 -0
  439. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  440. package/types/src/charts/Network/clusters.d.ts +115 -0
  441. package/types/src/charts/Network/graph.d.ts +65 -0
  442. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  443. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  444. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  445. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  446. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  447. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  448. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  449. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  450. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  451. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  452. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  453. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  454. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  455. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  456. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  457. package/types/src/charts/Plot/axisHover.d.ts +68 -0
  458. package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
  459. package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
  460. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  461. package/types/src/charts/Plot/barHitArea.d.ts +59 -0
  462. package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
  463. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  464. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  465. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  466. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  467. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  468. package/types/src/charts/Plot/index.d.ts +28 -8
  469. package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
  470. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  471. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  472. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  473. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  474. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  475. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  476. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  477. package/types/src/charts/Plot/plotInit.d.ts +23 -2
  478. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  479. package/types/src/charts/Plot/plotZoom.d.ts +2 -0
  480. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  481. package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
  482. package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
  483. package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
  484. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  485. package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
  486. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  487. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  488. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  489. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  490. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  491. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  492. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  493. package/types/src/charts/Rings/emit.d.ts +50 -0
  494. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  495. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  496. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  497. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  498. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  499. package/types/src/charts/Sankey/emit.d.ts +58 -0
  500. package/types/src/charts/Sankey/labels.d.ts +19 -0
  501. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  502. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  503. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  504. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  505. package/types/src/charts/Scatter/index.d.ts +15 -0
  506. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  507. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  508. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  509. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  510. package/types/src/charts/Treemap/emit.d.ts +2 -1
  511. package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
  512. package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
  513. package/types/src/charts/Treemap/index.d.ts +2 -0
  514. package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
  515. package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
  516. package/types/src/charts/definition/makeChart.d.ts +5 -3
  517. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  518. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  519. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  520. package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
  521. package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
  522. package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
  523. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
  524. package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
  525. package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
  526. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  527. package/types/src/charts/events/click.legend.d.ts +2 -1
  528. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  529. package/types/src/charts/facet/facetData.d.ts +1 -1
  530. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  531. package/types/src/charts/features/annotationText.d.ts +57 -0
  532. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  533. package/types/src/charts/features/axesMeasure.d.ts +13 -1
  534. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  535. package/types/src/charts/features/calloutScene.d.ts +40 -0
  536. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  537. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  538. package/types/src/charts/features/circleLabels.d.ts +130 -0
  539. package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
  540. package/types/src/charts/features/colorScaleHover.d.ts +32 -0
  541. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  542. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  543. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  544. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  545. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  546. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  547. package/types/src/charts/features/features.d.ts +8 -0
  548. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  549. package/types/src/charts/features/legendKeys.d.ts +34 -0
  550. package/types/src/charts/features/lineLabels.d.ts +15 -12
  551. package/types/src/charts/features/linkBundle.d.ts +16 -0
  552. package/types/src/charts/features/linkColor.d.ts +48 -0
  553. package/types/src/charts/features/linkFields.d.ts +16 -0
  554. package/types/src/charts/features/linkFocus.d.ts +51 -0
  555. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  556. package/types/src/charts/features/linkKeys.d.ts +11 -0
  557. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  558. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  559. package/types/src/charts/features/linkLabels.d.ts +77 -0
  560. package/types/src/charts/features/linkWidths.d.ts +19 -0
  561. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  562. package/types/src/charts/features/pathLabels.d.ts +41 -0
  563. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  564. package/types/src/charts/features/plotPaint.d.ts +19 -0
  565. package/types/src/charts/features/polyline.d.ts +32 -0
  566. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  567. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  568. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  569. package/types/src/charts/features/ringLabels.d.ts +164 -0
  570. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  571. package/types/src/charts/features/selfLoops.d.ts +165 -0
  572. package/types/src/charts/features/shapeEmit.d.ts +5 -1
  573. package/types/src/charts/features/shareKey.d.ts +9 -0
  574. package/types/src/charts/features/sharedFields.d.ts +11 -2
  575. package/types/src/charts/features/textHalo.d.ts +14 -0
  576. package/types/src/charts/features/thresholdMembers.d.ts +38 -0
  577. package/types/src/charts/helpers/valueTitle.d.ts +4 -2
  578. package/types/src/charts/index.d.ts +8 -0
  579. package/types/src/charts/partition/interaction.d.ts +6 -3
  580. package/types/src/charts/partition/zoom.d.ts +4 -4
  581. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  582. package/types/src/charts/pipeline/stages.d.ts +9 -0
  583. package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
  584. package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
  585. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  586. package/types/src/charts/viz/Viz.d.ts +44 -6
  587. package/types/src/charts/viz/VizBase.d.ts +16 -7
  588. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  589. package/types/src/charts/viz/dataPoller.d.ts +28 -0
  590. package/types/src/charts/viz/focusRing.d.ts +25 -0
  591. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  592. package/types/src/charts/viz/groupRow.d.ts +24 -0
  593. package/types/src/charts/viz/history.d.ts +35 -0
  594. package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
  595. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  596. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  597. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  598. package/types/src/charts/viz/missingFields.d.ts +57 -0
  599. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  600. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  601. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  602. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  603. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  604. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  605. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  606. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  607. package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
  608. package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
  609. package/types/src/charts/viz/simpleHover.d.ts +2 -1
  610. package/types/src/charts/viz/vizClassName.d.ts +23 -0
  611. package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
  612. package/types/src/charts/viz/vizDefaults.d.ts +49 -9
  613. package/types/src/charts/viz/vizFields.d.ts +47 -0
  614. package/types/src/charts/viz/vizRender.d.ts +2 -1
  615. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  616. package/types/src/charts/viz/vizTypes.d.ts +117 -8
  617. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  618. package/types/src/components/Axis/Axis.d.ts +37 -8
  619. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  620. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  621. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  622. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  623. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  624. package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
  625. package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
  626. package/types/src/components/Axis/axisLayout.d.ts +5 -0
  627. package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
  628. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  629. package/types/src/components/Axis/axisRounding.d.ts +6 -3
  630. package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
  631. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  632. package/types/src/components/Axis/powTicks.d.ts +29 -0
  633. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  634. package/types/src/components/Axis/timeValues.d.ts +1 -1
  635. package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
  636. package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
  637. package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
  638. package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
  639. package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
  640. package/types/src/components/Legend/Legend.d.ts +1 -0
  641. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  642. package/types/src/components/TextBox.d.ts +1 -0
  643. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  644. package/types/src/components/Timeline/brushSpan.d.ts +41 -0
  645. package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
  646. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  647. package/types/src/components/Timeline/timelineRender.d.ts +8 -0
  648. package/types/src/components/Tooltip.d.ts +12 -3
  649. package/types/src/components/fontStack.d.ts +10 -0
  650. package/types/src/components/textBoxLayout.d.ts +18 -9
  651. package/types/src/components/textBoxPath.d.ts +59 -0
  652. package/types/src/components/textBoxScene.d.ts +51 -0
  653. package/types/src/components/textBoxWords.d.ts +33 -0
  654. package/types/src/shapes/Area.d.ts +1 -0
  655. package/types/src/shapes/Bar.d.ts +1 -0
  656. package/types/src/shapes/Box.d.ts +2 -8
  657. package/types/src/shapes/Circle.d.ts +1 -0
  658. package/types/src/shapes/Line.d.ts +1 -0
  659. package/types/src/shapes/Path.d.ts +1 -0
  660. package/types/src/shapes/Rect.d.ts +1 -0
  661. package/types/src/shapes/Shape.d.ts +1 -0
  662. package/types/src/shapes/Whisker.d.ts +1 -0
  663. package/types/src/shapes/boxOutlierShape.d.ts +9 -0
  664. package/types/src/shapes/boxStats.d.ts +19 -0
  665. package/types/src/shapes/boxStyle.d.ts +25 -0
  666. package/types/src/shapes/boxSummary.d.ts +66 -0
  667. package/types/src/shapes/emitLabels.d.ts +1 -1
  668. package/types/src/shapes/shapeConfig.d.ts +42 -4
  669. package/types/src/utils/BaseClass.d.ts +32 -0
  670. package/types/src/utils/D3Scale.d.ts +3 -0
  671. package/types/src/utils/D3plusConfig.d.ts +1240 -33
  672. package/types/src/utils/className.d.ts +64 -0
  673. package/types/src/utils/configPrep.d.ts +2 -0
  674. package/types/src/utils/configWarnings.d.ts +21 -2
  675. package/types/src/utils/constant.d.ts +8 -0
  676. package/types/src/utils/displayName.d.ts +10 -0
  677. package/types/src/utils/fieldAccessor.d.ts +24 -0
  678. package/types/src/utils/index.d.ts +1 -1
  679. package/types/src/utils/paintComponentScene.d.ts +3 -1
  680. package/types/src/utils/theme.d.ts +170 -0
  681. package/types/src/utils/themeInk.d.ts +56 -0
  682. package/umd/d3plus-core.full.js +87388 -56271
  683. package/umd/d3plus-core.full.min.js +2 -2
  684. package/umd/d3plus-core.js +37988 -11768
  685. package/umd/d3plus-core.min.js +2 -2
  686. package/es/src/components/Axis/gridStroke.js +0 -10
  687. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -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
+ }
@@ -0,0 +1,219 @@
1
+ /**
2
+ Gantt — a project schedule: one labeled row per task, its bar running
3
+ from its start to its end over a time axis, with milestones, phases,
4
+ dependency arrows, progress, and a "today" line.
5
+
6
+ Implementation files in this folder:
7
+ - `ganttRows.ts` — pure: task fields, ordering, and group rows.
8
+ - `ganttGeometry.ts` — pure: diamonds, progress, brackets, elbows.
9
+ - `ganttLabels.ts` — the label column's font and fitted labels.
10
+ - `ganttTooltip.ts` — task times, tooltip rows, and aria labels.
11
+ - `applyLayout.ts` — chart-specific `TransformStage`.
12
+ - `ganttDecor.ts` — labels, brackets, dependencies, "today".
13
+ - `emit.ts` — the scene nodes of each task.
14
+ */ import { mean } from "d3-array";
15
+ import { Axis } from "../../components/index.js";
16
+ import accessor from "../../utils/accessor.js";
17
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
18
+ import { makeChart } from "../definition/makeChart.js";
19
+ import { seedTimeAggs, timeFields } from "../Priestley/timeAxis.js";
20
+ import { applyGanttLayout } from "./applyLayout.js";
21
+ import { ganttEmit } from "./emit.js";
22
+ import { normalizeProgress } from "./ganttRows.js";
23
+ import { ganttTooltipRows } from "./ganttTooltip.js";
24
+ /**
25
+ Coerces a per-row option: a function is kept, a string becomes a data-key
26
+ accessor, and anything else turns it off.
27
+ */ export function taskAccessor(v) {
28
+ if (typeof v === "function") return v;
29
+ if (typeof v === "string" && v) return fieldAccessor(v);
30
+ return false;
31
+ }
32
+ /**
33
+ Averages grouped rows' progress (as `aggs` call it, with the rows and an
34
+ accessor), reading percent strings as fractions.
35
+ */ export function progressAgg(rows, value) {
36
+ return mean(rows.map((d)=>normalizeProgress(value(d))).filter((v)=>v !== undefined));
37
+ }
38
+ /** The `progress` field's `onSet`: a data key averages grouped rows' progress. */ const seedProgressAgg = (viz, v)=>{
39
+ const key = typeof v === "string" ? v : null;
40
+ if (key && !viz.schema.aggs[key]) viz.schema.aggs[key] = progressAgg;
41
+ };
42
+ export const ganttDef = {
43
+ name: "Gantt",
44
+ layoutStage: applyGanttLayout,
45
+ emit: ganttEmit,
46
+ setup: (viz)=>{
47
+ seedTimeAggs(viz);
48
+ if (!viz.schema.aggs.progress) viz.schema.aggs.progress = progressAgg;
49
+ },
50
+ ctx: {
51
+ axis: new Axis().align("start").orient("top"),
52
+ axisTest: new Axis().align("start").gridSize(0).orient("top")
53
+ },
54
+ fields: [
55
+ /**
56
+ The time axis along the top of the rows (`orient: "bottom"` moves it
57
+ under them). It reads dates by default (`scale: "time"`); a
58
+ `rangeBreaks` setting such as `"weekends"` hides those times, and a
59
+ task's Duration then counts only the working days left showing.
60
+ */ {
61
+ key: "axisConfig",
62
+ merge: true,
63
+ default: {
64
+ scale: "time"
65
+ }
66
+ },
67
+ /**
68
+ Accessor function or string key for each task's predecessors: the ids
69
+ (by `groupBy`) of the tasks it waits on, as an array or a
70
+ comma-separated string. Each draws an arrow from the predecessor's end
71
+ to this task's start.
72
+ @type {string | function | false}
73
+ */ {
74
+ key: "dependencies",
75
+ default: accessor("dependencies"),
76
+ coerce: taskAccessor
77
+ },
78
+ /**
79
+ Styles the dependency arrows: `stroke` (the chart's text color by
80
+ default), `strokeWidth` (1), `strokeOpacity` (0.55), and `arrowSize`
81
+ (6, in pixels).
82
+ @type {{stroke, strokeWidth, strokeOpacity, arrowSize}}
83
+ */ {
84
+ key: "dependencyConfig",
85
+ merge: true,
86
+ default: {}
87
+ },
88
+ ...timeFields(),
89
+ /**
90
+ Accessor function or string key for each task's group (such as its
91
+ project phase). Grouped tasks sit under a header row that names the
92
+ group, with a bracket spanning its tasks.
93
+ @type {string | function | false}
94
+ */ {
95
+ key: "group",
96
+ default: false,
97
+ coerce: taskAccessor
98
+ },
99
+ /**
100
+ The most the task label column on the left may take: a share of the
101
+ chart's width when 1 or below (`0.3` by default), else pixels. The
102
+ column fits the widest label up to it, wrapping or truncating longer
103
+ ones; `0` hides it.
104
+ */ {
105
+ key: "labelWidth",
106
+ default: 0.3
107
+ },
108
+ /**
109
+ Shows a legend only when its entries group the tasks (for example, a
110
+ `color` by phase), since every task is labeled in its row.
111
+ */ {
112
+ key: "legend",
113
+ coerce: "const",
114
+ factory: (viz)=>{
115
+ const base = viz.schema.legend;
116
+ return (config, arr)=>{
117
+ const rows = viz._filteredData ?? [];
118
+ if (arr.length >= rows.length) return false;
119
+ return base.call(viz, config, arr);
120
+ };
121
+ }
122
+ },
123
+ /**
124
+ Accessor function or string key for whether a task is a milestone,
125
+ drawn as a diamond at its `end`. Without one, a task that starts and
126
+ ends at the same time is a milestone.
127
+ @type {string | function | false}
128
+ */ {
129
+ key: "milestone",
130
+ default: accessor("milestone"),
131
+ coerce: taskAccessor
132
+ },
133
+ /**
134
+ The space between neighboring task bars, as a share of each row
135
+ (see d3's
136
+ [paddingInner](https://github.com/d3/d3-scale#band_paddingInner)).
137
+ */ {
138
+ key: "paddingInner",
139
+ default: 0.35
140
+ },
141
+ /**
142
+ The space above the first row and below the last, as a share of a row
143
+ (see d3's
144
+ [paddingOuter](https://github.com/d3/d3-scale#band_paddingOuter)).
145
+ */ {
146
+ key: "paddingOuter",
147
+ default: 0.2
148
+ },
149
+ /**
150
+ Accessor function or string key for each task's progress: a fraction
151
+ from 0 to 1 (`0.6`), or a percent string (`"60%"`). The done part of
152
+ the bar fills in the task's color and the rest in a paler shade; the
153
+ tooltip lists it. A milestone below 100% draws pale and outlined. A
154
+ key also averages grouped rows' progress.
155
+ @type {string | function | false}
156
+ */ {
157
+ key: "progress",
158
+ default: accessor("progress"),
159
+ coerce: taskAccessor,
160
+ onSet: seedProgressAgg
161
+ },
162
+ /**
163
+ The order of the tasks: `"data"` (default) keeps the data's order,
164
+ `"start"` sorts them by start, and a function compares two data rows.
165
+ Groups follow their first task.
166
+ @type {"data" | "start" | function}
167
+ */ {
168
+ key: "taskSort",
169
+ default: "data"
170
+ },
171
+ /**
172
+ Styles the task label column: `fontColor` (the chart's text color by
173
+ default), `fontFamily`, and `fontSize` (12).
174
+ @type {{fontColor, fontFamily, fontSize}}
175
+ */ {
176
+ key: "taskLabelConfig",
177
+ merge: true,
178
+ default: {}
179
+ },
180
+ /**
181
+ Draws a "today" line across the rows: `true` at the current time, or a
182
+ date (or anything the axis parses) to mark that time. Off (`false`) by
183
+ default. It only draws inside the time axis.
184
+ @type {boolean | Date | string | number}
185
+ */ {
186
+ key: "today",
187
+ default: false
188
+ },
189
+ /**
190
+ Styles the "today" line like a `referenceLines` entry: `stroke`,
191
+ `strokeWidth` (1.5), `strokeOpacity` (0.85), `dash`, and its `label`
192
+ (the translated "Today"; `false` for none), with the label's font
193
+ settings and `labelPosition`.
194
+ @type {ReferenceLineConfig}
195
+ */ {
196
+ key: "todayConfig",
197
+ merge: true,
198
+ default: {}
199
+ },
200
+ /** Lists each task's Start, End, Duration, and Progress in the tooltip body. */ {
201
+ key: "tooltipConfig",
202
+ merge: true,
203
+ factory: (viz)=>({
204
+ tbody: (d, i)=>ganttTooltipRows(viz, d, i)
205
+ })
206
+ },
207
+ /** Zooming doesn't help read a schedule's rows, so it's off by default. */ {
208
+ key: "zoom",
209
+ default: false
210
+ }
211
+ ]
212
+ };
213
+ /**
214
+ Creates a Gantt chart from an array of tasks: one labeled row per task,
215
+ its bar running from `start` to `end` over a time axis. Tasks can be
216
+ grouped into phases (`group`), drawn as milestones (`milestone`), linked
217
+ by dependency arrows (`dependencies`), and filled by their `progress`,
218
+ with an optional `today` line.
219
+ */ export default makeChart(ganttDef);
@@ -10,6 +10,7 @@
10
10
  - `emit.ts` — the dial plus one indicator per row.
11
11
  */ import { formatAbbreviate } from "@d3plus/format";
12
12
  import accessor from "../../utils/accessor.js";
13
+ import { fieldAccessor } from "../../utils/fieldAccessor.js";
13
14
  import constant from "../../utils/constant.js";
14
15
  import { makeChart } from "../definition/makeChart.js";
15
16
  import { chartBackground } from "../viz/backgroundInk.js";
@@ -124,7 +125,7 @@ export const gaugeDef = {
124
125
  */ {
125
126
  key: "value",
126
127
  default: accessor("value"),
127
- coerce: (v)=>typeof v === "function" ? v : typeof v === "string" ? accessor(v) : constant(v)
128
+ coerce: (v)=>typeof v === "function" ? v : typeof v === "string" ? fieldAccessor(v) : constant(v)
128
129
  },
129
130
  /**
130
131
  Formats the value shown under the hub and in each tooltip, as