@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
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
2
|
Light/dark basemaps. `tileUrl` and `ocean` accept either one value or a
|
|
3
|
-
`{light, dark}` pair; a pair resolves against the chart's
|
|
4
|
-
draw, and
|
|
3
|
+
`{light, dark}` pair; a pair resolves against the chart's theme each
|
|
4
|
+
draw (see `theme`), and an `"auto"` chart redraws when its page flips.
|
|
5
5
|
|
|
6
6
|
@module
|
|
7
|
-
*/
|
|
8
|
-
/** Esri's Canvas basemaps: muted, nearly label-free bases for data overlays. */ export const DEFAULT_TILE_URL = {
|
|
7
|
+
*/ /** A value, or one per page theme. */ /** Esri's Canvas basemaps: muted, nearly label-free bases for data overlays. */ export const DEFAULT_TILE_URL = {
|
|
9
8
|
light: "https://server.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Base/MapServer/tile/{z}/{y}/{x}",
|
|
10
9
|
dark: "https://server.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Dark_Gray_Base/MapServer/tile/{z}/{y}/{x}"
|
|
11
10
|
};
|
|
@@ -17,47 +16,3 @@ const isPair = (value)=>typeof value === "object" && value !== null && "light" i
|
|
|
17
16
|
/** Picks a themed value's light or dark side. */ export function resolveThemed(value, dark) {
|
|
18
17
|
return isPair(value) ? dark ? value.dark : value.light : value;
|
|
19
18
|
}
|
|
20
|
-
/** Whether a Geomap has any themed value that depends on the backdrop. */ export function isThemed(viz) {
|
|
21
|
-
return isPair(viz.schema.tileUrl) || isPair(viz.schema.ocean);
|
|
22
|
-
}
|
|
23
|
-
/**
|
|
24
|
-
Whether the chart sits on a dark backdrop: the first non-transparent
|
|
25
|
-
background among its ancestors, or — when none sets one — the browser's
|
|
26
|
-
own page canvas, which is dark only when the page opts into a dark
|
|
27
|
-
`color-scheme` and the system prefers dark. Server renders are light.
|
|
28
|
-
*/ export function pageIsDark(viz) {
|
|
29
|
-
if (viz._ssr || typeof window === "undefined" || typeof getComputedStyle !== "function") return false;
|
|
30
|
-
let node = viz._select?.node() ?? null;
|
|
31
|
-
while(node){
|
|
32
|
-
const bg = getComputedStyle(node).backgroundColor;
|
|
33
|
-
if (bg && bg !== "transparent" && bg !== "rgba(0, 0, 0, 0)") return lab(bg).l < 50;
|
|
34
|
-
node = node.parentElement;
|
|
35
|
-
}
|
|
36
|
-
const scheme = getComputedStyle(document.documentElement).colorScheme || "";
|
|
37
|
-
if (!scheme.includes("dark")) return false;
|
|
38
|
-
if (!scheme.includes("light")) return true;
|
|
39
|
-
return typeof matchMedia === "function" && matchMedia("(prefers-color-scheme: dark)").matches;
|
|
40
|
-
}
|
|
41
|
-
/**
|
|
42
|
-
Redraws the chart when its backdrop changes theme: on a system theme
|
|
43
|
-
change, or when the page flips a theme class/attribute/style on <html>
|
|
44
|
-
or <body> (how most theme toggles work). Installed once per chart, and
|
|
45
|
-
only while it uses a `{light, dark}` pair.
|
|
46
|
-
*/ export function watchPageTheme(viz) {
|
|
47
|
-
if (viz._themeWatch || viz._ssr || typeof window === "undefined") return;
|
|
48
|
-
const check = ()=>{
|
|
49
|
-
const host = viz._select?.node();
|
|
50
|
-
if (!host || !host.isConnected) return;
|
|
51
|
-
if (isThemed(viz) && pageIsDark(viz) !== viz._basemapDark) viz.render?.();
|
|
52
|
-
};
|
|
53
|
-
const media = typeof matchMedia === "function" ? matchMedia("(prefers-color-scheme: dark)") : null;
|
|
54
|
-
media?.addEventListener?.("change", check);
|
|
55
|
-
const observer = typeof MutationObserver === "function" ? new MutationObserver(check) : null;
|
|
56
|
-
for (const el of [
|
|
57
|
-
document.documentElement,
|
|
58
|
-
document.body
|
|
59
|
-
])if (el) observer?.observe(el, {
|
|
60
|
-
attributes: true
|
|
61
|
-
});
|
|
62
|
-
viz._themeWatch = true;
|
|
63
|
-
}
|
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
|
-
`geomapEmit` — country Paths
|
|
3
|
-
stashed on `viz.ctx`. Emits flat SceneNodes directly (no transient
|
|
2
|
+
`geomapEmit` — country Paths, links, and point Circles using
|
|
3
|
+
`geomapCtx` stashed on `viz.ctx`. Emits flat SceneNodes directly (no transient
|
|
4
4
|
Shape compute pass).
|
|
5
5
|
*/ import { chartBounds } from "../features/chartGeometry.js";
|
|
6
6
|
import { paintFromShapeConfig, shapeConfigFor } from "../features/emitHelpers.js";
|
|
7
7
|
import { backgroundImageNodes } from "../features/backgroundImageEmit.js";
|
|
8
8
|
import { resolveThemed } from "./basemapTheme.js";
|
|
9
|
+
import { geomapPointLabels } from "./pointLabels.js";
|
|
10
|
+
import { emitFlowLabels, emitFlowLinks } from "./flowEmit.js";
|
|
9
11
|
/**
|
|
10
12
|
The ocean rect and basemap tiles, for a server render or a small-multiples
|
|
11
13
|
panel (empty otherwise).
|
|
@@ -98,6 +100,9 @@ export const geomapEmit = ({ viz })=>{
|
|
|
98
100
|
];
|
|
99
101
|
}));
|
|
100
102
|
}
|
|
103
|
+
const links = c.flowLinks ?? [];
|
|
104
|
+
out.push(...emitFlowLinks(viz, links));
|
|
105
|
+
const circles = [];
|
|
101
106
|
if (c.pointData && c.pointData.length) {
|
|
102
107
|
const circleConfig = shapeConfigFor(viz, "Circle");
|
|
103
108
|
const points = c.pointSort ? [
|
|
@@ -107,6 +112,11 @@ export const geomapEmit = ({ viz })=>{
|
|
|
107
112
|
for(let i = 0; i < points.length; i++){
|
|
108
113
|
const d = points[i];
|
|
109
114
|
const paint = paintFromShapeConfig(circleConfig, d, i);
|
|
115
|
+
circles.push({
|
|
116
|
+
x: c.pointX(d, i),
|
|
117
|
+
y: c.pointY(d, i),
|
|
118
|
+
r: c.pointR(d, i)
|
|
119
|
+
});
|
|
110
120
|
// Origin-centered geometry with the projected position in `transform`,
|
|
111
121
|
// matching how Shape-emitted Circle marks are placed (cx/cy = 0, group
|
|
112
122
|
// transform positions the mark). The motion-trail layer reads a mark's
|
|
@@ -145,6 +155,13 @@ export const geomapEmit = ({ viz })=>{
|
|
|
145
155
|
points[k],
|
|
146
156
|
k
|
|
147
157
|
]));
|
|
158
|
+
out.push(...geomapPointLabels(viz, {
|
|
159
|
+
points,
|
|
160
|
+
pointR: c.pointR,
|
|
161
|
+
pointX: c.pointX,
|
|
162
|
+
pointY: c.pointY
|
|
163
|
+
}, circleConfig));
|
|
148
164
|
}
|
|
165
|
+
out.push(...emitFlowLabels(viz, links, circles));
|
|
149
166
|
return out;
|
|
150
167
|
};
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Geomap's links as scene nodes: each link's path (ending inside its
|
|
3
|
+
arrowheads), a wider transparent hit path over the whole path so thin
|
|
4
|
+
links are easy to point at, its arrowheads, and its label. The links sit above the topojson shapes and below the coordinate
|
|
5
|
+
points, so a link runs into the point at its end and the points stay on
|
|
6
|
+
top to hover.
|
|
7
|
+
*/ import { interpolateRgb } from "d3-interpolate";
|
|
8
|
+
import { chordArrowNodes, polylineArrowEdge } from "../features/curvedArrows.js";
|
|
9
|
+
import { edgeArrowTrims, emphasizedArrowEdge, scaledArrowSize, scaledStrokeWidth } from "../features/edgeArrows.js";
|
|
10
|
+
import { linkColorResolver } from "../features/linkColor.js";
|
|
11
|
+
import { linkAriaLabel, linkHitPath } from "../features/linkInteraction.js";
|
|
12
|
+
import { emitLinkLabels } from "../features/linkLabels.js";
|
|
13
|
+
import { backgroundInk, chartBackground } from "../viz/backgroundInk.js";
|
|
14
|
+
import { pathRuns, polylineMidpoint } from "./flowGeometry.js";
|
|
15
|
+
/** A link's scene key. */ export const flowLinkKey = (link)=>`geomap-link-${link.source.id}-${link.target.id}-${link.index}`;
|
|
16
|
+
/**
|
|
17
|
+
The color of links `linkColor` doesn't color: halfway between the
|
|
18
|
+
chart's background and its text color, a gray that reads over both the
|
|
19
|
+
land and the water of a light or dark map.
|
|
20
|
+
*/ export function flowLinkGray(viz) {
|
|
21
|
+
return interpolateRgb(chartBackground(viz), backgroundInk(viz))(0.5);
|
|
22
|
+
}
|
|
23
|
+
/** The link's paint: `linkColor` (else `flowLinkGray`) at its width. */ function flowLinkPaint(viz, link, color, gray) {
|
|
24
|
+
return {
|
|
25
|
+
fill: "none",
|
|
26
|
+
stroke: color(link.datum, link) ?? gray,
|
|
27
|
+
strokeWidth: link.size,
|
|
28
|
+
strokeOpacity: 0.85,
|
|
29
|
+
strokeLinecap: "round"
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
/** Whether the run starts (within a pixel) at `at`. */ const startsAt = (run, at)=>!!run && !!at && Math.hypot(run[0][0] - at[0], run[0][1] - at[1]) <= 1;
|
|
33
|
+
/**
|
|
34
|
+
A link's visible stroke and its arrowheads. Each head's tip sits on the
|
|
35
|
+
path, clear of the point at its end, and is aimed along the chord from
|
|
36
|
+
its base (`size` further back along the path) to its tip; the stroke
|
|
37
|
+
follows the path to each base, then runs straight along that chord to
|
|
38
|
+
end inside the head (see `polylineArrowEdge`). A head goes only on an
|
|
39
|
+
end the projection draws. `scale` widens the stroke (see
|
|
40
|
+
`emphasizedArrowEdge`).
|
|
41
|
+
*/ export function flowArrowEdge(viz, link, fill, scale = 1) {
|
|
42
|
+
const trims = edgeArrowTrims({
|
|
43
|
+
arrows: viz.schema.arrows,
|
|
44
|
+
arrowSize: scaledArrowSize(viz.schema.arrowSize, scale),
|
|
45
|
+
strokeWidth: scaledStrokeWidth(link.size, scale),
|
|
46
|
+
datum: link.datum,
|
|
47
|
+
i: link.index
|
|
48
|
+
});
|
|
49
|
+
if (!trims.ends.source && !trims.ends.target) return {
|
|
50
|
+
d: link.d,
|
|
51
|
+
arrows: []
|
|
52
|
+
};
|
|
53
|
+
const runs = pathRuns(link.d);
|
|
54
|
+
const last = runs[runs.length - 1];
|
|
55
|
+
const inset = (r)=>r ? r + 1 : 0;
|
|
56
|
+
// The first run leaves the source and the last reaches the target, when
|
|
57
|
+
// the projection draws them.
|
|
58
|
+
const ends = {
|
|
59
|
+
source: trims.ends.source && startsAt(runs[0], link.sourceAt),
|
|
60
|
+
target: trims.ends.target && startsAt(last ? [
|
|
61
|
+
...last
|
|
62
|
+
].reverse() : undefined, link.targetAt)
|
|
63
|
+
};
|
|
64
|
+
const { d, source, target } = polylineArrowEdge(runs, {
|
|
65
|
+
...trims,
|
|
66
|
+
ends
|
|
67
|
+
}, {
|
|
68
|
+
source: inset(link.source.r),
|
|
69
|
+
target: inset(link.target.r)
|
|
70
|
+
});
|
|
71
|
+
return {
|
|
72
|
+
d,
|
|
73
|
+
arrows: chordArrowNodes({
|
|
74
|
+
ends: {
|
|
75
|
+
source,
|
|
76
|
+
target
|
|
77
|
+
},
|
|
78
|
+
size: trims.size,
|
|
79
|
+
datum: link.datum,
|
|
80
|
+
keyPrefix: `${flowLinkKey(link)}-arrow`,
|
|
81
|
+
fill
|
|
82
|
+
})
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
/** The links, their hit paths, and their arrowheads, in that order. */ export function emitFlowLinks(viz, links) {
|
|
86
|
+
if (!links.length) return [];
|
|
87
|
+
const color = linkColorResolver(viz);
|
|
88
|
+
const gray = flowLinkGray(viz);
|
|
89
|
+
const paths = [];
|
|
90
|
+
const hits = [];
|
|
91
|
+
const arrows = [];
|
|
92
|
+
// Widest first, so a thin link stays visible over a wide one.
|
|
93
|
+
const order = [
|
|
94
|
+
...links
|
|
95
|
+
].sort((a, b)=>b.size - a.size || a.index - b.index);
|
|
96
|
+
for (const link of order){
|
|
97
|
+
const paint = flowLinkPaint(viz, link, color, gray);
|
|
98
|
+
const key = flowLinkKey(link);
|
|
99
|
+
const fill = typeof paint.stroke === "string" ? paint.stroke : undefined;
|
|
100
|
+
const edge = emphasizedArrowEdge((scale)=>flowArrowEdge(viz, link, fill, scale));
|
|
101
|
+
// A stroke ending inside its head ends square, so no cap pokes past it.
|
|
102
|
+
if (edge.arrows.length) paint.strokeLinecap = "butt";
|
|
103
|
+
paths.push({
|
|
104
|
+
type: "path",
|
|
105
|
+
key,
|
|
106
|
+
d: edge.d,
|
|
107
|
+
...edge.emphasis ? {
|
|
108
|
+
emphasis: edge.emphasis
|
|
109
|
+
} : {},
|
|
110
|
+
datum: link.datum,
|
|
111
|
+
index: link.index,
|
|
112
|
+
paint,
|
|
113
|
+
aria: {
|
|
114
|
+
label: linkAriaLabel(viz, link.datum)
|
|
115
|
+
}
|
|
116
|
+
});
|
|
117
|
+
hits.push(linkHitPath(key, link.d, link.datum, link.size));
|
|
118
|
+
arrows.push(...edge.arrows);
|
|
119
|
+
}
|
|
120
|
+
return [
|
|
121
|
+
...paths,
|
|
122
|
+
...hits,
|
|
123
|
+
...arrows
|
|
124
|
+
];
|
|
125
|
+
}
|
|
126
|
+
/** The link labels, at the middle of each link, clear of the points. */ export function emitFlowLabels(viz, links, circles) {
|
|
127
|
+
return emitLinkLabels(viz, links.map((link, i)=>({
|
|
128
|
+
key: flowLinkKey(link),
|
|
129
|
+
link: link.datum,
|
|
130
|
+
i,
|
|
131
|
+
anchor: link.points ? polylineMidpoint(link.points) : null,
|
|
132
|
+
path: link.points,
|
|
133
|
+
priority: link.size
|
|
134
|
+
})), {
|
|
135
|
+
circles
|
|
136
|
+
});
|
|
137
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Geomap's link interaction. Hovering a link emphasizes it and the marks
|
|
3
|
+
at its ends; hovering a point or shape that ends a link emphasizes its
|
|
4
|
+
links. Clicking a link focuses it (the rest of the map dims) and zooms
|
|
5
|
+
to it; clicking it again, any other mark, or the open ocean clears the
|
|
6
|
+
focus. Also installs `links`, which loads its rows like `topojson`.
|
|
7
|
+
*/ import { clearLinkFocus, focusLink, installFocusBackgroundClick } from "../features/linkFocus.js";
|
|
8
|
+
import { isLinkDatum, linkHighlight, linkMeta, nodeHighlight } from "../features/linkInteraction.js";
|
|
9
|
+
import { setLoaderValue } from "../viz/loaderFormat.js";
|
|
10
|
+
import { simpleHover } from "../viz/simpleHover.js";
|
|
11
|
+
/** The box around a drawn link, or null when it isn't drawn. */ export function flowLinkBox(viz, d) {
|
|
12
|
+
const index = linkMeta(d)?.index;
|
|
13
|
+
const links = viz.ctx.geomapCtx?.flowLinks ?? [];
|
|
14
|
+
const link = links.find((l)=>l.index === index);
|
|
15
|
+
return link ? link.box : null;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
What hovering `d` emphasizes: a link and its two ends, or a mark that
|
|
19
|
+
ends links and those links. Null for anything else.
|
|
20
|
+
*/ export function flowHoverPredicate(viz, d) {
|
|
21
|
+
const nodeKey = (h, hi)=>`${viz._id(h, hi)}`;
|
|
22
|
+
if (isLinkDatum(d)) return linkHighlight(viz, d, nodeKey);
|
|
23
|
+
return nodeHighlight(viz, d, nodeKey);
|
|
24
|
+
}
|
|
25
|
+
/** Installs `links` and the link hover, click, and focus handlers. */ export function setupGeomapLinks(viz) {
|
|
26
|
+
const v = viz;
|
|
27
|
+
/**
|
|
28
|
+
Lines between places on the map, each drawn along the great circle
|
|
29
|
+
between its two ends (lifted into an arc by `linkCurve`). Each link's
|
|
30
|
+
`source` and `target` is a `[longitude, latitude]` coordinate, or the
|
|
31
|
+
id of a row in the data (or of a topojson feature): a row with a
|
|
32
|
+
coordinate `point` links from that point, and any other id from the
|
|
33
|
+
centroid of its topojson shape. Accepts an array of links, or a
|
|
34
|
+
URL/filepath to load them from. `linksFormat` transforms them; a
|
|
35
|
+
function passed as a second argument sets it.
|
|
36
|
+
@type {object[] | string}
|
|
37
|
+
*/ v.links = function() {
|
|
38
|
+
if (arguments.length) {
|
|
39
|
+
// eslint-disable-next-line prefer-rest-params
|
|
40
|
+
setLoaderValue(this, "links", arguments);
|
|
41
|
+
return this;
|
|
42
|
+
}
|
|
43
|
+
return this.schema.links;
|
|
44
|
+
};
|
|
45
|
+
installFocusBackgroundClick(viz);
|
|
46
|
+
const on = viz.schema.on;
|
|
47
|
+
let hovering = false;
|
|
48
|
+
const move = on["mousemove.shape"];
|
|
49
|
+
on["mousemove.shape"] = (d, i, x, event)=>{
|
|
50
|
+
move?.(d, i, x, event);
|
|
51
|
+
const predicate = flowHoverPredicate(viz, d);
|
|
52
|
+
if (predicate) {
|
|
53
|
+
hovering = true;
|
|
54
|
+
// Geomap's own hover is off (`hoverOpacity: 1`), so set the predicate
|
|
55
|
+
// directly; the scene emphasizes the matches.
|
|
56
|
+
simpleHover.call(viz, predicate);
|
|
57
|
+
}
|
|
58
|
+
};
|
|
59
|
+
const leave = on["mouseleave.shape"];
|
|
60
|
+
on["mouseleave.shape"] = (d, i, x, event)=>{
|
|
61
|
+
leave?.(d, i, x, event);
|
|
62
|
+
if (!hovering) return;
|
|
63
|
+
hovering = false;
|
|
64
|
+
simpleHover.call(viz, false);
|
|
65
|
+
};
|
|
66
|
+
const click = on["click.shape"];
|
|
67
|
+
on["click.shape"] = (d, i, x, event)=>{
|
|
68
|
+
if (isLinkDatum(d)) {
|
|
69
|
+
event?.stopPropagation?.();
|
|
70
|
+
focusLink(viz, d, {
|
|
71
|
+
nodeKey: (h, hi)=>`${viz._id(h, hi)}`,
|
|
72
|
+
box: flowLinkBox(viz, d)
|
|
73
|
+
});
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
if (clearLinkFocus(viz)) return;
|
|
77
|
+
return click?.(d, i, x, event);
|
|
78
|
+
};
|
|
79
|
+
// The ocean beneath an SVG map takes the clicks between marks.
|
|
80
|
+
const draw = viz._draw.bind(viz);
|
|
81
|
+
viz._draw = function(callback) {
|
|
82
|
+
const result = draw(callback);
|
|
83
|
+
viz._container?.select("rect.d3plus-geomap-ocean").on("click.linkFocus", ()=>clearLinkFocus(viz));
|
|
84
|
+
return result;
|
|
85
|
+
};
|
|
86
|
+
}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The config Geomap's links add: `links` and how they are sized, curved,
|
|
3
|
+
bundled, colored, labeled, and pointed, and the tooltips that read them.
|
|
4
|
+
*/ import constant from "../../utils/constant.js";
|
|
5
|
+
import { linkBundleFields, linkSizeMaxField, linkStyleFields } from "../features/linkFields.js";
|
|
6
|
+
import { linkTooltipConfig } from "../features/linkInteraction.js";
|
|
7
|
+
/** Geomap's link fields. */ export function geomapLinkFields() {
|
|
8
|
+
return [
|
|
9
|
+
/**
|
|
10
|
+
Draws arrowheads on the links: `true` (or `"target"`) at each link's
|
|
11
|
+
target end, `"source"` at its source end, `"both"`, or `false` for
|
|
12
|
+
none. Also accepts an accessor function returning one of those per
|
|
13
|
+
link.
|
|
14
|
+
@type {boolean | "target" | "source" | "both" | function}
|
|
15
|
+
*/ {
|
|
16
|
+
key: "arrows",
|
|
17
|
+
default: false
|
|
18
|
+
},
|
|
19
|
+
/**
|
|
20
|
+
The arrowhead size in pixels, or an accessor function returning one
|
|
21
|
+
per link. Defaults to three times the link's stroke width (at least
|
|
22
|
+
6), held to 12 pixels on wide links but never under one and a half
|
|
23
|
+
times the stroke, so the head stays wider than its line.
|
|
24
|
+
@type {number | function}
|
|
25
|
+
*/ {
|
|
26
|
+
key: "arrowSize"
|
|
27
|
+
},
|
|
28
|
+
...linkStyleFields(),
|
|
29
|
+
...linkBundleFields(),
|
|
30
|
+
{
|
|
31
|
+
key: "links",
|
|
32
|
+
default: []
|
|
33
|
+
},
|
|
34
|
+
/**
|
|
35
|
+
How far each link bows into an arc, as a share of the distance
|
|
36
|
+
between its ends: `0` draws the plain great-circle path, and the
|
|
37
|
+
default `0.2` lifts its middle by a fifth of that distance, to the
|
|
38
|
+
left of the link's direction (a negative value bows to the right),
|
|
39
|
+
so links running both ways between two places stay apart. On a
|
|
40
|
+
flat map, a link whose great circle the projection cuts (across the
|
|
41
|
+
antimeridian, or between `"geoAlbersUsa"`'s insets) is drawn on the
|
|
42
|
+
screen between its two ends instead, bowed the same way, so it
|
|
43
|
+
crosses the map rather than leaving by one edge. On a projection that
|
|
44
|
+
clips to a circle (a globe, such as `"geoOrthographic"`), links
|
|
45
|
+
follow the great circle without the lift, which would leave the
|
|
46
|
+
sphere.
|
|
47
|
+
@type {number}
|
|
48
|
+
*/ {
|
|
49
|
+
key: "linkCurve",
|
|
50
|
+
default: 0.2
|
|
51
|
+
},
|
|
52
|
+
/**
|
|
53
|
+
The thickness of each link: a pixel number used for every link, or
|
|
54
|
+
an accessor function whose values are scaled between `linkSizeMin`
|
|
55
|
+
and `linkSizeMax` (see `linkSizeScale`). The function receives each
|
|
56
|
+
link, with `source` and `target` set to the data at its ends, and
|
|
57
|
+
its index in `links`.
|
|
58
|
+
@type {number | function}
|
|
59
|
+
*/ {
|
|
60
|
+
key: "linkSize",
|
|
61
|
+
default: constant(2),
|
|
62
|
+
coerce: (v)=>typeof v === "function" ? v : constant(v)
|
|
63
|
+
},
|
|
64
|
+
/** The widest link, in pixels, when `linkSize` values differ. */ linkSizeMaxField(10),
|
|
65
|
+
/** The thinnest link, in pixels, when `linkSize` values differ. */ {
|
|
66
|
+
key: "linkSizeMin",
|
|
67
|
+
default: 1
|
|
68
|
+
},
|
|
69
|
+
/**
|
|
70
|
+
The type of [continuous d3-scale](https://github.com/d3/d3-scale#continuous-scales)
|
|
71
|
+
used to size links (e.g. `"linear"`, `"sqrt"`, `"log"`).
|
|
72
|
+
*/ {
|
|
73
|
+
key: "linkSizeScale",
|
|
74
|
+
default: "sqrt"
|
|
75
|
+
},
|
|
76
|
+
/**
|
|
77
|
+
How many links a point's or shape's tooltip lists under its number
|
|
78
|
+
of connections, strongest first: a number, or `false` for none.
|
|
79
|
+
Defaults to 3 when the links differ in `linkSize`, and none
|
|
80
|
+
otherwise.
|
|
81
|
+
@type {number | false}
|
|
82
|
+
*/ {
|
|
83
|
+
key: "nodeTooltipLinks"
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
key: "tooltipConfig",
|
|
87
|
+
merge: true,
|
|
88
|
+
factory: (viz)=>linkTooltipConfig(viz)
|
|
89
|
+
}
|
|
90
|
+
];
|
|
91
|
+
}
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure geometry for Geomap's links: which place a link end names, the
|
|
3
|
+
point a region's link ends at, and each link's path, a great circle
|
|
4
|
+
through the map's projection, optionally lifted into an arc.
|
|
5
|
+
*/ import { geoArea, geoCentroid, geoDistance, geoInterpolate } from "d3-geo";
|
|
6
|
+
import { polylinePath } from "../features/polyline.js";
|
|
7
|
+
export { polylineAt, polylineBox, polylineLength, polylineMidpoint, polylinePath, trimPolyline } from "../features/polyline.js";
|
|
8
|
+
/** Whether `v` is a `[longitude, latitude]` pair of finite numbers. */ export function isLonLat(v) {
|
|
9
|
+
return Array.isArray(v) && v.length === 2 && typeof v[0] === "number" && typeof v[1] === "number" && Number.isFinite(v[0]) && Number.isFinite(v[1]) && Math.abs(v[1]) <= 90;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
A row's `point` value as a coordinate: a pair whose two entries read as
|
|
13
|
+
finite numbers (CSV data gives strings), or null.
|
|
14
|
+
*/ export function toLonLat(v) {
|
|
15
|
+
if (!Array.isArray(v) || v.length < 2) return null;
|
|
16
|
+
const c = [
|
|
17
|
+
Number(v[0]),
|
|
18
|
+
Number(v[1])
|
|
19
|
+
];
|
|
20
|
+
return isLonLat(c) ? c : null;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
The point a link to a geographic feature ends at: the centroid of the
|
|
24
|
+
feature's largest polygon (so a country's link meets its mainland, not a
|
|
25
|
+
point between its islands), or of the whole geometry when it isn't a
|
|
26
|
+
MultiPolygon. Null when the feature has no geometry.
|
|
27
|
+
*/ export function featureAnchor(feature) {
|
|
28
|
+
const geometry = feature?.geometry;
|
|
29
|
+
if (!geometry) return null;
|
|
30
|
+
let part = geometry;
|
|
31
|
+
if (geometry.type === "MultiPolygon") {
|
|
32
|
+
const polygons = geometry.coordinates;
|
|
33
|
+
let best = -1;
|
|
34
|
+
for (const coordinates of polygons){
|
|
35
|
+
const polygon = {
|
|
36
|
+
type: "Polygon",
|
|
37
|
+
coordinates
|
|
38
|
+
};
|
|
39
|
+
const area = sphericalArea(polygon);
|
|
40
|
+
if (area > best) {
|
|
41
|
+
best = area;
|
|
42
|
+
part = polygon;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
let c = geoCentroid(part);
|
|
47
|
+
// A ring wound the wrong way encloses the rest of the sphere, whose
|
|
48
|
+
// centroid is the antipode of the shape's.
|
|
49
|
+
if (geoArea(part) > 2 * Math.PI) c = [
|
|
50
|
+
c[0] > 0 ? c[0] - 180 : c[0] + 180,
|
|
51
|
+
-c[1]
|
|
52
|
+
];
|
|
53
|
+
return isLonLat(c) ? c : null;
|
|
54
|
+
}
|
|
55
|
+
/** A shape's area on the unit sphere, whichever way its rings wind. */ function sphericalArea(object) {
|
|
56
|
+
const area = geoArea(object);
|
|
57
|
+
return Math.min(area, 4 * Math.PI - area);
|
|
58
|
+
}
|
|
59
|
+
/** `count + 1` evenly spaced points along the great circle from `a` to `b`. */ export function greatCircle(a, b, count) {
|
|
60
|
+
const interpolate = geoInterpolate(a, b);
|
|
61
|
+
const n = Math.max(1, Math.round(count));
|
|
62
|
+
return Array.from({
|
|
63
|
+
length: n + 1
|
|
64
|
+
}, (_, k)=>interpolate(k / n));
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
Lifts a polyline into an arc: each point moves off the straight line
|
|
68
|
+
between its ends, most at the middle, by `curve` times that line's
|
|
69
|
+
length, to the left of the direction of travel (right for a negative
|
|
70
|
+
`curve`). The ends stay put.
|
|
71
|
+
*/ export function liftPolyline(points, curve) {
|
|
72
|
+
if (!curve || points.length < 2) return points.slice();
|
|
73
|
+
const [x0, y0] = points[0];
|
|
74
|
+
const [x1, y1] = points[points.length - 1];
|
|
75
|
+
const length = Math.hypot(x1 - x0, y1 - y0);
|
|
76
|
+
if (!length) return points.slice();
|
|
77
|
+
// On screen (y down), the left of travel is the direction rotated -90°.
|
|
78
|
+
const nx = (y1 - y0) / length;
|
|
79
|
+
const ny = -(x1 - x0) / length;
|
|
80
|
+
const last = points.length - 1;
|
|
81
|
+
return points.map(([x, y], k)=>{
|
|
82
|
+
const t = k / last;
|
|
83
|
+
const h = 4 * t * (1 - t) * curve * length;
|
|
84
|
+
return [
|
|
85
|
+
x + nx * h,
|
|
86
|
+
y + ny * h
|
|
87
|
+
];
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
/** The numbers in a path string, in order. */ function pathNumbers(d) {
|
|
91
|
+
return (d.match(/-?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?/gi) ?? []).map(Number);
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
Whether d3-geo drew a line as one unbroken run from `a` to `b`: one
|
|
95
|
+
subpath, starting and ending (within a pixel) at the two points.
|
|
96
|
+
*/ export function unbrokenPath(d, a, b) {
|
|
97
|
+
if ((d.match(/M/g) ?? []).length !== 1) return false;
|
|
98
|
+
const n = pathNumbers(d);
|
|
99
|
+
if (n.length < 4) return false;
|
|
100
|
+
const near = (x, y, p)=>Math.abs(x - p[0]) <= 1 && Math.abs(y - p[1]) <= 1;
|
|
101
|
+
return near(n[0], n[1], a) && near(n[n.length - 2], n[n.length - 1], b);
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
Whether the projection cuts the great circle from `a` to `b` (across
|
|
105
|
+
the antimeridian, between geoAlbersUsa's insets, past a globe's horizon,
|
|
106
|
+
or anywhere else it breaks or shortens the line), so it isn't drawn as
|
|
107
|
+
one run from one end to the other.
|
|
108
|
+
*/ export function greatCircleCut(a, b, projection, path) {
|
|
109
|
+
const straight = path({
|
|
110
|
+
type: "LineString",
|
|
111
|
+
coordinates: [
|
|
112
|
+
a,
|
|
113
|
+
b
|
|
114
|
+
]
|
|
115
|
+
});
|
|
116
|
+
const pa = finitePoint(projection(a));
|
|
117
|
+
const pb = finitePoint(projection(b));
|
|
118
|
+
return !straight || !pa || !pb || !unbrokenPath(straight, pa, pb);
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
A link drawn on the screen between two projected points: the straight
|
|
122
|
+
line between them, bowed by `curve` the way `liftPolyline` bows it.
|
|
123
|
+
*/ export function screenArc(pa, pb, curve = 0) {
|
|
124
|
+
const chord = Math.hypot(pb[0] - pa[0], pb[1] - pa[1]);
|
|
125
|
+
const count = Math.min(128, Math.max(16, Math.ceil(chord / 4)));
|
|
126
|
+
const line = Array.from({
|
|
127
|
+
length: count + 1
|
|
128
|
+
}, (_, k)=>{
|
|
129
|
+
const t = k / count;
|
|
130
|
+
return [
|
|
131
|
+
pa[0] + (pb[0] - pa[0]) * t,
|
|
132
|
+
pa[1] + (pb[1] - pa[1]) * t
|
|
133
|
+
];
|
|
134
|
+
});
|
|
135
|
+
const drawn = liftPolyline(line, curve);
|
|
136
|
+
return {
|
|
137
|
+
d: polylinePath(drawn),
|
|
138
|
+
points: drawn
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
A link's path between two coordinates: the great circle between them
|
|
143
|
+
through the map's projection, lifted into an arc by `curve` (see
|
|
144
|
+
`liftPolyline`) when the projection draws it unbroken.
|
|
145
|
+
|
|
146
|
+
When the projection cuts the great circle, a flat map draws the link on
|
|
147
|
+
the screen between its two ends instead (see `screenArc`), so it
|
|
148
|
+
crosses the map rather than leaving by one edge and coming back by the
|
|
149
|
+
other. A globe (see `clipsToCircle`), or a flat map hiding one of the
|
|
150
|
+
ends, draws it as d3-geo clips it, without the lift. Null when the two
|
|
151
|
+
places are the same or the projection hides the whole path.
|
|
152
|
+
*/ export function flowArc(a, b, projection, path, curve = 0) {
|
|
153
|
+
if (!geoDistance(a, b)) return null;
|
|
154
|
+
const straight = path({
|
|
155
|
+
type: "LineString",
|
|
156
|
+
coordinates: [
|
|
157
|
+
a,
|
|
158
|
+
b
|
|
159
|
+
]
|
|
160
|
+
});
|
|
161
|
+
if (!straight) return null;
|
|
162
|
+
const pa = finitePoint(projection(a));
|
|
163
|
+
const pb = finitePoint(projection(b));
|
|
164
|
+
const flat = !clipsToCircle(projection);
|
|
165
|
+
const shown = (p)=>coordinateVisible(path, p);
|
|
166
|
+
const onScreen = ()=>flat && pa && pb && shown(a) && shown(b) ? screenArc(pa, pb, curve) : null;
|
|
167
|
+
if (!pa || !pb || !unbrokenPath(straight, pa, pb)) return onScreen() ?? {
|
|
168
|
+
d: straight,
|
|
169
|
+
points: null
|
|
170
|
+
};
|
|
171
|
+
const chord = Math.hypot(pb[0] - pa[0], pb[1] - pa[1]);
|
|
172
|
+
const count = Math.min(128, Math.max(16, Math.ceil(chord / 4)));
|
|
173
|
+
const points = [];
|
|
174
|
+
for (const p of greatCircle(a, b, count)){
|
|
175
|
+
const q = finitePoint(projection(p));
|
|
176
|
+
if (!q) return onScreen() ?? {
|
|
177
|
+
d: straight,
|
|
178
|
+
points: null
|
|
179
|
+
};
|
|
180
|
+
points.push(q);
|
|
181
|
+
}
|
|
182
|
+
const drawn = curve ? liftPolyline(points, curve) : points;
|
|
183
|
+
return {
|
|
184
|
+
d: curve ? polylinePath(drawn) : straight,
|
|
185
|
+
points: drawn
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
/** A projected point as a pair of finite numbers, or null. */ function finitePoint(q) {
|
|
189
|
+
return q && Number.isFinite(q[0]) && Number.isFinite(q[1]) ? [
|
|
190
|
+
q[0],
|
|
191
|
+
q[1]
|
|
192
|
+
] : null;
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
The runs of a path's `d` made of moves and lines (as d3-geo draws a
|
|
196
|
+
line, and `polylinePath` writes one): one polyline per `M`.
|
|
197
|
+
*/ export function pathRuns(d) {
|
|
198
|
+
const runs = [];
|
|
199
|
+
for (const [, command, args] of d.matchAll(/([ML])([^ML]*)/gi)){
|
|
200
|
+
const n = (args.match(/-?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?/gi) ?? []).map(Number);
|
|
201
|
+
if (command.toUpperCase() === "M" || !runs.length) runs.push([]);
|
|
202
|
+
const run = runs[runs.length - 1];
|
|
203
|
+
for(let k = 0; k + 1 < n.length; k += 2)run.push([
|
|
204
|
+
n[k],
|
|
205
|
+
n[k + 1]
|
|
206
|
+
]);
|
|
207
|
+
}
|
|
208
|
+
return runs.filter((run)=>run.length > 1);
|
|
209
|
+
}
|
|
210
|
+
/**
|
|
211
|
+
Whether a projection clips the sphere to a circle (a globe, or any
|
|
212
|
+
projection with a `clipAngle`), where a bowed arc would leave the disc.
|
|
213
|
+
*/ export function clipsToCircle(projection) {
|
|
214
|
+
const clipAngle = projection?.clipAngle;
|
|
215
|
+
if (typeof clipAngle !== "function") return false;
|
|
216
|
+
const angle = clipAngle.call(projection);
|
|
217
|
+
// An unset clip angle reads as 0 (clipping only at the antimeridian).
|
|
218
|
+
return typeof angle === "number" && Number.isFinite(angle) && angle > 0;
|
|
219
|
+
}
|
|
220
|
+
/** Whether the projection draws a coordinate, read through its clipping stream. */ export function coordinateVisible(path, coord) {
|
|
221
|
+
return !!path({
|
|
222
|
+
type: "Point",
|
|
223
|
+
coordinates: coord
|
|
224
|
+
});
|
|
225
|
+
}
|