@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
|
@@ -3,7 +3,8 @@ import type { FeatureModule } from "./features.js";
|
|
|
3
3
|
import type Legend from "../../components/Legend/Legend.js";
|
|
4
4
|
import type { VizInstance } from "../viz/vizTypes.js";
|
|
5
5
|
import type { InsetOrient } from "./insetState.js";
|
|
6
|
-
|
|
6
|
+
/** The legend's rolled-up entries, with the key and paint accessors its render reuses. */
|
|
7
|
+
export interface LegendData {
|
|
7
8
|
legendData: DataPoint[];
|
|
8
9
|
legendKey: (d: DataPoint, i: number) => string;
|
|
9
10
|
getAttr: (d: DataPoint, i: number, attr: string) => string;
|
|
@@ -13,7 +14,8 @@ interface LegendData {
|
|
|
13
14
|
`viz._legendDepth` (the lowest groupBy level whose values are unique) and
|
|
14
15
|
`viz._legendCategories` (see `legendCategory.ts`), then sorts it.
|
|
15
16
|
Returns the `legendData` array plus the `fill`/`getAttr` accessors the
|
|
16
|
-
render step reuses.
|
|
17
|
+
render step reuses. A legend set to a constant false (`legend(false)`)
|
|
18
|
+
gets no entries, and its depth and categories stay as they were.
|
|
17
19
|
*/
|
|
18
20
|
export declare function buildLegendData(viz: VizInstance): LegendData;
|
|
19
21
|
/**
|
|
@@ -47,4 +49,3 @@ export declare function paintLegendInset(viz: VizInstance, orient: InsetOrient,
|
|
|
47
49
|
scene composition for Legend happens via Viz.toScene's `components` array.
|
|
48
50
|
*/
|
|
49
51
|
export declare const legendFeature: FeatureModule;
|
|
50
|
-
export {};
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
How the legend groups rows into entries: by the color each row encodes,
|
|
3
|
+
its opacity and its texture.
|
|
4
|
+
*/
|
|
5
|
+
import type { DataPoint } from "@d3plus/data";
|
|
6
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
7
|
+
/** The functions that read a row's legend paint and key. */
|
|
8
|
+
export interface LegendKeys {
|
|
9
|
+
/** A paint attribute (`fill`, `opacity`, …) from the row's shapeConfig; a Line's fill is its stroke. */
|
|
10
|
+
getAttr: (d: DataPoint, i: number, attr: string) => string;
|
|
11
|
+
/** The row's color encoding input, or undefined without a color accessor. */
|
|
12
|
+
colorOf: (d: DataPoint, i: number) => unknown;
|
|
13
|
+
/** The row's entry key, given its color encoding. */
|
|
14
|
+
keyOf: (d: DataPoint, i: number, c: unknown) => string;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
The legend's key functions for a chart.
|
|
18
|
+
@param viz The chart.
|
|
19
|
+
*/
|
|
20
|
+
export declare function legendKeys(viz: VizInstance): LegendKeys;
|
|
21
|
+
/**
|
|
22
|
+
The rows the legend rolls up: `_legendData`, less the rows a colorScale
|
|
23
|
+
colors.
|
|
24
|
+
@param viz The chart.
|
|
25
|
+
*/
|
|
26
|
+
export declare function legendRows(viz: VizInstance): DataPoint[];
|
|
27
|
+
/**
|
|
28
|
+
How many entries the legend has (the number `buildLegendData` rolls its
|
|
29
|
+
rows into), counting no further than `limit + 1`: enough to tell whether
|
|
30
|
+
there are more than `limit`. A legend set to a constant false has none.
|
|
31
|
+
@param viz The chart.
|
|
32
|
+
@param limit The count past which to stop.
|
|
33
|
+
*/
|
|
34
|
+
export declare function legendEntryCount(viz: VizInstance, limit?: number): number;
|
|
@@ -2,16 +2,19 @@
|
|
|
2
2
|
Line-label collision resolution + connector emit for the Plot paint phase.
|
|
3
3
|
|
|
4
4
|
Plot's `lineLabels` feature draws a label at the end of each series line.
|
|
5
|
-
When several series end at nearby y positions the labels overlap,
|
|
6
|
-
are
|
|
7
|
-
links each
|
|
5
|
+
When several series end at nearby y positions the labels would overlap,
|
|
6
|
+
so they are spread apart until none do; a thin connector line then
|
|
7
|
+
links each moved label back to its true series position.
|
|
8
|
+
|
|
9
|
+
Labels at a line's left end (`lineLabels: "start"` or `"both"`) are
|
|
10
|
+
placed the same way, apart from the right-end labels.
|
|
8
11
|
|
|
9
12
|
The measure half (which series get labels + their widths) lives upstream
|
|
10
13
|
as the `measurePlotLineLabels` pipeline stage. This module owns the two
|
|
11
14
|
remaining pieces:
|
|
12
15
|
|
|
13
|
-
- `bumpLineLabels` — resolve overlaps, returning the id→
|
|
14
|
-
- `emitLineLabelConnectors` — draw the connector lines for
|
|
16
|
+
- `bumpLineLabels` — resolve overlaps, returning the id→moved-y map.
|
|
17
|
+
- `emitLineLabelConnectors` — draw the connector lines for moved labels.
|
|
15
18
|
|
|
16
19
|
This is Plot-family-specific (it depends on Line series + the rendered
|
|
17
20
|
y-axis position function), not a generic cross-viz feature.
|
|
@@ -22,18 +25,18 @@ import type { SceneNode } from "@d3plus/render";
|
|
|
22
25
|
import type { LabelWidth } from "./plotPaint.js";
|
|
23
26
|
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
24
27
|
/**
|
|
25
|
-
Resolve label overlaps within each x-group
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
connector emit read. Must run AFTER the production y-axis has rendered
|
|
30
|
-
|
|
28
|
+
Resolve label overlaps within each x-group, each end of the lines on its
|
|
29
|
+
own: labels are spread apart until none overlap (see `spreadGroup`).
|
|
30
|
+
Mutates each `LabelWidth`'s `newY`/`defaultY` in place and returns the
|
|
31
|
+
moved-y map, keyed by `lineLabelKey`, that the Line emitter and
|
|
32
|
+
connector emit read. Must run AFTER the production y-axis has rendered:
|
|
33
|
+
it reads `viz._yAxis._getPosition`.
|
|
31
34
|
*/
|
|
32
35
|
export declare function bumpLineLabels(viz: Viz, labelWidths: LabelWidth[], yRange: number[]): Record<string, number>;
|
|
33
36
|
/**
|
|
34
37
|
Emit the connector lines for labels that were bumped (`newY` set). Each
|
|
35
38
|
connector runs from the label's true series position to its bumped
|
|
36
|
-
position. Returns the compute-mode scene nodes (empty when nothing was
|
|
39
|
+
position, rightward for a right-end label and leftward for a left-end one. Returns the compute-mode scene nodes (empty when nothing was
|
|
37
40
|
bumped). Coords are relative to `_chartTransform`, which the chart-cells
|
|
38
41
|
group applies.
|
|
39
42
|
*/
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkBundle` for a chart's links: bundles their straight runs (see
|
|
3
|
+
`bundleEdges`) with the chart's `linkBundleConfig`, through a cache kept
|
|
4
|
+
on the chart, so a redraw with the links where they were reuses the
|
|
5
|
+
last bundling.
|
|
6
|
+
*/
|
|
7
|
+
import type { EdgeBundleCache, Segment } from "./edgeBundling.js";
|
|
8
|
+
import type { Point } from "./polyline.js";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
/** The chart's bundling cache, created on first use. */
|
|
11
|
+
export declare function linkBundleCache(viz: VizInstance): EdgeBundleCache;
|
|
12
|
+
/**
|
|
13
|
+
Each edge's bundled path, from its source to its target, with the
|
|
14
|
+
chart's `linkBundleConfig`.
|
|
15
|
+
*/
|
|
16
|
+
export declare function bundleLinkPaths(viz: VizInstance, edges: readonly Segment[]): Point[][];
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkColor` on the node-link charts (Network, Rings, Sankey, ArcDiagram):
|
|
3
|
+
each link's stroke, from one of its end nodes or from a value on the
|
|
4
|
+
link. Arrowheads take their link's stroke.
|
|
5
|
+
*/
|
|
6
|
+
import type { DataPoint } from "@d3plus/data";
|
|
7
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
8
|
+
/** How links are colored: theme gray, an end node's color, or a value on each link. */
|
|
9
|
+
export type LinkColorSetting = false | "source" | "target" | ((d: DataPoint, i: number) => unknown);
|
|
10
|
+
/** A drawn link's end node, as a layout hands it to its emitter. */
|
|
11
|
+
export interface DrawnLinkEnd {
|
|
12
|
+
/** The node's shape kind (`"Circle"` when it has none). */
|
|
13
|
+
shape?: unknown;
|
|
14
|
+
}
|
|
15
|
+
/** A drawn link: its two end nodes. */
|
|
16
|
+
export interface LinkEnds {
|
|
17
|
+
source?: DrawnLinkEnd;
|
|
18
|
+
target?: DrawnLinkEnd;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
Stores a `linkColor` value: `"source"` and `"target"` as given, a falsy
|
|
22
|
+
value as `false`, a function as given, and any other string as a key
|
|
23
|
+
read from each link.
|
|
24
|
+
*/
|
|
25
|
+
export declare function coerceLinkColor(value: unknown): unknown;
|
|
26
|
+
/**
|
|
27
|
+
The datum a drawn link carries (see `makeLinkDatum`), or the link itself
|
|
28
|
+
when it has none, and the link's index in `links` (else `i`).
|
|
29
|
+
*/
|
|
30
|
+
export declare function linkRow(link: object, i: number): {
|
|
31
|
+
row: DataPoint;
|
|
32
|
+
index: number;
|
|
33
|
+
};
|
|
34
|
+
/**
|
|
35
|
+
The color a link's value gives it: a number through the chart's
|
|
36
|
+
colorScale, a string as a literal color when it parses as one or as a
|
|
37
|
+
category in the chart's categorical palette (the way `color` colors
|
|
38
|
+
nodes), and nothing for any other value.
|
|
39
|
+
*/
|
|
40
|
+
export declare function linkValueColor(viz: VizInstance, value: unknown): string | undefined;
|
|
41
|
+
/**
|
|
42
|
+
Builds the chart's link stroke resolver for one draw: given a link's
|
|
43
|
+
datum (and its drawn ends, for their shape kinds), the stroke
|
|
44
|
+
`linkColor` gives it, or undefined to keep the link's
|
|
45
|
+
`shapeConfig.Path` stroke. Links colored by number are noted for the
|
|
46
|
+
colorScale.
|
|
47
|
+
*/
|
|
48
|
+
export declare function linkColorResolver(viz: VizInstance): (datum: DataPoint, drawn?: LinkEnds) => string | undefined;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The link color and label config the node-link charts (Network, Rings,
|
|
3
|
+
Sankey, ArcDiagram) share, and the widest-link and link bundling fields
|
|
4
|
+
Network and Geomap share.
|
|
5
|
+
*/
|
|
6
|
+
import type { ConfigField } from "../../fluent.js";
|
|
7
|
+
/** The `linkColor`, `linkLabel`, and `linkLabelConfig` fields. */
|
|
8
|
+
export declare function linkStyleFields(): ConfigField[];
|
|
9
|
+
/**
|
|
10
|
+
The `linkSizeMax` field: the widest link, in pixels, when `linkSize`
|
|
11
|
+
values differ. `fallback` is the chart's default; without one the
|
|
12
|
+
chart works the width out (see `linkWidthRange`).
|
|
13
|
+
*/
|
|
14
|
+
export declare function linkSizeMaxField(fallback?: number): ConfigField;
|
|
15
|
+
/** The `linkBundle` and `linkBundleConfig` fields (Network and Geomap). */
|
|
16
|
+
export declare function linkBundleFields(): ConfigField[];
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Click focus for links on the node-link charts (Network, Rings, Sankey).
|
|
3
|
+
Clicking a link (or pressing Enter on it) keeps it and its two ends
|
|
4
|
+
bright and dims the rest, and a chart that zooms zooms to fit the two
|
|
5
|
+
ends. Clicking the focused link again, or the chart's background, clears
|
|
6
|
+
the focus.
|
|
7
|
+
*/
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { LinkDatum } from "./linkInteraction.js";
|
|
11
|
+
type NodeKey = (d: DataPoint, i: number) => string;
|
|
12
|
+
/** A box as `[[x0, y0], [x1, y1]]`. */
|
|
13
|
+
export type FocusBox = [[number, number], [number, number]];
|
|
14
|
+
/** The id a focused link sets on `viz._focus`. */
|
|
15
|
+
export declare function linkFocusId(d: LinkDatum): string;
|
|
16
|
+
/**
|
|
17
|
+
The box around a link's two ends, from the chart's laid-out nodes
|
|
18
|
+
(`viz.ctx.nodeLookup` records with `x`, `y`, and `r`), or null when they
|
|
19
|
+
aren't laid out that way.
|
|
20
|
+
*/
|
|
21
|
+
export declare function linkEndsBox(viz: VizInstance, d: LinkDatum): FocusBox | null;
|
|
22
|
+
/**
|
|
23
|
+
Clears a click focus: the active marks, and the zoom where the chart
|
|
24
|
+
zooms. Returns whether there was a focus to clear.
|
|
25
|
+
*/
|
|
26
|
+
export declare function clearLinkFocus(viz: VizInstance): boolean;
|
|
27
|
+
/**
|
|
28
|
+
Routes clicks on the chart's own outer `<svg>` (the empty space around an
|
|
29
|
+
SVG scene, which only takes the pointer over what it paints) to
|
|
30
|
+
`viz._backgroundClick`. Clicks on marks, on the chart's chrome, or on a
|
|
31
|
+
zoom surface's background land on other elements and are left alone; the
|
|
32
|
+
Canvas renderer reports its empty clicks itself.
|
|
33
|
+
*/
|
|
34
|
+
export declare function bindSvgBackgroundClick(viz: VizInstance): void;
|
|
35
|
+
/**
|
|
36
|
+
Focuses a clicked link: it and the nodes at its ends stay bright, the
|
|
37
|
+
rest dims, and a chart that zooms zooms to `box`. Clicking the focused
|
|
38
|
+
link again clears the focus. Rows that aren't recorded nodes (legend
|
|
39
|
+
entries) match by `nodeKey`.
|
|
40
|
+
*/
|
|
41
|
+
export declare function focusLink(viz: VizInstance, d: LinkDatum, { nodeKey, box }?: {
|
|
42
|
+
nodeKey?: NodeKey;
|
|
43
|
+
box?: FocusBox | null;
|
|
44
|
+
}): void;
|
|
45
|
+
/**
|
|
46
|
+
Clears the chart's click focus when a click lands on no mark within its
|
|
47
|
+
chart area (`viz._backgroundClick`, given the click's point on the
|
|
48
|
+
chart's surface).
|
|
49
|
+
*/
|
|
50
|
+
export declare function installFocusBackgroundClick(viz: VizInstance): void;
|
|
51
|
+
export {};
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Link interaction shared by the node-link charts (Network, Rings, Sankey,
|
|
3
|
+
ArcDiagram): the datum each link is drawn with, its tooltip and spoken
|
|
4
|
+
label, what hovering a link or a node highlights, and the connections a
|
|
5
|
+
node's tooltip lists.
|
|
6
|
+
|
|
7
|
+
A link's datum is its row from `links`, with `source` and `target`
|
|
8
|
+
replaced by the data of the nodes they name. `linkSize`, `value`,
|
|
9
|
+
`shapeConfig` functions, arrow accessors, and the tooltip all receive it,
|
|
10
|
+
so they read node fields directly (`d.source.name`). The chart's
|
|
11
|
+
bookkeeping for each datum (its index in `links`, the ids of its ends, its
|
|
12
|
+
value) is kept beside it in a WeakMap, so the datum holds only the link's
|
|
13
|
+
own fields.
|
|
14
|
+
*/
|
|
15
|
+
import type { DataPoint } from "@d3plus/data";
|
|
16
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
17
|
+
/**
|
|
18
|
+
A link as accessors and tooltips receive it: the link's own fields, with
|
|
19
|
+
`source` and `target` set to the data of the nodes at its ends.
|
|
20
|
+
*/
|
|
21
|
+
export type LinkDatum = DataPoint & {
|
|
22
|
+
source: DataPoint;
|
|
23
|
+
target: DataPoint;
|
|
24
|
+
};
|
|
25
|
+
/** One end of a link: the node's datum, its index, and its id. */
|
|
26
|
+
export interface LinkEnd {
|
|
27
|
+
data: DataPoint;
|
|
28
|
+
i: number;
|
|
29
|
+
id: string;
|
|
30
|
+
/** The end's name, for an end with no row of its own to label it (a bare coordinate). */
|
|
31
|
+
label?: string;
|
|
32
|
+
}
|
|
33
|
+
/** The links of a chart, and each node's links by node id. */
|
|
34
|
+
export interface LinkGraph {
|
|
35
|
+
links: LinkDatum[];
|
|
36
|
+
/** Whether the links' values differ, so tooltips and labels report them. */
|
|
37
|
+
sized: boolean;
|
|
38
|
+
byNode: Map<string, LinkDatum[]>;
|
|
39
|
+
}
|
|
40
|
+
/** What the chart knows about a link datum. */
|
|
41
|
+
export interface LinkMeta {
|
|
42
|
+
/** The link's index in `links`. */
|
|
43
|
+
index: number;
|
|
44
|
+
/** The link's row in `links`. */
|
|
45
|
+
raw: DataPoint;
|
|
46
|
+
source: LinkEnd;
|
|
47
|
+
target: LinkEnd;
|
|
48
|
+
/** The keys of `raw` that name its ends. */
|
|
49
|
+
endKeys: string[];
|
|
50
|
+
/** The link's value (`linkSize` or `value`), when it is a number. */
|
|
51
|
+
value?: number;
|
|
52
|
+
graph?: LinkGraph;
|
|
53
|
+
}
|
|
54
|
+
type Predicate = (d: DataPoint, i: number) => boolean;
|
|
55
|
+
type NodeKey = (d: DataPoint, i: number) => string;
|
|
56
|
+
type Row = [string, string];
|
|
57
|
+
/** What the chart recorded for a link datum, if `d` is one. */
|
|
58
|
+
export declare function linkMeta(d: unknown): LinkMeta | undefined;
|
|
59
|
+
/** Whether `d` is a link datum. */
|
|
60
|
+
export declare function isLinkDatum(d: unknown): d is LinkDatum;
|
|
61
|
+
/**
|
|
62
|
+
The datum a link is drawn with: `raw`'s fields, with `source` and
|
|
63
|
+
`target` set to the data of the nodes at its ends.
|
|
64
|
+
@param raw The link's row in `links`.
|
|
65
|
+
@param source The node at its source end.
|
|
66
|
+
@param target The node at its target end.
|
|
67
|
+
@param index The link's index in `links`.
|
|
68
|
+
@param endKeys The keys of `raw` that name its ends.
|
|
69
|
+
*/
|
|
70
|
+
export declare function makeLinkDatum(raw: DataPoint, source: LinkEnd, target: LinkEnd, index: number, endKeys?: string[]): LinkDatum;
|
|
71
|
+
/**
|
|
72
|
+
Records a link's value (from `linkSize` or `value`) for its tooltip and
|
|
73
|
+
spoken label, and returns it.
|
|
74
|
+
*/
|
|
75
|
+
export declare function setLinkValue<T>(d: LinkDatum, value: T): T;
|
|
76
|
+
/**
|
|
77
|
+
Indexes a chart's links by node and stores the result on `viz.ctx.linkGraph`.
|
|
78
|
+
Each of `nodes` (including any without links) is recognized by its datum
|
|
79
|
+
from then on, so its tooltip can list its connections.
|
|
80
|
+
*/
|
|
81
|
+
export declare function publishLinkGraph(viz: VizInstance, links: LinkDatum[], nodes: LinkEnd[]): LinkGraph;
|
|
82
|
+
/**
|
|
83
|
+
Forgets every node `publishLinkGraph` recorded for a chart, so rows that
|
|
84
|
+
no longer end a link stop reading as nodes.
|
|
85
|
+
*/
|
|
86
|
+
export declare function forgetLinkNodes(viz: VizInstance): void;
|
|
87
|
+
/** The node id and graph recorded for a node datum, if `d` is one. */
|
|
88
|
+
export declare function linkNodeOf(viz: VizInstance, d: unknown): {
|
|
89
|
+
id: string;
|
|
90
|
+
graph: LinkGraph;
|
|
91
|
+
} | undefined;
|
|
92
|
+
/** Whether a locale code (`"ar-SA"`) names a language written right to left. */
|
|
93
|
+
export declare function rtlLocale(locale: unknown): boolean;
|
|
94
|
+
/**
|
|
95
|
+
The arrows a chart's tooltips point from a link's source to its target
|
|
96
|
+
with: `["→", "←"]`, mirrored to `["←", "→"]` when the chart's locale is
|
|
97
|
+
written right to left or the page's direction is (see `rtl`).
|
|
98
|
+
*/
|
|
99
|
+
export declare function linkArrows(viz: VizInstance): [string, string];
|
|
100
|
+
/** A link end's label, as its node's tooltip titles it. */
|
|
101
|
+
export declare function linkEndLabel(viz: VizInstance, end: LinkEnd): string;
|
|
102
|
+
/** A link's tooltip title: "Source → Target" ("Source ← Target" right to left). */
|
|
103
|
+
export declare function linkTooltipTitle(viz: VizInstance, d: LinkDatum): string;
|
|
104
|
+
/** A tooltip cell's text for one field value, or null for a value it skips. */
|
|
105
|
+
export declare function linkCellText(viz: VizInstance, v: unknown): string | null;
|
|
106
|
+
/**
|
|
107
|
+
A link's tooltip rows: its value (when the chart's links differ in value
|
|
108
|
+
and no field of the link already shows it), then each of the link's own
|
|
109
|
+
fields other than the ones naming its ends.
|
|
110
|
+
*/
|
|
111
|
+
export declare function linkTooltipRows(viz: VizInstance, d: LinkDatum): Row[];
|
|
112
|
+
/**
|
|
113
|
+
A link's spoken label: "Source to Target." When the chart's links differ
|
|
114
|
+
in value, its value follows: "Source to Target, 4."
|
|
115
|
+
*/
|
|
116
|
+
export declare function linkAriaLabel(viz: VizInstance, d: LinkDatum): string;
|
|
117
|
+
/**
|
|
118
|
+
What hovering a link highlights: the link and the nodes at its two ends.
|
|
119
|
+
Rows that aren't recorded nodes (legend entries) match by `nodeKey`.
|
|
120
|
+
*/
|
|
121
|
+
export declare function linkHighlight(viz: VizInstance, d: LinkDatum, nodeKey?: NodeKey): Predicate;
|
|
122
|
+
/**
|
|
123
|
+
A node's links in `graph`, the other end of each, and its direction,
|
|
124
|
+
strongest first. A link from the node to itself is `loop`, with the node
|
|
125
|
+
as its other end.
|
|
126
|
+
*/
|
|
127
|
+
export declare function nodeConnections(graph: LinkGraph, id: string): {
|
|
128
|
+
link: LinkDatum;
|
|
129
|
+
other: LinkEnd;
|
|
130
|
+
outgoing: boolean;
|
|
131
|
+
loop: boolean;
|
|
132
|
+
value?: number;
|
|
133
|
+
}[];
|
|
134
|
+
/**
|
|
135
|
+
What hovering a node highlights: the node, the nodes it links to, and the
|
|
136
|
+
links between them. Null when `d` isn't a recorded node. Rows that aren't
|
|
137
|
+
recorded nodes (legend entries) match by `nodeKey`.
|
|
138
|
+
*/
|
|
139
|
+
export declare function nodeHighlight(viz: VizInstance, d: DataPoint, nodeKey?: NodeKey): Predicate | null;
|
|
140
|
+
/**
|
|
141
|
+
How many links a node's tooltip lists: `nodeTooltipLinks` when it is a
|
|
142
|
+
number (`true` is 3, `false` none), else 3 when the links differ in value
|
|
143
|
+
and none when they don't.
|
|
144
|
+
*/
|
|
145
|
+
export declare function nodeTooltipLinkLimit(viz: VizInstance, graph: LinkGraph): number;
|
|
146
|
+
/** The arrow a node's tooltip marks a link from the node to itself with. */
|
|
147
|
+
export declare const LOOP_ARROW = "\u21BB";
|
|
148
|
+
/**
|
|
149
|
+
A node's tooltip rows: its number of connections, then its strongest
|
|
150
|
+
links ("→ Target" or "← Source", or "↻ Node" for a link to itself, with
|
|
151
|
+
the link's value when the links differ in value), up to
|
|
152
|
+
`nodeTooltipLinkLimit`. The arrows mirror right to left (see
|
|
153
|
+
`linkArrows`).
|
|
154
|
+
*/
|
|
155
|
+
export declare function nodeConnectionRows(viz: VizInstance, d: DataPoint): Row[];
|
|
156
|
+
/**
|
|
157
|
+
The node-link charts' default `tooltipConfig`: a link is titled
|
|
158
|
+
"Source → Target" and lists its value and fields; a node is titled by its
|
|
159
|
+
label and lists its connections.
|
|
160
|
+
*/
|
|
161
|
+
export declare function linkTooltipConfig(viz: VizInstance): {
|
|
162
|
+
title: (d: DataPoint, i: number) => string;
|
|
163
|
+
tbody: (d: DataPoint, i: number) => Row[];
|
|
164
|
+
};
|
|
165
|
+
/** The smallest stroke width a link's hit path takes, in pixels. */
|
|
166
|
+
export declare const LINK_HIT_WIDTH = 8;
|
|
167
|
+
/**
|
|
168
|
+
A transparent path over a link, wider than it, so thin links are easy to
|
|
169
|
+
point at. Keyboard navigation skips it (its key ends in `::hit`).
|
|
170
|
+
*/
|
|
171
|
+
export declare function linkHitPath(key: string, d: string, datum: LinkDatum, strokeWidth: unknown): {
|
|
172
|
+
type: "path";
|
|
173
|
+
key: string;
|
|
174
|
+
d: string;
|
|
175
|
+
datum: LinkDatum;
|
|
176
|
+
index: number;
|
|
177
|
+
paint: {
|
|
178
|
+
fill: string;
|
|
179
|
+
stroke: string;
|
|
180
|
+
strokeWidth: number;
|
|
181
|
+
};
|
|
182
|
+
};
|
|
183
|
+
export {};
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Unique scene keys for links whose base key names only their ends, so
|
|
3
|
+
parallel links (the same source and target) each get their own.
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
One unique key per base key, in order: the first link with a base keeps
|
|
7
|
+
it, and each later one adds its order among the links sharing that base
|
|
8
|
+
(`-1`, `-2`, …), skipping any key already taken. The same bases give the
|
|
9
|
+
same keys on every call.
|
|
10
|
+
*/
|
|
11
|
+
export declare function uniqueLinkKeys(bases: readonly string[]): string[];
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure geometry for link labels: where on a link its label sits (the
|
|
3
|
+
middle of its length) and which way the link runs there, the angle that
|
|
4
|
+
keeps text upright, and the overlap tests that hide labels which would
|
|
5
|
+
cover each other or a node.
|
|
6
|
+
*/
|
|
7
|
+
import type { CircleLabelBox, LabelCircle } from "./circleLabelPlacement.js";
|
|
8
|
+
/** A point on a link and the direction the link runs there, in radians. */
|
|
9
|
+
export interface LinkAnchor {
|
|
10
|
+
x: number;
|
|
11
|
+
y: number;
|
|
12
|
+
angle: number;
|
|
13
|
+
}
|
|
14
|
+
type Point = [number, number];
|
|
15
|
+
/**
|
|
16
|
+
The middle of a straight link's visible length, between the edges of the
|
|
17
|
+
circles of radius `r0` and `r1` around its ends, and its direction.
|
|
18
|
+
*/
|
|
19
|
+
export declare function segmentMidpoint(a: Point, b: Point, r0?: number, r1?: number): LinkAnchor;
|
|
20
|
+
/** The point at `t` (0–1) along a cubic Bézier curve. */
|
|
21
|
+
export declare function cubicPoint(p0: Point, p1: Point, p2: Point, p3: Point, t: number): Point;
|
|
22
|
+
/** The direction (radians) a cubic Bézier curve runs at `t`. */
|
|
23
|
+
export declare function cubicAngle(p0: Point, p1: Point, p2: Point, p3: Point, t: number): number;
|
|
24
|
+
/**
|
|
25
|
+
The point halfway along a cubic Bézier curve's length (not at `t` = 0.5,
|
|
26
|
+
which bunches toward the tighter end), and its direction there.
|
|
27
|
+
@param steps The number of chords the curve's length is measured in.
|
|
28
|
+
*/
|
|
29
|
+
export declare function cubicMidpoint(p0: Point, p1: Point, p2: Point, p3: Point, steps?: number): LinkAnchor;
|
|
30
|
+
/**
|
|
31
|
+
A direction (radians) as the rotation (degrees) that keeps text running
|
|
32
|
+
along it upright: within -90° (reading bottom to top) and 90°.
|
|
33
|
+
*/
|
|
34
|
+
export declare function uprightAngle(radians: number): number;
|
|
35
|
+
/** A label's box: its center, its size, and its rotation in degrees about its center. */
|
|
36
|
+
export interface LinkLabelBox {
|
|
37
|
+
x: number;
|
|
38
|
+
y: number;
|
|
39
|
+
width: number;
|
|
40
|
+
height: number;
|
|
41
|
+
angle: number;
|
|
42
|
+
}
|
|
43
|
+
/** A label box's four corners, clockwise from its top-left. */
|
|
44
|
+
export declare function labelCorners(box: LinkLabelBox): Point[];
|
|
45
|
+
/** Whether two label boxes overlap. */
|
|
46
|
+
export declare function labelsOverlap(a: LinkLabelBox, b: LinkLabelBox): boolean;
|
|
47
|
+
/** Whether a label box overlaps a circle. */
|
|
48
|
+
export declare function labelHitsCircle(box: LinkLabelBox, circle: LabelCircle): boolean;
|
|
49
|
+
/** Whether a label box overlaps an axis-aligned box (such as a Sankey node). */
|
|
50
|
+
export declare function labelHitsBox(box: LinkLabelBox, rect: CircleLabelBox): boolean;
|
|
51
|
+
/** The nodes (and node labels) link labels must stay clear of. */
|
|
52
|
+
export interface LabelObstacles {
|
|
53
|
+
circles?: LabelCircle[];
|
|
54
|
+
boxes?: CircleLabelBox[];
|
|
55
|
+
/** Other labels' boxes, which may be rotated. */
|
|
56
|
+
labels?: LinkLabelBox[];
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
The labels that fit, in the order given (earlier labels win): each one
|
|
60
|
+
that overlaps no node and no label already kept. A label with `boxes`
|
|
61
|
+
(such as one along a curve) is tested by those, else by its `box`.
|
|
62
|
+
*/
|
|
63
|
+
export declare function placeLinkLabels<T extends {
|
|
64
|
+
box: LinkLabelBox;
|
|
65
|
+
boxes?: readonly LinkLabelBox[];
|
|
66
|
+
}>(labels: readonly T[], obstacles: LabelObstacles): T[];
|
|
67
|
+
export {};
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure geometry for link labels that follow a curved link: the link's
|
|
3
|
+
centerline as points, trimmed to the edges of its nodes; where a label's
|
|
4
|
+
anchor falls along it; the stretch the label covers, kept upright and
|
|
5
|
+
short of tight turns; the path its text follows, which puts the glyphs'
|
|
6
|
+
middles on the centerline; and the stretch its pad covers.
|
|
7
|
+
*/
|
|
8
|
+
import type { Pt } from "./pathLabelGeometry.js";
|
|
9
|
+
/** The most a label's stretch turns, in radians: past this, it is cut short. */
|
|
10
|
+
export declare const LINK_LABEL_MAX_TURN: number;
|
|
11
|
+
/** A stretch that turns less than this (radians) takes a straight label. */
|
|
12
|
+
export declare const LINK_LABEL_STRAIGHT_TURN = 0.03;
|
|
13
|
+
/** The tightest a label's stretch may bend, as a radius in ems: a stretch is cut short of tighter bends. */
|
|
14
|
+
export declare const LINK_LABEL_MIN_RADIUS = 2;
|
|
15
|
+
/**
|
|
16
|
+
A path's `d` as points, its curves flattened.
|
|
17
|
+
@param d The path.
|
|
18
|
+
*/
|
|
19
|
+
export declare function curvePoints(d: string): Pt[];
|
|
20
|
+
/**
|
|
21
|
+
The part of a polyline outside circles of radius `r0` around its first
|
|
22
|
+
point and `r1` around its last: a link's run between the edges of its
|
|
23
|
+
nodes. Empty when the circles cover it.
|
|
24
|
+
@param points The polyline.
|
|
25
|
+
@param r0 The radius around its first point.
|
|
26
|
+
@param r1 The radius around its last point.
|
|
27
|
+
*/
|
|
28
|
+
export declare function trimToNodes(points: Pt[], r0?: number, r1?: number): Pt[];
|
|
29
|
+
/**
|
|
30
|
+
How far along a polyline its point nearest `p` lies.
|
|
31
|
+
@param points The polyline.
|
|
32
|
+
@param p The point.
|
|
33
|
+
*/
|
|
34
|
+
export declare function distanceAlong(points: Pt[], p: Pt): number;
|
|
35
|
+
/**
|
|
36
|
+
The most a polyline turns along any `span` pixels of it, in radians: a
|
|
37
|
+
circle of radius `r` turns `span / r`.
|
|
38
|
+
@param points The polyline.
|
|
39
|
+
@param span The length of the stretches measured.
|
|
40
|
+
*/
|
|
41
|
+
export declare function sharpestTurn(points: Pt[], span: number): number;
|
|
42
|
+
/**
|
|
43
|
+
The stretch of a polyline a label covers: `length` pixels long (or the
|
|
44
|
+
whole polyline when it is shorter), centered `at` pixels along it as
|
|
45
|
+
near as its ends allow, and shortened until it turns no more than
|
|
46
|
+
`maxTurn` in all, and bends no tighter than a circle of `minRadius`.
|
|
47
|
+
Upright: it runs left to right, or bottom to top when it runs straight
|
|
48
|
+
up or down (see `uprightPoints`).
|
|
49
|
+
@param points The polyline.
|
|
50
|
+
@param at Where the stretch's middle goes, along the polyline.
|
|
51
|
+
@param length The stretch's length.
|
|
52
|
+
@param maxTurn The most the stretch may turn, in radians.
|
|
53
|
+
@param minRadius The tightest bend the stretch may hold, in pixels.
|
|
54
|
+
*/
|
|
55
|
+
export declare function labelStretch(points: Pt[], at: number, length: number, maxTurn?: number, minRadius?: number): Pt[];
|
|
56
|
+
/** Where a curved label goes: its centerline stretch and the points its text follows. */
|
|
57
|
+
export interface CurvedLabelSpot {
|
|
58
|
+
/** The centerline stretch the label covers, pad included, upright. */
|
|
59
|
+
stretch: Pt[];
|
|
60
|
+
/** The path its text follows: the stretch less the pad at each end, its baseline dropped so the glyphs' middles sit on the centerline. */
|
|
61
|
+
text: Pt[];
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
Where a label follows a curved link, or null when the stretch it would
|
|
65
|
+
cover runs straight (a straight label reads the same there) or the link
|
|
66
|
+
bends too tightly around the label's spot for a few letters to follow
|
|
67
|
+
it (a small self-loop).
|
|
68
|
+
@param path The link's centerline.
|
|
69
|
+
@param at Where the label's middle goes, along the centerline.
|
|
70
|
+
@param textWidth The text's width.
|
|
71
|
+
@param fontSize The font size.
|
|
72
|
+
@param pad The pad around the text.
|
|
73
|
+
@param minRadius The tightest bend the label follows, in ems.
|
|
74
|
+
*/
|
|
75
|
+
export declare function curvedLabelSpot(path: Pt[], at: number, textWidth: number, fontSize: number, pad: number, minRadius?: number): CurvedLabelSpot | null;
|
|
76
|
+
/**
|
|
77
|
+
The centerline stretch a curved label's pad covers: its text, centered
|
|
78
|
+
on the stretch, and `pad` past each end. The text's width along its
|
|
79
|
+
baseline is scaled to the centerline, which runs longer outside a bend
|
|
80
|
+
and shorter inside one.
|
|
81
|
+
@param spot The label's spot.
|
|
82
|
+
@param textWidth The width of the text drawn.
|
|
83
|
+
@param pad The pad around the text.
|
|
84
|
+
*/
|
|
85
|
+
export declare function curvedLabelPad(spot: CurvedLabelSpot, textWidth: number, pad: number): Pt[];
|