@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,28 @@
1
+ /**
2
+ ArcDiagram — a network's nodes in a row along one line, each link drawn
3
+ as an arc between its two nodes. It takes Network's data (`nodes`,
4
+ `links`, and the same accessors), so a network drops in as is.
5
+
6
+ Implementation files in this folder:
7
+ - `applyLayout.ts` — orders, spaces, and sizes the nodes, and shapes
8
+ each link's arc.
9
+ - `arcGeometry.ts` / `arcLabels.ts` — the pure geometry and label fit.
10
+ - `emit.ts` — arcs, nodes, and labels as scene nodes.
11
+ - `events.ts` — hover, click focus, and legend focus.
12
+ */
13
+ import type { DataPoint } from "@d3plus/data";
14
+ import type { ChartDefinition } from "../definition/ChartDefinition.js";
15
+ import type { VizInstance } from "../viz/vizTypes.js";
16
+ /**
17
+ The table view's rows: every node's row with its number of connections,
18
+ then every link with its source ("From") and target ("To") labels and its own fields.
19
+ */
20
+ export declare function arcTableData(viz: VizInstance): DataPoint[] | null;
21
+ export declare const arcDiagramDef: ChartDefinition;
22
+ /**
23
+ Places a network's nodes in a row along one line and draws each link as
24
+ an arc between its two nodes, which shows the network's structure
25
+ without a force layout's tangle, in an order you choose.
26
+ */
27
+ declare const _default: new () => any;
28
+ export default _default;
@@ -1,6 +1,8 @@
1
1
  /**
2
2
  BoxWhisker — Plot with `discrete: "x"`, `shape: "Box"`, plus a
3
- tooltip-title accessor that walks through `__d3plus__` wrappers.
3
+ tooltip-title accessor that walks through `__d3plus__` wrappers. Boxes
4
+ summarize each category's rows, or come from each row's own statistics
5
+ (see `summary.ts`).
4
6
  */
5
7
  import type { ChartDefinition } from "../definition/ChartDefinition.js";
6
8
  export declare const boxWhiskerDef: ChartDefinition;
@@ -0,0 +1,25 @@
1
+ /**
2
+ BoxWhisker's hidden outliers: a Box whose `outlier` setting is `false`
3
+ draws no point past its whiskers, so the value axis leaves those values
4
+ out and reaches only as far as the whisker ends.
5
+ */
6
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ type Row = Record<string, unknown>;
9
+ type RowFn = (d: DataPoint, i: number) => unknown;
10
+ /** The axis a box's statistics run along: the one that isn't discrete. */
11
+ export declare const boxValueAxis: (viz: VizInstance) => "x" | "y";
12
+ /**
13
+ The `outlier` setting of BoxWhisker's boxes (`shapeConfig.Box.outlier`),
14
+ as an accessor of a plotted row; null when every outlier draws a point.
15
+ */
16
+ export declare function chartOutlierShape(viz: VizInstance): RowFn | null;
17
+ /** Whether each plotted row's box draws its outliers. */
18
+ export declare function drawsRowOutliers(viz: VizInstance): (row: Row) => boolean;
19
+ /**
20
+ The rows that place `axis` (see `_plotAxisRows`): on the value axis of
21
+ boxes computed from observations, each box's rows without the outliers
22
+ its `outlier` setting hides, plus its whisker ends; otherwise `rows`.
23
+ */
24
+ export declare function boxAxisRows(viz: VizInstance, rows: Row[], axis: string): Row[];
25
+ export {};
@@ -0,0 +1,39 @@
1
+ /**
2
+ BoxWhisker's precomputed boxes: with `boxMin`, `boxQ1`, `boxMedian`,
3
+ `boxQ3`, and `boxMax` set, each row is one box drawn from its own
4
+ statistics. These hooks place those statistics on the value axis, pad
5
+ the axis around them, and hand them to the Box shape in pixels.
6
+ */
7
+ import type { D3Scale } from "../../utils/index.js";
8
+ import type { ShapeEmitter } from "../features/shapeEmit.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ type Row = Record<string, unknown>;
11
+ /** Whether the chart draws its boxes from precomputed statistics. */
12
+ export declare const precomputedBoxes: (viz: VizInstance) => boolean;
13
+ /**
14
+ The values precomputed boxes add to `axis` (see `_plotAxisValues`): each
15
+ row's statistics and drawn outliers, on the value axis only.
16
+ */
17
+ export declare function boxAxisValues(viz: VizInstance, rows: Row[], axis: string): number[];
18
+ /** The arguments Plot hands a shape's axis buffer. */
19
+ interface BufferArgs {
20
+ data: Row[];
21
+ x: D3Scale;
22
+ y: D3Scale;
23
+ x2?: unknown;
24
+ [key: string]: unknown;
25
+ }
26
+ /**
27
+ BoxWhisker's axis buffer: Box's own, which pads the value axis past each
28
+ row's value. A precomputed box spans its statistics, so each row is
29
+ buffered at every one of them; a computed box, at the rows that place
30
+ the axis (see `boxAxisRows`).
31
+ */
32
+ export declare function boxWhiskerBuffer(this: VizInstance, args: BufferArgs): [unknown, unknown];
33
+ /**
34
+ Draws Box rows: precomputed boxes take their statistics in pixels on the
35
+ value axis; otherwise Plot's own Box path, noting each box it draws for
36
+ the tooltip.
37
+ */
38
+ export declare const boxWhiskerEmit: ShapeEmitter;
39
+ export {};
@@ -0,0 +1,36 @@
1
+ /**
2
+ BoxWhisker's tooltip rows: a box lists its whisker ends, quartiles, and
3
+ median, largest first. A precomputed box reads them from its summary row;
4
+ a box computed from observations recomputes them in data units from the
5
+ observations it drew.
6
+ */
7
+ import type { DataPoint } from "@d3plus/data";
8
+ import type { SceneNode } from "@d3plus/render";
9
+ import type { WhiskerMode } from "../../shapes/boxStats.js";
10
+ import type { VizInstance } from "../viz/vizTypes.js";
11
+ /** A datum's source row and its index, through Plot's and Box's wrappers. */
12
+ export declare function sourceRow(d: DataPoint, i: number): [DataPoint, number];
13
+ /**
14
+ Notes the box record behind each Box part in `nodes`, keyed by the source
15
+ row a tooltip on that box receives, and returns `nodes`.
16
+ */
17
+ export declare function noteDrawnBoxes(nodes: SceneNode[]): SceneNode[];
18
+ /** The `whiskerMode` BoxWhisker's boxes draw with. */
19
+ export declare function chartWhiskerMode(viz: VizInstance): WhiskerMode;
20
+ /** One table row per statistic, largest first. */
21
+ type Rows = [string, string][];
22
+ /**
23
+ A drawn box's statistics in data units, from the observations it
24
+ summarizes; null when `row` isn't a drawn box.
25
+ */
26
+ export declare function drawnBoxStats(viz: VizInstance, row: DataPoint): import("../../shapes/boxStats.js").BoxStats | null;
27
+ /**
28
+ The tooltip rows of a box. A precomputed box lists its given statistics.
29
+ A computed box lists its whisker ends as Maximum and Minimum when its
30
+ `whiskerMode` reaches the extreme values (`"extent"`), and as Upper and
31
+ Lower Whisker otherwise, since a Tukey or quantile whisker can stop short
32
+ of (or past) the data's extremes. Anything else, such as an outlier,
33
+ lists nothing.
34
+ */
35
+ export declare function boxTooltipRows(viz: VizInstance, d: DataPoint, i: number): Rows;
36
+ export {};
@@ -0,0 +1,20 @@
1
+ /**
2
+ BubbleChart's Circle emitter: Plot's own, with the bubbles repainted
3
+ largest first, so smaller bubbles paint (and hit-test) over the larger
4
+ ones they overlap.
5
+ */
6
+ import type { SceneNode } from "@d3plus/render";
7
+ import { type ShapeEmitter } from "../features/shapeEmit.js";
8
+ /**
9
+ The nodes with each circle, and the nodes keyed to it (its hit area),
10
+ reordered largest radius first. Circles of equal radius keep their
11
+ order, and every other node (labels, …) keeps its place.
12
+ @param nodes A Circle shape's scene nodes, in data order.
13
+ */
14
+ export declare function largestFirst(nodes: SceneNode[]): SceneNode[];
15
+ /**
16
+ Plot's Circle emitter, drawing the bubbles largest first. The rows are
17
+ emitted in data order, so each series takes the color it would in a
18
+ Scatter; only the painted nodes are reordered.
19
+ */
20
+ export declare const bubbleEmit: ShapeEmitter;
@@ -0,0 +1,16 @@
1
+ /**
2
+ BubbleChart — a Scatter whose points are sized by `size`, by area.
3
+ */
4
+ import type { ChartDefinition } from "../definition/ChartDefinition.js";
5
+ export declare const bubbleChartDef: ChartDefinition;
6
+ /**
7
+ Creates a bubble chart from an array of data: each row draws as a circle
8
+ at its `x` and `y` values, sized by its `size` value. Bubbles are sized by
9
+ area (`sizeZero` with a `"sqrt"` `sizeScale`): a value twice as large
10
+ draws a bubble with twice the area, and the largest draws at `sizeMax`
11
+ pixels in radius. A size legend keys the sizes, larger bubbles are drawn
12
+ first so smaller ones stay on top, and each bubble is outlined in the
13
+ chart's background color so overlapping bubbles stay distinct.
14
+ */
15
+ declare const _default: new () => any;
16
+ export default _default;
@@ -31,6 +31,12 @@ export type ValueField = (typeof VALUE_FIELDS)[number];
31
31
  @param value The setter's argument.
32
32
  */
33
33
  export declare function keyedAccessor(value: unknown): unknown;
34
+ /**
35
+ A value field's default accessor: reads `key` and remembers it as
36
+ `keyedAccessor` does, without naming a field of the user's.
37
+ @param key The data key to read.
38
+ */
39
+ export declare function defaultKeyedAccessor(key: string): RowAccessor;
34
40
  /**
35
41
  Remembers that `fn` reads the data key `key`.
36
42
  @param fn The accessor.
@@ -10,6 +10,7 @@
10
10
  */
11
11
  import type { Chord, ChordGroup, Chords } from "d3-chord";
12
12
  import type { DataPoint } from "@d3plus/data";
13
+ import type { RingLabelFit } from "../features/ringLabels.js";
13
14
  import type { TransformStage } from "../pipeline/stages.js";
14
15
  /** A single laid-out Chord node (group), accreted across the layout passes. */
15
16
  export interface ChordNode {
@@ -32,6 +33,8 @@ export interface ChordNode {
32
33
  width: number;
33
34
  height: number;
34
35
  };
36
+ /** The curve the label follows, when it curves (see `labelPosition`). */
37
+ labelCurve?: RingLabelFit;
35
38
  }
36
39
  /** Everything `chordEmit` needs, stashed on `viz.ctx.chordCtx`. */
37
40
  export interface ChordCtx {
@@ -0,0 +1,66 @@
1
+ /**
2
+ Chord group labels (see `labelPosition`): each group's name curves just
3
+ outside its arc, following the ring, or turns along its spoke, reading
4
+ outward. Curved names need only a line of room around the ring, so when
5
+ every name fits along its arc the ring grows into the band the spoke
6
+ labels would need.
7
+ */
8
+ import type { ChordGroup } from "d3-chord";
9
+ import type { DataPoint } from "@d3plus/data";
10
+ import type { RingLabelFit } from "../features/ringLabels.js";
11
+ import type { VizInstance } from "../viz/vizTypes.js";
12
+ /** The gap between the ring and its labels, in pixels. */
13
+ export declare const CHORD_LABEL_PADDING = 4;
14
+ /** The label font size, curved or along a spoke, when the Path labelConfig sets none. */
15
+ export declare const CHORD_LABEL_FONT_SIZE = 11;
16
+ /** What placing a group's label needs: its id, row, index, and arc. */
17
+ export interface ChordLabelNode {
18
+ data: DataPoint;
19
+ i: number;
20
+ group?: ChordGroup;
21
+ labelX?: number;
22
+ labelY?: number;
23
+ labelRotate?: number;
24
+ labelAnchor?: "start" | "end";
25
+ labelBounds?: {
26
+ x: number;
27
+ y: number;
28
+ width: number;
29
+ height: number;
30
+ };
31
+ /** The curve the label follows, when it curves. */
32
+ labelCurve?: RingLabelFit;
33
+ }
34
+ /**
35
+ The labels' font size: the Path labelConfig's `fontSize`, else
36
+ `CHORD_LABEL_FONT_SIZE`.
37
+ @param viz The chart.
38
+ */
39
+ export declare function chordLabelFontSize(viz: VizInstance): number;
40
+ /**
41
+ Each group's label along its arc at `outer` (the ring's outer radius),
42
+ or null where it doesn't fit there or its `labelPosition` keeps it on
43
+ its spoke. A label cut short with an ellipsis is allowed only when its
44
+ `labelPosition` is `"along"`.
45
+ @param viz The chart.
46
+ @param nodes The laid-out groups.
47
+ @param outer The ring's outer radius.
48
+ */
49
+ export declare function chordCurves(viz: VizInstance, nodes: ChordLabelNode[], outer: number): (RingLabelFit | null)[];
50
+ /**
51
+ Whether every group with an arc takes a curved label: each one fits
52
+ along its arc (or is cut short, for `"along"`) or has no text.
53
+ @param viz The chart.
54
+ @param nodes The laid-out groups.
55
+ @param curves Each group's curve (see `chordCurves`).
56
+ */
57
+ export declare function chordAllCurved(viz: VizInstance, nodes: ChordLabelNode[], curves: (RingLabelFit | null)[]): boolean;
58
+ /**
59
+ Each group's label along its spoke: just outside the outer arc, rotated
60
+ to read outward, flipped upright on the left half. Mutates each node.
61
+ @param nodes The laid-out groups.
62
+ @param outer The ring's outer radius.
63
+ @param labelWidth The room outside the ring for a label.
64
+ @param fontSize The labels' font size: each label's box is 1.5 lines of it tall.
65
+ */
66
+ export declare function applyChordLabelGeometry(nodes: ChordLabelNode[], outer: number, labelWidth: number, fontSize?: number): void;
@@ -2,7 +2,8 @@
2
2
  Donut — Pie with a centered inner radius.
3
3
 
4
4
  Extends Pie; inherits its layout stage + emit. Only the inner-radius
5
- closure and the default arc gap (`padPixel`) differ.
5
+ closure (half the ring's hole-less radius) and the default arc gap
6
+ (`padPixel`) differ.
6
7
  */
7
8
  import type { ChartDefinition } from "../definition/ChartDefinition.js";
8
9
  export declare const donutDef: ChartDefinition;
@@ -0,0 +1,64 @@
1
+ /**
2
+ `applyGanttLayout` — Gantt's chart-specific layout stage. Reads one task
3
+ per row of `viz._filteredData`, orders and groups them into rows, sizes
4
+ the label column, measures and renders the time axis beside it, and
5
+ places every row. Stores the layout on `viz.ctx.gantt` and returns one
6
+ `GanttMark` per task.
7
+ */
8
+ import type { DataPoint } from "@d3plus/data";
9
+ import type { TransformStage } from "../pipeline/stages.js";
10
+ import type { TimeValue } from "../Priestley/timeAxis.js";
11
+ import type { VizInstance } from "../viz/vizTypes.js";
12
+ import type { FittedLabel, GanttLabelFont } from "./ganttLabels.js";
13
+ import type { GanttRow, GanttTask } from "./ganttRows.js";
14
+ /** A task, placed: its row, its row's center, and its left and right edges. */
15
+ export interface GanttMark extends GanttTask {
16
+ row: number;
17
+ cy: number;
18
+ x0: number;
19
+ x1: number;
20
+ }
21
+ /** The Gantt's layout, shared by its emit, stored on `viz.ctx.gantt`. */
22
+ export interface GanttLayout {
23
+ rows: GanttRow[];
24
+ /** Each row's fitted label, by row. */
25
+ labels: FittedLabel[];
26
+ font: GanttLabelFont;
27
+ /** The label column's width; the time axis starts at its right edge. */
28
+ column: number;
29
+ /** Maps a start or end to its x position. */
30
+ x: (v: TimeValue) => number;
31
+ /** Each row's center, by row. */
32
+ cy: number[];
33
+ /** The distance between neighboring row centers. */
34
+ step: number;
35
+ /** A task bar's thickness. */
36
+ band: number;
37
+ /** The rows' area, the plot the "today" line spans. */
38
+ plot: {
39
+ x0: number;
40
+ x1: number;
41
+ y0: number;
42
+ y1: number;
43
+ };
44
+ time: boolean;
45
+ /** Formats a start or end for the tooltip and aria labels. */
46
+ format: (v: TimeValue) => string;
47
+ }
48
+ /** The most a row may take, in pixels, so a short list doesn't draw giant bars. */
49
+ export declare const MAX_ROW_STEP = 40;
50
+ /** The space on each side of the labels in the label column. */
51
+ export declare const LABEL_PADDING = 8;
52
+ /** How far a grouped task's label is indented under its group's. */
53
+ export declare const LABEL_INDENT = 12;
54
+ /**
55
+ Reads one task per data row (see `taskTimes`); rows without a start or
56
+ an end are skipped.
57
+ */
58
+ export declare function ganttTasks(viz: VizInstance, data: DataPoint[]): GanttTask[];
59
+ /**
60
+ The time domain the tasks span, widened by a day (or by 1 on a numeric
61
+ axis) on each side when every task falls on one time.
62
+ */
63
+ export declare function ganttDomain(tasks: GanttTask[], time: boolean): number[];
64
+ export declare const applyGanttLayout: TransformStage;
@@ -0,0 +1,17 @@
1
+ /**
2
+ `ganttEmit` — the Gantt's scene: the group brackets and dependency
3
+ arrows behind the tasks, each task's bar (split by its progress) or
4
+ milestone diamond, the label column, and the "today" line.
5
+ */
6
+ import type { ChartEmit } from "../definition/ChartDefinition.js";
7
+ /** How far the remaining part of a bar mixes toward the background. */
8
+ export declare const REMAINING_MIX = 0.6;
9
+ /**
10
+ The paler shade a bar's remaining (not yet done) part takes: its color
11
+ mixed toward the chart's background, so it reads lighter on a light page
12
+ and dimmer on a dark one.
13
+ */
14
+ export declare function remainingShade(fill: string, background: string): string;
15
+ /** A milestone diamond's half-height for a bar thickness. */
16
+ export declare const milestoneRadius: (band: number) => number;
17
+ export declare const ganttEmit: ChartEmit;
@@ -0,0 +1,41 @@
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
+ */
6
+ import type { PathNode, SceneNode, TextNode } from "@d3plus/render";
7
+ import type { VizInstance } from "../viz/vizTypes.js";
8
+ import type { GanttLayout, GanttMark } from "./applyLayout.js";
9
+ import type { Point } from "./ganttGeometry.js";
10
+ /** The `dependencyConfig` settings, resolved. */
11
+ export interface DependencyStyle {
12
+ stroke: string;
13
+ strokeWidth: number;
14
+ strokeOpacity: number;
15
+ arrowSize: number;
16
+ }
17
+ /** Reads `dependencyConfig`, with the chart's ink as the default color. */
18
+ export declare function dependencyStyle(viz: VizInstance): DependencyStyle;
19
+ /** The label column's text: one node per row with a fitted label. */
20
+ export declare function labelNodes(layout: GanttLayout, marks: GanttMark[]): TextNode[];
21
+ /** Each group header's summary bracket, from its first start to its last end. */
22
+ export declare function groupNodes(viz: VizInstance, layout: GanttLayout): PathNode[];
23
+ /** Where a dependency leaves a task: its bar's right edge or its diamond's right tip. */
24
+ export declare function taskEnd(mark: GanttMark, r: number): Point;
25
+ /** Where a dependency enters a task: its bar's left edge or its diamond's left tip. */
26
+ export declare function taskStart(mark: GanttMark, r: number): Point;
27
+ /**
28
+ One elbow line and arrowhead per dependency whose predecessor is drawn,
29
+ from the predecessor's end to the dependent's start. Each carries both
30
+ tasks as interaction points, so hovering either keeps it lit while the
31
+ rest dim.
32
+ */
33
+ export declare function dependencyNodes(viz: VizInstance, layout: GanttLayout, marks: GanttMark[], r: number): SceneNode[];
34
+ /** The time `today` marks: now for `true`, the value given otherwise, or null when off. */
35
+ export declare function todayValue(today: unknown, now?: () => Date): unknown;
36
+ /**
37
+ The "today" line across the rows at `today`, styled by `todayConfig` and
38
+ labeled with the translated "Today" unless `todayConfig.label` says
39
+ otherwise. Nothing when `today` is off or falls outside the time axis.
40
+ */
41
+ export declare function todayNodes(viz: VizInstance, layout: GanttLayout): SceneNode[];
@@ -0,0 +1,57 @@
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
+ */
6
+ /** A point, `[x, y]`. */
7
+ export type Point = [number, number];
8
+ /** A horizontal span, `x` to `x + width`. */
9
+ export interface Span {
10
+ x: number;
11
+ width: number;
12
+ }
13
+ /**
14
+ The SVG path of a diamond centered on `(cx, cy)`, `r` from its center to
15
+ each tip.
16
+ */
17
+ export declare function diamondPath(cx: number, cy: number, r: number): string;
18
+ /**
19
+ Splits a bar into its done part (from its start) and the rest, by the
20
+ share of it `progress` covers (clamped to 0–1).
21
+ @param x The bar's left edge.
22
+ @param width The bar's width.
23
+ @param progress The share done.
24
+ */
25
+ export declare function progressSplit(x: number, width: number, progress: number): {
26
+ done: Span;
27
+ rest: Span;
28
+ };
29
+ /**
30
+ The SVG path of a group's summary bracket: a bar from `x0` to `x1`
31
+ centered on `cy`, `h` tall, with a pointed foot hanging below each end.
32
+ */
33
+ export declare function bracketPath(x0: number, x1: number, cy: number, h: number): string;
34
+ /**
35
+ The route of a dependency arrow from a predecessor's end (`from`) to a
36
+ dependent's start (`to`): right `stub` pixels, then down (or up) to the
37
+ dependent's row, then right into its start. When the dependent starts
38
+ too close to (or before) the predecessor's end for that, the route turns
39
+ down (or up) to the edge of the predecessor's row (`step / 2` away),
40
+ runs back left to `stub` before the dependent's start, and drops to its
41
+ row from there. Points on one row join straight.
42
+ @param from The predecessor's end.
43
+ @param to The dependent's start.
44
+ @param stub The length of the first and last legs.
45
+ @param step The distance between neighboring row centers.
46
+ */
47
+ export declare function elbowRoute(from: Point, to: Point, stub: number, step: number): Point[];
48
+ /**
49
+ The label column's width: the widest label plus padding on both sides,
50
+ at most `limit` (a share of the chart's `width` when below 1, else
51
+ pixels). Zero when there are no labels or no room.
52
+ @param widest The widest label's width (with its indent).
53
+ @param width The chart's width.
54
+ @param limit The `labelWidth` setting.
55
+ @param padding The space on each side of the labels.
56
+ */
57
+ export declare function labelColumnWidth(widest: number, width: number, limit: number, padding: number): number;
@@ -0,0 +1,41 @@
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
+ */
6
+ import type { VizInstance } from "../viz/vizTypes.js";
7
+ /** The label column's font. */
8
+ export interface GanttLabelFont {
9
+ family: string;
10
+ size: number;
11
+ color: string;
12
+ lineHeight: number;
13
+ }
14
+ /** A label fitted to the column. */
15
+ export interface FittedLabel {
16
+ lines: string[];
17
+ widths: number[];
18
+ }
19
+ /** The label font size, in pixels, unless `taskLabelConfig` sets one. */
20
+ export declare const LABEL_FONT_SIZE = 12;
21
+ /** Reads `taskLabelConfig`, with the chart's font and ink as defaults. */
22
+ export declare function ganttLabelFont(viz: VizInstance): GanttLabelFont;
23
+ /** The width of `text` in the label font. */
24
+ export declare function labelWidth(text: string, font: GanttLabelFont, weight?: number | string): number;
25
+ /**
26
+ Ends `text` in an ellipsis, dropping characters until it fits `width`.
27
+ @param text The line.
28
+ @param width The room it has.
29
+ @param measure Measures a line.
30
+ */
31
+ export declare function ellipsize(text: string, width: number, measure: (t: string) => number): string;
32
+ /**
33
+ Wraps a label to `width`, over at most `maxLines` lines, ending the last
34
+ in an ellipsis when the label doesn't fit.
35
+ @param text The label.
36
+ @param width The room each line has.
37
+ @param maxLines The most lines it may take.
38
+ @param font The label font.
39
+ @param weight The font weight.
40
+ */
41
+ export declare function fitLabel(text: string, width: number, maxLines: number, font: GanttLabelFont, weight?: number | string): FittedLabel;
@@ -0,0 +1,84 @@
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
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { TimeValue } from "../Priestley/timeAxis.js";
8
+ /** One task, read from a data row. */
9
+ export interface GanttTask {
10
+ __d3plus__: true;
11
+ data: DataPoint;
12
+ i: number;
13
+ /** The task's id (its `groupBy` id), which `dependencies` refer to. */
14
+ id: string;
15
+ label: string;
16
+ start: TimeValue;
17
+ end: TimeValue;
18
+ milestone: boolean;
19
+ /** The share of the task done, 0 to 1, or undefined when it has none. */
20
+ progress: number | undefined;
21
+ /** The ids of the tasks this one waits on. */
22
+ dependencies: string[];
23
+ /** The task's group, or undefined when it has none. */
24
+ group: string | undefined;
25
+ }
26
+ /** A group's header row: its label and the span of its tasks. */
27
+ export interface GanttGroupRow {
28
+ kind: "group";
29
+ key: string;
30
+ label: string;
31
+ start: TimeValue;
32
+ end: TimeValue;
33
+ tasks: GanttTask[];
34
+ }
35
+ /** A task's row, indented under its group header when it has one. */
36
+ export interface GanttTaskRow {
37
+ kind: "task";
38
+ key: string;
39
+ task: GanttTask;
40
+ indent: boolean;
41
+ }
42
+ /** A Gantt row, top to bottom. */
43
+ export type GanttRow = GanttGroupRow | GanttTaskRow;
44
+ /** How tasks are ordered: as given, by start, or by a comparator of their data rows. */
45
+ export type TaskSort = "data" | "start" | ((a: DataPoint, b: DataPoint) => number);
46
+ /**
47
+ Whether a task draws as a milestone: when its `milestone` value is
48
+ truthy, or, without one, when it starts and ends at the same time.
49
+ @param start The task's start.
50
+ @param end The task's end.
51
+ @param flag The task's `milestone` value.
52
+ */
53
+ export declare function isMilestone(start: TimeValue, end: TimeValue, flag?: unknown): boolean;
54
+ /**
55
+ A `progress` value as a share from 0 to 1: a number is read as a
56
+ fraction (`0.6`), a string ending in `%` as a percent (`"60%"`), clamped
57
+ to 0–1. Anything else is undefined.
58
+ @param value The raw value.
59
+ */
60
+ export declare function normalizeProgress(value: unknown): number | undefined;
61
+ /**
62
+ A `dependencies` value as a list of task ids: an array, or a string of
63
+ comma-separated ids. Anything else is no dependencies.
64
+ @param value The raw value.
65
+ */
66
+ export declare function dependencyIds(value: unknown): string[];
67
+ /**
68
+ Orders tasks by `taskSort`: `"data"` keeps their order, `"start"` sorts
69
+ by start (then end), and a function compares their data rows. Ties keep
70
+ data order.
71
+ @param tasks The tasks.
72
+ @param sort The `taskSort` setting.
73
+ */
74
+ export declare function sortTasks(tasks: GanttTask[], sort: TaskSort): GanttTask[];
75
+ /**
76
+ The chart's rows, top to bottom. Tasks are ordered by `sort`; when any
77
+ task has a group, each group gets a header row (spanning its tasks'
78
+ earliest start to latest end) followed by its tasks, the groups in the
79
+ order their first task appears. Tasks without a group stay in place
80
+ among the groups, without a header.
81
+ @param tasks The tasks.
82
+ @param sort The `taskSort` setting.
83
+ */
84
+ export declare function ganttRows(tasks: GanttTask[], sort: TaskSort): GanttRow[];
@@ -0,0 +1,57 @@
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
+ */
6
+ import type { DataPoint } from "@d3plus/data";
7
+ import type { RangeBreakRule } from "../../components/Axis/rangeBreaks.js";
8
+ import type { TimeValue } from "../Priestley/timeAxis.js";
9
+ import type { VizInstance } from "../viz/vizTypes.js";
10
+ /**
11
+ Formats starts and ends: dates in the chart's locale, at the precision
12
+ the given dates step by (see `formatDateFull`), or numbers abbreviated.
13
+ @param viz The chart.
14
+ @param values The dates the chart draws, which set the precision.
15
+ */
16
+ export declare function timeFormatter(viz: VizInstance, values: TimeValue[]): (v: TimeValue) => string;
17
+ /**
18
+ The time axis's `rangeBreaks` rules (from `axisConfig`) when they hide
19
+ whole days (weekends, weekdays, dates, or explicit ranges), else none: a
20
+ rule hiding hours of every day leaves no whole days to count.
21
+ @param viz The chart.
22
+ */
23
+ export declare function ganttDayBreaks(viz: VizInstance): RangeBreakRule[];
24
+ /**
25
+ A task's duration: whole (or tenths of) days on a time axis, translated
26
+ ("12 days"), else the difference of its end and start. When the axis's
27
+ `rangeBreaks` hide whole days (see `ganttDayBreaks`), only the days left
28
+ showing count ("8 working days").
29
+ */
30
+ export declare function ganttDuration(viz: VizInstance, start: TimeValue, end: TimeValue): string;
31
+ /** A day count in a locale, with at most one decimal. */
32
+ export declare function dayCount(days: number, locale: unknown): string;
33
+ /** A share from 0 to 1 as a whole percent. */
34
+ export declare const percent: (share: number) => string;
35
+ /** A task's times, milestone flag, and progress. */
36
+ export interface TaskTimes {
37
+ start: TimeValue;
38
+ end: TimeValue;
39
+ milestone: boolean;
40
+ progress: number | undefined;
41
+ }
42
+ /**
43
+ Reads a row's start, end, milestone flag, and progress. A missing start
44
+ or end takes the other's value, and reversed times are swapped; null
45
+ when both are missing.
46
+ */
47
+ export declare function taskTimes(viz: VizInstance, d: DataPoint, i: number): TaskTimes | null;
48
+ /**
49
+ The tooltip rows for a task: Start, End, Duration, and Progress, or a
50
+ milestone's date and Progress, each label translated.
51
+ */
52
+ export declare function ganttTooltipRows(viz: VizInstance, d: DataPoint, i: number): [string, string][];
53
+ /**
54
+ A task's aria label: its name and span (or a milestone's date), and its
55
+ progress, such as `"Design, Jan 8, 2024 - Jan 19, 2024, Progress 60%."`.
56
+ */
57
+ export declare function ganttAriaLabel(viz: VizInstance, d: DataPoint, i: number): string;