@d3plus/core 4.10.0 → 4.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/es/index.js +1 -1
  2. package/es/internal.js +178 -9
  3. package/es/src/charts/Alluvial/aggregate.js +145 -0
  4. package/es/src/charts/Alluvial/applyLayout.js +125 -0
  5. package/es/src/charts/Alluvial/dimensions.js +56 -0
  6. package/es/src/charts/Alluvial/emit.js +73 -0
  7. package/es/src/charts/Alluvial/hover.js +101 -0
  8. package/es/src/charts/Alluvial/index.js +176 -0
  9. package/es/src/charts/Alluvial/layout.js +137 -0
  10. package/es/src/charts/Alluvial/meta.js +57 -0
  11. package/es/src/charts/Alluvial/titles.js +101 -0
  12. package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
  13. package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
  14. package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
  15. package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
  16. package/es/src/charts/ArcDiagram/emit.js +192 -0
  17. package/es/src/charts/ArcDiagram/events.js +148 -0
  18. package/es/src/charts/ArcDiagram/index.js +217 -0
  19. package/es/src/charts/BarChart/index.js +12 -7
  20. package/es/src/charts/BoxWhisker/index.js +22 -0
  21. package/es/src/charts/BubbleChart/emit.js +31 -0
  22. package/es/src/charts/BubbleChart/index.js +54 -0
  23. package/es/src/charts/Calendar/emit.js +1 -1
  24. package/es/src/charts/Calendar/index.js +5 -2
  25. package/es/src/charts/Candlestick/buffer.js +6 -4
  26. package/es/src/charts/Candlestick/index.js +6 -11
  27. package/es/src/charts/Chord/applyLayout.js +56 -69
  28. package/es/src/charts/Chord/emit.js +55 -24
  29. package/es/src/charts/Chord/index.js +14 -10
  30. package/es/src/charts/Chord/labels.js +105 -0
  31. package/es/src/charts/Donut/index.js +5 -11
  32. package/es/src/charts/Dumbbell/index.js +2 -4
  33. package/es/src/charts/Gantt/applyLayout.js +160 -0
  34. package/es/src/charts/Gantt/emit.js +142 -0
  35. package/es/src/charts/Gantt/ganttDecor.js +207 -0
  36. package/es/src/charts/Gantt/ganttGeometry.js +107 -0
  37. package/es/src/charts/Gantt/ganttLabels.js +85 -0
  38. package/es/src/charts/Gantt/ganttRows.js +111 -0
  39. package/es/src/charts/Gantt/ganttTooltip.js +136 -0
  40. package/es/src/charts/Gantt/index.js +219 -0
  41. package/es/src/charts/Geomap/applyLayout.js +90 -49
  42. package/es/src/charts/Geomap/basemapTheme.js +3 -48
  43. package/es/src/charts/Geomap/emit.js +19 -2
  44. package/es/src/charts/Geomap/flowEmit.js +137 -0
  45. package/es/src/charts/Geomap/flowEvents.js +86 -0
  46. package/es/src/charts/Geomap/flowFields.js +91 -0
  47. package/es/src/charts/Geomap/flowGeometry.js +225 -0
  48. package/es/src/charts/Geomap/flowLinks.js +239 -0
  49. package/es/src/charts/Geomap/geoCache.js +180 -0
  50. package/es/src/charts/Geomap/globeKeys.js +131 -0
  51. package/es/src/charts/Geomap/globeRotate.js +208 -0
  52. package/es/src/charts/Geomap/index.js +51 -16
  53. package/es/src/charts/Geomap/pointLabels.js +107 -0
  54. package/es/src/charts/Hexbin/binning.js +103 -0
  55. package/es/src/charts/Hexbin/buffer.js +33 -0
  56. package/es/src/charts/Hexbin/contourLabels.js +234 -0
  57. package/es/src/charts/Hexbin/contours.js +48 -0
  58. package/es/src/charts/Hexbin/emit.js +142 -0
  59. package/es/src/charts/Hexbin/index.js +206 -0
  60. package/es/src/charts/Hexbin/layers.js +212 -0
  61. package/es/src/charts/Hexbin/settings.js +86 -0
  62. package/es/src/charts/Hexbin/tooltip.js +77 -0
  63. package/es/src/charts/Histogram/binData.js +31 -4
  64. package/es/src/charts/Histogram/index.js +32 -15
  65. package/es/src/charts/Histogram/labels.js +18 -0
  66. package/es/src/charts/Icicle/index.js +6 -4
  67. package/es/src/charts/LinePlot/index.js +7 -0
  68. package/es/src/charts/Marimekko/index.js +7 -4
  69. package/es/src/charts/Matrix/applyLayout.js +20 -9
  70. package/es/src/charts/Matrix/index.js +19 -1
  71. package/es/src/charts/Network/applyLayout.js +171 -96
  72. package/es/src/charts/Network/bundle.js +82 -0
  73. package/es/src/charts/Network/clusterLabels.js +423 -0
  74. package/es/src/charts/Network/clusters.js +290 -0
  75. package/es/src/charts/Network/emit.js +257 -75
  76. package/es/src/charts/Network/graph.js +146 -0
  77. package/es/src/charts/Network/graphFluent.js +81 -0
  78. package/es/src/charts/Network/index.js +91 -106
  79. package/es/src/charts/Network/minNodeDistance.js +64 -0
  80. package/es/src/charts/Network/polygonRows.js +44 -0
  81. package/es/src/charts/Pack/applyLayout.js +16 -5
  82. package/es/src/charts/Pack/emit.js +15 -8
  83. package/es/src/charts/Pack/groupRows.js +61 -0
  84. package/es/src/charts/Pack/index.js +8 -1
  85. package/es/src/charts/Pack/neutralPaint.js +20 -0
  86. package/es/src/charts/Pack/nodeNames.js +35 -0
  87. package/es/src/charts/ParallelCoordinates/axes.js +22 -22
  88. package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
  89. package/es/src/charts/ParallelCoordinates/index.js +3 -1
  90. package/es/src/charts/ParallelCoordinates/titles.js +17 -9
  91. package/es/src/charts/Pie/applyLayout.js +86 -27
  92. package/es/src/charts/Pie/arcFit.js +152 -0
  93. package/es/src/charts/Pie/curvedLabels.js +134 -0
  94. package/es/src/charts/Pie/emit.js +51 -96
  95. package/es/src/charts/Pie/index.js +74 -31
  96. package/es/src/charts/Pie/labelRoom.js +154 -0
  97. package/es/src/charts/Pie/outsideLabels.js +224 -0
  98. package/es/src/charts/Pie/outsideNodes.js +267 -0
  99. package/es/src/charts/Pie/pieLabels.js +137 -0
  100. package/es/src/charts/Pie/sectorBox.js +223 -0
  101. package/es/src/charts/Pie/straightLabels.js +96 -0
  102. package/es/src/charts/Pie/straightLayout.js +215 -0
  103. package/es/src/charts/Plot/alongLegend.js +76 -0
  104. package/es/src/charts/Plot/areaEnter.js +68 -0
  105. package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
  106. package/es/src/charts/Plot/axisHoverScene.js +2 -1
  107. package/es/src/charts/Plot/axisValues.js +43 -0
  108. package/es/src/charts/Plot/barWidth.js +59 -11
  109. package/es/src/charts/Plot/circleLabels.js +98 -0
  110. package/es/src/charts/Plot/connectGaps.js +237 -0
  111. package/es/src/charts/Plot/connectGapsScene.js +188 -0
  112. package/es/src/charts/Plot/draw.js +34 -14
  113. package/es/src/charts/Plot/fillBetween.js +2 -1
  114. package/es/src/charts/Plot/forecastScene.js +3 -4
  115. package/es/src/charts/Plot/index.js +19 -17
  116. package/es/src/charts/Plot/labelPlacement.js +1 -1
  117. package/es/src/charts/Plot/lineLabelEmit.js +82 -0
  118. package/es/src/charts/Plot/lineLabelSides.js +51 -0
  119. package/es/src/charts/Plot/lineLabelSpread.js +65 -0
  120. package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
  121. package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
  122. package/es/src/charts/Plot/pipeline.js +66 -19
  123. package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
  124. package/es/src/charts/Plot/pipelineDomains.js +16 -3
  125. package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
  126. package/es/src/charts/Plot/pipelineScales.js +40 -8
  127. package/es/src/charts/Plot/plotFacet.js +12 -1
  128. package/es/src/charts/Plot/plotInit.js +40 -5
  129. package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
  130. package/es/src/charts/Plot/referenceDomains.js +133 -0
  131. package/es/src/charts/Plot/shapeDefaults.js +10 -5
  132. package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
  133. package/es/src/charts/Plot/sharedHover.js +2 -1
  134. package/es/src/charts/Plot/sharedTooltip.js +13 -3
  135. package/es/src/charts/Plot/stackLegendOrder.js +176 -0
  136. package/es/src/charts/Plot/trendLabels.js +183 -0
  137. package/es/src/charts/Plot/trendLines.js +1 -0
  138. package/es/src/charts/Plot/trendScene.js +6 -3
  139. package/es/src/charts/Plot/trendTooltip.js +5 -1
  140. package/es/src/charts/PolarArea/index.js +4 -3
  141. package/es/src/charts/Priestley/applyLayout.js +21 -23
  142. package/es/src/charts/Priestley/index.js +4 -37
  143. package/es/src/charts/Priestley/timeAxis.js +103 -0
  144. package/es/src/charts/Pyramid/gutter.js +52 -16
  145. package/es/src/charts/Pyramid/index.js +55 -7
  146. package/es/src/charts/Pyramid/scene.js +4 -4
  147. package/es/src/charts/Radar/applyLayout.js +31 -33
  148. package/es/src/charts/Radar/axisDecorations.js +62 -13
  149. package/es/src/charts/Radar/curvedLabels.js +228 -0
  150. package/es/src/charts/Radar/emit.js +30 -15
  151. package/es/src/charts/Radar/index.js +43 -5
  152. package/es/src/charts/Radar/points.js +85 -0
  153. package/es/src/charts/RadialBar/curvedLabels.js +111 -0
  154. package/es/src/charts/RadialBar/emit.js +9 -1
  155. package/es/src/charts/RadialBar/index.js +26 -9
  156. package/es/src/charts/RadialBar/trackLayout.js +43 -13
  157. package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
  158. package/es/src/charts/RadialMatrix/index.js +18 -9
  159. package/es/src/charts/Rings/applyLayout.js +39 -161
  160. package/es/src/charts/Rings/emit.js +219 -63
  161. package/es/src/charts/Rings/index.js +88 -32
  162. package/es/src/charts/Rings/ringsCurves.js +156 -0
  163. package/es/src/charts/Rings/ringsGraph.js +28 -9
  164. package/es/src/charts/Rings/ringsLoops.js +73 -0
  165. package/es/src/charts/Rings/ringsParallel.js +183 -0
  166. package/es/src/charts/Rings/ringsPlacement.js +152 -0
  167. package/es/src/charts/Rings/ringsSizing.js +61 -38
  168. package/es/src/charts/Sankey/applyLayout.js +130 -39
  169. package/es/src/charts/Sankey/circularLayout.js +208 -0
  170. package/es/src/charts/Sankey/circularLinks.js +301 -0
  171. package/es/src/charts/Sankey/emit.js +164 -94
  172. package/es/src/charts/Sankey/index.js +78 -75
  173. package/es/src/charts/Sankey/labels.js +80 -0
  174. package/es/src/charts/Sankey/ribbons.js +88 -0
  175. package/es/src/charts/Sankey/sankeyCycles.js +117 -0
  176. package/es/src/charts/Sankey/sankeyLayout.js +8 -3
  177. package/es/src/charts/Sankey/sankeyLinks.js +47 -0
  178. package/es/src/charts/Scatter/index.js +25 -0
  179. package/es/src/charts/SlopeChart/index.js +116 -0
  180. package/es/src/charts/SlopeChart/slope.js +95 -0
  181. package/es/src/charts/Streamgraph/index.js +51 -0
  182. package/es/src/charts/Sunburst/curvedLabels.js +74 -0
  183. package/es/src/charts/Sunburst/emit.js +83 -64
  184. package/es/src/charts/Sunburst/index.js +16 -4
  185. package/es/src/charts/Tree/applyLayout.js +44 -14
  186. package/es/src/charts/Tree/emit.js +5 -5
  187. package/es/src/charts/Tree/index.js +12 -18
  188. package/es/src/charts/Tree/keys.js +33 -0
  189. package/es/src/charts/Tree/nodeLabel.js +15 -0
  190. package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
  191. package/es/src/charts/Treemap/index.js +2 -5
  192. package/es/src/charts/Violin/inner.js +3 -5
  193. package/es/src/charts/definition/makeChart.js +14 -2
  194. package/es/src/charts/drawSteps/backControl.js +17 -5
  195. package/es/src/charts/drawSteps/gestureHover.js +79 -0
  196. package/es/src/charts/drawSteps/minimap.js +10 -25
  197. package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
  198. package/es/src/charts/drawSteps/searchControls.js +2 -1
  199. package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
  200. package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
  201. package/es/src/charts/drawSteps/zoomActions.js +36 -0
  202. package/es/src/charts/drawSteps/zoomControls.js +52 -23
  203. package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
  204. package/es/src/charts/drawSteps/zoomDrag.js +188 -0
  205. package/es/src/charts/drawSteps/zoomFit.js +69 -0
  206. package/es/src/charts/events/click.legend.js +11 -4
  207. package/es/src/charts/events/click.shape.js +13 -4
  208. package/es/src/charts/events/mouseenter.js +6 -16
  209. package/es/src/charts/events/mouseleave.js +9 -2
  210. package/es/src/charts/events/mousemove.legend.js +28 -32
  211. package/es/src/charts/events/mousemove.shape.js +45 -42
  212. package/es/src/charts/facet/drawFacets.js +14 -5
  213. package/es/src/charts/features/annotationFrame.js +179 -0
  214. package/es/src/charts/features/annotationText.js +83 -0
  215. package/es/src/charts/features/annotationTypes.js +10 -0
  216. package/es/src/charts/features/attributionFeature.js +6 -11
  217. package/es/src/charts/features/axes.js +17 -5
  218. package/es/src/charts/features/axesFinal.js +10 -3
  219. package/es/src/charts/features/axesMeasure.js +33 -12
  220. package/es/src/charts/features/axisTooltip.js +138 -0
  221. package/es/src/charts/features/calloutLayout.js +121 -0
  222. package/es/src/charts/features/calloutScene.js +155 -0
  223. package/es/src/charts/features/centerLabel.js +177 -0
  224. package/es/src/charts/features/chartGeometry.js +1 -1
  225. package/es/src/charts/features/circleLabelPlacement.js +297 -0
  226. package/es/src/charts/features/circleLabels.js +207 -0
  227. package/es/src/charts/features/colorScaleBivariate.js +83 -0
  228. package/es/src/charts/features/colorScaleBucket.js +20 -1
  229. package/es/src/charts/features/colorScaleHover.js +33 -7
  230. package/es/src/charts/features/colorScaleLimit.js +73 -0
  231. package/es/src/charts/features/colorScaleTooltip.js +77 -0
  232. package/es/src/charts/features/colorScaleTop.js +61 -0
  233. package/es/src/charts/features/colorScaleValue.js +97 -0
  234. package/es/src/charts/features/curvedArrows.js +191 -0
  235. package/es/src/charts/features/depthKey.js +26 -0
  236. package/es/src/charts/features/edgeArrows.js +220 -5
  237. package/es/src/charts/features/edgeBundling.js +442 -0
  238. package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
  239. package/es/src/charts/features/ensureZoomDom.js +32 -8
  240. package/es/src/charts/features/features.js +32 -14
  241. package/es/src/charts/features/featuresColorScale.js +75 -20
  242. package/es/src/charts/features/featuresLegend.js +15 -24
  243. package/es/src/charts/features/hoverTicks.js +41 -0
  244. package/es/src/charts/features/idleQueue.js +72 -0
  245. package/es/src/charts/features/legendKeys.js +64 -0
  246. package/es/src/charts/features/lineLabels.js +55 -46
  247. package/es/src/charts/features/linkBundle.js +19 -0
  248. package/es/src/charts/features/linkColor.js +72 -0
  249. package/es/src/charts/features/linkFields.js +86 -0
  250. package/es/src/charts/features/linkFocus.js +118 -0
  251. package/es/src/charts/features/linkInteraction.js +364 -0
  252. package/es/src/charts/features/linkKeys.js +20 -0
  253. package/es/src/charts/features/linkLabelGeometry.js +209 -0
  254. package/es/src/charts/features/linkLabelPath.js +162 -0
  255. package/es/src/charts/features/linkLabels.js +340 -0
  256. package/es/src/charts/features/linkWidths.js +32 -0
  257. package/es/src/charts/features/networkMeasures.js +241 -0
  258. package/es/src/charts/features/nodeStats.js +309 -0
  259. package/es/src/charts/features/pathLabelGeometry.js +232 -0
  260. package/es/src/charts/features/pathLabels.js +50 -0
  261. package/es/src/charts/features/plotAnnotations.js +68 -17
  262. package/es/src/charts/features/plotEndLabels.js +28 -7
  263. package/es/src/charts/features/plotPaint.js +46 -12
  264. package/es/src/charts/features/polyline.js +129 -0
  265. package/es/src/charts/features/referenceAnnotations.js +403 -0
  266. package/es/src/charts/features/referenceLabelPlacement.js +106 -0
  267. package/es/src/charts/features/ringLabelNodes.js +93 -0
  268. package/es/src/charts/features/ringLabels.js +222 -0
  269. package/es/src/charts/features/sceneBounds.js +26 -6
  270. package/es/src/charts/features/selfLoops.js +306 -0
  271. package/es/src/charts/features/shapeEmit.js +54 -32
  272. package/es/src/charts/features/sharedFields.js +15 -2
  273. package/es/src/charts/features/textHalo.js +30 -0
  274. package/es/src/charts/index.js +8 -0
  275. package/es/src/charts/partition/chartFields.js +14 -5
  276. package/es/src/charts/partition/interaction.js +19 -10
  277. package/es/src/charts/partition/zoom.js +7 -6
  278. package/es/src/charts/pipeline/insetPlacement.js +22 -9
  279. package/es/src/charts/pipeline/preDrawData.js +46 -3
  280. package/es/src/charts/pipeline/runVizPipeline.js +5 -0
  281. package/es/src/charts/pipeline/vizPreDraw.js +5 -3
  282. package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
  283. package/es/src/charts/polar/chrome.js +81 -9
  284. package/es/src/charts/polar/config.js +6 -3
  285. package/es/src/charts/polar/wedgeLayout.js +2 -1
  286. package/es/src/charts/viz/Viz.js +61 -49
  287. package/es/src/charts/viz/VizBase.js +57 -14
  288. package/es/src/charts/viz/backgroundInk.js +23 -7
  289. package/es/src/charts/viz/emphasis.js +14 -0
  290. package/es/src/charts/viz/fillStroke.js +10 -0
  291. package/es/src/charts/viz/focusRing.js +104 -0
  292. package/es/src/charts/viz/focusTargets.js +208 -0
  293. package/es/src/charts/viz/history.js +74 -0
  294. package/es/src/charts/viz/interactionOpacity.js +115 -32
  295. package/es/src/charts/viz/keyboardNav.js +297 -0
  296. package/es/src/charts/viz/keyboardNavHost.js +95 -0
  297. package/es/src/charts/viz/loaderFormat.js +114 -0
  298. package/es/src/charts/viz/missingFields.js +2 -1
  299. package/es/src/charts/viz/mountTarget.js +9 -0
  300. package/es/src/charts/viz/nearestHover.js +183 -0
  301. package/es/src/charts/viz/nearestHoverSurface.js +92 -0
  302. package/es/src/charts/viz/ordinalColor.js +14 -12
  303. package/es/src/charts/viz/pageTheme.js +83 -0
  304. package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
  305. package/es/src/charts/viz/pointVoronoi.js +124 -0
  306. package/es/src/charts/viz/reducedMotion.js +27 -0
  307. package/es/src/charts/viz/reportDrawError.js +15 -0
  308. package/es/src/charts/viz/setCursor.js +29 -0
  309. package/es/src/charts/viz/tooltipEnabled.js +38 -0
  310. package/es/src/charts/viz/userClick.js +34 -0
  311. package/es/src/charts/viz/vizDataPolling.js +8 -4
  312. package/es/src/charts/viz/vizDefaults.js +28 -57
  313. package/es/src/charts/viz/vizFields.js +41 -1
  314. package/es/src/charts/viz/vizRender.js +76 -31
  315. package/es/src/charts/viz/vizTheme.js +96 -0
  316. package/es/src/charts/viz/vizVisibility.js +26 -2
  317. package/es/src/components/Axis/Axis.js +35 -2
  318. package/es/src/components/Axis/AxisBottom.js +1 -0
  319. package/es/src/components/Axis/AxisLeft.js +1 -0
  320. package/es/src/components/Axis/AxisRight.js +1 -0
  321. package/es/src/components/Axis/AxisTop.js +1 -0
  322. package/es/src/components/Axis/axisBreak.js +33 -8
  323. package/es/src/components/Axis/axisDefaults.js +16 -9
  324. package/es/src/components/Axis/axisLabelKinds.js +36 -0
  325. package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
  326. package/es/src/components/Axis/axisLabelRoom.js +37 -0
  327. package/es/src/components/Axis/axisLabelSize.js +171 -0
  328. package/es/src/components/Axis/axisLabelThinning.js +98 -4
  329. package/es/src/components/Axis/axisLayout.js +71 -46
  330. package/es/src/components/Axis/axisLayoutLabels.js +82 -140
  331. package/es/src/components/Axis/axisLayoutScale.js +16 -11
  332. package/es/src/components/Axis/axisLimit.js +27 -0
  333. package/es/src/components/Axis/axisMaxSize.js +39 -0
  334. package/es/src/components/Axis/axisRangeBreaks.js +77 -0
  335. package/es/src/components/Axis/axisRender.js +20 -8
  336. package/es/src/components/Axis/axisRounding.js +16 -1
  337. package/es/src/components/Axis/axisScene.js +11 -2
  338. package/es/src/components/Axis/axisTitle.js +53 -0
  339. package/es/src/components/Axis/axisTooltipTargets.js +128 -0
  340. package/es/src/components/Axis/brokenTimeScale.js +196 -0
  341. package/es/src/components/Axis/rangeBreaks.js +201 -0
  342. package/es/src/components/Axis/timeValues.js +19 -4
  343. package/es/src/components/ColorScale/ColorScale.js +77 -27
  344. package/es/src/components/ColorScale/bivariateRender.js +353 -0
  345. package/es/src/components/ColorScale/bivariateScale.js +150 -0
  346. package/es/src/components/ColorScale/bucketBounds.js +32 -3
  347. package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
  348. package/es/src/components/ColorScale/colorScaleRender.js +32 -2
  349. package/es/src/components/ColorScale/colorScaleScale.js +28 -15
  350. package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
  351. package/es/src/components/Legend/Legend.js +13 -2
  352. package/es/src/components/Legend/legendConfig.js +2 -6
  353. package/es/src/components/Legend/legendCut.js +108 -0
  354. package/es/src/components/Legend/legendRender.js +38 -13
  355. package/es/src/components/SizeLegend/SizeLegend.js +1 -0
  356. package/es/src/components/TextBox.js +34 -67
  357. package/es/src/components/Timeline/Timeline.js +12 -3
  358. package/es/src/components/Timeline/timelineConfig.js +20 -10
  359. package/es/src/components/Timeline/timelineMode.js +26 -0
  360. package/es/src/components/Timeline/timelineRender.js +9 -4
  361. package/es/src/components/Tooltip.js +15 -5
  362. package/es/src/components/fontStack.js +20 -0
  363. package/es/src/components/textBoxLayout.js +58 -21
  364. package/es/src/components/textBoxPath.js +73 -0
  365. package/es/src/components/textBoxScene.js +226 -0
  366. package/es/src/components/textBoxWords.js +70 -0
  367. package/es/src/components/textEllipsis.js +7 -0
  368. package/es/src/components/tooltipDom.js +8 -5
  369. package/es/src/fluent.js +48 -0
  370. package/es/src/shapes/Area.js +1 -0
  371. package/es/src/shapes/Bar.js +1 -0
  372. package/es/src/shapes/Box.js +1 -0
  373. package/es/src/shapes/Circle.js +1 -0
  374. package/es/src/shapes/Line.js +1 -0
  375. package/es/src/shapes/Path.js +1 -0
  376. package/es/src/shapes/Rect.js +1 -0
  377. package/es/src/shapes/Shape.js +1 -0
  378. package/es/src/shapes/Whisker.js +1 -0
  379. package/es/src/utils/BaseClass.js +30 -12
  380. package/es/src/utils/configPrep.js +2 -1
  381. package/es/src/utils/configValue.js +9 -0
  382. package/es/src/utils/constant.js +13 -1
  383. package/es/src/utils/displayName.js +12 -0
  384. package/es/src/utils/theme.js +190 -0
  385. package/es/src/utils/themeInk.js +68 -0
  386. package/package.json +14 -11
  387. package/types/index.d.ts +6 -2
  388. package/types/internal.d.ts +268 -9
  389. package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
  390. package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
  391. package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
  392. package/types/src/charts/Alluvial/emit.d.ts +9 -0
  393. package/types/src/charts/Alluvial/hover.d.ts +31 -0
  394. package/types/src/charts/Alluvial/index.d.ts +27 -0
  395. package/types/src/charts/Alluvial/layout.d.ts +70 -0
  396. package/types/src/charts/Alluvial/meta.d.ts +54 -0
  397. package/types/src/charts/Alluvial/titles.d.ts +46 -0
  398. package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
  399. package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
  400. package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
  401. package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
  402. package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
  403. package/types/src/charts/ArcDiagram/events.d.ts +29 -0
  404. package/types/src/charts/ArcDiagram/index.d.ts +28 -0
  405. package/types/src/charts/BubbleChart/emit.d.ts +20 -0
  406. package/types/src/charts/BubbleChart/index.d.ts +16 -0
  407. package/types/src/charts/Chord/applyLayout.d.ts +3 -0
  408. package/types/src/charts/Chord/labels.d.ts +66 -0
  409. package/types/src/charts/Donut/index.d.ts +2 -1
  410. package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
  411. package/types/src/charts/Gantt/emit.d.ts +17 -0
  412. package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
  413. package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
  414. package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
  415. package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
  416. package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
  417. package/types/src/charts/Gantt/index.d.ts +36 -0
  418. package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
  419. package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
  420. package/types/src/charts/Geomap/emit.d.ts +2 -2
  421. package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
  422. package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
  423. package/types/src/charts/Geomap/flowFields.d.ts +7 -0
  424. package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
  425. package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
  426. package/types/src/charts/Geomap/geoCache.d.ts +47 -0
  427. package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
  428. package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
  429. package/types/src/charts/Geomap/index.d.ts +3 -0
  430. package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
  431. package/types/src/charts/Hexbin/binning.d.ts +64 -0
  432. package/types/src/charts/Hexbin/buffer.d.ts +18 -0
  433. package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
  434. package/types/src/charts/Hexbin/contours.d.ts +48 -0
  435. package/types/src/charts/Hexbin/emit.d.ts +23 -0
  436. package/types/src/charts/Hexbin/index.d.ts +25 -0
  437. package/types/src/charts/Hexbin/layers.d.ts +94 -0
  438. package/types/src/charts/Hexbin/settings.d.ts +122 -0
  439. package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
  440. package/types/src/charts/Histogram/binData.d.ts +20 -1
  441. package/types/src/charts/Histogram/index.d.ts +3 -2
  442. package/types/src/charts/Histogram/labels.d.ts +7 -0
  443. package/types/src/charts/Marimekko/index.d.ts +2 -1
  444. package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
  445. package/types/src/charts/Network/applyLayout.d.ts +11 -0
  446. package/types/src/charts/Network/bundle.d.ts +69 -0
  447. package/types/src/charts/Network/clusterLabels.d.ts +112 -0
  448. package/types/src/charts/Network/clusters.d.ts +115 -0
  449. package/types/src/charts/Network/graph.d.ts +73 -0
  450. package/types/src/charts/Network/graphFluent.d.ts +20 -0
  451. package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
  452. package/types/src/charts/Network/polygonRows.d.ts +29 -0
  453. package/types/src/charts/Pack/applyLayout.d.ts +2 -0
  454. package/types/src/charts/Pack/groupRows.d.ts +46 -0
  455. package/types/src/charts/Pack/index.d.ts +3 -0
  456. package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
  457. package/types/src/charts/Pack/nodeNames.d.ts +23 -0
  458. package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
  459. package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
  460. package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
  461. package/types/src/charts/Pie/applyLayout.d.ts +31 -3
  462. package/types/src/charts/Pie/arcFit.d.ts +63 -0
  463. package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
  464. package/types/src/charts/Pie/labelRoom.d.ts +83 -0
  465. package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
  466. package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
  467. package/types/src/charts/Pie/pieLabels.d.ts +85 -0
  468. package/types/src/charts/Pie/sectorBox.d.ts +95 -0
  469. package/types/src/charts/Pie/straightLabels.d.ts +24 -0
  470. package/types/src/charts/Pie/straightLayout.d.ts +88 -0
  471. package/types/src/charts/Plot/alongLegend.d.ts +42 -0
  472. package/types/src/charts/Plot/areaEnter.d.ts +34 -0
  473. package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
  474. package/types/src/charts/Plot/axisValues.d.ts +24 -0
  475. package/types/src/charts/Plot/barWidth.d.ts +38 -4
  476. package/types/src/charts/Plot/circleLabels.d.ts +29 -0
  477. package/types/src/charts/Plot/connectGaps.d.ts +99 -0
  478. package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
  479. package/types/src/charts/Plot/forecastScene.d.ts +5 -0
  480. package/types/src/charts/Plot/index.d.ts +16 -15
  481. package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
  482. package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
  483. package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
  484. package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
  485. package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
  486. package/types/src/charts/Plot/pipeline.d.ts +15 -1
  487. package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
  488. package/types/src/charts/Plot/plotFacet.d.ts +5 -0
  489. package/types/src/charts/Plot/plotInit.d.ts +14 -0
  490. package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
  491. package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
  492. package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
  493. package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
  494. package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
  495. package/types/src/charts/Plot/trendLabels.d.ts +73 -0
  496. package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
  497. package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
  498. package/types/src/charts/Pyramid/gutter.d.ts +28 -6
  499. package/types/src/charts/Pyramid/scene.d.ts +1 -1
  500. package/types/src/charts/Radar/applyLayout.d.ts +2 -3
  501. package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
  502. package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
  503. package/types/src/charts/Radar/emit.d.ts +5 -2
  504. package/types/src/charts/Radar/index.d.ts +7 -2
  505. package/types/src/charts/Radar/points.d.ts +50 -0
  506. package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
  507. package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
  508. package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
  509. package/types/src/charts/Rings/emit.d.ts +72 -0
  510. package/types/src/charts/Rings/index.d.ts +4 -2
  511. package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
  512. package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
  513. package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
  514. package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
  515. package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
  516. package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
  517. package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
  518. package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
  519. package/types/src/charts/Sankey/emit.d.ts +58 -0
  520. package/types/src/charts/Sankey/labels.d.ts +19 -0
  521. package/types/src/charts/Sankey/ribbons.d.ts +36 -0
  522. package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
  523. package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
  524. package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
  525. package/types/src/charts/Scatter/index.d.ts +15 -0
  526. package/types/src/charts/SlopeChart/index.d.ts +43 -0
  527. package/types/src/charts/SlopeChart/slope.d.ts +43 -0
  528. package/types/src/charts/Streamgraph/index.d.ts +28 -0
  529. package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
  530. package/types/src/charts/Tree/applyLayout.d.ts +20 -0
  531. package/types/src/charts/Tree/keys.d.ts +25 -0
  532. package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
  533. package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
  534. package/types/src/charts/definition/makeChart.d.ts +3 -2
  535. package/types/src/charts/drawSteps/backControl.d.ts +7 -22
  536. package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
  537. package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
  538. package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
  539. package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
  540. package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
  541. package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
  542. package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
  543. package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
  544. package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
  545. package/types/src/charts/events/click.legend.d.ts +2 -1
  546. package/types/src/charts/facet/facetConfig.d.ts +4 -2
  547. package/types/src/charts/features/annotationFrame.d.ts +108 -0
  548. package/types/src/charts/features/annotationText.d.ts +57 -0
  549. package/types/src/charts/features/annotationTypes.d.ts +161 -0
  550. package/types/src/charts/features/axesMeasure.d.ts +4 -0
  551. package/types/src/charts/features/axisTooltip.d.ts +49 -0
  552. package/types/src/charts/features/calloutLayout.d.ts +78 -0
  553. package/types/src/charts/features/calloutScene.d.ts +40 -0
  554. package/types/src/charts/features/centerLabel.d.ts +75 -0
  555. package/types/src/charts/features/chartGeometry.d.ts +1 -1
  556. package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
  557. package/types/src/charts/features/circleLabels.d.ts +130 -0
  558. package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
  559. package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
  560. package/types/src/charts/features/colorScaleHover.d.ts +13 -3
  561. package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
  562. package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
  563. package/types/src/charts/features/colorScaleTop.d.ts +30 -0
  564. package/types/src/charts/features/colorScaleValue.d.ts +35 -0
  565. package/types/src/charts/features/curvedArrows.d.ts +119 -0
  566. package/types/src/charts/features/depthKey.d.ts +19 -0
  567. package/types/src/charts/features/edgeArrows.d.ts +103 -4
  568. package/types/src/charts/features/edgeBundling.d.ts +86 -0
  569. package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
  570. package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
  571. package/types/src/charts/features/featuresLegend.d.ts +4 -3
  572. package/types/src/charts/features/hoverTicks.d.ts +30 -0
  573. package/types/src/charts/features/idleQueue.d.ts +46 -0
  574. package/types/src/charts/features/legendKeys.d.ts +34 -0
  575. package/types/src/charts/features/lineLabels.d.ts +15 -12
  576. package/types/src/charts/features/linkBundle.d.ts +16 -0
  577. package/types/src/charts/features/linkColor.d.ts +48 -0
  578. package/types/src/charts/features/linkFields.d.ts +16 -0
  579. package/types/src/charts/features/linkFocus.d.ts +51 -0
  580. package/types/src/charts/features/linkInteraction.d.ts +192 -0
  581. package/types/src/charts/features/linkKeys.d.ts +11 -0
  582. package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
  583. package/types/src/charts/features/linkLabelPath.d.ts +85 -0
  584. package/types/src/charts/features/linkLabels.d.ts +77 -0
  585. package/types/src/charts/features/linkWidths.d.ts +19 -0
  586. package/types/src/charts/features/networkMeasures.d.ts +53 -0
  587. package/types/src/charts/features/nodeStats.d.ts +93 -0
  588. package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
  589. package/types/src/charts/features/pathLabels.d.ts +41 -0
  590. package/types/src/charts/features/plotAnnotations.d.ts +23 -8
  591. package/types/src/charts/features/plotEndLabels.d.ts +14 -1
  592. package/types/src/charts/features/plotPaint.d.ts +17 -0
  593. package/types/src/charts/features/polyline.d.ts +32 -0
  594. package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
  595. package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
  596. package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
  597. package/types/src/charts/features/ringLabels.d.ts +164 -0
  598. package/types/src/charts/features/sceneBounds.d.ts +6 -0
  599. package/types/src/charts/features/selfLoops.d.ts +165 -0
  600. package/types/src/charts/features/shapeEmit.d.ts +3 -1
  601. package/types/src/charts/features/sharedFields.d.ts +11 -2
  602. package/types/src/charts/features/textHalo.d.ts +15 -0
  603. package/types/src/charts/index.d.ts +8 -0
  604. package/types/src/charts/partition/chartFields.d.ts +6 -1
  605. package/types/src/charts/partition/interaction.d.ts +6 -3
  606. package/types/src/charts/partition/zoom.d.ts +4 -4
  607. package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
  608. package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
  609. package/types/src/charts/pipeline/stages.d.ts +7 -0
  610. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
  611. package/types/src/charts/polar/chrome.d.ts +19 -6
  612. package/types/src/charts/viz/Viz.d.ts +25 -4
  613. package/types/src/charts/viz/VizBase.d.ts +37 -8
  614. package/types/src/charts/viz/backgroundInk.d.ts +19 -4
  615. package/types/src/charts/viz/emphasis.d.ts +17 -0
  616. package/types/src/charts/viz/fillStroke.d.ts +7 -0
  617. package/types/src/charts/viz/focusRing.d.ts +25 -0
  618. package/types/src/charts/viz/focusTargets.d.ts +56 -0
  619. package/types/src/charts/viz/history.d.ts +35 -0
  620. package/types/src/charts/viz/keyboardNav.d.ts +55 -0
  621. package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
  622. package/types/src/charts/viz/loaderFormat.d.ts +78 -0
  623. package/types/src/charts/viz/mountTarget.d.ts +7 -0
  624. package/types/src/charts/viz/nearestHover.d.ts +75 -0
  625. package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
  626. package/types/src/charts/viz/ordinalColor.d.ts +10 -8
  627. package/types/src/charts/viz/pageTheme.d.ts +34 -0
  628. package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
  629. package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
  630. package/types/src/charts/viz/reducedMotion.d.ts +25 -0
  631. package/types/src/charts/viz/reportDrawError.d.ts +12 -0
  632. package/types/src/charts/viz/setCursor.d.ts +26 -0
  633. package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
  634. package/types/src/charts/viz/userClick.d.ts +35 -0
  635. package/types/src/charts/viz/vizDefaults.d.ts +0 -9
  636. package/types/src/charts/viz/vizFields.d.ts +37 -0
  637. package/types/src/charts/viz/vizRender.d.ts +2 -1
  638. package/types/src/charts/viz/vizTheme.d.ts +40 -0
  639. package/types/src/charts/viz/vizTypes.d.ts +100 -7
  640. package/types/src/charts/viz/vizVisibility.d.ts +13 -0
  641. package/types/src/components/Axis/Axis.d.ts +34 -3
  642. package/types/src/components/Axis/AxisBottom.d.ts +1 -0
  643. package/types/src/components/Axis/AxisLeft.d.ts +1 -0
  644. package/types/src/components/Axis/AxisRight.d.ts +1 -0
  645. package/types/src/components/Axis/AxisTop.d.ts +1 -0
  646. package/types/src/components/Axis/axisBreak.d.ts +21 -3
  647. package/types/src/components/Axis/axisDefaults.d.ts +12 -0
  648. package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
  649. package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
  650. package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
  651. package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
  652. package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
  653. package/types/src/components/Axis/axisLayout.d.ts +9 -2
  654. package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
  655. package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
  656. package/types/src/components/Axis/axisLimit.d.ts +18 -0
  657. package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
  658. package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
  659. package/types/src/components/Axis/axisRounding.d.ts +8 -0
  660. package/types/src/components/Axis/axisTitle.d.ts +30 -0
  661. package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
  662. package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
  663. package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
  664. package/types/src/components/Axis/timeValues.d.ts +1 -1
  665. package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
  666. package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
  667. package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
  668. package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
  669. package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
  670. package/types/src/components/Legend/Legend.d.ts +6 -0
  671. package/types/src/components/Legend/legendCut.d.ts +31 -0
  672. package/types/src/components/Legend/legendRender.d.ts +6 -1
  673. package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
  674. package/types/src/components/TextBox.d.ts +5 -0
  675. package/types/src/components/Timeline/Timeline.d.ts +1 -0
  676. package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
  677. package/types/src/components/Timeline/timelineMode.d.ts +17 -0
  678. package/types/src/components/Tooltip.d.ts +4 -3
  679. package/types/src/components/fontStack.d.ts +10 -0
  680. package/types/src/components/textBoxLayout.d.ts +18 -9
  681. package/types/src/components/textBoxPath.d.ts +59 -0
  682. package/types/src/components/textBoxScene.d.ts +51 -0
  683. package/types/src/components/textBoxWords.d.ts +33 -0
  684. package/types/src/components/textEllipsis.d.ts +6 -0
  685. package/types/src/fluent.d.ts +18 -0
  686. package/types/src/shapes/Area.d.ts +1 -0
  687. package/types/src/shapes/Bar.d.ts +1 -0
  688. package/types/src/shapes/Box.d.ts +1 -0
  689. package/types/src/shapes/Circle.d.ts +1 -0
  690. package/types/src/shapes/Line.d.ts +1 -0
  691. package/types/src/shapes/Path.d.ts +1 -0
  692. package/types/src/shapes/Rect.d.ts +1 -0
  693. package/types/src/shapes/Shape.d.ts +1 -0
  694. package/types/src/shapes/Whisker.d.ts +1 -0
  695. package/types/src/shapes/emitLabels.d.ts +1 -1
  696. package/types/src/utils/BaseClass.d.ts +9 -0
  697. package/types/src/utils/D3plusConfig.d.ts +1093 -266
  698. package/types/src/utils/configPrep.d.ts +2 -0
  699. package/types/src/utils/configValue.d.ts +8 -0
  700. package/types/src/utils/constant.d.ts +8 -0
  701. package/types/src/utils/displayName.d.ts +10 -0
  702. package/types/src/utils/index.d.ts +1 -1
  703. package/types/src/utils/theme.d.ts +170 -0
  704. package/types/src/utils/themeInk.d.ts +56 -0
  705. package/types/umd-entry.d.ts +4 -0
  706. package/umd/d3plus-core.full.js +72239 -41465
  707. package/umd/d3plus-core.full.min.js +2 -2
  708. package/umd/d3plus-core.js +46249 -19519
  709. package/umd/d3plus-core.min.js +2 -2
  710. package/es/src/components/Axis/gridStroke.js +0 -10
  711. package/types/src/components/Axis/gridStroke.d.ts +0 -8
@@ -0,0 +1,208 @@
1
+ /**
2
+ Drag-to-rotate for Geomap globes (projections that clip to a circle,
3
+ such as `"geoOrthographic"`): a drag turns the globe under the pointer
4
+ rather than panning the zoom transform, while the wheel, pinch, and zoom
5
+ buttons still zoom. The rotation follows the pointer with versors
6
+ (quaternions), so the place grabbed stays under the pointer however the
7
+ globe is turned, without the gimbal flips of mapping the drag onto
8
+ longitude and latitude. A drag that starts off the globe turns it by
9
+ longitude and latitude instead; one dragged past the globe's edge keeps
10
+ the grabbed place on the horizon.
11
+ */ import { clipsToCircle } from "./flowGeometry.js";
12
+ const radians = Math.PI / 180;
13
+ const degrees = 180 / Math.PI;
14
+ const clamp = (n)=>Math.max(-1, Math.min(1, n));
15
+ /** The unit quaternion for a rotation. */ export function versor([l, p, g]) {
16
+ const hl = l * radians / 2, hp = p * radians / 2, hg = (g ?? 0) * radians / 2;
17
+ const sl = Math.sin(hl), cl = Math.cos(hl), sp = Math.sin(hp), cp = Math.cos(hp), sg = Math.sin(hg), cg = Math.cos(hg);
18
+ return [
19
+ cl * cp * cg + sl * sp * sg,
20
+ sl * cp * cg - cl * sp * sg,
21
+ cl * sp * cg + sl * cp * sg,
22
+ cl * cp * sg - sl * sp * cg
23
+ ];
24
+ }
25
+ /** The rotation a unit quaternion stands for. */ export function versorRotation(q) {
26
+ return [
27
+ Math.atan2(2 * (q[0] * q[1] + q[2] * q[3]), 1 - 2 * (q[1] ** 2 + q[2] ** 2)) * degrees,
28
+ Math.asin(clamp(2 * (q[0] * q[2] - q[3] * q[1]))) * degrees,
29
+ Math.atan2(2 * (q[0] * q[3] + q[1] * q[2]), 1 - 2 * (q[2] ** 2 + q[3] ** 2)) * degrees
30
+ ];
31
+ }
32
+ /** A coordinate as a point on the unit sphere. */ export function cartesian([lon, lat]) {
33
+ const l = lon * radians, p = lat * radians, cp = Math.cos(p);
34
+ return [
35
+ cp * Math.cos(l),
36
+ cp * Math.sin(l),
37
+ Math.sin(p)
38
+ ];
39
+ }
40
+ /** The quaternion turning the unit vector `a` onto `b`. */ export function versorDelta(a, b) {
41
+ const w = [
42
+ a[1] * b[2] - a[2] * b[1],
43
+ a[2] * b[0] - a[0] * b[2],
44
+ a[0] * b[1] - a[1] * b[0]
45
+ ];
46
+ const l = Math.hypot(...w);
47
+ if (!l) return [
48
+ 1,
49
+ 0,
50
+ 0,
51
+ 0
52
+ ];
53
+ const t = Math.acos(clamp(a[0] * b[0] + a[1] * b[1] + a[2] * b[2])) / 2, s = Math.sin(t);
54
+ return [
55
+ Math.cos(t),
56
+ w[2] / l * s,
57
+ -w[1] / l * s,
58
+ w[0] / l * s
59
+ ];
60
+ }
61
+ /** The product `a * b` of two quaternions. */ export function versorMultiply(a, b) {
62
+ return [
63
+ a[0] * b[0] - a[1] * b[1] - a[2] * b[2] - a[3] * b[3],
64
+ a[1] * b[0] + a[0] * b[1] + a[2] * b[3] - a[3] * b[2],
65
+ a[0] * b[2] - a[1] * b[3] + a[2] * b[0] + a[3] * b[1],
66
+ a[0] * b[3] + a[1] * b[2] - a[2] * b[1] + a[3] * b[0]
67
+ ];
68
+ }
69
+ const finite = (p)=>p && Number.isFinite(p[0]) && Number.isFinite(p[1]) ? p : null;
70
+ /**
71
+ The place under a pixel, or null off the globe: d3-geo inverts a pixel
72
+ past a globe's edge to the horizon, so the place must project back onto
73
+ the pixel.
74
+ */ function placeAt(projection, at) {
75
+ const place = finite(projection.invert?.(at));
76
+ if (!place) return null;
77
+ const back = projection(place);
78
+ return back && Math.hypot(back[0] - at[0], back[1] - at[1]) < 0.5 ? place : null;
79
+ }
80
+ /**
81
+ The rotation that carries the place under `from` (with the globe turned
82
+ to `start`) to the pixel `to`. Off the globe, where a pixel names no
83
+ place, it turns the globe by longitude and latitude instead, a degree
84
+ per the pixels a degree spans at the globe's center. Leaves the
85
+ projection's rotation as it found it.
86
+ */ export function dragRotation(projection, start, from, to) {
87
+ const current = projection.rotate();
88
+ projection.rotate(start);
89
+ const a = placeAt(projection, from);
90
+ // Dragged past the edge, the grabbed place follows to the horizon.
91
+ const b = a ? placeAt(projection, to) ?? finite(projection.invert?.(to)) : null;
92
+ projection.rotate(current);
93
+ const [l, p, g = 0] = start;
94
+ if (a && b) return versorRotation(versorMultiply(versor(start), versorDelta(cartesian(a), cartesian(b))));
95
+ const k = degrees / (projection.scale() || 1);
96
+ return [
97
+ l + (to[0] - from[0]) * k,
98
+ Math.max(-90, Math.min(90, p - (to[1] - from[1]) * k)),
99
+ g
100
+ ];
101
+ }
102
+ /** Where a pointer event is on `node`, for a mouse or a single touch. */ function pointerOn(event, node) {
103
+ const touches = event.touches;
104
+ const at = touches && touches.length ? touches[0] : event.clientX !== undefined ? event : null;
105
+ if (!at) return null;
106
+ const rect = node.getBoundingClientRect();
107
+ return [
108
+ at.clientX - rect.left - (node.clientLeft || 0),
109
+ at.clientY - rect.top - (node.clientTop || 0)
110
+ ];
111
+ }
112
+ /**
113
+ A point on the zoom surface in the map's projected pixels: the zoom
114
+ `transform` undone, then the chart's own offset.
115
+ */ export function surfaceToMap(point, transform, offset = {}) {
116
+ return [
117
+ (point[0] - transform.x) / transform.k - (offset.x ?? 0),
118
+ (point[1] - transform.y) / transform.k - (offset.y ?? 0)
119
+ ];
120
+ }
121
+ /** Whether `viz` is a globe drag can turn now. */ export function globeRotates(viz) {
122
+ return clipsToCircle(viz.schema.projection) && !!viz.schema.zoom && !viz._ssr && !viz._facetPanels && !viz._facetStep;
123
+ }
124
+ /**
125
+ The rotation a globe returns to, and fits its scale at: the configured
126
+ `projectionRotate`, else the one the projection had before it was first
127
+ dragged. Undefined for a globe that hasn't been turned.
128
+ */ export function globeHome(viz) {
129
+ const configured = viz.schema.projectionRotate;
130
+ if (Array.isArray(configured)) return configured;
131
+ const home = viz._globeHome;
132
+ return home && home.projection === viz.schema.projection ? home.rotate : undefined;
133
+ }
134
+ /** Whether a gesture event comes from a press that can drag. */ const isPress = (event)=>!!event && (event.type === "mousedown" || event.type === "pointerdown" || event.type === "touchstart" && (event.touches?.length ?? 0) === 1);
135
+ /**
136
+ Installs the globe drag on a Geomap: `viz._zoomGesture`, which the zoom
137
+ behavior consults on each gesture, rotating the projection on a drag
138
+ and re-laying the map out (with `relayout`) once per animation frame.
139
+ The zoom controls' reset turns the globe back to `globeHome`.
140
+ @param relayout Re-runs the map's layout and emit for the current projection.
141
+ */ export function installGlobeRotation(viz, relayout) {
142
+ let drag = null;
143
+ const surface = ()=>(viz._zoomEventTarget || viz._container)?.node() ?? null;
144
+ const paint = ()=>{
145
+ if (!drag || !drag.to) return;
146
+ drag.frame = undefined;
147
+ const projection = viz.schema.projection;
148
+ projection.rotate(dragRotation(projection, drag.r0, drag.p0, drag.to));
149
+ relayout();
150
+ viz._drawSceneToTarget?.(0);
151
+ };
152
+ const finish = ()=>{
153
+ if (!drag) return;
154
+ if (drag.frame !== undefined) cancelAnimationFrame(drag.frame);
155
+ paint();
156
+ drag = null;
157
+ viz._globeDragging = false;
158
+ };
159
+ const gesture = {
160
+ start (event) {
161
+ drag = null;
162
+ const node = surface();
163
+ if (!node || !globeRotates(viz) || !isPress(event.sourceEvent)) return;
164
+ const at = pointerOn(event.sourceEvent, node);
165
+ if (!at) return;
166
+ const projection = viz.schema.projection;
167
+ if (!globeHome(viz)) viz._globeHome = {
168
+ projection,
169
+ rotate: projection.rotate()
170
+ };
171
+ drag = {
172
+ t0: event.transform,
173
+ r0: projection.rotate(),
174
+ p0: surfaceToMap(at, event.transform, viz._chartTransform)
175
+ };
176
+ },
177
+ zoom (event) {
178
+ if (!drag) return false;
179
+ const source = event.sourceEvent;
180
+ const node = surface();
181
+ // A second finger makes it a pinch, which zooms.
182
+ if (!source || !node || source.type === "wheel" || (source.touches?.length ?? 0) > 1) {
183
+ finish();
184
+ return false;
185
+ }
186
+ // Hold the zoom transform where the drag found it.
187
+ (viz._zoomEventTarget || viz._container).property("__zoom", drag.t0);
188
+ const at = pointerOn(source, node);
189
+ if (!at) return true;
190
+ viz._globeDragging = true;
191
+ drag.to = surfaceToMap(at, drag.t0, viz._chartTransform);
192
+ if (typeof requestAnimationFrame !== "function") paint();
193
+ else if (drag.frame === undefined) drag.frame = requestAnimationFrame(paint);
194
+ return true;
195
+ },
196
+ end () {
197
+ finish();
198
+ },
199
+ reset () {
200
+ if (!globeRotates(viz)) return;
201
+ const home = globeHome(viz);
202
+ if (!home) return;
203
+ viz.schema.projection.rotate(home);
204
+ relayout();
205
+ }
206
+ };
207
+ viz._zoomGesture = gesture;
208
+ }
@@ -4,6 +4,9 @@
4
4
  Implementation files in this folder:
5
5
  - `applyLayout.ts` — topojson + projection + path/point compute.
6
6
  - `emit.ts` — country Paths + point Circles.
7
+ - `flowLinks.ts` / `flowGeometry.ts` — `links`: their ends, widths,
8
+ and great-circle paths; `flowEmit.ts` draws them, `flowEvents.ts`
9
+ wires their hover and click, and `flowFields.ts` declares their config.
7
10
  */ import { color } from "d3-color";
8
11
  import { tile } from "d3-tile";
9
12
  import { geoMercator } from "d3-geo";
@@ -15,12 +18,21 @@ import constant from "../../utils/constant.js";
15
18
  import { chartAreaRect, chartBounds } from "../features/chartGeometry.js";
16
19
  import { ensureZoomDom } from "../features/ensureZoomDom.js";
17
20
  import { tileZoomTransform } from "../drawSteps/zoomControls.js";
18
- import { DEFAULT_OCEAN, DEFAULT_TILE_URL, isThemed, pageIsDark, resolveThemed, watchPageTheme } from "./basemapTheme.js";
21
+ import { DEFAULT_OCEAN, DEFAULT_TILE_URL, resolveThemed } from "./basemapTheme.js";
22
+ import { pageIsDark } from "../viz/pageTheme.js";
19
23
  import { makeChart } from "../definition/makeChart.js";
24
+ import { isPointShape } from "../viz/nearestHover.js";
25
+ import { loaderFormatFields, setLoaderValue } from "../viz/loaderFormat.js";
20
26
  import { applyGeomapLayout, geomapPointData, geomapPointSizeScale } from "./applyLayout.js";
21
27
  import { projectionByName } from "./projections.js";
22
28
  import { geomapEmit } from "./emit.js";
29
+ import { setupGeomapLinks } from "./flowEvents.js";
30
+ import { installGlobeKeys } from "./globeKeys.js";
31
+ import { installGlobeRotation } from "./globeRotate.js";
32
+ import { runChartDraw } from "../pipeline/runChartDraw.js";
33
+ import { geomapLinkFields } from "./flowFields.js";
23
34
  import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
35
+ import { effectiveDuration } from "../viz/reducedMotion.js";
24
36
  function findAttribution(url) {
25
37
  const a = attributions.find((d)=>d.matches.some((m)=>url.includes(m)));
26
38
  return a ? a.text : false;
@@ -117,9 +129,8 @@ function findAttribution(url) {
117
129
  // Wrap _draw to ensure DOM zoom group + zoom wiring.
118
130
  const supDraw = viz._draw.bind(viz);
119
131
  viz._draw = function(callback) {
120
- // Resolve `{light, dark}` basemaps against the chart's backdrop.
121
- viz._basemapDark = pageIsDark(viz);
122
- if (isThemed(viz)) watchPageTheme(viz);
132
+ // Resolve `{light, dark}` basemaps against the chart's theme.
133
+ viz._basemapDark = viz._theme ? viz._theme.dark : pageIsDark(viz);
123
134
  syncTileAttribution(viz);
124
135
  const result = supDraw(callback);
125
136
  const { width, height } = chartBounds(viz);
@@ -127,7 +138,7 @@ function findAttribution(url) {
127
138
  kind: "geomap",
128
139
  width,
129
140
  height,
130
- duration: viz.schema.duration,
141
+ duration: effectiveDuration(viz),
131
142
  // On the canvas backend the ocean + tiles mount in an underlay beneath
132
143
  // the <canvas> (see `ensureZoomDom`), so they show through around the
133
144
  // geography on either backend. Small multiples paint each panel's
@@ -201,7 +212,9 @@ function findAttribution(url) {
201
212
  Accessor function for each data point's coordinates, as
202
213
  `[longitude, latitude]` (d3's coordinate order), or one coordinate for
203
214
  every point. Defaults to each row's `point` key. Rows with a coordinate are
204
- drawn as points; the rest are matched to `topojson` shapes.
215
+ drawn as points; the rest are matched to `topojson` shapes. A point the
216
+ projection clips (on the far side of a globe, or outside
217
+ `"geoAlbersUsa"`'s insets) is not drawn.
205
218
  @type {number[] | function}
206
219
  */ v.point = function(_) {
207
220
  return arguments.length ? (this.schema.point = typeof _ === "function" ? _ : constant(_), this) : this.schema.point;
@@ -240,10 +253,19 @@ function findAttribution(url) {
240
253
  Rotates the projection, as d3-geo's
241
254
  [`projection.rotate`](https://github.com/d3/d3-geo#projection_rotate) angles
242
255
  `[lambda, phi, gamma]` in degrees. Turns `tiles` off, since rotated tiles
243
- no longer line up.
256
+ no longer line up. On a projection that clips to a circle (a globe,
257
+ such as `"geoOrthographic"`), dragging the map turns the globe under the
258
+ pointer instead of panning it (the wheel, a pinch, and the zoom buttons
259
+ still zoom), Shift and the arrow keys turn it 10° of longitude or
260
+ latitude a press while the chart has keyboard focus (stopping at the
261
+ poles, and easing unless `reducedMotion` is on), and the zoom controls'
262
+ reset turns it back to this rotation. Reads back the rotation set
263
+ here, as the zoom transform isn't read back either;
264
+ `projection().rotate()` reads the globe's current one.
244
265
  @type {[number, number] | [number, number, number]}
245
266
  */ v.projectionRotate = function(_) {
246
267
  if (arguments.length) {
268
+ this.schema.projectionRotate = _;
247
269
  this.schema.projection.rotate(_);
248
270
  v.tiles(false);
249
271
  this._zoomSet = false;
@@ -286,12 +308,13 @@ function findAttribution(url) {
286
308
  const v = viz;
287
309
  /**
288
310
  The topojson to draw as geographic paths: a topojson object, or a filepath
289
- or URL to load. An optional formatting function, passed as a second
290
- argument, receives the loaded data and returns the final topojson object.
311
+ or URL to load. `topojsonFormat` transforms it; a function passed as a
312
+ second argument sets it.
291
313
  @type {string | object | false}
292
- */ v.topojson = function(_, f) {
314
+ */ v.topojson = function() {
293
315
  if (arguments.length) {
294
- addToQueue.bind(this)(_, f, "topojson");
316
+ // eslint-disable-next-line prefer-rest-params
317
+ setLoaderValue(this, "topojson", arguments);
295
318
  this._zoomSet = false;
296
319
  return this;
297
320
  }
@@ -299,8 +322,9 @@ function findAttribution(url) {
299
322
  };
300
323
  /**
301
324
  The fill for topojson shapes that have no data (or no `colorScale` value):
302
- a CSS color or a function of the feature. Defaults to a quiet light gray, or
303
- its dark counterpart over a dark basemap.
325
+ a CSS color or a function of the feature. Defaults to the theme's
326
+ `colorScale.missing` when it sets one, else a quiet light gray, or its
327
+ dark counterpart over a dark basemap.
304
328
  @type {CssColor | function}
305
329
  */ v.topojsonFill = function(_) {
306
330
  return arguments.length ? (this.schema.topojsonFill = typeof _ === "function" ? _ : constant(_), this) : this.schema.topojsonFill;
@@ -361,6 +385,8 @@ export const geomapDef = {
361
385
  insetRegion: sceneInsetRegion,
362
386
  // A row without a coordinate point draws as its topojson Path.
363
387
  colorScaleShape: (viz, d, i)=>viz.schema.point(d, i) instanceof Array ? viz.schema.shape(d, i) : "Path",
388
+ // Coordinate points are points for `hoverDistance`; regions keep exact hit-testing.
389
+ pointMark: (_viz, node)=>isPointShape(node),
364
390
  // Clip the geography to the map rectangle — the same box as the ocean rect and
365
391
  // the imperative inner <svg> viewport — so projected paths and points can't
366
392
  // spill past it (e.g. under the legend/timeline) when a `fitObject`/zoom pushes
@@ -375,18 +401,27 @@ export const geomapDef = {
375
401
  setupGeomapRenderTiles(viz);
376
402
  setupGeomapDraw(viz);
377
403
  setupGeomapFluent(viz);
404
+ setupGeomapLinks(viz);
405
+ // Dragging a globe, or Shift and the arrow keys, re-lays the map out for
406
+ // each new rotation.
407
+ const relayout = ()=>runChartDraw(viz, geomapDef, applyGeomapLayout);
408
+ installGlobeRotation(viz, relayout);
409
+ installGlobeKeys(viz, relayout);
378
410
  // Seed the default tile URL through the wrapped accessor so attribution is set.
379
411
  v.tileUrl(DEFAULT_TILE_URL);
380
- // Regions with no data: a quiet light fill, or its dark counterpart over a
381
- // dark basemap (`topojsonFill` replaces both).
382
- viz.schema.topojsonFill = ()=>viz._basemapDark ? "#3d3e44" : "#f5f5f3";
412
+ // Regions with no data: the theme's `colorScale.missing`, else a quiet
413
+ // light fill or its dark counterpart over a dark basemap (`topojsonFill`
414
+ // replaces all three).
415
+ viz.schema.topojsonFill = ()=>viz._theme?.colorScale.missing ?? (viz._basemapDark ? "#3d3e44" : "#f5f5f3");
383
416
  },
384
417
  ctx: {},
385
418
  fields: [
419
+ ...loaderFormatFields("topojson", "links"),
386
420
  {
387
421
  key: "fitObject",
388
422
  default: false
389
423
  },
424
+ ...geomapLinkFields(),
390
425
  {
391
426
  key: "noDataMessage",
392
427
  default: false
@@ -0,0 +1,107 @@
1
+ /**
2
+ Labels of a Geomap's coordinate points: each sits inside its point when it
3
+ fits there, else beside it where there's room, else hides (see
4
+ `labelPosition`).
5
+
6
+ @module
7
+ */ import { colorContrast } from "@d3plus/color";
8
+ import { emitLabels, shapeLabelDefaults } from "../../shapes/emitLabels.js";
9
+ import constant from "../../utils/constant.js";
10
+ import { chartBounds } from "../features/chartGeometry.js";
11
+ import { emitOutsideLabels, insideFontMin, layoutCircleLabels, outsideLabels } from "../features/circleLabels.js";
12
+ import { resolveAccessor, userLabelConfig } from "../features/emitHelpers.js";
13
+ /**
14
+ The label text of a point: the Circle shapeConfig's `label` (`false`
15
+ turns point labels off), else the chart's label for the row.
16
+ */ function pointLabel(viz, circleConfig, d, i) {
17
+ const label = circleConfig.label;
18
+ if (label === false) return undefined;
19
+ if (label !== undefined) return resolveAccessor(label, d, i);
20
+ return viz._drawLabel(d, i);
21
+ }
22
+ /**
23
+ The scene nodes of a Geomap's point labels, painted above the points.
24
+ @param viz The Geomap.
25
+ @param c The projected points, in the order they're drawn.
26
+ @param circleConfig The merged Circle shapeConfig.
27
+ */ export function geomapPointLabels(viz, c, circleConfig) {
28
+ const labelConfig = {
29
+ ...circleConfig.labelConfig ?? {},
30
+ ...userLabelConfig(viz, "Circle")
31
+ };
32
+ const items = c.points.map((d, i)=>{
33
+ const r = c.pointR(d, i);
34
+ return {
35
+ key: d,
36
+ datum: d,
37
+ index: i,
38
+ x: c.pointX(d, i),
39
+ y: c.pointY(d, i),
40
+ r,
41
+ text: pointLabel(viz, circleConfig, d, i),
42
+ inside: {
43
+ width: r * 2,
44
+ height: r * 2,
45
+ shape: "circle",
46
+ padding: resolveAccessor(labelConfig.padding, d, i) ?? shapeLabelDefaults.padding,
47
+ font: {
48
+ family: resolveAccessor(labelConfig.fontFamily, d, i),
49
+ weight: resolveAccessor(labelConfig.fontWeight, d, i)
50
+ }
51
+ }
52
+ };
53
+ });
54
+ const { width, height } = chartBounds(viz);
55
+ const layout = layoutCircleLabels(viz, items, {
56
+ x: 0,
57
+ y: 0,
58
+ width,
59
+ height
60
+ });
61
+ if (!layout.size) return [];
62
+ const index = new Map(c.points.map((d, i)=>[
63
+ d,
64
+ i
65
+ ]));
66
+ const id = (d)=>`geomap-label-${viz._id(d, index.get(d) ?? 0)}`;
67
+ const inside = emitLabels({
68
+ data: c.points,
69
+ label: (d)=>layout.get(d)?.position === "inside" ? layout.get(d).text : false,
70
+ x: (d, i)=>c.pointX(d, i),
71
+ y: (d, i)=>c.pointY(d, i),
72
+ aes: (d, i)=>({
73
+ r: c.pointR(d, i)
74
+ }),
75
+ rotate: constant(0),
76
+ id,
77
+ labelBounds: (_d, _i, aes)=>{
78
+ const r = aes.r;
79
+ return {
80
+ width: r * 2,
81
+ height: r * 2,
82
+ x: -r,
83
+ y: -r,
84
+ shape: "circle"
85
+ };
86
+ },
87
+ labelConfig: {
88
+ fontColor: (rec)=>{
89
+ const d = rec.data;
90
+ const fill = resolveAccessor(circleConfig.fill, d, index.get(d) ?? 0);
91
+ return colorContrast(typeof fill === "string" ? fill : "rgb(255, 255, 255)", viz.schema.colorDefaults);
92
+ },
93
+ textAnchor: "middle",
94
+ verticalAlign: "middle",
95
+ ...labelConfig,
96
+ fontMin: (rec, i)=>insideFontMin(viz, layout.get(rec.data), resolveAccessor(labelConfig.fontMin, rec, i) ?? shapeLabelDefaults.fontMin)
97
+ }
98
+ });
99
+ const beside = outsideLabels(layout, (d)=>({
100
+ id: id(d),
101
+ datum: d
102
+ }));
103
+ return [
104
+ ...inside,
105
+ ...emitOutsideLabels(viz, beside)
106
+ ];
107
+ }
@@ -0,0 +1,103 @@
1
+ /**
2
+ Hexbin's pure binning helpers: points in pixel space grouped into
3
+ hexagons (d3-hexbin) or squares of a fixed pixel size, each bin's
4
+ measure (a count, or a sum or mean of a value), and its outline.
5
+
6
+ @module
7
+ */ import { hexbin } from "d3-hexbin";
8
+ const SQRT3 = Math.sqrt(3);
9
+ /** Whether a point has finite pixel coordinates. */ const placed = (p)=>Number.isFinite(p.x) && Number.isFinite(p.y);
10
+ /**
11
+ Groups points into bins of a fixed pixel size: pointy-top hexagons of
12
+ radius `size`, or `size`-pixel squares. The grid is anchored at `origin`,
13
+ so a grid anchored to a data point moves with it when the view pans.
14
+ Points without finite coordinates are skipped, and only bins holding a
15
+ point are returned.
16
+ @param points The points, in pixels.
17
+ @param options `shape`, `size` (hexagon radius or square side, in
18
+ pixels), and the grid's `origin`.
19
+ */ export function binPoints(points, options) {
20
+ const { shape, size } = options;
21
+ const [ox, oy] = options.origin ?? [
22
+ 0,
23
+ 0
24
+ ];
25
+ const valid = points.filter(placed);
26
+ if (!(size > 0) || !valid.length) return [];
27
+ if (shape === "square") {
28
+ const bins = new Map();
29
+ for (const p of valid){
30
+ const col = Math.floor((p.x - ox) / size);
31
+ const row = Math.floor((p.y - oy) / size);
32
+ const key = `s${col}_${row}`;
33
+ let bin = bins.get(key);
34
+ if (!bin) {
35
+ bin = {
36
+ key,
37
+ cx: ox + (col + 0.5) * size,
38
+ cy: oy + (row + 0.5) * size,
39
+ points: []
40
+ };
41
+ bins.set(key, bin);
42
+ }
43
+ bin.points.push(p);
44
+ }
45
+ return Array.from(bins.values());
46
+ }
47
+ const dx = size * SQRT3;
48
+ const dy = size * 1.5;
49
+ return hexbin().radius(size).x((p)=>p.x - ox).y((p)=>p.y - oy)(valid).map((bin)=>({
50
+ key: `h${Math.round(2 * bin.x / dx)}_${Math.round(bin.y / dy)}`,
51
+ cx: ox + bin.x,
52
+ cy: oy + bin.y,
53
+ points: Array.from(bin)
54
+ }));
55
+ }
56
+ /**
57
+ A bin's pixel bounds: a hexagon's bounding box (it is `√3 × size` wide
58
+ and `2 × size` tall), or a square's sides.
59
+ */ export function binBounds(bin, shape, size) {
60
+ const halfW = shape === "square" ? size / 2 : size * SQRT3 / 2;
61
+ const halfH = shape === "square" ? size / 2 : size;
62
+ return {
63
+ x0: bin.cx - halfW,
64
+ x1: bin.cx + halfW,
65
+ y0: bin.cy - halfH,
66
+ y1: bin.cy + halfH
67
+ };
68
+ }
69
+ /** A bin's outline as an absolute SVG path. */ export function binPath(bin, shape, size) {
70
+ const round = (n)=>Math.round(n * 100) / 100;
71
+ if (shape === "square") {
72
+ const { x0, x1, y0, y1 } = binBounds(bin, shape, size);
73
+ return `M${round(x0)},${round(y0)}H${round(x1)}V${round(y1)}H${round(x0)}Z`;
74
+ }
75
+ const corners = [
76
+ 0,
77
+ 1,
78
+ 2,
79
+ 3,
80
+ 4,
81
+ 5
82
+ ].map((k)=>{
83
+ const angle = k * Math.PI / 3;
84
+ return `${round(bin.cx + Math.sin(angle) * size)},${round(bin.cy - Math.cos(angle) * size)}`;
85
+ });
86
+ return `M${corners.join("L")}Z`;
87
+ }
88
+ /** The area one bin covers, in square pixels. */ export function binArea(shape, size) {
89
+ return shape === "square" ? size * size : 3 * SQRT3 / 2 * size * size;
90
+ }
91
+ /**
92
+ A bin's measure: its point count, or the sum or mean of its points'
93
+ finite weights. A mean with no finite weight is `NaN`.
94
+ */ export function binMeasure(points, agg) {
95
+ if (agg === "count") return points.length;
96
+ let total = 0, n = 0;
97
+ for (const p of points)if (typeof p.weight === "number" && Number.isFinite(p.weight)) {
98
+ total += p.weight;
99
+ n++;
100
+ }
101
+ if (agg === "sum") return total;
102
+ return n ? total / n : NaN;
103
+ }
@@ -0,0 +1,33 @@
1
+ /**
2
+ Hexbin's axis buffer (see `Plot.buffer`): fits each axis to its numeric
3
+ observations and pads it by a bin, so the outermost bins sit inside the
4
+ plot.
5
+
6
+ @module
7
+ */ import { extent } from "d3-array";
8
+ import numericBuffer from "../plotBuffers/numericBuffer.js";
9
+ import { isNumeric } from "./layers.js";
10
+ import { hexbinSettings } from "./settings.js";
11
+ /** Pads one axis's domain so `values`' extremes sit `size` pixels inside it. */ function padAxis(scale, type, values, size, vertical) {
12
+ if (!scale.invert) return;
13
+ const [lo, hi] = extent(values.filter(isNumeric));
14
+ if (lo === undefined || hi === undefined) return;
15
+ let domain = scale.domain().slice();
16
+ domain = numericBuffer(scale, type, lo, size, domain, 0, vertical);
17
+ numericBuffer(scale, type, hi, size, domain, 1, vertical);
18
+ }
19
+ export function hexbinBuffer({ data, x, y, x2, y2, xScale, yScale }) {
20
+ if (x2 || y2) return [
21
+ x,
22
+ y
23
+ ];
24
+ const { size } = hexbinSettings(this);
25
+ x = x.copy();
26
+ y = y.copy();
27
+ padAxis(x, xScale ?? "linear", data.map((d)=>d.x), size, false);
28
+ padAxis(y, yScale ?? "linear", data.map((d)=>d.y), size, true);
29
+ return [
30
+ x,
31
+ y
32
+ ];
33
+ }