@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,49 @@
|
|
|
1
|
+
import type { Annotation } from "../features/annotationTypes.js";
|
|
2
|
+
import type { TransformStage } from "../pipeline/stages.js";
|
|
3
|
+
import type { DomainValue } from "./pipelineScales.js";
|
|
4
|
+
/** The viz a Plot pipeline stage reads. */
|
|
5
|
+
type PlotViz = Parameters<TransformStage>[0]["viz"];
|
|
6
|
+
/** The four Plot axes. */
|
|
7
|
+
type AxisKey = "x" | "y" | "x2" | "y2";
|
|
8
|
+
/**
|
|
9
|
+
The data-unit values reference lines and bands place on each axis, from
|
|
10
|
+
a list of annotations (`"plot"`-fraction entries and other kinds left
|
|
11
|
+
out).
|
|
12
|
+
@param annotations The chart's annotations, with `referenceLines` and `referenceBands` expanded.
|
|
13
|
+
*/
|
|
14
|
+
export declare function referenceDomainValues(annotations: Annotation[]): Record<AxisKey, unknown[]>;
|
|
15
|
+
/**
|
|
16
|
+
A continuous or time domain stretched to take in `values`, keeping its
|
|
17
|
+
orientation. Only the ends marked `open` move (an end the user set stays
|
|
18
|
+
put), and a log axis ignores values at or below zero. Returns the domain
|
|
19
|
+
itself when nothing changes.
|
|
20
|
+
@param domain The axis's `[start, end]` domain.
|
|
21
|
+
@param values The values to take in.
|
|
22
|
+
@param options Whether the axis is a time or log axis, and which ends may move.
|
|
23
|
+
*/
|
|
24
|
+
export declare function widenToValues(domain: DomainValue[], values: unknown[], options?: {
|
|
25
|
+
time?: boolean;
|
|
26
|
+
log?: boolean;
|
|
27
|
+
open?: [boolean, boolean];
|
|
28
|
+
}): DomainValue[];
|
|
29
|
+
/**
|
|
30
|
+
Which ends of an axis's domain may widen: those the user's domain leaves
|
|
31
|
+
unset (both, without one; the end, for a one-value `[start]`).
|
|
32
|
+
@param user The user's domain for the axis, if any.
|
|
33
|
+
*/
|
|
34
|
+
export declare function openDomainEnds(user: unknown): [boolean, boolean];
|
|
35
|
+
/**
|
|
36
|
+
Widens a Plot's auto domains to take in its reference lines and bands
|
|
37
|
+
(from `referenceLines`, `referenceBands`, and `"ReferenceLine"`/
|
|
38
|
+
`"ReferenceBand"` annotations), on continuous and time axes only. An
|
|
39
|
+
end set by the user's domain (`xDomain`, `xConfig.domain`, …) stays put.
|
|
40
|
+
@param viz The chart.
|
|
41
|
+
@param autoDomains Each axis's domain before the baseline is applied.
|
|
42
|
+
@param scales Each axis's scale type (`"Linear"`, `"Time"`, `"Point"`, …) and configured scale (`"log"`, …).
|
|
43
|
+
@param user The user's x and y domains, as `computePlotScales` reads them.
|
|
44
|
+
*/
|
|
45
|
+
export declare function widenReferenceDomains(viz: PlotViz, autoDomains: Record<AxisKey, DomainValue[] | undefined>, scales: Record<AxisKey, {
|
|
46
|
+
type: string;
|
|
47
|
+
config: string;
|
|
48
|
+
}>, user: Record<string, DomainValue[] | undefined>): Record<AxisKey, DomainValue[] | undefined>;
|
|
49
|
+
export {};
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A stacked Plot's legend order: its series in stacking order, from the
|
|
3
|
+
baseline outward, so the default `"descending"` order lists the largest
|
|
4
|
+
series first. The order is d3-stack's own (each drawn series' `index`),
|
|
5
|
+
which the chart's `stackOrder` sets, whatever the `stackOffset` does
|
|
6
|
+
with it: a diverging stack's negative series and a streamgraph's
|
|
7
|
+
centered layers keep the order they were stacked in.
|
|
8
|
+
|
|
9
|
+
@module
|
|
10
|
+
*/
|
|
11
|
+
import type { DataPoint } from "@d3plus/data";
|
|
12
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
13
|
+
/** Each series' summed fractional position across the stacks it appears in, and how many that is. */
|
|
14
|
+
export type StackPositions = Map<string, {
|
|
15
|
+
total: number;
|
|
16
|
+
count: number;
|
|
17
|
+
}>;
|
|
18
|
+
type Comparator = (a: DataPoint, b: DataPoint) => number;
|
|
19
|
+
/** A d3-stack series: its segments, and its place in the stacking order. */
|
|
20
|
+
type StackSeries = ArrayLike<ArrayLike<number>> & {
|
|
21
|
+
index?: number;
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
Where each series sits in the drawn stacks. Each stack (one per discrete
|
|
25
|
+
group) lists its non-empty segments in stacking order (each series'
|
|
26
|
+
d3-stack `index`, else its place in `stackData`), and each segment adds
|
|
27
|
+
its fractional position, `(rank + 0.5) / segments`, to its series. A
|
|
28
|
+
stacked bar keys each segment as its own series, so this also averages
|
|
29
|
+
bars that stack in different orders.
|
|
30
|
+
@param stackData The d3-stack output, `[series][group] = [start, end]`.
|
|
31
|
+
@param stackKeys Each series' stack key, in `stackData` order.
|
|
32
|
+
@param seriesOf The legend series a stack key belongs to; undefined skips it.
|
|
33
|
+
*/
|
|
34
|
+
export declare function stackPositions(stackData: StackSeries[], stackKeys: unknown[], seriesOf: (key: string) => string | undefined): StackPositions;
|
|
35
|
+
/**
|
|
36
|
+
Combines the positions of several sets of stacks (such as each small
|
|
37
|
+
multiple's) into one.
|
|
38
|
+
@param all Each set's positions.
|
|
39
|
+
*/
|
|
40
|
+
export declare function poolStackPositions(all: StackPositions[]): StackPositions;
|
|
41
|
+
/**
|
|
42
|
+
The series in reading order: by mean position, ties in the order the
|
|
43
|
+
positions list them.
|
|
44
|
+
@param positions Each series' stack positions.
|
|
45
|
+
*/
|
|
46
|
+
export declare function stackReadingOrder(positions: StackPositions): string[];
|
|
47
|
+
/**
|
|
48
|
+
The drawn order with the series it left out (hidden or soloed away)
|
|
49
|
+
kept in their previous place: each follows the series it followed
|
|
50
|
+
before, so hiding a series doesn't move it in the legend.
|
|
51
|
+
@param previous The order of the previous draw.
|
|
52
|
+
@param drawn The order of this draw.
|
|
53
|
+
@param keep The series still in the legend; others in `previous` drop out.
|
|
54
|
+
*/
|
|
55
|
+
export declare function mergeStackOrder(previous: string[], drawn: string[], keep: Set<string>): string[];
|
|
56
|
+
/**
|
|
57
|
+
The ids of the Plot series a row or legend entry stands for: its groupBy
|
|
58
|
+
values down to the drawn depth, joined like a Plot row's `id`. A legend
|
|
59
|
+
entry merging several series (an array at some level) stands for each
|
|
60
|
+
combination.
|
|
61
|
+
@param viz The chart.
|
|
62
|
+
@param d A row or legend entry.
|
|
63
|
+
@param i Its index.
|
|
64
|
+
*/
|
|
65
|
+
export declare function plotSeriesIds(viz: VizInstance, d: DataPoint, i: number): string[];
|
|
66
|
+
/**
|
|
67
|
+
Records a draw's stack positions as the legend's order (see
|
|
68
|
+
`stackLegendSort`), keeping series the draw left out where they were.
|
|
69
|
+
Undefined positions (an unstacked draw) clear it.
|
|
70
|
+
@param viz The chart.
|
|
71
|
+
@param positions The draw's stack positions.
|
|
72
|
+
*/
|
|
73
|
+
export declare function recordStackLegendOrder(viz: VizInstance, positions: StackPositions | undefined): void;
|
|
74
|
+
/**
|
|
75
|
+
A stacked Plot's default legend comparator: entries in the order of
|
|
76
|
+
`viz._stackLegendOrder` (an entry merging several series sits at their
|
|
77
|
+
mean place), then the entries the stacks don't place, with ties broken
|
|
78
|
+
by `fallback`. An unstacked chart sorts by `fallback` alone.
|
|
79
|
+
@param viz The chart.
|
|
80
|
+
@param fallback The comparator for everything the stack order doesn't settle.
|
|
81
|
+
*/
|
|
82
|
+
export declare function stackLegendSort(viz: VizInstance, fallback: Comparator): Comparator;
|
|
83
|
+
export {};
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { LinkLabelBox } from "../features/linkLabelGeometry.js";
|
|
3
|
+
import type { PlotAxisFn } from "../features/plotPaint.js";
|
|
4
|
+
import type { Edges, Pt } from "../features/pathLabelGeometry.js";
|
|
5
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
6
|
+
import type { TrendFit } from "./trendLines.js";
|
|
7
|
+
/** What `trendLineConfig.label` takes. */
|
|
8
|
+
export type TrendLabelSetting = boolean | "equation" | ((fit: TrendFit) => string | false | null | undefined);
|
|
9
|
+
/**
|
|
10
|
+
A fit's equation and R² as label text, e.g. `y = 2.1x + 3.4, R² = 0.84`,
|
|
11
|
+
its coefficients abbreviated as the axes abbreviate numbers. A fit along
|
|
12
|
+
a time axis shows only its R² (an equation in milliseconds since 1970
|
|
13
|
+
says nothing a reader can use).
|
|
14
|
+
@param fit The fitted trend line.
|
|
15
|
+
@param locale The chart's locale.
|
|
16
|
+
@param time Whether the fit runs along a time axis.
|
|
17
|
+
*/
|
|
18
|
+
export declare function trendEquationLabel(fit: Pick<TrendFit, "fit" | "axis">, locale: string, time?: boolean): string;
|
|
19
|
+
/**
|
|
20
|
+
A fit's label text for a `trendLineConfig.label` setting, or null for
|
|
21
|
+
none: `true` names the series ("Trend" for a line fit to every point),
|
|
22
|
+
`"equation"` gives its equation and R², and a function returns any text.
|
|
23
|
+
@param viz The chart.
|
|
24
|
+
@param fit The fitted trend line.
|
|
25
|
+
@param setting The configured label.
|
|
26
|
+
*/
|
|
27
|
+
export declare function trendLabelText(viz: VizInstance, fit: TrendFit, setting: unknown): string | null;
|
|
28
|
+
/** A label's box: its center, size, and turn in degrees. */
|
|
29
|
+
type Box = LinkLabelBox;
|
|
30
|
+
/** What placing a trend label needs. */
|
|
31
|
+
export interface TrendPlacement {
|
|
32
|
+
fontSize: number;
|
|
33
|
+
/** How far above the line's center the text's baseline sits. */
|
|
34
|
+
lift: number;
|
|
35
|
+
/** The label text's width. */
|
|
36
|
+
width: number;
|
|
37
|
+
/** The boxes of the labels already placed, which this one must clear. */
|
|
38
|
+
obstacles: Box[];
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
The path a fit's label follows and the boxes it covers, or null when its
|
|
42
|
+
line has no clear spot for it: the drawn (not projected) stretch inside
|
|
43
|
+
the plot, upright, stopped short of its end. The label prefers the end of
|
|
44
|
+
the line, just above it; when that spot overlaps an earlier label it
|
|
45
|
+
slides back along the line to the nearest clear stretch, then tries the
|
|
46
|
+
same below the line. A line too short for a few letters gets none.
|
|
47
|
+
@param points The fitted stretch's points, in pixels.
|
|
48
|
+
@param rect The plot area.
|
|
49
|
+
@param place The font, lift, text width, and labels to clear.
|
|
50
|
+
*/
|
|
51
|
+
export declare function trendLabelSpot(points: Pt[], rect: Edges, place: TrendPlacement): {
|
|
52
|
+
d: string;
|
|
53
|
+
boxes: Box[];
|
|
54
|
+
} | null;
|
|
55
|
+
/**
|
|
56
|
+
The boxes of the labels a trend label must clear: the line labels at the
|
|
57
|
+
lines' ends and along them, and Hexbin's contour labels, wherever they
|
|
58
|
+
sit among the marks.
|
|
59
|
+
@param marks The plot's marks.
|
|
60
|
+
*/
|
|
61
|
+
export declare function lineLabelBoxes(marks: SceneNode[]): Box[];
|
|
62
|
+
/**
|
|
63
|
+
The label nodes for every fitted trend line, when `trendLineConfig.label`
|
|
64
|
+
asks for them, placed one at a time (in series order) so none overlaps
|
|
65
|
+
another or the plot's line labels.
|
|
66
|
+
@param viz The chart.
|
|
67
|
+
@param x Maps an x value to pixels.
|
|
68
|
+
@param y Maps a y value to pixels.
|
|
69
|
+
@param rect The plot area.
|
|
70
|
+
@param marks The plot's marks, for the line labels to clear.
|
|
71
|
+
*/
|
|
72
|
+
export declare function emitTrendLabels(viz: VizInstance, x: PlotAxisFn, y: PlotAxisFn, rect: Edges, marks?: SceneNode[]): SceneNode[];
|
|
73
|
+
export {};
|
|
@@ -13,6 +13,12 @@ export declare const trendTypeNames: Record<string, string>;
|
|
|
13
13
|
@param axis The independent axis the fit runs along.
|
|
14
14
|
*/
|
|
15
15
|
export declare function trendEquation(fit: Pick<RegressionResult, "type" | "coefficients">, format?: (n: number) => string, axis?: "x" | "y"): string;
|
|
16
|
+
/**
|
|
17
|
+
Abbreviates a coefficient as the axes abbreviate their numbers, keeping
|
|
18
|
+
three significant digits on tiny values.
|
|
19
|
+
@param locale The chart's locale.
|
|
20
|
+
*/
|
|
21
|
+
export declare function coefficientFormat(locale: string): (n: number) => string;
|
|
16
22
|
/**
|
|
17
23
|
The tooltip rows for a fit: type, equation, R², and observations. Given a
|
|
18
24
|
projected sample, it leads with that projection: its independent-axis
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Time helpers Priestley and Gantt share: the `start`/`end` accessor
|
|
3
|
+
fields, the min/max aggregation seeds they register, date parsing for a
|
|
4
|
+
time-scaled axis, and the time axis render that pushes the axis scene and
|
|
5
|
+
returns its scale.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { SceneNode, Transform } from "@d3plus/render";
|
|
9
|
+
import type { ConfigField } from "../../fluent.js";
|
|
10
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
11
|
+
/** A start or end value: a date on a time axis, a number otherwise. */
|
|
12
|
+
export type TimeValue = number | Date;
|
|
13
|
+
/** The Axis surface the time axis render drives. */
|
|
14
|
+
export interface TimeAxisLike {
|
|
15
|
+
config: (c: unknown) => TimeAxisLike;
|
|
16
|
+
measure: () => TimeAxisLike;
|
|
17
|
+
renderMode: (m: string) => TimeAxisLike;
|
|
18
|
+
select: (el: HTMLElement | undefined) => TimeAxisLike;
|
|
19
|
+
render: () => TimeAxisLike;
|
|
20
|
+
outerBounds: () => {
|
|
21
|
+
height: number;
|
|
22
|
+
};
|
|
23
|
+
toScene: () => {
|
|
24
|
+
children?: unknown[];
|
|
25
|
+
} | undefined;
|
|
26
|
+
schema: {
|
|
27
|
+
padding: number;
|
|
28
|
+
orient?: string;
|
|
29
|
+
};
|
|
30
|
+
_d3Scale: (v: TimeValue) => number;
|
|
31
|
+
}
|
|
32
|
+
/** The `start` and `end` accessor fields. */
|
|
33
|
+
export declare function timeFields(): ConfigField[];
|
|
34
|
+
/**
|
|
35
|
+
Seeds the `start`/`end` reducers for the default accessors, which are
|
|
36
|
+
functions the fields' `onSet` can't read a data key from, so the time
|
|
37
|
+
domain spans min(start)…max(end) instead of summing them.
|
|
38
|
+
*/
|
|
39
|
+
export declare function seedTimeAggs(viz: VizInstance): void;
|
|
40
|
+
/** Whether the chart's `axisConfig` plots dates. */
|
|
41
|
+
export declare function isTimeAxis(viz: VizInstance): boolean;
|
|
42
|
+
/**
|
|
43
|
+
Reads a start or end value: parsed as a date on a time axis, else a
|
|
44
|
+
number. Missing or unparseable values return null.
|
|
45
|
+
*/
|
|
46
|
+
export declare function parseTime(value: unknown, time: boolean): TimeValue | null;
|
|
47
|
+
/** Where the time axis draws, in the chart scene's coordinates. */
|
|
48
|
+
export interface TimeAxisFrame {
|
|
49
|
+
domain: number[];
|
|
50
|
+
width: number;
|
|
51
|
+
height: number;
|
|
52
|
+
/** Where the axis group sits. */
|
|
53
|
+
transform: Transform;
|
|
54
|
+
/** The axis group's scene key. */
|
|
55
|
+
key: string;
|
|
56
|
+
/** Extra config applied after `axisConfig` (e.g. a Gantt's default orient). */
|
|
57
|
+
config?: Record<string, unknown>;
|
|
58
|
+
}
|
|
59
|
+
/** The time axis's measured height and padding. */
|
|
60
|
+
export interface TimeAxisSize {
|
|
61
|
+
height: number;
|
|
62
|
+
padding: number;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
Measures the chart's time axis (`viz.ctx.axisTest`) over `frame`: the
|
|
66
|
+
height its ticks and labels take, and its padding.
|
|
67
|
+
*/
|
|
68
|
+
export declare function measureTimeAxis(viz: VizInstance, frame: Pick<TimeAxisFrame, "domain" | "width" | "height" | "config">): TimeAxisSize;
|
|
69
|
+
/**
|
|
70
|
+
Renders the chart's time axis (`viz.ctx.axis`) over `frame`, pushes its
|
|
71
|
+
scene onto `viz._chartScene` (with any extra `group` fields), and returns
|
|
72
|
+
its scale.
|
|
73
|
+
*/
|
|
74
|
+
export declare function renderTimeAxis(viz: VizInstance, frame: TimeAxisFrame, group?: Partial<SceneNode>): (v: TimeValue) => number;
|
|
75
|
+
/** Reads a row's raw start or end through the chart's accessor. */
|
|
76
|
+
export declare function rowTime(viz: VizInstance, key: "start" | "end", d: DataPoint, i: number): unknown;
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
import type { DataPoint } from "@d3plus/data";
|
|
7
7
|
import type { SceneNode } from "@d3plus/render";
|
|
8
8
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
9
|
+
import type { RadarCurve } from "./curvedLabels.js";
|
|
9
10
|
import type { RadarLevels } from "./levels.js";
|
|
10
11
|
import type { RadarRingStyle } from "./rings.js";
|
|
11
12
|
type Viz = Parameters<TransformStage>[0]["viz"];
|
|
@@ -26,6 +27,8 @@ export interface PolarAxisDatum {
|
|
|
26
27
|
rotateAnchor: [number, number];
|
|
27
28
|
x: number;
|
|
28
29
|
y: number;
|
|
30
|
+
/** The curved lines the label follows, when it curves (see `labelPosition`). */
|
|
31
|
+
labelCurve?: RadarCurve;
|
|
29
32
|
}
|
|
30
33
|
export interface RadarAxisConfig {
|
|
31
34
|
barConfig?: RadarRingStyle;
|
|
@@ -43,8 +46,10 @@ export declare const labelFont: (viz: Viz, text: string, datum: DataPoint, i: nu
|
|
|
43
46
|
};
|
|
44
47
|
/**
|
|
45
48
|
Lays out the metric labels and the web radius. `outerPadding` "auto"
|
|
46
|
-
|
|
47
|
-
|
|
49
|
+
curves every label along the web when they all fit, which leaves the web
|
|
50
|
+
the most room, and otherwise sizes both from the measured labels along
|
|
51
|
+
their spokes; a number reserves that many pixels around the web and
|
|
52
|
+
wraps labels to it. Either way, a label that fits along the web curves.
|
|
48
53
|
*/
|
|
49
54
|
export declare function radarPolarAxis(viz: Viz, axisData: [unknown, DataPoint[]][], width: number, height: number): {
|
|
50
55
|
radius: number;
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Radar metric labels along the web (see `labelPosition`): each metric's
|
|
3
|
+
name curves just outside the outer ring, centered on its spoke, in the
|
|
4
|
+
arc between the spokes on either side, wrapping onto a second curved
|
|
5
|
+
line when it is too long for one. Curved names need only a line or two
|
|
6
|
+
of room around the web, so when every name fits that way the web grows
|
|
7
|
+
into the band the spoke labels would need.
|
|
8
|
+
*/
|
|
9
|
+
import type { DataPoint } from "@d3plus/data";
|
|
10
|
+
import { textWrap } from "@d3plus/text";
|
|
11
|
+
import type { RingLabelFont } from "../features/ringLabelNodes.js";
|
|
12
|
+
import type { RingLabelFit } from "../features/ringLabels.js";
|
|
13
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
14
|
+
/** The gap (px) between the outer ring and a curved metric label. */
|
|
15
|
+
export declare const RADAR_CURVE_PADDING = 5;
|
|
16
|
+
/** The lines a curved metric label may wrap onto. */
|
|
17
|
+
export declare const RADAR_CURVE_MAX_LINES = 2;
|
|
18
|
+
/** What curving a metric label needs. */
|
|
19
|
+
export interface RadarCurveInput {
|
|
20
|
+
text: string;
|
|
21
|
+
data: DataPoint;
|
|
22
|
+
/** Spoke direction, in radians (clockwise from 3 o'clock). */
|
|
23
|
+
angle: number;
|
|
24
|
+
font: RingLabelFont & {
|
|
25
|
+
fontSize: number;
|
|
26
|
+
lineHeight?: number;
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
/** A metric label along the web: its lines, first to last, each with its curve. */
|
|
30
|
+
export interface RadarCurve {
|
|
31
|
+
lines: {
|
|
32
|
+
text: string;
|
|
33
|
+
fit: RingLabelFit;
|
|
34
|
+
}[];
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
The band (px) curved labels need around the web: `lines` of their
|
|
38
|
+
largest line height (the last one only its font size) and the padding
|
|
39
|
+
on either side.
|
|
40
|
+
@param labels The metric labels.
|
|
41
|
+
@param lines How many lines they take.
|
|
42
|
+
*/
|
|
43
|
+
export declare function radarCurveBand(labels: RadarCurveInput[], lines?: number): number;
|
|
44
|
+
/**
|
|
45
|
+
`text` wrapped onto `count` lines of as even a length as it allows: at
|
|
46
|
+
the narrowest width, down to half of `width`, that keeps it on `count`
|
|
47
|
+
lines.
|
|
48
|
+
@param wrap The wrapper, set to the label's font.
|
|
49
|
+
@param text The text.
|
|
50
|
+
@param width The width it fits on `count` lines.
|
|
51
|
+
@param count Its line count at `width`.
|
|
52
|
+
*/
|
|
53
|
+
export declare function balancedLines(wrap: ReturnType<typeof textWrap>, text: string, width: number, count: number): string[];
|
|
54
|
+
/**
|
|
55
|
+
Each metric's label along the web at `radius`, or null where it doesn't
|
|
56
|
+
fit between its neighbors on `maxLines` lines or its `labelPosition`
|
|
57
|
+
keeps it on its spoke. One line is tried first. A label cut short with
|
|
58
|
+
an ellipsis (on one line) is allowed only when its `labelPosition` is
|
|
59
|
+
`"along"`.
|
|
60
|
+
@param viz The chart.
|
|
61
|
+
@param labels The metric labels, in spoke order.
|
|
62
|
+
@param radius The web's radius.
|
|
63
|
+
@param maxLines The lines a label may wrap onto.
|
|
64
|
+
*/
|
|
65
|
+
export declare function radarCurves(viz: VizInstance, labels: RadarCurveInput[], radius: number, maxLines?: number): (RadarCurve | null)[];
|
|
66
|
+
/**
|
|
67
|
+
Whether every metric takes a curved label: each one fits along the web
|
|
68
|
+
(or is cut short, for `"along"`) or has no text.
|
|
69
|
+
@param labels The metric labels.
|
|
70
|
+
@param curves Each one's curve (see `radarCurves`).
|
|
71
|
+
*/
|
|
72
|
+
export declare function radarAllCurved(labels: RadarCurveInput[], curves: (RadarCurve | null)[]): boolean;
|
|
73
|
+
/**
|
|
74
|
+
The lines a curved label may take at `radius` so it stays inside a
|
|
75
|
+
`width` × `height` area centered on the web: up to
|
|
76
|
+
`RADAR_CURVE_MAX_LINES`, or 0 when not even one fits.
|
|
77
|
+
@param labels The metric labels.
|
|
78
|
+
@param radius The web's radius.
|
|
79
|
+
@param room The room from the center to the area's nearest edge.
|
|
80
|
+
*/
|
|
81
|
+
export declare function radarCurveLines(labels: RadarCurveInput[], radius: number, room: number): number;
|
|
82
|
+
/**
|
|
83
|
+
The web's radius and every metric's curved label when every name fits
|
|
84
|
+
along the web, which leaves the web the most room: on one line when
|
|
85
|
+
they all fit, else on up to `RADAR_CURVE_MAX_LINES`. Null when some
|
|
86
|
+
name doesn't fit either way.
|
|
87
|
+
@param viz The chart.
|
|
88
|
+
@param labels The metric labels, in spoke order.
|
|
89
|
+
@param room The room from the center to the area's nearest edge.
|
|
90
|
+
*/
|
|
91
|
+
export declare function radarCurvedLayout(viz: VizInstance, labels: RadarCurveInput[], room: number): {
|
|
92
|
+
radius: number;
|
|
93
|
+
curves: (RadarCurve | null)[];
|
|
94
|
+
} | null;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { RingArc, RingLabelFit } from "../features/ringLabels.js";
|
|
3
|
+
import type { PolarWedge } from "../polar/wedgeLayout.js";
|
|
4
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
5
|
+
import type { RadialBarFrame } from "./trackLayout.js";
|
|
6
|
+
/** Where a track's curved label goes, and whether it sits inside the bar. */
|
|
7
|
+
export interface RadialBarLabelSpot {
|
|
8
|
+
fit: RingLabelFit;
|
|
9
|
+
inBar: boolean;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
Fits a track's label at `fontSize` along its track: inside the bar from
|
|
13
|
+
the bar's start, else on the track from the bar's end, as long as it
|
|
14
|
+
ends before the sweep does. Null when neither holds it whole.
|
|
15
|
+
@param bar The bar's arc.
|
|
16
|
+
@param sweepEnd Where the tracks end.
|
|
17
|
+
@param width The label's one-line width at a font size.
|
|
18
|
+
@param fontSize The label's font size.
|
|
19
|
+
*/
|
|
20
|
+
export declare function radialBarLabelSpot(bar: RingArc, sweepEnd: number, width: (fontSize: number) => number, fontSize: number): RadialBarLabelSpot | null;
|
|
21
|
+
/**
|
|
22
|
+
The curved labels for the tracks whose rows take one (see
|
|
23
|
+
`radialBarCurvedRows`), each in the color that reads on its bar or, past
|
|
24
|
+
the bar, on its track, unless the Path `labelConfig` sets a `fontColor`.
|
|
25
|
+
Counts the tracks and their labels into `viz._alongStats`, so labels
|
|
26
|
+
that name every track hide the default legend (see `alongLegend.ts`).
|
|
27
|
+
@param viz The chart.
|
|
28
|
+
@param wedges The bars, in track order.
|
|
29
|
+
@param frame The tracks' frame.
|
|
30
|
+
*/
|
|
31
|
+
export declare function radialBarCurvedLabels(viz: VizInstance, wedges: PolarWedge[], frame: RadialBarFrame): SceneNode[];
|
|
@@ -4,8 +4,8 @@
|
|
|
4
4
|
shared sweep. Pushes the chrome onto `viz._chartScene` beneath the bars:
|
|
5
5
|
the track backgrounds, the value gridlines (spokes at the ticks) with
|
|
6
6
|
their labels outside the circle, and each track's label beside its start
|
|
7
|
-
(a sweep within 30° of a full circle has no room there, so the
|
|
8
|
-
|
|
7
|
+
(a sweep within 30° of a full circle has no room there, so the names
|
|
8
|
+
curve along the tracks, see `curvedLabels.ts`).
|
|
9
9
|
*/
|
|
10
10
|
import type { DataPoint } from "@d3plus/data";
|
|
11
11
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
@@ -32,9 +32,40 @@ export declare const RADIAL_BAR_MIN_LABEL_GAP: number;
|
|
|
32
32
|
/**
|
|
33
33
|
Whether the tracks leave enough of a gap before their start for the track
|
|
34
34
|
labels. A sweep closer to a full circle leaves too little (none at 360°),
|
|
35
|
-
so the
|
|
35
|
+
so the names curve along the tracks instead (see `radialBarCurvedRows`).
|
|
36
36
|
*/
|
|
37
37
|
export declare function radialBarTrackLabels(viz: Viz): boolean;
|
|
38
|
+
/**
|
|
39
|
+
Which rows' tracks take a curved label: every `"along"` row, and the
|
|
40
|
+
`"auto"` rows when the sweep leaves no room for the straight labels.
|
|
41
|
+
`"inside"` and `"outside"` rows keep the straight labels.
|
|
42
|
+
@param viz The chart.
|
|
43
|
+
@param rows The rows, in track order.
|
|
44
|
+
*/
|
|
45
|
+
export declare function radialBarCurvedRows(viz: Viz, rows: DataPoint[]): boolean[];
|
|
46
|
+
/**
|
|
47
|
+
Whether a draw's curved track labels could name every track, so the
|
|
48
|
+
default legend may stand aside for them (see `alongLegend.ts`): the
|
|
49
|
+
tracks layout, with every row's label curved.
|
|
50
|
+
@param viz The chart.
|
|
51
|
+
*/
|
|
52
|
+
export declare function radialBarAlongPossible(viz: Viz): boolean;
|
|
53
|
+
/** A track label's font size: the user's `labelConfig.fontSize`, else scaled to the track. */
|
|
54
|
+
export declare function trackFontSize(viz: Viz, thickness: number): number;
|
|
55
|
+
/** The track labels' text, font, and one-line width at their track's font size. */
|
|
56
|
+
export declare function measureTrackLabels(viz: Viz, rows: DataPoint[], thickness: number): {
|
|
57
|
+
d: DataPoint;
|
|
58
|
+
i: number;
|
|
59
|
+
text: any;
|
|
60
|
+
font: {
|
|
61
|
+
fontFamily: string;
|
|
62
|
+
fontSize: number;
|
|
63
|
+
fontWeight: number | string;
|
|
64
|
+
lineHeight: number;
|
|
65
|
+
};
|
|
66
|
+
size: number;
|
|
67
|
+
width: number;
|
|
68
|
+
}[];
|
|
38
69
|
/**
|
|
39
70
|
Lays out the tracks and bars for `rows` (already in track order) and
|
|
40
71
|
pushes the chrome; returns one wedge per row and the frame.
|
|
@@ -3,5 +3,55 @@
|
|
|
3
3
|
`ringsCtx` stashed on `viz.ctx`. Emits flat SceneNodes directly
|
|
4
4
|
(no transient Shape compute pass).
|
|
5
5
|
*/
|
|
6
|
+
import type { DataPoint } from "@d3plus/data";
|
|
7
|
+
import type { LinkDatum } from "../features/linkInteraction.js";
|
|
8
|
+
import type { LinkAnchor } from "../features/linkLabelGeometry.js";
|
|
9
|
+
import type { SelfLoopGeometry } from "../features/selfLoops.js";
|
|
6
10
|
import type { ChartEmit } from "../definition/ChartDefinition.js";
|
|
11
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
12
|
+
export interface RingsEdge {
|
|
13
|
+
/** The edge's index in `links`. */
|
|
14
|
+
index?: number;
|
|
15
|
+
source: DataPoint & {
|
|
16
|
+
id: string;
|
|
17
|
+
x: number;
|
|
18
|
+
y: number;
|
|
19
|
+
};
|
|
20
|
+
target: DataPoint & {
|
|
21
|
+
id: string;
|
|
22
|
+
x: number;
|
|
23
|
+
y: number;
|
|
24
|
+
};
|
|
25
|
+
size?: number;
|
|
26
|
+
datum: LinkDatum;
|
|
27
|
+
spline?: boolean;
|
|
28
|
+
sourceX?: number;
|
|
29
|
+
sourceY?: number;
|
|
30
|
+
sourceBisectX?: number;
|
|
31
|
+
sourceBisectY?: number;
|
|
32
|
+
targetX?: number;
|
|
33
|
+
targetY?: number;
|
|
34
|
+
targetBisectX?: number;
|
|
35
|
+
targetBisectY?: number;
|
|
36
|
+
loop?: SelfLoopGeometry;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
An edge's visible stroke: `d`, cut short inside its arrowheads (see
|
|
40
|
+
`edgeArrowTrims`). A spline edge or a loop follows its curve up to each
|
|
41
|
+
head's base, then runs along the head's axis (see `cubicArrowEdge`); a
|
|
42
|
+
spline's arrow tips sit on the node's edge, where the curve ends.
|
|
43
|
+
*/
|
|
44
|
+
export declare function ringsVisibleD(viz: VizInstance, edge: RingsEdge, i: number, strokeWidth: unknown, d: string): string;
|
|
45
|
+
/** Each edge's scene key, unique across `edges`: parallel edges after the first add their order among them (see `uniqueLinkKeys`). */
|
|
46
|
+
export declare const ringsLinkKeys: (edges: readonly RingsEdge[]) => string[];
|
|
47
|
+
/**
|
|
48
|
+
Where an edge's label goes: halfway along a spline edge's curve, along
|
|
49
|
+
a straight edge's run between its nodes, or at a loop's far point.
|
|
50
|
+
*/
|
|
51
|
+
export declare function ringsEdgeAnchor(edge: RingsEdge): LinkAnchor;
|
|
52
|
+
/**
|
|
53
|
+
The curve an edge's label follows: a spline edge's curve or a loop, or
|
|
54
|
+
null for a straight edge.
|
|
55
|
+
*/
|
|
56
|
+
export declare function ringsEdgePath(edge: RingsEdge): [number, number][] | null;
|
|
7
57
|
export declare const ringsEmit: ChartEmit;
|
|
@@ -5,7 +5,9 @@
|
|
|
5
5
|
@module
|
|
6
6
|
*/
|
|
7
7
|
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { LinkDatum, LinkEnd } from "../features/linkInteraction.js";
|
|
8
9
|
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { SelfLoopGeometry } from "../features/selfLoops.js";
|
|
9
11
|
/**
|
|
10
12
|
Single laid-out node — accreted across the layout's passes. Each
|
|
11
13
|
field is filled in by one of the steps below; collected here so a
|
|
@@ -27,7 +29,6 @@ export interface RingsNode {
|
|
|
27
29
|
angle: number;
|
|
28
30
|
radius: number;
|
|
29
31
|
}>;
|
|
30
|
-
edge?: RingsEdge;
|
|
31
32
|
size?: number;
|
|
32
33
|
labelBounds?: {
|
|
33
34
|
x: number;
|
|
@@ -49,6 +50,8 @@ export interface RingsEdge {
|
|
|
49
50
|
source: RingsNode;
|
|
50
51
|
target: RingsNode;
|
|
51
52
|
size: number;
|
|
53
|
+
/** The datum the link is drawn with (see `makeLinkDatum`). */
|
|
54
|
+
datum: LinkDatum;
|
|
52
55
|
spline?: boolean;
|
|
53
56
|
sourceX?: number;
|
|
54
57
|
sourceY?: number;
|
|
@@ -58,11 +61,16 @@ export interface RingsEdge {
|
|
|
58
61
|
targetY?: number;
|
|
59
62
|
targetBisectX?: number;
|
|
60
63
|
targetBisectY?: number;
|
|
64
|
+
/** The loop a link from a node to itself draws as, once laid out. */
|
|
65
|
+
loop?: SelfLoopGeometry;
|
|
61
66
|
}
|
|
67
|
+
/** A node record as a link end. */
|
|
68
|
+
export declare const ringsLinkEnd: (n: RingsNode) => LinkEnd;
|
|
62
69
|
/**
|
|
63
70
|
Build the Rings node set + link descriptors from filtered data and schema
|
|
64
71
|
nodes/links. Stashes `nodeLookup` on `viz.ctx` and returns the working
|
|
65
|
-
`nodes`, `nodeLookup`, `links`, and per-node `linkMap
|
|
72
|
+
`nodes`, `nodeLookup`, `links`, and per-node `linkMap` (which leaves out
|
|
73
|
+
links from a node to itself).
|
|
66
74
|
*/
|
|
67
75
|
export declare function buildRingsGraph(v: VizInstance, data: Record<string, DataPoint>): {
|
|
68
76
|
nodes: RingsNode[];
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Rings' loops: each placed node's links to itself, drawn as loops into the
|
|
3
|
+
widest gap between its drawn links and, on the rings, its label.
|
|
4
|
+
*/
|
|
5
|
+
import type { RingsEdge, RingsNode } from "./ringsGraph.js";
|
|
6
|
+
import type { RingGeometry } from "./ringsSizing.js";
|
|
7
|
+
/**
|
|
8
|
+
The loops on the placed `nodes`, as edges carrying their `loop`: a
|
|
9
|
+
node's loops point into the widest gap between the nodes its drawn
|
|
10
|
+
`edges` reach and, for a ring node, its label (which runs out from the
|
|
11
|
+
center). The center's loops stay inside the first ring.
|
|
12
|
+
*/
|
|
13
|
+
export declare function ringsLoops(links: readonly RingsEdge[], nodes: readonly RingsNode[], edges: readonly RingsEdge[], center: RingsNode, geom: RingGeometry): RingsEdge[];
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Rings' parallel links: several links between the same two nodes, in
|
|
3
|
+
either direction. Each node takes one place on its ring however many
|
|
4
|
+
links reach it, and the links fan out as curves bowed either side of
|
|
5
|
+
the line between their nodes, so each stays its own mark.
|
|
6
|
+
*/
|
|
7
|
+
import type { RingsEdge } from "./ringsGraph.js";
|
|
8
|
+
type Point = {
|
|
9
|
+
x: number;
|
|
10
|
+
y: number;
|
|
11
|
+
r?: number;
|
|
12
|
+
};
|
|
13
|
+
/** `edges` from the node `id`, keeping only the first to each other node. */
|
|
14
|
+
export declare function firstPerNeighbor(edges: readonly RingsEdge[], id: string): RingsEdge[];
|
|
15
|
+
/** The edges among `edges` between the node `id` and the node `otherId`. */
|
|
16
|
+
export declare const edgesBetween: (edges: readonly RingsEdge[], id: string, otherId: string) => RingsEdge[];
|
|
17
|
+
/** How far apart, at their middles, `n` parallel links sit, centered on the line: `[-step/2, step/2]` for two. */
|
|
18
|
+
export declare const parallelOffsets: (n: number, step: number) => number[];
|
|
19
|
+
/**
|
|
20
|
+
The point on the rim of `node` (centered on `node`, through `p`) moved
|
|
21
|
+
`e` pixels along the unit `normal`, keeping to the side of the center
|
|
22
|
+
`p` is on. It slides at most 90% of the radius out, and a node with no
|
|
23
|
+
radius keeps `p`.
|
|
24
|
+
*/
|
|
25
|
+
export declare function slideOnRim(node: Point, p: [number, number], normal: [number, number], e: number): [number, number];
|
|
26
|
+
/**
|
|
27
|
+
A straight link from `s` to `t` bowed `offset` pixels along the unit
|
|
28
|
+
`normal` at its middle: a cubic across the gap between the two nodes,
|
|
29
|
+
whose ends slide most of that way along each node's rim (see
|
|
30
|
+
`END_SHARE`), and whose control points sit a third and two thirds of
|
|
31
|
+
the way across, out as far as the rest of the bow needs.
|
|
32
|
+
*/
|
|
33
|
+
export declare function bowedEdge(s: Point, t: Point, normal: [number, number], offset: number): Required<Pick<RingsEdge, "sourceX" | "sourceY" | "sourceBisectX" | "sourceBisectY" | "targetBisectX" | "targetBisectY" | "targetX" | "targetY">>;
|
|
34
|
+
/**
|
|
35
|
+
Fans out each group of parallel links among `edges` (mutated in place),
|
|
36
|
+
leaving a link with no parallel alone. Their middles sit a hit path's
|
|
37
|
+
width (and a gap) apart, so each can be pointed at. A straight link
|
|
38
|
+
becomes a bowed curve (see `bowedEdge`); a curved one moves to the side
|
|
39
|
+
(see `shiftSpline`). The side follows the two nodes, not the link's
|
|
40
|
+
direction, so links both ways between them fan apart too.
|
|
41
|
+
*/
|
|
42
|
+
export declare function fanParallelEdges(edges: readonly RingsEdge[]): void;
|
|
43
|
+
export {};
|