@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.
- package/es/index.js +1 -1
- package/es/internal.js +167 -8
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +3 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +2 -1
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +86 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +5 -1
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +64 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +8 -2
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +18 -10
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +34 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +2 -2
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -35
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +2 -3
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +16 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +3 -7
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +61 -28
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +72 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +10 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +8 -1
- package/es/src/charts/events/mousemove.shape.js +5 -2
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +2 -1
- package/es/src/charts/features/axesFinal.js +3 -1
- package/es/src/charts/features/axesMeasure.js +7 -4
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +2 -1
- package/es/src/charts/features/colorScaleHover.js +3 -2
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +20 -6
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +38 -11
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +47 -31
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +2 -2
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +39 -36
- package/es/src/charts/viz/VizBase.js +18 -10
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -3
- package/es/src/charts/viz/vizDefaults.js +15 -23
- package/es/src/charts/viz/vizFields.js +35 -0
- package/es/src/charts/viz/vizRender.js +43 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +6 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +5 -9
- package/es/src/components/Axis/axisLayoutScale.js +7 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +15 -9
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +29 -65
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +7 -3
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +25 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +250 -8
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +15 -8
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +16 -2
- package/types/src/charts/viz/VizBase.d.ts +6 -6
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +32 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +84 -7
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +1 -0
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +981 -30
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +86811 -61031
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +28392 -6498
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkLabel` on the node-link charts: a line of text at the middle of each
|
|
3
|
+
link, along it or level, on a pad of the chart's background so it reads
|
|
4
|
+
over the links. Along a curved link, the text and its pad follow the
|
|
5
|
+
curve. Labels that would cover a node or another label are left out, the
|
|
6
|
+
most prominent links' first. Labels are inert to the pointer and
|
|
7
|
+
keyboard, and dim with their link on hover.
|
|
8
|
+
*/
|
|
9
|
+
import type { SceneNode } from "@d3plus/render";
|
|
10
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
11
|
+
import type { LabelObstacles, LinkAnchor, LinkLabelBox } from "./linkLabelGeometry.js";
|
|
12
|
+
import type { Pt } from "./pathLabelGeometry.js";
|
|
13
|
+
/** `linkLabelConfig`'s defaults. */
|
|
14
|
+
export declare const LINK_LABEL_DEFAULTS: {
|
|
15
|
+
rotate: string;
|
|
16
|
+
fontSize: number;
|
|
17
|
+
padding: number;
|
|
18
|
+
backgroundOpacity: number;
|
|
19
|
+
minRadius: number;
|
|
20
|
+
};
|
|
21
|
+
/** The resolved `linkLabelConfig`. */
|
|
22
|
+
export interface LinkLabelSettings {
|
|
23
|
+
/** `"along"` runs text along its link (kept upright); `"horizontal"` keeps it level. */
|
|
24
|
+
rotate: "along" | "horizontal";
|
|
25
|
+
fontSize: number;
|
|
26
|
+
/** The pad around the text, in pixels. */
|
|
27
|
+
padding: number;
|
|
28
|
+
/** The opacity of the background pad. */
|
|
29
|
+
backgroundOpacity: number;
|
|
30
|
+
/** The tightest bend a curved label follows, as a radius in ems. */
|
|
31
|
+
minRadius: number;
|
|
32
|
+
/** The rest, as TextBox config (fontFamily, fontColor, fontWeight, …). */
|
|
33
|
+
text: Record<string, unknown>;
|
|
34
|
+
}
|
|
35
|
+
/** Reads `linkLabelConfig`, with its defaults for anything missing or invalid. */
|
|
36
|
+
export declare function linkLabelSettings(viz: VizInstance): LinkLabelSettings;
|
|
37
|
+
/**
|
|
38
|
+
A `linkLabel` value as text: a number abbreviated in the chart's locale,
|
|
39
|
+
a string as given, and nothing for anything else.
|
|
40
|
+
*/
|
|
41
|
+
export declare function linkLabelText(value: unknown, locale?: string): string;
|
|
42
|
+
/**
|
|
43
|
+
The boxes the lines of text scene nodes (such as a chart's node labels)
|
|
44
|
+
cover, each rotated with its node: about a line's glyphs, from 0.8em
|
|
45
|
+
above its baseline to 0.2em below.
|
|
46
|
+
@param nodes Scene nodes; text nodes inside groups are included.
|
|
47
|
+
*/
|
|
48
|
+
export declare function textLineBoxes(nodes: readonly SceneNode[]): LinkLabelBox[];
|
|
49
|
+
/** One drawn link a label may go on. */
|
|
50
|
+
export interface LinkLabelRequest {
|
|
51
|
+
/** The link's scene key; the label's is built from it. */
|
|
52
|
+
key: string;
|
|
53
|
+
/** The drawn link's datum, which the label carries so it dims with the link. */
|
|
54
|
+
link: object;
|
|
55
|
+
/** The link's position among the drawn links. */
|
|
56
|
+
i: number;
|
|
57
|
+
/** Where on the link the label goes, or null for nowhere. */
|
|
58
|
+
anchor: LinkAnchor | null;
|
|
59
|
+
/**
|
|
60
|
+
A curved link's centerline, between the edges of its nodes: an
|
|
61
|
+
`"along"` label follows it, centered where `anchor` falls on it (or
|
|
62
|
+
halfway along without one). A straight link needs none.
|
|
63
|
+
*/
|
|
64
|
+
path?: Pt[] | null;
|
|
65
|
+
/** Links with a larger priority (such as a wider stroke) get their label first. */
|
|
66
|
+
priority?: number;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
The labels for the drawn links, as scene nodes: for each link with
|
|
70
|
+
`linkLabel` text that fits, a group at the link's middle, rotated with
|
|
71
|
+
the link unless `linkLabelConfig.rotate` is `"horizontal"`, holding a pad
|
|
72
|
+
in the chart's background and the text in the chart's ink. Along a
|
|
73
|
+
curved link (one with a `path`), the text follows the curve over a pad
|
|
74
|
+
that follows it too.
|
|
75
|
+
@param obstacles The nodes labels stay clear of.
|
|
76
|
+
*/
|
|
77
|
+
export declare function emitLinkLabels(viz: VizInstance, requests: readonly LinkLabelRequest[], obstacles: LabelObstacles): SceneNode[];
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The stroke widths the node-link charts size their links between when
|
|
3
|
+
`linkSize` values differ.
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
The share of the smallest node's radius the heaviest link is drawn at
|
|
7
|
+
by default: a quarter of the node's width, so links read as weighted
|
|
8
|
+
lines beside their nodes rather than bands as wide as them, and a
|
|
9
|
+
heavy link's arrowhead (1.5× its stroke) stays narrower than the node.
|
|
10
|
+
*/
|
|
11
|
+
export declare const LINK_SIZE_SHARE = 0.5;
|
|
12
|
+
/**
|
|
13
|
+
The thinnest and widest link, in pixels, for links whose `linkSize`
|
|
14
|
+
values differ. The thinnest is `sizeMin` (1 when unset). The widest is
|
|
15
|
+
`sizeMax` when set, which also caps the thinnest; otherwise it is half
|
|
16
|
+
the smallest node's radius (`rMin`), and never thinner than the
|
|
17
|
+
thinnest.
|
|
18
|
+
*/
|
|
19
|
+
export declare function linkWidthRange(sizeMin: unknown, sizeMax: unknown, rMin: number): [number, number];
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Polyline geometry for labels drawn along a line (trend line labels, line
|
|
3
|
+
labels that follow their series): trimming a line to the plot, keeping
|
|
4
|
+
its text upright, lifting it clear of the stroke, and the path `d` a
|
|
5
|
+
TextBox `textPath` follows.
|
|
6
|
+
*/
|
|
7
|
+
/** A point in pixels. */
|
|
8
|
+
export type Pt = [number, number];
|
|
9
|
+
/** A rectangle by its edges. */
|
|
10
|
+
export interface Edges {
|
|
11
|
+
x0: number;
|
|
12
|
+
y0: number;
|
|
13
|
+
x1: number;
|
|
14
|
+
y1: number;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
The polyline's length.
|
|
18
|
+
@param points The polyline.
|
|
19
|
+
*/
|
|
20
|
+
export declare function polylineLength(points: Pt[]): number;
|
|
21
|
+
/**
|
|
22
|
+
The polyline in the direction its text reads upright: left to right, or
|
|
23
|
+
bottom to top when it runs (near enough) straight up or down. A line
|
|
24
|
+
running right to left in screen space (a reversed axis, or a fit along
|
|
25
|
+
the y axis) is reversed, so its text never reads upside down.
|
|
26
|
+
@param points The polyline.
|
|
27
|
+
@param steep How far across, for each pixel up or down, a line can run
|
|
28
|
+
and still read bottom to top. Defaults to `0.02`.
|
|
29
|
+
*/
|
|
30
|
+
export declare function uprightPoints(points: Pt[], steep?: number): Pt[];
|
|
31
|
+
/**
|
|
32
|
+
The polyline moved `distance` pixels to its left (above a line running
|
|
33
|
+
left to right), each vertex along the average of its segments' normals.
|
|
34
|
+
@param points The polyline.
|
|
35
|
+
@param distance How far to move it.
|
|
36
|
+
*/
|
|
37
|
+
export declare function offsetPolyline(points: Pt[], distance: number): Pt[];
|
|
38
|
+
/**
|
|
39
|
+
The stretch of the polyline from `from` to `to` pixels along it, its ends
|
|
40
|
+
interpolated.
|
|
41
|
+
@param points The polyline.
|
|
42
|
+
@param from The distance along it where the stretch starts.
|
|
43
|
+
@param to The distance along it where the stretch ends.
|
|
44
|
+
*/
|
|
45
|
+
export declare function trimPolyline(points: Pt[], from: number, to: number): Pt[];
|
|
46
|
+
/**
|
|
47
|
+
A polyline with the distance along it to each of its points, for taking
|
|
48
|
+
many stretches or samples of it in one pass: `trim` and `at` give what
|
|
49
|
+
`trimPolyline` does, but start from the first segment the stretch
|
|
50
|
+
reaches instead of the polyline's first point. Walking forward is
|
|
51
|
+
cheapest; a shorter distance than the last searches back.
|
|
52
|
+
*/
|
|
53
|
+
export declare class PolylineRuler {
|
|
54
|
+
private points;
|
|
55
|
+
/** The polyline's length. */
|
|
56
|
+
readonly length: number;
|
|
57
|
+
/** The distance along the polyline to each point. */
|
|
58
|
+
private cum;
|
|
59
|
+
/** The segment (its end point's index) the last lookup stopped at. */
|
|
60
|
+
private i;
|
|
61
|
+
/** @param points The polyline. */
|
|
62
|
+
constructor(points: Pt[]);
|
|
63
|
+
/** The first segment ending `distance` or more along the polyline (`points.length` when none does). */
|
|
64
|
+
private seek;
|
|
65
|
+
/**
|
|
66
|
+
The stretch from `from` to `to` pixels along the polyline, the same
|
|
67
|
+
points `trimPolyline` gives.
|
|
68
|
+
@param from The distance along it where the stretch starts.
|
|
69
|
+
@param to The distance along it where the stretch ends.
|
|
70
|
+
*/
|
|
71
|
+
trim(from: number, to: number): Pt[];
|
|
72
|
+
/**
|
|
73
|
+
The point `distance` pixels along the polyline, as `trimPolyline`'s
|
|
74
|
+
first point for a stretch from there to there, or undefined past its
|
|
75
|
+
end.
|
|
76
|
+
@param distance The distance along it.
|
|
77
|
+
*/
|
|
78
|
+
at(distance: number): Pt | undefined;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
The longest run of consecutive points inside `rect`: the part of a line a
|
|
82
|
+
label can sit on where the plot's domains don't cut it off.
|
|
83
|
+
@param points The polyline.
|
|
84
|
+
@param rect The plot area.
|
|
85
|
+
*/
|
|
86
|
+
export declare function visibleRun(points: Pt[], rect: Edges): Pt[];
|
|
87
|
+
/**
|
|
88
|
+
The SVG path `d` through a polyline's points.
|
|
89
|
+
@param points The polyline.
|
|
90
|
+
*/
|
|
91
|
+
export declare function polylineD(points: Pt[]): string;
|
|
92
|
+
/**
|
|
93
|
+
The plot area's edges from its x and y ranges, the y range shifted up by
|
|
94
|
+
the top x axis's height, as the plot's clip reads them.
|
|
95
|
+
@param xRange The x range in pixels.
|
|
96
|
+
@param yRange The y range in pixels.
|
|
97
|
+
@param x2Height The top x axis's height.
|
|
98
|
+
*/
|
|
99
|
+
export declare function plotEdges(xRange: unknown[], yRange: unknown[], x2Height?: number): Edges;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Labels drawn along a line with a TextBox `textPath`: in their line's
|
|
3
|
+
color, legible on the chart's background, over a halo of that background,
|
|
4
|
+
and inert (no hover, click, or keyboard stop). A label given its mark's
|
|
5
|
+
datum dims and highlights with that mark.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { SceneNode } from "@d3plus/render";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
/** One label along a path. */
|
|
11
|
+
export interface PathLabel {
|
|
12
|
+
/** The label's scene key. */
|
|
13
|
+
key: string;
|
|
14
|
+
text: string;
|
|
15
|
+
/** The path's `d`, in the plot's coordinates. */
|
|
16
|
+
d: string;
|
|
17
|
+
/** The line's color, made legible on the chart's background. */
|
|
18
|
+
color: string;
|
|
19
|
+
/** Where along the path the text sits: `"start"`, `"middle"`, or `"end"`. */
|
|
20
|
+
anchor: "start" | "middle" | "end";
|
|
21
|
+
/** The datum of the mark the label names, so hover dims them together. */
|
|
22
|
+
datum?: DataPoint;
|
|
23
|
+
/** That mark's index. */
|
|
24
|
+
index?: number;
|
|
25
|
+
}
|
|
26
|
+
/** Options for `pathLabelNodes`. */
|
|
27
|
+
export interface PathLabelOptions {
|
|
28
|
+
/** Whether a halo of the chart's background clears the marks around the text. Defaults to `true`. */
|
|
29
|
+
halo?: boolean;
|
|
30
|
+
}
|
|
31
|
+
/** The label font size when a config sets none. */
|
|
32
|
+
export declare const PATH_LABEL_FONT_SIZE = 11;
|
|
33
|
+
/**
|
|
34
|
+
The scene nodes for labels along paths, each cut short with an ellipsis
|
|
35
|
+
when its path is too short for it.
|
|
36
|
+
@param viz The chart, for its theme, background, and locale.
|
|
37
|
+
@param labels The labels.
|
|
38
|
+
@param config TextBox config laid over the defaults.
|
|
39
|
+
@param options Whether the text takes a halo.
|
|
40
|
+
*/
|
|
41
|
+
export declare function pathLabelNodes(viz: VizInstance, labels: PathLabel[], config?: Record<string, unknown>, options?: PathLabelOptions): SceneNode[];
|
|
@@ -7,12 +7,9 @@ import type { SceneNode } from "@d3plus/render";
|
|
|
7
7
|
import * as shapes from "../../shapes/index.js";
|
|
8
8
|
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
9
9
|
import type { PlotAxisFn } from "./plotPaint.js";
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
layer?: string;
|
|
14
|
-
[key: string]: unknown;
|
|
15
|
-
}
|
|
10
|
+
import type { AnnotationFrame } from "./annotationFrame.js";
|
|
11
|
+
import type { Annotation } from "./annotationTypes.js";
|
|
12
|
+
export type { Annotation };
|
|
16
13
|
/**
|
|
17
14
|
Wraps one annotation's scene in its OWN stable-keyed group, keeping the
|
|
18
15
|
shape's node group and label group as distinct sub-groups (rather than
|
|
@@ -31,8 +28,26 @@ export declare function collectAnnotationGroup(inst: shapes.Shape, key: string):
|
|
|
31
28
|
same mapping user `annotations` get.
|
|
32
29
|
*/
|
|
33
30
|
export declare function renderPlotAnnotation(viz: Viz, annotation: Annotation, x: PlotAxisFn, y: PlotAxisFn, domains: Record<string, unknown[]>, yOffset: number): shapes.Shape;
|
|
31
|
+
/**
|
|
32
|
+
The layer an annotation draws in: its own `layer`, else `"front"` for a
|
|
33
|
+
callout and `"back"` for everything else.
|
|
34
|
+
@param annotation The annotation.
|
|
35
|
+
*/
|
|
36
|
+
export declare function annotationLayer(annotation: Annotation): string;
|
|
37
|
+
/**
|
|
38
|
+
Every annotation a Plot draws: its `referenceBands`, then its
|
|
39
|
+
`referenceLines` (so lines draw over bands), then its own `annotations`.
|
|
40
|
+
@param viz The chart.
|
|
41
|
+
*/
|
|
42
|
+
export declare function plotAnnotationList(viz: Viz): Annotation[];
|
|
34
43
|
/**
|
|
35
44
|
Renders back/front annotations, pushing back-layer scenes onto `out` and
|
|
36
|
-
returning the front-layer
|
|
45
|
+
returning the front-layer groups, which the caller places above the data
|
|
46
|
+
shapes. A back-layer reference line or band's label joins the front
|
|
47
|
+
groups, so the data never covers it.
|
|
37
48
|
*/
|
|
38
|
-
export declare function emitAnnotations(viz: Viz, out: SceneNode[],
|
|
49
|
+
export declare function emitAnnotations(viz: Viz, out: SceneNode[], axes: {
|
|
50
|
+
x: PlotAxisFn;
|
|
51
|
+
y: PlotAxisFn;
|
|
52
|
+
frame: AnnotationFrame;
|
|
53
|
+
}, domains: Record<string, number[]>, yOffset: number): SceneNode[];
|
|
@@ -15,6 +15,7 @@ import type { ClipShape, SceneNode } from "@d3plus/render";
|
|
|
15
15
|
import type Axis from "../../components/Axis/Axis.js";
|
|
16
16
|
import type { EndLabelBox, XLabelMode } from "./plotEndLabels.js";
|
|
17
17
|
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
18
|
+
import type { LineLabelSide } from "../Plot/lineLabelSides.js";
|
|
18
19
|
/** An axis position function: maps a domain value to a pixel coordinate. */
|
|
19
20
|
export type PlotAxisFn = (d: unknown, axis?: string) => number;
|
|
20
21
|
/**
|
|
@@ -24,6 +25,18 @@ export type PlotAxisFn = (d: unknown, axis?: string) => number;
|
|
|
24
25
|
*/
|
|
25
26
|
export interface LabelWidth {
|
|
26
27
|
id: string | number;
|
|
28
|
+
/** Which end of its line the label sits past (the right end when unset). */
|
|
29
|
+
side?: LineLabelSide;
|
|
30
|
+
/** The formatted value the label shows after the series name, if any. */
|
|
31
|
+
valueText?: string;
|
|
32
|
+
/** The series name, shortened to fit the label's room; unset when it fits. */
|
|
33
|
+
name?: string;
|
|
34
|
+
/** The plot had no room for this label (see `collapsed`). */
|
|
35
|
+
hidden?: boolean;
|
|
36
|
+
/** How many labels this one stands for as "+N more", when the plot had no room for them all. */
|
|
37
|
+
collapsed?: number;
|
|
38
|
+
/** The label's width, padding included. */
|
|
39
|
+
labelWidth?: number;
|
|
27
40
|
xValue: unknown;
|
|
28
41
|
value: unknown;
|
|
29
42
|
fontSize: number;
|
|
@@ -122,6 +135,8 @@ export interface PlotPaintContext {
|
|
|
122
135
|
y2Ticks: unknown[];
|
|
123
136
|
labelWidths: LabelWidth[];
|
|
124
137
|
largestLabel: number;
|
|
138
|
+
/** The room left of the x range for the lines' left-end labels. */
|
|
139
|
+
startLabelSpace?: number;
|
|
125
140
|
xRangeMax: number;
|
|
126
141
|
xTest: Axis;
|
|
127
142
|
yTest: Axis;
|
|
@@ -164,6 +179,8 @@ export interface PlotPaintContext {
|
|
|
164
179
|
zoomAxes?: Partial<Record<"x" | "x2" | "y" | "y2", Record<string, unknown>>>;
|
|
165
180
|
/** Where a zoom repaint's unzoomed x/y plot ranges land (see `Plot/plotZoom.ts`). */
|
|
166
181
|
zoomRanges?: Partial<Record<"x" | "y", number[]>>;
|
|
182
|
+
/** Line rows with no plottable value, where `connectGaps` breaks lines. */
|
|
183
|
+
missingRows?: PlotDatum[];
|
|
167
184
|
}
|
|
168
185
|
/**
|
|
169
186
|
Result of the MEASURE phase of plotPaint. Captures everything the EMIT
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Measuring and drawing polylines: a sampled curve, a map's projected
|
|
3
|
+
link, or a bundled edge, as a list of `[x, y]` points.
|
|
4
|
+
*/
|
|
5
|
+
import type { LinkAnchor } from "./linkLabelGeometry.js";
|
|
6
|
+
/** A point in pixels, `[x, y]`. */
|
|
7
|
+
export type Point = [number, number];
|
|
8
|
+
/** A polyline as a path `d`. */
|
|
9
|
+
export declare function polylinePath(points: Point[]): string;
|
|
10
|
+
/**
|
|
11
|
+
A polyline shortened along its length by `start` pixels at its first
|
|
12
|
+
end and `end` at its last. When the cuts meet, it collapses to the
|
|
13
|
+
point where they do.
|
|
14
|
+
*/
|
|
15
|
+
export declare function trimPolyline(points: Point[], start: number, end: number): Point[];
|
|
16
|
+
/** A polyline's length. */
|
|
17
|
+
export declare function polylineLength(points: Point[]): number;
|
|
18
|
+
/**
|
|
19
|
+
The point `distance` along a polyline from its start (clamped to its
|
|
20
|
+
ends), and the direction the polyline runs there, in radians.
|
|
21
|
+
*/
|
|
22
|
+
export declare function polylineAt(points: Point[], distance: number): LinkAnchor;
|
|
23
|
+
/** The middle of a polyline's length, and its direction there. */
|
|
24
|
+
export declare function polylineMidpoint(points: Point[]): LinkAnchor;
|
|
25
|
+
/** The box around a polyline, as `[[x0, y0], [x1, y1]]`. */
|
|
26
|
+
export declare function polylineBox(points: Point[]): [Point, Point];
|
|
27
|
+
/**
|
|
28
|
+
How far along a polyline, from its first point, it first gets `radius`
|
|
29
|
+
pixels away from that point: where it leaves a circle of that radius
|
|
30
|
+
around its start. The polyline's whole length when it never does.
|
|
31
|
+
*/
|
|
32
|
+
export declare function polylineReach(points: Point[], radius: number): number;
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Reference lines and bands: `referenceLines`/`referenceBands` entries
|
|
3
|
+
expand into `"ReferenceLine"`/`"ReferenceBand"` annotations, drawn as a
|
|
4
|
+
line across the whole plot at one value, or a shaded span between two,
|
|
5
|
+
with an optional label. Both sit behind the data unless `layer: "front"`;
|
|
6
|
+
their labels draw above it, clear of the data labels (see
|
|
7
|
+
`placeReferenceLabels`).
|
|
8
|
+
*/
|
|
9
|
+
import type { SceneNode } from "@d3plus/render";
|
|
10
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
11
|
+
import { type AnnotationAxis, type AnnotationFrame } from "./annotationFrame.js";
|
|
12
|
+
import { type TextAlign, type TextBlock } from "./annotationText.js";
|
|
13
|
+
import type { Annotation } from "./annotationTypes.js";
|
|
14
|
+
import type { Box } from "./calloutLayout.js";
|
|
15
|
+
import { type LabelSpot } from "./referenceLabelPlacement.js";
|
|
16
|
+
/** The annotation shape a `referenceLines` entry expands into. */
|
|
17
|
+
export declare const REFERENCE_LINE = "ReferenceLine";
|
|
18
|
+
/** The annotation shape a `referenceBands` entry expands into. */
|
|
19
|
+
export declare const REFERENCE_BAND = "ReferenceBand";
|
|
20
|
+
/**
|
|
21
|
+
Expands `referenceLines` into `"ReferenceLine"` annotations, in the back
|
|
22
|
+
layer unless an entry sets its own.
|
|
23
|
+
@param setting The `referenceLines` setting.
|
|
24
|
+
*/
|
|
25
|
+
export declare function expandReferenceLines(setting: unknown): Annotation[];
|
|
26
|
+
/**
|
|
27
|
+
Expands `referenceBands` into `"ReferenceBand"` annotations, in the back
|
|
28
|
+
layer unless an entry sets its own.
|
|
29
|
+
@param setting The `referenceBands` setting.
|
|
30
|
+
*/
|
|
31
|
+
export declare function expandReferenceBands(setting: unknown): Annotation[];
|
|
32
|
+
/**
|
|
33
|
+
The axis a reference entry is on: the first of `x`, `y`, `x2`, `y2` it
|
|
34
|
+
sets, or null.
|
|
35
|
+
@param entry The entry.
|
|
36
|
+
*/
|
|
37
|
+
export declare function referenceAxis(entry: Record<string, unknown>): AnnotationAxis | null;
|
|
38
|
+
/**
|
|
39
|
+
Where a reference line runs: its axis, its pixel position `at` along that
|
|
40
|
+
axis, and its two end points across the plot (start first). Null when it
|
|
41
|
+
has no position or falls outside the plot area.
|
|
42
|
+
@param frame The plot area and its axes.
|
|
43
|
+
@param entry The reference line.
|
|
44
|
+
*/
|
|
45
|
+
export declare function referenceLinePoints(frame: AnnotationFrame, entry: Record<string, unknown>): {
|
|
46
|
+
axis: AnnotationAxis;
|
|
47
|
+
at: number;
|
|
48
|
+
points: [number, number][];
|
|
49
|
+
} | null;
|
|
50
|
+
/**
|
|
51
|
+
The rect a reference band shades, clipped to the plot area, and its
|
|
52
|
+
axis. Null when it has no position or lies wholly outside the plot.
|
|
53
|
+
@param frame The plot area and its axes.
|
|
54
|
+
@param entry The reference band.
|
|
55
|
+
*/
|
|
56
|
+
export declare function referenceBandRect(frame: AnnotationFrame, entry: Record<string, unknown>): {
|
|
57
|
+
axis: AnnotationAxis;
|
|
58
|
+
box: Box;
|
|
59
|
+
} | null;
|
|
60
|
+
/**
|
|
61
|
+
Where a reference line's label goes (the top-left of its text block, and
|
|
62
|
+
its alignment): beside the line's `"end"` (the right of a horizontal line,
|
|
63
|
+
the top of a vertical one) or `"start"`, above a horizontal line (below
|
|
64
|
+
it near the plot's top) and right of a vertical one (left of it near the
|
|
65
|
+
plot's right edge).
|
|
66
|
+
@param frame The plot area and its axes.
|
|
67
|
+
@param line The line's axis and pixel position.
|
|
68
|
+
@param block The wrapped label.
|
|
69
|
+
@param position Which end of the line.
|
|
70
|
+
*/
|
|
71
|
+
export declare function referenceLineLabelAt(frame: AnnotationFrame, line: {
|
|
72
|
+
axis: AnnotationAxis;
|
|
73
|
+
at: number;
|
|
74
|
+
}, block: TextBlock, position?: "start" | "end"): {
|
|
75
|
+
x: number;
|
|
76
|
+
y: number;
|
|
77
|
+
align: TextAlign;
|
|
78
|
+
};
|
|
79
|
+
/**
|
|
80
|
+
Where a reference band's label goes: inside its top-left corner
|
|
81
|
+
(`"start"`) or top-right (`"end"`).
|
|
82
|
+
@param box The band's rect.
|
|
83
|
+
@param position Which corner.
|
|
84
|
+
*/
|
|
85
|
+
export declare function referenceBandLabelAt(box: Box, position?: "start" | "end"): {
|
|
86
|
+
x: number;
|
|
87
|
+
y: number;
|
|
88
|
+
align: TextAlign;
|
|
89
|
+
};
|
|
90
|
+
/**
|
|
91
|
+
Every spot a reference line's label may take, the one
|
|
92
|
+
`referenceLineLabelAt` picks first: then the other side of the line, then
|
|
93
|
+
the line's other end on either side, then along the line from the
|
|
94
|
+
preferred end on either side.
|
|
95
|
+
@param frame The plot area and its axes.
|
|
96
|
+
@param line The line's axis and pixel position.
|
|
97
|
+
@param block The wrapped label.
|
|
98
|
+
@param position Which end of the line is preferred.
|
|
99
|
+
*/
|
|
100
|
+
export declare function referenceLineLabelSpots(frame: AnnotationFrame, line: {
|
|
101
|
+
axis: AnnotationAxis;
|
|
102
|
+
at: number;
|
|
103
|
+
}, block: TextBlock, position?: "start" | "end"): LabelSpot[];
|
|
104
|
+
/**
|
|
105
|
+
Every spot a reference band's label may take, inside the band: the
|
|
106
|
+
corner `referenceBandLabelAt` picks first, then the other top corner,
|
|
107
|
+
then the bottom corners, then along the band's length from its top (or,
|
|
108
|
+
across the plot, from its preferred side).
|
|
109
|
+
@param box The band's rect.
|
|
110
|
+
@param axis The band's axis.
|
|
111
|
+
@param block The wrapped label.
|
|
112
|
+
@param position Which top corner is preferred.
|
|
113
|
+
*/
|
|
114
|
+
export declare function referenceBandLabelSpots(box: Box, axis: AnnotationAxis, block: TextBlock, position?: "start" | "end"): LabelSpot[];
|
|
115
|
+
/**
|
|
116
|
+
The scene nodes of a reference line: the line and its label.
|
|
117
|
+
@param viz The chart.
|
|
118
|
+
@param annotation The `"ReferenceLine"` annotation.
|
|
119
|
+
@param frame The plot area and its axes.
|
|
120
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
121
|
+
*/
|
|
122
|
+
export declare function referenceLineNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, key: string): SceneNode[];
|
|
123
|
+
/**
|
|
124
|
+
The scene nodes of a reference band: the shaded rect and its label.
|
|
125
|
+
@param viz The chart.
|
|
126
|
+
@param annotation The `"ReferenceBand"` annotation.
|
|
127
|
+
@param frame The plot area and its axes.
|
|
128
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
129
|
+
*/
|
|
130
|
+
export declare function referenceBandNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, key: string): SceneNode[];
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Where reference line and band labels go once the data is drawn: each
|
|
3
|
+
label has a list of spots, its preferred one first, and takes the first
|
|
4
|
+
whose box is clear of the data labels and of the reference labels placed
|
|
5
|
+
before it, inside the plot. A label with no clear spot is hidden.
|
|
6
|
+
*/
|
|
7
|
+
import type { SceneNode } from "@d3plus/render";
|
|
8
|
+
import type { PlotRect } from "./annotationFrame.js";
|
|
9
|
+
import type { TextAlign, TextBlock } from "./annotationText.js";
|
|
10
|
+
import type { Box } from "./calloutLayout.js";
|
|
11
|
+
/** A spot a label may take: its text block's top at `y`, lined up against `x` by `align`. */
|
|
12
|
+
export interface LabelSpot {
|
|
13
|
+
x: number;
|
|
14
|
+
y: number;
|
|
15
|
+
align: TextAlign;
|
|
16
|
+
}
|
|
17
|
+
/** Gap between a reference label and its line or band edge, in pixels. */
|
|
18
|
+
export declare const LABEL_PAD = 4;
|
|
19
|
+
/**
|
|
20
|
+
Records the spots a reference label node may move to (its preferred spot
|
|
21
|
+
first, where it is drawn), for `placeReferenceLabels`.
|
|
22
|
+
@param node The label's text node.
|
|
23
|
+
@param block The wrapped label.
|
|
24
|
+
@param spots Its spots, preferred first.
|
|
25
|
+
*/
|
|
26
|
+
export declare function registerLabelSpots(node: SceneNode, block: TextBlock, spots: LabelSpot[]): void;
|
|
27
|
+
/**
|
|
28
|
+
The box a label's block covers at a spot.
|
|
29
|
+
@param spot The spot.
|
|
30
|
+
@param block The wrapped label.
|
|
31
|
+
*/
|
|
32
|
+
export declare function labelSpotBox(spot: LabelSpot, block: TextBlock): Box;
|
|
33
|
+
/**
|
|
34
|
+
The first of `spots` whose box is clear of every obstacle and inside the
|
|
35
|
+
plot (the first spot, the preferred one, need only be clear), or null
|
|
36
|
+
when none is.
|
|
37
|
+
@param spots The spots, preferred first.
|
|
38
|
+
@param block The wrapped label.
|
|
39
|
+
@param obstacles The boxes to stay clear of.
|
|
40
|
+
@param plot The plot area.
|
|
41
|
+
*/
|
|
42
|
+
export declare function pickLabelSpot(spots: LabelSpot[], block: TextBlock, obstacles: Box[], plot: PlotRect): LabelSpot | null;
|
|
43
|
+
/**
|
|
44
|
+
Positions from `from` toward `to`, `SLIDE_STEP` apart, both ends included.
|
|
45
|
+
@param from The first position.
|
|
46
|
+
@param to The last.
|
|
47
|
+
*/
|
|
48
|
+
export declare function slideSteps(from: number, to: number): number[];
|
|
49
|
+
/**
|
|
50
|
+
Moves each registered reference label among `nodes` to its first clear
|
|
51
|
+
spot (see `pickLabelSpot`), in order, each placed label joining the
|
|
52
|
+
obstacles of the ones after it, and drops a label with no clear spot.
|
|
53
|
+
Returns the nodes with the labels moved; unregistered nodes pass through.
|
|
54
|
+
@param nodes Scene nodes holding reference labels, at any depth.
|
|
55
|
+
@param obstacles The boxes to keep clear of, such as the data labels'.
|
|
56
|
+
@param plot The plot area.
|
|
57
|
+
*/
|
|
58
|
+
export declare function placeReferenceLabels(nodes: SceneNode[], obstacles: Box[], plot: PlotRect): SceneNode[];
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene nodes for curved ring labels (see `ringLabels.ts`): text along
|
|
3
|
+
each label's arc in a color that reads on what lies under it, carrying
|
|
4
|
+
its segment's datum so it dims with it, inert, and fading rather than
|
|
5
|
+
gliding when a redraw moves it.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { FadeSwap, SceneNode, TextNode } from "@d3plus/render";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { LinkLabelBox } from "./linkLabelGeometry.js";
|
|
11
|
+
import type { RingLabelFit } from "./ringLabels.js";
|
|
12
|
+
/**
|
|
13
|
+
How a curved label fades through a redraw that moves it: out over the
|
|
14
|
+
first 6% of the eased progress, back in over the last 6%, so it never
|
|
15
|
+
slides along the ring while its segment's arc tweens.
|
|
16
|
+
*/
|
|
17
|
+
export declare const RING_LABEL_FADE: FadeSwap;
|
|
18
|
+
/** One curved label. */
|
|
19
|
+
export interface RingLabel {
|
|
20
|
+
/** Its scene key. */
|
|
21
|
+
key: string;
|
|
22
|
+
text: string;
|
|
23
|
+
/** Where it goes (see `ringLabelFit`). */
|
|
24
|
+
fit: Pick<RingLabelFit, "d" | "fontSize">;
|
|
25
|
+
/** Its text color. */
|
|
26
|
+
color: string;
|
|
27
|
+
/** The segment's datum, so hover dims them together. */
|
|
28
|
+
datum?: DataPoint;
|
|
29
|
+
/** The segment's index. */
|
|
30
|
+
index?: number;
|
|
31
|
+
}
|
|
32
|
+
/** The plain-value font keys a label config may set. */
|
|
33
|
+
export interface RingLabelFont {
|
|
34
|
+
fontFamily?: string | string[];
|
|
35
|
+
fontWeight?: number | string;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
The label font a shape's labelConfig sets, as plain values (accessors
|
|
39
|
+
are left to the defaults).
|
|
40
|
+
@param config The labelConfig.
|
|
41
|
+
*/
|
|
42
|
+
export declare function ringLabelFont(config: Record<string, unknown>): RingLabelFont;
|
|
43
|
+
/**
|
|
44
|
+
A text's one-line width in a ring label font, by font size.
|
|
45
|
+
@param text The text.
|
|
46
|
+
@param font The label font.
|
|
47
|
+
*/
|
|
48
|
+
export declare function ringTextWidth(text: string, font: RingLabelFont): (fontSize: number) => number;
|
|
49
|
+
/**
|
|
50
|
+
The text nodes for curved labels: one per label that keeps some text
|
|
51
|
+
after it is cut to its path, each in its own font size and color.
|
|
52
|
+
@param viz The chart, for its locale.
|
|
53
|
+
@param labels The labels.
|
|
54
|
+
@param font The label font.
|
|
55
|
+
*/
|
|
56
|
+
export declare function ringLabelNodes(viz: VizInstance, labels: RingLabel[], font?: RingLabelFont): TextNode[];
|
|
57
|
+
/**
|
|
58
|
+
The labels that stay clear of each other and of `obstacles`, earlier
|
|
59
|
+
labels winning.
|
|
60
|
+
@param nodes The label nodes, in priority order.
|
|
61
|
+
@param obstacles Boxes they must stay clear of, such as other labels.
|
|
62
|
+
*/
|
|
63
|
+
export declare function clearRingLabels<T extends SceneNode>(nodes: T[], obstacles?: LinkLabelBox[]): T[];
|