@d3plus/core 4.9.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +170 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +17 -12
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Funnel/index.js +2 -1
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Gauge/index.js +2 -1
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +60 -19
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +37 -16
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/index.js +3 -2
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +93 -108
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +7 -2
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +66 -32
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +14 -4
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +5 -5
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +65 -30
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +75 -77
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +42 -15
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +123 -0
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +34 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +67 -79
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/facet/facetData.d.ts +1 -1
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +13 -1
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/features.d.ts +8 -0
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +19 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/missingFields.d.ts +57 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +2 -8
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -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
|
/**
|
|
@@ -27,6 +28,18 @@ export default class Plot extends Viz {
|
|
|
27
28
|
@private
|
|
28
29
|
*/
|
|
29
30
|
_preDraw(): void;
|
|
31
|
+
/**
|
|
32
|
+
The legend rows with a stacked chart's threshold bucket folded into
|
|
33
|
+
one entry (see `stackThreshold.ts`).
|
|
34
|
+
@private
|
|
35
|
+
*/
|
|
36
|
+
_thresholdLegend(legendData: DataPoint[]): DataPoint[];
|
|
37
|
+
/**
|
|
38
|
+
Folds a stacked chart's small series into one threshold bucket (see
|
|
39
|
+
`stackThreshold.ts`).
|
|
40
|
+
@private
|
|
41
|
+
*/
|
|
42
|
+
_thresholdFunction(data: DataPoint[], _tree?: unknown, all?: DataPoint[]): DataPoint[];
|
|
30
43
|
/**
|
|
31
44
|
Composes the chart's scene graph: the native shape scenes from Viz.toScene
|
|
32
45
|
(bars/lines/areas + labels) plus snapshots of the rendered axes, so a Plot
|
|
@@ -65,6 +78,12 @@ export default class Plot extends Viz {
|
|
|
65
78
|
i: number;
|
|
66
79
|
x: unknown;
|
|
67
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;
|
|
68
87
|
/**
|
|
69
88
|
Picks the interaction point closest to a surface-local cursor position
|
|
70
89
|
along the discrete axis. `event.point` is post-zoom surface space while the
|
|
@@ -79,6 +98,7 @@ export default class Plot extends Viz {
|
|
|
79
98
|
inside the plot area, snaps to the nearest discrete position and, when
|
|
80
99
|
two or more series share it, shows them all in one tooltip (suppressing
|
|
81
100
|
the single-shape tooltip). Clears on leaving the plot area or the chart.
|
|
101
|
+
Then tracks the hovered point's axis guides and badges (`axisHover`).
|
|
82
102
|
@private
|
|
83
103
|
*/
|
|
84
104
|
_sharedHover(event: SceneEvent): void;
|
|
@@ -121,7 +141,9 @@ export default class Plot extends Viz {
|
|
|
121
141
|
/**
|
|
122
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).
|
|
123
143
|
|
|
124
|
-
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.
|
|
125
147
|
*/
|
|
126
148
|
annotations(_?: unknown): this | unknown[];
|
|
127
149
|
/**
|
|
@@ -177,10 +199,6 @@ export default class Plot extends Viz {
|
|
|
177
199
|
The d3plus-shape config used on the Line shapes created to connect lineLabels to the end of their associated Line path.
|
|
178
200
|
*/
|
|
179
201
|
labelConnectorConfig(_?: Record<string, unknown>): this | Record<string, unknown>;
|
|
180
|
-
/**
|
|
181
|
-
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.
|
|
182
|
-
*/
|
|
183
|
-
labelPosition(_?: string | ((d: DataPoint, i: number) => string)): this | ((d: DataPoint, i: number) => string);
|
|
184
202
|
/**
|
|
185
203
|
Paint for the shared tooltip's crosshair guide line (`stroke`,
|
|
186
204
|
`strokeWidth`, `strokeDasharray`, `strokeOpacity`, …). Merged into the
|
|
@@ -237,8 +255,10 @@ export default class Plot extends Viz {
|
|
|
237
255
|
- a value accessor, or a `{value, order}` config, to rank series by an
|
|
238
256
|
aggregate of any data field.
|
|
239
257
|
|
|
240
|
-
Unknown named strings warn and fall back to `"descending"`.
|
|
241
|
-
|
|
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.
|
|
242
262
|
*/
|
|
243
263
|
stackOrder(_?: StackOrderInput): this | StackOrderFn | string[];
|
|
244
264
|
/**
|
|
@@ -9,6 +9,11 @@ import type { VizInstance } from "../viz/vizTypes.js";
|
|
|
9
9
|
Default shape size, routed through the chart's internal sizeScale.
|
|
10
10
|
*/
|
|
11
11
|
export declare function defaultSize(this: VizInstance, d: DataPoint): number;
|
|
12
|
+
/**
|
|
13
|
+
Whether a bar grows back along its value axis: a negative value, or a
|
|
14
|
+
positive one on a `reverse` axis (down a y axis, left along an x axis).
|
|
15
|
+
*/
|
|
16
|
+
export declare function growsBack(viz: VizInstance, valueAxis: string, d: DataPoint, i: number): boolean;
|
|
12
17
|
/**
|
|
13
18
|
Determines if a Bar label should be placed outside of the Bar.
|
|
14
19
|
*/
|
|
@@ -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
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type Plot from "./index.js";
|
|
2
|
+
import { axisHoverDefaults } from "./axisHoverScene.js";
|
|
2
3
|
import { fillBetweenDefaults } from "./fillBetween.js";
|
|
3
4
|
/**
|
|
4
5
|
Plot's identity-coerce accessor schema. `installFluent` installs it on
|
|
@@ -7,13 +8,19 @@ import { fillBetweenDefaults } from "./fillBetween.js";
|
|
|
7
8
|
export declare const plotSchema: ({
|
|
8
9
|
key: string;
|
|
9
10
|
coerce: "identity";
|
|
10
|
-
default
|
|
11
|
+
default: boolean;
|
|
11
12
|
merge?: undefined;
|
|
12
13
|
factory?: undefined;
|
|
14
|
+
} | {
|
|
15
|
+
key: string;
|
|
16
|
+
merge: boolean;
|
|
17
|
+
factory: typeof axisHoverDefaults;
|
|
18
|
+
coerce?: undefined;
|
|
19
|
+
default?: undefined;
|
|
13
20
|
} | {
|
|
14
21
|
key: string;
|
|
15
22
|
coerce: "identity";
|
|
16
|
-
default
|
|
23
|
+
default?: undefined;
|
|
17
24
|
merge?: undefined;
|
|
18
25
|
factory?: undefined;
|
|
19
26
|
} | {
|
|
@@ -22,6 +29,20 @@ export declare const plotSchema: ({
|
|
|
22
29
|
factory: typeof fillBetweenDefaults;
|
|
23
30
|
coerce?: undefined;
|
|
24
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;
|
|
25
46
|
} | {
|
|
26
47
|
key: string;
|
|
27
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 {};
|
|
@@ -44,6 +44,8 @@ export interface PlotZoomBase {
|
|
|
44
44
|
labelSpace: Partial<Record<AxisName, number>>;
|
|
45
45
|
/** Axes drawn with a baseline break; a zoom keeps the break only on these. */
|
|
46
46
|
breaks: Partial<Record<AxisName, boolean>>;
|
|
47
|
+
/** Axes drawn `reverse`d, whose scales run the other way to their domains. */
|
|
48
|
+
reversed: Partial<Record<AxisName, boolean>>;
|
|
47
49
|
}
|
|
48
50
|
/**
|
|
49
51
|
Paints a Plot at its natural (unzoomed) scale and records what a zoom
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { Annotation } from "../features/annotationTypes.js";
|
|
2
|
+
import type { TransformStage } from "../pipeline/stages.js";
|
|
3
|
+
import type { DomainValue } from "./pipelineScales.js";
|
|
4
|
+
/** The viz a Plot pipeline stage reads. */
|
|
5
|
+
type PlotViz = Parameters<TransformStage>[0]["viz"];
|
|
6
|
+
/** The four Plot axes. */
|
|
7
|
+
type AxisKey = "x" | "y" | "x2" | "y2";
|
|
8
|
+
/**
|
|
9
|
+
The data-unit values reference lines and bands place on each axis, from
|
|
10
|
+
a list of annotations (`"plot"`-fraction entries and other kinds left
|
|
11
|
+
out).
|
|
12
|
+
@param annotations The chart's annotations, with `referenceLines` and `referenceBands` expanded.
|
|
13
|
+
*/
|
|
14
|
+
export declare function referenceDomainValues(annotations: Annotation[]): Record<AxisKey, unknown[]>;
|
|
15
|
+
/**
|
|
16
|
+
A continuous or time domain stretched to take in `values`, keeping its
|
|
17
|
+
orientation. Only the ends marked `open` move (an end the user set stays
|
|
18
|
+
put), and a log axis ignores values at or below zero. Returns the domain
|
|
19
|
+
itself when nothing changes.
|
|
20
|
+
@param domain The axis's `[start, end]` domain.
|
|
21
|
+
@param values The values to take in.
|
|
22
|
+
@param options Whether the axis is a time or log axis, and which ends may move.
|
|
23
|
+
*/
|
|
24
|
+
export declare function widenToValues(domain: DomainValue[], values: unknown[], options?: {
|
|
25
|
+
time?: boolean;
|
|
26
|
+
log?: boolean;
|
|
27
|
+
open?: [boolean, boolean];
|
|
28
|
+
}): DomainValue[];
|
|
29
|
+
/**
|
|
30
|
+
Which ends of an axis's domain may widen: those the user's domain leaves
|
|
31
|
+
unset (both, without one; the end, for a one-value `[start]`).
|
|
32
|
+
@param user The user's domain for the axis, if any.
|
|
33
|
+
*/
|
|
34
|
+
export declare function openDomainEnds(user: unknown): [boolean, boolean];
|
|
35
|
+
/**
|
|
36
|
+
Widens a Plot's auto domains to take in its reference lines and bands
|
|
37
|
+
(from `referenceLines`, `referenceBands`, and `"ReferenceLine"`/
|
|
38
|
+
`"ReferenceBand"` annotations), on continuous and time axes only. An
|
|
39
|
+
end set by the user's domain (`xDomain`, `xConfig.domain`, …) stays put.
|
|
40
|
+
@param viz The chart.
|
|
41
|
+
@param autoDomains Each axis's domain before the baseline is applied.
|
|
42
|
+
@param scales Each axis's scale type (`"Linear"`, `"Time"`, `"Point"`, …) and configured scale (`"log"`, …).
|
|
43
|
+
@param user The user's x and y domains, as `computePlotScales` reads them.
|
|
44
|
+
*/
|
|
45
|
+
export declare function widenReferenceDomains(viz: PlotViz, autoDomains: Record<AxisKey, DomainValue[] | undefined>, scales: Record<AxisKey, {
|
|
46
|
+
type: string;
|
|
47
|
+
config: string;
|
|
48
|
+
}>, user: Record<string, DomainValue[] | undefined>): Record<AxisKey, DomainValue[] | undefined>;
|
|
49
|
+
export {};
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import type { Scene } from "@d3plus/render";
|
|
2
2
|
import type { VizInstance } from "../viz/vizTypes.js";
|
|
3
3
|
/**
|
|
4
|
-
Adds the
|
|
5
|
-
|
|
6
|
-
|
|
4
|
+
Adds the hover's scene nodes (see `decorateBody`) to the chart body group
|
|
5
|
+
(content space, so they track zoom) — to each panel's body when the chart
|
|
6
|
+
is drawn as small multiples.
|
|
7
7
|
*/
|
|
8
8
|
export declare function appendSharedHoverNodes(viz: VizInstance, scene: Scene): void;
|
|
@@ -12,7 +12,7 @@ export declare function axisName(viz: VizInstance, k: Axis): string;
|
|
|
12
12
|
axis of years, matching its tick labels), and anything else (e.g. a numeric
|
|
13
13
|
year on the discrete axis) as-is.
|
|
14
14
|
*/
|
|
15
|
-
export declare function axisValue(viz: VizInstance, k: Axis, value: unknown): string;
|
|
15
|
+
export declare function axisValue(viz: VizInstance, k: Axis | "x2" | "y2", value: unknown): string;
|
|
16
16
|
/**
|
|
17
17
|
Holds the tooltip's own arrow/thead/tbody to restore once the snapped
|
|
18
18
|
hover ends (see `restoreTooltip`), so the next legend or default tooltip
|
|
@@ -23,19 +23,26 @@ export declare function axisValue(viz: VizInstance, k: Axis, value: unknown): st
|
|
|
23
23
|
export declare function prepareTooltip(viz: VizInstance): any;
|
|
24
24
|
/** Puts back what `prepareTooltip` held. */
|
|
25
25
|
export declare function restoreTooltip(viz: VizInstance): void;
|
|
26
|
+
/**
|
|
27
|
+
How many of a threshold bucket's series the shared tooltip lists under
|
|
28
|
+
its row: fewer than a single-mark tooltip, since every other series has
|
|
29
|
+
a row of its own beside them.
|
|
30
|
+
*/
|
|
31
|
+
export declare const SHARED_MEMBER_LIMIT = 5;
|
|
26
32
|
/**
|
|
27
33
|
The shared tooltip: title from the continuous axis, a header row naming
|
|
28
34
|
the hovered discrete value, then one `[name, value]` row per series, the
|
|
29
35
|
name led by a swatch in its series stroke and the value followed by its
|
|
30
|
-
`confidence` range
|
|
31
|
-
title/rows win.
|
|
36
|
+
`confidence` range, and a threshold bucket's series listed under its row.
|
|
37
|
+
User `tooltipConfig` styles apply first; the shared title/rows win.
|
|
32
38
|
*/
|
|
33
39
|
export declare function renderSharedTooltip(viz: VizInstance, hover: SharedHover, event: SceneEvent): void;
|
|
34
40
|
/**
|
|
35
41
|
The single-mark tooltip (one series, `tooltipShared(false)`, or a
|
|
36
42
|
side-by-side bar): the default title (the mark's label, unless
|
|
37
43
|
`tooltipConfig` sets one), its x and y values, its `confidence` bounds,
|
|
38
|
-
then any rows the chart's `tooltipConfig` adds
|
|
44
|
+
then any rows the chart's `tooltipConfig` adds, and a threshold bucket's
|
|
45
|
+
series.
|
|
39
46
|
*/
|
|
40
47
|
export declare function renderSingleTooltip(viz: VizInstance, hover: SharedHover, event: SceneEvent): void;
|
|
41
48
|
export {};
|