@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
@@ -1,13 +1,25 @@
1
1
  import { deviation, extent, min, quantile, range } from "d3-array";
2
2
  import { interpolateRgb } from "d3-interpolate";
3
3
  import { scaleLinear, scaleThreshold } from "d3-scale";
4
- import { colorLighter, colorRamp } from "@d3plus/color";
4
+ import { colorLighter } from "@d3plus/color";
5
5
  import { unique } from "@d3plus/data";
6
6
  import { ckmeans } from "@d3plus/math";
7
+ import { themeRamp, themeScaleColor } from "../../utils/theme.js";
7
8
  import { resolveColorScaleType } from "./colorScaleType.js";
8
- /** The scale's poles, with unset ones taken from its `colorDefaults`. */ const colorMin = (cs)=>cs.schema.colorMin ?? cs.schema.colorDefaults.off;
9
- const colorMid = (cs)=>cs.schema.colorMid ?? cs.schema.colorDefaults.light;
10
- const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
9
+ /**
10
+ The scale's poles: unset ones come from the theme's `colorScale` tokens on
11
+ a dark or custom theme, and from its `colorDefaults` otherwise.
12
+ */ const colorMin = (cs)=>cs.schema.colorMin ?? themeScaleColor(cs._theme, "min", cs.schema.colorDefaults.off);
13
+ const colorMid = (cs)=>cs.schema.colorMid ?? themeScaleColor(cs._theme, "mid", cs.schema.colorDefaults.light);
14
+ const colorMax = (cs)=>cs.schema.colorMax ?? themeScaleColor(cs._theme, "max", cs.schema.colorDefaults.sequential);
15
+ /**
16
+ A single-hue low→high ramp toward `base` that reads on the scale's theme,
17
+ its palest step held darker on a light theme with `ordinalRamp`.
18
+ */ const ramp = (cs, base, n)=>themeRamp(cs._theme, base, n, Boolean(cs.schema.ordinalRamp) && !cs._theme?.dark);
19
+ /**
20
+ Steps a diverging pole `t` of the way back toward the midpoint: lighter on
21
+ a light theme, and mixed into the dark midpoint on a dark one.
22
+ */ const towardMid = (cs, pole, t)=>cs._theme?.dark ? interpolateRgb.gamma(2.2)(pole, colorMid(cs))(t) : colorLighter(pole, t);
11
23
  /** Builds the jenks (ckmeans) threshold scale and assigns it to the instance. */ function computeJenksScale(cs, ctx) {
12
24
  const { allValues, diverging, numBuckets } = ctx;
13
25
  let { colors } = ctx;
@@ -57,13 +69,13 @@ const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
57
69
  const negatives = ticks.slice(0, buckets).filter((d, i)=>d < cs.schema.midpoint && ticks[i + 1] <= cs.schema.midpoint);
58
70
  const spanning = ticks.slice(0, buckets).filter((d, i)=>d <= cs.schema.midpoint && ticks[i + 1] > cs.schema.midpoint);
59
71
  const positives = ticks.slice(0, buckets).filter((d)=>d > cs.schema.midpoint);
60
- const negativeColors = negatives.map((_d, i)=>!i ? base[0] : colorLighter(base[0], i / negatives.length));
72
+ const negativeColors = negatives.map((_d, i)=>!i ? base[0] : towardMid(cs, base[0], i / negatives.length));
61
73
  const spanningColors = spanning.map(()=>base[1]);
62
- const positiveColors = positives.map((_d, i)=>i === positives.length - 1 ? base[2] : colorLighter(base[2], 1 - (i + 1) / positives.length));
74
+ const positiveColors = positives.map((_d, i)=>i === positives.length - 1 ? base[2] : towardMid(cs, base[2], 1 - (i + 1) / positives.length));
63
75
  colors = negativeColors.concat(spanningColors).concat(positiveColors);
64
76
  } else {
65
- // Single-hue light→dark ramp, stepped in OKLab (see @d3plus/color).
66
- colors = colorRamp(colorMax(cs), numBuckets);
77
+ // Single-hue low→high ramp, stepped in OKLab (see @d3plus/color).
78
+ colors = ramp(cs, colorMax(cs), numBuckets);
67
79
  }
68
80
  }
69
81
  if (ticks.length <= buckets) colors = colors.slice(-ticks.length);
@@ -103,14 +115,15 @@ const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
103
115
  const { allValues, domain, negative, positive, diverging, numBuckets, scale } = ctx;
104
116
  let { colors } = ctx;
105
117
  if (!colors) {
106
- // Single-hue ramp of the relevant pole, stepped in OKLab (light→dark).
107
- // Negative-only scales read dark→light, so the ramp is reversed.
118
+ // Single-hue ramp of the relevant pole, stepped in OKLab (low→high).
119
+ // Negative-only scales put the pole on the most negative value, so the
120
+ // ramp is reversed.
108
121
  const base = negative ? colorMin(cs) : colorMax(cs);
109
122
  if (scale === "buckets" || scale === "quantile") {
110
- const ramp = colorRamp(base, numBuckets);
111
- colors = positive ? ramp : ramp.slice().reverse();
123
+ const steps = ramp(cs, base, numBuckets);
124
+ colors = positive ? steps : steps.slice().reverse();
112
125
  } else {
113
- const two = colorRamp(base, 2);
126
+ const two = ramp(cs, base, 2);
114
127
  colors = negative ? two.slice().reverse() : two;
115
128
  }
116
129
  }
@@ -196,8 +209,8 @@ const colorMax = (cs)=>cs.schema.colorMax ?? cs.schema.colorDefaults.sequential;
196
209
  ]);
197
210
  let colors = diverging && (!cs.schema.color || cs.schema.color instanceof Array && !cs.schema.color.includes(colorMid(cs))) ? undefined : cs.schema.color;
198
211
  if (colors && !(colors instanceof Array)) {
199
- // A single hue expands to a light→dark ramp, stepped in OKLab.
200
- colors = colorRamp(colors, numBuckets);
212
+ // A single hue expands to a low→high ramp, stepped in OKLab.
213
+ colors = ramp(cs, colors, numBuckets);
201
214
  }
202
215
  const ctx = {
203
216
  scale,
@@ -6,6 +6,7 @@ import { accessor, BaseClass, constant, paintComponentScene } from "../../utils/
6
6
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
7
7
  import { buildLegendShapeConfig } from "./legendConfig.js";
8
8
  import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendTitle, renderLegendShapes, renderLegendTitle, wrapLegendRows } from "./legendRender.js";
9
+ import { inkText } from "../../utils/themeInk.js";
9
10
  /** Legend's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const legendSchema = [
10
11
  {
11
12
  key: "align",
@@ -70,6 +71,7 @@ import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendT
70
71
  /**
71
72
  Creates an SVG legend based on an array of data.
72
73
  */ export default class Legend extends BaseClass {
74
+ static _displayName = "Legend";
73
75
  _titleClass;
74
76
  _data;
75
77
  _lineData;
@@ -105,6 +107,7 @@ import { clearLegend, computeLegendBounds, computeLegendLineData, measureLegendT
105
107
  this._shapes = [];
106
108
  this.schema.shapeConfig = buildLegendShapeConfig(this);
107
109
  this.schema.titleConfig = {
110
+ fontColor: ()=>inkText(this),
108
111
  fontSize: 12
109
112
  };
110
113
  this._rtl = false;
@@ -1,7 +1,6 @@
1
1
  import { max } from "d3-array";
2
- import { colorContrast } from "@d3plus/color";
3
- import { backgroundColor } from "@d3plus/dom";
4
2
  import { accessor, constant } from "../../utils/index.js";
3
+ import { inkText } from "../../utils/themeInk.js";
5
4
  const padding = 5;
6
5
  const positionCache = new WeakMap();
7
6
  /**
@@ -117,10 +116,7 @@ const positionCache = new WeakMap();
117
116
  };
118
117
  },
119
118
  labelConfig: {
120
- fontColor: ()=>{
121
- const bg = legend._select ? backgroundColor(legend._select.node()) : "rgb(255, 255, 255)";
122
- return colorContrast(bg, legend.schema.colorDefaults);
123
- },
119
+ fontColor: ()=>inkText(legend),
124
120
  fontFamily: legend._titleClass.fontFamily(),
125
121
  fontResize: false,
126
122
  fontSize: constant(10),
@@ -61,6 +61,7 @@ new SizeLegend()
61
61
  .select("#container")
62
62
  .render();
63
63
  */ export default class SizeLegend extends BaseClass {
64
+ static _displayName = "SizeLegend";
64
65
  _layout;
65
66
  /** Drops values whose circles would outgrow this radius; set by a zoomed chart. */ _maxRadius;
66
67
  _select;
@@ -1,11 +1,12 @@
1
1
  import { select } from "d3-selection";
2
2
  import { rtl as detectRTL } from "@d3plus/dom";
3
- import { fontFamily, strip, textSplit } from "@d3plus/text";
3
+ import { fontFamily, textSplit } from "@d3plus/text";
4
4
  import { SvgRenderer } from "@d3plus/render";
5
5
  import { accessor, BaseClass, constant } from "../utils/index.js";
6
6
  import { applyClassName } from "../utils/className.js";
7
7
  import { installFluent } from "../fluent.js";
8
8
  import { computeTextBoxDatum } from "./textBoxLayout.js";
9
+ import { textBoxNodes } from "./textBoxScene.js";
9
10
  const defaultHtmlLookup = {
10
11
  i: "font-style: italic;",
11
12
  em: "font-style: italic;",
@@ -88,6 +89,11 @@ const defaultHtmlLookup = {
88
89
  coerce: "const",
89
90
  default: accessor("height", 200)
90
91
  },
92
+ {
93
+ key: "hitbox",
94
+ coerce: "const",
95
+ default: constant(false)
96
+ },
91
97
  {
92
98
  key: "id",
93
99
  coerce: "const",
@@ -146,11 +152,21 @@ const defaultHtmlLookup = {
146
152
  coerce: "const",
147
153
  default: (d)=>d.__d3plusWrapShape__ ?? "square"
148
154
  },
155
+ {
156
+ key: "side",
157
+ coerce: "const",
158
+ default: constant("left")
159
+ },
149
160
  {
150
161
  key: "split",
151
162
  coerce: "identity",
152
163
  default: textSplit
153
164
  },
165
+ {
166
+ key: "startOffset",
167
+ coerce: "const",
168
+ default: constant(0)
169
+ },
154
170
  {
155
171
  key: "text",
156
172
  coerce: "const",
@@ -161,6 +177,16 @@ const defaultHtmlLookup = {
161
177
  coerce: "const",
162
178
  default: constant("start")
163
179
  },
180
+ {
181
+ key: "textPath",
182
+ coerce: "const",
183
+ default: constant(false)
184
+ },
185
+ {
186
+ key: "truncateWord",
187
+ coerce: "const",
188
+ default: constant(false)
189
+ },
164
190
  {
165
191
  key: "verticalAlign",
166
192
  coerce: "const",
@@ -185,6 +211,7 @@ const defaultHtmlLookup = {
185
211
  /**
186
212
  Creates a wrapped text box for each point in an array of data.
187
213
  */ export default class TextBox extends BaseClass {
214
+ static _displayName = "TextBox";
188
215
  _select;
189
216
  _data;
190
217
  /**
@@ -213,70 +240,7 @@ const defaultHtmlLookup = {
213
240
  layout (_textData) and per-line positioning render() applies to the DOM.
214
241
  */ toScene() {
215
242
  const rtl = detectRTL();
216
- const children = this._textData().map((d)=>{
217
- const anchor = d.tA === "middle" ? "middle" : d.tA === "end" ? "end" : "start";
218
- const lineX = d.tA === "middle" ? d.w / 2 : rtl ? d.tA === "start" ? d.w : 0 : d.tA === "end" ? d.w : 2 * Math.sin(Math.PI * d.r / 180);
219
- const lines = d.lines.map((text, i)=>{
220
- const y = d.r === 0 || d.vA === "top" ? (i + 1) * d.lH - (d.lH - d.fS) : d.vA === "middle" ? (d.h + d.fS) / 2 - (d.lH - d.fS) + (i - d.lines.length / 2 + 0.5) * d.lH : d.h - 2 * (d.lH - d.fS) - (d.lines.length - (i + 1)) * d.lH + 2 * Math.cos(Math.PI * d.r / 180);
221
- const width = d.widths ? d.widths[i] ?? 0 : 0;
222
- const runs = d.lineRuns ? d.lineRuns[i] : undefined;
223
- return runs ? {
224
- text,
225
- x: lineX,
226
- y,
227
- width,
228
- runs
229
- } : {
230
- text,
231
- x: lineX,
232
- y,
233
- width
234
- };
235
- });
236
- const rotateAnchor = this.schema.rotateAnchor(d, d.i);
237
- const ariaHidden = d.aH === "true" || d.aH === true;
238
- const interactive = d.pE !== "none";
239
- return {
240
- type: "text",
241
- key: d.id,
242
- id: `d3plus-textBox-${strip(d.id)}`,
243
- datum: d.data,
244
- index: d.i,
245
- x: 0,
246
- y: 0,
247
- width: d.w,
248
- height: d.h,
249
- lines,
250
- font: {
251
- family: d.fF,
252
- size: d.fS,
253
- weight: d.fW,
254
- anchor,
255
- baseline: "alphabetic",
256
- dir: rtl ? "rtl" : "ltr"
257
- },
258
- paint: {
259
- fill: d.fC,
260
- opacity: d.fO,
261
- ...d.fStroke && d.fStroke !== "transparent" ? {
262
- stroke: d.fStroke
263
- } : {},
264
- ...d.fSW ? {
265
- strokeWidth: d.fSW
266
- } : {}
267
- },
268
- transform: {
269
- x: d.x,
270
- y: d.y,
271
- rotate: d.r,
272
- rotateAnchor
273
- },
274
- aria: ariaHidden ? {
275
- hidden: true
276
- } : undefined,
277
- interactive
278
- };
279
- });
243
+ const children = this._textData().flatMap((d)=>textBoxNodes(d, this.schema.rotateAnchor(d, d.i), rtl));
280
244
  return {
281
245
  type: "group",
282
246
  key: "textBox-group",
@@ -5,7 +5,8 @@ import { Axis } from "../index.js";
5
5
  import { constant } from "../../utils/index.js";
6
6
  import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
7
7
  import { fitBrush, timelineBrushSpan } from "./brushSpan.js";
8
- import { byValue, initTimelineDefaults } from "./timelineConfig.js";
8
+ import { brushOverlayCursor, byValue, initTimelineDefaults } from "./timelineConfig.js";
9
+ import { classTimelineMode } from "./timelineMode.js";
9
10
  import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, renderPlayButton, setupBrush } from "./timelineRender.js";
10
11
  /** Timeline's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const timelineSchema = [
11
12
  {
@@ -13,6 +14,11 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
13
14
  coerce: "identity",
14
15
  default: 10
15
16
  },
17
+ {
18
+ key: "brushCursor",
19
+ coerce: "identity",
20
+ default: "pointer"
21
+ },
16
22
  {
17
23
  key: "brushing",
18
24
  coerce: "identity",
@@ -74,6 +80,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
74
80
  /**
75
81
  Creates an interactive timeline brush component for selecting time periods within a visualization.
76
82
  */ export default class Timeline extends Axis {
83
+ static _displayName = "Timeline";
77
84
  _buttonBehaviorCurrent;
78
85
  _hiddenHandles;
79
86
  _playButtonClass;
@@ -162,8 +169,9 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
162
169
  // would animate from d3-brush's internal drag bounds (the anchored edge), so
163
170
  // the lone handle would jump back to where the drag began and slide to the
164
171
  // release point; duration 0 applies the final period on the first frame.
172
+ // A timeline without a duration (reduced motion) snaps too.
165
173
  const move = this._brushGroup.transition(this._transition);
166
- if (!this.schema.brushing) move.duration(0);
174
+ if (!this.schema.brushing || !this.schema.duration) move.duration(0);
167
175
  move.call(this._brush.move, this._updateBrushLimit(domain));
168
176
  if (this.schema.on.end) this.schema.on.end(this.schema.selection);
169
177
  }
@@ -218,7 +226,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
218
226
  const sw = +brushSelection.attr("width") || 0;
219
227
  brushHandle.filter((d)=>d.type === "e").attr("x", sx + sw / 2 - this.schema.handleSize / 2);
220
228
  }
221
- this._brushGroup.selectAll(".overlay").attr("x", this._paddingLeft).attr("cursor", "pointer").attr("transform", `translate(0,${this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight / 2 : -this.schema.handleSize})`).attr("width", this._buttonBehaviorCurrent === "buttons" ? this._ticksWidth : this.schema.width).attr("height", this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight : this.schema.handleSize * 2);
229
+ this._brushGroup.selectAll(".overlay").attr("x", this._paddingLeft).attr("cursor", brushOverlayCursor(this)).attr("transform", `translate(0,${this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight / 2 : -this.schema.handleSize})`).attr("width", this._buttonBehaviorCurrent === "buttons" ? this._ticksWidth : this.schema.width).attr("height", this._buttonBehaviorCurrent === "buttons" ? this.schema.buttonHeight : this.schema.handleSize * 2);
222
230
  if (this._buttonBehaviorCurrent === "buttons") {
223
231
  const yTransform = this.schema.align === "middle" ? this.schema.height / 2 - this.schema.buttonHeight / 2 : this.schema.align === "start" ? this._margin.top : this.schema.height - this.schema.buttonHeight - this._margin.bottom;
224
232
  brushHandle.attr("y", yTransform);
@@ -419,6 +427,7 @@ import { configureScale, measureTicksWidth, paintTimelineScene, prepareTicks, re
419
427
  super.render(callback);
420
428
  setupBrush(this, hiddenHandles, height, y);
421
429
  renderPlayButton(this, playButtonWidth);
430
+ classTimelineMode(this._group?.node(), "d3plus-Timeline", this._buttonBehaviorCurrent);
422
431
  // Standalone (non-Viz) use: a parent Viz normally composes the timeline's
423
432
  // scene via toScene(), but on its own `_managesOwnScenePaint` made
424
433
  // Axis.render() skip the paint, leaving only the brush/play DOM. Paint the
@@ -1,7 +1,13 @@
1
- import { colorContrast } from "@d3plus/color";
2
- import { assign, backgroundColor } from "@d3plus/dom";
1
+ import { assign } from "@d3plus/dom";
2
+ import { inkBackground, inkText } from "../../utils/themeInk.js";
3
+ import { themed } from "../../utils/theme.js";
3
4
  import TextBox from "../TextBox.js";
4
5
  const colorMid = "#bbb";
6
+ const accentDefault = "#228be6";
7
+ /** A button's fill: white, or the theme's background once it is forced or dark. */ function buttonFill(tl) {
8
+ return tl._theme?.painted || tl._theme?.dark ? inkBackground(tl) : "#fff";
9
+ }
10
+ /** The selection and handle color: the theme's `accent`. */ const accent = (tl)=>()=>themed(tl._theme, (t)=>t.accent, accentDefault);
5
11
  /**
6
12
  A copy of `values` (dates, years or pixel positions) in ascending order.
7
13
  A `reverse` timeline lays its ticks out from latest to earliest, but its
@@ -9,6 +15,13 @@ const colorMid = "#bbb";
9
15
  */ export function byValue(values) {
10
16
  return values.slice().sort((a, b)=>Number(a) - Number(b));
11
17
  }
18
+ /**
19
+ The brush overlay's cursor: `brushCursor`, or what it returns when given
20
+ the presentation drawn (`"ticks"` or `"buttons"`).
21
+ */ export function brushOverlayCursor(tl) {
22
+ const cursor = tl.schema.brushCursor;
23
+ return typeof cursor === "function" ? cursor(tl._buttonBehaviorCurrent) : cursor ?? null;
24
+ }
12
25
  /**
13
26
  Builds the play/pause TextBox. The button's visual is composed into the
14
27
  scene in compute mode; its click is wired to `Timeline._togglePlay` via a
@@ -26,14 +39,11 @@ const colorMid = "#bbb";
26
39
  height: tl.schema.buttonHeight
27
40
  } : d.labelBounds,
28
41
  labelConfig: {
29
- fontColor: ()=>{
30
- const bg = tl._select ? backgroundColor(tl._select.node()) : "rgb(255, 255, 255)";
31
- return colorContrast(bg, tl.schema.colorDefaults);
32
- },
42
+ fontColor: ()=>inkText(tl),
33
43
  fontSize: ()=>12,
34
44
  verticalAlign: ()=>tl._buttonBehaviorCurrent === "buttons" ? "middle" : "top"
35
45
  },
36
- fill: ()=>tl._buttonBehaviorCurrent === "buttons" ? "#fff" : colorMid,
46
+ fill: ()=>tl._buttonBehaviorCurrent === "buttons" ? buttonFill(tl) : colorMid,
37
47
  stroke: ()=>tl._buttonBehaviorCurrent === "buttons" ? colorMid : "transparent",
38
48
  height: (d)=>tl._buttonBehaviorCurrent === "buttons" ? tl.schema.buttonHeight : d.tick ? tl.schema.handleSize : 0,
39
49
  width: (d)=>tl._buttonBehaviorCurrent === "buttons" ? tl._ticksWidth / tl._availableTicks.length : d.tick ? tl.schema.domain.map(Number).includes(d.id) ? 2 : 1 : 0,
@@ -57,7 +67,7 @@ const colorMid = "#bbb";
57
67
  tl.schema.gridSize = 0;
58
68
  tl.schema.handleConfig = {
59
69
  fill: ()=>tl.schema.colorDefaults.light,
60
- stroke: "#228be6",
70
+ stroke: accent(tl),
61
71
  "stroke-width": 2,
62
72
  rx: 2,
63
73
  ry: 2
@@ -69,14 +79,14 @@ const colorMid = "#bbb";
69
79
  tl.orient("bottom");
70
80
  tl._playButtonClass = buildPlayButton();
71
81
  tl.schema.playButtonConfig = {
72
- fontColor: ()=>tl.schema.colorDefaults.dark,
82
+ fontColor: ()=>inkText(tl),
73
83
  fontSize: 15,
74
84
  text: ()=>tl._playTimer ? "\u23F8" : "\u23F5",
75
85
  textAnchor: "middle",
76
86
  verticalAlign: "middle"
77
87
  };
78
88
  tl.schema.selectionConfig = {
79
- fill: "#228be6",
89
+ fill: accent(tl),
80
90
  "fill-opacity": ()=>tl._buttonBehaviorCurrent === "buttons" ? 0.3 : 1,
81
91
  "stroke-width": 0
82
92
  };
@@ -0,0 +1,26 @@
1
+ /** How a Timeline draws its periods: tick marks along an axis, or a row of buttons. */ const MODES = [
2
+ "ticks",
3
+ "buttons"
4
+ ];
5
+ /**
6
+ The class naming how a Timeline is drawn, `<prefix>-ticks` or
7
+ `<prefix>-buttons`, or none before it resolves a mode.
8
+ @param prefix The element's own class, such as `d3plus-viz-timeline`.
9
+ @param mode The Timeline's resolved `buttonBehavior`.
10
+ */ export function timelineModeClass(prefix, mode) {
11
+ return MODES.includes(mode) ? `${prefix}-${mode}` : null;
12
+ }
13
+ /**
14
+ Adds `timelineModeClass(prefix, mode)` to `el` and removes the other
15
+ mode's class, so the element names the presentation drawn last.
16
+ @param el The element to mark.
17
+ @param prefix The element's own class.
18
+ @param mode The Timeline's resolved `buttonBehavior`.
19
+ */ export function classTimelineMode(el, prefix, mode) {
20
+ if (!el) return;
21
+ const current = timelineModeClass(prefix, mode);
22
+ for (const m of MODES){
23
+ const name = `${prefix}-${m}`;
24
+ el.classList.toggle(name, name === current);
25
+ }
26
+ }
@@ -108,8 +108,9 @@ import { byValue } from "./timelineConfig.js";
108
108
  const hiddenHandles = tl._hiddenHandles = tl._buttonBehaviorCurrent === "buttons" && !tl.schema.brushing;
109
109
  if (tl._buttonBehaviorCurrent === "buttons") {
110
110
  tl.schema.scale = "ordinal";
111
- const domain = scaleTime().domain(tl.schema.domain.map(date)).ticks().map(Number);
112
- tl.schema.domain = tl.schema.ticks ? tl.schema.ticks : Array.from(Array(domain[domain.length - 1] - domain[0] + 1), (_, x)=>domain[0] + x).map(date);
111
+ // One button per tick: the `ticks` given, or the time scale's own (the
112
+ // ones `measureTicksWidth` sized the buttons for).
113
+ tl.schema.domain = tl.schema.ticks ? tl.schema.ticks : ticks;
113
114
  tl.schema.ticks = tl.schema.domain;
114
115
  const buttonMargin = 0.5 * tl._ticksWidth / tl.schema.ticks.length;
115
116
  const emptySpace = tl.schema.width - tl._ticksWidth - playButtonWidth;
@@ -205,7 +206,10 @@ import { byValue } from "./timelineConfig.js";
205
206
  tl._brushGroup = elem("g.brushGroup", {
206
207
  parent: tl._group
207
208
  });
208
- tl._brushGroup.call(brush).transition(tl._transition).call(brush.move, tl._buttonBehaviorCurrent === "ticks" ? tl._updateBrushLimit(selection) : selection);
209
+ const brushMove = tl._brushGroup.call(brush).transition(tl._transition);
210
+ // Without a duration (reduced motion), the brush jumps to the selection.
211
+ if (!tl.schema.duration) brushMove.duration(0);
212
+ brushMove.call(brush.move, tl._buttonBehaviorCurrent === "ticks" ? tl._updateBrushLimit(selection) : selection);
209
213
  tl._outerBounds.y -= tl.schema.handleSize / 2;
210
214
  tl._outerBounds.height += tl.schema.handleSize / 2;
211
215
  }
@@ -5,8 +5,17 @@ import { resetInjectedBoxes } from "@d3plus/render";
5
5
  import { fontFamily, fontFamilyStringify } from "@d3plus/text";
6
6
  import { accessor, BaseClass, constant } from "../utils/index.js";
7
7
  import { setUserClasses } from "../utils/className.js";
8
+ import { themed, themeLight } from "../utils/theme.js";
8
9
  import { installFluent, mergeConfigBag, resolvesReset } from "../fluent.js";
9
10
  import { bindTooltips, buildTable, divElement, resolvePortal, TOOLTIP_SELECTORS } from "./tooltipDom.js";
11
+ /** The tooltip colors of the theme of the chart showing it (light when shown alone). */ const tokens = (t)=>(t._theme ?? themeLight).tooltip;
12
+ /**
13
+ The tooltip's text: the theme's while the fill is the theme's own, and
14
+ otherwise whichever of `colorDefaults`' dark and light reads on the fill.
15
+ */ function tooltipText(t, background) {
16
+ const contrast = colorContrast(background, t.schema.colorDefaults);
17
+ return t._theme && background === t._theme.tooltip.background ? themed(t._theme, (x)=>x.tooltip.text, contrast) : contrast;
18
+ }
10
19
  /** Tooltip's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ /** Every tooltip element's fixed class; `className` adds classes beside it. */ const TOOLTIP_CLASS = "d3plus-tooltip";
11
20
  const tooltipSchema = [
12
21
  {
@@ -17,7 +26,7 @@ const tooltipSchema = [
17
26
  {
18
27
  key: "background",
19
28
  coerce: "const",
20
- factory: (t)=>()=>t.schema.colorDefaults.light
29
+ factory: (t)=>()=>themed(t._theme, (x)=>x.tooltip.background, t.schema.colorDefaults.light)
21
30
  },
22
31
  {
23
32
  key: "body",
@@ -27,7 +36,7 @@ const tooltipSchema = [
27
36
  {
28
37
  key: "border",
29
38
  coerce: "const",
30
- default: constant("1px solid rgba(0, 0, 0, 0.25)")
39
+ factory: (t)=>()=>`1px solid ${tokens(t).border}`
31
40
  },
32
41
  {
33
42
  key: "borderRadius",
@@ -103,6 +112,7 @@ const tooltipSchema = [
103
112
  /**
104
113
  Creates HTML tooltips in the body of a webpage.
105
114
  */ export default class Tooltip extends BaseClass {
115
+ static _displayName = "Tooltip";
106
116
  _data;
107
117
  /** v4: optional per-chart parent element (default: global #d3plus-portal). */ _parentEl;
108
118
  /**
@@ -166,12 +176,12 @@ const tooltipSchema = [
166
176
  "text-align": "center"
167
177
  };
168
178
  this.schema.tooltipStyle = {
169
- "box-shadow": "0 1px 5px rgba(0, 0, 0, 0.25)",
170
- color: (d, i)=>colorContrast(this.schema.background(d, i), this.schema.colorDefaults),
179
+ "box-shadow": ()=>tokens(this).shadow,
180
+ color: (d, i)=>tooltipText(this, this.schema.background(d, i)),
171
181
  "font-family": fontFamilyStringify(fontFamily)
172
182
  };
173
183
  this.schema.trStyle = {
174
- "border-top": (d, i)=>i ? "1px solid rgba(0, 0, 0, 0.1)" : "none"
184
+ "border-top": (d, i)=>i ? `1px solid ${tokens(this).divider}` : "none"
175
185
  };
176
186
  // First column (labels) left-aligned, value columns right-aligned.
177
187
  const cellAlign = (_d, i)=>i ? "right" : "left";
@@ -0,0 +1,20 @@
1
+ import { fontFamilyStringify } from "@d3plus/text";
2
+ /** A family name without the quotes CSS lets it carry. */ const unquote = (family)=>family.trim().replace(/^(['"])(.*)\1$/, "$2");
3
+ /**
4
+ The CSS `font-family` a label is drawn with: the family its layout measured
5
+ (the first one in the configured list that is installed), then the families
6
+ listed after it. A renderer without the measured family then falls back
7
+ down the same list rather than to its default font, as when a chart drawn
8
+ on a server is opened in a browser that has different fonts.
9
+ @param configured The label's configured families, as an Array or a CSS list.
10
+ @param measured The family the layout measured with, from `fontExists`, or `false` when none was found.
11
+ */ export function fontStack(configured, measured) {
12
+ const list = (Array.isArray(configured) ? configured : configured.split(",")).map(unquote).filter(Boolean);
13
+ if (!measured) return fontFamilyStringify(list);
14
+ const family = unquote(measured);
15
+ const at = list.indexOf(family);
16
+ return fontFamilyStringify(at < 0 ? [
17
+ family,
18
+ ...list
19
+ ] : list.slice(at));
20
+ }