@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
@@ -1,10 +1,12 @@
1
1
  import { select } from "d3-selection";
2
2
  import { rtl as detectRTL } from "@d3plus/dom";
3
- import { fontFamily, strip, textSplit } from "@d3plus/text";
3
+ import { fontFamily, textSplit } from "@d3plus/text";
4
4
  import { SvgRenderer } from "@d3plus/render";
5
5
  import { accessor, BaseClass, constant } from "../utils/index.js";
6
+ import { applyClassName } from "../utils/className.js";
6
7
  import { installFluent } from "../fluent.js";
7
8
  import { computeTextBoxDatum } from "./textBoxLayout.js";
9
+ import { textBoxNodes } from "./textBoxScene.js";
8
10
  const defaultHtmlLookup = {
9
11
  i: "font-style: italic;",
10
12
  em: "font-style: italic;",
@@ -87,6 +89,11 @@ const defaultHtmlLookup = {
87
89
  coerce: "const",
88
90
  default: accessor("height", 200)
89
91
  },
92
+ {
93
+ key: "hitbox",
94
+ coerce: "const",
95
+ default: constant(false)
96
+ },
90
97
  {
91
98
  key: "id",
92
99
  coerce: "const",
@@ -145,11 +152,21 @@ const defaultHtmlLookup = {
145
152
  coerce: "const",
146
153
  default: (d)=>d.__d3plusWrapShape__ ?? "square"
147
154
  },
155
+ {
156
+ key: "side",
157
+ coerce: "const",
158
+ default: constant("left")
159
+ },
148
160
  {
149
161
  key: "split",
150
162
  coerce: "identity",
151
163
  default: textSplit
152
164
  },
165
+ {
166
+ key: "startOffset",
167
+ coerce: "const",
168
+ default: constant(0)
169
+ },
153
170
  {
154
171
  key: "text",
155
172
  coerce: "const",
@@ -160,6 +177,16 @@ const defaultHtmlLookup = {
160
177
  coerce: "const",
161
178
  default: constant("start")
162
179
  },
180
+ {
181
+ key: "textPath",
182
+ coerce: "const",
183
+ default: constant(false)
184
+ },
185
+ {
186
+ key: "truncateWord",
187
+ coerce: "const",
188
+ default: constant(false)
189
+ },
163
190
  {
164
191
  key: "verticalAlign",
165
192
  coerce: "const",
@@ -184,6 +211,7 @@ const defaultHtmlLookup = {
184
211
  /**
185
212
  Creates a wrapped text box for each point in an array of data.
186
213
  */ export default class TextBox extends BaseClass {
214
+ static _displayName = "TextBox";
187
215
  _select;
188
216
  _data;
189
217
  /**
@@ -212,70 +240,7 @@ const defaultHtmlLookup = {
212
240
  layout (_textData) and per-line positioning render() applies to the DOM.
213
241
  */ toScene() {
214
242
  const rtl = detectRTL();
215
- const children = this._textData().map((d)=>{
216
- const anchor = d.tA === "middle" ? "middle" : d.tA === "end" ? "end" : "start";
217
- const lineX = d.tA === "middle" ? d.w / 2 : rtl ? d.tA === "start" ? d.w : 0 : d.tA === "end" ? d.w : 2 * Math.sin(Math.PI * d.r / 180);
218
- const lines = d.lines.map((text, i)=>{
219
- const y = d.r === 0 || d.vA === "top" ? (i + 1) * d.lH - (d.lH - d.fS) : d.vA === "middle" ? (d.h + d.fS) / 2 - (d.lH - d.fS) + (i - d.lines.length / 2 + 0.5) * d.lH : d.h - 2 * (d.lH - d.fS) - (d.lines.length - (i + 1)) * d.lH + 2 * Math.cos(Math.PI * d.r / 180);
220
- const width = d.widths ? d.widths[i] ?? 0 : 0;
221
- const runs = d.lineRuns ? d.lineRuns[i] : undefined;
222
- return runs ? {
223
- text,
224
- x: lineX,
225
- y,
226
- width,
227
- runs
228
- } : {
229
- text,
230
- x: lineX,
231
- y,
232
- width
233
- };
234
- });
235
- const rotateAnchor = this.schema.rotateAnchor(d, d.i);
236
- const ariaHidden = d.aH === "true" || d.aH === true;
237
- const interactive = d.pE !== "none";
238
- return {
239
- type: "text",
240
- key: d.id,
241
- id: `d3plus-textBox-${strip(d.id)}`,
242
- datum: d.data,
243
- index: d.i,
244
- x: 0,
245
- y: 0,
246
- width: d.w,
247
- height: d.h,
248
- lines,
249
- font: {
250
- family: d.fF,
251
- size: d.fS,
252
- weight: d.fW,
253
- anchor,
254
- baseline: "alphabetic",
255
- dir: rtl ? "rtl" : "ltr"
256
- },
257
- paint: {
258
- fill: d.fC,
259
- opacity: d.fO,
260
- ...d.fStroke && d.fStroke !== "transparent" ? {
261
- stroke: d.fStroke
262
- } : {},
263
- ...d.fSW ? {
264
- strokeWidth: d.fSW
265
- } : {}
266
- },
267
- transform: {
268
- x: d.x,
269
- y: d.y,
270
- rotate: d.r,
271
- rotateAnchor
272
- },
273
- aria: ariaHidden ? {
274
- hidden: true
275
- } : undefined,
276
- interactive
277
- };
278
- });
243
+ const children = this._textData().flatMap((d)=>textBoxNodes(d, this.schema.rotateAnchor(d, d.i), rtl));
279
244
  return {
280
245
  type: "group",
281
246
  key: "textBox-group",
@@ -324,6 +289,7 @@ const defaultHtmlLookup = {
324
289
  });
325
290
  renderer.drawScene(scene);
326
291
  this._sceneRenderer = renderer;
292
+ applyClassName(this);
327
293
  }
328
294
  }
329
295
  if (callback) setTimeout(callback, 0);
@@ -1,11 +1,12 @@
1
- import { max, min } from "d3-array";
2
1
  import { pointers } from "d3-selection";
3
2
  import { assign, attrize, date } from "@d3plus/dom";
4
3
  import { closest } from "@d3plus/math";
5
4
  import { Axis } from "../index.js";
6
5
  import { constant } from "../../utils/index.js";
7
6
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
8
- import { initTimelineDefaults } from "./timelineConfig.js";
7
+ import { fitBrush, timelineBrushSpan } from "./brushSpan.js";
8
+ import { brushOverlayCursor, byValue, initTimelineDefaults } from "./timelineConfig.js";
9
+ import { classTimelineMode } from "./timelineMode.js";
9
10
  import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, renderPlayButton, setupBrush } from "./timelineRender.js";
10
11
  /** Timeline's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const timelineSchema = [
11
12
  {
@@ -13,6 +14,11 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
13
14
  coerce: "identity",
14
15
  default: 10
15
16
  },
17
+ {
18
+ key: "brushCursor",
19
+ coerce: "identity",
20
+ default: "pointer"
21
+ },
16
22
  {
17
23
  key: "brushing",
18
24
  coerce: "identity",
@@ -22,6 +28,10 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
22
28
  key: "brushFilter",
23
29
  coerce: "identity"
24
30
  },
31
+ {
32
+ key: "brushMax",
33
+ coerce: "const"
34
+ },
25
35
  {
26
36
  key: "brushMin",
27
37
  coerce: "const",
@@ -70,6 +80,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
70
80
  /**
71
81
  Creates an interactive timeline brush component for selecting time periods within a visualization.
72
82
  */ export default class Timeline extends Axis {
83
+ static _displayName = "Timeline";
73
84
  _buttonBehaviorCurrent;
74
85
  _hiddenHandles;
75
86
  _playButtonClass;
@@ -158,8 +169,9 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
158
169
  // would animate from d3-brush's internal drag bounds (the anchored edge), so
159
170
  // the lone handle would jump back to where the drag began and slide to the
160
171
  // release point; duration 0 applies the final period on the first frame.
172
+ // A timeline without a duration (reduced motion) snaps too.
161
173
  const move = this._brushGroup.transition(this._transition);
162
- if (!this.schema.brushing) move.duration(0);
174
+ if (!this.schema.brushing || !this.schema.duration) move.duration(0);
163
175
  move.call(this._brush.move, this._updateBrushLimit(domain));
164
176
  if (this.schema.on.end) this.schema.on.end(this.schema.selection);
165
177
  }
@@ -214,7 +226,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
214
226
  const sw = +brushSelection.attr("width") || 0;
215
227
  brushHandle.filter((d)=>d.type === "e").attr("x", sx + sw / 2 - this.schema.handleSize / 2);
216
228
  }
217
- this._brushGroup.selectAll(".overlay").attr("x", this._paddingLeft).attr("cursor", "pointer").attr("transform", `translate(0,${this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight / 2 : -this.schema.handleSize})`).attr("width", this._buttonBehaviorCurrent === "buttons" ? this._ticksWidth : this.schema.width).attr("height", this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight : this.schema.handleSize * 2);
229
+ this._brushGroup.selectAll(".overlay").attr("x", this._paddingLeft).attr("cursor", brushOverlayCursor(this)).attr("transform", `translate(0,${this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight / 2 : -this.schema.handleSize})`).attr("width", this._buttonBehaviorCurrent === "buttons" ? this._ticksWidth : this.schema.width).attr("height", this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight : this.schema.handleSize * 2);
218
230
  if (this._buttonBehaviorCurrent === "buttons") {
219
231
  const yTransform = this.schema.align === "middle" ? this.schema.height / 2 - this.schema.buttonHeight / 2 : this.schema.align === "start" ? this._margin.top : this.schema.height - this.schema.buttonHeight - this._margin.bottom;
220
232
  brushHandle.attr("y", yTransform);
@@ -226,60 +238,47 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
226
238
  @private
227
239
  */ _updateDomain(event) {
228
240
  const x = pointers(event, this._select.node());
229
- let domain = event.selection && this.schema.brushing || !x.length ? event.selection : [
241
+ const pixels = (event.selection && this.schema.brushing || !x.length ? event.selection : [
230
242
  x[0][0],
231
243
  x[0][0]
232
- ];
233
- if (this._buttonBehaviorCurrent === "ticks") domain = domain.map((d)=>this._d3Scale.invert(d));
234
- domain = domain.map(Number);
235
- const ticks = this._buttonBehaviorCurrent === "ticks" ? this._availableTicks.map(Number) : this._d3Scale.range();
236
- if (this._buttonBehaviorCurrent === "ticks") {
237
- // find closest min and max ticks from data
238
- // and their indices in the ticks Array
239
- let minDomain = date(closest(domain[0], ticks));
240
- let minIndex = ticks.indexOf(+minDomain);
241
- let maxDomain = date(closest(domain[1], ticks));
242
- let maxIndex = ticks.indexOf(+maxDomain);
243
- // using the indices, determine if the 2 ends of the brush
244
- // are too close to each other. "ticksApart" always needs to
245
- // be less than the current current brushMin minus 1. For
246
- // example, a brushMin of "2" means that the min and max domain
247
- // values need to be "1" space apart from eachother.
248
- let ticksApart = Math.abs(maxIndex - minIndex);
249
- const minTicksAllowed = this.schema.brushMin() - 1;
250
- // if the min and max are not far enough apart to satisfy
251
- // brushMin, then forcibly extend the domain.
252
- if (ticksApart < minTicksAllowed) {
253
- // push the maxDomain out as far as possible to account for brushMin
254
- maxIndex = min([
255
- ticks.length - 1,
256
- maxIndex + (minTicksAllowed - ticksApart)
257
- ]);
258
- maxDomain = ticks[maxIndex];
259
- ticksApart = Math.abs(maxIndex - minIndex);
260
- // if the domain is still not far enough apart, extent the minDomain
261
- // as far as possible to allow for brushMin
262
- if (ticksApart < minTicksAllowed) {
263
- minIndex = max([
264
- 0,
265
- minIndex - (minTicksAllowed - ticksApart)
266
- ]);
267
- minDomain = ticks[minIndex];
268
- }
269
- }
270
- domain[0] = minDomain;
271
- domain[1] = maxDomain;
272
- } else {
273
- domain[0] = closest(domain[0], ticks);
274
- domain[1] = closest(domain[1], ticks);
275
- }
244
+ ]).map(Number);
245
+ // Each period's value, earliest first (a reversed timeline lays them out
246
+ // latest first), and in buttons mode each button's position.
247
+ const ticksMode = this._buttonBehaviorCurrent === "ticks";
248
+ const periods = byValue(this._availableTicks).map(Number);
249
+ const positions = this._d3Scale.range();
250
+ const values = this._availableTicks.map(Number);
251
+ const periodAt = (px)=>periods.indexOf(ticksMode ? closest(+this._d3Scale.invert(px), periods) : values[positions.indexOf(closest(px, positions))]);
252
+ const ticks = ticksMode ? periods : positions;
253
+ // The edge being dragged (nearest the pointer) stays put when a
254
+ // selection is pulled in to `brushMax`, or (buttons) pushed out to
255
+ // `brushMin`.
256
+ const brushed = event.selection;
257
+ const px = x.length ? x[0][0] : NaN;
258
+ const anchor = brushed && Math.abs(px - brushed[0]) < Math.abs(px - brushed[1]) ? "lo" : "hi";
259
+ // The periods under each edge, moved so the selection spans `brushMin`
260
+ // to `brushMax` periods. A short ticks-mode selection grows from its
261
+ // first tick; a short buttons selection keeps the button being dragged,
262
+ // or starts at the one clicked.
263
+ const [lo, hi] = fitBrush([
264
+ periodAt(pixels[0]),
265
+ periodAt(pixels[1])
266
+ ], periods.length, timelineBrushSpan(this.schema), anchor, !ticksMode);
267
+ const position = (i)=>positions[values.indexOf(periods[i])];
268
+ const domain = ticksMode ? [
269
+ date(periods[lo]),
270
+ date(periods[hi])
271
+ ] : byValue([
272
+ position(lo),
273
+ position(hi)
274
+ ]);
276
275
  // if the brush event has finished, update the current "selection" value
277
276
  const single = +domain[0] === +domain[1];
278
277
  if (event.type === "brush" || event.type === "end") {
279
- this.schema.selection = this._buttonBehaviorCurrent === "ticks" ? single ? domain[0] : domain : single ? date(this._availableTicks[ticks.indexOf(domain[0])]) : [
278
+ this.schema.selection = this._buttonBehaviorCurrent === "ticks" ? single ? domain[0] : domain : single ? date(this._availableTicks[ticks.indexOf(domain[0])]) : byValue([
280
279
  date(this._availableTicks[ticks.indexOf(domain[0])]),
281
280
  date(this._availableTicks[ticks.indexOf(domain[1])])
282
- ];
281
+ ]);
283
282
  }
284
283
  return domain;
285
284
  }
@@ -287,7 +286,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
287
286
  Updates limits of the brush.
288
287
  @private
289
288
  */ _updateBrushLimit(domain) {
290
- const selection = this._buttonBehaviorCurrent === "ticks" ? domain.map(date).map((d)=>this._d3Scale(d)) : domain;
289
+ const selection = this._buttonBehaviorCurrent === "ticks" ? byValue(domain.map(date).map((d)=>this._d3Scale(d))) : domain;
291
290
  if (selection[0] === selection[1]) {
292
291
  selection[0] -= 0.1;
293
292
  selection[1] += 0.1;
@@ -330,8 +329,8 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
330
329
  };
331
330
  let firstTime = true;
332
331
  const nextYear = ()=>{
333
- const periods = this._buttonBehaviorCurrent === "ticks" ? this._availableTicks : this.schema.ticks;
334
- if (!periods || !periods.length) return;
332
+ const periods = byValue((this._buttonBehaviorCurrent === "ticks" ? this._availableTicks : this.schema.ticks) || []);
333
+ if (!periods.length) return;
335
334
  let selection = this.schema.selection || [
336
335
  this.schema.domain[this.schema.domain.length - 1]
337
336
  ];
@@ -428,6 +427,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
428
427
  super.render(callback);
429
428
  setupBrush(this, hiddenHandles, height, y);
430
429
  renderPlayButton(this, playButtonWidth);
430
+ classTimelineMode(this._group?.node(), "d3plus-Timeline", this._buttonBehaviorCurrent);
431
431
  // Standalone (non-Viz) use: a parent Viz normally composes the timeline's
432
432
  // scene via toScene(), but on its own `_managesOwnScenePaint` made
433
433
  // Axis.render() skip the paint, leaving only the brush/play DOM. Paint the
@@ -0,0 +1,78 @@
1
+ /** The fewest and most ticks a Timeline's brush selection may span. */ /** A `brushMin`/`brushMax` setting's value: a number, or a function returning one. */ const read = (value)=>typeof value === "function" ? value() : value;
2
+ /**
3
+ The fewest and most ticks a brush selection may span, from `brushMin` and
4
+ `brushMax` (each a number, or a function returning one). An unset or
5
+ non-finite `brushMax` is unlimited and a fractional one rounds down; one
6
+ below `brushMin` rises to it, so `brushMin` wins when they conflict.
7
+ */ export function brushSpan(brushMin, brushMax) {
8
+ const lo = read(brushMin);
9
+ const min = typeof lo === "number" && Number.isFinite(lo) ? lo : 1;
10
+ const hi = read(brushMax);
11
+ const max = typeof hi === "number" && Number.isFinite(hi) ? Math.max(Math.floor(hi), Math.ceil(min), 1) : Infinity;
12
+ return {
13
+ min,
14
+ max
15
+ };
16
+ }
17
+ /**
18
+ A selection's end tick indices (`lo` to `hi`, out of `count` ticks), moved
19
+ so it spans `span.min` to `span.max` ticks. Too short, it keeps its `fixed`
20
+ end and moves the other out, then the fixed end too where the ticks run
21
+ out. Too long, it keeps the `anchor` end (the one being dragged) and pulls
22
+ the other in.
23
+ */ export function spanIndices(lo, hi, count, span, anchor = "hi", fixed = "lo") {
24
+ const fewest = span.min - 1;
25
+ if (Math.abs(hi - lo) < fewest) {
26
+ if (fixed === "lo") {
27
+ hi = Math.min(count - 1, lo + fewest);
28
+ lo = Math.max(0, hi - fewest);
29
+ } else {
30
+ lo = Math.max(0, hi - fewest);
31
+ hi = Math.min(count - 1, lo + fewest);
32
+ }
33
+ }
34
+ const most = span.max - 1;
35
+ if (hi - lo > most) {
36
+ if (anchor === "lo") hi = lo + most;
37
+ else lo = hi - most;
38
+ }
39
+ return [
40
+ lo,
41
+ hi
42
+ ];
43
+ }
44
+ /**
45
+ The end a selection keeps while it grows to `brushMin`: the end being
46
+ dragged (`anchor`), or its first when it is a single period (a click).
47
+ */ export const growFrom = (lo, hi, anchor)=>lo === hi ? "lo" : anchor;
48
+ /**
49
+ A Timeline's brush span (see `brushSpan`); a single-period Timeline
50
+ (`brushing: false`) has no `brushMin` to meet.
51
+ */ export function timelineBrushSpan(schema) {
52
+ const span = brushSpan(schema.brushMin, schema.brushMax);
53
+ return schema.brushing === false ? {
54
+ ...span,
55
+ min: 1
56
+ } : span;
57
+ }
58
+ /**
59
+ A brushed selection fitted to `span`. `edges` are the period indices
60
+ (earliest first) under the brush's left and right edges, which a
61
+ reversed timeline holds latest first; `anchor` is the edge being dragged.
62
+ Pulled in, the dragged end stays put. Pushed out, the first period does,
63
+ or with `keepDragged` the dragged end (a click's period). Returns the
64
+ fitted indices, earliest first.
65
+ */ export function fitBrush(edges, count, span, anchor, keepDragged = false) {
66
+ const lo = Math.min(...edges);
67
+ const hi = Math.max(...edges);
68
+ const dragged = edges[anchor === "lo" ? 0 : 1] === lo ? "lo" : "hi";
69
+ const fixed = keepDragged ? growFrom(lo, hi, dragged) : "lo";
70
+ return spanIndices(lo, hi, count, span, dragged, fixed);
71
+ }
72
+ /** The index of the value in `values` nearest `value`. */ export function nearestIndex(values, value) {
73
+ let best = -1;
74
+ values.forEach((v, i)=>{
75
+ if (best < 0 || Math.abs(v - value) < Math.abs(values[best] - value)) best = i;
76
+ });
77
+ return best;
78
+ }
@@ -1,7 +1,27 @@
1
- import { colorContrast } from "@d3plus/color";
2
- import { assign, backgroundColor } from "@d3plus/dom";
1
+ import { assign } from "@d3plus/dom";
2
+ import { inkBackground, inkText } from "../../utils/themeInk.js";
3
+ import { themed } from "../../utils/theme.js";
3
4
  import TextBox from "../TextBox.js";
4
5
  const colorMid = "#bbb";
6
+ const accentDefault = "#228be6";
7
+ /** A button's fill: white, or the theme's background once it is forced or dark. */ function buttonFill(tl) {
8
+ return tl._theme?.painted || tl._theme?.dark ? inkBackground(tl) : "#fff";
9
+ }
10
+ /** The selection and handle color: the theme's `accent`. */ const accent = (tl)=>()=>themed(tl._theme, (t)=>t.accent, accentDefault);
11
+ /**
12
+ A copy of `values` (dates, years or pixel positions) in ascending order.
13
+ A `reverse` timeline lays its ticks out from latest to earliest, but its
14
+ selections, defaults and playback run from earliest to latest.
15
+ */ export function byValue(values) {
16
+ return values.slice().sort((a, b)=>Number(a) - Number(b));
17
+ }
18
+ /**
19
+ The brush overlay's cursor: `brushCursor`, or what it returns when given
20
+ the presentation drawn (`"ticks"` or `"buttons"`).
21
+ */ export function brushOverlayCursor(tl) {
22
+ const cursor = tl.schema.brushCursor;
23
+ return typeof cursor === "function" ? cursor(tl._buttonBehaviorCurrent) : cursor ?? null;
24
+ }
5
25
  /**
6
26
  Builds the play/pause TextBox. The button's visual is composed into the
7
27
  scene in compute mode; its click is wired to `Timeline._togglePlay` via a
@@ -19,14 +39,11 @@ const colorMid = "#bbb";
19
39
  height: tl.schema.buttonHeight
20
40
  } : d.labelBounds,
21
41
  labelConfig: {
22
- fontColor: ()=>{
23
- const bg = tl._select ? backgroundColor(tl._select.node()) : "rgb(255, 255, 255)";
24
- return colorContrast(bg, tl.schema.colorDefaults);
25
- },
42
+ fontColor: ()=>inkText(tl),
26
43
  fontSize: ()=>12,
27
44
  verticalAlign: ()=>tl._buttonBehaviorCurrent === "buttons" ? "middle" : "top"
28
45
  },
29
- fill: ()=>tl._buttonBehaviorCurrent === "buttons" ? "#fff" : colorMid,
46
+ fill: ()=>tl._buttonBehaviorCurrent === "buttons" ? buttonFill(tl) : colorMid,
30
47
  stroke: ()=>tl._buttonBehaviorCurrent === "buttons" ? colorMid : "transparent",
31
48
  height: (d)=>tl._buttonBehaviorCurrent === "buttons" ? tl.schema.buttonHeight : d.tick ? tl.schema.handleSize : 0,
32
49
  width: (d)=>tl._buttonBehaviorCurrent === "buttons" ? tl._ticksWidth / tl._availableTicks.length : d.tick ? tl.schema.domain.map(Number).includes(d.id) ? 2 : 1 : 0,
@@ -50,7 +67,7 @@ const colorMid = "#bbb";
50
67
  tl.schema.gridSize = 0;
51
68
  tl.schema.handleConfig = {
52
69
  fill: ()=>tl.schema.colorDefaults.light,
53
- stroke: "#228be6",
70
+ stroke: accent(tl),
54
71
  "stroke-width": 2,
55
72
  rx: 2,
56
73
  ry: 2
@@ -62,14 +79,14 @@ const colorMid = "#bbb";
62
79
  tl.orient("bottom");
63
80
  tl._playButtonClass = buildPlayButton();
64
81
  tl.schema.playButtonConfig = {
65
- fontColor: ()=>tl.schema.colorDefaults.dark,
82
+ fontColor: ()=>inkText(tl),
66
83
  fontSize: 15,
67
84
  text: ()=>tl._playTimer ? "\u23F8" : "\u23F5",
68
85
  textAnchor: "middle",
69
86
  verticalAlign: "middle"
70
87
  };
71
88
  tl.schema.selectionConfig = {
72
- fill: "#228be6",
89
+ fill: accent(tl),
73
90
  "fill-opacity": ()=>tl._buttonBehaviorCurrent === "buttons" ? 0.3 : 1,
74
91
  "stroke-width": 0
75
92
  };
@@ -0,0 +1,26 @@
1
+ /** How a Timeline draws its periods: tick marks along an axis, or a row of buttons. */ const MODES = [
2
+ "ticks",
3
+ "buttons"
4
+ ];
5
+ /**
6
+ The class naming how a Timeline is drawn, `<prefix>-ticks` or
7
+ `<prefix>-buttons`, or none before it resolves a mode.
8
+ @param prefix The element's own class, such as `d3plus-viz-timeline`.
9
+ @param mode The Timeline's resolved `buttonBehavior`.
10
+ */ export function timelineModeClass(prefix, mode) {
11
+ return MODES.includes(mode) ? `${prefix}-${mode}` : null;
12
+ }
13
+ /**
14
+ Adds `timelineModeClass(prefix, mode)` to `el` and removes the other
15
+ mode's class, so the element names the presentation drawn last.
16
+ @param el The element to mark.
17
+ @param prefix The element's own class.
18
+ @param mode The Timeline's resolved `buttonBehavior`.
19
+ */ export function classTimelineMode(el, prefix, mode) {
20
+ if (!el) return;
21
+ const current = timelineModeClass(prefix, mode);
22
+ for (const m of MODES){
23
+ const name = `${prefix}-${m}`;
24
+ el.classList.toggle(name, name === current);
25
+ }
26
+ }
@@ -8,7 +8,10 @@ import { locale } from "@d3plus/locales";
8
8
  import { SvgRenderer } from "@d3plus/render";
9
9
  import { textWrap } from "@d3plus/text";
10
10
  import { configPrep } from "../../utils/index.js";
11
+ import { applyClassName } from "../../utils/className.js";
11
12
  import { parseTimeValues } from "../Axis/timeValues.js";
13
+ import { nearestIndex, spanIndices, timelineBrushSpan } from "./brushSpan.js";
14
+ import { byValue } from "./timelineConfig.js";
12
15
  /**
13
16
  Standalone paint for the Timeline's scene (axis ticks/domain line/labels
14
17
  plus the play button's pixels). Inside a Viz the parent composes this via
@@ -47,6 +50,7 @@ import { parseTimeValues } from "../Axis/timeValues.js";
47
50
  }, {
48
51
  duration: 0
49
52
  });
53
+ applyClassName(tl);
50
54
  }
51
55
  /** Coerces ticks/data to dates and resolves the tick format. */ export function prepareTicks(tl) {
52
56
  if (tl.schema.ticks) tl.schema.ticks = parseTimeValues(tl.schema.ticks);
@@ -104,8 +108,9 @@ import { parseTimeValues } from "../Axis/timeValues.js";
104
108
  const hiddenHandles = tl._hiddenHandles = tl._buttonBehaviorCurrent === "buttons" && !tl.schema.brushing;
105
109
  if (tl._buttonBehaviorCurrent === "buttons") {
106
110
  tl.schema.scale = "ordinal";
107
- const domain = scaleTime().domain(tl.schema.domain.map(date)).ticks().map(Number);
108
- tl.schema.domain = tl.schema.ticks ? tl.schema.ticks : Array.from(Array(domain[domain.length - 1] - domain[0] + 1), (_, x)=>domain[0] + x).map(date);
111
+ // One button per tick: the `ticks` given, or the time scale's own (the
112
+ // ones `measureTicksWidth` sized the buttons for).
113
+ tl.schema.domain = tl.schema.ticks ? tl.schema.ticks : ticks;
109
114
  tl.schema.ticks = tl.schema.domain;
110
115
  const buttonMargin = 0.5 * tl._ticksWidth / tl.schema.ticks.length;
111
116
  const emptySpace = tl.schema.width - tl._ticksWidth - playButtonWidth;
@@ -125,6 +130,33 @@ import { parseTimeValues } from "../Axis/timeValues.js";
125
130
  }
126
131
  return hiddenHandles;
127
132
  }
133
+ /**
134
+ Holds a starting `selection` to `brushMin` to `brushMax` periods, in
135
+ place, keeping its later end (or, at the first period, its earlier one),
136
+ and stores what remains as the Timeline's selection. `periods` are where
137
+ each period sits in `selection`'s terms (tick dates, or button positions)
138
+ and `dates` the periods themselves, both earliest first.
139
+ */ export function clampSelection(tl, selection, periods, dates = periods) {
140
+ const span = timelineBrushSpan(tl.schema);
141
+ if (span.min <= 1 && span.max === Infinity || !periods.length) return;
142
+ const values = periods.map(Number);
143
+ const ends = [
144
+ selection[0],
145
+ selection[selection.length - 1]
146
+ ].map((d)=>nearestIndex(values, Number(d)));
147
+ const first = Math.min(...ends);
148
+ const last = Math.max(...ends);
149
+ const [lo, hi] = spanIndices(first, last, values.length, span, "hi", "hi");
150
+ if (lo === first && hi === last) return;
151
+ [selection[0], selection[selection.length - 1]] = byValue([
152
+ periods[lo],
153
+ periods[hi]
154
+ ]);
155
+ tl.schema.selection = [
156
+ dates[lo],
157
+ dates[hi]
158
+ ].map((d)=>date(d));
159
+ }
128
160
  /** Builds the d3-brush, computes the active selection, and mounts the brush group. */ export function setupBrush(tl, hiddenHandles, height, y) {
129
161
  const offset = tl._outerBounds[y], range = tl._d3Scale.range();
130
162
  // In "buttons" mode the scale positions ticks at each button's *midpoint*, so
@@ -149,25 +181,35 @@ import { parseTimeValues } from "../Axis/timeValues.js";
149
181
  offset + tl._outerBounds[height]
150
182
  ]
151
183
  ]).filter(tl.schema.brushFilter).handleSize(hiddenHandles ? 0 : tl.schema.handleSize).on("start", tl._brushStart.bind(tl)).on("brush", tl._brushBrush.bind(tl)).on("end", tl._brushEnd.bind(tl));
152
- // data Array to be used when detecting the default value
153
- const defaultData = tl._buttonBehaviorCurrent === "ticks" ? tl._availableTicks : range;
184
+ // The ticks from earliest to latest, to pick the default from, and a
185
+ // button's position.
186
+ const ticks = byValue((tl._buttonBehaviorCurrent === "ticks" ? tl._availableTicks : tl.schema.ticks) || []);
187
+ const button = (d)=>{
188
+ const tick = ticks[ticks.map(Number).indexOf(+d)];
189
+ return tick === undefined ? undefined : tl._d3Scale(tick);
190
+ };
191
+ const defaultData = tl._buttonBehaviorCurrent === "ticks" ? ticks : ticks.map(button);
154
192
  // the default selection, if needed
155
- const defaultSelection = [
193
+ const defaultSelection = byValue([
156
194
  tl.schema.brushMin() > defaultData.length ? defaultData[0] : defaultData[defaultData.length - tl.schema.brushMin()],
157
195
  defaultData[defaultData.length - 1]
158
- ];
196
+ ]);
159
197
  // the current selection, considering user input, defaults, and data
160
- const selection = tl.schema.selection === void 0 ? defaultSelection : tl.schema.selection instanceof Array ? tl._buttonBehaviorCurrent === "buttons" ? tl.schema.selection.map(date).map((d)=>range[tl.schema.ticks.map(Number).indexOf(+d)]) : tl.schema.selection.map(date) : tl._buttonBehaviorCurrent === "buttons" ? [
161
- range[tl.schema.ticks.map(Number).indexOf(+tl.schema.selection)]
198
+ const selection = tl.schema.selection === void 0 ? defaultSelection : tl.schema.selection instanceof Array ? tl._buttonBehaviorCurrent === "buttons" ? byValue(tl.schema.selection.map(date).map(button)) : tl.schema.selection.map(date) : tl._buttonBehaviorCurrent === "buttons" ? [
199
+ button(date(tl.schema.selection))
162
200
  ] : [
163
201
  tl.schema.selection
164
202
  ];
165
203
  if (selection.length === 1) selection.push(selection[0]);
204
+ clampSelection(tl, selection, defaultData, ticks);
166
205
  tl._updateBrushLimit(selection);
167
206
  tl._brushGroup = elem("g.brushGroup", {
168
207
  parent: tl._group
169
208
  });
170
- tl._brushGroup.call(brush).transition(tl._transition).call(brush.move, tl._buttonBehaviorCurrent === "ticks" ? tl._updateBrushLimit(selection) : selection);
209
+ const brushMove = tl._brushGroup.call(brush).transition(tl._transition);
210
+ // Without a duration (reduced motion), the brush jumps to the selection.
211
+ if (!tl.schema.duration) brushMove.duration(0);
212
+ brushMove.call(brush.move, tl._buttonBehaviorCurrent === "ticks" ? tl._updateBrushLimit(selection) : selection);
171
213
  tl._outerBounds.y -= tl.schema.handleSize / 2;
172
214
  tl._outerBounds.height += tl.schema.handleSize / 2;
173
215
  }