@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
@@ -0,0 +1,183 @@
1
+ /**
2
+ Nearest-point hover (`hoverDistance`): a pointer over empty space, or over
3
+ something other than a point mark, acts on the closest point mark within
4
+ `hoverDistance` pixels, read off the painted scene through a Voronoi
5
+ diagram.
6
+
7
+ @module
8
+ */ import { gestureHolds } from "../drawSteps/gestureHover.js";
9
+ import { facetPanelAt } from "../facet/facetPanel.js";
10
+ import { focusTargets } from "./focusTargets.js";
11
+ import { pointVoronoi } from "./pointVoronoi.js";
12
+ import { nodeShapeType } from "./shapeClassTargets.js";
13
+ /** The shape classes that draw a point. */ const POINT_SHAPES = [
14
+ "Circle",
15
+ "Rect"
16
+ ];
17
+ /**
18
+ Whether a scene node draws a point: a Circle or Rect shape (or another of
19
+ `shapes`) that isn't part of a composite (a Box's rect).
20
+ */ export function isPointShape(node, shapes = POINT_SHAPES) {
21
+ const shape = nodeShapeType(node);
22
+ return !!shape && shapes.includes(shape) && !node.owners?.length;
23
+ }
24
+ /**
25
+ The point marks of a painted scene, as Voronoi points: every chart mark
26
+ keyboard navigation could visit (so `::hit` duplicates, inert nodes, and
27
+ marks clipped out by a zoom are left out) that `isPoint` accepts, at its
28
+ surface-space center with its inscribed radius.
29
+ @param nodes The scene root's children (`viz._paintedScene.root.children`).
30
+ @param isPoint Which nodes count as point marks.
31
+ */ export function pointMarkTargets(nodes, isPoint) {
32
+ return focusTargets(nodes).filter((t)=>t.group === "shape" && t.pointIndex === undefined && isPoint(t.node)).map((t)=>({
33
+ x: t.center[0],
34
+ y: t.center[1],
35
+ r: Math.min(t.box.width, t.box.height) / 2,
36
+ item: t
37
+ }));
38
+ }
39
+ /** The pixel reach of nearest-point hover, or 0 when it is off for this chart. */ export function hoverReach(viz) {
40
+ const distance = Number(viz.schema.hoverDistance);
41
+ if (!(distance > 0) || !viz._pointMark) return 0;
42
+ // Plot's shared tooltip already snaps to the nearest discrete position.
43
+ const discrete = viz.schema.discrete === "x" || viz.schema.discrete === "y";
44
+ if (viz.schema.tooltipShared && discrete) return 0;
45
+ return distance;
46
+ }
47
+ /** The chart's diagrams for its current painted scene, rebuilt once per paint. */ function pointIndex(viz, state) {
48
+ const scene = viz._paintedScene;
49
+ if (state.index && state.index.scene === scene) return state.index;
50
+ const isPoint = (node)=>!!viz._pointMark?.(node);
51
+ const points = pointMarkTargets(scene?.root.children ?? [], isPoint);
52
+ const groups = new Map();
53
+ for (const p of points){
54
+ const key = facetPanelAt(viz, [
55
+ p.x,
56
+ p.y
57
+ ])?.key ?? "";
58
+ if (!groups.has(key)) groups.set(key, []);
59
+ groups.get(key).push(p);
60
+ }
61
+ const bounds = {
62
+ x: 0,
63
+ y: 0,
64
+ width: Number(viz.schema.width) || 0,
65
+ height: Number(viz.schema.height) || 0
66
+ };
67
+ const panels = new Map([
68
+ ...groups
69
+ ].map(([key, list])=>[
70
+ key,
71
+ pointVoronoi(list, bounds)
72
+ ]));
73
+ const byKey = new Map(points.map((p)=>[
74
+ String(p.item.node.key),
75
+ p.item
76
+ ]));
77
+ state.index = {
78
+ scene,
79
+ panels,
80
+ byKey
81
+ };
82
+ return state.index;
83
+ }
84
+ /**
85
+ The painted point mark a picked node stands for, while nearest-point
86
+ hover applies: the mark itself, or the one its `::hit` duplicate
87
+ widens. Undefined for anything else (bars, lines, legend items).
88
+ */ export function pointTarget(viz, node) {
89
+ if (!node || !hoverReach(viz) || !viz._pointMark(node)) return undefined;
90
+ const state = viz._nearestHover ??= {
91
+ key: null
92
+ };
93
+ const key = String(node.key).replace(/::hit$/, "");
94
+ return pointIndex(viz, state).byKey.get(key);
95
+ }
96
+ /**
97
+ The pick the pointer at `point` acts on, in place of `pick`: the nearest
98
+ point mark within `hoverDistance` (in the same small-multiples panel),
99
+ when `pick` is empty or something other than a point mark. A point mark,
100
+ a legend or timeline item, a trend line, or a mark's own label is kept as
101
+ picked, as is everything when nearest-point hover is off.
102
+ */ export function nearestPick(viz, pick, point) {
103
+ const reach = hoverReach(viz);
104
+ if (!reach || !point) return pick;
105
+ if (pick) {
106
+ const node = pick.node;
107
+ if (viz._pointMark(node)) return pick;
108
+ if (node.interactionGroup && node.interactionGroup !== "axis") return pick;
109
+ if (node.type === "text" && node.datum !== undefined) return pick;
110
+ }
111
+ const state = viz._nearestHover ??= {
112
+ key: null
113
+ };
114
+ const index = pointIndex(viz, state);
115
+ const panel = viz._facetPanels?.length ? facetPanelAt(viz, point) : null;
116
+ if (panel === undefined) return pick;
117
+ const voronoi = index.panels.get(panel?.key ?? "");
118
+ const match = voronoi?.nearest(point[0], point[1], reach);
119
+ if (!match) return pick;
120
+ const node = match.point.item.node;
121
+ return {
122
+ node,
123
+ datum: node.datum,
124
+ index: node.index
125
+ };
126
+ }
127
+ /**
128
+ The renderer's pointer bridge: resolves each event's pick through
129
+ `nearestPick` and hands it to `viz._routeSceneEvent` (a click that
130
+ resolves to nothing also runs `viz._backgroundClick`), firing
131
+ mouseleave/mouseenter whenever the mark the pointer resolves to changes
132
+ (in place of the renderer's own, which follow the raw pick). Events that
133
+ don't come from the renderer's pointer listeners pass through unchanged
134
+ apart from the pick.
135
+ */ export function routePointerEvent(viz, event) {
136
+ // A zoom gesture moving the chart holds pointer events until it ends.
137
+ if (gestureHolds(viz)) return;
138
+ const route = (e)=>viz._routeSceneEvent?.(e);
139
+ const state = viz._nearestHover ??= {
140
+ key: null
141
+ };
142
+ const native = event.nativeEvent?.type;
143
+ const fromMove = native === "mousemove";
144
+ if (event.type === "mouseenter" || event.type === "mouseleave") {
145
+ // The renderer's own crossing between picks: replaced below.
146
+ if (fromMove) return;
147
+ // Leaving the SVG scene for the empty space around it, which routes its
148
+ // own moves (see `nearestHoverSurface`): not leaving the chart.
149
+ const to = event.nativeEvent?.relatedTarget;
150
+ if (event.type === "mouseleave" && state.surface?.aroundScene(to ?? null) && hoverReach(viz)) return;
151
+ state.key = event.type === "mouseenter" && event.pick ? String(event.pick.node.key) : null;
152
+ route(event);
153
+ return;
154
+ }
155
+ const pick = nearestPick(viz, event.pick, event.point);
156
+ const resolved = pick === event.pick ? event : {
157
+ ...event,
158
+ pick
159
+ };
160
+ // A click on no mark reaches the chart's background (on SVG, a Network's
161
+ // background rect takes it before the renderer does).
162
+ if (event.type === "click" && !pick && event.point) viz._backgroundClick?.(event.point);
163
+ if (event.type === "mousemove" && fromMove) {
164
+ const key = pick ? String(pick.node.key) : null;
165
+ if (key !== state.key) {
166
+ const { point, nativeEvent } = event;
167
+ if (state.key !== null) route({
168
+ type: "mouseleave",
169
+ point,
170
+ pick: null,
171
+ nativeEvent
172
+ });
173
+ state.key = key;
174
+ if (pick) route({
175
+ type: "mouseenter",
176
+ point,
177
+ pick,
178
+ nativeEvent
179
+ });
180
+ }
181
+ }
182
+ route(resolved);
183
+ }
@@ -0,0 +1,92 @@
1
+ /**
2
+ Nearest-point hover over the empty space of an SVG chart. A nested `<svg>`
3
+ only receives pointer events over what it paints, so moves and clicks over
4
+ the space between marks land on the chart's outer `<svg>` (or the zoom
5
+ surface, map tiles, or Network background inside it) and never reach the
6
+ SVG renderer. This routes them to the chart as pointer events over
7
+ nothing, which `routePointerEvent` resolves to the nearest point. The
8
+ Canvas renderer's surface covers the whole chart and needs none of it.
9
+
10
+ @module
11
+ */ import { hoverReach, nearestPick, routePointerEvent } from "./nearestHover.js";
12
+ import { surfaceOrigin } from "./pointTooltipAnchor.js";
13
+ /** Chart DOM that keeps its own pointer handling (the timeline and brushes). */ const OWN_POINTER = "g.d3plus-viz-timeline, g.d3plus-viz-brush, g.d3plus-zoom-brush";
14
+ /** The SVG renderer's own `<svg>`, if it is mounted. */ function sceneSvg(viz) {
15
+ const elements = viz._sceneRenderer?.elements?.() ?? [];
16
+ return elements.find((el)=>el.localName === "svg");
17
+ }
18
+ /**
19
+ Routes pointer events from the empty space around an SVG chart's scene
20
+ (see the module comment) while `hoverDistance` applies, binding to the
21
+ chart's outer `<svg>` once and rebinding when it changes. A click there
22
+ that resolves to a point is that point's alone: it stops before reaching
23
+ the chart DOM under the pointer (a Network's background, which clears
24
+ its focus). Removes the listeners on the Canvas renderer.
25
+ */ export function nearestHoverSurface(viz, unbind = false) {
26
+ const state = viz._nearestHover ??= {
27
+ key: null
28
+ };
29
+ const outer = viz._select?.node?.();
30
+ const svg = viz._renderer === "canvas" || unbind ? undefined : outer;
31
+ if (state.surface && state.surface.el === svg) return;
32
+ state.surface?.unbind();
33
+ state.surface = undefined;
34
+ if (!svg || typeof svg.addEventListener !== "function") return;
35
+ const aroundScene = (el)=>{
36
+ const node = el;
37
+ const scene = sceneSvg(viz);
38
+ return !!node && typeof node.closest === "function" && svg.contains(node) && !(scene && scene.contains(node)) && !node.closest(OWN_POINTER);
39
+ };
40
+ const local = (e)=>{
41
+ const origin = surfaceOrigin(viz);
42
+ return [
43
+ e.clientX - origin.left,
44
+ e.clientY - origin.top
45
+ ];
46
+ };
47
+ const applies = (e)=>aroundScene(e.target) && hoverReach(viz) > 0;
48
+ const move = (e)=>{
49
+ if (!applies(e)) return;
50
+ const point = local(e);
51
+ routePointerEvent(viz, {
52
+ type: "mousemove",
53
+ point,
54
+ pick: null,
55
+ nativeEvent: e
56
+ });
57
+ };
58
+ const click = (e)=>{
59
+ if (!applies(e)) return;
60
+ const point = local(e);
61
+ if (!nearestPick(viz, null, point)) return;
62
+ e.stopPropagation();
63
+ routePointerEvent(viz, {
64
+ type: "click",
65
+ point,
66
+ pick: null,
67
+ nativeEvent: e
68
+ });
69
+ };
70
+ const leave = (e)=>{
71
+ if (state.key === null) return;
72
+ const point = local(e);
73
+ routePointerEvent(viz, {
74
+ type: "mouseleave",
75
+ point,
76
+ pick: null,
77
+ nativeEvent: e
78
+ });
79
+ };
80
+ svg.addEventListener("mousemove", move);
81
+ svg.addEventListener("click", click, true);
82
+ svg.addEventListener("mouseleave", leave);
83
+ state.surface = {
84
+ el: svg,
85
+ aroundScene,
86
+ unbind: ()=>{
87
+ svg.removeEventListener("mousemove", move);
88
+ svg.removeEventListener("click", click, true);
89
+ svg.removeEventListener("mouseleave", leave);
90
+ }
91
+ };
92
+ }
@@ -1,16 +1,19 @@
1
1
  import { scaleOrdinal } from "d3-scale";
2
- import { colorDefaults, colorRamp } from "@d3plus/color";
2
+ import { colorDefaults } from "@d3plus/color";
3
+ import { themeRamp, themeScaleColor } from "../../utils/theme.js";
3
4
  /**
4
5
  Stamps `viz._ordinalColorScale` for ordinal color mode.
5
6
 
6
- When `colorOrdinal` is on (and no continuous `colorScale` is set), a discrete
7
- color field is treated as *ordered*: its distinct values take a single-hue
8
- light→dark ramp so the color encodes the order. This walks the drawn data to
9
- collect the distinct values in a stable order — numeric values sort
10
- ascending; everything else keeps the order it first appears in the data
11
- (pre-sort your data, or drive it with the existing ordering config, to
12
- control non-numeric ramps) — then maps them onto an OKLab ramp of the
13
- default sequential hue. Clears the scale when the mode is off.
7
+ When `colorOrdinal` is on (and no continuous `colorScale` is set), a
8
+ discrete color field is treated as *ordered*: its distinct values take a
9
+ single-hue ramp so the color encodes the order (light→dark, or dim→bright
10
+ on a dark theme). This walks the drawn data to collect the distinct values
11
+ in a stable order — numeric values sort ascending; everything else keeps
12
+ the order it first appears in the data (pre-sort your data, or drive it
13
+ with the existing ordering config, to control non-numeric ramps) — then
14
+ maps them onto an OKLab ramp of the default sequential hue (the theme's
15
+ `colorScale.max` on a dark or custom theme). Clears the scale when the
16
+ mode is off.
14
17
  */ export function configureOrdinalColor(viz) {
15
18
  if (!viz.schema.colorOrdinal || viz.schema.colorScale) {
16
19
  viz._ordinalColorScale = undefined;
@@ -32,8 +35,7 @@ import { colorDefaults, colorRamp } from "@d3plus/color";
32
35
  ...values
33
36
  ].sort((a, b)=>a - b) : values;
34
37
  const keys = ordered.map((v)=>typeof v === "string" ? v : JSON.stringify(v));
35
- const range = colorRamp((viz.schema.colorDefaults ?? colorDefaults).sequential, keys.length || 1, {
36
- ordinal: true
37
- });
38
+ const base = themeScaleColor(viz._theme, "max", (viz.schema.colorDefaults ?? colorDefaults).sequential);
39
+ const range = themeRamp(viz._theme, base, keys.length || 1, true);
38
40
  viz._ordinalColorScale = scaleOrdinal().domain(keys).range(range);
39
41
  }
@@ -0,0 +1,83 @@
1
+ /**
2
+ Reads the page behind a chart (light or dark, and its background) and
3
+ redraws an `"auto"` themed chart when the page flips between the two.
4
+
5
+ @module
6
+ */ import { isDarkColor } from "../../utils/theme.js";
7
+ const WHITE = "rgb(255, 255, 255)";
8
+ /** Whether a computed background paints anything. */ const opaque = (bg)=>Boolean(bg) && bg !== "transparent" && bg !== "rgba(0, 0, 0, 0)";
9
+ /**
10
+ The page behind the chart: the first non-transparent background among its
11
+ ancestors decides, or, when none sets one, the browser's own page canvas,
12
+ which is dark only when the page opts into a dark `color-scheme` and the
13
+ system prefers dark. Server renders are light.
14
+ */ export function pageTheme(viz) {
15
+ if (viz._ssr || typeof window === "undefined" || typeof getComputedStyle !== "function") return {
16
+ dark: false,
17
+ background: WHITE
18
+ };
19
+ let node = viz._select?.node?.() ?? null;
20
+ while(node){
21
+ const bg = getComputedStyle(node).backgroundColor;
22
+ if (opaque(bg)) return {
23
+ dark: isDarkColor(bg),
24
+ background: bg
25
+ };
26
+ node = node.parentElement;
27
+ }
28
+ const scheme = getComputedStyle(document.documentElement).colorScheme || "";
29
+ const dark = scheme.includes("dark") && (!scheme.includes("light") || typeof matchMedia === "function" && matchMedia("(prefers-color-scheme: dark)").matches);
30
+ return dark ? {
31
+ dark
32
+ } : {
33
+ dark,
34
+ background: WHITE
35
+ };
36
+ }
37
+ /** Whether the chart sits on a dark page (see `pageTheme`). */ export function pageIsDark(viz) {
38
+ return pageTheme(viz).dark;
39
+ }
40
+ /**
41
+ Calls `onFlip` whenever the page might have changed theme: on a system
42
+ theme change, when the page flips a class/attribute/style on `<html>` or
43
+ `<body>` (how most theme toggles work), or when a background transition
44
+ ends. Returns the unsubscribe.
45
+ */ export function watchPage(onFlip) {
46
+ if (typeof window === "undefined" || typeof document === "undefined") return ()=>undefined;
47
+ const media = typeof matchMedia === "function" ? matchMedia("(prefers-color-scheme: dark)") : null;
48
+ media?.addEventListener?.("change", onFlip);
49
+ const observer = typeof MutationObserver === "function" ? new MutationObserver(onFlip) : null;
50
+ for (const el of [
51
+ document.documentElement,
52
+ document.body
53
+ ])if (el) observer?.observe(el, {
54
+ attributes: true
55
+ });
56
+ // A page that animates its background lands on the new color only once the
57
+ // transition ends.
58
+ const onTransition = (event)=>{
59
+ if (/background/.test(event.propertyName || "")) onFlip();
60
+ };
61
+ document.addEventListener("transitionend", onTransition);
62
+ return ()=>{
63
+ media?.removeEventListener?.("change", onFlip);
64
+ observer?.disconnect();
65
+ document.removeEventListener("transitionend", onTransition);
66
+ };
67
+ }
68
+ /**
69
+ Keeps an `"auto"` themed chart in step with its page: redraws it when the
70
+ page's dark state differs from the one it last drew with. Installed once
71
+ per chart; `unwatchPageTheme` removes it.
72
+ */ export function watchPageTheme(viz) {
73
+ if (viz._themeWatch || viz._ssr || typeof window === "undefined") return;
74
+ viz._themeWatch = watchPage(()=>{
75
+ const host = viz._select?.node?.();
76
+ if (!host || !host.isConnected || !viz._theme || viz._theme.painted) return;
77
+ if (pageIsDark(viz) !== viz._theme.dark) viz.render?.();
78
+ });
79
+ }
80
+ /** Stops a chart's page-theme watcher, if it has one. */ export function unwatchPageTheme(viz) {
81
+ viz._themeWatch?.();
82
+ viz._themeWatch = undefined;
83
+ }
@@ -0,0 +1,59 @@
1
+ /**
2
+ Where a hovered point mark's tooltip points: the mark's painted box, in
3
+ client coordinates, so the tooltip's arrow meets the middle of its top
4
+ edge (its bottom edge when the tooltip flips below) and holds still
5
+ while the pointer moves within reach of the same point.
6
+
7
+ @module
8
+ */ import { pointTarget } from "./nearestHover.js";
9
+ /**
10
+ The client position of the drawing surface's origin: the scene `<svg>`'s
11
+ user-space origin (read off its screen CTM: a nested svg's bounding rect
12
+ is the box of its painted content), or the `<canvas>`'s corner. Falls
13
+ back to the chart's own element, then to the viewport origin.
14
+ */ export function surfaceOrigin(viz) {
15
+ const elements = viz._sceneRenderer?.elements?.() ?? [];
16
+ const surface = elements.find((el)=>el.localName === "svg" || el.localName === "canvas") ?? viz._select?.node?.();
17
+ if (!surface) return {
18
+ left: 0,
19
+ top: 0
20
+ };
21
+ const ctm = surface.localName === "svg" && typeof surface.getScreenCTM === "function" ? surface.getScreenCTM() : null;
22
+ if (ctm) return {
23
+ left: ctm.e,
24
+ top: ctm.f
25
+ };
26
+ const rect = surface.getBoundingClientRect();
27
+ return {
28
+ left: rect.left,
29
+ top: rect.top
30
+ };
31
+ }
32
+ /**
33
+ A tooltip anchor (a Floating UI virtual element) for a box in surface
34
+ coordinates, moved to client coordinates by `origin`.
35
+ */ export function clientAnchor(box, origin) {
36
+ const x = origin.left + box.x, y = origin.top + box.y;
37
+ const rect = {
38
+ x,
39
+ y,
40
+ left: x,
41
+ top: y,
42
+ right: x + box.width,
43
+ bottom: y + box.height,
44
+ width: box.width,
45
+ height: box.height
46
+ };
47
+ return {
48
+ getBoundingClientRect: ()=>rect
49
+ };
50
+ }
51
+ /**
52
+ The tooltip anchor for a hovered node: its point mark's painted box when
53
+ nearest-point hover applies to it (see `pointTarget`), whether the
54
+ pointer is on the mark or only near it. Undefined otherwise, for the
55
+ tooltip to follow the pointer.
56
+ */ export function pointTooltipAnchor(viz, node) {
57
+ const target = pointTarget(viz, node);
58
+ return target ? clientAnchor(target.box, surfaceOrigin(viz)) : undefined;
59
+ }
@@ -0,0 +1,124 @@
1
+ /**
2
+ A Voronoi diagram over a set of points: the nearest point to a position
3
+ (within a distance, measured from each point's edge), and each point's
4
+ clipped cell and neighbors.
5
+
6
+ @module
7
+ */ import { Delaunay } from "d3-delaunay";
8
+ /** The smallest box holding `bounds` and every point. */ function grownBounds(points, bounds) {
9
+ let x0 = bounds.x, y0 = bounds.y, x1 = bounds.x + bounds.width, y1 = bounds.y + bounds.height;
10
+ for (const p of points){
11
+ x0 = Math.min(x0, p.x);
12
+ y0 = Math.min(y0, p.y);
13
+ x1 = Math.max(x1, p.x);
14
+ y1 = Math.max(y1, p.y);
15
+ }
16
+ return {
17
+ x: x0,
18
+ y: y0,
19
+ width: x1 - x0,
20
+ height: y1 - y0
21
+ };
22
+ }
23
+ /** The distance from `[x, y]` to the segment `a`–`b`. */ function segmentDistance(x, y, [ax, ay], [bx, by]) {
24
+ const dx = bx - ax, dy = by - ay;
25
+ const len = dx * dx + dy * dy;
26
+ const t = len ? Math.max(0, Math.min(1, ((x - ax) * dx + (y - ay) * dy) / len)) : 0;
27
+ return Math.hypot(x - (ax + t * dx), y - (ay + t * dy));
28
+ }
29
+ /** The distance from `[x, y]` to a polygon (0 inside it). */ export function polygonDistance(x, y, ring) {
30
+ let inside = false, min = Infinity;
31
+ for(let i = 0, j = ring.length - 1; i < ring.length; j = i++){
32
+ const [xi, yi] = ring[i], [xj, yj] = ring[j];
33
+ if (yi > y !== yj > y && x < (xj - xi) * (y - yi) / (yj - yi) + xi) inside = !inside;
34
+ min = Math.min(min, segmentDistance(x, y, ring[j], ring[i]));
35
+ }
36
+ return inside ? 0 : min;
37
+ }
38
+ /**
39
+ Builds a Voronoi diagram over `points` (with d3-delaunay), clipped to
40
+ `bounds`. Points with a non-finite coordinate are left out of the
41
+ diagram: `nearest` never returns them and their `cell` is null. The
42
+ Delaunay triangulation is built up front; the clipped cells only on the
43
+ first call that needs them.
44
+ @param points The points, in surface coordinates.
45
+ @param bounds The box to clip cells to (grown to hold every point).
46
+ */ export function pointVoronoi(points, bounds) {
47
+ const valid = points.map((_, i)=>i).filter((i)=>Number.isFinite(points[i].x) && Number.isFinite(points[i].y));
48
+ const box = grownBounds(valid.map((i)=>points[i]), bounds);
49
+ const delaunay = Delaunay.from(valid, (i)=>points[i].x, (i)=>points[i].y);
50
+ // Positions in `valid` (the diagram's own indices) for each input index.
51
+ const slot = new Map(valid.map((i, s)=>[
52
+ i,
53
+ s
54
+ ]));
55
+ const radius = (p)=>Number.isFinite(p.r) ? Math.max(0, p.r) : 0;
56
+ const maxRadius = valid.reduce((m, i)=>Math.max(m, radius(points[i])), 0);
57
+ let voronoi;
58
+ const diagram = ()=>voronoi ??= delaunay.voronoi([
59
+ box.x,
60
+ box.y,
61
+ box.x + box.width,
62
+ box.y + box.height
63
+ ]);
64
+ const cellOf = (s)=>{
65
+ const polygon = diagram().cellPolygon(s);
66
+ return polygon ? polygon.slice(0, -1) : null;
67
+ };
68
+ const neighborSlots = (s)=>[
69
+ ...delaunay.neighbors(s)
70
+ ].filter((n)=>n >= 0);
71
+ const nearest = (x, y, maxDistance = Infinity)=>{
72
+ if (!valid.length || !Number.isFinite(x) || !Number.isFinite(y)) return null;
73
+ const start = delaunay.find(x, y);
74
+ const centerOf = (s)=>Math.hypot(points[valid[s]].x - x, points[valid[s]].y - y);
75
+ // Every point whose edge is within reach has its center within `reach`,
76
+ // so its cell meets the disk of that radius; those cells are connected,
77
+ // so a walk out from the nearest center finds them all.
78
+ const reach = maxDistance + maxRadius;
79
+ if (centerOf(start) > reach) return null;
80
+ let best = null, bestCenter = Infinity;
81
+ const seen = new Set([
82
+ start
83
+ ]);
84
+ const queue = [
85
+ start
86
+ ];
87
+ while(queue.length){
88
+ const s = queue.shift();
89
+ const index = valid[s];
90
+ const point = points[index];
91
+ const center = centerOf(s);
92
+ const distance = Math.max(0, center - radius(point));
93
+ if (distance <= maxDistance && (!best || distance < best.distance || distance === best.distance && (center < bestCenter || center === bestCenter && index < best.index))) {
94
+ best = {
95
+ index,
96
+ point,
97
+ distance
98
+ };
99
+ bestCenter = center;
100
+ }
101
+ for (const n of neighborSlots(s)){
102
+ if (seen.has(n)) continue;
103
+ seen.add(n);
104
+ const ring = cellOf(n);
105
+ if (ring && polygonDistance(x, y, ring) <= reach) queue.push(n);
106
+ }
107
+ }
108
+ return best;
109
+ };
110
+ return {
111
+ points,
112
+ bounds: box,
113
+ nearest,
114
+ cell: (index)=>{
115
+ const s = slot.get(index);
116
+ return s === undefined ? null : cellOf(s);
117
+ },
118
+ neighbors: (index)=>{
119
+ const s = slot.get(index);
120
+ if (s === undefined) return [];
121
+ return neighborSlots(s).map((n)=>valid[n]).sort((a, b)=>a - b);
122
+ }
123
+ };
124
+ }
@@ -0,0 +1,27 @@
1
+ /** The `reducedMotion` setting: follow the OS (`"auto"`), or force it on or off. */ /**
2
+ Whether the viewer's OS asks for reduced motion, read from the
3
+ `(prefers-reduced-motion: reduce)` media query. False without a `window`
4
+ or `matchMedia` (server-side rendering, older runtimes).
5
+ */ export function prefersReducedMotion() {
6
+ if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
7
+ try {
8
+ return !!window.matchMedia("(prefers-reduced-motion: reduce)").matches;
9
+ } catch {
10
+ return false;
11
+ }
12
+ }
13
+ /**
14
+ Whether a chart draws without motion: `reducedMotion` `true` always,
15
+ `false` never, and `"auto"` (or unset) when the OS asks for it.
16
+ */ export function motionReduced(host) {
17
+ const setting = host.schema.reducedMotion;
18
+ if (setting === true) return true;
19
+ if (setting === false) return false;
20
+ return prefersReducedMotion();
21
+ }
22
+ /**
23
+ The transition duration a chart animates with: 0 when motion is reduced,
24
+ otherwise its `duration` (the stored `duration` is left as the user set it).
25
+ */ export function effectiveDuration(host) {
26
+ return motionReduced(host) ? 0 : Number(host.schema.duration) || 0;
27
+ }
@@ -2,6 +2,7 @@ import { isData, load } from "@d3plus/data";
2
2
  import { warnConfig } from "../../utils/configWarnings.js";
3
3
  import { createDataPoller } from "./dataPoller.js";
4
4
  import { canObserveVisibility, observeVisibility } from "./vizVisibility.js";
5
+ import { displayName } from "../../utils/displayName.js";
5
6
  /**
6
7
  Whether a `data` value is fetched: a URL, a request object, or an Array
7
8
  holding at least one of them.
@@ -85,11 +86,15 @@ import { canObserveVisibility, observeVisibility } from "./vizVisibility.js";
85
86
  viz._dataPollStop = undefined;
86
87
  viz._dataPollFor = undefined;
87
88
  }
89
+ /** The chart's `dataFormat`, which every poll runs. */ function dataFormatter(viz) {
90
+ const f = viz.schema.dataFormat;
91
+ return typeof f === "function" ? f : undefined;
92
+ }
88
93
  /** What a running poll was started for; a change restarts it. */ function pollKey(viz) {
89
94
  return [
90
95
  viz.schema.dataPollingInterval,
91
96
  viz._userData,
92
- viz._userDataFormat,
97
+ dataFormatter(viz),
93
98
  viz.schema.detectVisible,
94
99
  viz.schema.scrollContainer
95
100
  ];
@@ -106,7 +111,7 @@ import { canObserveVisibility, observeVisibility } from "./vizVisibility.js";
106
111
  }
107
112
  /** Starts polling `viz._userData` every `interval` ms. */ function startDataPolling(viz, interval) {
108
113
  const source = viz._userData;
109
- const formatter = viz._userDataFormat;
114
+ const formatter = dataFormatter(viz);
110
115
  const doc = viz._select?.node()?.ownerDocument;
111
116
  let offscreen = false;
112
117
  const poller = createDataPoller({
@@ -144,7 +149,7 @@ import { canObserveVisibility, observeVisibility } from "./vizVisibility.js";
144
149
  const interval = viz.schema.dataPollingInterval;
145
150
  const wanted = typeof interval === "number" && interval > 0 && isFinite(interval);
146
151
  if (wanted && !isPollable(viz._userData)) {
147
- warnConfig(`${viz.constructor.name}: dataPollingInterval only polls data loaded from a URL.`);
152
+ warnConfig(`${displayName(viz)}: dataPollingInterval only polls data loaded from a URL.`);
148
153
  }
149
154
  if (!wanted || viz._ssr || !isPollable(viz._userData)) {
150
155
  stopDataPolling(viz);