@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
@@ -5,6 +5,9 @@
5
5
  */ import { max, min, sum } from "d3-array";
6
6
  import { fontExists, parseSides, textWidth } from "@d3plus/dom";
7
7
  import { textWrap } from "@d3plus/text";
8
+ import { fontStack } from "./fontStack.js";
9
+ import { hitboxPadding, textBoxPath, textBoxRoom } from "./textBoxPath.js";
10
+ import { justifyWords } from "./textBoxWords.js";
8
11
  /** Parses a "style: foo; …" string from defaultHtmlLookup into TextRun style. */ function parseStyleString(styleStr) {
9
12
  const out = {};
10
13
  for (const decl of styleStr.split(";")){
@@ -107,41 +110,68 @@ import { textWrap } from "@d3plus/text";
107
110
  return fS;
108
111
  }
109
112
  /** Assembles the final TextBoxDatum from the resolved layout values. */ function assembleTextBoxDatum(box, d, i, layout) {
110
- const { lineData, line, fS, lH, w, h, vA, style, widths, truncated, padding } = layout;
113
+ const { lineData, line, fS, lH, w, h, vA, style, wrap, kept, padding, path } = layout;
111
114
  const tH = line * lH;
112
115
  const r = box.schema.rotate(d, i);
113
- let yP = r === 0 ? vA === "top" ? 0 : vA === "middle" ? h / 2 - tH / 2 : h - tH : 0;
114
- yP -= lH * 0.1;
116
+ let yP = path || r === 0 ? vA === "top" ? 0 : vA === "middle" ? h / 2 - tH / 2 : h - tH : 0;
117
+ if (path) yP = 0;
118
+ else yP -= lH * 0.1;
115
119
  // Pre-compute per-line runs from HTML markup, carrying open-tag state
116
120
  // across lines so a multi-line <b> continues to bold subsequent lines.
117
121
  const lineRuns = buildLineRuns(box, lineData);
122
+ const tA = box.schema.textAnchor(d, i);
123
+ // A line the wrap didn't produce (the ellipsis drawn when nothing fit) has
124
+ // no wrap data, so it reads as a plain, paragraph-ending line.
125
+ const wrapped = kept.length === lineData.length;
126
+ const pick = (arr, fallback)=>lineData.map((_, l)=>wrapped ? arr[kept[l]] ?? fallback : fallback);
118
127
  return {
119
128
  aH: box.schema.ariaHidden(d, i),
120
129
  data: d,
121
130
  i,
122
131
  lines: lineData,
123
132
  lineRuns,
133
+ hardBreaks: pick(wrap.hardBreaks, true),
134
+ lineWords: tA === "justify" ? justifyWords(pick(wrap.lineWords, []), lineRuns, style) : null,
124
135
  fC: box.schema.fontColor(d, i),
125
136
  fStroke: box.schema.fontStroke(d, i),
126
137
  fSW: box.schema.fontStrokeWidth(d, i),
127
- fF: style["font-family"],
138
+ fF: fontStack(box.schema.fontFamily(d, i), style["font-family"]),
128
139
  fO: box.schema.fontOpacity(d, i),
129
140
  fW: style["font-weight"],
130
141
  id: box.schema.id(d, i),
131
142
  pE: box.schema.pointerEvents(d, i),
132
- tA: box.schema.textAnchor(d, i),
143
+ tA,
133
144
  vA: box.schema.verticalAlign(d, i),
134
- widths,
135
- truncated,
145
+ widths: pick(wrap.widths, 0),
146
+ truncated: wrap.truncated,
136
147
  fS,
137
148
  lH,
138
149
  w,
139
150
  h,
140
151
  r,
141
- x: box.schema.x(d, i) + padding.left,
142
- y: box.schema.y(d, i) + yP + padding.top
152
+ // Text on a path is placed by the path, relative to the box's x/y.
153
+ x: box.schema.x(d, i) + (path ? 0 : padding.left),
154
+ y: box.schema.y(d, i) + (path ? 0 : yP + padding.top),
155
+ path: path ? {
156
+ d: path.d,
157
+ side: path.side,
158
+ offset: path.offset
159
+ } : null,
160
+ pad: padding,
161
+ yP,
162
+ hit: hitboxPadding(box.schema.hitbox(d, i))
143
163
  };
144
164
  }
165
+ /** The wrap result of a box too small to wrap into. */ const EMPTY_WRAP = {
166
+ hardBreaks: [],
167
+ lines: [],
168
+ lineWords: [],
169
+ nextWord: 0,
170
+ sentence: "",
171
+ truncated: false,
172
+ widths: [],
173
+ words: []
174
+ };
145
175
  /**
146
176
  Computes the laid-out text box for a single data point, or null when the
147
177
  text is undefined or wraps to no visible lines.
@@ -152,11 +182,11 @@ import { textWrap } from "@d3plus/text";
152
182
  t = `${t}`.trim();
153
183
  const resize = box.schema.fontResize(d, i);
154
184
  const lHRatio = box.schema.lineHeight(d, i) / box.schema.fontSize(d, i);
155
- let fS = resize ? box.schema.fontMax(d, i) : box.schema.fontSize(d, i), lH = resize ? fS * lHRatio : box.schema.lineHeight(d, i), line = 1, lineData = [], wrapResults = {
156
- lines: [],
157
- truncated: false,
158
- widths: []
159
- };
185
+ let fS = resize ? box.schema.fontMax(d, i) : box.schema.fontSize(d, i), lH = resize ? fS * lHRatio : box.schema.lineHeight(d, i), line = 1, lineData = [], kept = [], wrapResults = EMPTY_WRAP;
186
+ // Text is measured with the one family fontExists finds installed, never a
187
+ // list: a list would measure with whichever family the browser picks, which
188
+ // can change under the wrap as web fonts load. Only the drawn label (`fF`)
189
+ // names the families after it, as fallbacks for other machines.
160
190
  const style = {
161
191
  "font-family": fontExists(box.schema.fontFamily(d, i)),
162
192
  "font-size": fS,
@@ -164,18 +194,21 @@ import { textWrap } from "@d3plus/text";
164
194
  "line-height": lH
165
195
  };
166
196
  const padding = parseSides(box.schema.padding(d, i));
167
- const h = box.schema.height(d, i) - (padding.top + padding.bottom), w = box.schema.width(d, i) - (padding.left + padding.right), shape = box.schema.shape(d, i);
168
- const wrapper = textWrap().fontFamily(style["font-family"]).fontSize(fS).fontWeight(style["font-weight"]).lineHeight(lH).maxLines(box.schema.maxLines(d, i)).height(h).overflow(box.schema.overflow(d, i)).shape(shape).width(w).split(box.schema.split);
197
+ const path = textBoxPath(box, d, i);
198
+ const { w, h } = textBoxRoom(box, d, i, padding, path, lH);
199
+ const shape = box.schema.shape(d, i);
200
+ const wrapper = textWrap().fontFamily(style["font-family"]).fontSize(fS).fontWeight(style["font-weight"]).lineHeight(lH).maxLines(path ? 1 : box.schema.maxLines(d, i)).height(h).overflow(box.schema.overflow(d, i)).shape(shape).width(w).split(box.schema.split).ellipsis((text, n)=>box.schema.ellipsis(text, n)).truncateWord(!!box.schema.truncateWord(d, i));
169
201
  const fMax = box.schema.fontMax(d, i), fMin = box.schema.fontMin(d, i), vA = box.schema.verticalAlign(d, i), words = box.schema.split(t, i);
170
202
  /**
171
203
  Figures out the lineData to be used for wrapping.
172
204
  @private
173
205
  */ function checkSize() {
206
+ // The wrap ends a truncated last line with the ellipsis itself, measured
207
+ // to fit; when nothing fit, the ellipsis decides what to draw instead.
174
208
  const truncate = ()=>{
175
209
  if (line < 1) lineData = [
176
210
  that.schema.ellipsis("", line)
177
211
  ];
178
- else lineData[line - 1] = that.schema.ellipsis(lineData[line - 1], line);
179
212
  };
180
213
  if (resize) {
181
214
  // fontMin/fontMax bound the resize search; a fixed fontSize is used as given.
@@ -193,7 +226,10 @@ import { textWrap } from "@d3plus/text";
193
226
  style["line-height"] = lH;
194
227
  }
195
228
  wrapResults = wrapper(t);
196
- lineData = wrapResults.lines.filter((l)=>l !== "");
229
+ kept = wrapResults.lines.flatMap((l, k)=>l !== "" ? [
230
+ k
231
+ ] : []);
232
+ lineData = kept.map((k)=>wrapResults.lines[k]);
197
233
  line = lineData.length;
198
234
  if (wrapResults.truncated) {
199
235
  if (resize) {
@@ -223,8 +259,9 @@ import { textWrap } from "@d3plus/text";
223
259
  h,
224
260
  vA,
225
261
  style,
226
- widths: wrapResults.widths,
227
- truncated: wrapResults.truncated,
228
- padding
262
+ wrap: wrapResults,
263
+ kept,
264
+ padding,
265
+ path
229
266
  });
230
267
  }
@@ -0,0 +1,73 @@
1
+ /**
2
+ TextBox options that change where its text sits: a path the text follows
3
+ (`textPath`, `startOffset`, `side`), and the transparent `hitbox` behind it.
4
+ */ import { parseSides } from "@d3plus/dom";
5
+ import { samplePath } from "@d3plus/render";
6
+ /**
7
+ Reads a `startOffset`: a distance in pixels, or a percentage of the path's
8
+ length, clamped to the path.
9
+ @param value The configured offset.
10
+ @param length The path's length.
11
+ */ export function resolveOffset(value, length) {
12
+ let px = 0;
13
+ if (typeof value === "number") px = value;
14
+ else if (typeof value === "string") {
15
+ const n = parseFloat(value);
16
+ if (Number.isFinite(n)) px = value.trim().endsWith("%") ? n / 100 * length : n;
17
+ }
18
+ return Math.max(0, Math.min(length, Number.isFinite(px) ? px : 0));
19
+ }
20
+ /**
21
+ The path a datum's text follows, or null when `textPath` gives none.
22
+ @param box The TextBox.
23
+ @param d The datum.
24
+ @param i Its index.
25
+ */ export function textBoxPath(box, d, i) {
26
+ const path = box.schema.textPath(d, i);
27
+ if (typeof path !== "string" || !path.trim()) return null;
28
+ const length = samplePath(path).total;
29
+ if (!length) return null;
30
+ return {
31
+ d: path,
32
+ side: box.schema.side(d, i) === "right" ? "right" : "left",
33
+ offset: resolveOffset(box.schema.startOffset(d, i), length),
34
+ length
35
+ };
36
+ }
37
+ /**
38
+ The room a datum's text wraps into: the box less its padding, or along a
39
+ path, the path from its start offset to its end (one line, which the
40
+ height always fits).
41
+ @param box The TextBox.
42
+ @param d The datum.
43
+ @param i Its index.
44
+ @param padding The box's padding.
45
+ @param path The path the text follows, if any.
46
+ @param lineHeight The line height the wrap starts at.
47
+ */ export function textBoxRoom(box, d, i, padding, path, lineHeight) {
48
+ const h = box.schema.height(d, i) - (padding.top + padding.bottom);
49
+ if (path) return {
50
+ w: path.length - path.offset,
51
+ h: Math.max(h, lineHeight + 1)
52
+ };
53
+ return {
54
+ w: box.schema.width(d, i) - (padding.left + padding.right),
55
+ h
56
+ };
57
+ }
58
+ /**
59
+ The extra room a `hitbox` config adds around the box, or null when the
60
+ box has no hitbox: `true` adds none, and `{padding}` takes a number or CSS
61
+ shorthand string.
62
+ @param value The configured hitbox.
63
+ */ export function hitboxPadding(value) {
64
+ if (!value) return null;
65
+ if (value === true) return {
66
+ top: 0,
67
+ right: 0,
68
+ bottom: 0,
69
+ left: 0
70
+ };
71
+ const padding = value.padding;
72
+ return parseSides(padding ?? 0);
73
+ }
@@ -0,0 +1,223 @@
1
+ /**
2
+ Turns laid-out text boxes (`TextBoxDatum`) into scene nodes: each line's
3
+ position, its runs, and the node's font and paint.
4
+ */ import { strip } from "@d3plus/text";
5
+ import { alignLines, textPathSamples } from "@d3plus/render";
6
+ /**
7
+ A line's baseline y within its box, for the box's vertical alignment and
8
+ rotation.
9
+ @param d The laid-out box.
10
+ @param i The line's index.
11
+ */ export function textBoxLineY(d, i) {
12
+ if (d.r === 0 || d.vA === "top") return (i + 1) * d.lH - (d.lH - d.fS);
13
+ if (d.vA === "middle") return (d.h + d.fS) / 2 - (d.lH - d.fS) + (i - d.lines.length / 2 + 0.5) * d.lH;
14
+ return d.h - 2 * (d.lH - d.fS) - (d.lines.length - (i + 1)) * d.lH + 2 * Math.cos(Math.PI * d.r / 180);
15
+ }
16
+ /**
17
+ Each line of a laid-out box placed across `width` for its `textAnchor`
18
+ (start, middle, end, justify, or a percentage), with the anchor the lines
19
+ are drawn with. A justified line carries one run per word, each at its
20
+ own x. Lines get their y from `textBoxLineY`.
21
+ @param d The laid-out box.
22
+ @param width The width to place the lines across.
23
+ @param rtl Whether the text reads right to left.
24
+ */ export function textBoxLines(d, width, rtl) {
25
+ const last = d.lines.length - 1;
26
+ const placed = alignLines(d.tA, width, d.lines.map((_, i)=>({
27
+ width: d.widths[i] ?? 0,
28
+ words: d.lineWords?.[i] ?? undefined,
29
+ paragraphEnd: i === last || d.hardBreaks[i]
30
+ })), rtl);
31
+ const lines = d.lines.map((text, i)=>{
32
+ const { x, width: lineWidth, wordX } = placed.lines[i];
33
+ const words = d.lineWords?.[i];
34
+ const runs = wordX && words ? words.flatMap((word, k)=>(word.runs ?? [
35
+ {
36
+ text: word.text
37
+ }
38
+ ]).map((run, j)=>j ? run : {
39
+ ...run,
40
+ x: wordX[k]
41
+ })) : d.lineRuns?.[i] ?? undefined;
42
+ return runs ? {
43
+ text,
44
+ x,
45
+ width: lineWidth,
46
+ runs
47
+ } : {
48
+ text,
49
+ x,
50
+ width: lineWidth
51
+ };
52
+ });
53
+ return {
54
+ anchor: placed.anchor,
55
+ lines
56
+ };
57
+ }
58
+ /**
59
+ The x nudge rotated start-aligned text gets in left-to-right boxes, which
60
+ keeps its first glyph clear of the box's edge.
61
+ */ function rotateNudge(d, anchor, rtl) {
62
+ return anchor === "start" && !rtl ? 2 * Math.sin(Math.PI * d.r / 180) : 0;
63
+ }
64
+ /** The font a laid-out box's text is drawn with. */ export function textBoxFont(d, anchor, rtl) {
65
+ return {
66
+ family: d.fF,
67
+ size: d.fS,
68
+ weight: d.fW,
69
+ anchor,
70
+ baseline: "alphabetic",
71
+ dir: rtl ? "rtl" : "ltr"
72
+ };
73
+ }
74
+ /** The paint a laid-out box's text is drawn with. */ export function textBoxPaint(d) {
75
+ return {
76
+ fill: d.fC,
77
+ opacity: d.fO,
78
+ ...d.fStroke && d.fStroke !== "transparent" ? {
79
+ stroke: d.fStroke
80
+ } : {},
81
+ ...d.fSW ? {
82
+ strokeWidth: d.fSW
83
+ } : {}
84
+ };
85
+ }
86
+ /** The transform a laid-out box's nodes share: its position and rotation. */ function textBoxTransform(d, rotateAnchor) {
87
+ return {
88
+ x: d.x,
89
+ y: d.y,
90
+ rotate: d.r,
91
+ rotateAnchor
92
+ };
93
+ }
94
+ /**
95
+ Each line of a laid-out box at its place in the node: across the box with
96
+ its baseline at `textBoxLineY`, or along the box's path, its x the
97
+ distance along the path past the start offset.
98
+ */ function placedLines(d, rtl) {
99
+ const { anchor, lines } = textBoxLines(d, d.w, rtl);
100
+ if (d.path) {
101
+ const offset = d.path.offset;
102
+ return {
103
+ anchor,
104
+ lines: lines.map((ln)=>({
105
+ ...ln,
106
+ x: ln.x + offset,
107
+ y: 0
108
+ }))
109
+ };
110
+ }
111
+ const nudge = rotateNudge(d, anchor, rtl);
112
+ return {
113
+ anchor,
114
+ lines: lines.map((ln, i)=>({
115
+ ...ln,
116
+ x: ln.x + nudge,
117
+ ...ln.runs && nudge ? {
118
+ runs: ln.runs.map((r)=>r.x === undefined ? r : {
119
+ ...r,
120
+ x: r.x + nudge
121
+ })
122
+ } : {},
123
+ y: textBoxLineY(d, i)
124
+ }))
125
+ };
126
+ }
127
+ /**
128
+ The transparent rect behind a laid-out box that makes the whole box
129
+ (padding included, plus the hitbox's own padding) pick its datum, or null
130
+ without a `hitbox`. Text on a path gets the path's bounds, grown by a font
131
+ size on every side. Its key ends in `::hit`, so keyboard navigation and
132
+ chart extents pass over it.
133
+ @param d The laid-out box.
134
+ @param rotateAnchor The point the box rotates about.
135
+ */ export function textBoxHitbox(d, rotateAnchor) {
136
+ const hit = d.hit;
137
+ if (!hit) return null;
138
+ let x, y, width, height;
139
+ if (d.path) {
140
+ const { points } = textPathSamples({
141
+ d: d.path.d,
142
+ side: d.path.side
143
+ });
144
+ const xs = points.map((p)=>p[0]), ys = points.map((p)=>p[1]);
145
+ x = Math.min(...xs) - d.fS;
146
+ y = Math.min(...ys) - d.fS;
147
+ width = Math.max(...xs) - x + d.fS;
148
+ height = Math.max(...ys) - y + d.fS;
149
+ } else {
150
+ x = -d.pad.left;
151
+ y = -(d.yP + d.pad.top);
152
+ width = d.w + d.pad.left + d.pad.right;
153
+ height = d.h + d.pad.top + d.pad.bottom;
154
+ }
155
+ return {
156
+ type: "rect",
157
+ key: `${d.id}::hit`,
158
+ datum: d.data,
159
+ index: d.i,
160
+ x: x - hit.left,
161
+ y: y - hit.top,
162
+ width: width + hit.left + hit.right,
163
+ height: height + hit.top + hit.bottom,
164
+ paint: {
165
+ fill: "transparent"
166
+ },
167
+ transform: textBoxTransform(d, rotateAnchor),
168
+ aria: {
169
+ hidden: true
170
+ },
171
+ interactive: d.pE !== "none"
172
+ };
173
+ }
174
+ /**
175
+ The text node for one laid-out box.
176
+ @param d The laid-out box.
177
+ @param rotateAnchor The point the box rotates about.
178
+ @param rtl Whether the text reads right to left.
179
+ */ export function textBoxNode(d, rotateAnchor, rtl) {
180
+ const { anchor, lines } = placedLines(d, rtl);
181
+ const ariaHidden = d.aH === "true" || d.aH === true;
182
+ return {
183
+ type: "text",
184
+ key: d.id,
185
+ id: `d3plus-textBox-${strip(d.id)}`,
186
+ datum: d.data,
187
+ index: d.i,
188
+ x: 0,
189
+ y: 0,
190
+ width: d.w,
191
+ height: d.h,
192
+ lines,
193
+ font: textBoxFont(d, anchor, rtl),
194
+ paint: textBoxPaint(d),
195
+ transform: textBoxTransform(d, rotateAnchor),
196
+ aria: ariaHidden ? {
197
+ hidden: true
198
+ } : undefined,
199
+ interactive: d.pE !== "none",
200
+ ...d.path ? {
201
+ path: {
202
+ d: d.path.d,
203
+ side: d.path.side
204
+ }
205
+ } : {}
206
+ };
207
+ }
208
+ /**
209
+ The scene nodes for one laid-out box: its text, behind it its hitbox
210
+ when it has one.
211
+ @param d The laid-out box.
212
+ @param rotateAnchor The point the box rotates about.
213
+ @param rtl Whether the text reads right to left.
214
+ */ export function textBoxNodes(d, rotateAnchor, rtl) {
215
+ const text = textBoxNode(d, rotateAnchor, rtl);
216
+ const hit = textBoxHitbox(d, rotateAnchor);
217
+ return hit ? [
218
+ hit,
219
+ text
220
+ ] : [
221
+ text
222
+ ];
223
+ }
@@ -0,0 +1,70 @@
1
+ /**
2
+ The words of each wrapped line that justified text spreads apart, with
3
+ any styled runs (bold/italic from HTML markup) split at word boundaries
4
+ so each word can be placed on its own.
5
+ */ import { textWidth } from "@d3plus/dom";
6
+ /** A word's visible text: its markup removed. */ function visible(text) {
7
+ return text.replace(/<[^>]+>/g, "");
8
+ }
9
+ /**
10
+ Splits a line's runs where its words begin, so each word gets the runs
11
+ (or run pieces) that draw it. Returns null when the runs and words don't
12
+ spell the same text.
13
+ @param runs The line's styled runs.
14
+ @param words The line's words as wrapped (markup included).
15
+ */ export function splitRunsAtWords(runs, words) {
16
+ const texts = words.map(visible);
17
+ if (runs.map((r)=>r.text).join("") !== texts.join("")) return null;
18
+ const out = texts.map(()=>[]);
19
+ let w = 0, used = 0;
20
+ for (const run of runs){
21
+ let rest = run.text;
22
+ while(rest){
23
+ while(w < texts.length - 1 && used >= texts[w].length){
24
+ w++;
25
+ used = 0;
26
+ }
27
+ const take = Math.min(rest.length, texts[w].length - used) || rest.length;
28
+ out[w].push({
29
+ ...run,
30
+ text: rest.slice(0, take)
31
+ });
32
+ rest = rest.slice(take);
33
+ used += take;
34
+ }
35
+ }
36
+ return out;
37
+ }
38
+ /**
39
+ The words of each line for justified text. Plain lines use the wrap's
40
+ words and widths; a line with styled runs measures each word's pieces in
41
+ their own weight and style. A line whose runs can't be matched to its
42
+ words gets null, and is not justified.
43
+ @param lineWords Each line's words, as the wrap measured them.
44
+ @param lineRuns Each line's styled runs, or null for plain text.
45
+ @param style The font the text was measured with.
46
+ */ export function justifyWords(lineWords, lineRuns, style) {
47
+ return lineWords.map((words, l)=>{
48
+ const runs = lineRuns?.[l];
49
+ if (!runs) return words;
50
+ const pieces = splitRunsAtWords(runs, words.map((w)=>w.text));
51
+ if (!pieces) return null;
52
+ return words.map((word, k)=>{
53
+ const parts = pieces[k];
54
+ const width = parts.reduce((sum, part, j)=>{
55
+ const text = j === parts.length - 1 ? part.text.trimEnd() : part.text;
56
+ const measured = textWidth(text, {
57
+ ...style,
58
+ "font-weight": part.style?.weight ?? style["font-weight"],
59
+ "font-style": part.style?.style ?? "normal"
60
+ });
61
+ return sum + measured;
62
+ }, 0);
63
+ return {
64
+ text: word.text,
65
+ width,
66
+ runs: parts
67
+ };
68
+ });
69
+ });
70
+ }
@@ -20,6 +20,7 @@ import Shape from "./Shape.js";
20
20
  /**
21
21
  Creates SVG areas based on an array of data.
22
22
  */ export default class Area extends Shape {
23
+ static _displayName = "Area";
23
24
  /**
24
25
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
25
26
  @private
@@ -16,6 +16,7 @@ import Shape from "./Shape.js";
16
16
  /**
17
17
  Creates SVG bars based on an array of data.
18
18
  */ export default class Bar extends Shape {
19
+ static _displayName = "Bar";
19
20
  /**
20
21
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
21
22
  @private
@@ -258,6 +258,7 @@ const toAccessor = (value)=>typeof value === "function" ? value : accessor(value
258
258
  /**
259
259
  Creates SVG box-and-whisker plots based on an array of data, one per group of values.
260
260
  */ export default class Box extends BaseClass {
261
+ static _displayName = "Box";
261
262
  _data;
262
263
  _select;
263
264
  _box;
@@ -30,6 +30,7 @@ import Shape from "./Shape.js";
30
30
  /**
31
31
  Creates SVG circles based on an array of data.
32
32
  */ export default class Circle extends Shape {
33
+ static _displayName = "Circle";
33
34
  /**
34
35
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
35
36
  @private
@@ -19,6 +19,7 @@ import Shape from "./Shape.js";
19
19
  /**
20
20
  Creates SVG lines based on an array of data.
21
21
  */ export default class Line extends Shape {
22
+ static _displayName = "Line";
22
23
  /**
23
24
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
24
25
  @private
@@ -12,6 +12,7 @@ import Shape from "./Shape.js";
12
12
  /**
13
13
  Creates SVG Paths based on an array of data.
14
14
  */ export default class Path extends Shape {
15
+ static _displayName = "Path";
15
16
  /**
16
17
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
17
18
  @private
@@ -33,6 +33,7 @@ import Shape from "./Shape.js";
33
33
  /**
34
34
  Creates SVG rectangles based on an array of data.
35
35
  */ export default class Rect extends Shape {
36
+ static _displayName = "Rect";
36
37
  /**
37
38
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
38
39
  @private
@@ -195,6 +195,7 @@ import { backgroundImageLayout, emitBackgroundImages, sortRanks } from "./sceneS
195
195
  /**
196
196
  An abstracted class for generating shapes.
197
197
  */ export default class Shape extends BaseClass {
198
+ static _displayName = "Shape";
198
199
  _data;
199
200
  _labelClass;
200
201
  _name;
@@ -108,6 +108,7 @@ const shapes = {
108
108
  /**
109
109
  Creates SVG whiskers based on an array of data: a line from each point in a given direction, capped with an endpoint shape.
110
110
  */ export default class Whisker extends BaseClass {
111
+ static _displayName = "Whisker";
111
112
  _data;
112
113
  _select;
113
114
  _line;