@d3plus/core 4.10.0 → 4.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +178 -9
- 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 +176 -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 +101 -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 +192 -0
- package/es/src/charts/ArcDiagram/events.js +148 -0
- package/es/src/charts/ArcDiagram/index.js +217 -0
- package/es/src/charts/BarChart/index.js +12 -7
- 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 +5 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +6 -11
- 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 +160 -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 +137 -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 +206 -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 +6 -4
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/applyLayout.js +20 -9
- package/es/src/charts/Matrix/index.js +19 -1
- package/es/src/charts/Network/applyLayout.js +171 -96
- package/es/src/charts/Network/bundle.js +82 -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 +257 -75
- package/es/src/charts/Network/graph.js +146 -0
- package/es/src/charts/Network/graphFluent.js +81 -0
- package/es/src/charts/Network/index.js +91 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +15 -8
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +8 -1
- package/es/src/charts/Pack/neutralPaint.js +20 -0
- package/es/src/charts/Pack/nodeNames.js +35 -0
- package/es/src/charts/ParallelCoordinates/axes.js +22 -22
- package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- 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 +51 -96
- package/es/src/charts/Pie/index.js +74 -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/areaEnter.js +68 -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 +34 -14
- 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 +19 -17
- 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/lineMarkerKeys.js +19 -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 +40 -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/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +2 -1
- package/es/src/charts/Plot/sharedTooltip.js +13 -3
- 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 +4 -3
- package/es/src/charts/Priestley/applyLayout.js +21 -23
- package/es/src/charts/Priestley/index.js +4 -37
- package/es/src/charts/Priestley/timeAxis.js +103 -0
- package/es/src/charts/Pyramid/gutter.js +52 -16
- package/es/src/charts/Pyramid/index.js +55 -7
- package/es/src/charts/Pyramid/scene.js +4 -4
- package/es/src/charts/Radar/applyLayout.js +31 -33
- package/es/src/charts/Radar/axisDecorations.js +62 -13
- package/es/src/charts/Radar/curvedLabels.js +228 -0
- package/es/src/charts/Radar/emit.js +30 -15
- package/es/src/charts/Radar/index.js +43 -5
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +9 -1
- package/es/src/charts/RadialBar/index.js +26 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/index.js +18 -9
- package/es/src/charts/Rings/applyLayout.js +39 -161
- package/es/src/charts/Rings/emit.js +219 -63
- package/es/src/charts/Rings/index.js +88 -32
- package/es/src/charts/Rings/ringsCurves.js +156 -0
- 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 +183 -0
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +61 -38
- package/es/src/charts/Sankey/applyLayout.js +130 -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 +78 -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 +83 -64
- package/es/src/charts/Sunburst/index.js +16 -4
- package/es/src/charts/Tree/applyLayout.js +44 -14
- package/es/src/charts/Tree/emit.js +5 -5
- package/es/src/charts/Tree/index.js +12 -18
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- 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 +14 -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 +10 -25
- 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/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +52 -23
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
- package/es/src/charts/drawSteps/zoomDrag.js +188 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +11 -4
- package/es/src/charts/events/click.shape.js +13 -4
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +9 -2
- package/es/src/charts/events/mousemove.legend.js +28 -32
- package/es/src/charts/events/mousemove.shape.js +45 -42
- 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 +17 -5
- package/es/src/charts/features/axesFinal.js +10 -3
- package/es/src/charts/features/axesMeasure.js +33 -12
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/centerLabel.js +177 -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/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +20 -1
- package/es/src/charts/features/colorScaleHover.js +33 -7
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +77 -0
- package/es/src/charts/features/colorScaleTop.js +61 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +191 -0
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +220 -5
- 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 +75 -20
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/hoverTicks.js +41 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- 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 +364 -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/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeStats.js +309 -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/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +46 -12
- 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 +54 -32
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +30 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +14 -5
- package/es/src/charts/partition/interaction.js +19 -10
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +22 -9
- 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/chrome.js +81 -9
- package/es/src/charts/polar/config.js +6 -3
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +61 -49
- package/es/src/charts/viz/VizBase.js +57 -14
- package/es/src/charts/viz/backgroundInk.js +23 -7
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- 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/interactionOpacity.js +115 -32
- 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/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +29 -0
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +34 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -4
- package/es/src/charts/viz/vizDefaults.js +28 -57
- package/es/src/charts/viz/vizFields.js +41 -1
- package/es/src/charts/viz/vizRender.js +76 -31
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +26 -2
- package/es/src/components/Axis/Axis.js +35 -2
- 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 +33 -8
- package/es/src/components/Axis/axisDefaults.js +16 -9
- package/es/src/components/Axis/axisLabelKinds.js +36 -0
- package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
- package/es/src/components/Axis/axisLabelRoom.js +37 -0
- package/es/src/components/Axis/axisLabelSize.js +171 -0
- package/es/src/components/Axis/axisLabelThinning.js +98 -4
- package/es/src/components/Axis/axisLayout.js +71 -46
- package/es/src/components/Axis/axisLayoutLabels.js +82 -140
- package/es/src/components/Axis/axisLayoutScale.js +16 -11
- package/es/src/components/Axis/axisLimit.js +27 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +20 -8
- package/es/src/components/Axis/axisRounding.js +16 -1
- package/es/src/components/Axis/axisScene.js +11 -2
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +128 -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 +77 -27
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +13 -2
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/Legend/legendCut.js +108 -0
- package/es/src/components/Legend/legendRender.js +38 -13
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +34 -67
- 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 +9 -4
- 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 +226 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +8 -5
- package/es/src/fluent.js +48 -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 +30 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configValue.js +9 -0
- 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 +268 -9
- 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 +46 -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 +24 -0
- package/types/src/charts/ArcDiagram/events.d.ts +29 -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 +36 -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/Matrix/applyLayout.d.ts +4 -2
- package/types/src/charts/Network/applyLayout.d.ts +11 -0
- package/types/src/charts/Network/bundle.d.ts +69 -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 +73 -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/Pack/applyLayout.d.ts +2 -0
- package/types/src/charts/Pack/groupRows.d.ts +46 -0
- package/types/src/charts/Pack/index.d.ts +3 -0
- package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
- package/types/src/charts/Pack/nodeNames.d.ts +23 -0
- package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
- package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
- package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
- 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/areaEnter.d.ts +34 -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 +16 -15
- 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/lineMarkerKeys.d.ts +11 -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/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
- 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 +79 -0
- package/types/src/charts/Pyramid/gutter.d.ts +28 -6
- package/types/src/charts/Pyramid/scene.d.ts +1 -1
- package/types/src/charts/Radar/applyLayout.d.ts +2 -3
- package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
- package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
- package/types/src/charts/Radar/emit.d.ts +5 -2
- package/types/src/charts/Radar/index.d.ts +7 -2
- package/types/src/charts/Radar/points.d.ts +50 -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/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/Rings/emit.d.ts +72 -0
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
- 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/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -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/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
- package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- 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/axisTooltip.d.ts +49 -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/centerLabel.d.ts +75 -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/colorScaleBivariate.d.ts +50 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
- package/types/src/charts/features/colorScaleHover.d.ts +13 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +119 -0
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +103 -4
- 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/hoverTicks.d.ts +30 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- 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 +192 -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/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -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/plotEndLabels.d.ts +14 -1
- 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 +15 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- 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/insetPlacement.d.ts +6 -0
- 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/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +25 -4
- package/types/src/charts/viz/VizBase.d.ts +37 -8
- package/types/src/charts/viz/backgroundInk.d.ts +19 -4
- package/types/src/charts/viz/emphasis.d.ts +17 -0
- package/types/src/charts/viz/fillStroke.d.ts +7 -0
- 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/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +26 -0
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +35 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +37 -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 +100 -7
- package/types/src/charts/viz/vizVisibility.d.ts +13 -0
- package/types/src/components/Axis/Axis.d.ts +34 -3
- 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 +21 -3
- package/types/src/components/Axis/axisDefaults.d.ts +12 -0
- package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
- package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
- package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
- package/types/src/components/Axis/axisLayout.d.ts +9 -2
- package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
- package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
- package/types/src/components/Axis/axisLimit.d.ts +18 -0
- package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +8 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -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 +22 -11
- package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
- package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +6 -0
- package/types/src/components/Legend/legendCut.d.ts +31 -0
- package/types/src/components/Legend/legendRender.d.ts +6 -1
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +5 -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/components/textEllipsis.d.ts +6 -0
- package/types/src/fluent.d.ts +18 -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/shapes/emitLabels.d.ts +1 -1
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +1093 -266
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configValue.d.ts +8 -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/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +72239 -41465
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +46249 -19519
- 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,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,192 @@
|
|
|
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, a node, or a legend entry highlights, and
|
|
5
|
+
the connections a
|
|
6
|
+
node's tooltip lists.
|
|
7
|
+
|
|
8
|
+
A link's datum is its row from `links`, with `source` and `target`
|
|
9
|
+
replaced by the data of the nodes they name. `linkSize`, `value`,
|
|
10
|
+
`shapeConfig` functions, arrow accessors, and the tooltip all receive it,
|
|
11
|
+
so they read node fields directly (`d.source.name`). The chart's
|
|
12
|
+
bookkeeping for each datum (its index in `links`, the ids of its ends, its
|
|
13
|
+
value) is kept beside it in a WeakMap, so the datum holds only the link's
|
|
14
|
+
own fields.
|
|
15
|
+
*/
|
|
16
|
+
import type { DataPoint } from "@d3plus/data";
|
|
17
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
18
|
+
/**
|
|
19
|
+
A link as accessors and tooltips receive it: the link's own fields, with
|
|
20
|
+
`source` and `target` set to the data of the nodes at its ends.
|
|
21
|
+
*/
|
|
22
|
+
export type LinkDatum = DataPoint & {
|
|
23
|
+
source: DataPoint;
|
|
24
|
+
target: DataPoint;
|
|
25
|
+
};
|
|
26
|
+
/** One end of a link: the node's datum, its index, and its id. */
|
|
27
|
+
export interface LinkEnd {
|
|
28
|
+
data: DataPoint;
|
|
29
|
+
i: number;
|
|
30
|
+
id: string;
|
|
31
|
+
/** The end's name, for an end with no row of its own to label it (a bare coordinate). */
|
|
32
|
+
label?: string;
|
|
33
|
+
}
|
|
34
|
+
/** The links of a chart, and each node's links by node id. */
|
|
35
|
+
export interface LinkGraph {
|
|
36
|
+
links: LinkDatum[];
|
|
37
|
+
/** Whether the links' values differ, so tooltips and labels report them. */
|
|
38
|
+
sized: boolean;
|
|
39
|
+
byNode: Map<string, LinkDatum[]>;
|
|
40
|
+
}
|
|
41
|
+
/** What the chart knows about a link datum. */
|
|
42
|
+
export interface LinkMeta {
|
|
43
|
+
/** The link's index in `links`. */
|
|
44
|
+
index: number;
|
|
45
|
+
/** The link's row in `links`. */
|
|
46
|
+
raw: DataPoint;
|
|
47
|
+
source: LinkEnd;
|
|
48
|
+
target: LinkEnd;
|
|
49
|
+
/** The keys of `raw` that name its ends. */
|
|
50
|
+
endKeys: string[];
|
|
51
|
+
/** The link's value (`linkSize` or `value`), when it is a number. */
|
|
52
|
+
value?: number;
|
|
53
|
+
graph?: LinkGraph;
|
|
54
|
+
}
|
|
55
|
+
type Predicate = (d: DataPoint, i: number) => boolean;
|
|
56
|
+
type NodeKey = (d: DataPoint, i: number) => string;
|
|
57
|
+
type Row = [string, string];
|
|
58
|
+
/** What the chart recorded for a link datum, if `d` is one. */
|
|
59
|
+
export declare function linkMeta(d: unknown): LinkMeta | undefined;
|
|
60
|
+
/** Whether `d` is a link datum. */
|
|
61
|
+
export declare function isLinkDatum(d: unknown): d is LinkDatum;
|
|
62
|
+
/**
|
|
63
|
+
The datum a link is drawn with: `raw`'s fields, with `source` and
|
|
64
|
+
`target` set to the data of the nodes at its ends.
|
|
65
|
+
@param raw The link's row in `links`.
|
|
66
|
+
@param source The node at its source end.
|
|
67
|
+
@param target The node at its target end.
|
|
68
|
+
@param index The link's index in `links`.
|
|
69
|
+
@param endKeys The keys of `raw` that name its ends.
|
|
70
|
+
*/
|
|
71
|
+
export declare function makeLinkDatum(raw: DataPoint, source: LinkEnd, target: LinkEnd, index: number, endKeys?: string[]): LinkDatum;
|
|
72
|
+
/**
|
|
73
|
+
Records a link's value (from `linkSize` or `value`) for its tooltip and
|
|
74
|
+
spoken label, and returns it.
|
|
75
|
+
*/
|
|
76
|
+
export declare function setLinkValue<T>(d: LinkDatum, value: T): T;
|
|
77
|
+
/**
|
|
78
|
+
Indexes a chart's links by node and stores the result on `viz.ctx.linkGraph`.
|
|
79
|
+
Each of `nodes` (including any without links) is recognized by its datum
|
|
80
|
+
from then on, so its tooltip can list its connections.
|
|
81
|
+
*/
|
|
82
|
+
export declare function publishLinkGraph(viz: VizInstance, links: LinkDatum[], nodes: LinkEnd[]): LinkGraph;
|
|
83
|
+
/**
|
|
84
|
+
Forgets every node `publishLinkGraph` recorded for a chart, so rows that
|
|
85
|
+
no longer end a link stop reading as nodes.
|
|
86
|
+
*/
|
|
87
|
+
export declare function forgetLinkNodes(viz: VizInstance): void;
|
|
88
|
+
/** The node id and graph recorded for a node datum, if `d` is one. */
|
|
89
|
+
export declare function linkNodeOf(viz: VizInstance, d: unknown): {
|
|
90
|
+
id: string;
|
|
91
|
+
graph: LinkGraph;
|
|
92
|
+
} | undefined;
|
|
93
|
+
/** Whether a locale code (`"ar-SA"`) names a language written right to left. */
|
|
94
|
+
export declare function rtlLocale(locale: unknown): boolean;
|
|
95
|
+
/**
|
|
96
|
+
The arrows a chart's tooltips point from a link's source to its target
|
|
97
|
+
with: `["→", "←"]`, mirrored to `["←", "→"]` when the chart's locale is
|
|
98
|
+
written right to left or the page's direction is (see `rtl`).
|
|
99
|
+
*/
|
|
100
|
+
export declare function linkArrows(viz: VizInstance): [string, string];
|
|
101
|
+
/** A link end's label, as its node's tooltip titles it. */
|
|
102
|
+
export declare function linkEndLabel(viz: VizInstance, end: LinkEnd): string;
|
|
103
|
+
/** A link's tooltip title: "Source → Target" ("Source ← Target" right to left). */
|
|
104
|
+
export declare function linkTooltipTitle(viz: VizInstance, d: LinkDatum): string;
|
|
105
|
+
/** A tooltip cell's text for one field value, or null for a value it skips. */
|
|
106
|
+
export declare function linkCellText(viz: VizInstance, v: unknown): string | null;
|
|
107
|
+
/**
|
|
108
|
+
A link's tooltip rows: its value (when the chart's links differ in value
|
|
109
|
+
and no field of the link already shows it), then each of the link's own
|
|
110
|
+
fields other than the ones naming its ends.
|
|
111
|
+
*/
|
|
112
|
+
export declare function linkTooltipRows(viz: VizInstance, d: LinkDatum): Row[];
|
|
113
|
+
/**
|
|
114
|
+
A link's spoken label: "Source to Target." When the chart's links differ
|
|
115
|
+
in value, its value follows: "Source to Target, 4."
|
|
116
|
+
*/
|
|
117
|
+
export declare function linkAriaLabel(viz: VizInstance, d: LinkDatum): string;
|
|
118
|
+
/**
|
|
119
|
+
What hovering a link highlights: the link and the nodes at its two ends.
|
|
120
|
+
Rows that aren't recorded nodes (legend entries) match by `nodeKey`.
|
|
121
|
+
*/
|
|
122
|
+
export declare function linkHighlight(viz: VizInstance, d: LinkDatum, nodeKey?: NodeKey): Predicate;
|
|
123
|
+
/**
|
|
124
|
+
What hovering a legend entry highlights: the nodes it stands for (one, or
|
|
125
|
+
every member of a merged entry, such as a cluster) and the links between
|
|
126
|
+
them. A row matches when every id it holds is one of the entry's, so the
|
|
127
|
+
entry matches itself.
|
|
128
|
+
*/
|
|
129
|
+
export declare function legendHighlight(viz: VizInstance, d: DataPoint, i: number): Predicate;
|
|
130
|
+
/**
|
|
131
|
+
A node's links in `graph`, the other end of each, and its direction,
|
|
132
|
+
strongest first. A link from the node to itself is `loop`, with the node
|
|
133
|
+
as its other end.
|
|
134
|
+
*/
|
|
135
|
+
export declare function nodeConnections(graph: LinkGraph, id: string): {
|
|
136
|
+
link: LinkDatum;
|
|
137
|
+
other: LinkEnd;
|
|
138
|
+
outgoing: boolean;
|
|
139
|
+
loop: boolean;
|
|
140
|
+
value?: number;
|
|
141
|
+
}[];
|
|
142
|
+
/**
|
|
143
|
+
What hovering a node highlights: the node, the nodes it links to, and the
|
|
144
|
+
links between them. Null when `d` isn't a recorded node. Rows that aren't
|
|
145
|
+
recorded nodes (legend entries) match by `nodeKey`.
|
|
146
|
+
*/
|
|
147
|
+
export declare function nodeHighlight(viz: VizInstance, d: DataPoint, nodeKey?: NodeKey): Predicate | null;
|
|
148
|
+
/**
|
|
149
|
+
How many links a node's tooltip lists: `nodeTooltipLinks` when it is a
|
|
150
|
+
number (`true` is 3, `false` none), else 3 when the links differ in value
|
|
151
|
+
and none when they don't.
|
|
152
|
+
*/
|
|
153
|
+
export declare function nodeTooltipLinkLimit(viz: VizInstance, graph: LinkGraph): number;
|
|
154
|
+
/** The arrow a node's tooltip marks a link from the node to itself with. */
|
|
155
|
+
export declare const LOOP_ARROW = "\u21BB";
|
|
156
|
+
/**
|
|
157
|
+
A node's tooltip rows: its number of connections (left out when its
|
|
158
|
+
degree takes its place) and the network measures `nodeTooltipStats`
|
|
159
|
+
lists (see `nodeStatRows`), then its strongest links ("→ Target" or "← Source", or "↻ Node" for a link to
|
|
160
|
+
itself, with the link's value when the links differ in value), up to
|
|
161
|
+
`nodeTooltipLinkLimit`. The arrows mirror right to left (see
|
|
162
|
+
`linkArrows`).
|
|
163
|
+
*/
|
|
164
|
+
export declare function nodeConnectionRows(viz: VizInstance, d: DataPoint): Row[];
|
|
165
|
+
/**
|
|
166
|
+
The node-link charts' default `tooltipConfig`: a link is titled
|
|
167
|
+
"Source → Target" and lists its value and fields; a node is titled by its
|
|
168
|
+
label and lists its connections.
|
|
169
|
+
*/
|
|
170
|
+
export declare function linkTooltipConfig(viz: VizInstance): {
|
|
171
|
+
title: (d: DataPoint, i: number) => string;
|
|
172
|
+
tbody: (d: DataPoint, i: number) => Row[];
|
|
173
|
+
};
|
|
174
|
+
/** The smallest stroke width a link's hit path takes, in pixels. */
|
|
175
|
+
export declare const LINK_HIT_WIDTH = 8;
|
|
176
|
+
/**
|
|
177
|
+
A transparent path over a link, wider than it, so thin links are easy to
|
|
178
|
+
point at. Keyboard navigation skips it (its key ends in `::hit`).
|
|
179
|
+
*/
|
|
180
|
+
export declare function linkHitPath(key: string, d: string, datum: LinkDatum, strokeWidth: unknown): {
|
|
181
|
+
type: "path";
|
|
182
|
+
key: string;
|
|
183
|
+
d: string;
|
|
184
|
+
datum: LinkDatum;
|
|
185
|
+
index: number;
|
|
186
|
+
paint: {
|
|
187
|
+
fill: string;
|
|
188
|
+
stroke: string;
|
|
189
|
+
strokeWidth: number;
|
|
190
|
+
};
|
|
191
|
+
};
|
|
192
|
+
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[];
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkLabel` on the node-link charts: a line of text at the middle of each
|
|
3
|
+
link, along it or level, on a pad of the chart's background so it reads
|
|
4
|
+
over the links. Along a curved link, the text and its pad follow the
|
|
5
|
+
curve. Labels that would cover a node or another label are left out, the
|
|
6
|
+
most prominent links' first. Labels are inert to the pointer and
|
|
7
|
+
keyboard, and dim with their link on hover.
|
|
8
|
+
*/
|
|
9
|
+
import type { SceneNode } from "@d3plus/render";
|
|
10
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
11
|
+
import type { LabelObstacles, LinkAnchor, LinkLabelBox } from "./linkLabelGeometry.js";
|
|
12
|
+
import type { Pt } from "./pathLabelGeometry.js";
|
|
13
|
+
/** `linkLabelConfig`'s defaults. */
|
|
14
|
+
export declare const LINK_LABEL_DEFAULTS: {
|
|
15
|
+
rotate: string;
|
|
16
|
+
fontSize: number;
|
|
17
|
+
padding: number;
|
|
18
|
+
backgroundOpacity: number;
|
|
19
|
+
minRadius: number;
|
|
20
|
+
};
|
|
21
|
+
/** The resolved `linkLabelConfig`. */
|
|
22
|
+
export interface LinkLabelSettings {
|
|
23
|
+
/** `"along"` runs text along its link (kept upright); `"horizontal"` keeps it level. */
|
|
24
|
+
rotate: "along" | "horizontal";
|
|
25
|
+
fontSize: number;
|
|
26
|
+
/** The pad around the text, in pixels. */
|
|
27
|
+
padding: number;
|
|
28
|
+
/** The opacity of the background pad. */
|
|
29
|
+
backgroundOpacity: number;
|
|
30
|
+
/** The tightest bend a curved label follows, as a radius in ems. */
|
|
31
|
+
minRadius: number;
|
|
32
|
+
/** The rest, as TextBox config (fontFamily, fontColor, fontWeight, …). */
|
|
33
|
+
text: Record<string, unknown>;
|
|
34
|
+
}
|
|
35
|
+
/** Reads `linkLabelConfig`, with its defaults for anything missing or invalid. */
|
|
36
|
+
export declare function linkLabelSettings(viz: VizInstance): LinkLabelSettings;
|
|
37
|
+
/**
|
|
38
|
+
A `linkLabel` value as text: a number abbreviated in the chart's locale,
|
|
39
|
+
a string as given, and nothing for anything else.
|
|
40
|
+
*/
|
|
41
|
+
export declare function linkLabelText(value: unknown, locale?: string): string;
|
|
42
|
+
/**
|
|
43
|
+
The boxes the lines of text scene nodes (such as a chart's node labels)
|
|
44
|
+
cover, each rotated with its node: about a line's glyphs, from 0.8em
|
|
45
|
+
above its baseline to 0.2em below.
|
|
46
|
+
@param nodes Scene nodes; text nodes inside groups are included.
|
|
47
|
+
*/
|
|
48
|
+
export declare function textLineBoxes(nodes: readonly SceneNode[]): LinkLabelBox[];
|
|
49
|
+
/** One drawn link a label may go on. */
|
|
50
|
+
export interface LinkLabelRequest {
|
|
51
|
+
/** The link's scene key; the label's is built from it. */
|
|
52
|
+
key: string;
|
|
53
|
+
/** The drawn link's datum, which the label carries so it dims with the link. */
|
|
54
|
+
link: object;
|
|
55
|
+
/** The link's position among the drawn links. */
|
|
56
|
+
i: number;
|
|
57
|
+
/** Where on the link the label goes, or null for nowhere. */
|
|
58
|
+
anchor: LinkAnchor | null;
|
|
59
|
+
/**
|
|
60
|
+
A curved link's centerline, between the edges of its nodes: an
|
|
61
|
+
`"along"` label follows it, centered where `anchor` falls on it (or
|
|
62
|
+
halfway along without one). A straight link needs none.
|
|
63
|
+
*/
|
|
64
|
+
path?: Pt[] | null;
|
|
65
|
+
/** Links with a larger priority (such as a wider stroke) get their label first. */
|
|
66
|
+
priority?: number;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
The labels for the drawn links, as scene nodes: for each link with
|
|
70
|
+
`linkLabel` text that fits, a group at the link's middle, rotated with
|
|
71
|
+
the link unless `linkLabelConfig.rotate` is `"horizontal"`, holding a pad
|
|
72
|
+
in the chart's background and the text in the chart's ink. Along a
|
|
73
|
+
curved link (one with a `path`), the text follows the curve over a pad
|
|
74
|
+
that follows it too.
|
|
75
|
+
@param obstacles The nodes labels stay clear of.
|
|
76
|
+
*/
|
|
77
|
+
export declare function emitLinkLabels(viz: VizInstance, requests: readonly LinkLabelRequest[], obstacles: LabelObstacles): SceneNode[];
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The stroke widths the node-link charts size their links between when
|
|
3
|
+
`linkSize` values differ.
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
The share of the smallest node's radius the heaviest link is drawn at
|
|
7
|
+
by default: a quarter of the node's width, so links read as weighted
|
|
8
|
+
lines beside their nodes rather than bands as wide as them, and a
|
|
9
|
+
heavy link's arrowhead (1.5× its stroke) stays narrower than the node.
|
|
10
|
+
*/
|
|
11
|
+
export declare const LINK_SIZE_SHARE = 0.5;
|
|
12
|
+
/**
|
|
13
|
+
The thinnest and widest link, in pixels, for links whose `linkSize`
|
|
14
|
+
values differ. The thinnest is `sizeMin` (1 when unset). The widest is
|
|
15
|
+
`sizeMax` when set, which also caps the thinnest; otherwise it is half
|
|
16
|
+
the smallest node's radius (`rMin`), and never thinner than the
|
|
17
|
+
thinnest.
|
|
18
|
+
*/
|
|
19
|
+
export declare function linkWidthRange(sizeMin: unknown, sizeMax: unknown, rMin: number): [number, number];
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Shortest-path measures of a network's nodes: betweenness (Brandes'
|
|
3
|
+
algorithm) and closeness, from one search per node. The graph is a list
|
|
4
|
+
of directed arcs; an undirected link is two arcs, one each way.
|
|
5
|
+
*/
|
|
6
|
+
/** One way along a link: from `source` to `target`, `length` steps long (default 1). */
|
|
7
|
+
export interface MeasureArc {
|
|
8
|
+
source: string;
|
|
9
|
+
target: string;
|
|
10
|
+
length?: number;
|
|
11
|
+
}
|
|
12
|
+
/** Each node's betweenness and closeness, both from 0 to 1. */
|
|
13
|
+
export interface NetworkMeasures {
|
|
14
|
+
betweenness: Map<string, number>;
|
|
15
|
+
closeness: Map<string, number>;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
Works out the measures one node's search at a time (see
|
|
19
|
+
`networkMeasures`), so the work can be spread over several turns.
|
|
20
|
+
*/
|
|
21
|
+
export interface MeasuresTask {
|
|
22
|
+
/**
|
|
23
|
+
Runs searches until `budget` milliseconds have passed (at least one),
|
|
24
|
+
and returns whether every node has been searched.
|
|
25
|
+
*/
|
|
26
|
+
step(budget?: number): boolean;
|
|
27
|
+
/** The measures, once `step` has returned `true`. */
|
|
28
|
+
result(): NetworkMeasures;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
A task working out each node's betweenness and closeness (see
|
|
32
|
+
`networkMeasures`), one node's search per unit of work.
|
|
33
|
+
@param nodes The node ids; arcs naming other ids are ignored.
|
|
34
|
+
@param arcs The directed arcs between them.
|
|
35
|
+
*/
|
|
36
|
+
export declare function measuresTask(nodes: string[], arcs: MeasureArc[]): MeasuresTask;
|
|
37
|
+
/**
|
|
38
|
+
Each node's betweenness and closeness.
|
|
39
|
+
|
|
40
|
+
Betweenness is the share of shortest paths between other pairs of nodes
|
|
41
|
+
that pass through the node, normalized by `(n - 1)(n - 2)` (the most a
|
|
42
|
+
node can have, as the center of a star), so it runs from 0 to 1.
|
|
43
|
+
|
|
44
|
+
Closeness is the inverse of the node's average distance to the nodes it
|
|
45
|
+
can reach, scaled by the share of the other nodes it can reach (Wasserman
|
|
46
|
+
and Faust's form, so a node in a small component isn't as close as one
|
|
47
|
+
linked to everything). It is 1 for a node one step from every other, and
|
|
48
|
+
0 for a node that reaches none. In a directed graph it reads distances
|
|
49
|
+
from the node along its arcs.
|
|
50
|
+
@param nodes The node ids; arcs naming other ids are ignored.
|
|
51
|
+
@param arcs The directed arcs between them.
|
|
52
|
+
*/
|
|
53
|
+
export declare function networkMeasures(nodes: string[], arcs: MeasureArc[]): NetworkMeasures;
|