@d3plus/core 4.10.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 (548) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +167 -8
  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 +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 +3 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +2 -1
  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 +162 -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 +132 -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 +204 -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 +3 -3
  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/Network/applyLayout.js +138 -94
  70. package/es/src/charts/Network/bundle.js +81 -0
  71. package/es/src/charts/Network/clusterLabels.js +423 -0
  72. package/es/src/charts/Network/clusters.js +290 -0
  73. package/es/src/charts/Network/emit.js +253 -70
  74. package/es/src/charts/Network/graph.js +117 -0
  75. package/es/src/charts/Network/graphFluent.js +79 -0
  76. package/es/src/charts/Network/index.js +86 -106
  77. package/es/src/charts/Network/minNodeDistance.js +64 -0
  78. package/es/src/charts/Network/polygonRows.js +44 -0
  79. package/es/src/charts/Pack/index.js +5 -1
  80. package/es/src/charts/Pie/applyLayout.js +86 -27
  81. package/es/src/charts/Pie/arcFit.js +152 -0
  82. package/es/src/charts/Pie/curvedLabels.js +134 -0
  83. package/es/src/charts/Pie/emit.js +43 -96
  84. package/es/src/charts/Pie/index.js +64 -31
  85. package/es/src/charts/Pie/labelRoom.js +154 -0
  86. package/es/src/charts/Pie/outsideLabels.js +224 -0
  87. package/es/src/charts/Pie/outsideNodes.js +267 -0
  88. package/es/src/charts/Pie/pieLabels.js +137 -0
  89. package/es/src/charts/Pie/sectorBox.js +223 -0
  90. package/es/src/charts/Pie/straightLabels.js +96 -0
  91. package/es/src/charts/Pie/straightLayout.js +215 -0
  92. package/es/src/charts/Plot/alongLegend.js +76 -0
  93. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  94. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  95. package/es/src/charts/Plot/axisValues.js +43 -0
  96. package/es/src/charts/Plot/barWidth.js +59 -11
  97. package/es/src/charts/Plot/circleLabels.js +98 -0
  98. package/es/src/charts/Plot/connectGaps.js +237 -0
  99. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  100. package/es/src/charts/Plot/draw.js +8 -2
  101. package/es/src/charts/Plot/fillBetween.js +2 -1
  102. package/es/src/charts/Plot/forecastScene.js +3 -4
  103. package/es/src/charts/Plot/index.js +18 -10
  104. package/es/src/charts/Plot/labelPlacement.js +1 -1
  105. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  106. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  107. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  108. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  109. package/es/src/charts/Plot/pipeline.js +66 -19
  110. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  111. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  112. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  113. package/es/src/charts/Plot/pipelineScales.js +40 -8
  114. package/es/src/charts/Plot/plotFacet.js +12 -1
  115. package/es/src/charts/Plot/plotInit.js +34 -5
  116. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  117. package/es/src/charts/Plot/referenceDomains.js +133 -0
  118. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  119. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  120. package/es/src/charts/Plot/trendLabels.js +183 -0
  121. package/es/src/charts/Plot/trendLines.js +1 -0
  122. package/es/src/charts/Plot/trendScene.js +6 -3
  123. package/es/src/charts/Plot/trendTooltip.js +5 -1
  124. package/es/src/charts/PolarArea/index.js +2 -2
  125. package/es/src/charts/Priestley/applyLayout.js +14 -20
  126. package/es/src/charts/Priestley/index.js +4 -35
  127. package/es/src/charts/Priestley/timeAxis.js +100 -0
  128. package/es/src/charts/Radar/axisDecorations.js +49 -12
  129. package/es/src/charts/Radar/curvedLabels.js +187 -0
  130. package/es/src/charts/Radar/index.js +2 -3
  131. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  132. package/es/src/charts/RadialBar/emit.js +4 -1
  133. package/es/src/charts/RadialBar/index.js +16 -9
  134. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  135. package/es/src/charts/RadialMatrix/index.js +3 -7
  136. package/es/src/charts/Rings/applyLayout.js +41 -24
  137. package/es/src/charts/Rings/emit.js +174 -58
  138. package/es/src/charts/Rings/index.js +61 -28
  139. package/es/src/charts/Rings/ringsGraph.js +28 -9
  140. package/es/src/charts/Rings/ringsLoops.js +73 -0
  141. package/es/src/charts/Rings/ringsParallel.js +166 -0
  142. package/es/src/charts/Sankey/applyLayout.js +116 -39
  143. package/es/src/charts/Sankey/circularLayout.js +208 -0
  144. package/es/src/charts/Sankey/circularLinks.js +301 -0
  145. package/es/src/charts/Sankey/emit.js +164 -94
  146. package/es/src/charts/Sankey/index.js +72 -75
  147. package/es/src/charts/Sankey/labels.js +80 -0
  148. package/es/src/charts/Sankey/ribbons.js +88 -0
  149. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  150. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  151. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  152. package/es/src/charts/Scatter/index.js +25 -0
  153. package/es/src/charts/SlopeChart/index.js +116 -0
  154. package/es/src/charts/SlopeChart/slope.js +95 -0
  155. package/es/src/charts/Streamgraph/index.js +51 -0
  156. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  157. package/es/src/charts/Sunburst/emit.js +74 -63
  158. package/es/src/charts/Sunburst/index.js +3 -3
  159. package/es/src/charts/Tree/index.js +2 -6
  160. package/es/src/charts/Treemap/index.js +2 -5
  161. package/es/src/charts/Violin/inner.js +3 -5
  162. package/es/src/charts/definition/makeChart.js +10 -2
  163. package/es/src/charts/drawSteps/backControl.js +17 -5
  164. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  165. package/es/src/charts/drawSteps/minimap.js +6 -5
  166. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  167. package/es/src/charts/drawSteps/searchControls.js +2 -1
  168. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  169. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  170. package/es/src/charts/drawSteps/zoomControls.js +21 -5
  171. package/es/src/charts/events/click.legend.js +7 -2
  172. package/es/src/charts/events/click.shape.js +8 -1
  173. package/es/src/charts/events/mousemove.shape.js +5 -2
  174. package/es/src/charts/facet/drawFacets.js +14 -5
  175. package/es/src/charts/features/annotationFrame.js +179 -0
  176. package/es/src/charts/features/annotationText.js +83 -0
  177. package/es/src/charts/features/annotationTypes.js +10 -0
  178. package/es/src/charts/features/attributionFeature.js +6 -11
  179. package/es/src/charts/features/axes.js +2 -1
  180. package/es/src/charts/features/axesFinal.js +3 -1
  181. package/es/src/charts/features/axesMeasure.js +7 -4
  182. package/es/src/charts/features/calloutLayout.js +121 -0
  183. package/es/src/charts/features/calloutScene.js +155 -0
  184. package/es/src/charts/features/chartGeometry.js +1 -1
  185. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  186. package/es/src/charts/features/circleLabels.js +207 -0
  187. package/es/src/charts/features/colorScaleBucket.js +2 -1
  188. package/es/src/charts/features/colorScaleHover.js +3 -2
  189. package/es/src/charts/features/colorScaleValue.js +97 -0
  190. package/es/src/charts/features/curvedArrows.js +158 -0
  191. package/es/src/charts/features/edgeArrows.js +160 -4
  192. package/es/src/charts/features/edgeBundling.js +442 -0
  193. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  194. package/es/src/charts/features/ensureZoomDom.js +32 -8
  195. package/es/src/charts/features/features.js +32 -14
  196. package/es/src/charts/features/featuresColorScale.js +20 -6
  197. package/es/src/charts/features/featuresLegend.js +15 -24
  198. package/es/src/charts/features/legendKeys.js +64 -0
  199. package/es/src/charts/features/lineLabels.js +55 -46
  200. package/es/src/charts/features/linkBundle.js +19 -0
  201. package/es/src/charts/features/linkColor.js +72 -0
  202. package/es/src/charts/features/linkFields.js +86 -0
  203. package/es/src/charts/features/linkFocus.js +118 -0
  204. package/es/src/charts/features/linkInteraction.js +312 -0
  205. package/es/src/charts/features/linkKeys.js +20 -0
  206. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  207. package/es/src/charts/features/linkLabelPath.js +162 -0
  208. package/es/src/charts/features/linkLabels.js +340 -0
  209. package/es/src/charts/features/linkWidths.js +32 -0
  210. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  211. package/es/src/charts/features/pathLabels.js +50 -0
  212. package/es/src/charts/features/plotAnnotations.js +68 -17
  213. package/es/src/charts/features/plotPaint.js +38 -11
  214. package/es/src/charts/features/polyline.js +129 -0
  215. package/es/src/charts/features/referenceAnnotations.js +403 -0
  216. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  217. package/es/src/charts/features/ringLabelNodes.js +93 -0
  218. package/es/src/charts/features/ringLabels.js +222 -0
  219. package/es/src/charts/features/sceneBounds.js +26 -6
  220. package/es/src/charts/features/selfLoops.js +306 -0
  221. package/es/src/charts/features/shapeEmit.js +47 -31
  222. package/es/src/charts/features/sharedFields.js +15 -2
  223. package/es/src/charts/features/textHalo.js +29 -0
  224. package/es/src/charts/index.js +8 -0
  225. package/es/src/charts/partition/chartFields.js +2 -2
  226. package/es/src/charts/partition/interaction.js +9 -5
  227. package/es/src/charts/partition/zoom.js +7 -6
  228. package/es/src/charts/pipeline/insetPlacement.js +14 -6
  229. package/es/src/charts/pipeline/preDrawData.js +46 -3
  230. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  231. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  232. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  233. package/es/src/charts/polar/config.js +2 -3
  234. package/es/src/charts/viz/Viz.js +39 -36
  235. package/es/src/charts/viz/VizBase.js +18 -10
  236. package/es/src/charts/viz/backgroundInk.js +13 -7
  237. package/es/src/charts/viz/focusRing.js +104 -0
  238. package/es/src/charts/viz/focusTargets.js +208 -0
  239. package/es/src/charts/viz/history.js +74 -0
  240. package/es/src/charts/viz/keyboardNav.js +297 -0
  241. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  242. package/es/src/charts/viz/loaderFormat.js +114 -0
  243. package/es/src/charts/viz/missingFields.js +2 -1
  244. package/es/src/charts/viz/mountTarget.js +9 -0
  245. package/es/src/charts/viz/nearestHover.js +183 -0
  246. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  247. package/es/src/charts/viz/ordinalColor.js +14 -12
  248. package/es/src/charts/viz/pageTheme.js +83 -0
  249. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  250. package/es/src/charts/viz/pointVoronoi.js +124 -0
  251. package/es/src/charts/viz/reducedMotion.js +27 -0
  252. package/es/src/charts/viz/vizDataPolling.js +8 -3
  253. package/es/src/charts/viz/vizDefaults.js +15 -23
  254. package/es/src/charts/viz/vizFields.js +35 -0
  255. package/es/src/charts/viz/vizRender.js +43 -28
  256. package/es/src/charts/viz/vizTheme.js +96 -0
  257. package/es/src/charts/viz/vizVisibility.js +14 -0
  258. package/es/src/components/Axis/Axis.js +6 -0
  259. package/es/src/components/Axis/AxisBottom.js +1 -0
  260. package/es/src/components/Axis/AxisLeft.js +1 -0
  261. package/es/src/components/Axis/AxisRight.js +1 -0
  262. package/es/src/components/Axis/AxisTop.js +1 -0
  263. package/es/src/components/Axis/axisBreak.js +4 -1
  264. package/es/src/components/Axis/axisDefaults.js +5 -9
  265. package/es/src/components/Axis/axisLayoutScale.js +7 -1
  266. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  267. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  268. package/es/src/components/Axis/rangeBreaks.js +201 -0
  269. package/es/src/components/Axis/timeValues.js +19 -4
  270. package/es/src/components/ColorScale/ColorScale.js +15 -9
  271. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  272. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  273. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  274. package/es/src/components/Legend/Legend.js +3 -0
  275. package/es/src/components/Legend/legendConfig.js +2 -6
  276. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  277. package/es/src/components/TextBox.js +29 -65
  278. package/es/src/components/Timeline/Timeline.js +12 -3
  279. package/es/src/components/Timeline/timelineConfig.js +20 -10
  280. package/es/src/components/Timeline/timelineMode.js +26 -0
  281. package/es/src/components/Timeline/timelineRender.js +7 -3
  282. package/es/src/components/Tooltip.js +15 -5
  283. package/es/src/components/fontStack.js +20 -0
  284. package/es/src/components/textBoxLayout.js +58 -21
  285. package/es/src/components/textBoxPath.js +73 -0
  286. package/es/src/components/textBoxScene.js +223 -0
  287. package/es/src/components/textBoxWords.js +70 -0
  288. package/es/src/shapes/Area.js +1 -0
  289. package/es/src/shapes/Bar.js +1 -0
  290. package/es/src/shapes/Box.js +1 -0
  291. package/es/src/shapes/Circle.js +1 -0
  292. package/es/src/shapes/Line.js +1 -0
  293. package/es/src/shapes/Path.js +1 -0
  294. package/es/src/shapes/Rect.js +1 -0
  295. package/es/src/shapes/Shape.js +1 -0
  296. package/es/src/shapes/Whisker.js +1 -0
  297. package/es/src/utils/BaseClass.js +25 -12
  298. package/es/src/utils/configPrep.js +2 -1
  299. package/es/src/utils/constant.js +13 -1
  300. package/es/src/utils/displayName.js +12 -0
  301. package/es/src/utils/theme.js +190 -0
  302. package/es/src/utils/themeInk.js +68 -0
  303. package/package.json +14 -11
  304. package/types/index.d.ts +6 -2
  305. package/types/internal.d.ts +250 -8
  306. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  307. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  308. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  309. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  310. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  311. package/types/src/charts/Alluvial/index.d.ts +27 -0
  312. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  313. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  314. package/types/src/charts/Alluvial/titles.d.ts +33 -0
  315. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  316. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  317. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  318. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  319. package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
  320. package/types/src/charts/ArcDiagram/events.d.ts +28 -0
  321. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  322. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  323. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  324. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  325. package/types/src/charts/Chord/labels.d.ts +66 -0
  326. package/types/src/charts/Donut/index.d.ts +2 -1
  327. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  328. package/types/src/charts/Gantt/emit.d.ts +17 -0
  329. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  330. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  331. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  332. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  333. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  334. package/types/src/charts/Gantt/index.d.ts +36 -0
  335. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  336. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  337. package/types/src/charts/Geomap/emit.d.ts +2 -2
  338. package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
  339. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  340. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  341. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  342. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  343. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  344. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  345. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  346. package/types/src/charts/Geomap/index.d.ts +3 -0
  347. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  348. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  349. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  350. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  351. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  352. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  353. package/types/src/charts/Hexbin/index.d.ts +25 -0
  354. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  355. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  356. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  357. package/types/src/charts/Histogram/binData.d.ts +20 -1
  358. package/types/src/charts/Histogram/index.d.ts +3 -2
  359. package/types/src/charts/Histogram/labels.d.ts +7 -0
  360. package/types/src/charts/Marimekko/index.d.ts +2 -1
  361. package/types/src/charts/Network/bundle.d.ts +67 -0
  362. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  363. package/types/src/charts/Network/clusters.d.ts +115 -0
  364. package/types/src/charts/Network/graph.d.ts +65 -0
  365. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  366. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  367. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  368. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  369. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  370. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  371. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  372. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  373. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  374. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  375. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  376. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  377. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  378. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  379. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  380. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  381. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  382. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  383. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  384. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  385. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  386. package/types/src/charts/Plot/index.d.ts +15 -8
  387. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  388. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  389. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  390. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  391. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  392. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  393. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  394. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  395. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  396. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  397. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  398. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  399. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  400. package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
  401. package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
  402. package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
  403. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  404. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  405. package/types/src/charts/Rings/emit.d.ts +50 -0
  406. package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
  407. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  408. package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
  409. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  410. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  411. package/types/src/charts/Sankey/emit.d.ts +58 -0
  412. package/types/src/charts/Sankey/labels.d.ts +19 -0
  413. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  414. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  415. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  416. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  417. package/types/src/charts/Scatter/index.d.ts +15 -0
  418. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  419. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  420. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  421. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  422. package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
  423. package/types/src/charts/definition/makeChart.d.ts +3 -2
  424. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  425. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  426. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  427. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  428. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  429. package/types/src/charts/events/click.legend.d.ts +2 -1
  430. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  431. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  432. package/types/src/charts/features/annotationText.d.ts +57 -0
  433. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  434. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  435. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  436. package/types/src/charts/features/calloutScene.d.ts +40 -0
  437. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  438. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  439. package/types/src/charts/features/circleLabels.d.ts +130 -0
  440. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  441. package/types/src/charts/features/curvedArrows.d.ts +105 -0
  442. package/types/src/charts/features/edgeArrows.d.ts +74 -2
  443. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  444. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  445. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  446. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  447. package/types/src/charts/features/legendKeys.d.ts +34 -0
  448. package/types/src/charts/features/lineLabels.d.ts +15 -12
  449. package/types/src/charts/features/linkBundle.d.ts +16 -0
  450. package/types/src/charts/features/linkColor.d.ts +48 -0
  451. package/types/src/charts/features/linkFields.d.ts +16 -0
  452. package/types/src/charts/features/linkFocus.d.ts +51 -0
  453. package/types/src/charts/features/linkInteraction.d.ts +183 -0
  454. package/types/src/charts/features/linkKeys.d.ts +11 -0
  455. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  456. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  457. package/types/src/charts/features/linkLabels.d.ts +77 -0
  458. package/types/src/charts/features/linkWidths.d.ts +19 -0
  459. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  460. package/types/src/charts/features/pathLabels.d.ts +41 -0
  461. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  462. package/types/src/charts/features/plotPaint.d.ts +17 -0
  463. package/types/src/charts/features/polyline.d.ts +32 -0
  464. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  465. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  466. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  467. package/types/src/charts/features/ringLabels.d.ts +164 -0
  468. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  469. package/types/src/charts/features/selfLoops.d.ts +165 -0
  470. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  471. package/types/src/charts/features/sharedFields.d.ts +11 -2
  472. package/types/src/charts/features/textHalo.d.ts +14 -0
  473. package/types/src/charts/index.d.ts +8 -0
  474. package/types/src/charts/partition/interaction.d.ts +6 -3
  475. package/types/src/charts/partition/zoom.d.ts +4 -4
  476. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  477. package/types/src/charts/pipeline/stages.d.ts +7 -0
  478. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  479. package/types/src/charts/viz/Viz.d.ts +16 -2
  480. package/types/src/charts/viz/VizBase.d.ts +6 -6
  481. package/types/src/charts/viz/backgroundInk.d.ts +11 -4
  482. package/types/src/charts/viz/focusRing.d.ts +25 -0
  483. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  484. package/types/src/charts/viz/history.d.ts +35 -0
  485. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  486. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  487. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  488. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  489. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  490. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  491. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  492. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  493. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  494. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  495. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  496. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  497. package/types/src/charts/viz/vizFields.d.ts +32 -0
  498. package/types/src/charts/viz/vizRender.d.ts +2 -1
  499. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  500. package/types/src/charts/viz/vizTypes.d.ts +84 -7
  501. package/types/src/charts/viz/vizVisibility.d.ts +6 -0
  502. package/types/src/components/Axis/Axis.d.ts +1 -0
  503. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  504. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  505. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  506. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  507. package/types/src/components/Axis/axisBreak.d.ts +2 -0
  508. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  509. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  510. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  511. package/types/src/components/Axis/timeValues.d.ts +1 -1
  512. package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
  513. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  514. package/types/src/components/Legend/Legend.d.ts +1 -0
  515. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  516. package/types/src/components/TextBox.d.ts +1 -0
  517. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  518. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  519. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  520. package/types/src/components/Tooltip.d.ts +4 -3
  521. package/types/src/components/fontStack.d.ts +10 -0
  522. package/types/src/components/textBoxLayout.d.ts +18 -9
  523. package/types/src/components/textBoxPath.d.ts +59 -0
  524. package/types/src/components/textBoxScene.d.ts +51 -0
  525. package/types/src/components/textBoxWords.d.ts +33 -0
  526. package/types/src/shapes/Area.d.ts +1 -0
  527. package/types/src/shapes/Bar.d.ts +1 -0
  528. package/types/src/shapes/Box.d.ts +1 -0
  529. package/types/src/shapes/Circle.d.ts +1 -0
  530. package/types/src/shapes/Line.d.ts +1 -0
  531. package/types/src/shapes/Path.d.ts +1 -0
  532. package/types/src/shapes/Rect.d.ts +1 -0
  533. package/types/src/shapes/Shape.d.ts +1 -0
  534. package/types/src/shapes/Whisker.d.ts +1 -0
  535. package/types/src/utils/BaseClass.d.ts +9 -0
  536. package/types/src/utils/D3plusConfig.d.ts +981 -30
  537. package/types/src/utils/configPrep.d.ts +2 -0
  538. package/types/src/utils/constant.d.ts +8 -0
  539. package/types/src/utils/displayName.d.ts +10 -0
  540. package/types/src/utils/index.d.ts +1 -1
  541. package/types/src/utils/theme.d.ts +170 -0
  542. package/types/src/utils/themeInk.d.ts +56 -0
  543. package/umd/d3plus-core.full.js +86811 -61031
  544. package/umd/d3plus-core.full.min.js +2 -2
  545. package/umd/d3plus-core.js +28392 -6498
  546. package/umd/d3plus-core.min.js +2 -2
  547. package/es/src/components/Axis/gridStroke.js +0 -10
  548. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -6,6 +6,7 @@ import RESET from "./RESET.js";
6
6
  import { containsReset, isPlainObject, mergeConfigBag, resolvesReset, RESOLVES_RESET } from "../fluent.js";
7
7
  import { isSharedConfig, warnUnknownConfig } from "./configWarnings.js";
8
8
  import { applyClassName, RENDERER_CLASSES, rendererSurfaces } from "./className.js";
9
+ import { displayName } from "./displayName.js";
9
10
  /**
10
11
  Swaps every nested `RESET` in a config value for the matching entry of
11
12
  `defaults`, dropping the key when that default is `undefined`. Objects
@@ -27,6 +28,19 @@ import { applyClassName, RENDERER_CLASSES, rendererSurfaces } from "./className.
27
28
  }
28
29
  return out;
29
30
  }
31
+ /** Public methods that are not config accessors, left out of `getAllMethods`. */ const REFLECT_SKIP = new Set([
32
+ "config",
33
+ "constructor",
34
+ "destroy",
35
+ "layout",
36
+ "measure",
37
+ "parent",
38
+ "render",
39
+ "renderMode",
40
+ "toCanvas",
41
+ "toSVGString",
42
+ "toScene"
43
+ ]);
30
44
  /**
31
45
  finds all prototype methods of a class and it's parent classes
32
46
  @param obj
@@ -40,17 +54,10 @@ import { applyClassName, RENDERER_CLASSES, rendererSurfaces } from "./className.
40
54
  return props.filter((e)=>e.indexOf("_") !== 0 && // Side-effect/lifecycle methods excluded from config reflection: invoking
41
55
  // them as no-arg getters would run real work. `measure` runs the full
42
56
  // axis-layout pass; `destroy` tears down the scene renderer (which defeats
43
- // keyed reconcile and forces a full remount on the next draw).
44
- ![
45
- "config",
46
- "constructor",
47
- "destroy",
48
- "measure",
49
- "parent",
50
- "render",
51
- "renderMode",
52
- "toScene"
53
- ].includes(e));
57
+ // keyed reconcile and forces a full remount on the next draw);
58
+ // `toSVGString` serializes the drawn chart (through a throwaway SVG
59
+ // backend on Canvas), and `layout` recomputes a SizeLegend's layout.
60
+ !REFLECT_SKIP.has(e));
54
61
  }
55
62
  /**
56
63
  Merges color overrides into an instance and every BaseClass it owns (own
@@ -74,6 +81,11 @@ import { applyClassName, RENDERER_CLASSES, rendererSurfaces } from "./className.
74
81
  /**
75
82
  Provides shared configuration, event handling, and locale management inherited by all d3plus classes.
76
83
  */ export default class BaseClass {
84
+ /**
85
+ The class's name as written in the source, for messages that name it:
86
+ a minifier renames classes (a Legend can become `Ch`). Every class
87
+ states its own; see `displayName`.
88
+ */ static _displayName = "BaseClass";
77
89
  /**
78
90
  Post-coercion fluent storage (`.sum(...)`, `.x(...)`, …). `any` is
79
91
  deliberate and load-bearing: `installFluent` coerces accessor/const
@@ -86,6 +98,7 @@ import { applyClassName, RENDERER_CLASSES, rendererSurfaces } from "./className.
86
98
  /** Chart-internal scratch (d3 layout instances, computed derived state). */ ctx;
87
99
  _uuid;
88
100
  _configDefault;
101
+ /** The theme of the chart this instance draws in, for its latest draw. */ _theme;
89
102
  /**
90
103
  Invoked when creating a new class instance, and sets any default parameters.
91
104
  @private
@@ -118,7 +131,7 @@ import { applyClassName, RENDERER_CLASSES, rendererSurfaces } from "./className.
118
131
  else if (v === RESET) setter.call(this, defaults[k]);
119
132
  else setter.call(this, nestedReset(v, defaults[k]));
120
133
  } else if (!isSharedConfig(_)) {
121
- warnUnknownConfig(`${this.constructor.name}.config()`, k);
134
+ warnUnknownConfig(`${displayName(this)}.config()`, k);
122
135
  }
123
136
  }
124
137
  }
@@ -1,4 +1,5 @@
1
1
  import { markSharedConfig } from "./configWarnings.js";
2
+ import { effectiveDuration } from "../charts/viz/reducedMotion.js";
2
3
  /**
3
4
  Preps a config object for d3plus data, and optionally bubbles up a specific nested type. When using this function, you must bind a d3plus class' `this` context.
4
5
  @param config The configuration object to parse.
@@ -6,7 +7,7 @@ import { markSharedConfig } from "./configWarnings.js";
6
7
  @param nest An optional nested key to bubble up to the parent config level.
7
8
  */ export default function configPrep(config = this.schema.shapeConfig, type = "shape", nest = false) {
8
9
  const newConfig = {
9
- duration: this.schema.duration,
10
+ duration: effectiveDuration(this),
10
11
  on: {}
11
12
  };
12
13
  const wrapFunction = (func)=>(d, i, s, e)=>{
@@ -1,3 +1,4 @@
1
+ /** The value each function `constant` returns. */ const constants = new WeakMap();
1
2
  /**
2
3
  Wraps non-function variables in a simple return function.
3
4
  @param value The value to wrap in a return function.
@@ -8,7 +9,18 @@ function() {
8
9
  return 42;
9
10
  }
10
11
  */ export default function(value) {
11
- return function constant() {
12
+ const fn = function constant() {
12
13
  return value;
13
14
  };
15
+ constants.set(fn, {
16
+ value
17
+ });
18
+ return fn;
19
+ }
20
+ /**
21
+ The value `fn` returns whatever it is called with, when `fn` came from
22
+ `constant`; undefined otherwise.
23
+ @param fn The function to look up.
24
+ */ export function constantValue(fn) {
25
+ return typeof fn === "function" ? constants.get(fn) : undefined;
14
26
  }
@@ -0,0 +1,12 @@
1
+ /**
2
+ The class name of a d3plus instance as written in the source, for messages
3
+ that name it: a minifier renames classes, so each class states its name in
4
+ a static `_displayName` (a chart made with `makeChart` is named after its
5
+ definition). Only the class's own `_displayName` counts, so a subclass that
6
+ doesn't state one goes by its own name rather than its parent's.
7
+ @param instance A chart, component, or shape.
8
+ @private
9
+ */ export function displayName(instance) {
10
+ const ctor = instance.constructor;
11
+ return Object.prototype.hasOwnProperty.call(ctor, "_displayName") ? ctor._displayName : ctor.name;
12
+ }
@@ -0,0 +1,190 @@
1
+ import { lab, rgb } from "d3-color";
2
+ import { colorContrast, colorDefaults, colorGray, colorRamp, colorRampDark } from "@d3plus/color";
3
+ /** The light theme's tokens. */ export const themeLight = Object.freeze({
4
+ background: "#ffffff",
5
+ text: colorDefaults.dark,
6
+ textMuted: "#767676",
7
+ axis: colorDefaults.dark,
8
+ gridline: colorGray[200],
9
+ accent: "#228be6",
10
+ hidden: "#aaa",
11
+ link: colorGray[500],
12
+ colorScale: Object.freeze({
13
+ max: colorDefaults.sequential,
14
+ mid: colorDefaults.light,
15
+ min: colorDefaults.off
16
+ }),
17
+ tooltip: Object.freeze({
18
+ background: colorDefaults.light,
19
+ text: colorDefaults.dark,
20
+ border: "rgba(0, 0, 0, 0.25)",
21
+ shadow: "0 1px 5px rgba(0, 0, 0, 0.25)",
22
+ divider: "rgba(0, 0, 0, 0.1)"
23
+ }),
24
+ overlay: Object.freeze({
25
+ background: "rgba(255, 255, 255, 0.75)",
26
+ text: "rgba(0, 0, 0, 0.75)",
27
+ border: "rgba(0, 0, 0, 0.25)"
28
+ }),
29
+ table: Object.freeze({
30
+ background: "#fff",
31
+ text: colorGray[900],
32
+ header: "#fff",
33
+ border: "#ccc",
34
+ rule: "#e0e0e0"
35
+ })
36
+ });
37
+ /** The dark theme's tokens. */ export const themeDark = Object.freeze({
38
+ background: colorGray[900],
39
+ text: colorDefaults.light,
40
+ textMuted: colorGray[500],
41
+ axis: colorDefaults.light,
42
+ gridline: colorGray[800],
43
+ accent: "#4dabf7",
44
+ hidden: colorGray[600],
45
+ link: colorGray[700],
46
+ colorScale: Object.freeze({
47
+ max: "#4dabf7",
48
+ mid: colorGray[800],
49
+ min: "#ff6b6b"
50
+ }),
51
+ tooltip: Object.freeze({
52
+ background: colorGray[800],
53
+ text: colorDefaults.light,
54
+ border: "rgba(255, 255, 255, 0.2)",
55
+ shadow: "0 1px 5px rgba(0, 0, 0, 0.6)",
56
+ divider: "rgba(255, 255, 255, 0.15)"
57
+ }),
58
+ overlay: Object.freeze({
59
+ background: "rgba(24, 25, 28, 0.75)",
60
+ text: "rgba(255, 255, 255, 0.85)",
61
+ border: "rgba(255, 255, 255, 0.25)"
62
+ }),
63
+ table: Object.freeze({
64
+ background: colorGray[900],
65
+ text: colorDefaults.light,
66
+ header: colorGray[900],
67
+ border: colorGray[700],
68
+ rule: colorGray[800]
69
+ })
70
+ });
71
+ /** Whether a CSS color reads as dark (CIELAB lightness under 50). */ export function isDarkColor(value) {
72
+ const l = lab(value).l;
73
+ return Number.isFinite(l) && l < 50;
74
+ }
75
+ /**
76
+ A CSS color at a given opacity, ignoring its own (`withOpacity("rgba(0, 0,
77
+ 0, 0.75)", 0.15)` is `rgba(0, 0, 0, 0.15)`).
78
+ */ export function withOpacity(value, opacity) {
79
+ const c = rgb(value);
80
+ c.opacity = opacity;
81
+ return c.formatRgb();
82
+ }
83
+ /** Whether a value is a custom theme object. */ const isThemeConfig = (value)=>typeof value === "object" && value !== null && !Array.isArray(value);
84
+ /**
85
+ Resolves a `theme` setting into the tokens one draw uses. `"auto"` (and
86
+ anything unrecognized) follows the page: the preset matching its dark
87
+ state, with the page's own background and text that contrasts with it
88
+ (picked from `ink`, the chart's `colorDefaults`). Every other setting
89
+ paints its background, and a custom object layers its tokens over the
90
+ preset its `base` names.
91
+ @param setting The chart's `theme`.
92
+ @param page The page behind the chart.
93
+ @param ink The dark and light text colors auto mode picks between.
94
+ */ export function resolveTheme(setting, page = {
95
+ dark: false
96
+ }, ink = {}) {
97
+ if (setting === "light" || setting === "dark" || isThemeConfig(setting)) {
98
+ const custom = isThemeConfig(setting) ? setting : {};
99
+ const dark = setting === "dark" || custom.base === "dark" || !custom.base && typeof custom.background === "string" && isDarkColor(custom.background);
100
+ const preset = dark ? themeDark : themeLight;
101
+ const { colorScale, tooltip, overlay, table, ...flat } = custom;
102
+ delete flat.base;
103
+ return Object.freeze({
104
+ ...preset,
105
+ ...flat,
106
+ colorScale: {
107
+ ...preset.colorScale,
108
+ ...colorScale
109
+ },
110
+ tooltip: {
111
+ ...preset.tooltip,
112
+ ...tooltip
113
+ },
114
+ overlay: {
115
+ ...preset.overlay,
116
+ ...overlay
117
+ },
118
+ table: {
119
+ ...preset.table,
120
+ ...table
121
+ },
122
+ dark,
123
+ painted: true
124
+ });
125
+ }
126
+ const preset = page.dark ? themeDark : themeLight;
127
+ const background = page.background ?? preset.background;
128
+ const darkInk = ink.dark || colorDefaults.dark;
129
+ const text = colorContrast(background, ink);
130
+ return Object.freeze({
131
+ ...preset,
132
+ background,
133
+ text,
134
+ axis: text,
135
+ gridline: text === darkInk ? colorGray[200] : colorGray[800],
136
+ dark: page.dark,
137
+ painted: false
138
+ });
139
+ }
140
+ /**
141
+ A token for a color the chart has its own default for: that default while
142
+ the token matches the light preset, and the token once a dark or custom
143
+ theme changes it. Keeps every light chart looking as it does unthemed.
144
+ @param theme The resolved theme, when the chart has drawn.
145
+ @param pick Reads the token from a token set.
146
+ @param fallback The chart's own default.
147
+ */ export function themed(theme, pick, fallback) {
148
+ if (!theme) return fallback;
149
+ const value = pick(theme);
150
+ return value === pick(themeLight) ? fallback : value;
151
+ }
152
+ /**
153
+ A color scale pole (`max`, `mid`, or `min`): the chart's own default (from
154
+ its `colorDefaults`) on the light preset, and the theme's `colorScale`
155
+ token once a dark or custom theme changes it.
156
+ @param theme The resolved theme, when the chart has drawn.
157
+ @param pole Which pole.
158
+ @param fallback The chart's own default.
159
+ */ export function themeScaleColor(theme, pole, fallback) {
160
+ return themed(theme, (t)=>t.colorScale[pole], fallback);
161
+ }
162
+ /**
163
+ An `n`-step single-hue ramp toward `base` that reads on the theme's
164
+ background, ordered low→high: pale→dark (`colorRamp`) on a light theme,
165
+ dim→bright (`colorRampDark`) on a dark one.
166
+ @param theme The resolved theme, when the chart has drawn.
167
+ @param base The ramp's high-value color.
168
+ @param n How many steps to produce.
169
+ @param ordinal Whether the steps are discrete marks (see `colorRamp`).
170
+ */ export function themeRamp(theme, base, n, ordinal = false) {
171
+ return theme?.dark ? colorRampDark(base, n, {
172
+ background: theme.background,
173
+ ordinal
174
+ }) : colorRamp(base, n, {
175
+ ordinal
176
+ });
177
+ }
178
+ /**
179
+ Swaps each entry of a style object that is still at its built-in default
180
+ for its themed value, so a user's own entries win.
181
+ @param style The configured style.
182
+ @param defaults The built-in default style.
183
+ @param overrides The themed values, by key (an `undefined` value is skipped).
184
+ */ export function themeStyle(style, defaults, overrides) {
185
+ const out = {
186
+ ...style
187
+ };
188
+ for (const key of Object.keys(overrides))if (overrides[key] !== undefined && out[key] === defaults[key]) out[key] = overrides[key];
189
+ return out;
190
+ }
@@ -0,0 +1,68 @@
1
+ import { hsl } from "d3-color";
2
+ import { colorContrast, colorDefaults as defaultColors, colorGray, colorLegible } from "@d3plus/color";
3
+ import { backgroundColor } from "@d3plus/dom";
4
+ import BaseClass from "./BaseClass.js";
5
+ const WHITE = "rgb(255, 255, 255)";
6
+ /**
7
+ The background behind a chart or component: its theme's, or the first
8
+ opaque one behind its DOM node (white when it has none).
9
+ @private
10
+ */ export function inkBackground(obj) {
11
+ if (obj._theme) return obj._theme.background;
12
+ const sel = obj._select;
13
+ const node = sel && typeof sel.node === "function" ? sel.node() : null;
14
+ return node ? backgroundColor(node) : WHITE;
15
+ }
16
+ /**
17
+ The gridline color for a background: a faint step off it, so gridlines
18
+ recede equally on light and dark pages.
19
+ @private
20
+ */ export function gridStroke(background, colorDefaults = {}) {
21
+ return colorContrast(background, colorDefaults) === (colorDefaults.dark || defaultColors.dark) ? colorGray[200] : colorGray[800];
22
+ }
23
+ /**
24
+ The text color that reads on a chart or component's background.
25
+ @private
26
+ */ export function inkText(obj) {
27
+ return obj._theme?.text ?? colorContrast(inkBackground(obj), obj.schema.colorDefaults);
28
+ }
29
+ /**
30
+ The axis color (lines, ticks, tick labels) on a chart or component's background.
31
+ @private
32
+ */ export function inkAxis(obj) {
33
+ return obj._theme?.axis ?? inkText(obj);
34
+ }
35
+ /**
36
+ The gridline color on a chart or component's background.
37
+ @private
38
+ */ export function inkGrid(obj) {
39
+ return obj._theme?.gridline ?? gridStroke(inkBackground(obj), obj.schema.colorDefaults);
40
+ }
41
+ /**
42
+ A series color adjusted to read as text on the chart's background: darkened
43
+ on a light background (`colorLegible`), lightened on a dark one.
44
+ @param c A CSS color.
45
+ @param dark Whether the background is dark.
46
+ @private
47
+ */ export function legibleOn(c, dark) {
48
+ if (!dark) return colorLegible(c);
49
+ const out = hsl(c);
50
+ if (!Number.isFinite(out.l)) return c;
51
+ if (out.l < 0.65) out.l = 0.65;
52
+ return out.toString();
53
+ }
54
+ /** Whether an instance is a chart (which themes itself). */ const isChart = (obj)=>typeof obj._preDraw === "function";
55
+ /**
56
+ Hands a chart's resolved theme to every component it owns (own properties
57
+ and `ctx` entries, recursively), the way `colorDefaults` cascades. Other
58
+ charts it references (linked charts) keep their own.
59
+ @private
60
+ */ export function cascadeTheme(obj, theme, seen = new WeakSet()) {
61
+ if (seen.has(obj)) return;
62
+ seen.add(obj);
63
+ obj._theme = theme;
64
+ for (const child of [
65
+ ...Object.values(obj),
66
+ ...Object.values(obj.ctx)
67
+ ])if (child instanceof BaseClass && !isChart(child)) cascadeTheme(child, theme, seen);
68
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@d3plus/core",
3
- "version": "4.10.0",
3
+ "version": "4.11.0",
4
4
  "description": "Data visualization made easy. A javascript library that extends the popular D3.js to enable fast and beautiful visualizations.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -37,15 +37,27 @@
37
37
  "visualization"
38
38
  ],
39
39
  "dependencies": {
40
+ "@d3plus/color": "4.11.0",
41
+ "@d3plus/data": "4.11.0",
42
+ "@d3plus/dom": "4.11.0",
43
+ "@d3plus/export": "4.11.0",
44
+ "@d3plus/format": "4.11.0",
45
+ "@d3plus/locales": "4.11.0",
46
+ "@d3plus/math": "4.11.0",
47
+ "@d3plus/render": "4.11.0",
48
+ "@d3plus/text": "4.11.0",
40
49
  "@floating-ui/dom": "^1.6.0",
41
50
  "d3-array": "^3.2.4",
42
51
  "d3-brush": "^3.0.0",
43
52
  "d3-chord": "^3.0.1",
44
53
  "d3-color": "^3.1.0",
45
54
  "d3-composite-projections": "^2.0.0",
55
+ "d3-contour": "^4.0.2",
56
+ "d3-delaunay": "^6.0.4",
46
57
  "d3-force": "^3.0.0",
47
58
  "d3-geo": "^3.1.1",
48
59
  "d3-geo-projection": "^4.0.0",
60
+ "d3-hexbin": "^0.2.2",
49
61
  "d3-hierarchy": "^3.1.2",
50
62
  "d3-interpolate": "^3.0.1",
51
63
  "d3-polygon": "^3.0.1",
@@ -57,16 +69,7 @@
57
69
  "d3-time-format": "^4.1.0",
58
70
  "d3-transition": "^3.0.1",
59
71
  "d3-zoom": "^3.0.0",
60
- "topojson-client": "^3.1.0",
61
- "@d3plus/color": "4.10.0",
62
- "@d3plus/data": "4.10.0",
63
- "@d3plus/dom": "4.10.0",
64
- "@d3plus/export": "4.10.0",
65
- "@d3plus/format": "4.10.0",
66
- "@d3plus/locales": "4.10.0",
67
- "@d3plus/math": "4.10.0",
68
- "@d3plus/render": "4.10.0",
69
- "@d3plus/text": "4.10.0"
72
+ "topojson-client": "^3.1.0"
70
73
  },
71
74
  "scripts": {
72
75
  "build:esm": "node ../../scripts/build-esm.js",
package/types/index.d.ts CHANGED
@@ -1,12 +1,16 @@
1
- export { AreaPlot, BarChart, Beeswarm, BoxWhisker, Bullet, BumpChart, Calendar, Candlestick, Chord, Donut, Dumbbell, FanChart, Funnel, Gauge, Geomap, Histogram, Icicle, LinePlot, Lollipop, Marimekko, Matrix, Network, Pack, ParallelCoordinates, Pie, Plot, PolarArea, Priestley, Pyramid, Radar, RadialBar, RadialMatrix, Ridgeline, Rings, Sankey, StackedArea, Sunburst, Tree, Treemap, Violin, Viz, Waffle, Waterfall, } from "./src/charts/index.js";
1
+ export { Alluvial, ArcDiagram, AreaPlot, BarChart, Beeswarm, BoxWhisker, BubbleChart, Bullet, BumpChart, Calendar, Candlestick, Chord, Donut, Dumbbell, FanChart, Funnel, Gantt, Gauge, Geomap, Hexbin, Histogram, Icicle, LinePlot, Lollipop, Marimekko, Matrix, Network, Pack, ParallelCoordinates, Pie, Plot, PolarArea, Priestley, Pyramid, Radar, RadialBar, RadialMatrix, Ridgeline, Rings, Sankey, Scatter, SlopeChart, StackedArea, Streamgraph, Sunburst, Tree, Treemap, Violin, Viz, Waffle, Waterfall, } from "./src/charts/index.js";
2
2
  export { Axis, AxisBottom, AxisLeft, AxisRight, AxisTop, ColorScale, Legend, Message, SizeLegend, TextBox, Timeline, Tooltip, } from "./src/components/index.js";
3
3
  export { Area, Bar, Box, Circle, Image, Line, Path, Rect, Shape, Whisker, } from "./src/shapes/index.js";
4
4
  export { accessor, BaseClass, configPrep, configWarnings, constant, RESET, } from "./src/utils/index.js";
5
- export type { D3plusConfig, AxisConfig, ColorDefaultsConfig, ColorScaleConfig, ConfidenceBandSetting, ConfidenceBound, LegendConfig, SaveControlConfig, SaveFormat, SizeLegendConfig, TextBoxConfig, TimelineConfig, TooltipConfig, TrendLineConfig, } from "./src/utils/index.js";
5
+ export type { D3plusConfig, AxisConfig, ColorDefaultsConfig, ColorScaleConfig, ConfidenceBandSetting, ConfidenceBound, KeyboardNavConfig, LegendConfig, PointLabelConfig, SaveControlConfig, SaveFormat, SizeLegendConfig, TextBoxConfig, TimelineConfig, TooltipConfig, TrendLineConfig, } from "./src/utils/index.js";
6
6
  export type { LinkConfig, LinkOption } from "./src/charts/viz/linkGroup.js";
7
+ export type { Annotation, AnnotationRef, AnnotationTextStyle, AnnotationValue, CalloutAnnotation, ReferenceBandConfig, ReferenceLineConfig, ReferenceStyle, } from "./src/charts/features/annotationTypes.js";
8
+ export type { RangeBreakRule, RangeBreakTime, } from "./src/components/Axis/rangeBreaks.js";
9
+ export type { ThemeColorScaleTokens, ThemeConfig, ThemeOverlayTokens, ThemeSetting, ThemeTableTokens, ThemeTokens, ThemeTooltipTokens, } from "./src/utils/theme.js";
7
10
  export type { ColorScaleType, ColorScaleTypeSetting, } from "./src/components/ColorScale/colorScaleType.js";
8
11
  export type { ColorScaleHoverMarkConfig } from "./src/components/ColorScale/colorScaleHoverMark.js";
9
12
  export type { BulletBandInput } from "./src/charts/Bullet/bulletGeometry.js";
13
+ export type { ConnectGaps, ConnectGapsConfig, } from "./src/charts/Plot/connectGaps.js";
10
14
  export type { FunnelConversion, FunnelConversionOption, } from "./src/charts/Funnel/funnelLabels.js";
11
15
  export type { FunnelCurve } from "./src/charts/Funnel/funnelGeometry.js";
12
16
  export type { GaugeBand } from "./src/charts/Gauge/gaugeGeometry.js";