@d3plus/core 4.10.0 → 4.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +178 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +176 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +101 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +192 -0
- package/es/src/charts/ArcDiagram/events.js +148 -0
- package/es/src/charts/ArcDiagram/index.js +217 -0
- package/es/src/charts/BarChart/index.js +12 -7
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +6 -11
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +160 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +137 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +206 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +6 -4
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/applyLayout.js +20 -9
- package/es/src/charts/Matrix/index.js +19 -1
- package/es/src/charts/Network/applyLayout.js +171 -96
- package/es/src/charts/Network/bundle.js +82 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +257 -75
- package/es/src/charts/Network/graph.js +146 -0
- package/es/src/charts/Network/graphFluent.js +81 -0
- package/es/src/charts/Network/index.js +91 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +15 -8
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +8 -1
- package/es/src/charts/Pack/neutralPaint.js +20 -0
- package/es/src/charts/Pack/nodeNames.js +35 -0
- package/es/src/charts/ParallelCoordinates/axes.js +22 -22
- package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +51 -96
- package/es/src/charts/Pie/index.js +74 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaEnter.js +68 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +34 -14
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +19 -17
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +40 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +2 -1
- package/es/src/charts/Plot/sharedTooltip.js +13 -3
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +4 -3
- package/es/src/charts/Priestley/applyLayout.js +21 -23
- package/es/src/charts/Priestley/index.js +4 -37
- package/es/src/charts/Priestley/timeAxis.js +103 -0
- package/es/src/charts/Pyramid/gutter.js +52 -16
- package/es/src/charts/Pyramid/index.js +55 -7
- package/es/src/charts/Pyramid/scene.js +4 -4
- package/es/src/charts/Radar/applyLayout.js +31 -33
- package/es/src/charts/Radar/axisDecorations.js +62 -13
- package/es/src/charts/Radar/curvedLabels.js +228 -0
- package/es/src/charts/Radar/emit.js +30 -15
- package/es/src/charts/Radar/index.js +43 -5
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +9 -1
- package/es/src/charts/RadialBar/index.js +26 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/index.js +18 -9
- package/es/src/charts/Rings/applyLayout.js +39 -161
- package/es/src/charts/Rings/emit.js +219 -63
- package/es/src/charts/Rings/index.js +88 -32
- package/es/src/charts/Rings/ringsCurves.js +156 -0
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +183 -0
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +61 -38
- package/es/src/charts/Sankey/applyLayout.js +130 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +78 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +83 -64
- package/es/src/charts/Sunburst/index.js +16 -4
- package/es/src/charts/Tree/applyLayout.js +44 -14
- package/es/src/charts/Tree/emit.js +5 -5
- package/es/src/charts/Tree/index.js +12 -18
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +14 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +10 -25
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +52 -23
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
- package/es/src/charts/drawSteps/zoomDrag.js +188 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +11 -4
- package/es/src/charts/events/click.shape.js +13 -4
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +9 -2
- package/es/src/charts/events/mousemove.legend.js +28 -32
- package/es/src/charts/events/mousemove.shape.js +45 -42
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +17 -5
- package/es/src/charts/features/axesFinal.js +10 -3
- package/es/src/charts/features/axesMeasure.js +33 -12
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/centerLabel.js +177 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +20 -1
- package/es/src/charts/features/colorScaleHover.js +33 -7
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +77 -0
- package/es/src/charts/features/colorScaleTop.js +61 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +191 -0
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +220 -5
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +75 -20
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/hoverTicks.js +41 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +364 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeStats.js +309 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +46 -12
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +54 -32
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +30 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +14 -5
- package/es/src/charts/partition/interaction.js +19 -10
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +22 -9
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/chrome.js +81 -9
- package/es/src/charts/polar/config.js +6 -3
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +61 -49
- package/es/src/charts/viz/VizBase.js +57 -14
- package/es/src/charts/viz/backgroundInk.js +23 -7
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +115 -32
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +29 -0
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +34 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -4
- package/es/src/charts/viz/vizDefaults.js +28 -57
- package/es/src/charts/viz/vizFields.js +41 -1
- package/es/src/charts/viz/vizRender.js +76 -31
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +26 -2
- package/es/src/components/Axis/Axis.js +35 -2
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +33 -8
- package/es/src/components/Axis/axisDefaults.js +16 -9
- package/es/src/components/Axis/axisLabelKinds.js +36 -0
- package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
- package/es/src/components/Axis/axisLabelRoom.js +37 -0
- package/es/src/components/Axis/axisLabelSize.js +171 -0
- package/es/src/components/Axis/axisLabelThinning.js +98 -4
- package/es/src/components/Axis/axisLayout.js +71 -46
- package/es/src/components/Axis/axisLayoutLabels.js +82 -140
- package/es/src/components/Axis/axisLayoutScale.js +16 -11
- package/es/src/components/Axis/axisLimit.js +27 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +20 -8
- package/es/src/components/Axis/axisRounding.js +16 -1
- package/es/src/components/Axis/axisScene.js +11 -2
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +128 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +77 -27
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +13 -2
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/Legend/legendCut.js +108 -0
- package/es/src/components/Legend/legendRender.js +38 -13
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +34 -67
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +9 -4
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +226 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +8 -5
- package/es/src/fluent.js +48 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +30 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configValue.js +9 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +268 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +46 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
- package/types/src/charts/ArcDiagram/events.d.ts +29 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
- package/types/src/charts/Network/applyLayout.d.ts +11 -0
- package/types/src/charts/Network/bundle.d.ts +69 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +73 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pack/applyLayout.d.ts +2 -0
- package/types/src/charts/Pack/groupRows.d.ts +46 -0
- package/types/src/charts/Pack/index.d.ts +3 -0
- package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
- package/types/src/charts/Pack/nodeNames.d.ts +23 -0
- package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
- package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
- package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaEnter.d.ts +34 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +16 -15
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
- package/types/src/charts/Pyramid/gutter.d.ts +28 -6
- package/types/src/charts/Pyramid/scene.d.ts +1 -1
- package/types/src/charts/Radar/applyLayout.d.ts +2 -3
- package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
- package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
- package/types/src/charts/Radar/emit.d.ts +5 -2
- package/types/src/charts/Radar/index.d.ts +7 -2
- package/types/src/charts/Radar/points.d.ts +50 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/Rings/emit.d.ts +72 -0
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
- package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/axisTooltip.d.ts +49 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/centerLabel.d.ts +75 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
- package/types/src/charts/features/colorScaleHover.d.ts +13 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +119 -0
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +103 -4
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/hoverTicks.d.ts +30 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +192 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotEndLabels.d.ts +14 -1
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +15 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +25 -4
- package/types/src/charts/viz/VizBase.d.ts +37 -8
- package/types/src/charts/viz/backgroundInk.d.ts +19 -4
- package/types/src/charts/viz/emphasis.d.ts +17 -0
- package/types/src/charts/viz/fillStroke.d.ts +7 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +26 -0
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +35 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +37 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +100 -7
- package/types/src/charts/viz/vizVisibility.d.ts +13 -0
- package/types/src/components/Axis/Axis.d.ts +34 -3
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +21 -3
- package/types/src/components/Axis/axisDefaults.d.ts +12 -0
- package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
- package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
- package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
- package/types/src/components/Axis/axisLayout.d.ts +9 -2
- package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
- package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
- package/types/src/components/Axis/axisLimit.d.ts +18 -0
- package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +8 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
- package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
- package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +6 -0
- package/types/src/components/Legend/legendCut.d.ts +31 -0
- package/types/src/components/Legend/legendRender.d.ts +6 -1
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +5 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/components/textEllipsis.d.ts +6 -0
- package/types/src/fluent.d.ts +18 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +1093 -266
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configValue.d.ts +8 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +72239 -41465
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +46249 -19519
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Network measures in a node's tooltip (Network, Rings, ArcDiagram, and
|
|
3
|
+
Sankey): its degree (in and out when the chart draws arrows, and in
|
|
4
|
+
Sankey), its betweenness and closeness, and its cluster. In a browser,
|
|
5
|
+
betweenness and closeness are worked out in idle time after the chart
|
|
6
|
+
draws (see `scheduleNodeStats`); a tooltip shown before they are ready
|
|
7
|
+
reads "…" for them, and fills them in when they are. They are kept until the chart's nodes or
|
|
8
|
+
links change.
|
|
9
|
+
*/
|
|
10
|
+
import type { DataPoint } from "@d3plus/data";
|
|
11
|
+
import type { ConfigField } from "../../fluent.js";
|
|
12
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
13
|
+
import type { ArrowValue } from "./edgeArrows.js";
|
|
14
|
+
import type { LinkGraph } from "./linkInteraction.js";
|
|
15
|
+
import type { MeasureArc } from "./networkMeasures.js";
|
|
16
|
+
/** A measure a node's tooltip can list. */
|
|
17
|
+
export type NodeStat = "degree" | "betweenness" | "closeness" | "cluster";
|
|
18
|
+
/** Every measure, in the order a node's tooltip lists them. */
|
|
19
|
+
export declare const NODE_STATS: readonly NodeStat[];
|
|
20
|
+
/** One link, as the measures read it. */
|
|
21
|
+
export interface StatLink {
|
|
22
|
+
source: string;
|
|
23
|
+
target: string;
|
|
24
|
+
/** Its index in `links`, for the `arrows` accessor. */
|
|
25
|
+
index: number;
|
|
26
|
+
/** Its value (`linkSize` or `value`), when it is a number. */
|
|
27
|
+
value?: number;
|
|
28
|
+
datum: DataPoint;
|
|
29
|
+
}
|
|
30
|
+
/** What a chart's links say about each node, for one `arrows` and weighting. */
|
|
31
|
+
export interface NodeStatsGraph {
|
|
32
|
+
/** Whether a link carries an arrowhead at one end only, so in and out differ. */
|
|
33
|
+
directed: boolean;
|
|
34
|
+
/** Each node's links (a link to itself counts once). */
|
|
35
|
+
degree: Map<string, number>;
|
|
36
|
+
/** Each node's links arriving at it (directed charts). */
|
|
37
|
+
inDegree: Map<string, number>;
|
|
38
|
+
/** Each node's links leaving it (directed charts). */
|
|
39
|
+
outDegree: Map<string, number>;
|
|
40
|
+
nodes: string[];
|
|
41
|
+
arcs: MeasureArc[];
|
|
42
|
+
}
|
|
43
|
+
type Row = [string, string];
|
|
44
|
+
/** The `nodeTooltipStats` and `nodeTooltipStatsConfig` fields. */
|
|
45
|
+
export declare function nodeStatsFields(): ConfigField[];
|
|
46
|
+
/**
|
|
47
|
+
The measures `nodeTooltipStats` asks for, in its order: every measure
|
|
48
|
+
for `true`, the known names of an Array (once each), and none otherwise.
|
|
49
|
+
*/
|
|
50
|
+
export declare function nodeTooltipStatList(value: unknown): NodeStat[];
|
|
51
|
+
/**
|
|
52
|
+
The degrees and the arcs the measures walk. A link is one-way when
|
|
53
|
+
`arrows` puts a head on one end only (from source to target for
|
|
54
|
+
`"target"`, back for `"source"`), and two-way otherwise. When `weighted`,
|
|
55
|
+
a link's length is the strongest link's weight over its own, so the
|
|
56
|
+
strongest link is one step and a link half as strong is two.
|
|
57
|
+
*/
|
|
58
|
+
export declare function nodeStatsGraph(nodes: string[], links: StatLink[], arrows: ArrowValue | undefined, weighted: boolean): NodeStatsGraph;
|
|
59
|
+
/**
|
|
60
|
+
Whether the measures are worked out in idle time: in a browser, but not
|
|
61
|
+
while `@d3plus/ssr` renders the chart (or anywhere without a window),
|
|
62
|
+
where they are worked out when first asked for.
|
|
63
|
+
*/
|
|
64
|
+
export declare function nodeStatsInIdle(viz: VizInstance): boolean;
|
|
65
|
+
/**
|
|
66
|
+
Works out a published graph's betweenness and closeness in the browser's
|
|
67
|
+
idle time after the chart draws (see `IdleQueue`), so a node's tooltip
|
|
68
|
+
rarely waits for them. The graphs one draw publishes (one per small
|
|
69
|
+
multiple) are settled together in the first idle turn after it: their
|
|
70
|
+
measures are queued, and a run for nodes and links the chart no longer
|
|
71
|
+
draws is cancelled. Nothing is queued while `@d3plus/ssr` renders.
|
|
72
|
+
@param refresh Runs when a graph's measures are ready, to update an open tooltip.
|
|
73
|
+
*/
|
|
74
|
+
export declare function scheduleNodeStats(viz: VizInstance, graph: LinkGraph, links: () => StatLink[], refresh: () => void): void;
|
|
75
|
+
/** What a node's tooltip shows for a measure still being worked out: an ellipsis. */
|
|
76
|
+
export declare const STAT_PENDING = "\u2026";
|
|
77
|
+
/**
|
|
78
|
+
A node's measure rows, in `nodeTooltipStats` order: "Degree" (or
|
|
79
|
+
"In-degree" and "Out-degree" when the chart draws arrows, and in
|
|
80
|
+
Sankey), "Betweenness", "Closeness", and "Cluster" (when clusters color
|
|
81
|
+
the chart and the node is in one). Betweenness and closeness read
|
|
82
|
+
`STAT_PENDING` until they are ready (see `measuresFor`), so the tooltip
|
|
83
|
+
keeps its size when they fill in. `degree` says whether its
|
|
84
|
+
degree is listed, so the tooltip leaves out its count of connections.
|
|
85
|
+
@param links The graph's links, read once per graph, `arrows`, and
|
|
86
|
+
weighting when a measure other than the cluster needs them.
|
|
87
|
+
@param refresh Runs when measures this asked for become ready.
|
|
88
|
+
*/
|
|
89
|
+
export declare function nodeStatRows(viz: VizInstance, graph: LinkGraph, id: string, links: () => StatLink[], refresh?: () => void): {
|
|
90
|
+
rows: Row[];
|
|
91
|
+
degree: boolean;
|
|
92
|
+
};
|
|
93
|
+
export {};
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Polyline geometry for labels drawn along a line (trend line labels, line
|
|
3
|
+
labels that follow their series): trimming a line to the plot, keeping
|
|
4
|
+
its text upright, lifting it clear of the stroke, and the path `d` a
|
|
5
|
+
TextBox `textPath` follows.
|
|
6
|
+
*/
|
|
7
|
+
/** A point in pixels. */
|
|
8
|
+
export type Pt = [number, number];
|
|
9
|
+
/** A rectangle by its edges. */
|
|
10
|
+
export interface Edges {
|
|
11
|
+
x0: number;
|
|
12
|
+
y0: number;
|
|
13
|
+
x1: number;
|
|
14
|
+
y1: number;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
The polyline's length.
|
|
18
|
+
@param points The polyline.
|
|
19
|
+
*/
|
|
20
|
+
export declare function polylineLength(points: Pt[]): number;
|
|
21
|
+
/**
|
|
22
|
+
The polyline in the direction its text reads upright: left to right, or
|
|
23
|
+
bottom to top when it runs (near enough) straight up or down. A line
|
|
24
|
+
running right to left in screen space (a reversed axis, or a fit along
|
|
25
|
+
the y axis) is reversed, so its text never reads upside down.
|
|
26
|
+
@param points The polyline.
|
|
27
|
+
@param steep How far across, for each pixel up or down, a line can run
|
|
28
|
+
and still read bottom to top. Defaults to `0.02`.
|
|
29
|
+
*/
|
|
30
|
+
export declare function uprightPoints(points: Pt[], steep?: number): Pt[];
|
|
31
|
+
/**
|
|
32
|
+
The polyline moved `distance` pixels to its left (above a line running
|
|
33
|
+
left to right), each vertex along the average of its segments' normals.
|
|
34
|
+
@param points The polyline.
|
|
35
|
+
@param distance How far to move it.
|
|
36
|
+
*/
|
|
37
|
+
export declare function offsetPolyline(points: Pt[], distance: number): Pt[];
|
|
38
|
+
/**
|
|
39
|
+
The stretch of the polyline from `from` to `to` pixels along it, its ends
|
|
40
|
+
interpolated.
|
|
41
|
+
@param points The polyline.
|
|
42
|
+
@param from The distance along it where the stretch starts.
|
|
43
|
+
@param to The distance along it where the stretch ends.
|
|
44
|
+
*/
|
|
45
|
+
export declare function trimPolyline(points: Pt[], from: number, to: number): Pt[];
|
|
46
|
+
/**
|
|
47
|
+
A polyline with the distance along it to each of its points, for taking
|
|
48
|
+
many stretches or samples of it in one pass: `trim` and `at` give what
|
|
49
|
+
`trimPolyline` does, but start from the first segment the stretch
|
|
50
|
+
reaches instead of the polyline's first point. Walking forward is
|
|
51
|
+
cheapest; a shorter distance than the last searches back.
|
|
52
|
+
*/
|
|
53
|
+
export declare class PolylineRuler {
|
|
54
|
+
private points;
|
|
55
|
+
/** The polyline's length. */
|
|
56
|
+
readonly length: number;
|
|
57
|
+
/** The distance along the polyline to each point. */
|
|
58
|
+
private cum;
|
|
59
|
+
/** The segment (its end point's index) the last lookup stopped at. */
|
|
60
|
+
private i;
|
|
61
|
+
/** @param points The polyline. */
|
|
62
|
+
constructor(points: Pt[]);
|
|
63
|
+
/** The first segment ending `distance` or more along the polyline (`points.length` when none does). */
|
|
64
|
+
private seek;
|
|
65
|
+
/**
|
|
66
|
+
The stretch from `from` to `to` pixels along the polyline, the same
|
|
67
|
+
points `trimPolyline` gives.
|
|
68
|
+
@param from The distance along it where the stretch starts.
|
|
69
|
+
@param to The distance along it where the stretch ends.
|
|
70
|
+
*/
|
|
71
|
+
trim(from: number, to: number): Pt[];
|
|
72
|
+
/**
|
|
73
|
+
The point `distance` pixels along the polyline, as `trimPolyline`'s
|
|
74
|
+
first point for a stretch from there to there, or undefined past its
|
|
75
|
+
end.
|
|
76
|
+
@param distance The distance along it.
|
|
77
|
+
*/
|
|
78
|
+
at(distance: number): Pt | undefined;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
The longest run of consecutive points inside `rect`: the part of a line a
|
|
82
|
+
label can sit on where the plot's domains don't cut it off.
|
|
83
|
+
@param points The polyline.
|
|
84
|
+
@param rect The plot area.
|
|
85
|
+
*/
|
|
86
|
+
export declare function visibleRun(points: Pt[], rect: Edges): Pt[];
|
|
87
|
+
/**
|
|
88
|
+
The SVG path `d` through a polyline's points.
|
|
89
|
+
@param points The polyline.
|
|
90
|
+
*/
|
|
91
|
+
export declare function polylineD(points: Pt[]): string;
|
|
92
|
+
/**
|
|
93
|
+
The plot area's edges from its x and y ranges, the y range shifted up by
|
|
94
|
+
the top x axis's height, as the plot's clip reads them.
|
|
95
|
+
@param xRange The x range in pixels.
|
|
96
|
+
@param yRange The y range in pixels.
|
|
97
|
+
@param x2Height The top x axis's height.
|
|
98
|
+
*/
|
|
99
|
+
export declare function plotEdges(xRange: unknown[], yRange: unknown[], x2Height?: number): Edges;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Labels drawn along a line with a TextBox `textPath`: in their line's
|
|
3
|
+
color, legible on the chart's background, over a halo of that background,
|
|
4
|
+
and inert (no hover, click, or keyboard stop). A label given its mark's
|
|
5
|
+
datum dims and highlights with that mark.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { SceneNode } from "@d3plus/render";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
/** One label along a path. */
|
|
11
|
+
export interface PathLabel {
|
|
12
|
+
/** The label's scene key. */
|
|
13
|
+
key: string;
|
|
14
|
+
text: string;
|
|
15
|
+
/** The path's `d`, in the plot's coordinates. */
|
|
16
|
+
d: string;
|
|
17
|
+
/** The line's color, made legible on the chart's background. */
|
|
18
|
+
color: string;
|
|
19
|
+
/** Where along the path the text sits: `"start"`, `"middle"`, or `"end"`. */
|
|
20
|
+
anchor: "start" | "middle" | "end";
|
|
21
|
+
/** The datum of the mark the label names, so hover dims them together. */
|
|
22
|
+
datum?: DataPoint;
|
|
23
|
+
/** That mark's index. */
|
|
24
|
+
index?: number;
|
|
25
|
+
}
|
|
26
|
+
/** Options for `pathLabelNodes`. */
|
|
27
|
+
export interface PathLabelOptions {
|
|
28
|
+
/** Whether a halo of the chart's background clears the marks around the text. Defaults to `true`. */
|
|
29
|
+
halo?: boolean;
|
|
30
|
+
}
|
|
31
|
+
/** The label font size when a config sets none. */
|
|
32
|
+
export declare const PATH_LABEL_FONT_SIZE = 11;
|
|
33
|
+
/**
|
|
34
|
+
The scene nodes for labels along paths, each cut short with an ellipsis
|
|
35
|
+
when its path is too short for it.
|
|
36
|
+
@param viz The chart, for its theme, background, and locale.
|
|
37
|
+
@param labels The labels.
|
|
38
|
+
@param config TextBox config laid over the defaults.
|
|
39
|
+
@param options Whether the text takes a halo.
|
|
40
|
+
*/
|
|
41
|
+
export declare function pathLabelNodes(viz: VizInstance, labels: PathLabel[], config?: Record<string, unknown>, options?: PathLabelOptions): SceneNode[];
|
|
@@ -7,12 +7,9 @@ import type { SceneNode } from "@d3plus/render";
|
|
|
7
7
|
import * as shapes from "../../shapes/index.js";
|
|
8
8
|
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
9
9
|
import type { PlotAxisFn } from "./plotPaint.js";
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
layer?: string;
|
|
14
|
-
[key: string]: unknown;
|
|
15
|
-
}
|
|
10
|
+
import type { AnnotationFrame } from "./annotationFrame.js";
|
|
11
|
+
import type { Annotation } from "./annotationTypes.js";
|
|
12
|
+
export type { Annotation };
|
|
16
13
|
/**
|
|
17
14
|
Wraps one annotation's scene in its OWN stable-keyed group, keeping the
|
|
18
15
|
shape's node group and label group as distinct sub-groups (rather than
|
|
@@ -31,8 +28,26 @@ export declare function collectAnnotationGroup(inst: shapes.Shape, key: string):
|
|
|
31
28
|
same mapping user `annotations` get.
|
|
32
29
|
*/
|
|
33
30
|
export declare function renderPlotAnnotation(viz: Viz, annotation: Annotation, x: PlotAxisFn, y: PlotAxisFn, domains: Record<string, unknown[]>, yOffset: number): shapes.Shape;
|
|
31
|
+
/**
|
|
32
|
+
The layer an annotation draws in: its own `layer`, else `"front"` for a
|
|
33
|
+
callout and `"back"` for everything else.
|
|
34
|
+
@param annotation The annotation.
|
|
35
|
+
*/
|
|
36
|
+
export declare function annotationLayer(annotation: Annotation): string;
|
|
37
|
+
/**
|
|
38
|
+
Every annotation a Plot draws: its `referenceBands`, then its
|
|
39
|
+
`referenceLines` (so lines draw over bands), then its own `annotations`.
|
|
40
|
+
@param viz The chart.
|
|
41
|
+
*/
|
|
42
|
+
export declare function plotAnnotationList(viz: Viz): Annotation[];
|
|
34
43
|
/**
|
|
35
44
|
Renders back/front annotations, pushing back-layer scenes onto `out` and
|
|
36
|
-
returning the front-layer
|
|
45
|
+
returning the front-layer groups, which the caller places above the data
|
|
46
|
+
shapes. A back-layer reference line or band's label joins the front
|
|
47
|
+
groups, so the data never covers it.
|
|
37
48
|
*/
|
|
38
|
-
export declare function emitAnnotations(viz: Viz, out: SceneNode[],
|
|
49
|
+
export declare function emitAnnotations(viz: Viz, out: SceneNode[], axes: {
|
|
50
|
+
x: PlotAxisFn;
|
|
51
|
+
y: PlotAxisFn;
|
|
52
|
+
frame: AnnotationFrame;
|
|
53
|
+
}, domains: Record<string, number[]>, yOffset: number): SceneNode[];
|
|
@@ -64,7 +64,7 @@ export declare function labelsXEnds(viz: Viz, showX: boolean, showY: boolean): b
|
|
|
64
64
|
export declare function domainEnds(axis: Axis): unknown[];
|
|
65
65
|
/**
|
|
66
66
|
Formats an axis's domain ends with its tick format and measures them with
|
|
67
|
-
its label font (
|
|
67
|
+
its label font and line height (see `labelLineHeight`).
|
|
68
68
|
Read after the axis has been measured or rendered.
|
|
69
69
|
*/
|
|
70
70
|
export declare function measureEndLabels(axis: Axis): EndLabelMeasure;
|
|
@@ -74,6 +74,19 @@ export declare function measureEndLabels(axis: Axis): EndLabelMeasure;
|
|
|
74
74
|
claim) shorter than the labels.
|
|
75
75
|
*/
|
|
76
76
|
export declare function endLabelSpace(measure: EndLabelMeasure, available: number): number;
|
|
77
|
+
/** How a Plot labels its x axis, and the height those labels claim below the plot. */
|
|
78
|
+
export interface XLabelClaim {
|
|
79
|
+
xLabelMode: XLabelMode;
|
|
80
|
+
xHeight: number;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
The x labels a Plot keeps once its chrome (title, legend, the corner
|
|
84
|
+
controls' reach, …) has claimed its margins. End labels claim their room
|
|
85
|
+
against the chart area as it stood before; when `room`, the height left
|
|
86
|
+
for the plot and its x labels, no longer holds both (see
|
|
87
|
+
`endLabelSpace`), they are dropped and the plot takes their height.
|
|
88
|
+
*/
|
|
89
|
+
export declare function endLabelsInRoom(claim: XLabelClaim, measure: () => EndLabelMeasure, room: number): XLabelClaim;
|
|
77
90
|
/**
|
|
78
91
|
Splits `span` between a start and an end label of natural widths `start`
|
|
79
92
|
and `end`, at least `gap` apart. Labels that fit keep room to their
|
|
@@ -15,6 +15,7 @@ import type { ClipShape, SceneNode } from "@d3plus/render";
|
|
|
15
15
|
import type Axis from "../../components/Axis/Axis.js";
|
|
16
16
|
import type { EndLabelBox, XLabelMode } from "./plotEndLabels.js";
|
|
17
17
|
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
18
|
+
import type { LineLabelSide } from "../Plot/lineLabelSides.js";
|
|
18
19
|
/** An axis position function: maps a domain value to a pixel coordinate. */
|
|
19
20
|
export type PlotAxisFn = (d: unknown, axis?: string) => number;
|
|
20
21
|
/**
|
|
@@ -24,6 +25,18 @@ export type PlotAxisFn = (d: unknown, axis?: string) => number;
|
|
|
24
25
|
*/
|
|
25
26
|
export interface LabelWidth {
|
|
26
27
|
id: string | number;
|
|
28
|
+
/** Which end of its line the label sits past (the right end when unset). */
|
|
29
|
+
side?: LineLabelSide;
|
|
30
|
+
/** The formatted value the label shows after the series name, if any. */
|
|
31
|
+
valueText?: string;
|
|
32
|
+
/** The series name, shortened to fit the label's room; unset when it fits. */
|
|
33
|
+
name?: string;
|
|
34
|
+
/** The plot had no room for this label (see `collapsed`). */
|
|
35
|
+
hidden?: boolean;
|
|
36
|
+
/** How many labels this one stands for as "+N more", when the plot had no room for them all. */
|
|
37
|
+
collapsed?: number;
|
|
38
|
+
/** The label's width, padding included. */
|
|
39
|
+
labelWidth?: number;
|
|
27
40
|
xValue: unknown;
|
|
28
41
|
value: unknown;
|
|
29
42
|
fontSize: number;
|
|
@@ -122,6 +135,8 @@ export interface PlotPaintContext {
|
|
|
122
135
|
y2Ticks: unknown[];
|
|
123
136
|
labelWidths: LabelWidth[];
|
|
124
137
|
largestLabel: number;
|
|
138
|
+
/** The room left of the x range for the lines' left-end labels. */
|
|
139
|
+
startLabelSpace?: number;
|
|
125
140
|
xRangeMax: number;
|
|
126
141
|
xTest: Axis;
|
|
127
142
|
yTest: Axis;
|
|
@@ -164,6 +179,8 @@ export interface PlotPaintContext {
|
|
|
164
179
|
zoomAxes?: Partial<Record<"x" | "x2" | "y" | "y2", Record<string, unknown>>>;
|
|
165
180
|
/** Where a zoom repaint's unzoomed x/y plot ranges land (see `Plot/plotZoom.ts`). */
|
|
166
181
|
zoomRanges?: Partial<Record<"x" | "y", number[]>>;
|
|
182
|
+
/** Line rows with no plottable value, where `connectGaps` breaks lines. */
|
|
183
|
+
missingRows?: PlotDatum[];
|
|
167
184
|
}
|
|
168
185
|
/**
|
|
169
186
|
Result of the MEASURE phase of plotPaint. Captures everything the EMIT
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Measuring and drawing polylines: a sampled curve, a map's projected
|
|
3
|
+
link, or a bundled edge, as a list of `[x, y]` points.
|
|
4
|
+
*/
|
|
5
|
+
import type { LinkAnchor } from "./linkLabelGeometry.js";
|
|
6
|
+
/** A point in pixels, `[x, y]`. */
|
|
7
|
+
export type Point = [number, number];
|
|
8
|
+
/** A polyline as a path `d`. */
|
|
9
|
+
export declare function polylinePath(points: Point[]): string;
|
|
10
|
+
/**
|
|
11
|
+
A polyline shortened along its length by `start` pixels at its first
|
|
12
|
+
end and `end` at its last. When the cuts meet, it collapses to the
|
|
13
|
+
point where they do.
|
|
14
|
+
*/
|
|
15
|
+
export declare function trimPolyline(points: Point[], start: number, end: number): Point[];
|
|
16
|
+
/** A polyline's length. */
|
|
17
|
+
export declare function polylineLength(points: Point[]): number;
|
|
18
|
+
/**
|
|
19
|
+
The point `distance` along a polyline from its start (clamped to its
|
|
20
|
+
ends), and the direction the polyline runs there, in radians.
|
|
21
|
+
*/
|
|
22
|
+
export declare function polylineAt(points: Point[], distance: number): LinkAnchor;
|
|
23
|
+
/** The middle of a polyline's length, and its direction there. */
|
|
24
|
+
export declare function polylineMidpoint(points: Point[]): LinkAnchor;
|
|
25
|
+
/** The box around a polyline, as `[[x0, y0], [x1, y1]]`. */
|
|
26
|
+
export declare function polylineBox(points: Point[]): [Point, Point];
|
|
27
|
+
/**
|
|
28
|
+
How far along a polyline, from its first point, it first gets `radius`
|
|
29
|
+
pixels away from that point: where it leaves a circle of that radius
|
|
30
|
+
around its start. The polyline's whole length when it never does.
|
|
31
|
+
*/
|
|
32
|
+
export declare function polylineReach(points: Point[], radius: number): number;
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Reference lines and bands: `referenceLines`/`referenceBands` entries
|
|
3
|
+
expand into `"ReferenceLine"`/`"ReferenceBand"` annotations, drawn as a
|
|
4
|
+
line across the whole plot at one value, or a shaded span between two,
|
|
5
|
+
with an optional label. Both sit behind the data unless `layer: "front"`;
|
|
6
|
+
their labels draw above it, clear of the data labels (see
|
|
7
|
+
`placeReferenceLabels`).
|
|
8
|
+
*/
|
|
9
|
+
import type { SceneNode } from "@d3plus/render";
|
|
10
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
11
|
+
import { type AnnotationAxis, type AnnotationFrame } from "./annotationFrame.js";
|
|
12
|
+
import { type TextAlign, type TextBlock } from "./annotationText.js";
|
|
13
|
+
import type { Annotation } from "./annotationTypes.js";
|
|
14
|
+
import type { Box } from "./calloutLayout.js";
|
|
15
|
+
import { type LabelSpot } from "./referenceLabelPlacement.js";
|
|
16
|
+
/** The annotation shape a `referenceLines` entry expands into. */
|
|
17
|
+
export declare const REFERENCE_LINE = "ReferenceLine";
|
|
18
|
+
/** The annotation shape a `referenceBands` entry expands into. */
|
|
19
|
+
export declare const REFERENCE_BAND = "ReferenceBand";
|
|
20
|
+
/**
|
|
21
|
+
Expands `referenceLines` into `"ReferenceLine"` annotations, in the back
|
|
22
|
+
layer unless an entry sets its own.
|
|
23
|
+
@param setting The `referenceLines` setting.
|
|
24
|
+
*/
|
|
25
|
+
export declare function expandReferenceLines(setting: unknown): Annotation[];
|
|
26
|
+
/**
|
|
27
|
+
Expands `referenceBands` into `"ReferenceBand"` annotations, in the back
|
|
28
|
+
layer unless an entry sets its own.
|
|
29
|
+
@param setting The `referenceBands` setting.
|
|
30
|
+
*/
|
|
31
|
+
export declare function expandReferenceBands(setting: unknown): Annotation[];
|
|
32
|
+
/**
|
|
33
|
+
The axis a reference entry is on: the first of `x`, `y`, `x2`, `y2` it
|
|
34
|
+
sets, or null.
|
|
35
|
+
@param entry The entry.
|
|
36
|
+
*/
|
|
37
|
+
export declare function referenceAxis(entry: Record<string, unknown>): AnnotationAxis | null;
|
|
38
|
+
/**
|
|
39
|
+
Where a reference line runs: its axis, its pixel position `at` along that
|
|
40
|
+
axis, and its two end points across the plot (start first). Null when it
|
|
41
|
+
has no position or falls outside the plot area.
|
|
42
|
+
@param frame The plot area and its axes.
|
|
43
|
+
@param entry The reference line.
|
|
44
|
+
*/
|
|
45
|
+
export declare function referenceLinePoints(frame: AnnotationFrame, entry: Record<string, unknown>): {
|
|
46
|
+
axis: AnnotationAxis;
|
|
47
|
+
at: number;
|
|
48
|
+
points: [number, number][];
|
|
49
|
+
} | null;
|
|
50
|
+
/**
|
|
51
|
+
The rect a reference band shades, clipped to the plot area, and its
|
|
52
|
+
axis. Null when it has no position or lies wholly outside the plot.
|
|
53
|
+
@param frame The plot area and its axes.
|
|
54
|
+
@param entry The reference band.
|
|
55
|
+
*/
|
|
56
|
+
export declare function referenceBandRect(frame: AnnotationFrame, entry: Record<string, unknown>): {
|
|
57
|
+
axis: AnnotationAxis;
|
|
58
|
+
box: Box;
|
|
59
|
+
} | null;
|
|
60
|
+
/**
|
|
61
|
+
Where a reference line's label goes (the top-left of its text block, and
|
|
62
|
+
its alignment): beside the line's `"end"` (the right of a horizontal line,
|
|
63
|
+
the top of a vertical one) or `"start"`, above a horizontal line (below
|
|
64
|
+
it near the plot's top) and right of a vertical one (left of it near the
|
|
65
|
+
plot's right edge).
|
|
66
|
+
@param frame The plot area and its axes.
|
|
67
|
+
@param line The line's axis and pixel position.
|
|
68
|
+
@param block The wrapped label.
|
|
69
|
+
@param position Which end of the line.
|
|
70
|
+
*/
|
|
71
|
+
export declare function referenceLineLabelAt(frame: AnnotationFrame, line: {
|
|
72
|
+
axis: AnnotationAxis;
|
|
73
|
+
at: number;
|
|
74
|
+
}, block: TextBlock, position?: "start" | "end"): {
|
|
75
|
+
x: number;
|
|
76
|
+
y: number;
|
|
77
|
+
align: TextAlign;
|
|
78
|
+
};
|
|
79
|
+
/**
|
|
80
|
+
Where a reference band's label goes: inside its top-left corner
|
|
81
|
+
(`"start"`) or top-right (`"end"`).
|
|
82
|
+
@param box The band's rect.
|
|
83
|
+
@param position Which corner.
|
|
84
|
+
*/
|
|
85
|
+
export declare function referenceBandLabelAt(box: Box, position?: "start" | "end"): {
|
|
86
|
+
x: number;
|
|
87
|
+
y: number;
|
|
88
|
+
align: TextAlign;
|
|
89
|
+
};
|
|
90
|
+
/**
|
|
91
|
+
Every spot a reference line's label may take, the one
|
|
92
|
+
`referenceLineLabelAt` picks first: then the other side of the line, then
|
|
93
|
+
the line's other end on either side, then along the line from the
|
|
94
|
+
preferred end on either side.
|
|
95
|
+
@param frame The plot area and its axes.
|
|
96
|
+
@param line The line's axis and pixel position.
|
|
97
|
+
@param block The wrapped label.
|
|
98
|
+
@param position Which end of the line is preferred.
|
|
99
|
+
*/
|
|
100
|
+
export declare function referenceLineLabelSpots(frame: AnnotationFrame, line: {
|
|
101
|
+
axis: AnnotationAxis;
|
|
102
|
+
at: number;
|
|
103
|
+
}, block: TextBlock, position?: "start" | "end"): LabelSpot[];
|
|
104
|
+
/**
|
|
105
|
+
Every spot a reference band's label may take, inside the band: the
|
|
106
|
+
corner `referenceBandLabelAt` picks first, then the other top corner,
|
|
107
|
+
then the bottom corners, then along the band's length from its top (or,
|
|
108
|
+
across the plot, from its preferred side).
|
|
109
|
+
@param box The band's rect.
|
|
110
|
+
@param axis The band's axis.
|
|
111
|
+
@param block The wrapped label.
|
|
112
|
+
@param position Which top corner is preferred.
|
|
113
|
+
*/
|
|
114
|
+
export declare function referenceBandLabelSpots(box: Box, axis: AnnotationAxis, block: TextBlock, position?: "start" | "end"): LabelSpot[];
|
|
115
|
+
/**
|
|
116
|
+
The scene nodes of a reference line: the line and its label.
|
|
117
|
+
@param viz The chart.
|
|
118
|
+
@param annotation The `"ReferenceLine"` annotation.
|
|
119
|
+
@param frame The plot area and its axes.
|
|
120
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
121
|
+
*/
|
|
122
|
+
export declare function referenceLineNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, key: string): SceneNode[];
|
|
123
|
+
/**
|
|
124
|
+
The scene nodes of a reference band: the shaded rect and its label.
|
|
125
|
+
@param viz The chart.
|
|
126
|
+
@param annotation The `"ReferenceBand"` annotation.
|
|
127
|
+
@param frame The plot area and its axes.
|
|
128
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
129
|
+
*/
|
|
130
|
+
export declare function referenceBandNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, key: string): SceneNode[];
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Where reference line and band labels go once the data is drawn: each
|
|
3
|
+
label has a list of spots, its preferred one first, and takes the first
|
|
4
|
+
whose box is clear of the data labels and of the reference labels placed
|
|
5
|
+
before it, inside the plot. A label with no clear spot is hidden.
|
|
6
|
+
*/
|
|
7
|
+
import type { SceneNode } from "@d3plus/render";
|
|
8
|
+
import type { PlotRect } from "./annotationFrame.js";
|
|
9
|
+
import type { TextAlign, TextBlock } from "./annotationText.js";
|
|
10
|
+
import type { Box } from "./calloutLayout.js";
|
|
11
|
+
/** A spot a label may take: its text block's top at `y`, lined up against `x` by `align`. */
|
|
12
|
+
export interface LabelSpot {
|
|
13
|
+
x: number;
|
|
14
|
+
y: number;
|
|
15
|
+
align: TextAlign;
|
|
16
|
+
}
|
|
17
|
+
/** Gap between a reference label and its line or band edge, in pixels. */
|
|
18
|
+
export declare const LABEL_PAD = 4;
|
|
19
|
+
/**
|
|
20
|
+
Records the spots a reference label node may move to (its preferred spot
|
|
21
|
+
first, where it is drawn), for `placeReferenceLabels`.
|
|
22
|
+
@param node The label's text node.
|
|
23
|
+
@param block The wrapped label.
|
|
24
|
+
@param spots Its spots, preferred first.
|
|
25
|
+
*/
|
|
26
|
+
export declare function registerLabelSpots(node: SceneNode, block: TextBlock, spots: LabelSpot[]): void;
|
|
27
|
+
/**
|
|
28
|
+
The box a label's block covers at a spot.
|
|
29
|
+
@param spot The spot.
|
|
30
|
+
@param block The wrapped label.
|
|
31
|
+
*/
|
|
32
|
+
export declare function labelSpotBox(spot: LabelSpot, block: TextBlock): Box;
|
|
33
|
+
/**
|
|
34
|
+
The first of `spots` whose box is clear of every obstacle and inside the
|
|
35
|
+
plot (the first spot, the preferred one, need only be clear), or null
|
|
36
|
+
when none is.
|
|
37
|
+
@param spots The spots, preferred first.
|
|
38
|
+
@param block The wrapped label.
|
|
39
|
+
@param obstacles The boxes to stay clear of.
|
|
40
|
+
@param plot The plot area.
|
|
41
|
+
*/
|
|
42
|
+
export declare function pickLabelSpot(spots: LabelSpot[], block: TextBlock, obstacles: Box[], plot: PlotRect): LabelSpot | null;
|
|
43
|
+
/**
|
|
44
|
+
Positions from `from` toward `to`, `SLIDE_STEP` apart, both ends included.
|
|
45
|
+
@param from The first position.
|
|
46
|
+
@param to The last.
|
|
47
|
+
*/
|
|
48
|
+
export declare function slideSteps(from: number, to: number): number[];
|
|
49
|
+
/**
|
|
50
|
+
Moves each registered reference label among `nodes` to its first clear
|
|
51
|
+
spot (see `pickLabelSpot`), in order, each placed label joining the
|
|
52
|
+
obstacles of the ones after it, and drops a label with no clear spot.
|
|
53
|
+
Returns the nodes with the labels moved; unregistered nodes pass through.
|
|
54
|
+
@param nodes Scene nodes holding reference labels, at any depth.
|
|
55
|
+
@param obstacles The boxes to keep clear of, such as the data labels'.
|
|
56
|
+
@param plot The plot area.
|
|
57
|
+
*/
|
|
58
|
+
export declare function placeReferenceLabels(nodes: SceneNode[], obstacles: Box[], plot: PlotRect): SceneNode[];
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene nodes for curved ring labels (see `ringLabels.ts`): text along
|
|
3
|
+
each label's arc in a color that reads on what lies under it, carrying
|
|
4
|
+
its segment's datum so it dims with it, inert, and fading rather than
|
|
5
|
+
gliding when a redraw moves it.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { FadeSwap, SceneNode, TextNode } from "@d3plus/render";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { LinkLabelBox } from "./linkLabelGeometry.js";
|
|
11
|
+
import type { RingLabelFit } from "./ringLabels.js";
|
|
12
|
+
/**
|
|
13
|
+
How a curved label fades through a redraw that moves it: out over the
|
|
14
|
+
first 6% of the eased progress, back in over the last 6%, so it never
|
|
15
|
+
slides along the ring while its segment's arc tweens.
|
|
16
|
+
*/
|
|
17
|
+
export declare const RING_LABEL_FADE: FadeSwap;
|
|
18
|
+
/** One curved label. */
|
|
19
|
+
export interface RingLabel {
|
|
20
|
+
/** Its scene key. */
|
|
21
|
+
key: string;
|
|
22
|
+
text: string;
|
|
23
|
+
/** Where it goes (see `ringLabelFit`). */
|
|
24
|
+
fit: Pick<RingLabelFit, "d" | "fontSize">;
|
|
25
|
+
/** Its text color. */
|
|
26
|
+
color: string;
|
|
27
|
+
/** The segment's datum, so hover dims them together. */
|
|
28
|
+
datum?: DataPoint;
|
|
29
|
+
/** The segment's index. */
|
|
30
|
+
index?: number;
|
|
31
|
+
}
|
|
32
|
+
/** The plain-value font keys a label config may set. */
|
|
33
|
+
export interface RingLabelFont {
|
|
34
|
+
fontFamily?: string | string[];
|
|
35
|
+
fontWeight?: number | string;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
The label font a shape's labelConfig sets, as plain values (accessors
|
|
39
|
+
are left to the defaults).
|
|
40
|
+
@param config The labelConfig.
|
|
41
|
+
*/
|
|
42
|
+
export declare function ringLabelFont(config: Record<string, unknown>): RingLabelFont;
|
|
43
|
+
/**
|
|
44
|
+
A text's one-line width in a ring label font, by font size.
|
|
45
|
+
@param text The text.
|
|
46
|
+
@param font The label font.
|
|
47
|
+
*/
|
|
48
|
+
export declare function ringTextWidth(text: string, font: RingLabelFont): (fontSize: number) => number;
|
|
49
|
+
/**
|
|
50
|
+
The text nodes for curved labels: one per label that keeps some text
|
|
51
|
+
after it is cut to its path, each in its own font size and color.
|
|
52
|
+
@param viz The chart, for its locale.
|
|
53
|
+
@param labels The labels.
|
|
54
|
+
@param font The label font.
|
|
55
|
+
*/
|
|
56
|
+
export declare function ringLabelNodes(viz: VizInstance, labels: RingLabel[], font?: RingLabelFont): TextNode[];
|
|
57
|
+
/**
|
|
58
|
+
The labels that stay clear of each other and of `obstacles`, earlier
|
|
59
|
+
labels winning.
|
|
60
|
+
@param nodes The label nodes, in priority order.
|
|
61
|
+
@param obstacles Boxes they must stay clear of, such as other labels.
|
|
62
|
+
*/
|
|
63
|
+
export declare function clearRingLabels<T extends SceneNode>(nodes: T[], obstacles?: LinkLabelBox[]): T[];
|