@d3plus/core 4.9.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 +170 -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 +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 +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- 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 +17 -12
- 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/Funnel/index.js +2 -1
- 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/Gauge/index.js +2 -1
- 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 +60 -19
- 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 +37 -16
- 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/Matrix/index.js +3 -2
- 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 +93 -108
- 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 +7 -2
- 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 +66 -32
- 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/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- 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 +14 -4
- 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 +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- 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/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- 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 +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -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 +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- 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 +5 -5
- 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 +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- 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 +65 -30
- 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 +75 -77
- 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/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- 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/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- 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 +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- 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 +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- 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 +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- 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 +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- 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 +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- 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 +42 -15
- 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 +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- 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 +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- 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 +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- 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 +123 -0
- 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/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -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 +34 -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 +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -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 +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- 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 +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- 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 +67 -79
- 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/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -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 +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/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -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/Candlestick/aggregate.d.ts +6 -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/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -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 +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- 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 +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -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/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- 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/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -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/facet/facetData.d.ts +1 -1
- 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 +13 -1
- 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/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -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/features.d.ts +8 -0
- 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 +19 -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 +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- 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 +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -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/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- 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/missingFields.d.ts +57 -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/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -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 +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- 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/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -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 +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- 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/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -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 +2 -8
- 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/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -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 +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- 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,72 @@
|
|
|
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
|
+
*/ import { colorAssign } from "@d3plus/color";
|
|
6
|
+
import { color } from "d3-color";
|
|
7
|
+
import { fieldAccessor } from "../../utils/fieldAccessor.js";
|
|
8
|
+
import { linkedColorDefaults } from "../viz/linkGroup.js";
|
|
9
|
+
import { colorScaleColor, isScaleValue, noteLinkValue } from "./colorScaleValue.js";
|
|
10
|
+
import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
|
|
11
|
+
import { linkMeta } from "./linkInteraction.js";
|
|
12
|
+
/**
|
|
13
|
+
Stores a `linkColor` value: `"source"` and `"target"` as given, a falsy
|
|
14
|
+
value as `false`, a function as given, and any other string as a key
|
|
15
|
+
read from each link.
|
|
16
|
+
*/ export function coerceLinkColor(value) {
|
|
17
|
+
if (!value) return false;
|
|
18
|
+
if (value === "source" || value === "target" || typeof value === "function") return value;
|
|
19
|
+
return fieldAccessor(value);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
The datum a drawn link carries (see `makeLinkDatum`), or the link itself
|
|
23
|
+
when it has none, and the link's index in `links` (else `i`).
|
|
24
|
+
*/ export function linkRow(link, i) {
|
|
25
|
+
const row = link.datum ?? link;
|
|
26
|
+
return {
|
|
27
|
+
row,
|
|
28
|
+
index: linkMeta(row)?.index ?? i
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
The color a link's value gives it: a number through the chart's
|
|
33
|
+
colorScale, a string as a literal color when it parses as one or as a
|
|
34
|
+
category in the chart's categorical palette (the way `color` colors
|
|
35
|
+
nodes), and nothing for any other value.
|
|
36
|
+
*/ export function linkValueColor(viz, value) {
|
|
37
|
+
if (isScaleValue(value)) {
|
|
38
|
+
const c = colorScaleColor(viz, value);
|
|
39
|
+
return typeof c === "string" ? c : undefined;
|
|
40
|
+
}
|
|
41
|
+
if (typeof value !== "string" || value === "") return undefined;
|
|
42
|
+
if (color(value)) return value;
|
|
43
|
+
return colorAssign(value, linkedColorDefaults(viz));
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
Builds the chart's link stroke resolver for one draw: given a link's
|
|
47
|
+
datum (and its drawn ends, for their shape kinds), the stroke
|
|
48
|
+
`linkColor` gives it, or undefined to keep the link's
|
|
49
|
+
`shapeConfig.Path` stroke. Links colored by number are noted for the
|
|
50
|
+
colorScale.
|
|
51
|
+
*/ export function linkColorResolver(viz) {
|
|
52
|
+
const setting = viz.schema.linkColor;
|
|
53
|
+
if (!setting) return ()=>undefined;
|
|
54
|
+
if (setting === "source" || setting === "target") {
|
|
55
|
+
const configs = new Map();
|
|
56
|
+
return (datum, drawn)=>{
|
|
57
|
+
const end = linkMeta(datum)?.[setting];
|
|
58
|
+
if (!end) return undefined;
|
|
59
|
+
const kind = drawn?.[setting]?.shape;
|
|
60
|
+
const shape = typeof kind === "string" ? kind : "Circle";
|
|
61
|
+
if (!configs.has(shape)) configs.set(shape, shapeConfigFor(viz, shape));
|
|
62
|
+
const fill = resolveAccessor(configs.get(shape).fill, end.data, end.i);
|
|
63
|
+
return typeof fill === "string" ? fill : undefined;
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
if (typeof setting !== "function") return ()=>undefined;
|
|
67
|
+
return (datum)=>{
|
|
68
|
+
const value = setting(datum, linkMeta(datum)?.index ?? 0);
|
|
69
|
+
if (isScaleValue(value)) noteLinkValue(viz, datum, value);
|
|
70
|
+
return linkValueColor(viz, value);
|
|
71
|
+
};
|
|
72
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
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
|
+
*/ import { optionalAccessor } from "../viz/vizFields.js";
|
|
6
|
+
import { EDGE_BUNDLE_DEFAULTS } from "./edgeBundling.js";
|
|
7
|
+
import { coerceLinkColor } from "./linkColor.js";
|
|
8
|
+
import { LINK_LABEL_DEFAULTS } from "./linkLabels.js";
|
|
9
|
+
/** The `linkColor`, `linkLabel`, and `linkLabelConfig` fields. */ export function linkStyleFields() {
|
|
10
|
+
return [
|
|
11
|
+
/**
|
|
12
|
+
Colors each link: `"source"` or `"target"` takes that end node's
|
|
13
|
+
color, and a key or accessor function reads a value from each link
|
|
14
|
+
(receiving the link and its index in `links`). A number is colored
|
|
15
|
+
on the chart's colorScale, which then shows the links' values; a
|
|
16
|
+
string is a color when it parses as one, or else a category in the
|
|
17
|
+
chart's palette. `false` (the default) draws every link in the
|
|
18
|
+
theme's link gray.
|
|
19
|
+
@type {false | "source" | "target" | string | function}
|
|
20
|
+
*/ {
|
|
21
|
+
key: "linkColor",
|
|
22
|
+
default: false,
|
|
23
|
+
coerce: coerceLinkColor
|
|
24
|
+
},
|
|
25
|
+
/**
|
|
26
|
+
Text drawn at the middle of each link: a key or accessor function
|
|
27
|
+
(receiving the link and its index in `links`). Numbers are
|
|
28
|
+
abbreviated in the chart's locale. Labels that would cover a node
|
|
29
|
+
or another label are hidden. Defaults to none.
|
|
30
|
+
@type {string | function}
|
|
31
|
+
*/ {
|
|
32
|
+
key: "linkLabel",
|
|
33
|
+
coerce: optionalAccessor
|
|
34
|
+
},
|
|
35
|
+
/**
|
|
36
|
+
Styles the link labels: `rotate`, `"along"` (the default) to run
|
|
37
|
+
text along its link, kept upright, or `"horizontal"`; `fontSize`
|
|
38
|
+
(10); `padding`, the pad around the text (2); `backgroundOpacity`,
|
|
39
|
+
the opacity of that pad in the chart's background color (0.85);
|
|
40
|
+
`minRadius`, the tightest bend a curved label follows, as a radius
|
|
41
|
+
in ems (2); and any other TextBox setting, such as `fontColor`,
|
|
42
|
+
`fontFamily`, or `fontWeight`.
|
|
43
|
+
*/ {
|
|
44
|
+
key: "linkLabelConfig",
|
|
45
|
+
merge: true,
|
|
46
|
+
default: {
|
|
47
|
+
...LINK_LABEL_DEFAULTS
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
];
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
The `linkSizeMax` field: the widest link, in pixels, when `linkSize`
|
|
54
|
+
values differ. `fallback` is the chart's default; without one the
|
|
55
|
+
chart works the width out (see `linkWidthRange`).
|
|
56
|
+
*/ export function linkSizeMaxField(fallback) {
|
|
57
|
+
return fallback === undefined ? {
|
|
58
|
+
key: "linkSizeMax"
|
|
59
|
+
} : {
|
|
60
|
+
key: "linkSizeMax",
|
|
61
|
+
default: fallback
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
/** The `linkBundle` and `linkBundleConfig` fields (Network and Geomap). */ export function linkBundleFields() {
|
|
65
|
+
return [
|
|
66
|
+
/**
|
|
67
|
+
Bundles the links: links running the same way near each other are
|
|
68
|
+
drawn pulled together, so the main flows read through the clutter.
|
|
69
|
+
Defaults to `false`.
|
|
70
|
+
@type {boolean}
|
|
71
|
+
*/ {
|
|
72
|
+
key: "linkBundle",
|
|
73
|
+
default: false
|
|
74
|
+
},
|
|
75
|
+
/**
|
|
76
|
+
Tunes `linkBundle`: `strength` (0.85), `cycles` (6), `iterations`
|
|
77
|
+
(50), `compatibility` (0.4), and `smoothing` (true).
|
|
78
|
+
*/ {
|
|
79
|
+
key: "linkBundleConfig",
|
|
80
|
+
merge: true,
|
|
81
|
+
default: {
|
|
82
|
+
...EDGE_BUNDLE_DEFAULTS
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
];
|
|
86
|
+
}
|
|
@@ -0,0 +1,118 @@
|
|
|
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
|
+
*/ import { zoomToNodeBounds } from "../Network/graph.js";
|
|
8
|
+
import { surfaceOrigin } from "../viz/pointTooltipAnchor.js";
|
|
9
|
+
import { chartBounds } from "./chartGeometry.js";
|
|
10
|
+
import { linkHighlight, linkMeta } from "./linkInteraction.js";
|
|
11
|
+
/** The id a focused link sets on `viz._focus`. */ export function linkFocusId(d) {
|
|
12
|
+
return `link:${linkMeta(d)?.index}`;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
The box around a link's two ends, from the chart's laid-out nodes
|
|
16
|
+
(`viz.ctx.nodeLookup` records with `x`, `y`, and `r`), or null when they
|
|
17
|
+
aren't laid out that way.
|
|
18
|
+
*/ export function linkEndsBox(viz, d) {
|
|
19
|
+
const meta = linkMeta(d);
|
|
20
|
+
const lookup = viz.ctx.nodeLookup;
|
|
21
|
+
if (!meta || !lookup) return null;
|
|
22
|
+
const ends = [
|
|
23
|
+
meta.source.id,
|
|
24
|
+
meta.target.id
|
|
25
|
+
].map((id)=>lookup[id]);
|
|
26
|
+
const boxes = [];
|
|
27
|
+
for (const n of ends){
|
|
28
|
+
if (!n || typeof n.x !== "number" || typeof n.y !== "number") return null;
|
|
29
|
+
const r = typeof n.r === "number" ? n.r : 0;
|
|
30
|
+
boxes.push([
|
|
31
|
+
[
|
|
32
|
+
n.x - r,
|
|
33
|
+
n.y - r
|
|
34
|
+
],
|
|
35
|
+
[
|
|
36
|
+
n.x + r,
|
|
37
|
+
n.y + r
|
|
38
|
+
]
|
|
39
|
+
]);
|
|
40
|
+
}
|
|
41
|
+
return [
|
|
42
|
+
[
|
|
43
|
+
Math.min(boxes[0][0][0], boxes[1][0][0]),
|
|
44
|
+
Math.min(boxes[0][0][1], boxes[1][0][1])
|
|
45
|
+
],
|
|
46
|
+
[
|
|
47
|
+
Math.max(boxes[0][1][0], boxes[1][1][0]),
|
|
48
|
+
Math.max(boxes[0][1][1], boxes[1][1][1])
|
|
49
|
+
]
|
|
50
|
+
];
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
Clears a click focus: the active marks, and the zoom where the chart
|
|
54
|
+
zooms. Returns whether there was a focus to clear.
|
|
55
|
+
*/ export function clearLinkFocus(viz) {
|
|
56
|
+
if (viz._focus === undefined) return false;
|
|
57
|
+
viz.active?.(false);
|
|
58
|
+
viz._focus = undefined;
|
|
59
|
+
viz._zoomToBounds?.(null);
|
|
60
|
+
return true;
|
|
61
|
+
}
|
|
62
|
+
const boundSurfaces = new WeakSet();
|
|
63
|
+
/**
|
|
64
|
+
Routes clicks on the chart's own outer `<svg>` (the empty space around an
|
|
65
|
+
SVG scene, which only takes the pointer over what it paints) to
|
|
66
|
+
`viz._backgroundClick`. Clicks on marks, on the chart's chrome, or on a
|
|
67
|
+
zoom surface's background land on other elements and are left alone; the
|
|
68
|
+
Canvas renderer reports its empty clicks itself.
|
|
69
|
+
*/ export function bindSvgBackgroundClick(viz) {
|
|
70
|
+
const outer = viz._select?.node?.();
|
|
71
|
+
if (!outer || typeof outer.addEventListener !== "function") return;
|
|
72
|
+
if (boundSurfaces.has(outer)) return;
|
|
73
|
+
boundSurfaces.add(outer);
|
|
74
|
+
outer.addEventListener("click", (e)=>{
|
|
75
|
+
if (e.target !== outer) return;
|
|
76
|
+
const origin = surfaceOrigin(viz);
|
|
77
|
+
const { clientX, clientY } = e;
|
|
78
|
+
viz._backgroundClick?.([
|
|
79
|
+
clientX - origin.left,
|
|
80
|
+
clientY - origin.top
|
|
81
|
+
]);
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
Focuses a clicked link: it and the nodes at its ends stay bright, the
|
|
86
|
+
rest dims, and a chart that zooms zooms to `box`. Clicking the focused
|
|
87
|
+
link again clears the focus. Rows that aren't recorded nodes (legend
|
|
88
|
+
entries) match by `nodeKey`.
|
|
89
|
+
*/ export function focusLink(viz, d, { nodeKey, box } = {}) {
|
|
90
|
+
viz._tooltipClass?.data([]).render();
|
|
91
|
+
const id = linkFocusId(d);
|
|
92
|
+
if (viz._focus === id) {
|
|
93
|
+
clearLinkFocus(viz);
|
|
94
|
+
return;
|
|
95
|
+
}
|
|
96
|
+
viz.hover?.(false);
|
|
97
|
+
viz.active?.(linkHighlight(viz, d, nodeKey));
|
|
98
|
+
viz._focus = id;
|
|
99
|
+
bindSvgBackgroundClick(viz);
|
|
100
|
+
if (box && viz._zoomToBounds) zoomToNodeBounds(viz, [
|
|
101
|
+
box[0][0],
|
|
102
|
+
box[1][0]
|
|
103
|
+
], [
|
|
104
|
+
box[0][1],
|
|
105
|
+
box[1][1]
|
|
106
|
+
]);
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
Clears the chart's click focus when a click lands on no mark within its
|
|
110
|
+
chart area (`viz._backgroundClick`, given the click's point on the
|
|
111
|
+
chart's surface).
|
|
112
|
+
*/ export function installFocusBackgroundClick(viz) {
|
|
113
|
+
viz._backgroundClick = ([x, y])=>{
|
|
114
|
+
const { width, height } = chartBounds(viz);
|
|
115
|
+
const { left, top } = viz._margin;
|
|
116
|
+
if (x >= left && x <= left + width && y >= top && y <= top + height) clearLinkFocus(viz);
|
|
117
|
+
};
|
|
118
|
+
}
|
|
@@ -0,0 +1,312 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Link interaction shared by the node-link charts (Network, Rings, Sankey,
|
|
3
|
+
ArcDiagram): the datum each link is drawn with, its tooltip and spoken
|
|
4
|
+
label, what hovering a link or a node highlights, and the connections a
|
|
5
|
+
node's tooltip lists.
|
|
6
|
+
|
|
7
|
+
A link's datum is its row from `links`, with `source` and `target`
|
|
8
|
+
replaced by the data of the nodes they name. `linkSize`, `value`,
|
|
9
|
+
`shapeConfig` functions, arrow accessors, and the tooltip all receive it,
|
|
10
|
+
so they read node fields directly (`d.source.name`). The chart's
|
|
11
|
+
bookkeeping for each datum (its index in `links`, the ids of its ends, its
|
|
12
|
+
value) is kept beside it in a WeakMap, so the datum holds only the link's
|
|
13
|
+
own fields.
|
|
14
|
+
*/ import { rtl } from "@d3plus/dom";
|
|
15
|
+
import { formatAbbreviate } from "@d3plus/format";
|
|
16
|
+
const metas = new WeakMap();
|
|
17
|
+
const nodeEntries = new WeakMap();
|
|
18
|
+
/** What the chart recorded for a link datum, if `d` is one. */ export function linkMeta(d) {
|
|
19
|
+
return d && typeof d === "object" ? metas.get(d) : undefined;
|
|
20
|
+
}
|
|
21
|
+
/** Whether `d` is a link datum. */ export function isLinkDatum(d) {
|
|
22
|
+
return linkMeta(d) !== undefined;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
The datum a link is drawn with: `raw`'s fields, with `source` and
|
|
26
|
+
`target` set to the data of the nodes at its ends.
|
|
27
|
+
@param raw The link's row in `links`.
|
|
28
|
+
@param source The node at its source end.
|
|
29
|
+
@param target The node at its target end.
|
|
30
|
+
@param index The link's index in `links`.
|
|
31
|
+
@param endKeys The keys of `raw` that name its ends.
|
|
32
|
+
*/ export function makeLinkDatum(raw, source, target, index, endKeys = [
|
|
33
|
+
"source",
|
|
34
|
+
"target"
|
|
35
|
+
]) {
|
|
36
|
+
const datum = {
|
|
37
|
+
...raw,
|
|
38
|
+
source: source.data,
|
|
39
|
+
target: target.data
|
|
40
|
+
};
|
|
41
|
+
metas.set(datum, {
|
|
42
|
+
index,
|
|
43
|
+
raw,
|
|
44
|
+
source,
|
|
45
|
+
target,
|
|
46
|
+
endKeys
|
|
47
|
+
});
|
|
48
|
+
return datum;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
Records a link's value (from `linkSize` or `value`) for its tooltip and
|
|
52
|
+
spoken label, and returns it.
|
|
53
|
+
*/ export function setLinkValue(d, value) {
|
|
54
|
+
const meta = linkMeta(d);
|
|
55
|
+
const n = typeof value === "number" ? value : Number(value);
|
|
56
|
+
if (meta && value !== null && value !== "" && Number.isFinite(n)) meta.value = n;
|
|
57
|
+
return value;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
Indexes a chart's links by node and stores the result on `viz.ctx.linkGraph`.
|
|
61
|
+
Each of `nodes` (including any without links) is recognized by its datum
|
|
62
|
+
from then on, so its tooltip can list its connections.
|
|
63
|
+
*/ export function publishLinkGraph(viz, links, nodes) {
|
|
64
|
+
const values = new Set(links.map((l)=>linkMeta(l)?.value));
|
|
65
|
+
const byNode = new Map(nodes.map((n)=>[
|
|
66
|
+
n.id,
|
|
67
|
+
[]
|
|
68
|
+
]));
|
|
69
|
+
const graph = {
|
|
70
|
+
links,
|
|
71
|
+
sized: values.size > 1,
|
|
72
|
+
byNode
|
|
73
|
+
};
|
|
74
|
+
for (const link of links){
|
|
75
|
+
const meta = linkMeta(link);
|
|
76
|
+
meta.graph = graph;
|
|
77
|
+
const ids = new Set([
|
|
78
|
+
meta.source.id,
|
|
79
|
+
meta.target.id
|
|
80
|
+
]);
|
|
81
|
+
for (const id of ids){
|
|
82
|
+
if (!byNode.has(id)) byNode.set(id, []);
|
|
83
|
+
byNode.get(id).push(link);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
let entries = nodeEntries.get(viz);
|
|
87
|
+
if (!entries) nodeEntries.set(viz, entries = new WeakMap());
|
|
88
|
+
for (const n of nodes)if (n.data && typeof n.data === "object") entries.set(n.data, {
|
|
89
|
+
id: n.id,
|
|
90
|
+
graph
|
|
91
|
+
});
|
|
92
|
+
viz.ctx.linkGraph = graph;
|
|
93
|
+
return graph;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
Forgets every node `publishLinkGraph` recorded for a chart, so rows that
|
|
97
|
+
no longer end a link stop reading as nodes.
|
|
98
|
+
*/ export function forgetLinkNodes(viz) {
|
|
99
|
+
nodeEntries.delete(viz);
|
|
100
|
+
}
|
|
101
|
+
/** The node id and graph recorded for a node datum, if `d` is one. */ export function linkNodeOf(viz, d) {
|
|
102
|
+
if (!d || typeof d !== "object") return undefined;
|
|
103
|
+
return nodeEntries.get(viz)?.get(d);
|
|
104
|
+
}
|
|
105
|
+
/** Languages written right to left, by their primary language subtag. */ const RTL_LANGUAGES = new Set([
|
|
106
|
+
"ar",
|
|
107
|
+
"dv",
|
|
108
|
+
"fa",
|
|
109
|
+
"he",
|
|
110
|
+
"ps",
|
|
111
|
+
"ur",
|
|
112
|
+
"yi"
|
|
113
|
+
]);
|
|
114
|
+
/** Whether a locale code (`"ar-SA"`) names a language written right to left. */ export function rtlLocale(locale) {
|
|
115
|
+
const language = `${locale ?? ""}`.split(/[-_]/)[0].toLowerCase();
|
|
116
|
+
return RTL_LANGUAGES.has(language);
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
The arrows a chart's tooltips point from a link's source to its target
|
|
120
|
+
with: `["→", "←"]`, mirrored to `["←", "→"]` when the chart's locale is
|
|
121
|
+
written right to left or the page's direction is (see `rtl`).
|
|
122
|
+
*/ export function linkArrows(viz) {
|
|
123
|
+
const mirrored = rtlLocale(viz.schema.locale) || typeof document !== "undefined" && !!document.body && rtl();
|
|
124
|
+
return mirrored ? [
|
|
125
|
+
"←",
|
|
126
|
+
"→"
|
|
127
|
+
] : [
|
|
128
|
+
"→",
|
|
129
|
+
"←"
|
|
130
|
+
];
|
|
131
|
+
}
|
|
132
|
+
/** A link end's label, as its node's tooltip titles it. */ export function linkEndLabel(viz, end) {
|
|
133
|
+
if (end.label !== undefined) return end.label;
|
|
134
|
+
return `${viz._drawLabel(end.data, end.i) ?? end.id}`;
|
|
135
|
+
}
|
|
136
|
+
/** A link's tooltip title: "Source → Target" ("Source ← Target" right to left). */ export function linkTooltipTitle(viz, d) {
|
|
137
|
+
const meta = linkMeta(d);
|
|
138
|
+
if (!meta) return "";
|
|
139
|
+
const [forward] = linkArrows(viz);
|
|
140
|
+
return `${linkEndLabel(viz, meta.source)} ${forward} ${linkEndLabel(viz, meta.target)}`;
|
|
141
|
+
}
|
|
142
|
+
/** A tooltip cell's text for one field value, or null for a value it skips. */ export function linkCellText(viz, v) {
|
|
143
|
+
const locale = viz.schema.locale;
|
|
144
|
+
if (typeof v === "number") return Number.isFinite(v) ? formatAbbreviate(v, locale) : null;
|
|
145
|
+
if (typeof v === "string") return v;
|
|
146
|
+
if (typeof v === "boolean") return `${v}`;
|
|
147
|
+
if (v instanceof Date && !isNaN(v.getTime())) return v.toLocaleDateString(locale);
|
|
148
|
+
return null;
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
A link's tooltip rows: its value (when the chart's links differ in value
|
|
152
|
+
and no field of the link already shows it), then each of the link's own
|
|
153
|
+
fields other than the ones naming its ends.
|
|
154
|
+
*/ export function linkTooltipRows(viz, d) {
|
|
155
|
+
const meta = linkMeta(d);
|
|
156
|
+
if (!meta) return [];
|
|
157
|
+
const fields = [];
|
|
158
|
+
let shown = false;
|
|
159
|
+
for (const [key, v] of Object.entries(meta.raw)){
|
|
160
|
+
if (meta.endKeys.includes(key) || key.startsWith("__")) continue;
|
|
161
|
+
const text = linkCellText(viz, v);
|
|
162
|
+
if (text === null) continue;
|
|
163
|
+
if (v === meta.value) shown = true;
|
|
164
|
+
fields.push([
|
|
165
|
+
key,
|
|
166
|
+
text
|
|
167
|
+
]);
|
|
168
|
+
}
|
|
169
|
+
const rows = [];
|
|
170
|
+
if (meta.graph?.sized && meta.value !== undefined && !shown) rows.push([
|
|
171
|
+
viz.schema.translate("Value"),
|
|
172
|
+
linkCellText(viz, meta.value)
|
|
173
|
+
]);
|
|
174
|
+
return rows.concat(fields);
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
A link's spoken label: "Source to Target." When the chart's links differ
|
|
178
|
+
in value, its value follows: "Source to Target, 4."
|
|
179
|
+
*/ export function linkAriaLabel(viz, d) {
|
|
180
|
+
const meta = linkMeta(d);
|
|
181
|
+
if (!meta) return "";
|
|
182
|
+
const value = meta.graph?.sized && meta.value !== undefined ? `, ${meta.value}` : "";
|
|
183
|
+
return `${linkEndLabel(viz, meta.source)} ${viz.schema.translate("to")} ${linkEndLabel(viz, meta.target)}${value}.`;
|
|
184
|
+
}
|
|
185
|
+
/**
|
|
186
|
+
What hovering a link highlights: the link and the nodes at its two ends.
|
|
187
|
+
Rows that aren't recorded nodes (legend entries) match by `nodeKey`.
|
|
188
|
+
*/ export function linkHighlight(viz, d, nodeKey) {
|
|
189
|
+
const meta = linkMeta(d);
|
|
190
|
+
const ids = new Set([
|
|
191
|
+
meta.source.id,
|
|
192
|
+
meta.target.id
|
|
193
|
+
]);
|
|
194
|
+
return (h, hi)=>{
|
|
195
|
+
const m = linkMeta(h);
|
|
196
|
+
if (m) return m.index === meta.index;
|
|
197
|
+
const id = linkNodeOf(viz, h)?.id ?? nodeKey?.(h, hi);
|
|
198
|
+
return id !== undefined && ids.has(`${id}`);
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
A node's links in `graph`, the other end of each, and its direction,
|
|
203
|
+
strongest first. A link from the node to itself is `loop`, with the node
|
|
204
|
+
as its other end.
|
|
205
|
+
*/ export function nodeConnections(graph, id) {
|
|
206
|
+
return (graph.byNode.get(id) ?? []).map((link)=>{
|
|
207
|
+
const meta = linkMeta(link);
|
|
208
|
+
const outgoing = meta.source.id === id;
|
|
209
|
+
return {
|
|
210
|
+
link,
|
|
211
|
+
other: outgoing ? meta.target : meta.source,
|
|
212
|
+
outgoing,
|
|
213
|
+
loop: meta.source.id === meta.target.id,
|
|
214
|
+
value: meta.value,
|
|
215
|
+
index: meta.index
|
|
216
|
+
};
|
|
217
|
+
}).sort((a, b)=>(b.value ?? -Infinity) - (a.value ?? -Infinity) || a.index - b.index).map(({ link, other, outgoing, loop, value })=>({
|
|
218
|
+
link,
|
|
219
|
+
other,
|
|
220
|
+
outgoing,
|
|
221
|
+
loop,
|
|
222
|
+
value
|
|
223
|
+
}));
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
What hovering a node highlights: the node, the nodes it links to, and the
|
|
227
|
+
links between them. Null when `d` isn't a recorded node. Rows that aren't
|
|
228
|
+
recorded nodes (legend entries) match by `nodeKey`.
|
|
229
|
+
*/ export function nodeHighlight(viz, d, nodeKey) {
|
|
230
|
+
const entry = linkNodeOf(viz, d);
|
|
231
|
+
if (!entry) return null;
|
|
232
|
+
const links = nodeConnections(entry.graph, entry.id);
|
|
233
|
+
const ids = new Set([
|
|
234
|
+
entry.id,
|
|
235
|
+
...links.map((c)=>c.other.id)
|
|
236
|
+
]);
|
|
237
|
+
const indices = new Set(links.map((c)=>linkMeta(c.link).index));
|
|
238
|
+
return (h, hi)=>{
|
|
239
|
+
const m = linkMeta(h);
|
|
240
|
+
if (m) return indices.has(m.index);
|
|
241
|
+
const id = linkNodeOf(viz, h)?.id ?? nodeKey?.(h, hi);
|
|
242
|
+
return id !== undefined && ids.has(`${id}`);
|
|
243
|
+
};
|
|
244
|
+
}
|
|
245
|
+
/**
|
|
246
|
+
How many links a node's tooltip lists: `nodeTooltipLinks` when it is a
|
|
247
|
+
number (`true` is 3, `false` none), else 3 when the links differ in value
|
|
248
|
+
and none when they don't.
|
|
249
|
+
*/ export function nodeTooltipLinkLimit(viz, graph) {
|
|
250
|
+
const limit = viz.schema.nodeTooltipLinks;
|
|
251
|
+
if (limit === false) return 0;
|
|
252
|
+
if (limit === true) return 3;
|
|
253
|
+
if (typeof limit === "number" && Number.isFinite(limit)) return Math.max(0, Math.floor(limit));
|
|
254
|
+
return graph.sized ? 3 : 0;
|
|
255
|
+
}
|
|
256
|
+
/** The arrow a node's tooltip marks a link from the node to itself with. */ export const LOOP_ARROW = "↻";
|
|
257
|
+
/**
|
|
258
|
+
A node's tooltip rows: its number of connections, then its strongest
|
|
259
|
+
links ("→ Target" or "← Source", or "↻ Node" for a link to itself, with
|
|
260
|
+
the link's value when the links differ in value), up to
|
|
261
|
+
`nodeTooltipLinkLimit`. The arrows mirror right to left (see
|
|
262
|
+
`linkArrows`).
|
|
263
|
+
*/ export function nodeConnectionRows(viz, d) {
|
|
264
|
+
const entry = linkNodeOf(viz, d);
|
|
265
|
+
if (!entry) return [];
|
|
266
|
+
const { graph, id } = entry;
|
|
267
|
+
const connections = nodeConnections(graph, id);
|
|
268
|
+
const rows = [
|
|
269
|
+
[
|
|
270
|
+
viz.schema.translate("Connections"),
|
|
271
|
+
`${connections.length}`
|
|
272
|
+
]
|
|
273
|
+
];
|
|
274
|
+
const [forward, back] = linkArrows(viz);
|
|
275
|
+
for (const c of connections.slice(0, nodeTooltipLinkLimit(viz, graph))){
|
|
276
|
+
const value = graph.sized && c.value !== undefined ? linkCellText(viz, c.value) : "";
|
|
277
|
+
rows.push([
|
|
278
|
+
`${c.loop ? LOOP_ARROW : c.outgoing ? forward : back} ${linkEndLabel(viz, c.other)}`,
|
|
279
|
+
value
|
|
280
|
+
]);
|
|
281
|
+
}
|
|
282
|
+
return rows;
|
|
283
|
+
}
|
|
284
|
+
/**
|
|
285
|
+
The node-link charts' default `tooltipConfig`: a link is titled
|
|
286
|
+
"Source → Target" and lists its value and fields; a node is titled by its
|
|
287
|
+
label and lists its connections.
|
|
288
|
+
*/ export function linkTooltipConfig(viz) {
|
|
289
|
+
return {
|
|
290
|
+
title: (d, i)=>isLinkDatum(d) ? linkTooltipTitle(viz, d) : viz._drawLabel(d, typeof d.i === "number" ? d.i : i),
|
|
291
|
+
tbody: (d)=>isLinkDatum(d) ? linkTooltipRows(viz, d) : nodeConnectionRows(viz, d)
|
|
292
|
+
};
|
|
293
|
+
}
|
|
294
|
+
/** The smallest stroke width a link's hit path takes, in pixels. */ export const LINK_HIT_WIDTH = 8;
|
|
295
|
+
/**
|
|
296
|
+
A transparent path over a link, wider than it, so thin links are easy to
|
|
297
|
+
point at. Keyboard navigation skips it (its key ends in `::hit`).
|
|
298
|
+
*/ export function linkHitPath(key, d, datum, strokeWidth) {
|
|
299
|
+
const width = typeof strokeWidth === "number" ? strokeWidth : 1;
|
|
300
|
+
return {
|
|
301
|
+
type: "path",
|
|
302
|
+
key: `${key}::hit`,
|
|
303
|
+
d,
|
|
304
|
+
datum,
|
|
305
|
+
index: linkMeta(datum)?.index ?? 0,
|
|
306
|
+
paint: {
|
|
307
|
+
fill: "none",
|
|
308
|
+
stroke: "transparent",
|
|
309
|
+
strokeWidth: Math.max(LINK_HIT_WIDTH, width + 4)
|
|
310
|
+
}
|
|
311
|
+
};
|
|
312
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
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
|
+
One unique key per base key, in order: the first link with a base keeps
|
|
6
|
+
it, and each later one adds its order among the links sharing that base
|
|
7
|
+
(`-1`, `-2`, …), skipping any key already taken. The same bases give the
|
|
8
|
+
same keys on every call.
|
|
9
|
+
*/ export function uniqueLinkKeys(bases) {
|
|
10
|
+
const taken = new Set();
|
|
11
|
+
const seen = new Map();
|
|
12
|
+
return bases.map((base)=>{
|
|
13
|
+
let n = seen.get(base) ?? 0;
|
|
14
|
+
let key = n ? `${base}-${n}` : base;
|
|
15
|
+
while(taken.has(key))key = `${base}-${++n}`;
|
|
16
|
+
seen.set(base, n + 1);
|
|
17
|
+
taken.add(key);
|
|
18
|
+
return key;
|
|
19
|
+
});
|
|
20
|
+
}
|