@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,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene of a callout annotation: per row, a connector from the box to
|
|
3
|
+
the anchor, an arrowhead or dot at the anchor, the box, and its wrapped
|
|
4
|
+
text, all inert.
|
|
5
|
+
*/
|
|
6
|
+
import type { SceneNode } from "@d3plus/render";
|
|
7
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
8
|
+
import { type AnnotationFrame } from "./annotationFrame.js";
|
|
9
|
+
import type { Annotation } from "./annotationTypes.js";
|
|
10
|
+
type Row = Record<string, unknown>;
|
|
11
|
+
/**
|
|
12
|
+
Reads one style key for a callout row: an accessor on the annotation
|
|
13
|
+
called with the row, else the row's own value, else the annotation's.
|
|
14
|
+
@param annotation The callout annotation.
|
|
15
|
+
@param d The row.
|
|
16
|
+
@param i The row's index.
|
|
17
|
+
*/
|
|
18
|
+
export declare function calloutPicker(annotation: Annotation, d: Row, i: number): (key: string) => unknown;
|
|
19
|
+
/**
|
|
20
|
+
The scene nodes of one callout row, or nothing when it has no label or
|
|
21
|
+
its anchor lies outside the plot area (a zoom that pans it out of view).
|
|
22
|
+
@param viz The chart.
|
|
23
|
+
@param annotation The callout annotation.
|
|
24
|
+
@param frame The plot area and its axes.
|
|
25
|
+
@param row The row, its index, and its key.
|
|
26
|
+
*/
|
|
27
|
+
export declare function calloutRowNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, row: {
|
|
28
|
+
d: Row;
|
|
29
|
+
i: number;
|
|
30
|
+
key: string;
|
|
31
|
+
}): SceneNode[];
|
|
32
|
+
/**
|
|
33
|
+
The scene nodes of a callout annotation's rows.
|
|
34
|
+
@param viz The chart.
|
|
35
|
+
@param annotation The callout annotation.
|
|
36
|
+
@param frame The plot area and its axes.
|
|
37
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
38
|
+
*/
|
|
39
|
+
export declare function calloutNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, key: string): SceneNode[];
|
|
40
|
+
export {};
|
|
@@ -53,7 +53,7 @@ export declare function marginOriginTransform(viz: Viz): Transform;
|
|
|
53
53
|
|
|
54
54
|
Width and height are the margin-adjusted chart-area dimensions —
|
|
55
55
|
callers usually have them on hand from `chartBounds(viz)` or from
|
|
56
|
-
fields a stage stashed (e.g. `
|
|
56
|
+
fields a stage stashed (e.g. `_radialMatrixWidth`).
|
|
57
57
|
*/
|
|
58
58
|
export declare function centerChartTransform(viz: Viz, width: number, height: number): Transform;
|
|
59
59
|
/**
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Placement of circle labels: each label sits inside its circle when it fits
|
|
3
|
+
there at a readable size, otherwise beside the circle on the side with the
|
|
4
|
+
most open room (Moritz Stefaner's Voronoi labeling), otherwise nowhere.
|
|
5
|
+
Pure geometry: text is measured by the caller.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/
|
|
9
|
+
import type { Bounds } from "@d3plus/math";
|
|
10
|
+
/** Where a circle's label goes: `"auto"` picks inside, beside, or hidden. */
|
|
11
|
+
export type LabelPosition = "auto" | "inside" | "outside";
|
|
12
|
+
/** A circle, in the same space as the bounds. */
|
|
13
|
+
export interface LabelCircle {
|
|
14
|
+
x: number;
|
|
15
|
+
y: number;
|
|
16
|
+
r: number;
|
|
17
|
+
}
|
|
18
|
+
/** An axis-aligned box: its top-left corner and size. */
|
|
19
|
+
export interface CircleLabelBox {
|
|
20
|
+
x: number;
|
|
21
|
+
y: number;
|
|
22
|
+
width: number;
|
|
23
|
+
height: number;
|
|
24
|
+
}
|
|
25
|
+
/** The sides of a circle a label can sit on. */
|
|
26
|
+
export type LabelSide = "right" | "left" | "top" | "bottom" | "top-right" | "top-left" | "bottom-right" | "bottom-left";
|
|
27
|
+
/** One label to place. */
|
|
28
|
+
export interface CircleLabelRequest {
|
|
29
|
+
/** The index, in the circles array, of the circle the label names. */
|
|
30
|
+
circle: number;
|
|
31
|
+
/** The label's size when it sits beside the circle. */
|
|
32
|
+
width: number;
|
|
33
|
+
height: number;
|
|
34
|
+
position: LabelPosition;
|
|
35
|
+
/** Whether the label fits inside its circle at a readable size. */
|
|
36
|
+
fitsInside: boolean;
|
|
37
|
+
}
|
|
38
|
+
/** Where a label went. */
|
|
39
|
+
export type CircleLabelPlacement = {
|
|
40
|
+
position: "inside";
|
|
41
|
+
} | {
|
|
42
|
+
position: "outside";
|
|
43
|
+
side: LabelSide;
|
|
44
|
+
box: CircleLabelBox;
|
|
45
|
+
} | {
|
|
46
|
+
position: "hidden";
|
|
47
|
+
};
|
|
48
|
+
/** Tuning for `placeCircleLabels`. */
|
|
49
|
+
export interface PlaceCircleLabelsOptions {
|
|
50
|
+
/** The space between a circle's edge and a label beside it (default 3). */
|
|
51
|
+
gap?: number;
|
|
52
|
+
/**
|
|
53
|
+
The share of a label's area that must lie in its circle's Voronoi cell,
|
|
54
|
+
the region closer to that circle's center than to any other (default
|
|
55
|
+
0.5): a label mostly in a neighbor's cell would read as the neighbor's.
|
|
56
|
+
*/
|
|
57
|
+
cellCoverage?: number;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
The box a `width` × `height` label takes on one side of a circle, `gap`
|
|
61
|
+
pixels clear of its edge: centered on the circle's axis for a straight
|
|
62
|
+
side, with its nearest corner on the circle's diagonal for a diagonal one.
|
|
63
|
+
*/
|
|
64
|
+
export declare function sideBox(circle: LabelCircle, side: LabelSide, width: number, height: number, gap?: number): CircleLabelBox;
|
|
65
|
+
/** A ring's centroid, or null when it has no area. */
|
|
66
|
+
export declare function ringCentroid(ring: [number, number][]): [number, number] | null;
|
|
67
|
+
/**
|
|
68
|
+
The sides of a circle, most open first: ordered by how closely each
|
|
69
|
+
points toward the centroid of the circle's Voronoi cell (diagonals
|
|
70
|
+
slightly discounted), or in the default order (right, left, top, bottom,
|
|
71
|
+
then the diagonals) when the centroid is too close to the center to point
|
|
72
|
+
anywhere, which is the case for an evenly surrounded circle.
|
|
73
|
+
@param circle The circle.
|
|
74
|
+
@param cell Its Voronoi cell, or null.
|
|
75
|
+
*/
|
|
76
|
+
export declare function sideOrder(circle: LabelCircle, cell: [number, number][] | null): LabelSide[];
|
|
77
|
+
/** The share (0–1) of a box's area that lies inside a ring. */
|
|
78
|
+
export declare function boxCoverage(box: CircleLabelBox, ring: [number, number][]): number;
|
|
79
|
+
/** Whether a box overlaps a circle's interior. */
|
|
80
|
+
export declare function boxHitsCircle(box: CircleLabelBox, circle: LabelCircle): boolean;
|
|
81
|
+
/** Whether two boxes overlap (touching edges don't count). */
|
|
82
|
+
export declare function boxesOverlap(a: CircleLabelBox, b: CircleLabelBox): boolean;
|
|
83
|
+
/**
|
|
84
|
+
Places circle labels. A label in `"inside"` mode stays inside its circle;
|
|
85
|
+
in `"auto"` mode it stays inside when `fitsInside`, and otherwise (or in
|
|
86
|
+
`"outside"` mode) it takes the first side of its circle, most open first
|
|
87
|
+
(see `sideOrder`), where it lies mostly in the circle's Voronoi cell, stays
|
|
88
|
+
in `bounds`, and overlaps no circle and no label placed before it. A label
|
|
89
|
+
with no such side, or whose circle is centered outside `bounds`, is
|
|
90
|
+
hidden. Labels are placed largest circle first
|
|
91
|
+
(ties in input order), so big circles win the room; the result is in
|
|
92
|
+
input order and depends only on the input.
|
|
93
|
+
@param circles Every circle, labeled or not: each is an obstacle.
|
|
94
|
+
@param labels The labels to place.
|
|
95
|
+
@param bounds The box labels must stay in.
|
|
96
|
+
*/
|
|
97
|
+
export declare function placeCircleLabels(circles: readonly LabelCircle[], labels: readonly CircleLabelRequest[], bounds: Bounds, options?: PlaceCircleLabelsOptions): CircleLabelPlacement[];
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Circle labels on a chart: resolves each label's `labelPosition`, measures
|
|
3
|
+
its text, places it (see `circleLabelPlacement.ts`), and emits the labels
|
|
4
|
+
that sit beside their circles. Shared by Plot's point marks, Network's
|
|
5
|
+
nodes, and Geomap's coordinate points.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/
|
|
9
|
+
import type { DataPoint } from "@d3plus/data";
|
|
10
|
+
import type { Bounds } from "@d3plus/math";
|
|
11
|
+
import type { SceneNode } from "@d3plus/render";
|
|
12
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
13
|
+
import type { CircleLabelPlacement, CircleLabelBox, LabelPosition, LabelSide } from "./circleLabelPlacement.js";
|
|
14
|
+
/** A font to measure or wrap text in. */
|
|
15
|
+
export interface LabelFont {
|
|
16
|
+
family?: string | string[];
|
|
17
|
+
size: number;
|
|
18
|
+
weight?: string | number;
|
|
19
|
+
/** The line height, in pixels (default 1.2 × `size`). */
|
|
20
|
+
lineHeight?: number;
|
|
21
|
+
}
|
|
22
|
+
/** The box an inside label wraps in, before padding. */
|
|
23
|
+
export interface InsideLabelBox {
|
|
24
|
+
width: number;
|
|
25
|
+
height: number;
|
|
26
|
+
/** `"circle"` wraps lines as chords of the circle the box holds. */
|
|
27
|
+
shape?: "circle" | "square";
|
|
28
|
+
/** CSS-style padding inside the box (default 0). */
|
|
29
|
+
padding?: number | string;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
Whether `text` fits inside a box at `font.size`, wrapped the way a label
|
|
33
|
+
TextBox wraps it, without being cut short.
|
|
34
|
+
@param text The label text.
|
|
35
|
+
@param box The box, with its wrapping shape and padding.
|
|
36
|
+
@param font The font, at the smallest size that counts as fitting.
|
|
37
|
+
*/
|
|
38
|
+
export declare function labelFitsInside(text: string, box: InsideLabelBox, font: LabelFont): boolean;
|
|
39
|
+
/**
|
|
40
|
+
The box a one-line label takes: its measured width, plus a pixel of slack
|
|
41
|
+
on each side so the TextBox drawing it never wraps it, by a line's height
|
|
42
|
+
plus a pixel.
|
|
43
|
+
*/
|
|
44
|
+
export declare function measureLabel(text: string, font: LabelFont): {
|
|
45
|
+
width: number;
|
|
46
|
+
height: number;
|
|
47
|
+
};
|
|
48
|
+
/** The resolved `pointLabelConfig`. */
|
|
49
|
+
export interface PointLabelSettings {
|
|
50
|
+
/** The smallest font size an inside label may shrink to before it moves outside. */
|
|
51
|
+
fontMin: number;
|
|
52
|
+
/** The font size of a label beside its circle. */
|
|
53
|
+
fontSize: number;
|
|
54
|
+
/** The space between a circle's edge and a label beside it. */
|
|
55
|
+
padding: number;
|
|
56
|
+
/** The TextBox config of a label beside its circle (font, color, …). */
|
|
57
|
+
text: Record<string, unknown>;
|
|
58
|
+
}
|
|
59
|
+
/** Reads `pointLabelConfig`: numbers for fontMin/fontSize/padding, the rest as TextBox config. */
|
|
60
|
+
export declare function pointLabelSettings(viz: VizInstance): PointLabelSettings;
|
|
61
|
+
/** A row's `labelPosition`, with anything unrecognized read as `"auto"`. */
|
|
62
|
+
export declare function labelPositionOf(viz: VizInstance, d: DataPoint, i: number): LabelPosition;
|
|
63
|
+
/** One circle on a chart, and its label. */
|
|
64
|
+
export interface CircleLabelItem<K> {
|
|
65
|
+
/** What the result is keyed by (the scene datum or layout node). */
|
|
66
|
+
key: K;
|
|
67
|
+
/** The data row, and its index, handed to `labelPosition` and the label config. */
|
|
68
|
+
datum: DataPoint;
|
|
69
|
+
index: number;
|
|
70
|
+
x: number;
|
|
71
|
+
y: number;
|
|
72
|
+
r: number;
|
|
73
|
+
/** The label text; anything but a string or number leaves the circle unlabeled (an obstacle only). */
|
|
74
|
+
text?: unknown;
|
|
75
|
+
/** How an inside label wraps (default: the circle itself, unpadded). */
|
|
76
|
+
inside?: InsideLabelBox & {
|
|
77
|
+
font?: Pick<LabelFont, "family" | "weight">;
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
/** A label's placement, with the mode it was placed in and its text. */
|
|
81
|
+
export type CircleLabelLayout = CircleLabelPlacement & {
|
|
82
|
+
mode: LabelPosition;
|
|
83
|
+
text: string;
|
|
84
|
+
};
|
|
85
|
+
/**
|
|
86
|
+
Places every labeled circle's label (see `placeCircleLabels`), reading
|
|
87
|
+
each row's `labelPosition` and the chart's `pointLabelConfig`. An
|
|
88
|
+
`"auto"` label counts as fitting inside when it fits at
|
|
89
|
+
`pointLabelConfig.fontMin`.
|
|
90
|
+
@param viz The chart.
|
|
91
|
+
@param items Every circle, labeled or not.
|
|
92
|
+
@param bounds The box labels must stay in, in the circles' space.
|
|
93
|
+
*/
|
|
94
|
+
export declare function layoutCircleLabels<K>(viz: VizInstance, items: readonly CircleLabelItem<K>[], bounds: Bounds): Map<K, CircleLabelLayout>;
|
|
95
|
+
/** The text anchor that keeps a label flush against its circle. */
|
|
96
|
+
export declare function sideAnchor(side: LabelSide): "start" | "middle" | "end";
|
|
97
|
+
/** A label to draw beside its circle. */
|
|
98
|
+
export interface OutsideLabel {
|
|
99
|
+
/** The id the label's scene key is built from (`${id}_0`). */
|
|
100
|
+
id: string;
|
|
101
|
+
/** The scene datum the label carries (hover and active match on it). */
|
|
102
|
+
datum: DataPoint;
|
|
103
|
+
text: string;
|
|
104
|
+
side: LabelSide;
|
|
105
|
+
box: CircleLabelBox;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
Text nodes for labels placed beside their circles: one line each, in the
|
|
109
|
+
chart's ink (`backgroundInk`) at `pointLabelConfig.fontSize`, flush
|
|
110
|
+
against the circle, and inert to the pointer.
|
|
111
|
+
@param viz The chart.
|
|
112
|
+
@param labels The labels, each with its placed box.
|
|
113
|
+
@param config TextBox config layered under `pointLabelConfig` (such as a
|
|
114
|
+
`fontOpacity` that follows the shapes).
|
|
115
|
+
*/
|
|
116
|
+
export declare function emitOutsideLabels(viz: VizInstance, labels: readonly OutsideLabel[], config?: Record<string, unknown>): SceneNode[];
|
|
117
|
+
/**
|
|
118
|
+
Splits laid-out labels into the ones drawn beside their circles, with the
|
|
119
|
+
id and scene datum each takes.
|
|
120
|
+
*/
|
|
121
|
+
export declare function outsideLabels<K>(layout: Map<K, CircleLabelLayout>, describe: (key: K) => {
|
|
122
|
+
id: string;
|
|
123
|
+
datum: DataPoint;
|
|
124
|
+
}): OutsideLabel[];
|
|
125
|
+
/**
|
|
126
|
+
The font size floor of an inside label: `pointLabelConfig.fontMin` when it
|
|
127
|
+
was placed in `"auto"` mode (so it never shrinks below the size it was
|
|
128
|
+
judged to fit at), else its own.
|
|
129
|
+
*/
|
|
130
|
+
export declare function insideFontMin(viz: VizInstance, placed: CircleLabelLayout | undefined, own: number): number;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The value the chart's colorScale reads from a row: the chart's own
|
|
3
|
+
`colorScale` for its data rows, and, on the node-link charts, each link's
|
|
4
|
+
numeric `linkColor` value for its link rows (see `linkColorScaleRows`).
|
|
5
|
+
*/
|
|
6
|
+
import type { DataPoint } from "@d3plus/data";
|
|
7
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
8
|
+
type Accessor = (d: DataPoint, i: number) => unknown;
|
|
9
|
+
/** Whether `v` is a number the colorScale can place. */
|
|
10
|
+
export declare function isScaleValue(v: unknown): v is number;
|
|
11
|
+
/**
|
|
12
|
+
Notes a drawn link datum's numeric `linkColor` value, so the colorScale
|
|
13
|
+
reads it for that link (hovering it marks the value on the colorScale,
|
|
14
|
+
and hovering a colorScale bucket highlights the links in it).
|
|
15
|
+
*/
|
|
16
|
+
export declare function noteLinkValue(viz: VizInstance, datum: object, value: number): void;
|
|
17
|
+
/**
|
|
18
|
+
The `links` entries whose `linkColor` value is a number: the rows the
|
|
19
|
+
chart's colorScale adds to its own. Empty when `linkColor` isn't a key or
|
|
20
|
+
accessor, or no link has a numeric value.
|
|
21
|
+
*/
|
|
22
|
+
export declare function linkColorScaleRows(viz: VizInstance): DataPoint[];
|
|
23
|
+
/**
|
|
24
|
+
The accessor the chart's colorScale reads values with: the chart's own
|
|
25
|
+
`colorScale`, which also reads each link row's numeric `linkColor`
|
|
26
|
+
value when it has links colored by number. Undefined when neither
|
|
27
|
+
gives the colorScale anything to show.
|
|
28
|
+
*/
|
|
29
|
+
export declare function colorScaleValue(viz: VizInstance): Accessor | undefined;
|
|
30
|
+
/**
|
|
31
|
+
The color the chart's colorScale gives `value`: the scale's color for it,
|
|
32
|
+
or the scale's last color while it has no domain yet.
|
|
33
|
+
*/
|
|
34
|
+
export declare function colorScaleColor(viz: VizInstance, value: unknown): unknown;
|
|
35
|
+
export {};
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Arrowheads on curved edge ends. On a curve, the tangent at the tip and
|
|
3
|
+
the curve a few pixels back point different ways, so a head aimed along
|
|
4
|
+
the tangent leaves the stroke's end off its axis. Here a head is aimed
|
|
5
|
+
along the chord from where its base sits on the path to its tip, and the
|
|
6
|
+
stroke follows the path up to the base, then runs straight along that
|
|
7
|
+
chord to end inside the head (see `arrowTrim`). The join at the base is
|
|
8
|
+
under the head, so the stroke reads smooth.
|
|
9
|
+
|
|
10
|
+
The path is a polyline (a sampled curve, or projected points such as a
|
|
11
|
+
map's) or a cubic Bézier curve.
|
|
12
|
+
*/
|
|
13
|
+
import type { DataPoint } from "@d3plus/data";
|
|
14
|
+
import type { SceneNode } from "@d3plus/render";
|
|
15
|
+
import type { EdgeArrowTrims } from "./edgeArrows.js";
|
|
16
|
+
import type { Point } from "./polyline.js";
|
|
17
|
+
type Cubic = [Point, Point, Point, Point];
|
|
18
|
+
/** One arrowed end of an edge: its head's tip and direction, its base on the path, and where the stroke ends. */
|
|
19
|
+
export interface ArrowedEnd {
|
|
20
|
+
tip: Point;
|
|
21
|
+
/** The head's direction, from its base to its tip, in radians. */
|
|
22
|
+
angle: number;
|
|
23
|
+
/** Where the head's base sits on the path. */
|
|
24
|
+
base: Point;
|
|
25
|
+
/** Where the stroke ends: on the head's axis, `trim` back from its tip. */
|
|
26
|
+
cut: Point;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
The point `distance` pixels back along a polyline from its last point
|
|
30
|
+
(its first point when the polyline is shorter than that). Pass the
|
|
31
|
+
points reversed for a distance from the first point.
|
|
32
|
+
*/
|
|
33
|
+
export declare function pathPointBack(points: readonly Point[], distance: number): Point;
|
|
34
|
+
/** A cubic Bézier curve as a polyline of `steps` chords. */
|
|
35
|
+
export declare function cubicPolyline(curve: Cubic, steps?: number): Point[];
|
|
36
|
+
/** The direction (radians) of the chord from `base` to `tip`. */
|
|
37
|
+
export declare function chordAngle(base: Point, tip: Point): number;
|
|
38
|
+
/**
|
|
39
|
+
A head at `tip` aimed along the chord from `base` (where its base sits
|
|
40
|
+
on the path), and the stroke's end `trim` back from the tip on that
|
|
41
|
+
chord.
|
|
42
|
+
*/
|
|
43
|
+
export declare function arrowAlongChord(tip: Point, base: Point, trim: number): ArrowedEnd;
|
|
44
|
+
/**
|
|
45
|
+
A cubic edge's visible stroke and its arrowed ends: each head's tip sits
|
|
46
|
+
`tipBack` pixels back along the curve from its end, its base `size`
|
|
47
|
+
further back, and the stroke runs along the curve between the bases,
|
|
48
|
+
then straight along each head's axis to its `cut`.
|
|
49
|
+
@param curve The edge, from its source end to its target end.
|
|
50
|
+
@param trims The edge's arrow ends, size, and stroke trims (see `edgeArrowTrims`).
|
|
51
|
+
@param tipBack How far back along the curve each end's tip sits.
|
|
52
|
+
*/
|
|
53
|
+
export declare function cubicArrowEdge(curve: Cubic, trims: EdgeArrowTrims, tipBack?: {
|
|
54
|
+
source: number;
|
|
55
|
+
target: number;
|
|
56
|
+
}): {
|
|
57
|
+
d: string;
|
|
58
|
+
source?: ArrowedEnd;
|
|
59
|
+
target?: ArrowedEnd;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
A polyline edge's visible stroke and its arrowed ends: each head's tip
|
|
63
|
+
sits `tipBack` pixels back along the polyline from its end, its base
|
|
64
|
+
`size` further back, and the stroke follows the polyline between the
|
|
65
|
+
bases, then runs straight along each head's axis to its `cut`.
|
|
66
|
+
@param points The edge, from its source end to its target end: one
|
|
67
|
+
polyline, or the runs of a path cut into pieces (a map projection's),
|
|
68
|
+
whose first run starts at the source and last run ends at the target.
|
|
69
|
+
@param trims The edge's arrow ends, size, and stroke trims (see `edgeArrowTrims`).
|
|
70
|
+
@param tipBack How far back along the polyline each end's tip sits.
|
|
71
|
+
*/
|
|
72
|
+
export declare function polylineArrowEdge(points: Point[] | Point[][], trims: EdgeArrowTrims, tipBack?: {
|
|
73
|
+
source: number;
|
|
74
|
+
target: number;
|
|
75
|
+
}): {
|
|
76
|
+
d: string;
|
|
77
|
+
source?: ArrowedEnd;
|
|
78
|
+
target?: ArrowedEnd;
|
|
79
|
+
};
|
|
80
|
+
/**
|
|
81
|
+
A path `body` (starting with its own `M`) extended straight along each
|
|
82
|
+
arrowed end's axis: from the source head's `cut` to the body's start,
|
|
83
|
+
and from the body's end to the target head's `cut`.
|
|
84
|
+
*/
|
|
85
|
+
export declare function chordEndsPathD(body: string, source?: ArrowedEnd, target?: ArrowedEnd): string;
|
|
86
|
+
/**
|
|
87
|
+
The head nodes for an edge's arrowed ends, keyed `${keyPrefix}-t` and
|
|
88
|
+
`${keyPrefix}-s`, or by `keys`.
|
|
89
|
+
*/
|
|
90
|
+
export declare function chordArrowNodes(opts: {
|
|
91
|
+
ends: {
|
|
92
|
+
source?: ArrowedEnd;
|
|
93
|
+
target?: ArrowedEnd;
|
|
94
|
+
};
|
|
95
|
+
size: number;
|
|
96
|
+
datum: DataPoint;
|
|
97
|
+
keyPrefix: string;
|
|
98
|
+
keys?: {
|
|
99
|
+
source: string;
|
|
100
|
+
target: string;
|
|
101
|
+
};
|
|
102
|
+
fill?: string;
|
|
103
|
+
opacity?: number;
|
|
104
|
+
}): SceneNode[];
|
|
105
|
+
export {};
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
Shared arrowhead geometry for edge charts (Network, Rings,
|
|
2
|
+
Shared arrowhead geometry for edge charts (Network, Rings, ArcDiagram,
|
|
3
|
+
Geomap, Gantt).
|
|
3
4
|
|
|
4
5
|
Arrowheads are drawn as filled-triangle `path` scene nodes rather than SVG
|
|
5
6
|
`marker-end`, because d3plus renders to both SVG and Canvas and Canvas has no
|
|
@@ -42,11 +43,81 @@ export declare function straightArrowTip(fromX: number, fromY: number, toX: numb
|
|
|
42
43
|
y: number;
|
|
43
44
|
angle: number;
|
|
44
45
|
};
|
|
46
|
+
/**
|
|
47
|
+
The arrowhead size for an edge drawn `strokeWidth` pixels wide when
|
|
48
|
+
`arrowSize` isn't set: three times the stroke for thin edges, growing no
|
|
49
|
+
larger than 12 pixels from a 4px stroke on, but never under 1.5 times the
|
|
50
|
+
stroke (so the head stays wider than its line), and at least 6 pixels.
|
|
51
|
+
*/
|
|
52
|
+
export declare function defaultArrowSize(strokeWidth: number): number;
|
|
45
53
|
/**
|
|
46
54
|
Resolve the arrowhead size from the `arrowSize` config (a number or per-edge
|
|
47
|
-
accessor), falling back to
|
|
55
|
+
accessor), falling back to `defaultArrowSize` for the edge's stroke width.
|
|
48
56
|
*/
|
|
49
57
|
export declare function arrowSizeFor(arrowSize: unknown, d: DataPoint, i: number, strokeWidth: number): number;
|
|
58
|
+
/**
|
|
59
|
+
How far back from an arrowhead's tip its edge's stroke ends, so the
|
|
60
|
+
stroke's square (butt) end sits inside the head: the head is `1.2 × d`
|
|
61
|
+
wide at `d` pixels from its tip, so this is where it is as wide as the
|
|
62
|
+
stroke, at least halfway along the head and at most its base.
|
|
63
|
+
*/
|
|
64
|
+
export declare function arrowTrim(size: number, strokeWidth: number): number;
|
|
65
|
+
/** An edge's arrowheads: which ends carry one, their size, and the stroke trim at each. */
|
|
66
|
+
export interface EdgeArrowTrims {
|
|
67
|
+
ends: ArrowEnds;
|
|
68
|
+
size: number;
|
|
69
|
+
/** How far the stroke ends back from each end's arrow tip (0 without an arrow). */
|
|
70
|
+
source: number;
|
|
71
|
+
target: number;
|
|
72
|
+
}
|
|
73
|
+
/** Resolves an edge's `arrows`/`arrowSize` into its arrowhead ends, size, and stroke trims. */
|
|
74
|
+
export declare function edgeArrowTrims(opts: {
|
|
75
|
+
arrows: ArrowValue;
|
|
76
|
+
arrowSize: unknown;
|
|
77
|
+
strokeWidth?: number;
|
|
78
|
+
datum: DataPoint;
|
|
79
|
+
i: number;
|
|
80
|
+
}): EdgeArrowTrims;
|
|
81
|
+
type Point = [number, number];
|
|
82
|
+
/**
|
|
83
|
+
A straight segment from `a` to `b`, shortened by `start` pixels at `a`
|
|
84
|
+
and `end` pixels at `b`. When the two overlap, it collapses to the point
|
|
85
|
+
between them.
|
|
86
|
+
*/
|
|
87
|
+
export declare function trimSegment(a: Point, b: Point, start: number, end: number): [Point, Point];
|
|
88
|
+
/**
|
|
89
|
+
A cubic Bézier curve shortened along its own length by `start` pixels at
|
|
90
|
+
its first end and `end` pixels at its last: the same curve, cut short,
|
|
91
|
+
so the ends keep their direction. When the two cuts meet, it collapses
|
|
92
|
+
to the point where they do.
|
|
93
|
+
@param steps The number of chords the curve's length is measured in.
|
|
94
|
+
*/
|
|
95
|
+
export declare function trimCubic(curve: [Point, Point, Point, Point], start: number, end: number, steps?: number): [Point, Point, Point, Point];
|
|
96
|
+
/** A cubic Bézier curve's SVG path. */
|
|
97
|
+
export declare function cubicPathD([p0, p1, p2, p3]: [
|
|
98
|
+
Point,
|
|
99
|
+
Point,
|
|
100
|
+
Point,
|
|
101
|
+
Point
|
|
102
|
+
]): string;
|
|
103
|
+
/**
|
|
104
|
+
The visible stroke of a straight, center-to-center edge between nodes
|
|
105
|
+
of radius `source.r` and `target.r`: cut short inside each arrowhead
|
|
106
|
+
(whose tip sits a pixel off the node's edge, see `straightArrowTip`).
|
|
107
|
+
The full center-to-center path stays the edge's hit area.
|
|
108
|
+
*/
|
|
109
|
+
export declare function straightEdgeD(source: {
|
|
110
|
+
x: number;
|
|
111
|
+
y: number;
|
|
112
|
+
r?: number;
|
|
113
|
+
}, target: {
|
|
114
|
+
x: number;
|
|
115
|
+
y: number;
|
|
116
|
+
r?: number;
|
|
117
|
+
}, trims: {
|
|
118
|
+
source: number;
|
|
119
|
+
target: number;
|
|
120
|
+
}): string;
|
|
50
121
|
/**
|
|
51
122
|
Emit arrowhead nodes for a straight, center-to-center edge between two nodes
|
|
52
123
|
(radii `source.r`/`target.r`), insetting each tip to the node boundary.
|
|
@@ -90,3 +161,4 @@ export interface ArrowNodeOpts {
|
|
|
90
161
|
arrow paired with its edge.
|
|
91
162
|
*/
|
|
92
163
|
export declare function arrowNode(opts: ArrowNodeOpts): SceneNode;
|
|
164
|
+
export {};
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Force-directed edge bundling (Holten & van Wijk, 2009). Each straight
|
|
3
|
+
edge is split into points, and each point is pulled toward the matching
|
|
4
|
+
points of the edges compatible with it (edges running the same way, at
|
|
5
|
+
a similar length, near it, and in view of it), while a spring along the
|
|
6
|
+
edge keeps it smooth. Over a few cycles the points double and the step
|
|
7
|
+
halves, so edges gather into bundles that fan out at their ends.
|
|
8
|
+
|
|
9
|
+
Pure geometry in screen space. The simulation runs on the edges scaled
|
|
10
|
+
to a fixed size, so its settings behave the same at any chart size, and
|
|
11
|
+
a cache keyed by the edges' positions and the settings lets a redraw
|
|
12
|
+
reuse it.
|
|
13
|
+
*/
|
|
14
|
+
import type { Point } from "./polyline.js";
|
|
15
|
+
/** An edge as its two ends, source then target. */
|
|
16
|
+
export type Segment = readonly [Point, Point];
|
|
17
|
+
/** The `linkBundleConfig` settings (see `EDGE_BUNDLE_DEFAULTS`). */
|
|
18
|
+
export interface EdgeBundleOptions {
|
|
19
|
+
/** How closely a path keeps to its bundle: 0 draws it straight, 1 fully bundled. */
|
|
20
|
+
strength: number;
|
|
21
|
+
/** How many times the points along each edge double. */
|
|
22
|
+
cycles: number;
|
|
23
|
+
/** Simulation steps in the first cycle; each later cycle takes two thirds as many. */
|
|
24
|
+
iterations: number;
|
|
25
|
+
/** The compatibility (0–1) two edges need to pull on each other. */
|
|
26
|
+
compatibility: number;
|
|
27
|
+
/** Whether the bundled points are joined by a smooth curve (else by straight lines). */
|
|
28
|
+
smoothing: boolean;
|
|
29
|
+
}
|
|
30
|
+
export declare const EDGE_BUNDLE_DEFAULTS: EdgeBundleOptions;
|
|
31
|
+
/** |cos| of the angle between two edges: 1 parallel, 0 perpendicular. */
|
|
32
|
+
export declare function angleCompatibility(p: Segment, q: Segment): number;
|
|
33
|
+
/** How alike two edges' lengths are: 1 for equal lengths, toward 0 as they differ. */
|
|
34
|
+
export declare function scaleCompatibility(p: Segment, q: Segment): number;
|
|
35
|
+
/** How near two edges' midpoints are, relative to their average length. */
|
|
36
|
+
export declare function positionCompatibility(p: Segment, q: Segment): number;
|
|
37
|
+
/** The smaller of each edge's visibility from the other (see Holten & van Wijk). */
|
|
38
|
+
export declare function visibilityCompatibility(p: Segment, q: Segment): number;
|
|
39
|
+
/** Two edges' compatibility, 0–1: the product of the four measures. */
|
|
40
|
+
export declare function edgeCompatibility(p: Segment, q: Segment): number;
|
|
41
|
+
/**
|
|
42
|
+
The largest ratio between two edges' lengths whose scale compatibility
|
|
43
|
+
still reaches `threshold` (Infinity for a threshold of 0 or less).
|
|
44
|
+
*/
|
|
45
|
+
export declare function maxLengthRatio(threshold: number): number;
|
|
46
|
+
/**
|
|
47
|
+
Each edge's compatible edges, as compressed rows: edge `e`'s neighbors
|
|
48
|
+
are `neighbors[offsets[e]]` up to `neighbors[offsets[e + 1]]`, and each
|
|
49
|
+
one's `weights` entry is its compatibility, negative when the two edges
|
|
50
|
+
run opposite ways. Only pairs reaching `threshold` are kept; a grid over
|
|
51
|
+
the edges' midpoints skips pairs too far apart to reach it.
|
|
52
|
+
*/
|
|
53
|
+
export interface CompatibilityGraph {
|
|
54
|
+
offsets: Int32Array;
|
|
55
|
+
neighbors: Int32Array;
|
|
56
|
+
weights: Float32Array;
|
|
57
|
+
}
|
|
58
|
+
/** The compatible pairs among `edges` (see `CompatibilityGraph`). */
|
|
59
|
+
export declare function compatibilityGraph(edges: readonly Segment[], threshold: number): CompatibilityGraph;
|
|
60
|
+
/**
|
|
61
|
+
`segments + 1` points spaced evenly along a polyline's length, from its
|
|
62
|
+
first point to its last.
|
|
63
|
+
*/
|
|
64
|
+
export declare function subdividePolyline(points: Point[], segments: number): Point[];
|
|
65
|
+
/** Cached simulations, by `edgeBundleKey`, and how many have run. */
|
|
66
|
+
export interface EdgeBundleCache {
|
|
67
|
+
entries: Map<string, Point[][]>;
|
|
68
|
+
runs: number;
|
|
69
|
+
}
|
|
70
|
+
/** A new, empty cache for `bundleEdges`. */
|
|
71
|
+
export declare function edgeBundleCache(): EdgeBundleCache;
|
|
72
|
+
/** The settings with every missing or invalid entry at its default. */
|
|
73
|
+
export declare function edgeBundleOptions(options?: Partial<EdgeBundleOptions>): EdgeBundleOptions;
|
|
74
|
+
/**
|
|
75
|
+
The cache key for bundling `edges` with `options`: the edges' ends to a
|
|
76
|
+
tenth of a pixel, and the settings the simulation reads.
|
|
77
|
+
*/
|
|
78
|
+
export declare function edgeBundleKey(edges: readonly Segment[], options: EdgeBundleOptions): string;
|
|
79
|
+
/**
|
|
80
|
+
Bundles `edges` (see the module notes) and returns each one's path as a
|
|
81
|
+
polyline from its source to its target: the simulated points pulled
|
|
82
|
+
toward the straight edge by `1 - strength`, and joined by a smooth
|
|
83
|
+
curve when `smoothing` is on. An edge of no length stays as its two
|
|
84
|
+
ends.
|
|
85
|
+
*/
|
|
86
|
+
export declare function bundleEdges(edges: readonly Segment[], options?: Partial<EdgeBundleOptions>, cache?: EdgeBundleCache): Point[][];
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Turns a bundled edge's control points into the polyline it draws as:
|
|
3
|
+
straightened by the bundle's strength (as d3's `curveBundle.beta`
|
|
4
|
+
does), then optionally rounded into a B-spline and thinned to the
|
|
5
|
+
points that shape it.
|
|
6
|
+
*/
|
|
7
|
+
import type { Point } from "./polyline.js";
|
|
8
|
+
/**
|
|
9
|
+
Each point pulled toward the straight line between the polyline's ends,
|
|
10
|
+
to `strength` of the way from that line (0) to where it was (1).
|
|
11
|
+
*/
|
|
12
|
+
export declare function straightenPolyline(points: Point[], strength: number): Point[];
|
|
13
|
+
/**
|
|
14
|
+
The uniform cubic B-spline through a polyline's control points, ends
|
|
15
|
+
clamped so it starts and ends on them, sampled about every `spacing`
|
|
16
|
+
pixels (between 1 and 8 samples a span).
|
|
17
|
+
*/
|
|
18
|
+
export declare function bsplinePolyline(points: Point[], spacing?: number): Point[];
|
|
19
|
+
/**
|
|
20
|
+
The points of a polyline that keep its shape to within `tolerance`
|
|
21
|
+
pixels (Ramer–Douglas–Peucker), its ends always kept.
|
|
22
|
+
*/
|
|
23
|
+
export declare function simplifyPolyline(points: Point[], tolerance: number): Point[];
|
|
24
|
+
/**
|
|
25
|
+
A bundled edge's drawn polyline: its control points straightened by
|
|
26
|
+
`strength`, rounded into a B-spline when `smoothing` is on, and thinned
|
|
27
|
+
to within a quarter pixel.
|
|
28
|
+
*/
|
|
29
|
+
export declare function smoothBundle(points: Point[], strength: number, smoothing: boolean): Point[];
|
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
|
|
14
14
|
Idempotent: calling it again returns the existing nodes. Mutates the
|
|
15
15
|
viz instance with `_container` / `_zoomGroup` (and the Network
|
|
16
|
-
variant also wires the hitArea click handler
|
|
16
|
+
variant also wires the hitArea click handler, and `_backgroundClick` for
|
|
17
|
+
the Canvas renderer).
|
|
17
18
|
|
|
18
19
|
The helper stays as long as d3-zoom owns event binding and Geomap's
|
|
19
20
|
tile-loading mounts `<g>` elements directly. An eventual fully
|
|
@@ -39,5 +40,22 @@ interface SetupOpts {
|
|
|
39
40
|
/** Geomap-only: ocean fill color (also used as the svg background). */
|
|
40
41
|
ocean?: string;
|
|
41
42
|
}
|
|
43
|
+
/**
|
|
44
|
+
Clears a Network or ArcDiagram's click focus: its active nodes and its
|
|
45
|
+
zoom. Returns whether there was a focus to clear.
|
|
46
|
+
@param viz The chart.
|
|
47
|
+
*/
|
|
48
|
+
export declare function clearGraphFocus(viz: Viz): boolean;
|
|
49
|
+
/**
|
|
50
|
+
Whether a point lies within an area, edges included.
|
|
51
|
+
@param point The point.
|
|
52
|
+
@param area The area.
|
|
53
|
+
*/
|
|
54
|
+
export declare function withinArea([x, y]: [number, number], area: {
|
|
55
|
+
x: number;
|
|
56
|
+
y: number;
|
|
57
|
+
width: number;
|
|
58
|
+
height: number;
|
|
59
|
+
}): boolean;
|
|
42
60
|
export declare function ensureZoomDom(viz: Viz, opts: SetupOpts): void;
|
|
43
61
|
export {};
|