@d3plus/core 4.10.0 → 4.12.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 (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -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 +176 -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 +101 -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 +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  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/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,196 @@
1
+ /**
2
+ A time scale whose domain skips hidden stretches of time (see
3
+ `RangeBreakRule`): weekends, nights, holidays, or explicit ranges close
4
+ up so the times on either side sit next to each other. A gap whose rule
5
+ asks for a marker keeps a short fixed stretch of pixels, where an axis
6
+ draws its break marker.
7
+ */ import { bisectRight, quantile } from "d3-array";
8
+ import { scaleTime, scaleUtc } from "d3-scale";
9
+ import { gapIndex, offsetVisible, rangeBreakGaps, visibleBetween } from "./rangeBreaks.js";
10
+ /** Whether `scale` is a broken time scale. */ export const isBrokenTimeScale = (scale)=>typeof scale === "function" && "rangeBreaks" in scale;
11
+ /**
12
+ The time between `a` and `b` on `scale` (`b - a`, in ms): on a broken
13
+ time scale, only the time it shows.
14
+ */ export const scaleTimeStep = (scale, a, b)=>isBrokenTimeScale(scale) ? scale.visible(a, b) : +b - +a;
15
+ /**
16
+ The time `ms` after `t` (before it, when negative) on `scale`: on a
17
+ broken time scale, stepping over the time it hides.
18
+ */ export const scaleTimeShift = (scale, t, ms)=>isBrokenTimeScale(scale) ? scale.offset(t, ms) : new Date(+t + ms);
19
+ function layout(rules, domain, range, utc, space) {
20
+ const [d0, d1] = domain;
21
+ const lo = Math.min(d0, d1);
22
+ const hi = Math.max(d0, d1);
23
+ const [r0, r1] = range;
24
+ const start = d0 <= d1 ? r0 : r1;
25
+ const end = d0 <= d1 ? r1 : r0;
26
+ const dir = Math.sign(end - start) || 1;
27
+ const length = Math.abs(end - start);
28
+ const all = rangeBreakGaps(rules, lo, hi, utc);
29
+ const clipped = all.map((g)=>({
30
+ ...g,
31
+ start: Math.max(g.start, lo),
32
+ end: Math.min(g.end, hi)
33
+ })).filter((g)=>g.end > g.start);
34
+ const marked = clipped.filter((g)=>g.marker && g.start > lo && g.end < hi);
35
+ // Marked gaps keep their space while it leaves the data twice that room.
36
+ const room = length - marked.length * space >= space * 2 ? space : 0;
37
+ const gaps = clipped.map((g)=>({
38
+ ...g,
39
+ space: g.marker && g.start > lo && g.end < hi ? room : 0
40
+ }));
41
+ const hidden = gaps.reduce((s, g)=>s + g.end - g.start, 0);
42
+ const visibleMs = hi - lo - hidden;
43
+ const spaced = gaps.reduce((s, g)=>s + g.space, 0);
44
+ const empty = !(visibleMs > 0);
45
+ const rate = empty ? 0 : (length - spaced) / visibleMs;
46
+ const at = [];
47
+ let seen = lo, px = 0;
48
+ gaps.forEach((g)=>{
49
+ px += (g.start - seen) * rate;
50
+ at.push(px);
51
+ px += g.space;
52
+ seen = g.end;
53
+ });
54
+ return {
55
+ lo,
56
+ hi,
57
+ start,
58
+ dir,
59
+ length,
60
+ rate,
61
+ all,
62
+ gaps,
63
+ at,
64
+ empty
65
+ };
66
+ }
67
+ /** Pixel offset of a time from the domain's low end. */ function offsetOf(lay, rules, utc, t) {
68
+ const { lo, hi, length, rate, gaps, at } = lay;
69
+ if (t < lo) return -visibleBetween(rules, t, lo, utc) * rate;
70
+ if (t > hi) return length + visibleBetween(rules, hi, t, utc) * rate;
71
+ const i = gapIndex(gaps, t);
72
+ if (i < 0) return (t - lo) * rate;
73
+ const g = gaps[i];
74
+ if (t < g.end) return at[i] + g.space * (t - g.start) / (g.end - g.start);
75
+ return at[i] + g.space + (t - g.end) * rate;
76
+ }
77
+ /** The time at a pixel; a closed gap's pixel reads as the time after it. */ function invertAt(lay, rules, utc, px) {
78
+ const { lo, hi, start, dir, rate, gaps, at, empty } = lay;
79
+ if (empty || !rate) return new Date(lo);
80
+ const o = (px - start) * dir;
81
+ if (o < 0) return new Date(offsetVisible(rules, lo, o / rate, utc));
82
+ const i = bisectRight(at, o) - 1;
83
+ let t;
84
+ if (i < 0) t = lo + o / rate;
85
+ else {
86
+ const g = gaps[i];
87
+ const into = o - at[i];
88
+ t = into < g.space ? g.start + into / g.space * (g.end - g.start) : g.end + (into - g.space) / rate;
89
+ }
90
+ // Past the last gap, time beyond `hi` steps over the rules' gaps.
91
+ return new Date(t > hi ? offsetVisible(rules, hi, t - hi, utc) : t);
92
+ }
93
+ /**
94
+ About `count` tick times (ms, ascending) for a laid-out domain, none of
95
+ them hidden: d3's time ticks, asked for more as more time is hidden,
96
+ with each tick inside a gap moved to the gap's end.
97
+ */ function layoutTicks(lay, count, time, scale) {
98
+ const { lo, hi, all, gaps, empty } = lay;
99
+ // A single shown time ticks itself, as d3's time scale does.
100
+ if (empty) return lo === hi && !scale.isHidden(lo) ? [
101
+ lo
102
+ ] : [];
103
+ const visibleMs = hi - lo - gaps.reduce((s, g)=>s + g.end - g.start, 0);
104
+ const asked = Math.max(1, Math.round(count * (hi - lo) / visibleMs));
105
+ const base = time.ticks(asked).map(Number);
106
+ const ticks = new Map();
107
+ for (const tick of base){
108
+ const i = gapIndex(all, tick);
109
+ const moved = i >= 0 && tick < all[i].end;
110
+ const t = moved ? all[i].end : tick;
111
+ if (t <= hi) ticks.set(t, moved || ticks.get(t) === true);
112
+ }
113
+ // A moved tick opens a stretch of shown time (a day after a night, a
114
+ // week after a weekend), so a plain tick within half a step of it gives
115
+ // way.
116
+ const steps = base.slice(1).map((t, k)=>t - base[k]);
117
+ const half = steps.length ? quantile(steps, 0.5) / 2 : 0;
118
+ const moved = [
119
+ ...ticks
120
+ ].filter(([, m])=>m).map(([t])=>t);
121
+ return [
122
+ ...ticks
123
+ ].filter(([t, m])=>m || !moved.some((o)=>Math.abs(scale.visible(o, t)) <= half)).map(([t])=>t).sort((a, b)=>a - b);
124
+ }
125
+ /**
126
+ Builds a time scale that hides the time `rules` describe. It reads like
127
+ d3's `scaleTime` — `domain`, `range`, `ticks`, `tickFormat`, `invert`,
128
+ and `copy` — but visible time shares one pixel rate and hidden time
129
+ takes none (or a marked gap's `space`). A hidden time maps to where its
130
+ gap sits; a pixel at a closed gap inverts to the time after it. Times
131
+ past the domain extrapolate through the rules' gaps, so a scale can be
132
+ padded or zoomed out.
133
+ */ export function brokenTimeScale(rules, options = {}) {
134
+ const utc = Boolean(options.utc);
135
+ const space = Math.max(0, options.space ?? 0);
136
+ let domain = [
137
+ +new Date(2000, 0, 1),
138
+ +new Date(2000, 0, 2)
139
+ ];
140
+ let range = [
141
+ 0,
142
+ 1
143
+ ];
144
+ let lay = layout(rules, domain, range, utc, space);
145
+ const rebuild = ()=>{
146
+ lay = layout(rules, domain, range, utc, space);
147
+ };
148
+ const scale = (value)=>{
149
+ const t = +value;
150
+ if (!Number.isFinite(t)) return NaN;
151
+ const { start, dir, empty } = lay;
152
+ if (empty) return (range[0] + range[1]) / 2;
153
+ return start + dir * offsetOf(lay, rules, utc, t);
154
+ };
155
+ scale.rangeBreaks = rules;
156
+ scale.domain = (d)=>{
157
+ if (d === undefined) return domain.map((t)=>new Date(t));
158
+ domain = Array.from(d, (v)=>+v).slice(0, 2);
159
+ rebuild();
160
+ return scale;
161
+ };
162
+ scale.range = (r)=>{
163
+ if (r === undefined) return range.slice();
164
+ range = Array.from(r, Number).slice(0, 2);
165
+ rebuild();
166
+ return scale;
167
+ };
168
+ scale.copy = ()=>brokenTimeScale(rules, options).domain(domain).range(range);
169
+ scale.invert = (px)=>invertAt(lay, rules, utc, px);
170
+ scale.gaps = ()=>lay.gaps.map((g)=>({
171
+ ...g
172
+ }));
173
+ scale.isHidden = (value)=>{
174
+ const t = +value;
175
+ const { lo, hi, all } = lay;
176
+ if (t < lo || t > hi) return rangeBreakGaps(rules, t, t, utc).some((g)=>g.start <= t && t < g.end);
177
+ const i = gapIndex(all, t);
178
+ return i >= 0 && t < all[i].end;
179
+ };
180
+ scale.visible = (a, b)=>{
181
+ const x = +a, y = +b;
182
+ return x <= y ? visibleBetween(rules, x, y, utc) : -visibleBetween(rules, y, x, utc);
183
+ };
184
+ scale.offset = (t, ms)=>new Date(offsetVisible(rules, +t, ms, utc));
185
+ const timeScale = ()=>(utc ? scaleUtc : scaleTime)().domain([
186
+ lay.lo,
187
+ lay.hi
188
+ ]);
189
+ scale.ticks = (count = 10)=>{
190
+ const out = layoutTicks(lay, count, timeScale(), scale).map((t)=>new Date(t));
191
+ if (domain[0] > domain[1]) out.reverse();
192
+ return out;
193
+ };
194
+ scale.tickFormat = (count, specifier)=>timeScale().tickFormat(count, specifier);
195
+ return scale;
196
+ }
@@ -0,0 +1,201 @@
1
+ /**
2
+ Range break rules for time axes: the calendar stretches (weekends,
3
+ daily hours, whole days, explicit ranges) a time axis hides so its data
4
+ closes up around them. Rules read calendar time in the local time zone,
5
+ as d3's `scaleTime` and d3plus's date labels do, or in UTC when asked.
6
+ */ import { timeDay, utcDay } from "d3-time";
7
+ import { date } from "@d3plus/dom";
8
+ const DAY = 864e5;
9
+ /** A rule value read as a timestamp, or `NaN` when it doesn't parse. */ export function rangeBreakTime(value) {
10
+ if (value instanceof Date) return +value;
11
+ if (typeof value !== "number" && typeof value !== "string") return NaN;
12
+ const parsed = date(value);
13
+ return parsed instanceof Date ? +parsed : NaN;
14
+ }
15
+ const isRecord = (v)=>typeof v === "object" && v !== null && !Array.isArray(v);
16
+ const validHours = (h)=>Array.isArray(h) && h.length === 2 && h.every((n)=>typeof n === "number" && n >= 0 && n <= 24);
17
+ /** Whether `rule` is a rule a time axis can read. */ export function isRangeBreakRule(rule) {
18
+ if (rule === "weekends") return true;
19
+ if (!isRecord(rule)) return false;
20
+ if ("days" in rule) return Array.isArray(rule.days) && rule.days.every((d)=>Number.isInteger(d) && d >= 0 && d <= 6);
21
+ if ("hours" in rule) return validHours(rule.hours);
22
+ if ("values" in rule) return Array.isArray(rule.values);
23
+ if ("bounds" in rule) return Array.isArray(rule.bounds) && rule.bounds.length === 2 && rule.bounds.every((b)=>Number.isFinite(rangeBreakTime(b)));
24
+ return false;
25
+ }
26
+ /**
27
+ Reads a `rangeBreaks` setting — one rule, a list of them, or a falsy
28
+ value — into the list of rules a time axis can use, dropping any it
29
+ can't read.
30
+ */ export function normalizeRangeBreaks(input) {
31
+ if (!input) return [];
32
+ const list = Array.isArray(input) ? input : [
33
+ input
34
+ ];
35
+ return list.filter(isRangeBreakRule);
36
+ }
37
+ /** Whether a rule draws a break marker (see `RangeBreakRule`). */ export const ruleMarker = (rule)=>typeof rule === "object" && typeof rule.marker === "boolean" ? rule.marker : typeof rule === "object" && "bounds" in rule;
38
+ /** The calendar days that touch `[lo, hi]`, each as its start and end. */ function eachDay(lo, hi, utc, fn) {
39
+ const interval = utc ? utcDay : timeDay;
40
+ let day = interval.floor(new Date(lo));
41
+ while(+day <= hi){
42
+ const next = interval.offset(day, 1);
43
+ fn(day, next);
44
+ day = next;
45
+ }
46
+ }
47
+ /** A time `hours` into `day`, read on the wall clock (so DST shifts it). */ function atHour(day, hours, utc) {
48
+ const out = new Date(+day);
49
+ const h = Math.floor(hours);
50
+ const m = Math.round((hours - h) * 60);
51
+ if (utc) out.setUTCHours(h, m, 0, 0);
52
+ else out.setHours(h, m, 0, 0);
53
+ return +out;
54
+ }
55
+ /** The gaps one rule hides that overlap `[lo, hi]`, unsorted and unmerged. */ function ruleGaps(rule, lo, hi, utc) {
56
+ const out = [];
57
+ if (rule === "weekends" || "days" in rule) {
58
+ const days = new Set(rule === "weekends" ? [
59
+ 0,
60
+ 6
61
+ ] : rule.days);
62
+ eachDay(lo, hi, utc, (start, end)=>{
63
+ if (days.has(utc ? start.getUTCDay() : start.getDay())) out.push([
64
+ +start,
65
+ +end
66
+ ]);
67
+ });
68
+ } else if ("hours" in rule) {
69
+ const [from, to] = rule.hours;
70
+ if (from === to) return out;
71
+ // A wrapping window reaches into the day before `lo`.
72
+ eachDay(lo - DAY, hi, utc, (start, end)=>{
73
+ const a = atHour(start, from, utc);
74
+ const b = from < to ? atHour(start, to, utc) : atHour(end, to, utc);
75
+ if (b > a) out.push([
76
+ a,
77
+ b
78
+ ]);
79
+ });
80
+ } else if ("values" in rule) {
81
+ const interval = utc ? utcDay : timeDay;
82
+ rule.values.forEach((v)=>{
83
+ const t = rangeBreakTime(v);
84
+ if (!Number.isFinite(t)) return;
85
+ const day = interval.floor(new Date(t));
86
+ out.push([
87
+ +day,
88
+ +interval.offset(day, 1)
89
+ ]);
90
+ });
91
+ } else {
92
+ const [a, b] = rule.bounds.map(rangeBreakTime);
93
+ if (a !== b) out.push(a < b ? [
94
+ a,
95
+ b
96
+ ] : [
97
+ b,
98
+ a
99
+ ]);
100
+ }
101
+ return out;
102
+ }
103
+ /**
104
+ The stretches of time `rules` hide that overlap `[lo, hi]`: sorted,
105
+ with overlapping and touching gaps merged (a merged gap draws a marker
106
+ when any of its rules does). Gaps are not clipped to `[lo, hi]`.
107
+ @param utc Read the calendar in UTC instead of local time.
108
+ */ export function rangeBreakGaps(rules, lo, hi, utc = false) {
109
+ if (!(lo <= hi)) return [];
110
+ const all = rules.flatMap((rule)=>ruleGaps(rule, lo, hi, utc).map(([start, end])=>({
111
+ start,
112
+ end,
113
+ marker: ruleMarker(rule)
114
+ }))).filter((g)=>g.end > lo && g.start <= hi).sort((a, b)=>a.start - b.start);
115
+ const merged = [];
116
+ for (const g of all){
117
+ const last = merged[merged.length - 1];
118
+ if (last && g.start <= last.end) {
119
+ last.end = Math.max(last.end, g.end);
120
+ last.marker = last.marker || g.marker;
121
+ } else merged.push({
122
+ ...g
123
+ });
124
+ }
125
+ return merged;
126
+ }
127
+ /** The last gap starting at or before `t` (gaps sorted by start), or -1. */ export function gapIndex(gaps, t) {
128
+ let lo = 0, hi = gaps.length - 1, found = -1;
129
+ while(lo <= hi){
130
+ const mid = lo + hi >> 1;
131
+ if (gaps[mid].start <= t) {
132
+ found = mid;
133
+ lo = mid + 1;
134
+ } else hi = mid - 1;
135
+ }
136
+ return found;
137
+ }
138
+ /**
139
+ A test for whether a time between `lo` and `hi` is hidden by `rules`:
140
+ the gaps are found once, so the test is cheap to run over many values.
141
+ A time outside `[lo, hi]` is tested on its own.
142
+ */ export function rangeBreakTest(rules, lo, hi, utc = false) {
143
+ const gaps = rangeBreakGaps(rules, lo, hi, utc);
144
+ return (value)=>{
145
+ const t = +value;
146
+ if (!Number.isFinite(t)) return false;
147
+ if (t < lo || t > hi) return isHiddenTime(rules, t, utc);
148
+ const i = gapIndex(gaps, t);
149
+ return i >= 0 && t < gaps[i].end;
150
+ };
151
+ }
152
+ /** Whether `rules` hide the time `t`. */ export function isHiddenTime(rules, t, utc = false) {
153
+ const n = +t;
154
+ return rangeBreakGaps(rules, n, n, utc).some((g)=>g.start <= n && n < g.end);
155
+ }
156
+ /**
157
+ The visible time between `a` and `b` (in ms, `a <= b`): their distance
158
+ less every hidden stretch between them.
159
+ */ export function visibleBetween(rules, a, b, utc = false) {
160
+ if (!(a < b)) return 0;
161
+ const hidden = rangeBreakGaps(rules, a, b, utc).reduce((s, g)=>s + Math.max(0, Math.min(b, g.end) - Math.max(a, g.start)), 0);
162
+ return b - a - hidden;
163
+ }
164
+ /**
165
+ Whether `rules` hide all of time: a week (plus a day for DST) with no
166
+ visible moment, which repeating rules then repeat forever.
167
+ */ export function hidesAllTime(rules, utc = false) {
168
+ const t = Date.UTC(2001, 0, 1);
169
+ return visibleBetween(rules, t, t + 8 * DAY, utc) <= 0;
170
+ }
171
+ /**
172
+ The time `ms` of visible time after `t` (or before it, when `ms` is
173
+ negative), stepping over every hidden stretch on the way. Rules that
174
+ hide all of time leave `t` where it is.
175
+ */ export function offsetVisible(rules, t, ms, utc = false) {
176
+ if (!ms || !Number.isFinite(ms) || hidesAllTime(rules, utc)) return t;
177
+ const forward = ms > 0;
178
+ let remaining = Math.abs(ms);
179
+ let cur = t;
180
+ let window = Math.max(remaining * 2, 7 * DAY);
181
+ for(let pass = 0; pass < 32; pass++){
182
+ const lo = forward ? cur : cur - window;
183
+ const hi = forward ? cur + window : cur;
184
+ const gaps = rangeBreakGaps(rules, lo, hi, utc);
185
+ for (const g of forward ? gaps : gaps.reverse()){
186
+ const free = forward ? g.start - cur : cur - g.end;
187
+ // A step that ends where a gap starts lands on the gap's far side.
188
+ if (free > 0 && (forward ? remaining < free : remaining <= free)) return forward ? cur + remaining : cur - remaining;
189
+ if (free > 0) remaining -= free;
190
+ if (forward ? g.end > cur : g.start < cur) cur = forward ? g.end : g.start;
191
+ }
192
+ const free = forward ? hi - cur : cur - lo;
193
+ if (free > 0 && remaining <= free) return forward ? cur + remaining : cur - remaining;
194
+ if (free > 0) {
195
+ remaining -= free;
196
+ cur = forward ? hi : lo;
197
+ }
198
+ window *= 2;
199
+ }
200
+ return cur;
201
+ }
@@ -3,6 +3,7 @@ import { timeFormatLocale } from "d3-time-format";
3
3
  import { date } from "@d3plus/dom";
4
4
  import { dateFullFormatter, formatDateFull } from "@d3plus/format";
5
5
  import { locale } from "@d3plus/locales";
6
+ import { normalizeRangeBreaks, rangeBreakTest } from "./rangeBreaks.js";
6
7
  /**
7
8
  Parses a value (Date, timestamp, or date string) into a valid Date, or `undefined` when it does not parse.
8
9
  @private
@@ -22,12 +23,19 @@ import { locale } from "@d3plus/locales";
22
23
  @private
23
24
  */ export function axisScaleData(axis) {
24
25
  if (axis.schema.scale !== "time") return axis._data ?? [];
25
- const data = parseTimeValues(axis._data ?? []);
26
+ const data = visibleDates(axis, parseTimeValues(axis._data ?? []));
26
27
  const domain = (axis.schema.domain ?? []).map(parseTime);
27
28
  if (domain.length < 2 || domain.some((d)=>d === undefined)) return data;
28
29
  const [lo, hi] = extent(domain);
29
30
  return data.filter((d)=>d >= lo && d <= hi);
30
31
  }
32
+ /** Dates a time axis's `rangeBreaks` leave shown. */ function visibleDates(axis, dates) {
33
+ const rules = normalizeRangeBreaks(axis.schema.rangeBreaks);
34
+ if (!rules.length || !dates.length) return dates;
35
+ const [lo, hi] = extent(dates, Number);
36
+ const hidden = rangeBreakTest(rules, lo, hi);
37
+ return dates.filter((d)=>!hidden(d));
38
+ }
31
39
  /**
32
40
  The dates of a time axis's `data` inside its scale's domain: what the axis ticks, so a domain narrower than the data (a zoomed view) ticks the window it shows.
33
41
  @private
@@ -51,14 +59,21 @@ import { locale } from "@d3plus/locales";
51
59
  return axis.schema.timeLocale || locale[axis.schema.locale] || locale["en-US"];
52
60
  }
53
61
  /**
54
- The ordered Dates a time axis picks its label interval from: its parsed `data`, else its domain.
62
+ 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.
55
63
  @private
56
64
  */ export function axisTimeReference(axis) {
57
65
  const { _scaleData: data, schema: { domain } } = axis;
66
+ const scale = axis._d3Scale;
67
+ const range = scale?.range ? scale.range() : [];
58
68
  return axisMemo(axis, "timeReference", [
59
69
  data,
60
- domain
61
- ], ()=>parseTimeValues(data.length ? data : domain).sort((a, b)=>+a - +b));
70
+ domain,
71
+ scale,
72
+ ...range
73
+ ], ()=>{
74
+ const offered = !data.length && scale ? axis._getLabels() : [];
75
+ return parseTimeValues(data.length ? data : offered.length > 1 ? offered : domain).sort((a, b)=>+a - +b);
76
+ });
62
77
  }
63
78
  /**
64
79
  A date labeled to be read on its own (e.g. in a tooltip): the label interval the axis uses for its ticks (see `axisDateReference`), always with the year, in the axis's time locale.
@@ -1,26 +1,50 @@
1
1
  import { max } from "d3-array";
2
2
  import { select } from "d3-selection";
3
3
  import { transition } from "d3-transition";
4
- import { colorContrast } from "@d3plus/color";
5
- import { backgroundColor, elem } from "@d3plus/dom";
4
+ import { elem } from "@d3plus/dom";
6
5
  import { formatAbbreviate } from "@d3plus/format";
7
6
  import { Axis, TextBox } from "../index.js";
8
7
  import { Rect } from "../../shapes/index.js";
9
8
  import { accessor, BaseClass, paintComponentScene } from "../../utils/index.js";
10
9
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
10
+ import { inkText } from "../../utils/themeInk.js";
11
11
  import Legend from "../Legend/Legend.js";
12
+ import { inertAxis } from "../Axis/axisTooltipTargets.js";
12
13
  import { formatYear, isYearLike } from "../Axis/yearValues.js";
13
- import { bucketBounds } from "./bucketBounds.js";
14
+ import { bucketBounds, labelValue } from "./bucketBounds.js";
14
15
  import { computeColorScale } from "./colorScaleScale.js";
15
16
  import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
16
17
  import { isBucketScale } from "./colorScaleType.js";
17
18
  import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
19
+ import { swatchTooltips } from "./colorScaleSwatchTooltips.js";
20
+ import { renderBivariate } from "./bivariateRender.js";
18
21
  /** ColorScale's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const colorScaleSchema = [
19
22
  {
20
23
  key: "align",
21
24
  coerce: "identity",
22
25
  default: "middle"
23
26
  },
27
+ // A bivariate scale reads a pair of values from each row and draws its
28
+ // grid of colors as a diamond key (see bivariateRender.ts).
29
+ {
30
+ key: "bivariate",
31
+ coerce: "identity",
32
+ default: false
33
+ },
34
+ {
35
+ key: "bivariateBuckets",
36
+ coerce: "identity",
37
+ default: 3
38
+ },
39
+ // No default grid: an unset one paints Stevens' blue–red scheme.
40
+ {
41
+ key: "bivariateColors",
42
+ coerce: "identity"
43
+ },
44
+ {
45
+ key: "bivariateLabels",
46
+ coerce: "identity"
47
+ },
24
48
  {
25
49
  key: "buckets",
26
50
  coerce: "identity",
@@ -54,7 +78,8 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
54
78
  },
55
79
  // Unset poles fall back to `colorDefaults` at draw time: `sequential` (blue)
56
80
  // high, `light` midpoint, `off` (red) low — warm/cool poles that stay
57
- // distinct under color-vision deficiency.
81
+ // distinct under color-vision deficiency. A dark or custom theme supplies
82
+ // its `colorScale` tokens instead.
58
83
  {
59
84
  key: "colorMax",
60
85
  coerce: "identity"
@@ -96,6 +121,13 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
96
121
  coerce: "identity",
97
122
  default: 0
98
123
  },
124
+ // Holds a single-hue light-theme ramp's palest step darker (colorRamp's
125
+ // `ordinal` option), so the lowest values still read as thin lines.
126
+ {
127
+ key: "ordinalRamp",
128
+ coerce: "identity",
129
+ default: false
130
+ },
99
131
  {
100
132
  key: "orient",
101
133
  coerce: "identity",
@@ -135,6 +167,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
135
167
  /**
136
168
  Creates an SVG color scale based on an array of data.
137
169
  */ export default class ColorScale extends BaseClass {
170
+ static _displayName = "ColorScale";
138
171
  _select;
139
172
  _axisClass;
140
173
  _axisTest;
@@ -149,7 +182,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
149
182
  _rectClass;
150
183
  /** The scale the last render built, with a `scale` function resolved. */ _scaleType = "linear";
151
184
  /** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */ _barGeometry;
152
- /** The value marked on the scale, set with `hover()`. */ _hoverValue;
185
+ /** The value marked on the scale, set with `hover()`: a pair of values on a bivariate scale. */ _hoverValue;
186
+ /** The names a chart gives a bivariate scale's two variables (its field names), under `bivariateLabels`. */ _bivariateFields;
187
+ /** The bivariate key's nodes, laid out by the last render. */ _bivariateNodes;
188
+ /** Each swatch's legend row, with its bucket, set when the swatch variant renders. */ _swatchBuckets = new Map();
153
189
  /** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */ _gradientFill;
154
190
  // Standalone scene renderer (used when rendered on its own, not inside a
155
191
  // Viz). Reused across re-renders by paintComponentScene().
@@ -170,7 +206,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
170
206
  const last = i === ticks.length - 1;
171
207
  if (tick === ticks[i + 1] || last) {
172
208
  const suffix = last && tick < max(allValues) ? "+" : "";
173
- return `${format(tick)}${suffix}`;
209
+ return `${format(labelValue(tick, allValues))}${suffix}`;
174
210
  }
175
211
  const [lower, upper] = bucketBounds(tick, i, ticks, allValues, format);
176
212
  return this.schema.bucketJoiner(format(lower), format(upper));
@@ -178,13 +214,12 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
178
214
  this._data = [];
179
215
  this._labelClass = new TextBox();
180
216
  this.schema.labelConfig = {
181
- fontColor: ()=>{
182
- const bg = this._select ? backgroundColor(this._select.node()) : "rgb(255, 255, 255)";
183
- return colorContrast(bg, this.schema.colorDefaults);
184
- },
217
+ fontColor: ()=>inkText(this),
185
218
  fontSize: 12
186
219
  };
187
220
  this._legendClass = new Legend();
221
+ // Swatch labels that don't fit whole are cut short, not left out.
222
+ this._legendClass._cutLabels = true;
188
223
  this.schema.legendConfig = {
189
224
  shapeConfig: {
190
225
  stroke: ()=>this.schema.colorDefaults.dark,
@@ -216,8 +251,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
216
251
  this._group = elem("g.d3plus-ColorScale", {
217
252
  parent: this._select
218
253
  });
219
- const compute = computeColorScale(this);
220
- const gradient = this.schema.bucketAxis || !isBucketScale(compute.scale);
254
+ const bivariate = Boolean(this.schema.bivariate);
255
+ this._bivariateNodes = bivariate ? renderBivariate(this).nodes : undefined;
256
+ const compute = bivariate ? undefined : computeColorScale(this);
257
+ const gradient = !bivariate && (this.schema.bucketAxis || !isBucketScale(compute.scale));
221
258
  const t = transition().duration(this.schema.duration);
222
259
  const groupParams = {
223
260
  enter: {
@@ -239,7 +276,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
239
276
  condition: gradient
240
277
  }, groupParams));
241
278
  const legendGroup = elem("g.d3plus-ColorScale-legend", Object.assign({
242
- condition: !gradient
279
+ condition: !gradient && !bivariate
243
280
  }, groupParams));
244
281
  const groups = {
245
282
  labelGroup,
@@ -248,8 +285,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
248
285
  groupParams,
249
286
  gradient
250
287
  };
251
- if (gradient) renderGradient(this, compute, groups);
252
- else renderLegendVariant(this, compute, groups);
288
+ if (compute) {
289
+ if (gradient) renderGradient(this, compute, groups);
290
+ else renderLegendVariant(this, compute, groups);
291
+ }
253
292
  // Standalone render: paint the scene into the user's `_select`. Inside a
254
293
  // Viz the color scale runs in compute mode and the Viz composes its
255
294
  // toScene().
@@ -260,10 +299,13 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
260
299
  /**
261
300
  Produces a backend-agnostic scene graph for this ColorScale with no DOM
262
301
  dependency. The discrete variant (jenks/buckets/quantile) delegates to the
263
- internal Legend's toScene(); the gradient variant composes the Rect, Axis,
264
- and label TextBox scenes. The scaleGroup's translate (set by the chart's
265
- colorScale feature on `g.d3plus-viz-colorScale`) is read off `_select` so
266
- the content lands at its on-screen position.
302
+ internal Legend's toScene(), its title and swatch labels taking the axis
303
+ tooltips (see `swatchTooltips`); the gradient variant composes the Rect,
304
+ Axis, and label TextBox scenes, all as chrome (see `inertAxis`): only an
305
+ axis label with a tooltip takes the pointer. The scaleGroup's
306
+ translate (set by the chart's colorScale feature on
307
+ `g.d3plus-viz-colorScale`) is read off `_select` so the content lands at
308
+ its on-screen position.
267
309
 
268
310
  A smooth (non-bucketed) gradient paints its Rect with a `gradient:<json>`
269
311
  fill token (see renderGradientStops); the backend materializes it into a
@@ -272,18 +314,26 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
272
314
  */ toScene() {
273
315
  const children = [];
274
316
  const gradient = this.schema.bucketAxis || !isBucketScale(this._scaleType);
275
- const pushScene = (cls)=>{
317
+ const pushScene = (cls, finish = (scene)=>scene)=>{
276
318
  if (cls && typeof cls.toScene === "function") {
277
319
  const s = cls.toScene();
278
- if (s) children.push(s);
320
+ if (s) children.push(finish(s));
279
321
  }
280
322
  };
281
- if (gradient) {
282
- pushScene(this._rectClass);
283
- pushScene(this._axisClass);
284
- pushScene(this._labelClass);
323
+ if (this._bivariateNodes) {
324
+ children.push(...this._bivariateNodes);
325
+ } else if (gradient) {
326
+ pushScene(this._rectClass, inertAxis);
327
+ pushScene(this._axisClass, inertAxis);
328
+ pushScene(this._labelClass, inertAxis);
285
329
  } else {
286
- pushScene(this._legendClass);
330
+ pushScene(this._legendClass, (scene)=>swatchTooltips(scene, {
331
+ title: this._legendClass.schema.title,
332
+ titleDatum: this._legendClass._titleClass.data()[0],
333
+ titleTooltip: this.schema.axisConfig.titleTooltip,
334
+ tickTooltip: this.schema.axisConfig.tickTooltip,
335
+ buckets: this._swatchBuckets
336
+ }));
287
337
  }
288
338
  // Preserve the placement of the scaleGroup the chart's colorScale feature
289
339
  // positioned (translate on `g.d3plus-viz-colorScale`).
@@ -307,7 +357,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
307
357
  } : {},
308
358
  children
309
359
  };
310
- addHoverMark(this, group);
360
+ if (!this._bivariateNodes) addHoverMark(this, group);
311
361
  return group;
312
362
  }
313
363
  axisConfig(_) {