@d3plus/core 4.9.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +170 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +17 -12
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Funnel/index.js +2 -1
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Gauge/index.js +2 -1
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +60 -19
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +37 -16
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/index.js +3 -2
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +93 -108
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +7 -2
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +66 -32
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +14 -4
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +5 -5
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +65 -30
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +75 -77
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +42 -15
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +123 -0
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +34 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +67 -79
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/facet/facetData.d.ts +1 -1
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +13 -1
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/features.d.ts +8 -0
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +19 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/missingFields.d.ts +57 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +2 -8
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,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
|
+
}
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Geomap's `links`: resolves each link's two ends to places on the map,
|
|
3
|
+
sizes the links from `linkSize`, and shapes each one's path.
|
|
4
|
+
|
|
5
|
+
A link end is either a `[longitude, latitude]` pair, drawn to that
|
|
6
|
+
coordinate, or an id (a string, a number, or an object with an `id`)
|
|
7
|
+
naming a row of the chart's data or a topojson feature. An id ends at
|
|
8
|
+
its row's coordinate point when the row has one (`point`), and otherwise
|
|
9
|
+
at the centroid of its topojson shape. Links with an end that names
|
|
10
|
+
nothing on the map are left out.
|
|
11
|
+
*/ import { extent } from "d3-array";
|
|
12
|
+
import * as scales from "d3-scale";
|
|
13
|
+
import { forgetLinkNodes, makeLinkDatum, publishLinkGraph, setLinkValue } from "../features/linkInteraction.js";
|
|
14
|
+
import { bundleLinkPaths } from "../features/linkBundle.js";
|
|
15
|
+
import { clipsToCircle, coordinateVisible, featureAnchor, flowArc, greatCircleCut, isLonLat, polylineBox, polylinePath, toLonLat } from "./flowGeometry.js";
|
|
16
|
+
/**
|
|
17
|
+
What a link end refers to: a coordinate, an id (as a string), or null
|
|
18
|
+
for anything else.
|
|
19
|
+
*/ export function linkEndRef(ref) {
|
|
20
|
+
if (isLonLat(ref)) return [
|
|
21
|
+
ref[0],
|
|
22
|
+
ref[1]
|
|
23
|
+
];
|
|
24
|
+
if (typeof ref === "string") return ref;
|
|
25
|
+
if (typeof ref === "number" && Number.isFinite(ref)) return `${ref}`;
|
|
26
|
+
if (ref && typeof ref === "object" && "id" in ref) {
|
|
27
|
+
const id = ref.id;
|
|
28
|
+
if (typeof id === "string" || typeof id === "number") return `${id}`;
|
|
29
|
+
}
|
|
30
|
+
return null;
|
|
31
|
+
}
|
|
32
|
+
/** A coordinate's name: its longitude and latitude, in the chart's locale. */ export function coordinateLabel(coord, locale) {
|
|
33
|
+
let format;
|
|
34
|
+
try {
|
|
35
|
+
const f = new Intl.NumberFormat(locale || undefined, {
|
|
36
|
+
maximumFractionDigits: 2
|
|
37
|
+
});
|
|
38
|
+
format = (n)=>f.format(n);
|
|
39
|
+
} catch {
|
|
40
|
+
format = (n)=>`${Math.round(n * 100) / 100}`;
|
|
41
|
+
}
|
|
42
|
+
return `${format(coord[0])}, ${format(coord[1])}`;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
Builds the resolver that turns a link end into the place it names on the
|
|
46
|
+
map (see the module notes), or null when it names nothing.
|
|
47
|
+
*/ export function flowEndResolver(v, input) {
|
|
48
|
+
const points = new Map();
|
|
49
|
+
input.pointData.forEach((d, i)=>{
|
|
50
|
+
const coord = toLonLat(v.schema.point(d, i));
|
|
51
|
+
if (!coord) return;
|
|
52
|
+
const id = `${v._id(d, i)}`;
|
|
53
|
+
if (points.has(id)) return;
|
|
54
|
+
const r = input.pointR(d, i);
|
|
55
|
+
points.set(id, {
|
|
56
|
+
data: d,
|
|
57
|
+
i,
|
|
58
|
+
id,
|
|
59
|
+
coord,
|
|
60
|
+
shape: "Circle",
|
|
61
|
+
r: Number.isFinite(r) ? r : 0
|
|
62
|
+
});
|
|
63
|
+
});
|
|
64
|
+
const shapes = new Map();
|
|
65
|
+
input.topoData.forEach((row, i)=>{
|
|
66
|
+
const id = `${row.id}`;
|
|
67
|
+
if (!shapes.has(id)) shapes.set(id, {
|
|
68
|
+
row,
|
|
69
|
+
i
|
|
70
|
+
});
|
|
71
|
+
});
|
|
72
|
+
const anchors = new Map();
|
|
73
|
+
const coords = new Map();
|
|
74
|
+
const locale = v.schema.locale;
|
|
75
|
+
return (ref)=>{
|
|
76
|
+
const key = linkEndRef(ref);
|
|
77
|
+
if (key === null) return null;
|
|
78
|
+
if (typeof key !== "string") {
|
|
79
|
+
const id = key.join(",");
|
|
80
|
+
if (!coords.has(id)) coords.set(id, {
|
|
81
|
+
data: {
|
|
82
|
+
point: key
|
|
83
|
+
},
|
|
84
|
+
i: 0,
|
|
85
|
+
id,
|
|
86
|
+
label: coordinateLabel(key, locale),
|
|
87
|
+
coord: key,
|
|
88
|
+
r: 0
|
|
89
|
+
});
|
|
90
|
+
return coords.get(id);
|
|
91
|
+
}
|
|
92
|
+
const point = points.get(key);
|
|
93
|
+
if (point) return point;
|
|
94
|
+
if (!anchors.has(key)) {
|
|
95
|
+
const shape = shapes.get(key);
|
|
96
|
+
const coord = shape ? featureAnchor(shape.row.feature) : null;
|
|
97
|
+
anchors.set(key, shape && coord ? {
|
|
98
|
+
// The datum the shape is drawn with, so hovering it finds its links.
|
|
99
|
+
data: shape.row.data ?? shape.row,
|
|
100
|
+
i: shape.i,
|
|
101
|
+
id: key,
|
|
102
|
+
coord,
|
|
103
|
+
shape: "Path",
|
|
104
|
+
r: 0
|
|
105
|
+
} : null);
|
|
106
|
+
}
|
|
107
|
+
return anchors.get(key);
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
The `[longitude, latitude]` ends of `links`, which the map's initial fit
|
|
112
|
+
takes in when it frames coordinate points.
|
|
113
|
+
*/ export function flowLinkCoordinates(links) {
|
|
114
|
+
if (!Array.isArray(links)) return [];
|
|
115
|
+
const out = [];
|
|
116
|
+
for (const link of links){
|
|
117
|
+
if (!link || typeof link !== "object") continue;
|
|
118
|
+
for (const ref of [
|
|
119
|
+
link.source,
|
|
120
|
+
link.target
|
|
121
|
+
])if (isLonLat(ref)) out.push([
|
|
122
|
+
ref[0],
|
|
123
|
+
ref[1]
|
|
124
|
+
]);
|
|
125
|
+
}
|
|
126
|
+
return out;
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
Link stroke widths from their `linkSize` values: scaled by the
|
|
130
|
+
continuous d3-scale `scaleName` onto `[min, max]` pixels when the values
|
|
131
|
+
differ, else each value as is. A missing value takes `min`.
|
|
132
|
+
*/ export function flowLinkWidths(sizes, { scale, min, max }) {
|
|
133
|
+
const values = sizes.map((s)=>typeof s === "number" && Number.isFinite(s) ? s : undefined);
|
|
134
|
+
const [lo, hi] = extent(values.filter((s)=>s !== undefined));
|
|
135
|
+
if (lo === undefined || hi === undefined || lo === hi) return values.map((s)=>s ?? min);
|
|
136
|
+
const name = `${scale || "sqrt"}`;
|
|
137
|
+
const factory = scales[`scale${name.charAt(0).toUpperCase()}${name.slice(1)}`];
|
|
138
|
+
const make = factory ?? scales.scaleSqrt;
|
|
139
|
+
const fn = make().domain([
|
|
140
|
+
lo,
|
|
141
|
+
hi
|
|
142
|
+
]).range([
|
|
143
|
+
min,
|
|
144
|
+
Math.max(min, max)
|
|
145
|
+
]);
|
|
146
|
+
return values.map((s)=>s === undefined ? min : fn(s));
|
|
147
|
+
}
|
|
148
|
+
/** The box around a path's points, read from its `d`. */ function pathBox(d) {
|
|
149
|
+
const n = (d.match(/-?(?:\d+\.?\d*|\.\d+)(?:e[-+]?\d+)?/gi) ?? []).map(Number);
|
|
150
|
+
const points = [];
|
|
151
|
+
for(let k = 0; k + 1 < n.length; k += 2)points.push([
|
|
152
|
+
n[k],
|
|
153
|
+
n[k + 1]
|
|
154
|
+
]);
|
|
155
|
+
return points.length ? polylineBox(points) : [
|
|
156
|
+
[
|
|
157
|
+
0,
|
|
158
|
+
0
|
|
159
|
+
],
|
|
160
|
+
[
|
|
161
|
+
0,
|
|
162
|
+
0
|
|
163
|
+
]
|
|
164
|
+
];
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
Bundles the links when `linkBundle` is on (see `bundleEdges`), on a flat
|
|
168
|
+
map only: each link the projection draws unbroken, both ends shown,
|
|
169
|
+
takes a bundled path between its two ends. Links on a globe, or ones
|
|
170
|
+
the projection cuts, keep their paths.
|
|
171
|
+
*/ export function bundleFlowLinks(v, links, projection, path) {
|
|
172
|
+
if (!v.schema.linkBundle || clipsToCircle(projection)) return;
|
|
173
|
+
const shown = links.filter((l)=>l.points && l.sourceAt && l.targetAt && !greatCircleCut(l.source.coord, l.target.coord, projection, path));
|
|
174
|
+
if (!shown.length) return;
|
|
175
|
+
const paths = bundleLinkPaths(v, shown.map((l)=>[
|
|
176
|
+
l.points[0],
|
|
177
|
+
l.points[l.points.length - 1]
|
|
178
|
+
]));
|
|
179
|
+
shown.forEach((l, k)=>{
|
|
180
|
+
l.points = paths[k];
|
|
181
|
+
l.d = polylinePath(paths[k]);
|
|
182
|
+
l.box = polylineBox(paths[k]);
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
/**
|
|
186
|
+
Resolves, sizes, and shapes the chart's `links` for this draw, and
|
|
187
|
+
publishes them for tooltips and hover (see `publishLinkGraph`).
|
|
188
|
+
*/ export function geomapFlowLinks(v, input) {
|
|
189
|
+
if (v._facetStep !== "panel") forgetLinkNodes(v);
|
|
190
|
+
const raw = Array.isArray(v.schema.links) ? v.schema.links : [];
|
|
191
|
+
const resolve = flowEndResolver(v, input);
|
|
192
|
+
const projection = v.schema.projection;
|
|
193
|
+
// On a globe a bowed arc would leave the disc, so links follow the sphere.
|
|
194
|
+
const drawnAt = (coord)=>{
|
|
195
|
+
const p = coordinateVisible(input.path, coord) ? projection(coord) : null;
|
|
196
|
+
return p && Number.isFinite(p[0]) && Number.isFinite(p[1]) ? p : null;
|
|
197
|
+
};
|
|
198
|
+
const curve = clipsToCircle(projection) ? 0 : Number(v.schema.linkCurve) || 0;
|
|
199
|
+
const drawn = [];
|
|
200
|
+
raw.forEach((row, index)=>{
|
|
201
|
+
if (!row || typeof row !== "object") return;
|
|
202
|
+
const source = resolve(row.source);
|
|
203
|
+
const target = resolve(row.target);
|
|
204
|
+
if (!source || !target) return;
|
|
205
|
+
const arc = flowArc(source.coord, target.coord, projection, input.path, curve);
|
|
206
|
+
if (!arc) return;
|
|
207
|
+
drawn.push({
|
|
208
|
+
datum: makeLinkDatum(row, source, target, index),
|
|
209
|
+
index,
|
|
210
|
+
source,
|
|
211
|
+
target,
|
|
212
|
+
...arc,
|
|
213
|
+
sourceAt: drawnAt(source.coord),
|
|
214
|
+
targetAt: drawnAt(target.coord),
|
|
215
|
+
box: arc.points ? polylineBox(arc.points) : pathBox(arc.d)
|
|
216
|
+
});
|
|
217
|
+
});
|
|
218
|
+
bundleFlowLinks(v, drawn, projection, input.path);
|
|
219
|
+
// Sized over the links drawn.
|
|
220
|
+
const linkSize = v.schema.linkSize;
|
|
221
|
+
const widths = flowLinkWidths(drawn.map((l)=>setLinkValue(l.datum, linkSize(l.datum, l.index))), {
|
|
222
|
+
scale: v.schema.linkSizeScale,
|
|
223
|
+
min: Number(v.schema.linkSizeMin) || 0,
|
|
224
|
+
max: Number(v.schema.linkSizeMax) || 0
|
|
225
|
+
});
|
|
226
|
+
const links = drawn.map((l, k)=>({
|
|
227
|
+
...l,
|
|
228
|
+
size: widths[k]
|
|
229
|
+
}));
|
|
230
|
+
const ends = new Map();
|
|
231
|
+
for (const link of links)for (const end of [
|
|
232
|
+
link.source,
|
|
233
|
+
link.target
|
|
234
|
+
])if (end.shape) ends.set(end.id, end);
|
|
235
|
+
publishLinkGraph(v, links.map((l)=>l.datum), [
|
|
236
|
+
...ends.values()
|
|
237
|
+
]);
|
|
238
|
+
return links;
|
|
239
|
+
}
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Geomap's caches across draws: the features of each topojson, the
|
|
3
|
+
projection fit, and each feature's projected path. A redraw with the same
|
|
4
|
+
topojson, chart size, and projection reuses them instead of streaming
|
|
5
|
+
every shape through the projection again.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ import { feature as topojsonFeature } from "topojson-client";
|
|
9
|
+
/** The features converted from each topojson object, by its key. */ const topoCache = new WeakMap();
|
|
10
|
+
/**
|
|
11
|
+
The features of the object `key` names in `topo` (or its first object),
|
|
12
|
+
as `topojson-client`'s `feature`. The conversion is kept per topojson, so
|
|
13
|
+
each draw gets new feature objects around the same geometries.
|
|
14
|
+
*/ export function topoFeatures(topo, key) {
|
|
15
|
+
const objects = topo.objects;
|
|
16
|
+
const k = key && objects[key] ? key : Object.keys(objects)[0];
|
|
17
|
+
let byKey = topoCache.get(topo);
|
|
18
|
+
if (!byKey) topoCache.set(topo, byKey = new Map());
|
|
19
|
+
let collection = byKey.get(k);
|
|
20
|
+
if (!collection) {
|
|
21
|
+
collection = topojsonFeature(topo, k);
|
|
22
|
+
byKey.set(k, collection);
|
|
23
|
+
}
|
|
24
|
+
return Array.isArray(collection.features) ? {
|
|
25
|
+
...collection,
|
|
26
|
+
features: collection.features.map((f)=>({
|
|
27
|
+
...f
|
|
28
|
+
}))
|
|
29
|
+
} : {
|
|
30
|
+
...collection
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
/** The projection settings that place points, besides a custom projection's own. */ const SETTINGS = [
|
|
34
|
+
"scale",
|
|
35
|
+
"translate",
|
|
36
|
+
"rotate",
|
|
37
|
+
"center",
|
|
38
|
+
"angle",
|
|
39
|
+
"reflectX",
|
|
40
|
+
"reflectY",
|
|
41
|
+
"parallels",
|
|
42
|
+
"clipAngle",
|
|
43
|
+
"clipExtent",
|
|
44
|
+
"precision",
|
|
45
|
+
"preclip",
|
|
46
|
+
"postclip"
|
|
47
|
+
];
|
|
48
|
+
/** Points spread over the globe, projected to tell projections apart. */ const PROBES = [
|
|
49
|
+
[
|
|
50
|
+
0,
|
|
51
|
+
0
|
|
52
|
+
],
|
|
53
|
+
[
|
|
54
|
+
-98,
|
|
55
|
+
39
|
|
56
|
+
],
|
|
57
|
+
[
|
|
58
|
+
-150,
|
|
59
|
+
61
|
|
60
|
+
],
|
|
61
|
+
[
|
|
62
|
+
-157,
|
|
63
|
+
21
|
|
64
|
+
],
|
|
65
|
+
[
|
|
66
|
+
-66,
|
|
67
|
+
18
|
|
68
|
+
],
|
|
69
|
+
[
|
|
70
|
+
12,
|
|
71
|
+
50
|
|
72
|
+
],
|
|
73
|
+
[
|
|
74
|
+
116,
|
|
75
|
+
40
|
|
76
|
+
],
|
|
77
|
+
[
|
|
78
|
+
151,
|
|
79
|
+
-34
|
|
80
|
+
],
|
|
81
|
+
[
|
|
82
|
+
-58,
|
|
83
|
+
-34
|
|
84
|
+
],
|
|
85
|
+
[
|
|
86
|
+
28,
|
|
87
|
+
-26
|
|
88
|
+
]
|
|
89
|
+
];
|
|
90
|
+
/** An id for each function a setting holds, so a new one changes the state. */ const functionIds = new WeakMap();
|
|
91
|
+
let nextFunctionId = 0;
|
|
92
|
+
/** A string that tells values apart: numbers exactly (-0 and NaN included), functions by identity. */ function serialize(value) {
|
|
93
|
+
if (typeof value === "function") {
|
|
94
|
+
let id = functionIds.get(value);
|
|
95
|
+
if (id === undefined) functionIds.set(value, id = nextFunctionId++);
|
|
96
|
+
return `f${id}`;
|
|
97
|
+
}
|
|
98
|
+
if (typeof value === "number") return Object.is(value, -0) ? "-0" : String(value);
|
|
99
|
+
if (Array.isArray(value)) return `[${value.map(serialize).join(",")}]`;
|
|
100
|
+
if (value === null || value === undefined) return String(value);
|
|
101
|
+
if (typeof value === "boolean" || typeof value === "string") return JSON.stringify(value);
|
|
102
|
+
return "?";
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
The state of `projection`: its settings and where it places a spread of
|
|
106
|
+
points. Two equal states draw the same paths (a projection with a setting
|
|
107
|
+
outside the list shows it in the points). Null when a setting can't be
|
|
108
|
+
read, which matches nothing.
|
|
109
|
+
*/ export function projectionState(projection) {
|
|
110
|
+
try {
|
|
111
|
+
const parts = [];
|
|
112
|
+
for (const name of SETTINGS){
|
|
113
|
+
const get = projection[name];
|
|
114
|
+
if (typeof get === "function") parts.push(`${name}=${serialize(get.call(projection))}`);
|
|
115
|
+
}
|
|
116
|
+
for (const p of PROBES)parts.push(serialize(projection(p)));
|
|
117
|
+
return parts.join(";");
|
|
118
|
+
} catch {
|
|
119
|
+
return null;
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
Whether two GeoJSON values are the same: the same object, or arrays and
|
|
124
|
+
plain objects whose entries are the same, numbers compared exactly.
|
|
125
|
+
*/ export function sameGeo(a, b) {
|
|
126
|
+
if (Object.is(a, b)) return true;
|
|
127
|
+
if (Array.isArray(a)) {
|
|
128
|
+
if (!Array.isArray(b) || a.length !== b.length) return false;
|
|
129
|
+
for(let i = 0; i < a.length; i++)if (!sameGeo(a[i], b[i])) return false;
|
|
130
|
+
return true;
|
|
131
|
+
}
|
|
132
|
+
if (!a || !b || typeof a !== "object" || typeof b !== "object" || Array.isArray(b) || Object.getPrototypeOf(a) !== Object.prototype || Object.getPrototypeOf(b) !== Object.prototype) return false;
|
|
133
|
+
const keys = Object.keys(a);
|
|
134
|
+
if (keys.length !== Object.keys(b).length) return false;
|
|
135
|
+
return keys.every((k)=>Object.prototype.hasOwnProperty.call(b, k) && sameGeo(a[k], b[k]));
|
|
136
|
+
}
|
|
137
|
+
const fits = new WeakMap();
|
|
138
|
+
/**
|
|
139
|
+
`projection.fitExtent(extent, object)`, skipped when the projection's
|
|
140
|
+
last fit was to the same extent and object and nothing about it has
|
|
141
|
+
changed since: fitting again would give the same scale and translate.
|
|
142
|
+
*/ export function fitExtentOnce(projection, extent, object) {
|
|
143
|
+
const last = fits.get(projection);
|
|
144
|
+
if (last && last.state !== null && sameGeo(last.extent, extent) && last.state === projectionState(projection) && sameGeo(last.object, object)) return;
|
|
145
|
+
projection.fitExtent(extent, object);
|
|
146
|
+
fits.set(projection, {
|
|
147
|
+
extent: [
|
|
148
|
+
[
|
|
149
|
+
...extent[0]
|
|
150
|
+
],
|
|
151
|
+
[
|
|
152
|
+
...extent[1]
|
|
153
|
+
]
|
|
154
|
+
],
|
|
155
|
+
object,
|
|
156
|
+
state: projectionState(projection)
|
|
157
|
+
});
|
|
158
|
+
}
|
|
159
|
+
/** Each projection's paths, by geometry, for the state they were drawn in. */ const paths = new WeakMap();
|
|
160
|
+
/**
|
|
161
|
+
`path(feature)` for each feature, kept by the feature's geometry while
|
|
162
|
+
`projection` stays in the same state (see `projectionState`).
|
|
163
|
+
*/ export function cachedPaths(projection, path) {
|
|
164
|
+
const state = projectionState(projection);
|
|
165
|
+
if (state === null) return path;
|
|
166
|
+
let cache = paths.get(projection);
|
|
167
|
+
if (cache?.state !== state) paths.set(projection, cache = {
|
|
168
|
+
state,
|
|
169
|
+
byGeometry: new WeakMap()
|
|
170
|
+
});
|
|
171
|
+
const { byGeometry } = cache;
|
|
172
|
+
return (feature)=>{
|
|
173
|
+
const geometry = feature?.geometry;
|
|
174
|
+
if (!geometry || typeof geometry !== "object") return path(feature);
|
|
175
|
+
if (byGeometry.has(geometry)) return byGeometry.get(geometry);
|
|
176
|
+
const d = path(feature);
|
|
177
|
+
byGeometry.set(geometry, d);
|
|
178
|
+
return d;
|
|
179
|
+
};
|
|
180
|
+
}
|