@d3plus/core 4.10.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 +167 -8
- 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 +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 +3 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +2 -1
- 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 +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/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 +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 +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 +32 -15
- 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/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 +86 -106
- 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 +5 -1
- 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 +64 -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/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 +8 -2
- 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 +18 -10
- 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/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 +34 -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/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 +2 -2
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -35
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- 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 +2 -3
- 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 +16 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +3 -7
- 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 +61 -28
- 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 +72 -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 +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/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +10 -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 +6 -5
- 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/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +8 -1
- package/es/src/charts/events/mousemove.shape.js +5 -2
- 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 +2 -1
- package/es/src/charts/features/axesFinal.js +3 -1
- package/es/src/charts/features/axesMeasure.js +7 -4
- 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 +2 -1
- package/es/src/charts/features/colorScaleHover.js +3 -2
- 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 +32 -14
- package/es/src/charts/features/featuresColorScale.js +20 -6
- package/es/src/charts/features/featuresLegend.js +15 -24
- 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 +38 -11
- 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 +47 -31
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +2 -2
- 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 +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/config.js +2 -3
- package/es/src/charts/viz/Viz.js +39 -36
- package/es/src/charts/viz/VizBase.js +18 -10
- package/es/src/charts/viz/backgroundInk.js +13 -7
- 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/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/vizDataPolling.js +8 -3
- package/es/src/charts/viz/vizDefaults.js +15 -23
- package/es/src/charts/viz/vizFields.js +35 -0
- package/es/src/charts/viz/vizRender.js +43 -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 +6 -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 +5 -9
- package/es/src/components/Axis/axisLayoutScale.js +7 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -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 +15 -9
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- 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 +29 -65
- 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 +7 -3
- 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 +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 +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 +25 -12
- package/es/src/utils/configPrep.js +2 -1
- 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 +250 -8
- 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/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 +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/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 +15 -8
- 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 +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/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 +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/definition/ChartDefinition.d.ts +13 -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/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/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/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/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 +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 +14 -0
- 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 +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +16 -2
- package/types/src/charts/viz/VizBase.d.ts +6 -6
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- 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/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +32 -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 +84 -7
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +1 -0
- 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/axisRangeBreaks.d.ts +25 -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 +1 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- 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/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/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/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +981 -30
- package/types/src/utils/configPrep.d.ts +2 -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/umd/d3plus-core.full.js +86811 -61031
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +28392 -6498
- 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,301 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure geometry for Sankey's circular links: the links that loop back into
|
|
3
|
+
a node they left (see `sankeyAcyclicLinks`), drawn as bands that leave
|
|
4
|
+
the source's right side, turn up (or down), run along a lane above (or
|
|
5
|
+
below) every node, and turn back into the target's left side.
|
|
6
|
+
*/ import { segmentMidpoint } from "../features/linkLabelGeometry.js";
|
|
7
|
+
import { edgeD, ribbonD } from "./ribbons.js";
|
|
8
|
+
/** The corner radius of the innermost band's turns, past half its width. */ export const CIRCULAR_RADIUS = 8;
|
|
9
|
+
/** The gap between the nodes and the innermost lane, in pixels. */ export const CIRCULAR_CLEARANCE = 12;
|
|
10
|
+
/**
|
|
11
|
+
Which side a circular link's lane runs along: above the nodes when the
|
|
12
|
+
middle of its two ends sits in the upper half of the nodes' extent
|
|
13
|
+
(`top` to `bottom`), else below. Each return band stays on the half of
|
|
14
|
+
the chart its ends are on, so its legs are short and it crosses as few
|
|
15
|
+
other bands as it can.
|
|
16
|
+
*/ export function circularLinkSide(link, top, bottom) {
|
|
17
|
+
const { source: s, target: t } = link;
|
|
18
|
+
const middle = (s.y0 + s.y1 + t.y0 + t.y1) / 4;
|
|
19
|
+
return middle <= (top + bottom) / 2 ? "top" : "bottom";
|
|
20
|
+
}
|
|
21
|
+
/** How many columns a circular link's lane spans (0 for a link to itself). */ const span = (l)=>Math.abs(l.source.layer - l.target.layer);
|
|
22
|
+
/**
|
|
23
|
+
Orders one side's circular links from the innermost lane (closest to the
|
|
24
|
+
nodes) outward: shorter spans first, so short loops nest inside long
|
|
25
|
+
ones; then links nearer that side (higher, for the top) first, so a
|
|
26
|
+
band never turns across the bands that leave above it; then heavier
|
|
27
|
+
first, then in the order given. The order is the links' stacking at
|
|
28
|
+
each node too: an inner band attaches closer to the node's edge.
|
|
29
|
+
*/ export function circularLinkOrder(links, side) {
|
|
30
|
+
const near = side === "top" ? 1 : -1;
|
|
31
|
+
const edge = (n)=>side === "top" ? n.y0 : n.y1;
|
|
32
|
+
return links.slice().sort((a, b)=>span(a) - span(b) || near * (edge(a.source) - edge(b.source)) || near * (edge(a.target) - edge(b.target)) || b.value - a.value || a.index - b.index);
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
Each circular link's lane and legs, for one side's links in the order of
|
|
36
|
+
`circularLinkOrder`. The legs leaving (or entering) one column nest,
|
|
37
|
+
each turning around the ones inside it. A lane sits outside every
|
|
38
|
+
earlier lane it would run into: one whose band, legs included, spans
|
|
39
|
+
some of the same width of the chart.
|
|
40
|
+
@param links One side's links, innermost first.
|
|
41
|
+
@param columnX Where a column's nodes sit across: their left and right
|
|
42
|
+
edges.
|
|
43
|
+
*/ export function circularLanes(links, columnX) {
|
|
44
|
+
const inside = {
|
|
45
|
+
source: new Map(),
|
|
46
|
+
target: new Map()
|
|
47
|
+
};
|
|
48
|
+
const arc = (end, l)=>{
|
|
49
|
+
const layer = l[end].layer;
|
|
50
|
+
const before = inside[end].get(layer) ?? 0;
|
|
51
|
+
inside[end].set(layer, before + l.width);
|
|
52
|
+
return CIRCULAR_RADIUS + before + l.width / 2;
|
|
53
|
+
};
|
|
54
|
+
const lanes = links.map((l)=>({
|
|
55
|
+
depth: 0,
|
|
56
|
+
arcSource: arc("source", l),
|
|
57
|
+
arcTarget: arc("target", l)
|
|
58
|
+
}));
|
|
59
|
+
// Where each band reaches across, from its target's leg to its source's.
|
|
60
|
+
const spans = links.map((l, k)=>{
|
|
61
|
+
const right = columnX(l.source.layer)[1] + lanes[k].arcSource;
|
|
62
|
+
const left = columnX(l.target.layer)[0] - lanes[k].arcTarget;
|
|
63
|
+
const half = l.width / 2;
|
|
64
|
+
return [
|
|
65
|
+
Math.min(left, right) - half,
|
|
66
|
+
Math.max(left, right) + half
|
|
67
|
+
];
|
|
68
|
+
});
|
|
69
|
+
links.forEach((l, k)=>{
|
|
70
|
+
for(let j = 0; j < k; j++)if (spans[j][0] < spans[k][1] && spans[k][0] < spans[j][1]) lanes[k].depth = Math.max(lanes[k].depth, lanes[j].depth + links[j].width);
|
|
71
|
+
});
|
|
72
|
+
return lanes;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
The space the circular links need outside the nodes: above and below
|
|
76
|
+
for their lanes, and beside the first and last columns for their legs.
|
|
77
|
+
@param sides Each side's links (in the order of `circularLinkOrder`)
|
|
78
|
+
and their lanes.
|
|
79
|
+
@param lastLayer The index of the last column.
|
|
80
|
+
*/ export function circularReserve(sides, lastLayer) {
|
|
81
|
+
const out = {
|
|
82
|
+
top: 0,
|
|
83
|
+
right: 0,
|
|
84
|
+
bottom: 0,
|
|
85
|
+
left: 0
|
|
86
|
+
};
|
|
87
|
+
for (const { side, links, lanes } of sides){
|
|
88
|
+
links.forEach((l, k)=>{
|
|
89
|
+
const lane = lanes[k];
|
|
90
|
+
const reach = CIRCULAR_CLEARANCE + lane.depth + l.width;
|
|
91
|
+
out[side] = Math.max(out[side], reach);
|
|
92
|
+
if (l.source.layer === lastLayer) out.right = Math.max(out.right, lane.arcSource + l.width / 2);
|
|
93
|
+
if (l.target.layer === 0) out.left = Math.max(out.left, lane.arcTarget + l.width / 2);
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
return out;
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
A circular link's band: where it leaves its source (`y0`) and enters
|
|
100
|
+
its target (`y1`), its legs, and its lane, which runs `CIRCULAR_CLEARANCE`
|
|
101
|
+
plus its lane's `depth` outside `edge` (the top of the highest node, or
|
|
102
|
+
the bottom of the lowest). Each turn's radius is its arc, or less where
|
|
103
|
+
the band's leg is too short for two.
|
|
104
|
+
*/ export function circularLinkShape(link, lane, side, edge) {
|
|
105
|
+
const dir = side === "top" ? -1 : 1;
|
|
106
|
+
const laneY = edge + dir * (CIRCULAR_CLEARANCE + lane.depth + link.width / 2);
|
|
107
|
+
const sy = link.y0;
|
|
108
|
+
const ty = link.y1;
|
|
109
|
+
return {
|
|
110
|
+
side,
|
|
111
|
+
xs: link.source.x1,
|
|
112
|
+
sy,
|
|
113
|
+
xt: link.target.x0,
|
|
114
|
+
ty,
|
|
115
|
+
laneY,
|
|
116
|
+
xr: link.source.x1 + lane.arcSource,
|
|
117
|
+
rs: Math.max(0, Math.min(lane.arcSource, Math.abs(sy - laneY) / 2)),
|
|
118
|
+
xl: link.target.x0 - lane.arcTarget,
|
|
119
|
+
rt: Math.max(0, Math.min(lane.arcTarget, Math.abs(ty - laneY) / 2))
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
/** The cubic Bézier curve's share of a quarter circle's radius at its handles. */ const kappa = 0.5523;
|
|
123
|
+
/**
|
|
124
|
+
A circular link's center line from its source to its target, made of
|
|
125
|
+
straight runs and quarter turns.
|
|
126
|
+
*/ export function circularLinkEdge(shape) {
|
|
127
|
+
const { xs, sy, xt, ty, laneY, xr, rs, xl, rt } = shape;
|
|
128
|
+
const dir = shape.side === "top" ? -1 : 1;
|
|
129
|
+
const steps = [];
|
|
130
|
+
/** A quarter turn from `a`, heading `u`, to `b`, heading `v`. */ const turn = (a, u, b, v, r)=>{
|
|
131
|
+
steps.push({
|
|
132
|
+
to: a
|
|
133
|
+
});
|
|
134
|
+
steps.push({
|
|
135
|
+
c1: [
|
|
136
|
+
a[0] + u[0] * kappa * r,
|
|
137
|
+
a[1] + u[1] * kappa * r
|
|
138
|
+
],
|
|
139
|
+
c2: [
|
|
140
|
+
b[0] - v[0] * kappa * r,
|
|
141
|
+
b[1] - v[1] * kappa * r
|
|
142
|
+
],
|
|
143
|
+
to: b
|
|
144
|
+
});
|
|
145
|
+
};
|
|
146
|
+
turn([
|
|
147
|
+
xr - rs,
|
|
148
|
+
sy
|
|
149
|
+
], [
|
|
150
|
+
1,
|
|
151
|
+
0
|
|
152
|
+
], [
|
|
153
|
+
xr,
|
|
154
|
+
sy + dir * rs
|
|
155
|
+
], [
|
|
156
|
+
0,
|
|
157
|
+
dir
|
|
158
|
+
], rs);
|
|
159
|
+
turn([
|
|
160
|
+
xr,
|
|
161
|
+
laneY - dir * rs
|
|
162
|
+
], [
|
|
163
|
+
0,
|
|
164
|
+
dir
|
|
165
|
+
], [
|
|
166
|
+
xr - rs,
|
|
167
|
+
laneY
|
|
168
|
+
], [
|
|
169
|
+
-1,
|
|
170
|
+
0
|
|
171
|
+
], rs);
|
|
172
|
+
turn([
|
|
173
|
+
xl + rt,
|
|
174
|
+
laneY
|
|
175
|
+
], [
|
|
176
|
+
-1,
|
|
177
|
+
0
|
|
178
|
+
], [
|
|
179
|
+
xl,
|
|
180
|
+
laneY - dir * rt
|
|
181
|
+
], [
|
|
182
|
+
0,
|
|
183
|
+
-dir
|
|
184
|
+
], rt);
|
|
185
|
+
turn([
|
|
186
|
+
xl,
|
|
187
|
+
ty + dir * rt
|
|
188
|
+
], [
|
|
189
|
+
0,
|
|
190
|
+
-dir
|
|
191
|
+
], [
|
|
192
|
+
xl + rt,
|
|
193
|
+
ty
|
|
194
|
+
], [
|
|
195
|
+
1,
|
|
196
|
+
0
|
|
197
|
+
], rt);
|
|
198
|
+
steps.push({
|
|
199
|
+
to: [
|
|
200
|
+
xt,
|
|
201
|
+
ty
|
|
202
|
+
]
|
|
203
|
+
});
|
|
204
|
+
return {
|
|
205
|
+
start: [
|
|
206
|
+
xs,
|
|
207
|
+
sy
|
|
208
|
+
],
|
|
209
|
+
steps
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
/** A circular link's center line as a path (see `circularLinkEdge`). */ export function circularLinkD(shape) {
|
|
213
|
+
return edgeD(circularLinkEdge(shape));
|
|
214
|
+
}
|
|
215
|
+
/**
|
|
216
|
+
A circular link's band moved `offset` pixels outward, away from the
|
|
217
|
+
loop it makes (inward when negative): its straight runs move out and
|
|
218
|
+
its turns widen around the same centers.
|
|
219
|
+
*/ export function offsetCircularShape(shape, offset) {
|
|
220
|
+
const dir = shape.side === "top" ? -1 : 1;
|
|
221
|
+
return {
|
|
222
|
+
...shape,
|
|
223
|
+
sy: shape.sy - dir * offset,
|
|
224
|
+
ty: shape.ty - dir * offset,
|
|
225
|
+
laneY: shape.laneY + dir * offset,
|
|
226
|
+
xr: shape.xr + offset,
|
|
227
|
+
xl: shape.xl - offset,
|
|
228
|
+
rs: Math.max(0, shape.rs + offset),
|
|
229
|
+
rt: Math.max(0, shape.rt + offset)
|
|
230
|
+
};
|
|
231
|
+
}
|
|
232
|
+
/**
|
|
233
|
+
A circular link's band as a filled ribbon, `half` its thickness each
|
|
234
|
+
side of its center line.
|
|
235
|
+
*/ export function circularRibbonD(shape, half) {
|
|
236
|
+
return ribbonD(circularLinkEdge(offsetCircularShape(shape, half)), circularLinkEdge(offsetCircularShape(shape, -half)));
|
|
237
|
+
}
|
|
238
|
+
/** The middle of a circular link's lane, where its label goes. */ export function circularLinkAnchor(shape) {
|
|
239
|
+
return segmentMidpoint([
|
|
240
|
+
shape.xr - shape.rs,
|
|
241
|
+
shape.laneY
|
|
242
|
+
], [
|
|
243
|
+
shape.xl + shape.rt,
|
|
244
|
+
shape.laneY
|
|
245
|
+
]);
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
The value a node is sized by: the larger of the flow leaving it and the
|
|
249
|
+
flow entering it, counting circular links too.
|
|
250
|
+
@param i The node's index.
|
|
251
|
+
@param links Every link Sankey draws, with node indices for ends.
|
|
252
|
+
*/ export function sankeyNodeValue(i, links) {
|
|
253
|
+
let out = 0;
|
|
254
|
+
let into = 0;
|
|
255
|
+
for (const l of links){
|
|
256
|
+
const v = Number.isFinite(l.value) ? l.value : 0;
|
|
257
|
+
if (l.source === i) out += v;
|
|
258
|
+
if (l.target === i) into += v;
|
|
259
|
+
}
|
|
260
|
+
return Math.max(out, into);
|
|
261
|
+
}
|
|
262
|
+
/**
|
|
263
|
+
Moves where links meet each node to make room for its circular links:
|
|
264
|
+
those whose lanes run above stack down from the node's top (innermost
|
|
265
|
+
first), the node's other links follow below them, and those whose lanes
|
|
266
|
+
run below stack up from its bottom. Sets each circular link's `y0`
|
|
267
|
+
(where it leaves its source) and `y1` (where it enters its target), and
|
|
268
|
+
shifts the other links' ends down past the circular links above them.
|
|
269
|
+
@param sides Each side's circular links, in the order of `circularLinkOrder`.
|
|
270
|
+
@param links The other links, with the ends the layout gave them.
|
|
271
|
+
*/ export function stackCircularEnds(sides, links) {
|
|
272
|
+
const above = {
|
|
273
|
+
source: new Map(),
|
|
274
|
+
target: new Map()
|
|
275
|
+
};
|
|
276
|
+
const below = {
|
|
277
|
+
source: new Map(),
|
|
278
|
+
target: new Map()
|
|
279
|
+
};
|
|
280
|
+
for (const { side, links: circular } of sides){
|
|
281
|
+
const taken = side === "top" ? above : below;
|
|
282
|
+
for (const l of circular){
|
|
283
|
+
for (const end of [
|
|
284
|
+
"source",
|
|
285
|
+
"target"
|
|
286
|
+
]){
|
|
287
|
+
const node = l[end];
|
|
288
|
+
const before = taken[end].get(node) ?? 0;
|
|
289
|
+
taken[end].set(node, before + l.width);
|
|
290
|
+
const { y0, y1 } = node;
|
|
291
|
+
const y = side === "top" ? y0 + before + l.width / 2 : y1 - before - l.width / 2;
|
|
292
|
+
if (end === "source") l.y0 = y;
|
|
293
|
+
else l.y1 = y;
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
for (const l of links){
|
|
298
|
+
l.y0 += above.source.get(l.source) ?? 0;
|
|
299
|
+
l.y1 += above.target.get(l.target) ?? 0;
|
|
300
|
+
}
|
|
301
|
+
}
|
|
@@ -1,122 +1,192 @@
|
|
|
1
1
|
/**
|
|
2
2
|
`sankeyEmit` — link Paths + per-shape-type node groups (typically Rect).
|
|
3
3
|
Emits flat SceneNodes directly (no transient Shape compute pass).
|
|
4
|
-
*/ import {
|
|
5
|
-
import { drawNodeLabel, paintFromShapeConfig, resolveAccessor, shapeConfigFor } from "../features/emitHelpers.js";
|
|
4
|
+
*/ import { drawNodeLabel, paintFromShapeConfig, resolveAccessor, shapeConfigFor } from "../features/emitHelpers.js";
|
|
6
5
|
import { backgroundImageNodes } from "../features/backgroundImageEmit.js";
|
|
6
|
+
import { LINK_HIT_WIDTH, linkAriaLabel, linkHitPath, linkMeta } from "../features/linkInteraction.js";
|
|
7
|
+
import { linkColorResolver } from "../features/linkColor.js";
|
|
8
|
+
import { cubicMidpoint } from "../features/linkLabelGeometry.js";
|
|
9
|
+
import { emitLinkLabels, textLineBoxes } from "../features/linkLabels.js";
|
|
10
|
+
import { curvePoints } from "../features/linkLabelPath.js";
|
|
11
|
+
import { uniqueLinkKeys } from "../features/linkKeys.js";
|
|
12
|
+
import { circularLinkAnchor, circularLinkD, circularRibbonD } from "./circularLinks.js";
|
|
13
|
+
import { sankeyLabels } from "./labels.js";
|
|
14
|
+
import { bandRibbonD } from "./ribbons.js";
|
|
7
15
|
/**
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
16
|
+
A band's thickness: its layout width less a pixel each side, so
|
|
17
|
+
neighboring bands show a gap, and at least 1.
|
|
18
|
+
*/ export function sankeyBandThickness(link) {
|
|
19
|
+
const width = typeof link.width === "number" ? link.width : 0;
|
|
20
|
+
return Math.max(1, width - 2);
|
|
21
|
+
}
|
|
22
|
+
/** A link's band as a filled ribbon from node to node, `half` its thickness each side of its center line. */ export function sankeyRibbonD(link, half) {
|
|
23
|
+
if (link.circular) return circularRibbonD(link.circular, half);
|
|
24
|
+
return bandRibbonD(link.source.x1, link.y0 ?? 0, link.target.x0, link.y1 ?? 0, half);
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
Each link's key ids, `source-target`, unique across `links`: parallel
|
|
28
|
+
links after the first add their order among them (see `uniqueLinkKeys`).
|
|
29
|
+
A link's scene key is `sankey-link-${ids}`.
|
|
30
|
+
*/ export const sankeyLinkIds = (links)=>uniqueLinkKeys(links.map((l)=>`${l.source.id ?? ""}-${l.target.id ?? ""}`));
|
|
31
|
+
/**
|
|
32
|
+
Where a link's label goes: the middle of its band, which runs as a
|
|
33
|
+
horizontal link curve from where it leaves its source to where it enters
|
|
34
|
+
its target.
|
|
35
|
+
*/ export function sankeyLinkAnchor(link) {
|
|
36
|
+
if (link.circular) return circularLinkAnchor(link.circular);
|
|
37
|
+
if (typeof link.y0 !== "number" || typeof link.y1 !== "number") return null;
|
|
38
|
+
const x0 = link.source.x1;
|
|
39
|
+
const x1 = link.target.x0;
|
|
40
|
+
const xm = (x0 + x1) / 2;
|
|
41
|
+
return cubicMidpoint([
|
|
42
|
+
x0,
|
|
43
|
+
link.y0
|
|
44
|
+
], [
|
|
45
|
+
xm,
|
|
46
|
+
link.y0
|
|
47
|
+
], [
|
|
48
|
+
xm,
|
|
49
|
+
link.y1
|
|
50
|
+
], [
|
|
51
|
+
x1,
|
|
52
|
+
link.y1
|
|
53
|
+
]);
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
The curve a link's label follows: its band's centerline, or a circular
|
|
57
|
+
link's center line around its return lane.
|
|
58
|
+
*/ export function sankeyLinkPath(link) {
|
|
59
|
+
if (link.circular) return curvePoints(circularLinkD(link.circular));
|
|
60
|
+
if (typeof link.y0 !== "number" || typeof link.y1 !== "number") return null;
|
|
61
|
+
const x0 = link.source.x1;
|
|
62
|
+
const x1 = link.target.x0;
|
|
63
|
+
const xm = (x0 + x1) / 2;
|
|
64
|
+
return curvePoints(`M${x0},${link.y0}C${xm},${link.y0} ${xm},${link.y1} ${x1},${link.y1}`);
|
|
65
|
+
}
|
|
66
|
+
/** The link labels, centered on their bands, clear of every node. */ function sankeyLinkLabels(viz, c, nodeLabels, ids) {
|
|
67
|
+
return emitLinkLabels(viz, c.links.map((link, i)=>({
|
|
68
|
+
key: `sankey-link-${ids[i]}`,
|
|
69
|
+
link,
|
|
70
|
+
i,
|
|
71
|
+
anchor: sankeyLinkAnchor(link),
|
|
72
|
+
path: sankeyLinkPath(link),
|
|
73
|
+
priority: link.value
|
|
74
|
+
})), {
|
|
75
|
+
boxes: c.nodeGroups.flatMap(([, values])=>values.map((n)=>({
|
|
76
|
+
x: n.x0,
|
|
77
|
+
y: n.y0,
|
|
78
|
+
width: n.x1 - n.x0,
|
|
79
|
+
height: n.y1 - n.y0
|
|
80
|
+
}))),
|
|
81
|
+
labels: textLineBoxes(nodeLabels)
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
/** The nodes, their background images and their labels, and the labels on their own. */ function emitSankeyNodes(viz, c) {
|
|
85
|
+
const out = [];
|
|
86
|
+
const labels = [];
|
|
87
|
+
for (const [shapeKind, values] of c.nodeGroups ?? []){
|
|
88
|
+
if (!values.length) continue;
|
|
89
|
+
const cfg = shapeConfigFor(viz, shapeKind);
|
|
90
|
+
const start = out.length;
|
|
91
|
+
for(let i = 0; i < values.length; i++){
|
|
92
|
+
const d = values[i];
|
|
93
|
+
const datum = d.data ?? d;
|
|
94
|
+
const paint = paintFromShapeConfig(cfg, datum, d.i ?? i);
|
|
95
|
+
const aria = {
|
|
96
|
+
label: `${drawNodeLabel(viz, d, i)}.`
|
|
97
|
+
};
|
|
98
|
+
if (shapeKind === "Rect") {
|
|
99
|
+
out.push({
|
|
100
|
+
type: "rect",
|
|
101
|
+
key: `sankey-${shapeKind}-${d.id}`,
|
|
102
|
+
x: d.x0,
|
|
103
|
+
y: d.y0,
|
|
104
|
+
width: d.x1 - d.x0,
|
|
105
|
+
height: d.y1 - d.y0,
|
|
106
|
+
datum,
|
|
107
|
+
paint,
|
|
108
|
+
aria
|
|
109
|
+
});
|
|
110
|
+
} else if (shapeKind === "Circle") {
|
|
111
|
+
const r = Number(resolveAccessor(cfg.r, datum, d.i ?? i) ?? 0);
|
|
112
|
+
out.push({
|
|
113
|
+
type: "circle",
|
|
114
|
+
key: `sankey-${shapeKind}-${d.id}`,
|
|
115
|
+
cx: (d.x0 + d.x1) / 2,
|
|
116
|
+
cy: (d.y0 + d.y1) / 2,
|
|
117
|
+
r,
|
|
118
|
+
datum,
|
|
119
|
+
paint,
|
|
120
|
+
aria
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
// Other shape kinds: skipped (Sankey's default is Rect).
|
|
42
124
|
}
|
|
125
|
+
out.push(...backgroundImageNodes(cfg, out.slice(start), (k)=>{
|
|
126
|
+
const d = values[k];
|
|
127
|
+
return [
|
|
128
|
+
d.data ?? d,
|
|
129
|
+
d.i ?? k
|
|
130
|
+
];
|
|
131
|
+
}));
|
|
132
|
+
const own = sankeyLabels(viz, values, cfg, c.width, c.height);
|
|
133
|
+
labels.push(...own);
|
|
134
|
+
out.push(...own);
|
|
43
135
|
}
|
|
44
|
-
return
|
|
136
|
+
return {
|
|
137
|
+
out,
|
|
138
|
+
labels
|
|
139
|
+
};
|
|
45
140
|
}
|
|
46
141
|
export const sankeyEmit = ({ viz })=>{
|
|
47
142
|
const c = viz.ctx.sankeyCtx;
|
|
48
143
|
if (!c) return [];
|
|
49
144
|
const out = [];
|
|
50
145
|
// Sankey's link config is the raw `viz.schema.shapeConfig.Path` (no
|
|
51
|
-
// configPrep wrap)
|
|
52
|
-
//
|
|
146
|
+
// configPrep wrap): each link's datum is a plain resolved link, not
|
|
147
|
+
// d3plus-wrapped.
|
|
53
148
|
const linkConfig = viz.schema.shapeConfig?.Path ?? {};
|
|
149
|
+
const ids = sankeyLinkIds(c.links ?? []);
|
|
54
150
|
if (c.links && c.links.length) {
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
const datum = link;
|
|
151
|
+
const linkColor = linkColorResolver(viz);
|
|
152
|
+
for (const [j, link] of c.links.entries()){
|
|
153
|
+
const datum = link.datum;
|
|
154
|
+
const i = linkMeta(datum)?.index ?? 0;
|
|
58
155
|
const paint = paintFromShapeConfig(linkConfig, datum, i);
|
|
156
|
+
const color = linkColor(datum, link);
|
|
157
|
+
if (color) {
|
|
158
|
+
// A colored band is see-through, so the flows it crosses show.
|
|
159
|
+
paint.fill = color;
|
|
160
|
+
paint.fillOpacity = resolveAccessor(linkConfig.fillOpacity, datum, i) ?? 0.5;
|
|
161
|
+
}
|
|
162
|
+
const thickness = sankeyBandThickness(link);
|
|
163
|
+
const key = `sankey-link-${ids[j]}`;
|
|
59
164
|
out.push({
|
|
60
165
|
type: "path",
|
|
61
166
|
shapeType: "Link",
|
|
62
|
-
key
|
|
63
|
-
d:
|
|
167
|
+
key,
|
|
168
|
+
d: sankeyRibbonD(link, thickness / 2),
|
|
64
169
|
datum,
|
|
170
|
+
index: i,
|
|
65
171
|
paint,
|
|
66
172
|
aria: {
|
|
67
|
-
label:
|
|
173
|
+
label: linkAriaLabel(viz, datum)
|
|
68
174
|
}
|
|
69
175
|
});
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
const datum = d.data ?? d;
|
|
81
|
-
const paint = paintFromShapeConfig(cfg, datum, d.i ?? i);
|
|
82
|
-
const aria = {
|
|
83
|
-
label: `${drawNodeLabel(viz, d, i)}.`
|
|
84
|
-
};
|
|
85
|
-
if (shapeKind === "Rect") {
|
|
86
|
-
out.push({
|
|
87
|
-
type: "rect",
|
|
88
|
-
key: `sankey-${shapeKind}-${d.id}`,
|
|
89
|
-
x: d.x0,
|
|
90
|
-
y: d.y0,
|
|
91
|
-
width: d.x1 - d.x0,
|
|
92
|
-
height: d.y1 - d.y0,
|
|
93
|
-
datum,
|
|
94
|
-
paint,
|
|
95
|
-
aria
|
|
96
|
-
});
|
|
97
|
-
} else if (shapeKind === "Circle") {
|
|
98
|
-
const r = Number(resolveAccessor(cfg.r, datum, d.i ?? i) ?? 0);
|
|
99
|
-
out.push({
|
|
100
|
-
type: "circle",
|
|
101
|
-
key: `sankey-${shapeKind}-${d.id}`,
|
|
102
|
-
cx: (d.x0 + d.x1) / 2,
|
|
103
|
-
cy: (d.y0 + d.y1) / 2,
|
|
104
|
-
r,
|
|
105
|
-
datum,
|
|
106
|
-
paint,
|
|
107
|
-
aria
|
|
108
|
-
});
|
|
109
|
-
}
|
|
110
|
-
// Other shape kinds: skipped (Sankey's default is Rect).
|
|
111
|
-
}
|
|
112
|
-
out.push(...backgroundImageNodes(cfg, out.slice(start), (k)=>{
|
|
113
|
-
const d = values[k];
|
|
114
|
-
return [
|
|
115
|
-
d.data ?? d,
|
|
116
|
-
d.i ?? k
|
|
117
|
-
];
|
|
118
|
-
}));
|
|
176
|
+
// The ribbon, a few pixels wider, so thin bands are easy to point at.
|
|
177
|
+
out.push({
|
|
178
|
+
...linkHitPath(key, sankeyRibbonD(link, thickness / 2), datum, 0),
|
|
179
|
+
paint: {
|
|
180
|
+
fill: "transparent",
|
|
181
|
+
stroke: "transparent",
|
|
182
|
+
strokeWidth: LINK_HIT_WIDTH
|
|
183
|
+
},
|
|
184
|
+
shapeType: "Link"
|
|
185
|
+
});
|
|
119
186
|
}
|
|
120
187
|
}
|
|
188
|
+
const nodes = emitSankeyNodes(viz, c);
|
|
189
|
+
if (c.links && c.links.length) out.push(...sankeyLinkLabels(viz, c, nodes.labels, ids));
|
|
190
|
+
out.push(...nodes.out);
|
|
121
191
|
return out;
|
|
122
192
|
};
|