@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,364 @@
|
|
|
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
|
+
*/ import { rtl } from "@d3plus/dom";
|
|
16
|
+
import { formatAbbreviate } from "@d3plus/format";
|
|
17
|
+
import { colorCategory } from "./legendCategory.js";
|
|
18
|
+
import { nodeStatRows, scheduleNodeStats } from "./nodeStats.js";
|
|
19
|
+
const metas = new WeakMap();
|
|
20
|
+
const nodeEntries = new WeakMap();
|
|
21
|
+
/** What the chart recorded for a link datum, if `d` is one. */ export function linkMeta(d) {
|
|
22
|
+
return d && typeof d === "object" ? metas.get(d) : undefined;
|
|
23
|
+
}
|
|
24
|
+
/** Whether `d` is a link datum. */ export function isLinkDatum(d) {
|
|
25
|
+
return linkMeta(d) !== undefined;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
The datum a link is drawn with: `raw`'s fields, with `source` and
|
|
29
|
+
`target` set to the data of the nodes at its ends.
|
|
30
|
+
@param raw The link's row in `links`.
|
|
31
|
+
@param source The node at its source end.
|
|
32
|
+
@param target The node at its target end.
|
|
33
|
+
@param index The link's index in `links`.
|
|
34
|
+
@param endKeys The keys of `raw` that name its ends.
|
|
35
|
+
*/ export function makeLinkDatum(raw, source, target, index, endKeys = [
|
|
36
|
+
"source",
|
|
37
|
+
"target"
|
|
38
|
+
]) {
|
|
39
|
+
const datum = {
|
|
40
|
+
...raw,
|
|
41
|
+
source: source.data,
|
|
42
|
+
target: target.data
|
|
43
|
+
};
|
|
44
|
+
metas.set(datum, {
|
|
45
|
+
index,
|
|
46
|
+
raw,
|
|
47
|
+
source,
|
|
48
|
+
target,
|
|
49
|
+
endKeys
|
|
50
|
+
});
|
|
51
|
+
return datum;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
Records a link's value (from `linkSize` or `value`) for its tooltip and
|
|
55
|
+
spoken label, and returns it.
|
|
56
|
+
*/ export function setLinkValue(d, value) {
|
|
57
|
+
const meta = linkMeta(d);
|
|
58
|
+
const n = typeof value === "number" ? value : Number(value);
|
|
59
|
+
if (meta && value !== null && value !== "" && Number.isFinite(n)) meta.value = n;
|
|
60
|
+
return value;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
Indexes a chart's links by node and stores the result on `viz.ctx.linkGraph`.
|
|
64
|
+
Each of `nodes` (including any without links) is recognized by its datum
|
|
65
|
+
from then on, so its tooltip can list its connections.
|
|
66
|
+
*/ export function publishLinkGraph(viz, links, nodes) {
|
|
67
|
+
const values = new Set(links.map((l)=>linkMeta(l)?.value));
|
|
68
|
+
const byNode = new Map(nodes.map((n)=>[
|
|
69
|
+
n.id,
|
|
70
|
+
[]
|
|
71
|
+
]));
|
|
72
|
+
const graph = {
|
|
73
|
+
links,
|
|
74
|
+
sized: values.size > 1,
|
|
75
|
+
byNode
|
|
76
|
+
};
|
|
77
|
+
for (const link of links){
|
|
78
|
+
const meta = linkMeta(link);
|
|
79
|
+
meta.graph = graph;
|
|
80
|
+
const ids = new Set([
|
|
81
|
+
meta.source.id,
|
|
82
|
+
meta.target.id
|
|
83
|
+
]);
|
|
84
|
+
for (const id of ids){
|
|
85
|
+
if (!byNode.has(id)) byNode.set(id, []);
|
|
86
|
+
byNode.get(id).push(link);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
let entries = nodeEntries.get(viz);
|
|
90
|
+
if (!entries) nodeEntries.set(viz, entries = new WeakMap());
|
|
91
|
+
for (const n of nodes)if (n.data && typeof n.data === "object") entries.set(n.data, {
|
|
92
|
+
id: n.id,
|
|
93
|
+
graph
|
|
94
|
+
});
|
|
95
|
+
viz.ctx.linkGraph = graph;
|
|
96
|
+
scheduleNodeStats(viz, graph, ()=>statLinks(graph), ()=>refreshNodeTooltip(viz));
|
|
97
|
+
return graph;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
Forgets every node `publishLinkGraph` recorded for a chart, so rows that
|
|
101
|
+
no longer end a link stop reading as nodes.
|
|
102
|
+
*/ export function forgetLinkNodes(viz) {
|
|
103
|
+
nodeEntries.delete(viz);
|
|
104
|
+
}
|
|
105
|
+
/** The node id and graph recorded for a node datum, if `d` is one. */ export function linkNodeOf(viz, d) {
|
|
106
|
+
if (!d || typeof d !== "object") return undefined;
|
|
107
|
+
return nodeEntries.get(viz)?.get(d);
|
|
108
|
+
}
|
|
109
|
+
/** Languages written right to left, by their primary language subtag. */ const RTL_LANGUAGES = new Set([
|
|
110
|
+
"ar",
|
|
111
|
+
"dv",
|
|
112
|
+
"fa",
|
|
113
|
+
"he",
|
|
114
|
+
"ps",
|
|
115
|
+
"ur",
|
|
116
|
+
"yi"
|
|
117
|
+
]);
|
|
118
|
+
/** Whether a locale code (`"ar-SA"`) names a language written right to left. */ export function rtlLocale(locale) {
|
|
119
|
+
const language = `${locale ?? ""}`.split(/[-_]/)[0].toLowerCase();
|
|
120
|
+
return RTL_LANGUAGES.has(language);
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
The arrows a chart's tooltips point from a link's source to its target
|
|
124
|
+
with: `["→", "←"]`, mirrored to `["←", "→"]` when the chart's locale is
|
|
125
|
+
written right to left or the page's direction is (see `rtl`).
|
|
126
|
+
*/ export function linkArrows(viz) {
|
|
127
|
+
const mirrored = rtlLocale(viz.schema.locale) || typeof document !== "undefined" && !!document.body && rtl();
|
|
128
|
+
return mirrored ? [
|
|
129
|
+
"←",
|
|
130
|
+
"→"
|
|
131
|
+
] : [
|
|
132
|
+
"→",
|
|
133
|
+
"←"
|
|
134
|
+
];
|
|
135
|
+
}
|
|
136
|
+
/** A link end's label, as its node's tooltip titles it. */ export function linkEndLabel(viz, end) {
|
|
137
|
+
if (end.label !== undefined) return end.label;
|
|
138
|
+
return `${viz._drawLabel(end.data, end.i) ?? end.id}`;
|
|
139
|
+
}
|
|
140
|
+
/** A link's tooltip title: "Source → Target" ("Source ← Target" right to left). */ export function linkTooltipTitle(viz, d) {
|
|
141
|
+
const meta = linkMeta(d);
|
|
142
|
+
if (!meta) return "";
|
|
143
|
+
const [forward] = linkArrows(viz);
|
|
144
|
+
return `${linkEndLabel(viz, meta.source)} ${forward} ${linkEndLabel(viz, meta.target)}`;
|
|
145
|
+
}
|
|
146
|
+
/** A tooltip cell's text for one field value, or null for a value it skips. */ export function linkCellText(viz, v) {
|
|
147
|
+
const locale = viz.schema.locale;
|
|
148
|
+
if (typeof v === "number") return Number.isFinite(v) ? formatAbbreviate(v, locale) : null;
|
|
149
|
+
if (typeof v === "string") return v;
|
|
150
|
+
if (typeof v === "boolean") return `${v}`;
|
|
151
|
+
if (v instanceof Date && !isNaN(v.getTime())) return v.toLocaleDateString(locale);
|
|
152
|
+
return null;
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
A link's tooltip rows: its value (when the chart's links differ in value
|
|
156
|
+
and no field of the link already shows it), then each of the link's own
|
|
157
|
+
fields other than the ones naming its ends.
|
|
158
|
+
*/ export function linkTooltipRows(viz, d) {
|
|
159
|
+
const meta = linkMeta(d);
|
|
160
|
+
if (!meta) return [];
|
|
161
|
+
const fields = [];
|
|
162
|
+
let shown = false;
|
|
163
|
+
for (const [key, v] of Object.entries(meta.raw)){
|
|
164
|
+
if (meta.endKeys.includes(key) || key.startsWith("__")) continue;
|
|
165
|
+
const text = linkCellText(viz, v);
|
|
166
|
+
if (text === null) continue;
|
|
167
|
+
if (v === meta.value) shown = true;
|
|
168
|
+
fields.push([
|
|
169
|
+
key,
|
|
170
|
+
text
|
|
171
|
+
]);
|
|
172
|
+
}
|
|
173
|
+
const rows = [];
|
|
174
|
+
if (meta.graph?.sized && meta.value !== undefined && !shown) rows.push([
|
|
175
|
+
viz.schema.translate("Value"),
|
|
176
|
+
linkCellText(viz, meta.value)
|
|
177
|
+
]);
|
|
178
|
+
return rows.concat(fields);
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
A link's spoken label: "Source to Target." When the chart's links differ
|
|
182
|
+
in value, its value follows: "Source to Target, 4."
|
|
183
|
+
*/ export function linkAriaLabel(viz, d) {
|
|
184
|
+
const meta = linkMeta(d);
|
|
185
|
+
if (!meta) return "";
|
|
186
|
+
const value = meta.graph?.sized && meta.value !== undefined ? `, ${meta.value}` : "";
|
|
187
|
+
return `${linkEndLabel(viz, meta.source)} ${viz.schema.translate("to")} ${linkEndLabel(viz, meta.target)}${value}.`;
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
What hovering a link highlights: the link and the nodes at its two ends.
|
|
191
|
+
Rows that aren't recorded nodes (legend entries) match by `nodeKey`.
|
|
192
|
+
*/ export function linkHighlight(viz, d, nodeKey) {
|
|
193
|
+
const meta = linkMeta(d);
|
|
194
|
+
const ids = new Set([
|
|
195
|
+
meta.source.id,
|
|
196
|
+
meta.target.id
|
|
197
|
+
]);
|
|
198
|
+
return (h, hi)=>{
|
|
199
|
+
const m = linkMeta(h);
|
|
200
|
+
if (m) return m.index === meta.index;
|
|
201
|
+
const id = linkNodeOf(viz, h)?.id ?? nodeKey?.(h, hi);
|
|
202
|
+
return id !== undefined && ids.has(`${id}`);
|
|
203
|
+
};
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
What hovering a legend entry highlights: the nodes it stands for (one, or
|
|
207
|
+
every member of a merged entry, such as a cluster) and the links between
|
|
208
|
+
them. A row matches when every id it holds is one of the entry's, so the
|
|
209
|
+
entry matches itself.
|
|
210
|
+
*/ export function legendHighlight(viz, d, i) {
|
|
211
|
+
const idsOf = (h, hi)=>[].concat(viz._id(h, hi)).map((id)=>`${id}`);
|
|
212
|
+
const ids = new Set(idsOf(d, i));
|
|
213
|
+
return (h, hi)=>{
|
|
214
|
+
const m = linkMeta(h);
|
|
215
|
+
if (m) return ids.has(m.source.id) && ids.has(m.target.id);
|
|
216
|
+
const own = idsOf(h, hi);
|
|
217
|
+
return own.length > 0 && own.every((id)=>ids.has(id));
|
|
218
|
+
};
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
A node's links in `graph`, the other end of each, and its direction,
|
|
222
|
+
strongest first. A link from the node to itself is `loop`, with the node
|
|
223
|
+
as its other end.
|
|
224
|
+
*/ export function nodeConnections(graph, id) {
|
|
225
|
+
return (graph.byNode.get(id) ?? []).map((link)=>{
|
|
226
|
+
const meta = linkMeta(link);
|
|
227
|
+
const outgoing = meta.source.id === id;
|
|
228
|
+
return {
|
|
229
|
+
link,
|
|
230
|
+
other: outgoing ? meta.target : meta.source,
|
|
231
|
+
outgoing,
|
|
232
|
+
loop: meta.source.id === meta.target.id,
|
|
233
|
+
value: meta.value,
|
|
234
|
+
index: meta.index
|
|
235
|
+
};
|
|
236
|
+
}).sort((a, b)=>(b.value ?? -Infinity) - (a.value ?? -Infinity) || a.index - b.index).map(({ link, other, outgoing, loop, value })=>({
|
|
237
|
+
link,
|
|
238
|
+
other,
|
|
239
|
+
outgoing,
|
|
240
|
+
loop,
|
|
241
|
+
value
|
|
242
|
+
}));
|
|
243
|
+
}
|
|
244
|
+
/**
|
|
245
|
+
What hovering a node highlights: the node, the nodes it links to, and the
|
|
246
|
+
links between them. Null when `d` isn't a recorded node. Rows that aren't
|
|
247
|
+
recorded nodes (legend entries) match by `nodeKey`.
|
|
248
|
+
*/ export function nodeHighlight(viz, d, nodeKey) {
|
|
249
|
+
const entry = linkNodeOf(viz, d);
|
|
250
|
+
if (!entry) return null;
|
|
251
|
+
const links = nodeConnections(entry.graph, entry.id);
|
|
252
|
+
const ids = new Set([
|
|
253
|
+
entry.id,
|
|
254
|
+
...links.map((c)=>c.other.id)
|
|
255
|
+
]);
|
|
256
|
+
const indices = new Set(links.map((c)=>linkMeta(c.link).index));
|
|
257
|
+
return (h, hi)=>{
|
|
258
|
+
const m = linkMeta(h);
|
|
259
|
+
if (m) return indices.has(m.index);
|
|
260
|
+
const id = linkNodeOf(viz, h)?.id ?? nodeKey?.(h, hi);
|
|
261
|
+
return id !== undefined && ids.has(`${id}`);
|
|
262
|
+
};
|
|
263
|
+
}
|
|
264
|
+
/**
|
|
265
|
+
How many links a node's tooltip lists: `nodeTooltipLinks` when it is a
|
|
266
|
+
number (`true` is 3, `false` none), else 3 when the links differ in value
|
|
267
|
+
and none when they don't.
|
|
268
|
+
*/ export function nodeTooltipLinkLimit(viz, graph) {
|
|
269
|
+
const limit = viz.schema.nodeTooltipLinks;
|
|
270
|
+
if (limit === false) return 0;
|
|
271
|
+
if (limit === true) return 3;
|
|
272
|
+
if (typeof limit === "number" && Number.isFinite(limit)) return Math.max(0, Math.floor(limit));
|
|
273
|
+
return graph.sized ? 3 : 0;
|
|
274
|
+
}
|
|
275
|
+
/** The arrow a node's tooltip marks a link from the node to itself with. */ export const LOOP_ARROW = "↻";
|
|
276
|
+
/** A graph's links as the node measures read them (see `nodeStatRows`). */ function statLinks(graph) {
|
|
277
|
+
return graph.links.map((datum)=>{
|
|
278
|
+
const meta = linkMeta(datum);
|
|
279
|
+
return {
|
|
280
|
+
source: meta.source.id,
|
|
281
|
+
target: meta.target.id,
|
|
282
|
+
index: meta.index,
|
|
283
|
+
value: meta.value,
|
|
284
|
+
datum
|
|
285
|
+
};
|
|
286
|
+
});
|
|
287
|
+
}
|
|
288
|
+
/**
|
|
289
|
+
Renders the chart's tooltip again while it shows one of its nodes, so
|
|
290
|
+
measures that became ready since it opened fill in.
|
|
291
|
+
*/ function refreshNodeTooltip(viz) {
|
|
292
|
+
const tooltip = viz._tooltipClass;
|
|
293
|
+
const shown = tooltip?.data();
|
|
294
|
+
if (Array.isArray(shown) && shown.some((d)=>linkNodeOf(viz, d))) tooltip.render();
|
|
295
|
+
}
|
|
296
|
+
/**
|
|
297
|
+
A node's tooltip rows: its number of connections (left out when its
|
|
298
|
+
degree takes its place) and the network measures `nodeTooltipStats`
|
|
299
|
+
lists (see `nodeStatRows`), then its strongest links ("→ Target" or "← Source", or "↻ Node" for a link to
|
|
300
|
+
itself, with the link's value when the links differ in value), up to
|
|
301
|
+
`nodeTooltipLinkLimit`. The arrows mirror right to left (see
|
|
302
|
+
`linkArrows`).
|
|
303
|
+
*/ export function nodeConnectionRows(viz, d) {
|
|
304
|
+
const entry = linkNodeOf(viz, d);
|
|
305
|
+
if (!entry) return [];
|
|
306
|
+
const { graph, id } = entry;
|
|
307
|
+
const connections = nodeConnections(graph, id);
|
|
308
|
+
const stats = nodeStatRows(viz, graph, id, ()=>statLinks(graph), ()=>refreshNodeTooltip(viz));
|
|
309
|
+
const rows = stats.degree ? stats.rows : [
|
|
310
|
+
[
|
|
311
|
+
viz.schema.translate("Connections"),
|
|
312
|
+
`${connections.length}`
|
|
313
|
+
],
|
|
314
|
+
...stats.rows
|
|
315
|
+
];
|
|
316
|
+
const [forward, back] = linkArrows(viz);
|
|
317
|
+
for (const c of connections.slice(0, nodeTooltipLinkLimit(viz, graph))){
|
|
318
|
+
const value = graph.sized && c.value !== undefined ? linkCellText(viz, c.value) : "";
|
|
319
|
+
rows.push([
|
|
320
|
+
`${c.loop ? LOOP_ARROW : c.outgoing ? forward : back} ${linkEndLabel(viz, c.other)}`,
|
|
321
|
+
value
|
|
322
|
+
]);
|
|
323
|
+
}
|
|
324
|
+
return rows;
|
|
325
|
+
}
|
|
326
|
+
/**
|
|
327
|
+
The color category a row merging several nodes stands for (a cluster's
|
|
328
|
+
name, or a legend entry's color value), so a legend entry's tooltip
|
|
329
|
+
reads as the entry does instead of listing every node.
|
|
330
|
+
*/ function mergedCategory(viz, d, i) {
|
|
331
|
+
const ids = viz._id?.(d, i);
|
|
332
|
+
if (!Array.isArray(ids) || ids.length < 2) return undefined;
|
|
333
|
+
const color = viz.schema.color;
|
|
334
|
+
return typeof color === "function" ? colorCategory(color(d, i)) : undefined;
|
|
335
|
+
}
|
|
336
|
+
/**
|
|
337
|
+
The node-link charts' default `tooltipConfig`: a link is titled
|
|
338
|
+
"Source → Target" and lists its value and fields; a node is titled by its
|
|
339
|
+
label and lists its connections.
|
|
340
|
+
*/ export function linkTooltipConfig(viz) {
|
|
341
|
+
return {
|
|
342
|
+
title: (d, i)=>isLinkDatum(d) ? linkTooltipTitle(viz, d) : mergedCategory(viz, d, i) ?? viz._drawLabel(d, typeof d.i === "number" ? d.i : i),
|
|
343
|
+
tbody: (d)=>isLinkDatum(d) ? linkTooltipRows(viz, d) : nodeConnectionRows(viz, d)
|
|
344
|
+
};
|
|
345
|
+
}
|
|
346
|
+
/** The smallest stroke width a link's hit path takes, in pixels. */ export const LINK_HIT_WIDTH = 8;
|
|
347
|
+
/**
|
|
348
|
+
A transparent path over a link, wider than it, so thin links are easy to
|
|
349
|
+
point at. Keyboard navigation skips it (its key ends in `::hit`).
|
|
350
|
+
*/ export function linkHitPath(key, d, datum, strokeWidth) {
|
|
351
|
+
const width = typeof strokeWidth === "number" ? strokeWidth : 1;
|
|
352
|
+
return {
|
|
353
|
+
type: "path",
|
|
354
|
+
key: `${key}::hit`,
|
|
355
|
+
d,
|
|
356
|
+
datum,
|
|
357
|
+
index: linkMeta(datum)?.index ?? 0,
|
|
358
|
+
paint: {
|
|
359
|
+
fill: "none",
|
|
360
|
+
stroke: "transparent",
|
|
361
|
+
strokeWidth: Math.max(LINK_HIT_WIDTH, width + 4)
|
|
362
|
+
}
|
|
363
|
+
};
|
|
364
|
+
}
|
|
@@ -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
|
+
}
|
|
@@ -0,0 +1,209 @@
|
|
|
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
|
+
*/ import { boxHitsCircle, boxesOverlap } from "./circleLabelPlacement.js";
|
|
7
|
+
/**
|
|
8
|
+
The middle of a straight link's visible length, between the edges of the
|
|
9
|
+
circles of radius `r0` and `r1` around its ends, and its direction.
|
|
10
|
+
*/ export function segmentMidpoint(a, b, r0 = 0, r1 = 0) {
|
|
11
|
+
const dx = b[0] - a[0];
|
|
12
|
+
const dy = b[1] - a[1];
|
|
13
|
+
const length = Math.hypot(dx, dy);
|
|
14
|
+
const angle = Math.atan2(dy, dx);
|
|
15
|
+
if (!length) return {
|
|
16
|
+
x: a[0],
|
|
17
|
+
y: a[1],
|
|
18
|
+
angle
|
|
19
|
+
};
|
|
20
|
+
// Half the visible run past the start edge.
|
|
21
|
+
const t = (r0 + Math.max(0, length - r0 - r1) / 2) / length;
|
|
22
|
+
return {
|
|
23
|
+
x: a[0] + dx * t,
|
|
24
|
+
y: a[1] + dy * t,
|
|
25
|
+
angle
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
/** The point at `t` (0–1) along a cubic Bézier curve. */ export function cubicPoint(p0, p1, p2, p3, t) {
|
|
29
|
+
const u = 1 - t;
|
|
30
|
+
const a = u * u * u;
|
|
31
|
+
const b = 3 * u * u * t;
|
|
32
|
+
const c = 3 * u * t * t;
|
|
33
|
+
const d = t * t * t;
|
|
34
|
+
return [
|
|
35
|
+
a * p0[0] + b * p1[0] + c * p2[0] + d * p3[0],
|
|
36
|
+
a * p0[1] + b * p1[1] + c * p2[1] + d * p3[1]
|
|
37
|
+
];
|
|
38
|
+
}
|
|
39
|
+
/** The direction (radians) a cubic Bézier curve runs at `t`. */ export function cubicAngle(p0, p1, p2, p3, t) {
|
|
40
|
+
const u = 1 - t;
|
|
41
|
+
const dx = 3 * u * u * (p1[0] - p0[0]) + 6 * u * t * (p2[0] - p1[0]) + 3 * t * t * (p3[0] - p2[0]);
|
|
42
|
+
const dy = 3 * u * u * (p1[1] - p0[1]) + 6 * u * t * (p2[1] - p1[1]) + 3 * t * t * (p3[1] - p2[1]);
|
|
43
|
+
// A degenerate end (a control point on its end) runs toward the far end.
|
|
44
|
+
if (!dx && !dy) return Math.atan2(p3[1] - p0[1], p3[0] - p0[0]);
|
|
45
|
+
return Math.atan2(dy, dx);
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
The point halfway along a cubic Bézier curve's length (not at `t` = 0.5,
|
|
49
|
+
which bunches toward the tighter end), and its direction there.
|
|
50
|
+
@param steps The number of chords the curve's length is measured in.
|
|
51
|
+
*/ export function cubicMidpoint(p0, p1, p2, p3, steps = 64) {
|
|
52
|
+
const lengths = [
|
|
53
|
+
0
|
|
54
|
+
];
|
|
55
|
+
let prev = p0;
|
|
56
|
+
for(let k = 1; k <= steps; k++){
|
|
57
|
+
const p = cubicPoint(p0, p1, p2, p3, k / steps);
|
|
58
|
+
lengths.push(lengths[k - 1] + Math.hypot(p[0] - prev[0], p[1] - prev[1]));
|
|
59
|
+
prev = p;
|
|
60
|
+
}
|
|
61
|
+
const half = lengths[steps] / 2;
|
|
62
|
+
let k = 1;
|
|
63
|
+
while(k < steps && lengths[k] < half)k++;
|
|
64
|
+
const span = lengths[k] - lengths[k - 1];
|
|
65
|
+
const t = (k - 1 + (span ? (half - lengths[k - 1]) / span : 0)) / steps;
|
|
66
|
+
const [x, y] = cubicPoint(p0, p1, p2, p3, t);
|
|
67
|
+
return {
|
|
68
|
+
x,
|
|
69
|
+
y,
|
|
70
|
+
angle: cubicAngle(p0, p1, p2, p3, t)
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
A direction (radians) as the rotation (degrees) that keeps text running
|
|
75
|
+
along it upright: within -90° (reading bottom to top) and 90°.
|
|
76
|
+
*/ export function uprightAngle(radians) {
|
|
77
|
+
let deg = radians * 180 / Math.PI;
|
|
78
|
+
deg = ((deg + 90) % 180 + 180) % 180 - 90;
|
|
79
|
+
// -0 reads as 0.
|
|
80
|
+
return deg === 0 ? 0 : Math.round(deg * 1e6) / 1e6;
|
|
81
|
+
}
|
|
82
|
+
/** A label box's four corners, clockwise from its top-left. */ export function labelCorners(box) {
|
|
83
|
+
const rad = box.angle * Math.PI / 180;
|
|
84
|
+
const cos = Math.cos(rad);
|
|
85
|
+
const sin = Math.sin(rad);
|
|
86
|
+
const hw = box.width / 2;
|
|
87
|
+
const hh = box.height / 2;
|
|
88
|
+
return [
|
|
89
|
+
[
|
|
90
|
+
-hw,
|
|
91
|
+
-hh
|
|
92
|
+
],
|
|
93
|
+
[
|
|
94
|
+
hw,
|
|
95
|
+
-hh
|
|
96
|
+
],
|
|
97
|
+
[
|
|
98
|
+
hw,
|
|
99
|
+
hh
|
|
100
|
+
],
|
|
101
|
+
[
|
|
102
|
+
-hw,
|
|
103
|
+
hh
|
|
104
|
+
]
|
|
105
|
+
].map(([x, y])=>[
|
|
106
|
+
box.x + x * cos - y * sin,
|
|
107
|
+
box.y + x * sin + y * cos
|
|
108
|
+
]);
|
|
109
|
+
}
|
|
110
|
+
/** Whether two convex polygons overlap (separating axis test; touching edges don't count). */ function polygonsOverlap(a, b) {
|
|
111
|
+
for (const poly of [
|
|
112
|
+
a,
|
|
113
|
+
b
|
|
114
|
+
]){
|
|
115
|
+
for(let k = 0; k < poly.length; k++){
|
|
116
|
+
const p = poly[k];
|
|
117
|
+
const q = poly[(k + 1) % poly.length];
|
|
118
|
+
const nx = q[1] - p[1];
|
|
119
|
+
const ny = p[0] - q[0];
|
|
120
|
+
const project = (pts)=>{
|
|
121
|
+
let min = Infinity;
|
|
122
|
+
let max = -Infinity;
|
|
123
|
+
for (const [x, y] of pts){
|
|
124
|
+
const v = x * nx + y * ny;
|
|
125
|
+
if (v < min) min = v;
|
|
126
|
+
if (v > max) max = v;
|
|
127
|
+
}
|
|
128
|
+
return [
|
|
129
|
+
min,
|
|
130
|
+
max
|
|
131
|
+
];
|
|
132
|
+
};
|
|
133
|
+
const [amin, amax] = project(a);
|
|
134
|
+
const [bmin, bmax] = project(b);
|
|
135
|
+
const eps = 1e-9 * Math.hypot(nx, ny);
|
|
136
|
+
if (amax <= bmin + eps || bmax <= amin + eps) return false;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
return true;
|
|
140
|
+
}
|
|
141
|
+
/** A label box without rotation, as a top-left box. */ const flatBox = (box)=>({
|
|
142
|
+
x: box.x - box.width / 2,
|
|
143
|
+
y: box.y - box.height / 2,
|
|
144
|
+
width: box.width,
|
|
145
|
+
height: box.height
|
|
146
|
+
});
|
|
147
|
+
/** Whether two label boxes overlap. */ export function labelsOverlap(a, b) {
|
|
148
|
+
if (!a.angle && !b.angle) return boxesOverlap(flatBox(a), flatBox(b));
|
|
149
|
+
return polygonsOverlap(labelCorners(a), labelCorners(b));
|
|
150
|
+
}
|
|
151
|
+
/** Whether a label box overlaps a circle. */ export function labelHitsCircle(box, circle) {
|
|
152
|
+
// The circle's center in the label's own (unrotated) frame.
|
|
153
|
+
const rad = -box.angle * Math.PI / 180;
|
|
154
|
+
const dx = circle.x - box.x;
|
|
155
|
+
const dy = circle.y - box.y;
|
|
156
|
+
const local = {
|
|
157
|
+
x: dx * Math.cos(rad) - dy * Math.sin(rad),
|
|
158
|
+
y: dx * Math.sin(rad) + dy * Math.cos(rad),
|
|
159
|
+
r: circle.r
|
|
160
|
+
};
|
|
161
|
+
return boxHitsCircle(flatBox({
|
|
162
|
+
...box,
|
|
163
|
+
x: 0,
|
|
164
|
+
y: 0
|
|
165
|
+
}), local);
|
|
166
|
+
}
|
|
167
|
+
/** Whether a label box overlaps an axis-aligned box (such as a Sankey node). */ export function labelHitsBox(box, rect) {
|
|
168
|
+
if (!box.angle) return boxesOverlap(flatBox(box), rect);
|
|
169
|
+
return polygonsOverlap(labelCorners(box), [
|
|
170
|
+
[
|
|
171
|
+
rect.x,
|
|
172
|
+
rect.y
|
|
173
|
+
],
|
|
174
|
+
[
|
|
175
|
+
rect.x + rect.width,
|
|
176
|
+
rect.y
|
|
177
|
+
],
|
|
178
|
+
[
|
|
179
|
+
rect.x + rect.width,
|
|
180
|
+
rect.y + rect.height
|
|
181
|
+
],
|
|
182
|
+
[
|
|
183
|
+
rect.x,
|
|
184
|
+
rect.y + rect.height
|
|
185
|
+
]
|
|
186
|
+
]);
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
The labels that fit, in the order given (earlier labels win): each one
|
|
190
|
+
that overlaps no node and no label already kept. A label with `boxes`
|
|
191
|
+
(such as one along a curve) is tested by those, else by its `box`.
|
|
192
|
+
*/ export function placeLinkLabels(labels, obstacles) {
|
|
193
|
+
const circles = obstacles.circles ?? [];
|
|
194
|
+
const rects = obstacles.boxes ?? [];
|
|
195
|
+
const others = obstacles.labels ?? [];
|
|
196
|
+
const kept = [];
|
|
197
|
+
const keptBoxes = [];
|
|
198
|
+
for (const label of labels){
|
|
199
|
+
const boxes = label.boxes ?? [
|
|
200
|
+
label.box
|
|
201
|
+
];
|
|
202
|
+
if (!boxes.length || !boxes.every((b)=>b.width > 0 && b.height > 0)) continue;
|
|
203
|
+
const hits = (box)=>circles.some((c)=>labelHitsCircle(box, c)) || rects.some((b)=>labelHitsBox(box, b)) || others.some((o)=>labelsOverlap(box, o)) || keptBoxes.some((k)=>labelsOverlap(box, k));
|
|
204
|
+
if (boxes.some(hits)) continue;
|
|
205
|
+
kept.push(label);
|
|
206
|
+
keptBoxes.push(...boxes);
|
|
207
|
+
}
|
|
208
|
+
return kept;
|
|
209
|
+
}
|