@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,99 @@
|
|
|
1
|
+
type Point = [number, number];
|
|
2
|
+
/** A stretch of a path, as `[start, end]` lengths along it. */
|
|
3
|
+
export type Interval = [number, number];
|
|
4
|
+
/** The style object `connectGaps` takes for a bridge. */
|
|
5
|
+
export interface ConnectGapsConfig {
|
|
6
|
+
stroke?: string;
|
|
7
|
+
strokeDasharray?: string | number | number[] | false;
|
|
8
|
+
strokeWidth?: number;
|
|
9
|
+
opacity?: number;
|
|
10
|
+
}
|
|
11
|
+
/** Everything `connectGaps` takes. */
|
|
12
|
+
export type ConnectGaps = boolean | "solid" | "dashed" | ConnectGapsConfig;
|
|
13
|
+
/** How a bridge across a gap is drawn. Unset keys take the line's own style. */
|
|
14
|
+
export interface GapBridge {
|
|
15
|
+
stroke?: string;
|
|
16
|
+
strokeDasharray?: number[];
|
|
17
|
+
strokeWidth?: number;
|
|
18
|
+
opacity: number;
|
|
19
|
+
}
|
|
20
|
+
/** The dash pattern `"dashed"` bridges a gap with: short and sparse, unlike a forecast's `"6 4"`. */
|
|
21
|
+
export declare const GAP_DASH: number[];
|
|
22
|
+
/**
|
|
23
|
+
What a `connectGaps` setting asks for: null when lines run through their
|
|
24
|
+
gaps as one continuous line (`true`, `"solid"`, unset), otherwise lines
|
|
25
|
+
break at each gap and `bridge` is the style of the line drawn across it,
|
|
26
|
+
or null to leave the gap empty (`false`).
|
|
27
|
+
@param value The setting.
|
|
28
|
+
*/
|
|
29
|
+
export declare function resolveConnectGaps(value: unknown): {
|
|
30
|
+
bridge: GapBridge | null;
|
|
31
|
+
} | null;
|
|
32
|
+
/**
|
|
33
|
+
The indices `k` of a line's points that a gap follows: some missing value
|
|
34
|
+
lies strictly between point `k` and point `k + 1` along the discrete axis.
|
|
35
|
+
A missing value before the first point or after the last makes no gap.
|
|
36
|
+
@param ranks Each drawn point's position along the discrete axis, in drawn order.
|
|
37
|
+
@param missing The positions with no value: every step any line has, and
|
|
38
|
+
the line's own rows with no plottable value.
|
|
39
|
+
*/
|
|
40
|
+
export declare function gapsAfter(ranks: number[], missing: number[]): number[];
|
|
41
|
+
/**
|
|
42
|
+
How far along a polyline it first reaches each of `targets` along one
|
|
43
|
+
axis, searching on from where it reached the one before, and its total
|
|
44
|
+
length. A target it never reaches lies at its full length.
|
|
45
|
+
@param line The polyline (see `curvePolyline`).
|
|
46
|
+
@param axis `0` to measure along x, `1` along y.
|
|
47
|
+
@param targets The positions to reach, in order along the line.
|
|
48
|
+
*/
|
|
49
|
+
export declare function pointLengths(line: Point[], axis: 0 | 1, targets: number[]): {
|
|
50
|
+
at: number[];
|
|
51
|
+
total: number;
|
|
52
|
+
};
|
|
53
|
+
/**
|
|
54
|
+
The stretches a dash pattern draws between `from` and `to`, starting the
|
|
55
|
+
pattern at `from`. No pattern (or one that draws nothing) draws the
|
|
56
|
+
whole stretch.
|
|
57
|
+
@param dash The pattern, as `[dash, gap, …]`.
|
|
58
|
+
@param from Where the stretch starts.
|
|
59
|
+
@param to Where it ends.
|
|
60
|
+
*/
|
|
61
|
+
export declare function patternIntervals(dash: number[] | undefined, from: number, to: number): Interval[];
|
|
62
|
+
/**
|
|
63
|
+
Where two lists of stretches overlap.
|
|
64
|
+
@param a Sorted, non-overlapping stretches.
|
|
65
|
+
@param b Sorted, non-overlapping stretches.
|
|
66
|
+
*/
|
|
67
|
+
export declare function intersectIntervals(a: Interval[], b: Interval[]): Interval[];
|
|
68
|
+
/**
|
|
69
|
+
The stretches of `[0, total]` a list of stretches leaves out.
|
|
70
|
+
@param intervals Sorted, non-overlapping stretches.
|
|
71
|
+
@param total The path's length.
|
|
72
|
+
*/
|
|
73
|
+
export declare function complementIntervals(intervals: Interval[], total: number): Interval[];
|
|
74
|
+
/**
|
|
75
|
+
The dash array that draws a path along exactly the given stretches and
|
|
76
|
+
nothing else, ending in a gap long enough that the pattern never repeats.
|
|
77
|
+
@param intervals Sorted, non-overlapping stretches to draw.
|
|
78
|
+
@param total The path's length.
|
|
79
|
+
*/
|
|
80
|
+
export declare function intervalsDash(intervals: Interval[], total: number): number[];
|
|
81
|
+
/**
|
|
82
|
+
A line's path with a separate subpath for each run of points between its
|
|
83
|
+
gaps, so nothing spans a gap. A point between two gaps gets a short tick
|
|
84
|
+
along the discrete axis.
|
|
85
|
+
@param points The line's points, in drawn order.
|
|
86
|
+
@param gaps The indices a gap follows (see `gapsAfter`).
|
|
87
|
+
@param curve The line's curve name.
|
|
88
|
+
@param axis `0` when the discrete axis is x, `1` when it is y.
|
|
89
|
+
@param stub Half the length of a lone point's tick.
|
|
90
|
+
*/
|
|
91
|
+
export declare function runPath(points: Point[], gaps: number[], curve: string, axis: 0 | 1, stub?: number): string;
|
|
92
|
+
/**
|
|
93
|
+
Each run of points between a line's gaps, as its `[first, last]` point
|
|
94
|
+
indices.
|
|
95
|
+
@param count The line's point count.
|
|
96
|
+
@param gaps The indices a gap follows (see `gapsAfter`).
|
|
97
|
+
*/
|
|
98
|
+
export declare function runIndices(count: number, gaps: number[]): Interval[];
|
|
99
|
+
export {};
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene side of a Plot's `connectGaps`: each line's gaps, read from its
|
|
3
|
+
rows, and the edits that break the line there. A line keeps its one path
|
|
4
|
+
through every point, so it follows its curve across a gap; its dash array
|
|
5
|
+
leaves the gaps out, its hit area stops at them, and a bridge (the same
|
|
6
|
+
path, drawn only across the gaps) is decoration that takes no pointer or
|
|
7
|
+
keyboard focus. Confidence bands are clipped to the runs between gaps.
|
|
8
|
+
*/
|
|
9
|
+
import type { SceneNode } from "@d3plus/render";
|
|
10
|
+
import type { ShapeEmitContext } from "../features/shapeEmit.js";
|
|
11
|
+
import { type GapBridge, type Interval } from "./connectGaps.js";
|
|
12
|
+
type Point = [number, number];
|
|
13
|
+
/** One line's gaps, measured along its path. */
|
|
14
|
+
export interface SeriesGaps {
|
|
15
|
+
/** The line's points, in plot space and drawn order. */
|
|
16
|
+
points: Point[];
|
|
17
|
+
/** The indices a gap follows. */
|
|
18
|
+
gaps: number[];
|
|
19
|
+
/** The stretches of the path that cross a gap. */
|
|
20
|
+
gapIntervals: Interval[];
|
|
21
|
+
/** The path's length. */
|
|
22
|
+
total: number;
|
|
23
|
+
}
|
|
24
|
+
/** Every gapped line of a Line group, by series id, and how to draw the gaps. */
|
|
25
|
+
export interface LineGaps {
|
|
26
|
+
series: Map<string, SeriesGaps>;
|
|
27
|
+
bridge: GapBridge | null;
|
|
28
|
+
curve: string;
|
|
29
|
+
/** `0` when the discrete axis is x, `1` when it is y. */
|
|
30
|
+
axis: 0 | 1;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
The gaps in each line of a Line group, or null when `connectGaps` draws
|
|
34
|
+
lines straight through them or no line has one. A gap is a step of the
|
|
35
|
+
discrete axis that some line in the group has and this one skips, or one
|
|
36
|
+
of this line's own rows whose value can't be plotted (`null`, `NaN`).
|
|
37
|
+
@param ctx The Line group's emit context.
|
|
38
|
+
*/
|
|
39
|
+
export declare function lineGaps(ctx: ShapeEmitContext): LineGaps | null;
|
|
40
|
+
/**
|
|
41
|
+
Breaks each gapped line among a Line group's nodes: the line's dash array
|
|
42
|
+
leaves its gaps empty, its hit area stops at them, and a bridge follows
|
|
43
|
+
it when `connectGaps` asks for one.
|
|
44
|
+
@param nodes The Line shape's computed nodes.
|
|
45
|
+
@param gaps The group's gaps (see `lineGaps`).
|
|
46
|
+
*/
|
|
47
|
+
export declare function breakLines(nodes: SceneNode[], gaps: LineGaps): SceneNode[];
|
|
48
|
+
/**
|
|
49
|
+
Clips each gapped line's confidence bands to the runs between its gaps,
|
|
50
|
+
so no band spans a stretch with no value.
|
|
51
|
+
@param nodes The band Areas' computed nodes.
|
|
52
|
+
@param gaps The group's gaps (see `lineGaps`).
|
|
53
|
+
*/
|
|
54
|
+
export declare function clipBands(nodes: SceneNode[], gaps: LineGaps): SceneNode[];
|
|
55
|
+
export {};
|
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene for a Plot's `forecast`: a shaded backdrop over the forecast
|
|
3
|
+
stretch with a rule at its start and a label, and the dash array that
|
|
4
|
+
draws each line's forecast stretch dashed.
|
|
5
|
+
*/
|
|
1
6
|
import type { DataPoint } from "@d3plus/data";
|
|
2
7
|
import type { RectNode, SceneNode } from "@d3plus/render";
|
|
3
8
|
import type { PlotAxisFn, PlotDatum } from "../features/plotPaint.js";
|
|
@@ -4,7 +4,7 @@ import { type ZoomState } from "./plotZoom.js";
|
|
|
4
4
|
import { type ConfidenceBand } from "./confidenceBands.js";
|
|
5
5
|
import { type TrendLineType } from "./trendLines.js";
|
|
6
6
|
import Viz from "../viz/Viz.js";
|
|
7
|
-
import type { InteractionPoint, PickResult, Scene, SceneEvent } from "@d3plus/render";
|
|
7
|
+
import type { InteractionPoint, PickResult, Scene, SceneEvent, SceneNode } from "@d3plus/render";
|
|
8
8
|
import type { DataPoint } from "@d3plus/data";
|
|
9
9
|
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
10
|
/** Accessor function or string key for a plotted value. */
|
|
@@ -15,6 +15,7 @@ type PlotAccessorArg = string | PlotAccessor;
|
|
|
15
15
|
Creates an x/y plot based on an array of data.
|
|
16
16
|
*/
|
|
17
17
|
export default class Plot extends Viz {
|
|
18
|
+
static readonly _displayName: string;
|
|
18
19
|
_trendLine: TrendLineType;
|
|
19
20
|
_trendLineConfig: Record<string, unknown>;
|
|
20
21
|
/**
|
|
@@ -77,6 +78,12 @@ export default class Plot extends Viz {
|
|
|
77
78
|
i: number;
|
|
78
79
|
x: unknown;
|
|
79
80
|
};
|
|
81
|
+
/**
|
|
82
|
+
A Plot's point marks are its Circle and Rect shapes (scatter and
|
|
83
|
+
bubble points, Beeswarm circles), for `hoverDistance`.
|
|
84
|
+
@private
|
|
85
|
+
*/
|
|
86
|
+
_pointMark(node: SceneNode): boolean;
|
|
80
87
|
/**
|
|
81
88
|
Picks the interaction point closest to a surface-local cursor position
|
|
82
89
|
along the discrete axis. `event.point` is post-zoom surface space while the
|
|
@@ -134,7 +141,9 @@ export default class Plot extends Viz {
|
|
|
134
141
|
/**
|
|
135
142
|
Allows drawing custom shapes to be used as annotations in the provided x/y plot. This method accepts custom config objects for the [Shape](http://d3plus.org/docs/#Shape) class, either a single config object or an array of config objects. Each config object requires an additional parameter, the "shape", which denotes which [Shape](http://d3plus.org/docs/#Shape) sub-class to use ([Rect](http://d3plus.org/docs/#Rect), [Line](http://d3plus.org/docs/#Line), etc).
|
|
136
143
|
|
|
137
|
-
Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present.
|
|
144
|
+
Additionally, each config object can also contain an optional "layer" key, which defines whether the annotations will be displayed in "front" or in "back" of the primary visualization shapes. This value defaults to "back" if not present ("front" for callouts).
|
|
145
|
+
|
|
146
|
+
Three more kinds draw chart notes: `"Callout"` anchors wrapped text in a box at each data row's `x`/`y` (in data units, or plot-area fractions with `xRef`/`yRef: "plot"`), offset by `dx`/`dy` pixels and joined to its anchor by a connector ending in an arrowhead or dot (see `CalloutAnnotation`); `"ReferenceLine"` and `"ReferenceBand"` draw what `referenceLines` and `referenceBands` entries expand into. All annotations follow zoom and never respond to the pointer or keyboard.
|
|
138
147
|
*/
|
|
139
148
|
annotations(_?: unknown): this | unknown[];
|
|
140
149
|
/**
|
|
@@ -190,10 +199,6 @@ export default class Plot extends Viz {
|
|
|
190
199
|
The d3plus-shape config used on the Line shapes created to connect lineLabels to the end of their associated Line path.
|
|
191
200
|
*/
|
|
192
201
|
labelConnectorConfig(_?: Record<string, unknown>): this | Record<string, unknown>;
|
|
193
|
-
/**
|
|
194
|
-
The behavior to be used when calculating the position and size of each shape's label(s). The value passed can either be the _String_ name of the behavior to be used for all shapes, or an accessor _Function_ that will be provided each data point and will be expected to return the behavior to be used for that data point. The availability and options for this method depend on the default logic for each Shape. As an example, the values "outside" or "inside" can be set for Bar shapes, whose "auto" default will calculate the best position dynamically based on the available space.
|
|
195
|
-
*/
|
|
196
|
-
labelPosition(_?: string | ((d: DataPoint, i: number) => string)): this | ((d: DataPoint, i: number) => string);
|
|
197
202
|
/**
|
|
198
203
|
Paint for the shared tooltip's crosshair guide line (`stroke`,
|
|
199
204
|
`strokeWidth`, `strokeDasharray`, `strokeOpacity`, …). Merged into the
|
|
@@ -250,8 +255,10 @@ export default class Plot extends Viz {
|
|
|
250
255
|
- a value accessor, or a `{value, order}` config, to rank series by an
|
|
251
256
|
aggregate of any data field.
|
|
252
257
|
|
|
253
|
-
Unknown named strings warn and fall back to `"descending"`.
|
|
254
|
-
|
|
258
|
+
Unknown named strings warn and fall back to `"descending"`. The
|
|
259
|
+
default legend lists the series in the order they stack, from the
|
|
260
|
+
baseline outward. If *value* is not specified, returns the current
|
|
261
|
+
stack order.
|
|
255
262
|
*/
|
|
256
263
|
stackOrder(_?: StackOrderInput): this | StackOrderFn | string[];
|
|
257
264
|
/**
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The Line shape's label config for a Plot's `lineLabels`: the text and
|
|
3
|
+
bounds of each line's labels past its right end, its left end, or both,
|
|
4
|
+
after their collisions have been bumped apart (see
|
|
5
|
+
`features/lineLabels.ts`).
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/
|
|
9
|
+
import type { LabelWidth, PlotDatum } from "../features/plotPaint.js";
|
|
10
|
+
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
11
|
+
import { type LineLabelSide } from "./lineLabelSides.js";
|
|
12
|
+
/** What a Line label config reads from the Plot paint. */
|
|
13
|
+
export interface LineLabelEmitInputs {
|
|
14
|
+
viz: Viz;
|
|
15
|
+
labelWidths: LabelWidth[];
|
|
16
|
+
/** The widest right-end label (padding included). */
|
|
17
|
+
largestLabel: number;
|
|
18
|
+
labelPositions: Record<string, number>;
|
|
19
|
+
/** The series name a label shows, in place of the chart's own label. */
|
|
20
|
+
name?: unknown;
|
|
21
|
+
}
|
|
22
|
+
/** A label's bounds relative to its line's first point. */
|
|
23
|
+
interface LabelBox {
|
|
24
|
+
x: number;
|
|
25
|
+
y: number;
|
|
26
|
+
width: number;
|
|
27
|
+
height: number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
The bounds of a line's label past its `side` end: right of its rightmost
|
|
31
|
+
point (`largest` wide, text starting there) or left of its leftmost point
|
|
32
|
+
(text ending there), as tall as a quarter of the chart and centered on
|
|
33
|
+
the label's bumped y.
|
|
34
|
+
*/
|
|
35
|
+
export declare function lineLabelBox(points: number[][], side: LineLabelSide, largest: number, chartHeight: number, bumpedY?: number): LabelBox;
|
|
36
|
+
/**
|
|
37
|
+
The Line shape's `label` and `labelBounds` for its line labels, and the
|
|
38
|
+
`textAnchor` that right-aligns the labels left of a line. A line with
|
|
39
|
+
one label keeps a single label; one labeled at both ends takes two.
|
|
40
|
+
*/
|
|
41
|
+
export declare function lineLabelConfig(inputs: LineLabelEmitInputs): {
|
|
42
|
+
label: (d: PlotDatum, i: number) => string | string[] | false;
|
|
43
|
+
labelBounds: (d: PlotDatum, i: number, s: {
|
|
44
|
+
points: number[][];
|
|
45
|
+
}) => LabelBox | LabelBox[];
|
|
46
|
+
textAnchor: (base: unknown) => (d: Record<string, unknown>, i: number) => unknown;
|
|
47
|
+
};
|
|
48
|
+
export {};
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure helpers behind a Plot's `lineLabels` and `lineLabelConfig`: which
|
|
3
|
+
ends of a line take a label, and the value text a label can carry.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
/** An end of a line that can carry a label. */
|
|
9
|
+
export type LineLabelSide = "start" | "end";
|
|
10
|
+
/** What `lineLabels` takes for one series. */
|
|
11
|
+
export type LineLabelsValue = boolean | "start" | "end" | "both" | "along";
|
|
12
|
+
/** The `lineLabels` setting: one value for every series, or a function of each row. */
|
|
13
|
+
export type LineLabelsSetting = LineLabelsValue | ((d: DataPoint, i: number) => LineLabelsValue | null | undefined);
|
|
14
|
+
/** Formats a line label's value: the value, the row it belongs to, and the row's index. */
|
|
15
|
+
export type LineLabelValueFormat = (value: unknown, d: DataPoint, i: number) => string;
|
|
16
|
+
/** The `lineLabelConfig` setting. */
|
|
17
|
+
export interface LineLabelConfig {
|
|
18
|
+
/** Adds each end's value after the series name. */
|
|
19
|
+
value?: boolean;
|
|
20
|
+
/** Formats the value (defaults to the y axis's tick format). */
|
|
21
|
+
valueFormat?: LineLabelValueFormat;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
The ends a `lineLabels` value labels, left end first: `true` and `"end"`
|
|
25
|
+
label the right end, `"start"` the left end, `"both"` both, and
|
|
26
|
+
`"along"` (a label along the line) or anything falsy neither.
|
|
27
|
+
*/
|
|
28
|
+
export declare function lineLabelSides(value: LineLabelsValue | null | undefined): LineLabelSide[];
|
|
29
|
+
/**
|
|
30
|
+
The ends `setting` labels for row `d` (index `i`): a function setting is
|
|
31
|
+
called with the row, any other setting applies to every row.
|
|
32
|
+
*/
|
|
33
|
+
export declare function rowLineLabelSides(setting: LineLabelsSetting | null | undefined, d: DataPoint, i: number): LineLabelSide[];
|
|
34
|
+
/**
|
|
35
|
+
Whether `setting` runs row `d`'s series name along its line (`"along"`)
|
|
36
|
+
instead of at an end.
|
|
37
|
+
*/
|
|
38
|
+
export declare function rowLabelsAlong(setting: LineLabelsSetting | null | undefined, d: DataPoint, i: number): boolean;
|
|
39
|
+
/**
|
|
40
|
+
A line label's value text, or `undefined` when `config` leaves values
|
|
41
|
+
off: `valueFormat` when set, else `format` (the y axis's own).
|
|
42
|
+
*/
|
|
43
|
+
export declare function lineLabelValue(config: LineLabelConfig | undefined, value: unknown, d: DataPoint, i: number, format: (value: unknown) => string): string | undefined;
|
|
44
|
+
/** A line label's text: the series name, followed by its value when there is one. */
|
|
45
|
+
export declare function lineLabelText(name: unknown, value?: string): string;
|
|
46
|
+
/**
|
|
47
|
+
The key a label's bumped position is stored under: the series id for the
|
|
48
|
+
right end, prefixed for the left end so the two ends never share one.
|
|
49
|
+
*/
|
|
50
|
+
export declare function lineLabelKey(side: LineLabelSide | undefined, id: unknown): string;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Spreads a column of labels apart so none overlap, each as close to the
|
|
3
|
+
position it labels as the others allow.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
Positions for labels centered on `desired` (sorted top to bottom), each
|
|
9
|
+
`sizes[i]` tall, so that no two overlap and every label stays within
|
|
10
|
+
`bounds` (the range its center may take). Touching labels move as a
|
|
11
|
+
group, centered on where they want to be, so each moves as little as the
|
|
12
|
+
others allow. Labels that need more room than `bounds` holds are packed
|
|
13
|
+
from its top and run past its bottom.
|
|
14
|
+
*/
|
|
15
|
+
export declare function spreadLabelPositions(desired: number[], sizes: number[], bounds: number[]): number[];
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { Edges, Pt } from "../features/pathLabelGeometry.js";
|
|
3
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
4
|
+
/**
|
|
5
|
+
Obstacle points, bucketed by cell for nearest-distance lookups. Each
|
|
6
|
+
point may carry a tag, so a lookup can ignore the points of the line a
|
|
7
|
+
label sits on.
|
|
8
|
+
*/
|
|
9
|
+
export declare class PointGrid {
|
|
10
|
+
private cell;
|
|
11
|
+
private cells;
|
|
12
|
+
/** @param cell The cell size: lookups see obstacles this far away. */
|
|
13
|
+
constructor(cell: number);
|
|
14
|
+
/** A cell's key: its column and row, packed into one number. */
|
|
15
|
+
private static key;
|
|
16
|
+
/**
|
|
17
|
+
Adds obstacle points.
|
|
18
|
+
@param points The points.
|
|
19
|
+
@param tag A tag `nearest` can ignore them by.
|
|
20
|
+
*/
|
|
21
|
+
add(points: Pt[], tag?: number): void;
|
|
22
|
+
/**
|
|
23
|
+
The distance from `p` to its nearest obstacle within one cell, or `Infinity`.
|
|
24
|
+
@param p The point.
|
|
25
|
+
@param ignore A tag whose points are left out.
|
|
26
|
+
*/
|
|
27
|
+
nearest(p: Pt, ignore?: number): number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
Points every `step` pixels along a polyline.
|
|
31
|
+
@param points The polyline.
|
|
32
|
+
@param step The spacing.
|
|
33
|
+
*/
|
|
34
|
+
export declare function resample(points: Pt[], step: number): Pt[];
|
|
35
|
+
/**
|
|
36
|
+
How much a stretch bends: the sum of its turns, in radians.
|
|
37
|
+
@param points The stretch.
|
|
38
|
+
*/
|
|
39
|
+
export declare function curvature(points: Pt[]): number;
|
|
40
|
+
/** What scoring a stretch needs. */
|
|
41
|
+
export interface StretchContext {
|
|
42
|
+
grid: PointGrid;
|
|
43
|
+
rect: Edges;
|
|
44
|
+
fontSize: number;
|
|
45
|
+
/** How far above the line the text's baseline sits (below it when negative). */
|
|
46
|
+
lift: number;
|
|
47
|
+
/** The least room a label needs from every obstacle. Defaults to `2`. */
|
|
48
|
+
minClearance?: number;
|
|
49
|
+
/** The room past which a stretch scores no better. Defaults to the font size. */
|
|
50
|
+
roomReach?: number;
|
|
51
|
+
/** How much room counts against bends and slope. Defaults to `0.5`. */
|
|
52
|
+
roomWeight?: number;
|
|
53
|
+
/** How steep a stretch reads bottom to top (see `uprightPoints`). */
|
|
54
|
+
steep?: number;
|
|
55
|
+
/** A grid tag to ignore: the points of the line the label sits on. */
|
|
56
|
+
ignore?: number;
|
|
57
|
+
/** The most a stretch may turn in all, in radians (default a right angle). */
|
|
58
|
+
maxTurn?: number;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
The points a label along `points` would cover: its baseline and two rows
|
|
62
|
+
above it, up to its letters' height.
|
|
63
|
+
@param points The upright stretch.
|
|
64
|
+
@param ctx The font size and lift.
|
|
65
|
+
*/
|
|
66
|
+
export declare function labelBand(points: Pt[], ctx: StretchContext): Pt[];
|
|
67
|
+
/**
|
|
68
|
+
A stretch's score, lower being better: how much it bends and slopes, less
|
|
69
|
+
a bonus for room around its label (up to `roomReach`, weighted by
|
|
70
|
+
`roomWeight`); null when its label would leave the
|
|
71
|
+
plot or come within `minClearance` of an obstacle (another line or
|
|
72
|
+
label, or the edges of the band it runs in).
|
|
73
|
+
@param points The upright stretch.
|
|
74
|
+
@param ctx The obstacles, plot area, and font.
|
|
75
|
+
*/
|
|
76
|
+
export declare function scoreStretch(points: Pt[], ctx: StretchContext): number | null;
|
|
77
|
+
/** A stretch `bestStretchAt` found: its points, its piece, and where along the piece it starts. */
|
|
78
|
+
export interface StretchSpot {
|
|
79
|
+
points: Pt[];
|
|
80
|
+
piece: number;
|
|
81
|
+
from: number;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
The best-scoring stretch of `length` pixels along any of a line's
|
|
85
|
+
pieces, upright, with where it lies, or null when every stretch is
|
|
86
|
+
blocked or too bent.
|
|
87
|
+
@param pieces The line's pieces (where its data has gaps), in pixels.
|
|
88
|
+
@param length The stretch's length.
|
|
89
|
+
@param ctx The obstacles, plot area, and font.
|
|
90
|
+
@param allow Which stretches may be taken, by their piece and start.
|
|
91
|
+
*/
|
|
92
|
+
export declare function bestStretchAt(pieces: Pt[][], length: number, ctx: StretchContext, allow?: (from: number, piece: number) => boolean): StretchSpot | null;
|
|
93
|
+
/**
|
|
94
|
+
The best-scoring stretch of `length` pixels along any of a line's
|
|
95
|
+
pieces, upright, or null when every stretch is blocked or too bent.
|
|
96
|
+
@param pieces The line's pieces (where its data has gaps), in pixels.
|
|
97
|
+
@param length The stretch's length.
|
|
98
|
+
@param ctx The obstacles, plot area, and font.
|
|
99
|
+
*/
|
|
100
|
+
export declare function bestStretch(pieces: Pt[][], length: number, ctx: StretchContext): Pt[] | null;
|
|
101
|
+
/**
|
|
102
|
+
The label font a shape's labelConfig sets, as plain values.
|
|
103
|
+
@param viz The chart.
|
|
104
|
+
@param shape The shape whose labelConfig to read.
|
|
105
|
+
*/
|
|
106
|
+
export declare function labelFont(viz: VizInstance, shape?: string): Record<string, unknown>;
|
|
107
|
+
/**
|
|
108
|
+
The labels for every series `lineLabels` runs along its line, placed one
|
|
109
|
+
by one so each stays clear of the lines and the labels before it. A
|
|
110
|
+
plot (or panel) with a single line labels none. Counts the lines and
|
|
111
|
+
labels into `viz._alongStats`, for the legend (see `alongLegend.ts`).
|
|
112
|
+
@param viz The chart.
|
|
113
|
+
@param marks The plot's drawn marks, its Lines among them.
|
|
114
|
+
@param rect The plot area.
|
|
115
|
+
*/
|
|
116
|
+
export declare function emitAlongLabels(viz: VizInstance, marks: SceneNode[], rect: Edges): SceneNode[];
|
|
@@ -9,9 +9,23 @@ export { preparePlotAxisLayout } from "./pipelineAxisLayout.js";
|
|
|
9
9
|
/**
|
|
10
10
|
The bubble radius scale: `sizeScale` over the extent of `sizes`, ranging
|
|
11
11
|
from `sizeMin` (capped at half of `sizeMax`) to `sizeMax`. A single-value
|
|
12
|
-
extent maps everything to `sizeMax`.
|
|
12
|
+
extent maps everything to `sizeMax`. With `sizeZero`, the smallest value's
|
|
13
|
+
radius is where a scale anchored at zero puts it instead (see
|
|
14
|
+
`zeroAnchoredRadius`).
|
|
13
15
|
*/
|
|
14
16
|
export declare function plotSizeScale(viz: Parameters<TransformStage>[0]["viz"], sizes: number[]): D3Scale;
|
|
17
|
+
/**
|
|
18
|
+
The radius a size scale anchored at zero (domain `[0, max]`, range
|
|
19
|
+
`[0, sizeMax]`) gives the smallest of `[min, max]`. A scale over
|
|
20
|
+
`[min, max]` starting at this radius draws every value where the anchored
|
|
21
|
+
one does: with a `"sqrt"` scale, each mark's area is proportional to its
|
|
22
|
+
value; with `"linear"`, its radius. NaN when the extent can't be anchored
|
|
23
|
+
at zero (a negative or non-positive extent, or a log scale).
|
|
24
|
+
@param make The size scale's constructor.
|
|
25
|
+
@param extent The size values' `[min, max]`.
|
|
26
|
+
@param sizeMax The largest radius.
|
|
27
|
+
*/
|
|
28
|
+
export declare function zeroAnchoredRadius(make: () => D3Scale, [lo, hi]: [number, number], sizeMax: number): number;
|
|
15
29
|
/**
|
|
16
30
|
Plot's size-legend scale, available before layout: the same scale
|
|
17
31
|
`formatPlotData` builds, over the plottable rows. Null when there's no
|
|
@@ -1,2 +1,70 @@
|
|
|
1
1
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
2
|
+
import { type LineLabelSide } from "./lineLabelSides.js";
|
|
3
|
+
/** A d3plus config value: a constant or a `(datum, index)` accessor. */
|
|
4
|
+
type ConfigAccessor<T> = T | ((d: Record<string, unknown>, i?: number) => T);
|
|
5
|
+
interface LineLabelCtx {
|
|
6
|
+
labelFunction: ConfigAccessor<string>;
|
|
7
|
+
fontColorAccessor: ConfigAccessor<string>;
|
|
8
|
+
fontSizeAccessor: ConfigAccessor<number>;
|
|
9
|
+
fontWeightAccessor: ConfigAccessor<number | string>;
|
|
10
|
+
fontFamilyAccessor: ConfigAccessor<string | string[]>;
|
|
11
|
+
paddingAccessor: ConfigAccessor<number>;
|
|
12
|
+
xEstimate: (d: unknown) => number;
|
|
13
|
+
yEstimate: (d: unknown) => number;
|
|
14
|
+
/** The value text for a label's point, or `undefined` without one. */
|
|
15
|
+
valueText: (value: unknown, d: Record<string, unknown>) => string | undefined;
|
|
16
|
+
/** The most room a label may take past its line's end, padding included. */
|
|
17
|
+
maxSpace?: number;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
Shortens a label to fit `maxWidth`: the name and value when both fit,
|
|
21
|
+
else the name alone, else the name cut short with an ellipsis, else
|
|
22
|
+
`null` (no room for even one letter).
|
|
23
|
+
*/
|
|
24
|
+
export declare function fitLineLabelText(name: string, value: string | undefined, maxWidth: number, measure: (text: string) => number): {
|
|
25
|
+
name: string;
|
|
26
|
+
value?: string;
|
|
27
|
+
} | null;
|
|
28
|
+
/**
|
|
29
|
+
The most room the labels at one end of a line chart may take: a quarter
|
|
30
|
+
of its `width` past its y axis (`yWidth`), so labels at both ends leave
|
|
31
|
+
the plot at least half of that, and labels never crowd the plot out of a
|
|
32
|
+
narrow chart or a small-multiples panel.
|
|
33
|
+
*/
|
|
34
|
+
export declare function lineLabelCap(width: number, yWidth?: number): number;
|
|
35
|
+
/**
|
|
36
|
+
Measures one end of a line's label (width, position, overlap coords): its
|
|
37
|
+
right end (`"end"`, the last point across) or its left end (`"start"`).
|
|
38
|
+
*/
|
|
39
|
+
export declare function measureLineLabel([lineKey, lineValues]: [unknown, Record<string, unknown>[]], ctx: LineLabelCtx, side?: LineLabelSide): {
|
|
40
|
+
id: unknown;
|
|
41
|
+
side: LineLabelSide;
|
|
42
|
+
name: string | undefined;
|
|
43
|
+
valueText: string | undefined;
|
|
44
|
+
labelWidth: number;
|
|
45
|
+
spaceNeeded: number;
|
|
46
|
+
value: unknown;
|
|
47
|
+
yEstimate: number;
|
|
48
|
+
padding: number;
|
|
49
|
+
fontSize: number;
|
|
50
|
+
fontColor: string;
|
|
51
|
+
edgeX: number;
|
|
52
|
+
xValue: unknown;
|
|
53
|
+
coords: number[][];
|
|
54
|
+
} | null;
|
|
55
|
+
/** A measured line label (see `measureLineLabel`). */
|
|
56
|
+
type LineLabel = NonNullable<ReturnType<typeof measureLineLabel>>;
|
|
57
|
+
/**
|
|
58
|
+
Whether another line passes through the space `label` would occupy past
|
|
59
|
+
its line's end: right of its last point, or left of its first point for a
|
|
60
|
+
`"start"` label.
|
|
61
|
+
*/
|
|
62
|
+
export declare function labelOverlapsLine(label: LineLabel, labels: LineLabel[]): boolean;
|
|
63
|
+
/**
|
|
64
|
+
The room the labels at one end of the plot claim: the widest label among
|
|
65
|
+
the lines that end at the x range's `edge`, at most `cap`; 0 when no line
|
|
66
|
+
reaches that edge.
|
|
67
|
+
*/
|
|
68
|
+
export declare function lineLabelSpace(labels: Pick<LineLabel, "edgeX" | "spaceNeeded">[], edge: number, cap: number): number;
|
|
2
69
|
export declare const measurePlotLineLabels: TransformStage;
|
|
70
|
+
export {};
|
|
@@ -14,6 +14,11 @@ import type { DomainValue, PlotFacetScales } from "./facetScales.js";
|
|
|
14
14
|
export declare function listAxis(viz: VizInstance, axis: string): boolean;
|
|
15
15
|
/** The `[min, max]` covering every extent (dates stay dates); undefined when none are numeric. */
|
|
16
16
|
export declare function unionExtent(extents: DomainValue[][]): DomainValue[] | undefined;
|
|
17
|
+
/**
|
|
18
|
+
Orders a stacked chart's legend by every panel's stacks, pooled (see
|
|
19
|
+
`stackLegendOrder.ts`), before the chrome lays the legend out.
|
|
20
|
+
*/
|
|
21
|
+
export declare function plotFacetChrome(viz: VizInstance, panels: DataPoint[][]): void;
|
|
17
22
|
/**
|
|
18
23
|
The domains (and size scale) that fit every panel's rows: a category axis
|
|
19
24
|
lists every panel's categories, in the order one chart of all the rows
|
|
@@ -29,6 +29,20 @@ export declare const plotSchema: ({
|
|
|
29
29
|
factory: typeof fillBetweenDefaults;
|
|
30
30
|
coerce?: undefined;
|
|
31
31
|
default?: undefined;
|
|
32
|
+
} | {
|
|
33
|
+
key: string;
|
|
34
|
+
merge: boolean;
|
|
35
|
+
factory: () => {
|
|
36
|
+
value: boolean;
|
|
37
|
+
};
|
|
38
|
+
coerce?: undefined;
|
|
39
|
+
default?: undefined;
|
|
40
|
+
} | {
|
|
41
|
+
key: string;
|
|
42
|
+
coerce: "identity";
|
|
43
|
+
factory: () => never[];
|
|
44
|
+
default?: undefined;
|
|
45
|
+
merge?: undefined;
|
|
32
46
|
} | {
|
|
33
47
|
key: string;
|
|
34
48
|
coerce: "identity";
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { type RangeBreakRule } from "../../components/Axis/rangeBreaks.js";
|
|
2
|
+
import type { D3Scale } from "../../utils/index.js";
|
|
3
|
+
import type { TransformStage } from "../pipeline/stages.js";
|
|
4
|
+
/** The viz a Plot pipeline stage reads. */
|
|
5
|
+
type PlotViz = Parameters<TransformStage>[0]["viz"];
|
|
6
|
+
/** The axes a Plot can draw time on. */
|
|
7
|
+
declare const AXES: readonly ["x", "x2", "y", "y2"];
|
|
8
|
+
/** One of a Plot's four axes. */
|
|
9
|
+
export type AxisName = (typeof AXES)[number];
|
|
10
|
+
/** An axis's `rangeBreaks` rules, from its axis config, when it plots time. */
|
|
11
|
+
export declare function plotRangeBreaks(viz: PlotViz, axis: AxisName): RangeBreakRule[];
|
|
12
|
+
/**
|
|
13
|
+
Whether an axis's `rangeBreaks` make it a time axis without `time`: the
|
|
14
|
+
axis config has rules, and `value` (the first row's) reads as a date — a
|
|
15
|
+
Date, a timestamp, or a date string.
|
|
16
|
+
*/
|
|
17
|
+
export declare function rangeBreaksTimeAxis(viz: PlotViz, axis: AxisName, value: unknown): boolean;
|
|
18
|
+
/**
|
|
19
|
+
The `rangeBreaks` a chart's timeline takes by default: those of the axis
|
|
20
|
+
that plots the chart's `time` values (the first row's time equals that
|
|
21
|
+
axis's value), else none.
|
|
22
|
+
*/
|
|
23
|
+
export declare function timelineRangeBreaks(viz: PlotViz): RangeBreakRule[];
|
|
24
|
+
/**
|
|
25
|
+
The rows to draw: those whose time every time axis shows. Rows inside
|
|
26
|
+
an axis's `rangeBreaks` are dropped, with a warning naming the axis.
|
|
27
|
+
*/
|
|
28
|
+
export declare function dropHiddenRows<T extends Record<string, unknown>>(viz: PlotViz, rows: T[]): T[];
|
|
29
|
+
/**
|
|
30
|
+
A Plot pipeline scale for `axis`: a broken time scale over the same
|
|
31
|
+
domain and range when the axis plots time with `rangeBreaks`, else the
|
|
32
|
+
scale as given.
|
|
33
|
+
*/
|
|
34
|
+
export declare function plotTimeScale(viz: PlotViz, axis: AxisName, scale: D3Scale): D3Scale;
|
|
35
|
+
export {};
|