@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,51 @@
1
+ import type { D3Scale } from "../../utils/index.js";
2
+ import { type RangeBreakRule, type TimeGap } from "./rangeBreaks.js";
3
+ /** Options for `brokenTimeScale`. */
4
+ export interface BrokenTimeScaleOptions {
5
+ /** Read the rules' calendar in UTC instead of local time. */
6
+ utc?: boolean;
7
+ /** Pixels each marked gap inside the domain occupies (default 0). */
8
+ space?: number;
9
+ }
10
+ /** A hidden stretch inside the scale's domain, with the pixels it occupies. */
11
+ export interface ScaleTimeGap extends TimeGap {
12
+ /** Pixels the gap occupies: `space` for a marked gap, else 0. */
13
+ space: number;
14
+ }
15
+ /** A continuous time scale whose mapping skips hidden time. */
16
+ export interface BrokenTimeScale extends D3Scale {
17
+ /** The rules the scale hides time by. */
18
+ rangeBreaks: RangeBreakRule[];
19
+ /** The hidden stretches inside the domain, clipped to it, ascending. */
20
+ gaps(): ScaleTimeGap[];
21
+ /** Whether a time is hidden. */
22
+ isHidden(t: number | Date): boolean;
23
+ /** The visible time (ms) between two times, signed like `b - a`. */
24
+ visible(a: number | Date, b: number | Date): number;
25
+ /** The time `ms` of visible time after (or, when negative, before) `t`. */
26
+ offset(t: number | Date, ms: number): Date;
27
+ /** A d3 time tick format for the scale's domain. */
28
+ tickFormat(count?: number, specifier?: string): (d: Date) => string;
29
+ }
30
+ /** Whether `scale` is a broken time scale. */
31
+ export declare const isBrokenTimeScale: (scale: unknown) => scale is BrokenTimeScale;
32
+ /**
33
+ The time between `a` and `b` on `scale` (`b - a`, in ms): on a broken
34
+ time scale, only the time it shows.
35
+ */
36
+ export declare const scaleTimeStep: (scale: unknown, a: number | Date, b: number | Date) => number;
37
+ /**
38
+ The time `ms` after `t` (before it, when negative) on `scale`: on a
39
+ broken time scale, stepping over the time it hides.
40
+ */
41
+ export declare const scaleTimeShift: (scale: unknown, t: number | Date, ms: number) => Date;
42
+ /**
43
+ Builds a time scale that hides the time `rules` describe. It reads like
44
+ d3's `scaleTime` — `domain`, `range`, `ticks`, `tickFormat`, `invert`,
45
+ and `copy` — but visible time shares one pixel rate and hidden time
46
+ takes none (or a marked gap's `space`). A hidden time maps to where its
47
+ gap sits; a pixel at a closed gap inverts to the time after it. Times
48
+ past the domain extrapolate through the rules' gaps, so a scale can be
49
+ padded or zoomed out.
50
+ */
51
+ export declare function brokenTimeScale(rules: RangeBreakRule[], options?: BrokenTimeScaleOptions): BrokenTimeScale;
@@ -0,0 +1,29 @@
1
+ /**
2
+ Tick values for a power scale whose exponent isn't 1. Value-spaced ticks
3
+ bunch up where the exponent compresses the axis and leave long gaps
4
+ where it stretches it, so these are spaced evenly along the axis instead,
5
+ each rounded to a round number at the precision its neighbors allow.
6
+ */
7
+ /**
8
+ The exponent a `"pow"` axis uses: `exponent` when it is a positive
9
+ number, else 1.
10
+ */
11
+ export declare const powExponent: (exponent: unknown) => number;
12
+ /**
13
+ `value` rounded to the roundest number within `tolerance` of it: the
14
+ nearest multiple of the largest step (1, 2 or 5 times a power of ten)
15
+ that lands that close.
16
+ */
17
+ export declare function roundWithin(value: number, tolerance: number): number;
18
+ /**
19
+ Tick values for a power scale: `count` equal steps along the axis (in the
20
+ scale's transformed space), each rounded to a round number. With
21
+ `minor`, the midpoints between those steps are added, so the major
22
+ ticks are always a subset of the minor ones. Returns ascending values
23
+ inside the domain, or the domain's own order when it runs high to low.
24
+ @param domain The scale's domain.
25
+ @param exponent The scale's exponent.
26
+ @param count How many steps to divide the axis into.
27
+ @param minor Whether to add a tick between each pair of steps.
28
+ */
29
+ export declare function powTicks(domain: number[], exponent: number, count: number, minor?: boolean): number[];
@@ -0,0 +1,82 @@
1
+ /** A time value a rule reads: a Date, a timestamp, or a date string. */
2
+ export type RangeBreakTime = Date | number | string;
3
+ /**
4
+ One stretch of time a time axis hides:
5
+
6
+ - `"weekends"`: every Saturday and Sunday.
7
+ - `{days: [6, 0]}`: every day of the week listed (0 is Sunday, 6 is Saturday).
8
+ - `{hours: [17, 9]}`: the same hours of every day, from the first hour to
9
+ the second (fractions are minutes, so `9.5` is 9:30); a start after the
10
+ end wraps past midnight, so `[17, 9]` hides 5pm to 9am.
11
+ - `{values: [date, …]}`: each listed date's whole day, such as holidays.
12
+ - `{bounds: [start, end]}`: one explicit range, from `start` up to `end`.
13
+
14
+ An object rule's `marker` draws the axis's break marker where its time
15
+ was removed, leaving a short gap there. It defaults to `true` for
16
+ `bounds` and `false` for the others, which recur too often to mark.
17
+ */
18
+ export type RangeBreakRule = "weekends" | {
19
+ days: number[];
20
+ marker?: boolean;
21
+ } | {
22
+ hours: [number, number];
23
+ marker?: boolean;
24
+ } | {
25
+ values: RangeBreakTime[];
26
+ marker?: boolean;
27
+ } | {
28
+ bounds: [RangeBreakTime, RangeBreakTime];
29
+ marker?: boolean;
30
+ };
31
+ /** A hidden stretch of time, from `start` (hidden) up to `end` (shown), in ms. */
32
+ export interface TimeGap {
33
+ start: number;
34
+ end: number;
35
+ /** Whether the gap draws a break marker. */
36
+ marker: boolean;
37
+ }
38
+ /** A rule value read as a timestamp, or `NaN` when it doesn't parse. */
39
+ export declare function rangeBreakTime(value: unknown): number;
40
+ /** Whether `rule` is a rule a time axis can read. */
41
+ export declare function isRangeBreakRule(rule: unknown): rule is RangeBreakRule;
42
+ /**
43
+ Reads a `rangeBreaks` setting — one rule, a list of them, or a falsy
44
+ value — into the list of rules a time axis can use, dropping any it
45
+ can't read.
46
+ */
47
+ export declare function normalizeRangeBreaks(input: unknown): RangeBreakRule[];
48
+ /** Whether a rule draws a break marker (see `RangeBreakRule`). */
49
+ export declare const ruleMarker: (rule: RangeBreakRule) => boolean;
50
+ /**
51
+ The stretches of time `rules` hide that overlap `[lo, hi]`: sorted,
52
+ with overlapping and touching gaps merged (a merged gap draws a marker
53
+ when any of its rules does). Gaps are not clipped to `[lo, hi]`.
54
+ @param utc Read the calendar in UTC instead of local time.
55
+ */
56
+ export declare function rangeBreakGaps(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): TimeGap[];
57
+ /** The last gap starting at or before `t` (gaps sorted by start), or -1. */
58
+ export declare function gapIndex(gaps: TimeGap[], t: number): number;
59
+ /**
60
+ A test for whether a time between `lo` and `hi` is hidden by `rules`:
61
+ the gaps are found once, so the test is cheap to run over many values.
62
+ A time outside `[lo, hi]` is tested on its own.
63
+ */
64
+ export declare function rangeBreakTest(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): (t: number | Date) => boolean;
65
+ /** Whether `rules` hide the time `t`. */
66
+ export declare function isHiddenTime(rules: RangeBreakRule[], t: number | Date, utc?: boolean): boolean;
67
+ /**
68
+ The visible time between `a` and `b` (in ms, `a <= b`): their distance
69
+ less every hidden stretch between them.
70
+ */
71
+ export declare function visibleBetween(rules: RangeBreakRule[], a: number, b: number, utc?: boolean): number;
72
+ /**
73
+ Whether `rules` hide all of time: a week (plus a day for DST) with no
74
+ visible moment, which repeating rules then repeat forever.
75
+ */
76
+ export declare function hidesAllTime(rules: RangeBreakRule[], utc?: boolean): boolean;
77
+ /**
78
+ The time `ms` of visible time after `t` (or before it, when `ms` is
79
+ negative), stepping over every hidden stretch on the way. Rules that
80
+ hide all of time leave `t` where it is.
81
+ */
82
+ export declare function offsetVisible(rules: RangeBreakRule[], t: number, ms: number, utc?: boolean): number;
@@ -33,7 +33,7 @@ export declare function axisTimeDomain(axis: Axis): Date[];
33
33
  */
34
34
  export declare function axisTimeLocale(axis: Axis): TimeLocaleDefinition;
35
35
  /**
36
- The ordered Dates a time axis picks its label interval from: its parsed `data`, else its domain.
36
+ The ordered Dates a time axis picks its label interval from: its parsed `data`, else the labels its scale offers (when two or more), else its domain.
37
37
  @private
38
38
  */
39
39
  export declare function axisTimeReference(axis: Axis): Date[];
@@ -7,10 +7,13 @@ import { Rect } from "../../shapes/index.js";
7
7
  import { BaseClass } from "../../utils/index.js";
8
8
  import type { D3Scale } from "../../utils/index.js";
9
9
  import Legend from "../Legend/Legend.js";
10
+ import type { ColorScaleType } from "./colorScaleType.js";
11
+ import type { ColorScaleBarGeometry } from "./colorScaleHoverMark.js";
10
12
  /**
11
13
  Creates an SVG color scale based on an array of data.
12
14
  */
13
15
  export default class ColorScale extends BaseClass {
16
+ static readonly _displayName: string;
14
17
  [key: string]: any;
15
18
  _select: D3Selection;
16
19
  _axisClass: Axis;
@@ -24,6 +27,12 @@ export default class ColorScale extends BaseClass {
24
27
  _legendClass: Legend;
25
28
  _outerBounds: Record<string, number>;
26
29
  _rectClass: Rect;
30
+ /** The scale the last render built, with a `scale` function resolved. */
31
+ _scaleType: ColorScaleType;
32
+ /** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */
33
+ _barGeometry?: ColorScaleBarGeometry;
34
+ /** The value marked on the scale, set with `hover()`. */
35
+ _hoverValue?: number | false;
27
36
  /** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */
28
37
  _gradientFill?: string;
29
38
  _sceneRenderer?: SvgRenderer;
@@ -61,6 +70,11 @@ export default class ColorScale extends BaseClass {
61
70
  */
62
71
  data(): DataPoint[];
63
72
  data(_: DataPoint[]): this;
73
+ /**
74
+ Marks a value on the scale: an extra axis tick where the value falls on the color bar and a badge reading it where that tick's label would sit, plus an outline around its bucket on a bucketed bar (`bucketAxis`). A scale drawn as discrete swatches draws no mark. A chart sets this while one of its shapes is hovered. Pass `false` to clear it. Turned off with `hoverMark(false)`.
75
+ */
76
+ hover(): number | false | undefined;
77
+ hover(_: number | false): this;
64
78
  /**
65
79
  A pass-through for the TextBox class used to style the labelMin and labelMax text.
66
80
  */
@@ -0,0 +1,28 @@
1
+ /**
2
+ The number of decimal places `value` is written with, read at 15
3
+ significant digits so float noise (`0.1 + 0.2`) doesn't count.
4
+ */
5
+ export declare function decimalPlaces(value: number): number;
6
+ /** The number of significant digits `value` is written with, at 15 digits. */
7
+ export declare function significantDigits(value: number): number;
8
+ /**
9
+ The decimal places bucket labels step at: the most any value is written
10
+ with. A computed value (a mean such as `1 / 3`) carries float precision
11
+ no label should step at, so its own places count only to the data's
12
+ display precision: three significant digits of the values' span. A value
13
+ within float noise of zero (`-1.4e-14`) counts as zero.
14
+ */
15
+ export declare function labelPlaces(allValues: number[]): number;
16
+ /** `value` rounded to the places bucket labels step at (see `labelPlaces`). */
17
+ export declare function labelValue(value: number, allValues: number[]): number;
18
+ /**
19
+ The `[lower, upper]` values a ColorScale label shows for the bucket
20
+ `[ticks[i], ticks[i + 1])`: the first and last values the data's own
21
+ precision (see `labelPlaces`) can write inside it, so integer data reads
22
+ "1 - 2", "3 - 4", and computed values such as means don't step at float
23
+ precision (a bucket ending at 0 reads "-9.5 - -0.1", not "-9.5 - -1f").
24
+ When `format` prints the upper bound the same as the next bucket's lower
25
+ one (an abbreviation like "1.5k"), the upper bound drops a decimal place
26
+ at a time until it reads differently ("1.49k").
27
+ */
28
+ export declare function bucketBounds(tick: number, i: number, ticks: number[], allValues: number[], format: (v: number) => string): [number, number];
@@ -0,0 +1,86 @@
1
+ import type { Bounds } from "@d3plus/math";
2
+ import type { GroupNode } from "@d3plus/render";
3
+ import type ColorScale from "./ColorScale.js";
4
+ /** A style value: a constant, or a function of the hovered value. */
5
+ type Style<T> = T | ((value: number) => T);
6
+ /** The `hoverMarkConfig` options. */
7
+ export interface ColorScaleHoverMarkConfig {
8
+ /** The tick at the value: `stroke` and `strokeWidth` default to the axis ticks' own, and `length` to the axis's `tickSize`. */
9
+ tickConfig?: {
10
+ length?: Style<number>;
11
+ stroke?: Style<string>;
12
+ strokeWidth?: Style<number>;
13
+ };
14
+ /** The value's badge: `fill` defaults to the value's color, `stroke` to the text color that reads on the background, and `fontColor` to a color contrasting the fill. */
15
+ badgeConfig?: {
16
+ fill?: Style<string>;
17
+ fontColor?: Style<string>;
18
+ fontFamily?: Style<string>;
19
+ fontSize?: Style<number>;
20
+ fontWeight?: Style<number | string>;
21
+ padding?: Style<number>;
22
+ rx?: Style<number>;
23
+ stroke?: Style<string>;
24
+ strokeWidth?: Style<number>;
25
+ };
26
+ /** The outline around the value's bucket on a bucketed bar (`bucketAxis`): `stroke` defaults to the text color that reads on the background. */
27
+ outlineConfig?: {
28
+ stroke?: Style<string>;
29
+ strokeWidth?: Style<number>;
30
+ };
31
+ }
32
+ /** `hoverMarkConfig`'s defaults. */
33
+ export declare function hoverMarkDefaults(): ColorScaleHoverMarkConfig;
34
+ /** The side of the bar the axis labels sit on. */
35
+ export type ColorScaleOrient = "bottom" | "left" | "right" | "top";
36
+ /**
37
+ Where the color bar sits in the ColorScale, recorded when a bar renders:
38
+ its axis maps a value to a pixel along the bar, and the bar spans `cross`
39
+ across it. `ticks` holds a bucketed bar's bucket starts.
40
+ */
41
+ export interface ColorScaleBarGeometry {
42
+ orient: ColorScaleOrient;
43
+ position: (value: number) => number;
44
+ /** The bar's start and end along its length. */
45
+ range: [number, number];
46
+ /** The bar's edges across its length. */
47
+ cross: [number, number];
48
+ /** The values at the bar's two ends, low first. */
49
+ domain: [number, number];
50
+ ticks?: number[];
51
+ }
52
+ /** `value` held within `[min, max]` (in either order). */
53
+ export declare function clampTo(value: number, [a, b]: [number, number]): number;
54
+ /**
55
+ The hovered value's pixel along the bar: a value outside the bar's domain
56
+ clamps to its nearer end. Null for a value that isn't a finite number.
57
+ */
58
+ export declare function barPosition(geometry: ColorScaleBarGeometry, value: number): number | null;
59
+ /**
60
+ The tick at `at` along a bar whose labels face `orient`: from the bar's
61
+ edge on the labels' side, `length` out toward them.
62
+ @returns The tick's two ends, on the bar first.
63
+ */
64
+ export declare function tickPoints(orient: ColorScaleOrient, at: number, cross: [number, number], length: number): [number, number][];
65
+ /**
66
+ The value badge's box: centered on `at` along the bar (held within
67
+ `[0, limit]`), its near edge `offset` past the bar's edge on the labels'
68
+ side, where the tick ends.
69
+ */
70
+ export declare function badgeBox(orient: ColorScaleOrient, at: number, cross: [number, number], size: {
71
+ width: number;
72
+ height: number;
73
+ }, limit: number, offset: number): Bounds;
74
+ /**
75
+ The span `[start, end]` of the bucket holding `value` on a bucketed bar
76
+ whose buckets start at `ticks`, the last running to `domainEnd`; null
77
+ when the value is below the first bucket.
78
+ */
79
+ export declare function bucketSpan(ticks: number[], value: number, domainEnd: number): [number, number] | null;
80
+ /**
81
+ Adds the hover mark for the ColorScale's hovered value to its scene
82
+ `group` (changed in place): nothing when no finite value is hovered,
83
+ `hoverMark` is off, or the scale draws discrete swatches.
84
+ */
85
+ export declare function addHoverMark(cs: ColorScale, group: GroupNode): void;
86
+ export {};
@@ -1,6 +1,9 @@
1
1
  import type ColorScale from "./ColorScale.js";
2
+ import type { ColorScaleType } from "./colorScaleType.js";
2
3
  /** Computed values shared between the scale solve and the render branches. */
3
4
  export interface ColorScaleCompute {
5
+ /** The scale this render builds, with a `scale` function resolved. */
6
+ scale: ColorScaleType;
4
7
  allValues: number[];
5
8
  domain: number[];
6
9
  ticks: number[] | undefined;
@@ -0,0 +1,17 @@
1
+ /** The kinds of scale a ColorScale can build. */
2
+ export type ColorScaleType = "buckets" | "jenks" | "linear" | "log" | "quantile";
3
+ /**
4
+ A ColorScale `scale` setting: a scale name, or a function that picks one
5
+ from the values the scale is built from (sorted ascending) and their
6
+ `[min, max]` extent, called with the ColorScale as `this`.
7
+ */
8
+ export type ColorScaleTypeSetting = ColorScaleType | ((this: unknown, values: number[], extent: [number, number] | [undefined, undefined]) => ColorScaleType);
9
+ export declare const colorScaleTypes: readonly ColorScaleType[];
10
+ /** Whether a scale draws as discrete swatches (one per bucket) rather than a bar. */
11
+ export declare const isBucketScale: (scale: ColorScaleType) => boolean;
12
+ /**
13
+ Resolves a `scale` setting to a scale name for one render. A function is
14
+ called with the sorted `values` and their extent, with `context` as
15
+ `this`. An unknown name warns and falls back to `"linear"`.
16
+ */
17
+ export declare function resolveColorScaleType(setting: unknown, values: number[], context?: unknown): ColorScaleType;
@@ -8,6 +8,7 @@ import { BaseClass } from "../../utils/index.js";
8
8
  Creates an SVG legend based on an array of data.
9
9
  */
10
10
  export default class Legend extends BaseClass {
11
+ static readonly _displayName: string;
11
12
  [key: string]: any;
12
13
  _titleClass: TextBox;
13
14
  _data: DataPoint[];
@@ -41,6 +41,7 @@ new SizeLegend()
41
41
  .render();
42
42
  */
43
43
  export default class SizeLegend extends BaseClass {
44
+ static readonly _displayName: string;
44
45
  [key: string]: any;
45
46
  _layout: SizeLegendLayout;
46
47
  /** Drops values whose circles would outgrow this radius; set by a zoomed chart. */
@@ -7,6 +7,7 @@ import type { TextBoxDatum } from "./textBoxLayout.js";
7
7
  Creates a wrapped text box for each point in an array of data.
8
8
  */
9
9
  export default class TextBox extends BaseClass {
10
+ static readonly _displayName: string;
10
11
  [key: string]: any;
11
12
  _select: D3Selection;
12
13
  _data: DataPoint[];
@@ -6,6 +6,7 @@ import { Axis, TextBox } from "../index.js";
6
6
  Creates an interactive timeline brush component for selecting time periods within a visualization.
7
7
  */
8
8
  export default class Timeline extends Axis {
9
+ static readonly _displayName: string;
9
10
  _buttonBehaviorCurrent: string;
10
11
  _hiddenHandles: boolean;
11
12
  _playButtonClass: TextBox;
@@ -0,0 +1,41 @@
1
+ /** The fewest and most ticks a Timeline's brush selection may span. */
2
+ export interface BrushSpan {
3
+ min: number;
4
+ max: number;
5
+ }
6
+ /**
7
+ The fewest and most ticks a brush selection may span, from `brushMin` and
8
+ `brushMax` (each a number, or a function returning one). An unset or
9
+ non-finite `brushMax` is unlimited and a fractional one rounds down; one
10
+ below `brushMin` rises to it, so `brushMin` wins when they conflict.
11
+ */
12
+ export declare function brushSpan(brushMin: unknown, brushMax: unknown): BrushSpan;
13
+ /**
14
+ A selection's end tick indices (`lo` to `hi`, out of `count` ticks), moved
15
+ so it spans `span.min` to `span.max` ticks. Too short, it keeps its `fixed`
16
+ end and moves the other out, then the fixed end too where the ticks run
17
+ out. Too long, it keeps the `anchor` end (the one being dragged) and pulls
18
+ the other in.
19
+ */
20
+ export declare function spanIndices(lo: number, hi: number, count: number, span: BrushSpan, anchor?: "lo" | "hi", fixed?: "lo" | "hi"): [number, number];
21
+ /**
22
+ The end a selection keeps while it grows to `brushMin`: the end being
23
+ dragged (`anchor`), or its first when it is a single period (a click).
24
+ */
25
+ export declare const growFrom: (lo: number, hi: number, anchor: "lo" | "hi") => "lo" | "hi";
26
+ /**
27
+ A Timeline's brush span (see `brushSpan`); a single-period Timeline
28
+ (`brushing: false`) has no `brushMin` to meet.
29
+ */
30
+ export declare function timelineBrushSpan(schema: Record<string, unknown>): BrushSpan;
31
+ /**
32
+ A brushed selection fitted to `span`. `edges` are the period indices
33
+ (earliest first) under the brush's left and right edges, which a
34
+ reversed timeline holds latest first; `anchor` is the edge being dragged.
35
+ Pulled in, the dragged end stays put. Pushed out, the first period does,
36
+ or with `keepDragged` the dragged end (a click's period). Returns the
37
+ fitted indices, earliest first.
38
+ */
39
+ export declare function fitBrush(edges: [number, number], count: number, span: BrushSpan, anchor: "lo" | "hi", keepDragged?: boolean): [number, number];
40
+ /** The index of the value in `values` nearest `value`. */
41
+ export declare function nearestIndex(values: number[], value: number): number;
@@ -1,4 +1,15 @@
1
1
  import type Timeline from "./Timeline.js";
2
+ /**
3
+ A copy of `values` (dates, years or pixel positions) in ascending order.
4
+ A `reverse` timeline lays its ticks out from latest to earliest, but its
5
+ selections, defaults and playback run from earliest to latest.
6
+ */
7
+ export declare function byValue<T>(values: T[]): T[];
8
+ /**
9
+ The brush overlay's cursor: `brushCursor`, or what it returns when given
10
+ the presentation drawn (`"ticks"` or `"buttons"`).
11
+ */
12
+ export declare function brushOverlayCursor(tl: Timeline): string | null;
2
13
  /**
3
14
  Sets the Timeline-specific defaults that override the inherited Axis config,
4
15
  mirroring the original constructor body exactly.
@@ -0,0 +1,17 @@
1
+ /** How a Timeline draws its periods: tick marks along an axis, or a row of buttons. */
2
+ export type TimelineMode = "ticks" | "buttons";
3
+ /**
4
+ The class naming how a Timeline is drawn, `<prefix>-ticks` or
5
+ `<prefix>-buttons`, or none before it resolves a mode.
6
+ @param prefix The element's own class, such as `d3plus-viz-timeline`.
7
+ @param mode The Timeline's resolved `buttonBehavior`.
8
+ */
9
+ export declare function timelineModeClass(prefix: string, mode: string): string | null;
10
+ /**
11
+ Adds `timelineModeClass(prefix, mode)` to `el` and removes the other
12
+ mode's class, so the element names the presentation drawn last.
13
+ @param el The element to mark.
14
+ @param prefix The element's own class.
15
+ @param mode The Timeline's resolved `buttonBehavior`.
16
+ */
17
+ export declare function classTimelineMode(el: Element | null | undefined, prefix: string, mode: string): void;
@@ -18,6 +18,14 @@ export declare function prepareTicks(tl: Timeline): {
18
18
  export declare function measureTicksWidth(tl: Timeline, ticks: unknown[], tickFormat: (d: Date) => string): void;
19
19
  /** Resolves button-vs-tick behavior and sets the scale/domain/range. */
20
20
  export declare function configureScale(tl: Timeline, ticks: unknown[], playButtonWidth: number): boolean;
21
+ /**
22
+ Holds a starting `selection` to `brushMin` to `brushMax` periods, in
23
+ place, keeping its later end (or, at the first period, its earlier one),
24
+ and stores what remains as the Timeline's selection. `periods` are where
25
+ each period sits in `selection`'s terms (tick dates, or button positions)
26
+ and `dates` the periods themselves, both earliest first.
27
+ */
28
+ export declare function clampSelection(tl: Timeline, selection: unknown[], periods: unknown[], dates?: unknown[]): void;
21
29
  /** Builds the d3-brush, computes the active selection, and mounts the brush group. */
22
30
  export declare function setupBrush(tl: Timeline, hiddenHandles: boolean, height: string, y: string): void;
23
31
  /** Renders the play button TextBox into its own group. */
@@ -5,6 +5,7 @@ import { BaseClass } from "../utils/index.js";
5
5
  Creates HTML tooltips in the body of a webpage.
6
6
  */
7
7
  export default class Tooltip extends BaseClass {
8
+ static readonly _displayName: string;
8
9
  [key: string]: any;
9
10
  _data: DataPoint[];
10
11
  /** v4: optional per-chart parent element (default: global #d3plus-portal). */
@@ -33,6 +34,14 @@ export default class Tooltip extends BaseClass {
33
34
  @private
34
35
  */
35
36
  render(callback?: (...args: unknown[]) => unknown): this;
37
+ /**
38
+ CSS classes added to each tooltip element, next to its fixed
39
+ `d3plus-tooltip` class, so page CSS can style these tooltips (a chart
40
+ passes its `tooltipConfig.className`). Takes a space-separated string or
41
+ an array; a new value replaces the classes the previous one added.
42
+ */
43
+ className(): string | string[] | undefined;
44
+ className(_: string | string[] | undefined): this;
36
45
  /**
37
46
  CSS styles applied to the arrow element.
38
47
  */
@@ -65,15 +74,15 @@ export default class Tooltip extends BaseClass {
65
74
  footerStyle(): Record<string, string>;
66
75
  footerStyle(_: Record<string, string>): this;
67
76
  /**
68
- The position of each tooltip. Can be an HTMLElement to anchor to, a selection string, or coordinate points in reference to the client viewport (not the overall page).
77
+ The position of each tooltip. Can be an HTMLElement to anchor to, a virtual element (any object with a `getBoundingClientRect()` returning a box in client coordinates), a selection string, or coordinate points in reference to the client viewport (not the overall page). An element or box anchors the tooltip's arrow to the middle of its top edge (or its bottom edge when the tooltip flips below).
69
78
 
70
79
  @example <caption>default accessor</caption>
71
80
  function value(d) {
72
81
  return [d.x, d.y];
73
82
  }
74
83
  */
75
- position(): (d: DataPoint, i?: number) => number[] | HTMLElement;
76
- position(_: ((d: DataPoint, i?: number) => number[] | HTMLElement) | number[] | HTMLElement | string): this;
84
+ position(): (d: DataPoint, i?: number) => number[] | HTMLElement | VirtualElement;
85
+ position(_: ((d: DataPoint, i?: number) => number[] | HTMLElement | VirtualElement) | number[] | HTMLElement | VirtualElement | string): this;
77
86
  /**
78
87
  CSS styles applied to the table element.
79
88
  */
@@ -0,0 +1,10 @@
1
+ /**
2
+ The CSS `font-family` a label is drawn with: the family its layout measured
3
+ (the first one in the configured list that is installed), then the families
4
+ listed after it. A renderer without the measured family then falls back
5
+ down the same list rather than to its default font, as when a chart drawn
6
+ on a server is opened in a browser that has different fonts.
7
+ @param configured The label's configured families, as an Array or a CSS list.
8
+ @param measured The family the layout measured with, from `fontExists`, or `false` when none was found.
9
+ */
10
+ export declare function fontStack(configured: string | string[], measured: string | false): string;
@@ -1,13 +1,7 @@
1
1
  import type { DataPoint } from "@d3plus/data";
2
2
  import type TextBox from "./TextBox.js";
3
- /** A parsed inline run (segment of a wrapped line with optional bold/italic). */
4
- interface LineRun {
5
- text: string;
6
- style?: {
7
- weight?: number | string;
8
- style?: "normal" | "italic";
9
- };
10
- }
3
+ import type { BoxPath, Sides } from "./textBoxPath.js";
4
+ import type { JustifyWord, LineRun } from "./textBoxWords.js";
11
5
  /** Internal shape produced by the data reduce in render(). */
12
6
  export interface TextBoxDatum {
13
7
  aH: string;
@@ -16,9 +10,17 @@ export interface TextBoxDatum {
16
10
  lines: string[];
17
11
  /** Per-line parsed runs when `_html` is configured; null when plain text. */
18
12
  lineRuns: LineRun[][] | null;
13
+ /** Whether each line ended at a newline in the text. */
14
+ hardBreaks: boolean[];
15
+ /**
16
+ For justified text, each line's words with their widths (null for a
17
+ line that can't be split into words); null for other alignments.
18
+ */
19
+ lineWords: (JustifyWord[] | null)[] | null;
19
20
  fC: string;
20
21
  fStroke: string;
21
22
  fSW: number;
23
+ /** The CSS font-family to draw with: the measured family, then its fallbacks. */
22
24
  fF: string;
23
25
  fO: number;
24
26
  fW: number | string;
@@ -36,10 +38,17 @@ export interface TextBoxDatum {
36
38
  r: number;
37
39
  x: number;
38
40
  y: number;
41
+ /** The path the text follows (its `d` relative to x/y), or null. */
42
+ path: Pick<BoxPath, "d" | "side" | "offset"> | null;
43
+ /** The box's padding. */
44
+ pad: Sides;
45
+ /** How far the text block sits below the top of the box's padded area. */
46
+ yP: number;
47
+ /** The extra room around the box its hitbox covers, or null without one. */
48
+ hit: Sides | null;
39
49
  }
40
50
  /**
41
51
  Computes the laid-out text box for a single data point, or null when the
42
52
  text is undefined or wraps to no visible lines.
43
53
  */
44
54
  export declare function computeTextBoxDatum(box: TextBox, d: DataPoint, i: number): TextBoxDatum | null;
45
- export {};
@@ -0,0 +1,59 @@
1
+ /**
2
+ TextBox options that change where its text sits: a path the text follows
3
+ (`textPath`, `startOffset`, `side`), and the transparent `hitbox` behind it.
4
+ */
5
+ import type { DataPoint } from "@d3plus/data";
6
+ import type TextBox from "./TextBox.js";
7
+ /** Sides of a box, in pixels. */
8
+ export interface Sides {
9
+ top: number;
10
+ right: number;
11
+ bottom: number;
12
+ left: number;
13
+ }
14
+ /** The path a box's text follows, resolved for one datum. */
15
+ export interface BoxPath {
16
+ /** The path's `d`, relative to the box's x/y. */
17
+ d: string;
18
+ side: "left" | "right";
19
+ /** Where along the path the text's room begins, in pixels. */
20
+ offset: number;
21
+ /** The path's length. */
22
+ length: number;
23
+ }
24
+ /**
25
+ Reads a `startOffset`: a distance in pixels, or a percentage of the path's
26
+ length, clamped to the path.
27
+ @param value The configured offset.
28
+ @param length The path's length.
29
+ */
30
+ export declare function resolveOffset(value: unknown, length: number): number;
31
+ /**
32
+ The path a datum's text follows, or null when `textPath` gives none.
33
+ @param box The TextBox.
34
+ @param d The datum.
35
+ @param i Its index.
36
+ */
37
+ export declare function textBoxPath(box: TextBox, d: DataPoint, i: number): BoxPath | null;
38
+ /**
39
+ The room a datum's text wraps into: the box less its padding, or along a
40
+ path, the path from its start offset to its end (one line, which the
41
+ height always fits).
42
+ @param box The TextBox.
43
+ @param d The datum.
44
+ @param i Its index.
45
+ @param padding The box's padding.
46
+ @param path The path the text follows, if any.
47
+ @param lineHeight The line height the wrap starts at.
48
+ */
49
+ export declare function textBoxRoom(box: TextBox, d: DataPoint, i: number, padding: Sides, path: BoxPath | null, lineHeight: number): {
50
+ w: number;
51
+ h: number;
52
+ };
53
+ /**
54
+ The extra room a `hitbox` config adds around the box, or null when the
55
+ box has no hitbox: `true` adds none, and `{padding}` takes a number or CSS
56
+ shorthand string.
57
+ @param value The configured hitbox.
58
+ */
59
+ export declare function hitboxPadding(value: unknown): Sides | null;