@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,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`alluvialEmit` — a filled ribbon per band, a rect per node with its label
|
|
3
|
+
beside it (Sankey's node labels), and the column titles.
|
|
4
|
+
*/
|
|
5
|
+
import type { ChartEmit } from "../definition/ChartDefinition.js";
|
|
6
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
7
|
+
/** A value as the chart prints it. */
|
|
8
|
+
export declare function formatAlluvialValue(viz: VizInstance, value: number): string;
|
|
9
|
+
export declare const alluvialEmit: ChartEmit;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Alluvial hover and tooltips. Hovering a band or a node highlights the
|
|
3
|
+
rows it carries, through every column: each band and node they pass
|
|
4
|
+
through. Tooltips title a band with its path and a node
|
|
5
|
+
with its category, then list the value and its share of the total.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
9
|
+
import type { AlluvialGraph } from "./aggregate.js";
|
|
10
|
+
/**
|
|
11
|
+
The ids of the bands and nodes a hovered datum highlights, or null when
|
|
12
|
+
the datum is not one of the chart's bands or nodes: every band and node
|
|
13
|
+
that the hovered band's or node's rows pass through, in every column.
|
|
14
|
+
@param graph The chart's graph.
|
|
15
|
+
@param d The hovered datum.
|
|
16
|
+
*/
|
|
17
|
+
export declare function alluvialHighlight(graph: AlluvialGraph, d: unknown): Set<string> | null;
|
|
18
|
+
/**
|
|
19
|
+
Replaces the chart's `mouseenter` handler: over a band or node it
|
|
20
|
+
highlights what `alluvialHighlight` names, and over anything else (a
|
|
21
|
+
color scale swatch) it falls back to the default handler.
|
|
22
|
+
@param viz The chart.
|
|
23
|
+
*/
|
|
24
|
+
export declare function installAlluvialHover(viz: VizInstance): void;
|
|
25
|
+
/** A tooltip's title: a band's path, or a node's category. */
|
|
26
|
+
export declare function alluvialTooltipTitle(viz: VizInstance, d: DataPoint, i: number): string;
|
|
27
|
+
/**
|
|
28
|
+
A tooltip's rows for a band or node: its column's title (for a node), its
|
|
29
|
+
value, and its share of the chart's total. Other datums get none.
|
|
30
|
+
*/
|
|
31
|
+
export declare function alluvialTooltipRows(viz: VizInstance, d: DataPoint): [string, string][];
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Alluvial — parallel sets: how rows flow across several categorical
|
|
3
|
+
dimensions, one column of category nodes per dimension.
|
|
4
|
+
|
|
5
|
+
Implementation files in this folder:
|
|
6
|
+
- `dimensions.ts` — resolves `dimensions` and `colorBy`.
|
|
7
|
+
- `aggregate.ts` — rows → nodes, bands split by origin, and paths.
|
|
8
|
+
- `layout.ts` — node order, node and band positions, ribbon paths.
|
|
9
|
+
- `titles.ts` — the column titles.
|
|
10
|
+
- `meta.ts` — what each drawn datum stands for, and the default `groupBy`.
|
|
11
|
+
- `applyLayout.ts` — chart-specific `TransformStage`.
|
|
12
|
+
- `emit.ts` — band ribbons, node rects and labels, column titles.
|
|
13
|
+
- `hover.ts` — path highlighting and tooltip content.
|
|
14
|
+
*/
|
|
15
|
+
import type { DataDrivenChartDefinition } from "../definition/ChartDefinition.js";
|
|
16
|
+
/** `value`'s setter: a data key, an accessor, or a constant. */
|
|
17
|
+
export declare function alluvialValue(value: unknown): unknown;
|
|
18
|
+
export declare const alluvialDef: DataDrivenChartDefinition;
|
|
19
|
+
/**
|
|
20
|
+
Creates an alluvial (parallel sets) chart from plain data rows: one
|
|
21
|
+
column per entry in `dimensions`, one node per category in each column,
|
|
22
|
+
and bands between neighboring columns sized by how many rows (or how
|
|
23
|
+
much `value`) flow between each pair of categories. Each band keeps the
|
|
24
|
+
color of its rows' category in the `colorBy` column across every column.
|
|
25
|
+
*/
|
|
26
|
+
declare const _default: new () => any;
|
|
27
|
+
export default _default;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Alluvial geometry: the node order within each column, each node's place
|
|
3
|
+
in its fixed column, each band's ends, and the ribbon drawn for a band.
|
|
4
|
+
*/
|
|
5
|
+
import type { AlluvialBand, AlluvialGraph, AlluvialNode } from "./aggregate.js";
|
|
6
|
+
/**
|
|
7
|
+
How the nodes in each column are ordered, top to bottom: `"crossings"`
|
|
8
|
+
by value in the first column and then each column by where its flows
|
|
9
|
+
come from, `"value"` by value (largest first), `"data"` by the order
|
|
10
|
+
categories first appear in the data, or a comparator.
|
|
11
|
+
*/
|
|
12
|
+
export type AlluvialNodeSort = "value" | "data" | "crossings" | ((a: AlluvialNode, b: AlluvialNode) => number);
|
|
13
|
+
/**
|
|
14
|
+
Where each node's incoming flows come from: the mean of the middles of
|
|
15
|
+
their source nodes, weighted by each flow's value and measured in value
|
|
16
|
+
units down the previous column (in its current order). A node with no
|
|
17
|
+
incoming flows sorts last.
|
|
18
|
+
@param column The nodes to place.
|
|
19
|
+
@param previous The previous column, already ordered.
|
|
20
|
+
*/
|
|
21
|
+
export declare function incomingBarycenters(column: AlluvialNode[], previous: AlluvialNode[]): Map<AlluvialNode, number>;
|
|
22
|
+
/**
|
|
23
|
+
Orders the nodes in every column by `sort` (see `AlluvialNodeSort`), and
|
|
24
|
+
sets each node's `rank` to its position. Ties keep the order the
|
|
25
|
+
categories first appeared in.
|
|
26
|
+
@param graph The aggregated graph; its columns are sorted in place.
|
|
27
|
+
@param sort The ordering.
|
|
28
|
+
*/
|
|
29
|
+
export declare function sortAlluvialColumns(graph: AlluvialGraph, sort?: AlluvialNodeSort): void;
|
|
30
|
+
/** The space an alluvial is laid out in, and its node sizing. */
|
|
31
|
+
export interface AlluvialLayoutOptions {
|
|
32
|
+
width: number;
|
|
33
|
+
height: number;
|
|
34
|
+
/** The space above the nodes kept for the column titles. */
|
|
35
|
+
top: number;
|
|
36
|
+
nodeWidth: number;
|
|
37
|
+
nodePadding: number;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
Where each of `n` columns sits: evenly spaced across `width`, the first
|
|
41
|
+
flush left and the last flush right (a single column is centered). Nodes
|
|
42
|
+
narrow when `nodeWidth` would leave less room between columns than a node.
|
|
43
|
+
@param n The number of columns.
|
|
44
|
+
@param width The width to spread them across.
|
|
45
|
+
@param nodeWidth The preferred node width.
|
|
46
|
+
@returns Each column's left edge, and the node width.
|
|
47
|
+
*/
|
|
48
|
+
export declare function alluvialColumns(n: number, width: number, nodeWidth: number): {
|
|
49
|
+
x: number[];
|
|
50
|
+
nodeWidth: number;
|
|
51
|
+
};
|
|
52
|
+
/**
|
|
53
|
+
Places every node and band. The columns sit where `alluvialColumns`
|
|
54
|
+
places them. The nodes in each column stack in rank order,
|
|
55
|
+
`nodePadding` apart (less when the most crowded column wouldn't fit),
|
|
56
|
+
centered in the space below `top`, with one value-to-pixel scale for
|
|
57
|
+
every column. Where bands leave a node they stack in the order of their
|
|
58
|
+
targets, and where they enter one in the order of their sources; bands
|
|
59
|
+
sharing both ends stack in the order of their origins.
|
|
60
|
+
@param graph The aggregated, sorted graph; its nodes and bands are positioned in place.
|
|
61
|
+
@param options The layout space and node sizing.
|
|
62
|
+
*/
|
|
63
|
+
export declare function layoutAlluvial(graph: AlluvialGraph, options: AlluvialLayoutOptions): void;
|
|
64
|
+
/**
|
|
65
|
+
A band's ribbon: a filled shape from its source node's right edge to its
|
|
66
|
+
target node's left edge, its top and bottom each an S-curve, so its
|
|
67
|
+
thickness at either end matches its share of the node it touches.
|
|
68
|
+
@param band A positioned band.
|
|
69
|
+
*/
|
|
70
|
+
export declare function alluvialRibbon(band: AlluvialBand): string;
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
What each Alluvial datum stands for. The chart draws merged rows (a node's
|
|
3
|
+
rows, a band's rows) and groups rows by origin for its legend; this keeps,
|
|
4
|
+
beside each of those datums, which node, band, or origin it is, and the
|
|
5
|
+
rows it holds. The chart's default `groupBy` reads it, so every datum
|
|
6
|
+
reports its origin (or node) as its id and takes its color from it.
|
|
7
|
+
*/
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { AlluvialBand, AlluvialNode } from "./aggregate.js";
|
|
11
|
+
import type { AlluvialDimension } from "./dimensions.js";
|
|
12
|
+
/** A datum's role in the chart. */
|
|
13
|
+
export type AlluvialMeta = {
|
|
14
|
+
kind: "group";
|
|
15
|
+
id: unknown;
|
|
16
|
+
rows: DataPoint[];
|
|
17
|
+
} | {
|
|
18
|
+
kind: "path";
|
|
19
|
+
id: unknown;
|
|
20
|
+
rows: DataPoint[];
|
|
21
|
+
} | {
|
|
22
|
+
kind: "node";
|
|
23
|
+
id: unknown;
|
|
24
|
+
node: AlluvialNode;
|
|
25
|
+
} | {
|
|
26
|
+
kind: "band";
|
|
27
|
+
id: unknown;
|
|
28
|
+
band: AlluvialBand;
|
|
29
|
+
};
|
|
30
|
+
/** The role recorded for `d`, if any. */
|
|
31
|
+
export declare function alluvialMeta(d: unknown): AlluvialMeta | undefined;
|
|
32
|
+
/** Records `d`'s role, and returns `d`. */
|
|
33
|
+
export declare function setAlluvialMeta<T extends object>(d: T, meta: AlluvialMeta): T;
|
|
34
|
+
/**
|
|
35
|
+
The source rows a drawn row stands for: a group's or a path row's rows,
|
|
36
|
+
or the row itself.
|
|
37
|
+
@param d A row from the chart's drawn rows.
|
|
38
|
+
*/
|
|
39
|
+
export declare function sourceRows(d: DataPoint): DataPoint[];
|
|
40
|
+
/**
|
|
41
|
+
The chart's dimensions and its `colorBy` column, resolved once per change
|
|
42
|
+
to `dimensions` or `colorBy`.
|
|
43
|
+
@param viz The chart.
|
|
44
|
+
*/
|
|
45
|
+
export declare function alluvialDimensions(viz: VizInstance): {
|
|
46
|
+
dims: AlluvialDimension[];
|
|
47
|
+
k: number;
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
The chart's default `groupBy`: a datum's recorded id, or for a plain data
|
|
51
|
+
row its category in the `colorBy` column.
|
|
52
|
+
@param viz The chart.
|
|
53
|
+
*/
|
|
54
|
+
export declare function alluvialGroupBy(viz: VizInstance): (d: DataPoint, i: number) => DataPoint[keyof DataPoint];
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Alluvial column titles: each dimension's title above its column, flush
|
|
3
|
+
with the first and last columns' outer edges and centered over the rest.
|
|
4
|
+
*/
|
|
5
|
+
import type { SceneNode } from "@d3plus/render";
|
|
6
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
7
|
+
import type { DimensionTitle } from "../ParallelCoordinates/titles.js";
|
|
8
|
+
/** The space between the titles and the nodes below them, in pixels. */
|
|
9
|
+
export declare const TITLE_GAP = 8;
|
|
10
|
+
/** A column title's box and how its text aligns in it. */
|
|
11
|
+
export interface AlluvialTitle extends DimensionTitle {
|
|
12
|
+
anchor: "start" | "middle" | "end";
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
Each titled column's title box, in chart coordinates (from y = 0, with no
|
|
16
|
+
height yet): a middle column's spans halfway to each neighbor, the first
|
|
17
|
+
column's runs from its left edge, and the last column's ends at its
|
|
18
|
+
right edge. Columns with an empty title get none.
|
|
19
|
+
@param texts Each column's title.
|
|
20
|
+
@param x Each column's left edge.
|
|
21
|
+
@param nodeWidth The node width.
|
|
22
|
+
@param width The chart width.
|
|
23
|
+
*/
|
|
24
|
+
export declare function alluvialTitleBoxes(texts: string[], x: number[], nodeWidth: number, width: number): AlluvialTitle[];
|
|
25
|
+
/** The column title style: `dimensionTitleConfig` over the chart's background ink. */
|
|
26
|
+
export declare function alluvialTitleStyle(viz: VizInstance, titles: AlluvialTitle[]): Record<string, unknown>;
|
|
27
|
+
/**
|
|
28
|
+
Sizes the title boxes to the tallest wrapped title and returns that
|
|
29
|
+
height (0 with no titles).
|
|
30
|
+
*/
|
|
31
|
+
export declare function sizeAlluvialTitles(titles: AlluvialTitle[], style: Record<string, unknown>, locale?: string): number;
|
|
32
|
+
/** The title text nodes: chrome, so no datum and no pointer events. */
|
|
33
|
+
export declare function alluvialTitleNodes(titles: AlluvialTitle[], style: Record<string, unknown>, locale?: string): SceneNode[];
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`applyArcDiagramLayout` — ArcDiagram's layout stage. Resolves nodes and
|
|
3
|
+
links the way Network does, orders the nodes along the line (`nodeSort`),
|
|
4
|
+
spaces them evenly, sizes them, fits their labels, and shapes each link as
|
|
5
|
+
an arc on its side of the line, flattened just enough that the tallest
|
|
6
|
+
arc fits. The result rides on `viz.ctx.arcCtx` for the emit.
|
|
7
|
+
*/
|
|
8
|
+
import type { TransformStage } from "../pipeline/stages.js";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
|
|
11
|
+
import type { LinkDatum } from "../features/linkInteraction.js";
|
|
12
|
+
import type { GraphNode } from "../Network/graph.js";
|
|
13
|
+
import type { ArcGeometry } from "./arcGeometry.js";
|
|
14
|
+
import type { ArcLabel } from "./arcLabels.js";
|
|
15
|
+
import type { SelfLoopGeometry } from "../features/selfLoops.js";
|
|
16
|
+
/** A laid-out node. `r` is its final radius. */
|
|
17
|
+
export interface ArcNode extends GraphNode {
|
|
18
|
+
x: number;
|
|
19
|
+
y: number;
|
|
20
|
+
/** Its index along the line. */
|
|
21
|
+
rank: number;
|
|
22
|
+
label: string;
|
|
23
|
+
group: unknown;
|
|
24
|
+
degree: number;
|
|
25
|
+
}
|
|
26
|
+
/** A laid-out link: the datum it is drawn with, its resolved ends, and its arc. */
|
|
27
|
+
export interface ArcLink {
|
|
28
|
+
datum: LinkDatum;
|
|
29
|
+
source: ArcNode;
|
|
30
|
+
target: ArcNode;
|
|
31
|
+
/** Stroke width, in pixels. */
|
|
32
|
+
size: number;
|
|
33
|
+
/** The link's index in `links`. */
|
|
34
|
+
index: number;
|
|
35
|
+
arc: ArcGeometry;
|
|
36
|
+
d: string;
|
|
37
|
+
/** The loop a link from a node to itself draws as, instead of an arc. */
|
|
38
|
+
loop?: SelfLoopGeometry;
|
|
39
|
+
}
|
|
40
|
+
/** Everything the emit needs. */
|
|
41
|
+
export interface ArcCtx {
|
|
42
|
+
nodes: ArcNode[];
|
|
43
|
+
links: ArcLink[];
|
|
44
|
+
labels: ArcLabel[];
|
|
45
|
+
/** Whether arcs run on the labels' side of the line, so the labels draw over a halo. */
|
|
46
|
+
labelHalo: boolean;
|
|
47
|
+
linkConfig: Record<string, unknown>;
|
|
48
|
+
}
|
|
49
|
+
type ScaleFn = ((v: number) => number) & {
|
|
50
|
+
domain?: (d: [number, number]) => ScaleFn;
|
|
51
|
+
range?: ((r: [number, number]) => ScaleFn) & (() => [number, number]);
|
|
52
|
+
};
|
|
53
|
+
/**
|
|
54
|
+
The node radius scale for nodes `spacing` pixels apart. Nodes are at most
|
|
55
|
+
`sizeMax` (default: just under half the spacing, up to 20px). Unsized
|
|
56
|
+
nodes all draw at `sizeMin` (within that cap); sized ones run from
|
|
57
|
+
`sizeMin` (or half the cap, if smaller) up to the cap.
|
|
58
|
+
*/
|
|
59
|
+
export declare function arcRadiusScale(values: number[] | null, opts: {
|
|
60
|
+
sizeMin: number;
|
|
61
|
+
sizeMax?: number;
|
|
62
|
+
sizeScale: string;
|
|
63
|
+
spacing: number;
|
|
64
|
+
}): ScaleFn;
|
|
65
|
+
/** A node's group for `nodeSort: "group"`: its top `groupBy` (or `nodeGroupBy`) level, else its color value. */
|
|
66
|
+
export declare function arcNodeGroup(v: VizInstance, n: GraphNode): unknown;
|
|
67
|
+
/** ArcDiagram's size-legend scale for a chart area of `width` × `height`. */
|
|
68
|
+
export declare function arcSizeLegendScale(v: VizInstance, width: number, height: number): SizeLegendScale | null;
|
|
69
|
+
export declare const applyArcDiagramLayout: TransformStage;
|
|
70
|
+
export {};
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure geometry for ArcDiagram: node order, node positions along the line,
|
|
3
|
+
which side of the line each arc takes, how far arcs are flattened to fit,
|
|
4
|
+
and each arc's path and arrowhead tip.
|
|
5
|
+
*/
|
|
6
|
+
import type { DataPoint } from "@d3plus/data";
|
|
7
|
+
import type { ArrowedEnd } from "../features/curvedArrows.js";
|
|
8
|
+
import type { EdgeArrowTrims } from "../features/edgeArrows.js";
|
|
9
|
+
/** How ArcDiagram orders its nodes along the line. */
|
|
10
|
+
export type NodeSort = "data" | "label" | "group" | "degree" | ((a: DataPoint, b: DataPoint) => number);
|
|
11
|
+
/** Which side of the line ArcDiagram draws its arcs on. */
|
|
12
|
+
export type ArcSide = "above" | "below" | "both";
|
|
13
|
+
/** The direction ArcDiagram's line runs. */
|
|
14
|
+
export type ArcOrient = "horizontal" | "vertical";
|
|
15
|
+
/** A node, with everything `sortArcNodes` can order it by. */
|
|
16
|
+
export interface SortableNode {
|
|
17
|
+
id: string;
|
|
18
|
+
/** The node's row, passed to a comparator `nodeSort`. */
|
|
19
|
+
datum: DataPoint;
|
|
20
|
+
label: string;
|
|
21
|
+
group?: unknown;
|
|
22
|
+
degree: number;
|
|
23
|
+
/** The node's position in `nodes`, which breaks every tie. */
|
|
24
|
+
order: number;
|
|
25
|
+
}
|
|
26
|
+
/** A link between two node ids. */
|
|
27
|
+
export interface IdLink {
|
|
28
|
+
source: {
|
|
29
|
+
id: string;
|
|
30
|
+
};
|
|
31
|
+
target: {
|
|
32
|
+
id: string;
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
How many link ends touch each node: a link counts once at each end, so a
|
|
37
|
+
link from a node to itself counts twice.
|
|
38
|
+
*/
|
|
39
|
+
export declare function nodeDegrees(links: readonly IdLink[]): Map<string, number>;
|
|
40
|
+
/** Compares two values: numbers by size, anything else as text, with numbers inside text read as numbers. */
|
|
41
|
+
export declare function naturalCompare(a: unknown, b: unknown): number;
|
|
42
|
+
/**
|
|
43
|
+
Orders nodes for the line: `"data"` keeps their order in `nodes`,
|
|
44
|
+
`"label"` sorts by label, `"group"` by group and then label, `"degree"`
|
|
45
|
+
puts the most connected first (then by label), and a comparator receives
|
|
46
|
+
two node rows. Ties keep the `nodes` order. Returns a new array.
|
|
47
|
+
*/
|
|
48
|
+
export declare function sortArcNodes<T extends SortableNode>(nodes: readonly T[], sort: NodeSort | undefined): T[];
|
|
49
|
+
/**
|
|
50
|
+
Evenly spaced positions for `count` nodes along a line of `length`
|
|
51
|
+
pixels starting at `start`: each node sits in the middle of an equal slot,
|
|
52
|
+
so neighbors are `length / count` apart and the end nodes sit half a slot
|
|
53
|
+
in from the ends.
|
|
54
|
+
*/
|
|
55
|
+
export declare function slotPositions(count: number, start: number, length: number): number[];
|
|
56
|
+
/**
|
|
57
|
+
The side an arc takes. With `"both"`, a link running forward along the
|
|
58
|
+
line (its source placed before its target) arcs above and a link running
|
|
59
|
+
backward arcs below, so the two directions read apart.
|
|
60
|
+
*/
|
|
61
|
+
export declare function arcSideOf(sourceRank: number, targetRank: number, side: ArcSide | undefined): "above" | "below";
|
|
62
|
+
/**
|
|
63
|
+
How much the arcs flatten to fit. A semicircle over the farthest-apart
|
|
64
|
+
pair on a side rises half its span; `height` is the room both sides share.
|
|
65
|
+
Every arc's height is `scale` times half its span, so heights stay
|
|
66
|
+
proportional to spans on both sides, and `scale` is 1 (true semicircles)
|
|
67
|
+
whenever they fit. Returns the scale and each side's tallest arc.
|
|
68
|
+
*/
|
|
69
|
+
export declare function arcScale(maxSpanAbove: number, maxSpanBelow: number, height: number): {
|
|
70
|
+
scale: number;
|
|
71
|
+
above: number;
|
|
72
|
+
below: number;
|
|
73
|
+
};
|
|
74
|
+
/** One arc: its ends along the line, the line's cross position, and its shape. */
|
|
75
|
+
export interface ArcGeometry {
|
|
76
|
+
/** The source and target positions along the line. */
|
|
77
|
+
from: number;
|
|
78
|
+
to: number;
|
|
79
|
+
/** The line's position across its direction (y when horizontal, x when vertical). */
|
|
80
|
+
base: number;
|
|
81
|
+
/** Arc height over half its span (1 draws a semicircle). */
|
|
82
|
+
scale: number;
|
|
83
|
+
side: "above" | "below";
|
|
84
|
+
orient: ArcOrient;
|
|
85
|
+
}
|
|
86
|
+
/** Maps a point along the line (`u`) and out from it toward the arc's side (`h`) to the screen. */
|
|
87
|
+
export declare function arcPoint(arc: ArcGeometry, u: number, h: number): [number, number];
|
|
88
|
+
/**
|
|
89
|
+
The arc's SVG path: half an ellipse from its source to its target, as wide
|
|
90
|
+
as their span and `scale` times half the span tall. Horizontal arcs
|
|
91
|
+
"above" rise toward the top; vertical arcs "above" bulge to the right.
|
|
92
|
+
*/
|
|
93
|
+
export declare function arcPathD(arc: ArcGeometry): string;
|
|
94
|
+
/** The arc's highest point: midway between its ends, `scale` times half its span out from the line. */
|
|
95
|
+
export declare function arcApex(arc: ArcGeometry): [number, number];
|
|
96
|
+
/**
|
|
97
|
+
Where an arrowhead at one end of an arc sits: on the arc, `inset` pixels
|
|
98
|
+
out from the line (clear of the node it points into), pointing along the
|
|
99
|
+
arc toward that end. `angle` is in radians.
|
|
100
|
+
*/
|
|
101
|
+
export declare function arcEndTip(arc: ArcGeometry, end: "source" | "target", inset: number): {
|
|
102
|
+
x: number;
|
|
103
|
+
y: number;
|
|
104
|
+
angle: number;
|
|
105
|
+
};
|
|
106
|
+
/**
|
|
107
|
+
The point on an arc's ellipse `length` pixels along it from where it
|
|
108
|
+
stands `inset` pixels out from the line at `end` (where `arcEndTip` puts
|
|
109
|
+
that end's arrow tip), toward the arc's top. It stops at the top.
|
|
110
|
+
*/
|
|
111
|
+
export declare function arcPointAlong(arc: ArcGeometry, end: "source" | "target", inset: number, length: number): [number, number];
|
|
112
|
+
/**
|
|
113
|
+
An arc's visible stroke and arrowed ends. Each head's tip sits on the
|
|
114
|
+
arc `insets` pixels out from the line (see `arcEndTip`), its base `size`
|
|
115
|
+
further along the arc, and it is aimed along the chord from base to tip.
|
|
116
|
+
The stroke follows the arc between the bases, then runs along each
|
|
117
|
+
head's axis to end inside it (see `cubicArrowEdge`). The full arc stays
|
|
118
|
+
its hit area.
|
|
119
|
+
*/
|
|
120
|
+
export declare function arcArrowEdge(arc: ArcGeometry, trims: EdgeArrowTrims, insets: {
|
|
121
|
+
source: number;
|
|
122
|
+
target: number;
|
|
123
|
+
}): {
|
|
124
|
+
d: string;
|
|
125
|
+
source?: ArrowedEnd;
|
|
126
|
+
target?: ArrowedEnd;
|
|
127
|
+
};
|
|
128
|
+
/** The box an arc covers: its two ends and its highest point, as `[[x0, y0], [x1, y1]]`. */
|
|
129
|
+
export declare function arcBox(arc: ArcGeometry): [[number, number], [number, number]];
|
|
130
|
+
/** The cross-axis layout: how far arcs flatten, and where the line sits. */
|
|
131
|
+
export declare function crossLayout(opts: {
|
|
132
|
+
cross: number;
|
|
133
|
+
spans: {
|
|
134
|
+
above: number;
|
|
135
|
+
below: number;
|
|
136
|
+
};
|
|
137
|
+
labelSide: "above" | "below";
|
|
138
|
+
labelBand: number;
|
|
139
|
+
rMax: number;
|
|
140
|
+
strokePad: number;
|
|
141
|
+
orient: ArcOrient;
|
|
142
|
+
/** How far loops reach out from the line, on each side. */
|
|
143
|
+
loops?: {
|
|
144
|
+
above: number;
|
|
145
|
+
below: number;
|
|
146
|
+
};
|
|
147
|
+
}): {
|
|
148
|
+
scale: number;
|
|
149
|
+
base: number;
|
|
150
|
+
};
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
ArcDiagram's node labels: one line each, on the side of the line away
|
|
3
|
+
from the arcs (under it when arcs take both sides, over a halo). Labels
|
|
4
|
+
that are too wide for their slot turn to -45°, then to -90° when even
|
|
5
|
+
that crowds, and when neighbors are closer than a line of text only
|
|
6
|
+
every few labels draw. Rotating keeps every label directly under its
|
|
7
|
+
node, in node order, which reads better along a dense line than
|
|
8
|
+
scattering labels into free space around each circle.
|
|
9
|
+
*/
|
|
10
|
+
import type { DataPoint } from "@d3plus/data";
|
|
11
|
+
import type { SceneNode } from "@d3plus/render";
|
|
12
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
13
|
+
import type { ArcOrient } from "./arcGeometry.js";
|
|
14
|
+
/** A label's rotation (degrees) and how many nodes apart drawn labels are. */
|
|
15
|
+
export interface LabelFit {
|
|
16
|
+
angle: 0 | -45 | -90;
|
|
17
|
+
step: number;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
Fits labels to node spacing: flat when the widest fits its slot, -45°
|
|
21
|
+
when neighbors sit far enough apart for slanted lines, else -90°. When
|
|
22
|
+
even upright lines crowd (vertical lines take flat labels only), every
|
|
23
|
+
`step`-th label draws.
|
|
24
|
+
@param maxWidth The widest label, in pixels.
|
|
25
|
+
@param spacing The distance between neighboring nodes.
|
|
26
|
+
@param lineHeight A label's line height.
|
|
27
|
+
*/
|
|
28
|
+
export declare function fitLabels(maxWidth: number, spacing: number, lineHeight: number, orient: ArcOrient): LabelFit;
|
|
29
|
+
/**
|
|
30
|
+
How far a label reaches out from the line (`depth`) and along it past its
|
|
31
|
+
node (`spread`), at `width` pixels wide and `angle` degrees.
|
|
32
|
+
*/
|
|
33
|
+
export declare function labelReach(angle: LabelFit["angle"], width: number, lineHeight: number, orient: ArcOrient): {
|
|
34
|
+
depth: number;
|
|
35
|
+
spread: number;
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
The widest a label may be so it reaches no more than `maxDepth` out from
|
|
39
|
+
the line (rotated or vertical-line labels only; flat labels on a
|
|
40
|
+
horizontal line are one line tall at any width).
|
|
41
|
+
*/
|
|
42
|
+
export declare function labelWidthLimit(angle: LabelFit["angle"], maxDepth: number, lineHeight: number, orient: ArcOrient): number;
|
|
43
|
+
/** One placed label. */
|
|
44
|
+
export interface ArcLabel {
|
|
45
|
+
id: string;
|
|
46
|
+
/** The node's row, which the label carries for hover. */
|
|
47
|
+
datum: DataPoint;
|
|
48
|
+
text: string;
|
|
49
|
+
/** The point the label hangs from, just past its node. */
|
|
50
|
+
x: number;
|
|
51
|
+
y: number;
|
|
52
|
+
angle: number;
|
|
53
|
+
/** The label's box around `x`/`y`, before rotation. */
|
|
54
|
+
box: {
|
|
55
|
+
x: number;
|
|
56
|
+
y: number;
|
|
57
|
+
width: number;
|
|
58
|
+
height: number;
|
|
59
|
+
};
|
|
60
|
+
anchor: "start" | "middle" | "end";
|
|
61
|
+
verticalAlign: "top" | "middle" | "bottom";
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
Places a label at one node. `side` is the side of the line the labels
|
|
65
|
+
take ("below" is under a horizontal line or left of a vertical one);
|
|
66
|
+
`gap` is the distance from the line to the label's near edge.
|
|
67
|
+
*/
|
|
68
|
+
export declare function placeArcLabel(opts: {
|
|
69
|
+
id: string;
|
|
70
|
+
datum: DataPoint;
|
|
71
|
+
text: string;
|
|
72
|
+
/** The node's position along the line, and the line's cross position. */
|
|
73
|
+
at: number;
|
|
74
|
+
base: number;
|
|
75
|
+
gap: number;
|
|
76
|
+
width: number;
|
|
77
|
+
spacing: number;
|
|
78
|
+
lineHeight: number;
|
|
79
|
+
angle: LabelFit["angle"];
|
|
80
|
+
side: "above" | "below";
|
|
81
|
+
orient: ArcOrient;
|
|
82
|
+
}): ArcLabel;
|
|
83
|
+
/**
|
|
84
|
+
Text nodes for placed labels: one line each in the chart's ink at
|
|
85
|
+
`pointLabelConfig.fontSize`, inert to the pointer. With `halo`, each
|
|
86
|
+
draws over a halo in the chart's background (see `textHalo`), which
|
|
87
|
+
keeps it readable where arcs pass behind it.
|
|
88
|
+
*/
|
|
89
|
+
export declare function emitArcLabels(viz: VizInstance, labels: readonly ArcLabel[], halo?: boolean): SceneNode[];
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
ArcDiagram's loops: a link from a node to itself draws as a small loop on
|
|
3
|
+
the arcs' side of the line, pointing straight out from it.
|
|
4
|
+
*/
|
|
5
|
+
import type { LinkDatum } from "../features/linkInteraction.js";
|
|
6
|
+
import type { ArcLink, ArcNode } from "./applyLayout.js";
|
|
7
|
+
import type { ArcOrient, ArcSide } from "./arcGeometry.js";
|
|
8
|
+
/** The side of the line a node's loops take: the arcs' side ("above" with `"both"`). */
|
|
9
|
+
export declare function loopSide(side: ArcSide): "above" | "below";
|
|
10
|
+
/**
|
|
11
|
+
How far a hairline loop on a node of radius `r` reaches out from it: as
|
|
12
|
+
a Network loop does (see `selfLoopReach`), and at least 30% of the
|
|
13
|
+
`spacing` between nodes (up to 40 pixels), so it reads at a glance. Its
|
|
14
|
+
stroke grows outward from there (see `selfLoopGeometry`).
|
|
15
|
+
*/
|
|
16
|
+
export declare function arcLoopReach(r: number, spacing: number): number;
|
|
17
|
+
/** The direction (radians) loops point on `side` of a line running `orient`. */
|
|
18
|
+
export declare function loopAngle(side: "above" | "below", orient: ArcOrient): number;
|
|
19
|
+
/**
|
|
20
|
+
The laid-out loops (links from a node to themselves), on the arcs' side
|
|
21
|
+
of the line, pointing straight out from it. A node's loops fan out side
|
|
22
|
+
by side.
|
|
23
|
+
*/
|
|
24
|
+
export declare function placeLoops(loops: {
|
|
25
|
+
index: number;
|
|
26
|
+
datum: LinkDatum;
|
|
27
|
+
size: number;
|
|
28
|
+
id: string;
|
|
29
|
+
}[], nodes: ArcNode[], geometry: {
|
|
30
|
+
base: number;
|
|
31
|
+
scale: number;
|
|
32
|
+
orient: ArcOrient;
|
|
33
|
+
side: "above" | "below";
|
|
34
|
+
spacing: number;
|
|
35
|
+
}): ArcLink[];
|
|
36
|
+
/**
|
|
37
|
+
How far the loops reach out from the line, past their nodes' centers,
|
|
38
|
+
on each side (all of them sit on `loopSide(side)`).
|
|
39
|
+
@param loops Each loop's node id and stroke width.
|
|
40
|
+
@param radii Each node's radius, by id.
|
|
41
|
+
*/
|
|
42
|
+
export declare function arcLoopRoom(loops: readonly {
|
|
43
|
+
id: string;
|
|
44
|
+
size: number;
|
|
45
|
+
}[], radii: ReadonlyMap<string, number>, spacing: number, side: ArcSide): {
|
|
46
|
+
above: number;
|
|
47
|
+
below: number;
|
|
48
|
+
};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`arcDiagramEmit` — ArcDiagram's scene: the arcs (longest first), a wider
|
|
3
|
+
transparent hit path over each so thin arcs are easy to point at, their
|
|
4
|
+
arrowheads, the nodes, and the node labels.
|
|
5
|
+
*/
|
|
6
|
+
import type { ChartEmit } from "../definition/ChartDefinition.js";
|
|
7
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
8
|
+
import type { ArcLink } from "./applyLayout.js";
|
|
9
|
+
import type { LinkAnchor } from "../features/linkLabelGeometry.js";
|
|
10
|
+
/** Where an arc's label goes: its highest point (a loop's far point), running with the line. */
|
|
11
|
+
export declare function arcLabelAnchor(link: ArcLink): LinkAnchor;
|
|
12
|
+
/**
|
|
13
|
+
The curve an arc's label follows: the arc between the edges of its two
|
|
14
|
+
nodes, or the loop.
|
|
15
|
+
*/
|
|
16
|
+
export declare function arcLabelPath(link: ArcLink): [number, number][];
|
|
17
|
+
/**
|
|
18
|
+
An arc's (or loop's) visible stroke: along it up to each arrowhead's
|
|
19
|
+
base, then along the head's axis to end inside it (see `arcArrowEdge`),
|
|
20
|
+
whose tips sit a pixel out past the nodes.
|
|
21
|
+
*/
|
|
22
|
+
export declare function arcVisibleD(viz: VizInstance, link: ArcLink): string;
|
|
23
|
+
export declare const arcDiagramEmit: ChartEmit;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
ArcDiagram's pointer handlers. Hovering a node highlights it, its
|
|
3
|
+
neighbors, and the arcs between them; hovering an arc highlights it and
|
|
4
|
+
its two ends. Clicking a node or arc focuses the same set and zooms to it
|
|
5
|
+
(clicking it again, or the background, resets), and clicking a legend
|
|
6
|
+
item focuses its nodes, as Network does.
|
|
7
|
+
*/
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
type Predicate = (d: DataPoint, i: number) => boolean;
|
|
11
|
+
type Toggle = (predicate?: Predicate | false) => unknown;
|
|
12
|
+
/** The chart's hover and active setters. */
|
|
13
|
+
export type ArcViz = VizInstance & {
|
|
14
|
+
hover: Toggle;
|
|
15
|
+
active: Toggle;
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
What hovering (or focusing) `d` highlights, and the box around it: for a
|
|
19
|
+
node, it, its neighbors, and their arcs; for an arc, it and its two ends.
|
|
20
|
+
Null when `d` is neither.
|
|
21
|
+
*/
|
|
22
|
+
export declare function arcFocus(viz: VizInstance, d: DataPoint, i: number): {
|
|
23
|
+
predicate: Predicate;
|
|
24
|
+
box: [[number, number], [number, number]];
|
|
25
|
+
} | null;
|
|
26
|
+
/** Installs ArcDiagram's hover, click, and legend-click handlers. */
|
|
27
|
+
export declare function setupArcEvents(viz: VizInstance): void;
|
|
28
|
+
export {};
|