@d3plus/core 4.10.0 → 4.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +178 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +176 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +101 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +192 -0
- package/es/src/charts/ArcDiagram/events.js +148 -0
- package/es/src/charts/ArcDiagram/index.js +217 -0
- package/es/src/charts/BarChart/index.js +12 -7
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +6 -11
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +160 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +137 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +206 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +6 -4
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/applyLayout.js +20 -9
- package/es/src/charts/Matrix/index.js +19 -1
- package/es/src/charts/Network/applyLayout.js +171 -96
- package/es/src/charts/Network/bundle.js +82 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +257 -75
- package/es/src/charts/Network/graph.js +146 -0
- package/es/src/charts/Network/graphFluent.js +81 -0
- package/es/src/charts/Network/index.js +91 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +15 -8
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +8 -1
- package/es/src/charts/Pack/neutralPaint.js +20 -0
- package/es/src/charts/Pack/nodeNames.js +35 -0
- package/es/src/charts/ParallelCoordinates/axes.js +22 -22
- package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +51 -96
- package/es/src/charts/Pie/index.js +74 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaEnter.js +68 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +34 -14
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +19 -17
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +40 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +2 -1
- package/es/src/charts/Plot/sharedTooltip.js +13 -3
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +4 -3
- package/es/src/charts/Priestley/applyLayout.js +21 -23
- package/es/src/charts/Priestley/index.js +4 -37
- package/es/src/charts/Priestley/timeAxis.js +103 -0
- package/es/src/charts/Pyramid/gutter.js +52 -16
- package/es/src/charts/Pyramid/index.js +55 -7
- package/es/src/charts/Pyramid/scene.js +4 -4
- package/es/src/charts/Radar/applyLayout.js +31 -33
- package/es/src/charts/Radar/axisDecorations.js +62 -13
- package/es/src/charts/Radar/curvedLabels.js +228 -0
- package/es/src/charts/Radar/emit.js +30 -15
- package/es/src/charts/Radar/index.js +43 -5
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +9 -1
- package/es/src/charts/RadialBar/index.js +26 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/index.js +18 -9
- package/es/src/charts/Rings/applyLayout.js +39 -161
- package/es/src/charts/Rings/emit.js +219 -63
- package/es/src/charts/Rings/index.js +88 -32
- package/es/src/charts/Rings/ringsCurves.js +156 -0
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +183 -0
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +61 -38
- package/es/src/charts/Sankey/applyLayout.js +130 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +78 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +83 -64
- package/es/src/charts/Sunburst/index.js +16 -4
- package/es/src/charts/Tree/applyLayout.js +44 -14
- package/es/src/charts/Tree/emit.js +5 -5
- package/es/src/charts/Tree/index.js +12 -18
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +14 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +10 -25
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +52 -23
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
- package/es/src/charts/drawSteps/zoomDrag.js +188 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +11 -4
- package/es/src/charts/events/click.shape.js +13 -4
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +9 -2
- package/es/src/charts/events/mousemove.legend.js +28 -32
- package/es/src/charts/events/mousemove.shape.js +45 -42
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +17 -5
- package/es/src/charts/features/axesFinal.js +10 -3
- package/es/src/charts/features/axesMeasure.js +33 -12
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/centerLabel.js +177 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +20 -1
- package/es/src/charts/features/colorScaleHover.js +33 -7
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +77 -0
- package/es/src/charts/features/colorScaleTop.js +61 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +191 -0
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +220 -5
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +75 -20
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/hoverTicks.js +41 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +364 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeStats.js +309 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +46 -12
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +54 -32
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +30 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +14 -5
- package/es/src/charts/partition/interaction.js +19 -10
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +22 -9
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/chrome.js +81 -9
- package/es/src/charts/polar/config.js +6 -3
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +61 -49
- package/es/src/charts/viz/VizBase.js +57 -14
- package/es/src/charts/viz/backgroundInk.js +23 -7
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +115 -32
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +29 -0
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +34 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -4
- package/es/src/charts/viz/vizDefaults.js +28 -57
- package/es/src/charts/viz/vizFields.js +41 -1
- package/es/src/charts/viz/vizRender.js +76 -31
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +26 -2
- package/es/src/components/Axis/Axis.js +35 -2
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +33 -8
- package/es/src/components/Axis/axisDefaults.js +16 -9
- package/es/src/components/Axis/axisLabelKinds.js +36 -0
- package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
- package/es/src/components/Axis/axisLabelRoom.js +37 -0
- package/es/src/components/Axis/axisLabelSize.js +171 -0
- package/es/src/components/Axis/axisLabelThinning.js +98 -4
- package/es/src/components/Axis/axisLayout.js +71 -46
- package/es/src/components/Axis/axisLayoutLabels.js +82 -140
- package/es/src/components/Axis/axisLayoutScale.js +16 -11
- package/es/src/components/Axis/axisLimit.js +27 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +20 -8
- package/es/src/components/Axis/axisRounding.js +16 -1
- package/es/src/components/Axis/axisScene.js +11 -2
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +128 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +77 -27
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +13 -2
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/Legend/legendCut.js +108 -0
- package/es/src/components/Legend/legendRender.js +38 -13
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +34 -67
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +9 -4
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +226 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +8 -5
- package/es/src/fluent.js +48 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +30 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configValue.js +9 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +268 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +46 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
- package/types/src/charts/ArcDiagram/events.d.ts +29 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
- package/types/src/charts/Network/applyLayout.d.ts +11 -0
- package/types/src/charts/Network/bundle.d.ts +69 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +73 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pack/applyLayout.d.ts +2 -0
- package/types/src/charts/Pack/groupRows.d.ts +46 -0
- package/types/src/charts/Pack/index.d.ts +3 -0
- package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
- package/types/src/charts/Pack/nodeNames.d.ts +23 -0
- package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
- package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
- package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaEnter.d.ts +34 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +16 -15
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
- package/types/src/charts/Pyramid/gutter.d.ts +28 -6
- package/types/src/charts/Pyramid/scene.d.ts +1 -1
- package/types/src/charts/Radar/applyLayout.d.ts +2 -3
- package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
- package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
- package/types/src/charts/Radar/emit.d.ts +5 -2
- package/types/src/charts/Radar/index.d.ts +7 -2
- package/types/src/charts/Radar/points.d.ts +50 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/Rings/emit.d.ts +72 -0
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
- package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/axisTooltip.d.ts +49 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/centerLabel.d.ts +75 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
- package/types/src/charts/features/colorScaleHover.d.ts +13 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +119 -0
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +103 -4
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/hoverTicks.d.ts +30 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +192 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotEndLabels.d.ts +14 -1
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +15 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +25 -4
- package/types/src/charts/viz/VizBase.d.ts +37 -8
- package/types/src/charts/viz/backgroundInk.d.ts +19 -4
- package/types/src/charts/viz/emphasis.d.ts +17 -0
- package/types/src/charts/viz/fillStroke.d.ts +7 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +26 -0
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +35 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +37 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +100 -7
- package/types/src/charts/viz/vizVisibility.d.ts +13 -0
- package/types/src/components/Axis/Axis.d.ts +34 -3
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +21 -3
- package/types/src/components/Axis/axisDefaults.d.ts +12 -0
- package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
- package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
- package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
- package/types/src/components/Axis/axisLayout.d.ts +9 -2
- package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
- package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
- package/types/src/components/Axis/axisLimit.d.ts +18 -0
- package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +8 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
- package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
- package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +6 -0
- package/types/src/components/Legend/legendCut.d.ts +31 -0
- package/types/src/components/Legend/legendRender.d.ts +6 -1
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +5 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/components/textEllipsis.d.ts +6 -0
- package/types/src/fluent.d.ts +18 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +1093 -266
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configValue.d.ts +8 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +72239 -41465
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +46249 -19519
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The pointer gestures a chart zooms by beyond d3-zoom's own pan and wheel:
|
|
3
|
+
a mouse drag that draws a box to zoom into (`zoomDrag: "brush"`), and
|
|
4
|
+
what a double-click does (`zoomDoubleClick`).
|
|
5
|
+
|
|
6
|
+
The drawn box needs no brush overlay over the chart: the press listens on
|
|
7
|
+
the zoom surface beside the chart's own pointer listeners, so a click
|
|
8
|
+
that doesn't drag still reaches the shape under it, and hover still
|
|
9
|
+
works until a drag begins. Once one does, it reuses the brush mode's
|
|
10
|
+
pieces: the zoom brush shows the box (with its styles), and releasing
|
|
11
|
+
zooms to it through `viz._zoomToBounds`.
|
|
12
|
+
|
|
13
|
+
@module
|
|
14
|
+
*/
|
|
15
|
+
import type Viz from "../viz/Viz.js";
|
|
16
|
+
/** A point in the zoom surface's coordinates. */
|
|
17
|
+
export type Point = [number, number];
|
|
18
|
+
/** A box's top-left and bottom-right corners. */
|
|
19
|
+
export type Box = [Point, Point];
|
|
20
|
+
/** How far (px) a press moves before it draws a box instead of clicking. */
|
|
21
|
+
export declare const BOX_DRAG_DISTANCE = 3;
|
|
22
|
+
/**
|
|
23
|
+
Clamps a point into a box.
|
|
24
|
+
@param point The point.
|
|
25
|
+
@param box The box.
|
|
26
|
+
*/
|
|
27
|
+
export declare function clampPoint([x, y]: Point, [[x0, y0], [x1, y1]]: Box): Point;
|
|
28
|
+
/**
|
|
29
|
+
The box two corners span, whichever way the drag went.
|
|
30
|
+
@param a One corner.
|
|
31
|
+
@param b The opposite corner.
|
|
32
|
+
*/
|
|
33
|
+
export declare function spanBox(a: Point, b: Point): Box;
|
|
34
|
+
/**
|
|
35
|
+
Whether a point lies in a box, edges included.
|
|
36
|
+
@param point The point.
|
|
37
|
+
@param box The box.
|
|
38
|
+
*/
|
|
39
|
+
export declare function inBox([x, y]: Point, [[x0, y0], [x1, y1]]: Box): boolean;
|
|
40
|
+
/**
|
|
41
|
+
Whether a press at `at` may draw a zoom box: the primary button with no
|
|
42
|
+
modifier key (Shift + drag pans), the first press of a click (not the
|
|
43
|
+
second of a double-click), inside the chart area, and not on a brush
|
|
44
|
+
(the timeline's).
|
|
45
|
+
@param event The mousedown.
|
|
46
|
+
@param at The press, in the zoom surface's coordinates.
|
|
47
|
+
@param area The chart area, in the same coordinates.
|
|
48
|
+
*/
|
|
49
|
+
export declare function startsBoxDrag(event: MouseEvent, at: Point, area: Box): boolean;
|
|
50
|
+
/**
|
|
51
|
+
Whether a move from `from` to `to` (client pixels) has gone far enough
|
|
52
|
+
to be a drag rather than a click.
|
|
53
|
+
@param from Where the press began.
|
|
54
|
+
@param to Where the pointer is now.
|
|
55
|
+
*/
|
|
56
|
+
export declare function dragsFar(from: Point, to: Point): boolean;
|
|
57
|
+
/**
|
|
58
|
+
Binds the gestures this module adds to the zoom surface, after d3-zoom's
|
|
59
|
+
own: the drawn zoom box for `zoomDrag: "brush"`, and the double-click
|
|
60
|
+
for `zoomDoubleClick`.
|
|
61
|
+
@param viz The chart.
|
|
62
|
+
@param tgt The element d3-zoom is bound to.
|
|
63
|
+
@param reset Returns the chart to its initial view.
|
|
64
|
+
*/
|
|
65
|
+
export declare function bindZoomGestures(viz: Viz, tgt: NonNullable<Viz["_zoomEventTarget"]>, reset: () => void): void;
|
|
66
|
+
/**
|
|
67
|
+
Removes the gestures `bindZoomGestures` added (d3-zoom's own listeners,
|
|
68
|
+
the double-click included, go with `.on(".zoom", null)`).
|
|
69
|
+
@param tgt The element they were bound to.
|
|
70
|
+
*/
|
|
71
|
+
export declare function unbindZoomGestures(tgt: NonNullable<Viz["_zoomEventTarget"]>): void;
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type Viz from "../viz/Viz.js";
|
|
2
|
+
/** Bounds in the zoom surface's unzoomed coordinates: top-left, bottom-right. */
|
|
3
|
+
export type Bounds = [[number, number], [number, number]];
|
|
4
|
+
/** A zoom transform: scale `k`, then translate by `x`, `y`. */
|
|
5
|
+
export interface FitTransform {
|
|
6
|
+
k: number;
|
|
7
|
+
x: number;
|
|
8
|
+
y: number;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
Which screen dimensions the zoom actually scales. Every chart zooms its
|
|
12
|
+
picture uniformly, except a Plot, which rescales only its linear and time
|
|
13
|
+
axes: a LinePlot or a bar chart with a discrete x axis zooms vertically
|
|
14
|
+
alone.
|
|
15
|
+
@param viz The chart.
|
|
16
|
+
*/
|
|
17
|
+
export declare function zoomedDims(viz: Viz): {
|
|
18
|
+
x: boolean;
|
|
19
|
+
y: boolean;
|
|
20
|
+
};
|
|
21
|
+
/**
|
|
22
|
+
The zoom transform that fits `bounds` (unzoomed surface coordinates) to
|
|
23
|
+
the chart's zoom area along each dimension the zoom scales (see
|
|
24
|
+
`zoomedDims`): the dimension with less room fills the area, and the other
|
|
25
|
+
is centered in it. A dimension the zoom doesn't scale (a Plot's discrete
|
|
26
|
+
axis) has no say in the scale.
|
|
27
|
+
@param viz The chart.
|
|
28
|
+
@param bounds The bounds to show.
|
|
29
|
+
*/
|
|
30
|
+
export declare function fitBounds(viz: Viz, bounds: Bounds): FitTransform;
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
|
|
4
4
|
@module
|
|
5
5
|
*/
|
|
6
|
+
import type { ZoomTransform } from "d3-zoom";
|
|
6
7
|
/** The groups inside the zoom surface that hold a d3-brush: the timeline's and the zoom brush. */
|
|
7
8
|
export declare const BRUSH_GROUPS = "g.d3plus-viz-timeline, g.d3plus-zoom-brush";
|
|
8
9
|
/**
|
|
@@ -15,3 +16,34 @@ export declare const BRUSH_GROUPS = "g.d3plus-viz-timeline, g.d3plus-zoom-brush"
|
|
|
15
16
|
@param event The pointer event d3-zoom is filtering.
|
|
16
17
|
*/
|
|
17
18
|
export declare function startsOnBrush(event: Pick<Event, "target">): boolean;
|
|
19
|
+
/** A d3-zoom gesture event, as `ZoomGesture` reads it. */
|
|
20
|
+
export interface ZoomGestureEvent {
|
|
21
|
+
/** The zoom transform the event carries. */
|
|
22
|
+
transform: ZoomTransform;
|
|
23
|
+
/** The pointer or wheel event behind it, or null for a programmatic zoom. */
|
|
24
|
+
sourceEvent: Event | null;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
A chart's own handling of the zoom behavior's gestures, consulted before
|
|
28
|
+
the zoom transform changes (Geomap turns a globe on a drag).
|
|
29
|
+
*/
|
|
30
|
+
export interface ZoomGesture {
|
|
31
|
+
/** A gesture begins. */
|
|
32
|
+
start(event: ZoomGestureEvent): void;
|
|
33
|
+
/** A gesture moves; true when the chart handled it, so the zoom transform is left alone. */
|
|
34
|
+
zoom(event: ZoomGestureEvent): boolean;
|
|
35
|
+
/** A gesture ends. */
|
|
36
|
+
end(event: ZoomGestureEvent): void;
|
|
37
|
+
/** The zoom controls' reset was pressed, just before the zoom resets. */
|
|
38
|
+
reset(): void;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
The hover hold of a zoom gesture in progress (see `gestureHover.ts`):
|
|
42
|
+
where its press began, and whether it has moved the chart yet.
|
|
43
|
+
*/
|
|
44
|
+
export interface GestureHoverState {
|
|
45
|
+
/** The press's client position, or null for a gesture without one (a wheel). */
|
|
46
|
+
press: [number, number] | null;
|
|
47
|
+
/** Whether the gesture has moved the chart, holding off hover until it ends. */
|
|
48
|
+
moving: boolean;
|
|
49
|
+
}
|
|
@@ -2,7 +2,8 @@ import type { DataPoint } from "@d3plus/data";
|
|
|
2
2
|
import type Viz from "../viz/Viz.js";
|
|
3
3
|
/**
|
|
4
4
|
@module clickLegend
|
|
5
|
-
On click event for all legend shapes in a Viz.
|
|
5
|
+
On click event for all legend shapes in a Viz. A click that changes what
|
|
6
|
+
is hidden or solo'd goes on the chart's Back history (see `legendHistory`).
|
|
6
7
|
@private
|
|
7
8
|
*/
|
|
8
9
|
export default function (this: Viz, d: DataPoint, i: number, x: DataPoint, event: MouseEvent): void;
|
|
@@ -91,8 +91,8 @@ export interface FacetPanelContext {
|
|
|
91
91
|
default panel aspect.
|
|
92
92
|
*/
|
|
93
93
|
export interface FacetHooks {
|
|
94
|
-
/** The panel width/height ratio the chart reads best at, used to pick the grid shape. */
|
|
95
|
-
aspect?: number;
|
|
94
|
+
/** The panel width/height ratio the chart reads best at, used to pick the grid shape, or a function of the chart returning it. */
|
|
95
|
+
aspect?: number | ((viz: VizInstance) => number);
|
|
96
96
|
/** The chart's default for `FacetConfig.scales` (`"shared"` when unset). */
|
|
97
97
|
scales?: "shared" | "independent";
|
|
98
98
|
/** The chart's default for `FacetConfig.axes` (`"outer"` when unset), or a function of the chart returning it. */
|
|
@@ -106,6 +106,8 @@ export interface FacetHooks {
|
|
|
106
106
|
x?: boolean;
|
|
107
107
|
y?: boolean;
|
|
108
108
|
};
|
|
109
|
+
/** Runs before the chrome lays out, with each panel's rows (one array per panel), for chrome that reads what the panels draw (such as a stacked chart's legend order). */
|
|
110
|
+
chrome?: (viz: VizInstance, panels: DataPoint[][]) => void;
|
|
109
111
|
/** Computes the scales every panel shares from each panel's rows (one array per panel). Runs before any panel draws, when scales are shared. */
|
|
110
112
|
share?: (viz: VizInstance, panels: DataPoint[][]) => unknown;
|
|
111
113
|
/** Applies a panel's overrides before it draws; returns a function undoing them. */
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
2
|
+
import type { AnnotationRef } from "./annotationTypes.js";
|
|
3
|
+
import type { PlotAxisFn } from "./plotPaint.js";
|
|
4
|
+
/** A Plot axis an annotation can position against. */
|
|
5
|
+
export type AnnotationAxis = "x" | "y" | "x2" | "y2";
|
|
6
|
+
/** The plot area, in the chart's content pixels. */
|
|
7
|
+
export interface PlotRect {
|
|
8
|
+
x0: number;
|
|
9
|
+
y0: number;
|
|
10
|
+
x1: number;
|
|
11
|
+
y1: number;
|
|
12
|
+
}
|
|
13
|
+
/** One axis's mapping from data values to pixels. */
|
|
14
|
+
export interface AxisFrame {
|
|
15
|
+
/** Maps a (parsed) value to its pixel position. */
|
|
16
|
+
scale: (value: unknown) => number;
|
|
17
|
+
/** Whether the axis plots dates, so values parse as dates. */
|
|
18
|
+
time?: boolean;
|
|
19
|
+
/** A category axis's categories, which values must match (or fall between, when numeric). */
|
|
20
|
+
categories?: unknown[];
|
|
21
|
+
/** Whether each category fills a slot along the axis (bars), which spans take in whole. */
|
|
22
|
+
slots?: boolean;
|
|
23
|
+
}
|
|
24
|
+
/** The plot area and its axes, as annotations position against them. */
|
|
25
|
+
export interface AnnotationFrame {
|
|
26
|
+
plot: PlotRect;
|
|
27
|
+
axes: Partial<Record<AnnotationAxis, AxisFrame>>;
|
|
28
|
+
}
|
|
29
|
+
/** Whether an axis runs vertically. */
|
|
30
|
+
export declare const isVertical: (axis: AnnotationAxis) => boolean;
|
|
31
|
+
/**
|
|
32
|
+
The pixel position of `value` on `axis`, or NaN when it has none: the
|
|
33
|
+
axis is missing, the value is not one of a category axis's categories,
|
|
34
|
+
or it does not parse. A `"plot"` value is a fraction of the plot area
|
|
35
|
+
(`0` at the left or bottom edge, `1` at the right or top).
|
|
36
|
+
@param frame The plot area and its axes.
|
|
37
|
+
@param axis The axis the value is on.
|
|
38
|
+
@param value The value, in data units or as a fraction.
|
|
39
|
+
@param ref How the value is read.
|
|
40
|
+
*/
|
|
41
|
+
export declare function axisPixel(frame: AnnotationFrame, axis: AnnotationAxis, value: unknown, ref?: AnnotationRef): number;
|
|
42
|
+
/**
|
|
43
|
+
The pixel position of a number (or date) that is not itself a category
|
|
44
|
+
on an axis of numeric categories: interpolated between the categories on
|
|
45
|
+
either side of it, or NaN outside them or among non-numeric categories.
|
|
46
|
+
@param a The axis.
|
|
47
|
+
@param value The value.
|
|
48
|
+
*/
|
|
49
|
+
export declare function betweenCategories(a: AxisFrame, value: unknown): number;
|
|
50
|
+
/**
|
|
51
|
+
Half the pixel distance between neighboring categories on a category
|
|
52
|
+
axis whose categories fill slots (bars; half the plot's extent along it
|
|
53
|
+
when it has one category), or `0` on any other axis.
|
|
54
|
+
@param frame The plot area and its axes.
|
|
55
|
+
@param axis The axis.
|
|
56
|
+
*/
|
|
57
|
+
export declare function categoryHalfStep(frame: AnnotationFrame, axis: AnnotationAxis): number;
|
|
58
|
+
/**
|
|
59
|
+
The pixel extent `[lo, hi]` between two values on an axis, or null when
|
|
60
|
+
either has no position. On a category axis of bars it takes in each end
|
|
61
|
+
category's whole slot.
|
|
62
|
+
@param frame The plot area and its axes.
|
|
63
|
+
@param axis The axis the values are on.
|
|
64
|
+
@param values The two values.
|
|
65
|
+
@param ref How the values are read.
|
|
66
|
+
*/
|
|
67
|
+
export declare function axisSpan(frame: AnnotationFrame, axis: AnnotationAxis, values: [unknown, unknown], ref?: AnnotationRef): [number, number] | null;
|
|
68
|
+
/**
|
|
69
|
+
Clips a pixel extent to `[min, max]`, or null when nothing of it is left.
|
|
70
|
+
@param span The extent.
|
|
71
|
+
@param min The lower bound.
|
|
72
|
+
@param max The upper bound.
|
|
73
|
+
*/
|
|
74
|
+
export declare function clipSpan(span: [number, number], min: number, max: number): [number, number] | null;
|
|
75
|
+
/**
|
|
76
|
+
Whether a pixel point lies in the plot area, give or take `tolerance`.
|
|
77
|
+
@param point The point.
|
|
78
|
+
@param plot The plot area.
|
|
79
|
+
@param tolerance Pixels of slack on each side.
|
|
80
|
+
*/
|
|
81
|
+
export declare function inPlot([x, y]: [number, number], plot: PlotRect, tolerance?: number): boolean;
|
|
82
|
+
/**
|
|
83
|
+
The pixel position of an annotation row's anchor: its `x` (or `x2`, on
|
|
84
|
+
that axis) and `y` (or `y2`), or NaN coordinates when it has none.
|
|
85
|
+
@param frame The plot area and its axes.
|
|
86
|
+
@param d The row.
|
|
87
|
+
@param xRef How its x value is read.
|
|
88
|
+
@param yRef How its y value is read.
|
|
89
|
+
*/
|
|
90
|
+
export declare function anchorPoint(frame: AnnotationFrame, d: Record<string, unknown>, xRef?: AnnotationRef, yRef?: AnnotationRef): [number, number];
|
|
91
|
+
/**
|
|
92
|
+
The annotation frame of a painted Plot: its plot area in content pixels
|
|
93
|
+
and its rendered axes. `x2`/`y2` are present only when the chart plots
|
|
94
|
+
on them, and `slots` marks a bar chart, whose categories fill slots
|
|
95
|
+
along its discrete axis.
|
|
96
|
+
@param viz The chart.
|
|
97
|
+
@param measured The axis functions and ranges `renderAxes` solved.
|
|
98
|
+
*/
|
|
99
|
+
export declare function plotAnnotationFrame(viz: VizInstance, measured: {
|
|
100
|
+
x: PlotAxisFn;
|
|
101
|
+
y: PlotAxisFn;
|
|
102
|
+
xRange: number[];
|
|
103
|
+
yRange: number[];
|
|
104
|
+
x2Height: number;
|
|
105
|
+
x2Exists?: boolean;
|
|
106
|
+
y2Exists?: boolean;
|
|
107
|
+
slots?: boolean;
|
|
108
|
+
}): AnnotationFrame;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Text for callouts and reference labels: the theme-aware text style, the
|
|
3
|
+
label wrapped to a width, and the text node that draws it.
|
|
4
|
+
*/
|
|
5
|
+
import type { TextNode } from "@d3plus/render";
|
|
6
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
7
|
+
/** A resolved annotation text style. */
|
|
8
|
+
export interface AnnotationText {
|
|
9
|
+
fontColor: string;
|
|
10
|
+
fontFamily: string;
|
|
11
|
+
fontSize: number;
|
|
12
|
+
fontWeight: number | string;
|
|
13
|
+
lineHeight: number;
|
|
14
|
+
maxWidth: number;
|
|
15
|
+
}
|
|
16
|
+
/** A label wrapped into lines. */
|
|
17
|
+
export interface TextBlock {
|
|
18
|
+
lines: string[];
|
|
19
|
+
widths: number[];
|
|
20
|
+
/** The widest line's width. */
|
|
21
|
+
width: number;
|
|
22
|
+
/** All lines' height. */
|
|
23
|
+
height: number;
|
|
24
|
+
lineHeight: number;
|
|
25
|
+
}
|
|
26
|
+
/** Which way text lines up against its `x`. */
|
|
27
|
+
export type TextAlign = "start" | "middle" | "end";
|
|
28
|
+
/**
|
|
29
|
+
The text style for an annotation: each key from `config` (through `pick`,
|
|
30
|
+
which may read a row), else the defaults: the chart's text color for its
|
|
31
|
+
background and font family, 12px, weight 400, a 1.3 line height, and
|
|
32
|
+
a 150px wrap width.
|
|
33
|
+
@param viz The chart.
|
|
34
|
+
@param pick Reads one style key.
|
|
35
|
+
*/
|
|
36
|
+
export declare function annotationTextStyle(viz: VizInstance, pick: (key: string) => unknown): AnnotationText;
|
|
37
|
+
/**
|
|
38
|
+
Wraps `text` at the style's `maxWidth`, measuring each line.
|
|
39
|
+
@param text The label.
|
|
40
|
+
@param style The text style.
|
|
41
|
+
*/
|
|
42
|
+
export declare function wrapAnnotationText(text: string, style: AnnotationText): TextBlock;
|
|
43
|
+
/**
|
|
44
|
+
The text node that draws a wrapped label whose block's top edge sits at
|
|
45
|
+
`y`, lined up against `x` by `align` (its left edge, center, or right
|
|
46
|
+
edge). Inert: annotations take no pointer or keyboard focus.
|
|
47
|
+
@param block The wrapped label.
|
|
48
|
+
@param style Its text style.
|
|
49
|
+
@param at Where the block goes, and its key.
|
|
50
|
+
*/
|
|
51
|
+
export declare function annotationTextNode(block: TextBlock, style: AnnotationText, at: {
|
|
52
|
+
key: string;
|
|
53
|
+
x: number;
|
|
54
|
+
y: number;
|
|
55
|
+
align: TextAlign;
|
|
56
|
+
opacity?: number;
|
|
57
|
+
}): TextNode;
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The config shapes of a Plot's callout annotations, reference lines, and
|
|
3
|
+
reference bands.
|
|
4
|
+
*/
|
|
5
|
+
import type { DataPoint } from "@d3plus/data";
|
|
6
|
+
/**
|
|
7
|
+
How an annotation position is read on one axis: `"data"` (the default)
|
|
8
|
+
maps it through the axis scale, in data units (a number, a date, or a
|
|
9
|
+
category); `"plot"` reads it as a fraction of the plot area, from `0` at
|
|
10
|
+
the left (or bottom) edge to `1` at the right (or top) edge.
|
|
11
|
+
*/
|
|
12
|
+
export type AnnotationRef = "data" | "plot";
|
|
13
|
+
/** A value on a Plot axis: a number, a date (a Date, timestamp, or date string), or a category. */
|
|
14
|
+
export type AnnotationValue = number | string | Date;
|
|
15
|
+
/**
|
|
16
|
+
A user annotation: a shape key (a Shape class name such as `"Line"` or
|
|
17
|
+
`"Rect"`, or `"Callout"`, `"ReferenceLine"`, or `"ReferenceBand"`) plus
|
|
18
|
+
its config, optionally z-layered.
|
|
19
|
+
*/
|
|
20
|
+
export interface Annotation {
|
|
21
|
+
shape: string;
|
|
22
|
+
layer?: string;
|
|
23
|
+
[key: string]: unknown;
|
|
24
|
+
}
|
|
25
|
+
/** A constant, or a `(datum, index)` accessor over a callout's data rows. */
|
|
26
|
+
type CalloutValue<T> = T | ((d: DataPoint, i: number) => T);
|
|
27
|
+
/** The text and stroke styles shared by callouts and reference labels. */
|
|
28
|
+
export interface AnnotationTextStyle {
|
|
29
|
+
/** Text color. Defaults to the chart's text color for its background. */
|
|
30
|
+
fontColor?: string;
|
|
31
|
+
/** Font family. Defaults to the chart's `fontFamily`. */
|
|
32
|
+
fontFamily?: string | string[];
|
|
33
|
+
/** Font size, in pixels. Defaults to `12`. */
|
|
34
|
+
fontSize?: number;
|
|
35
|
+
/** Font weight. Defaults to `400`. */
|
|
36
|
+
fontWeight?: number | string;
|
|
37
|
+
/** Line height, in pixels. Defaults to 1.3 times `fontSize`. */
|
|
38
|
+
lineHeight?: number;
|
|
39
|
+
/** The width, in pixels, the text wraps at. Defaults to `150`. */
|
|
40
|
+
maxWidth?: number;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
A callout annotation (`{shape: "Callout", data: [...]}` in `annotations`):
|
|
44
|
+
a note anchored at each row's `x`/`y` (or `x2`/`y2`, on those axes), drawn
|
|
45
|
+
as wrapped text in a box offset from the anchor by `dx`/`dy` pixels, with
|
|
46
|
+
a connector line from the box to the anchor ending in an arrowhead or a
|
|
47
|
+
dot. Each style key takes a constant or a `(d, i)` accessor, and a row's
|
|
48
|
+
own key of the same name wins over a constant. The box stays inside the
|
|
49
|
+
plot area. Callouts draw in front of the data unless `layer: "back"`, and
|
|
50
|
+
never respond to the pointer or keyboard.
|
|
51
|
+
*/
|
|
52
|
+
export interface CalloutAnnotation extends AnnotationTextStyle {
|
|
53
|
+
shape: "Callout";
|
|
54
|
+
/** The anchors: each row's `x`/`y` (or `x2`/`y2`) and `label`. */
|
|
55
|
+
data: DataPoint[];
|
|
56
|
+
/** `"front"` (the default) or `"back"` of the data shapes. */
|
|
57
|
+
layer?: "back" | "front";
|
|
58
|
+
/** How the anchors' `x` values are read. Defaults to `"data"`. */
|
|
59
|
+
xRef?: AnnotationRef;
|
|
60
|
+
/** How the anchors' `y` values are read. Defaults to `"data"`. */
|
|
61
|
+
yRef?: AnnotationRef;
|
|
62
|
+
/** The text. Defaults to each row's `label`. */
|
|
63
|
+
label?: CalloutValue<string>;
|
|
64
|
+
/** Horizontal offset of the box's center from the anchor, in pixels. Defaults to `0`. */
|
|
65
|
+
dx?: CalloutValue<number>;
|
|
66
|
+
/** Vertical offset of the box's center from the anchor, in pixels (negative is up). Defaults to `-40`. */
|
|
67
|
+
dy?: CalloutValue<number>;
|
|
68
|
+
/** Text alignment in the box: `"start"`, `"middle"` (the default), or `"end"`. */
|
|
69
|
+
textAlign?: CalloutValue<"start" | "middle" | "end">;
|
|
70
|
+
/** Space between the text and the box's edge, in pixels. Defaults to `6`. */
|
|
71
|
+
padding?: CalloutValue<number>;
|
|
72
|
+
/** Box fill. Defaults to the chart's background; `false` or `"none"` draws no box. */
|
|
73
|
+
fill?: CalloutValue<string | false>;
|
|
74
|
+
/** Box fill opacity. Defaults to `1`. */
|
|
75
|
+
fillOpacity?: CalloutValue<number>;
|
|
76
|
+
/** Box border color. Defaults to the text color. `false` or `"none"` draws no border. */
|
|
77
|
+
stroke?: CalloutValue<string | false>;
|
|
78
|
+
/** Box border opacity. Defaults to `0.25`. */
|
|
79
|
+
strokeOpacity?: CalloutValue<number>;
|
|
80
|
+
/** Box border width. Defaults to `1`. */
|
|
81
|
+
strokeWidth?: CalloutValue<number>;
|
|
82
|
+
/** Box corner radius. Defaults to `3`. */
|
|
83
|
+
rx?: CalloutValue<number>;
|
|
84
|
+
/** Whether a line joins the box to its anchor. Defaults to `true`. */
|
|
85
|
+
connector?: CalloutValue<boolean>;
|
|
86
|
+
/** Connector color. Defaults to the text color. */
|
|
87
|
+
connectorStroke?: CalloutValue<string>;
|
|
88
|
+
/** Connector width. Defaults to `1`. */
|
|
89
|
+
connectorStrokeWidth?: CalloutValue<number>;
|
|
90
|
+
/** Connector opacity. Defaults to `1`. */
|
|
91
|
+
connectorStrokeOpacity?: CalloutValue<number>;
|
|
92
|
+
/** Connector dash pattern, as a string ("4 2") or numbers. */
|
|
93
|
+
connectorStrokeDasharray?: CalloutValue<string | number[]>;
|
|
94
|
+
/** What marks the anchor: `"arrow"` (the default), `"dot"`, or `"none"`. */
|
|
95
|
+
marker?: CalloutValue<"arrow" | "dot" | "none">;
|
|
96
|
+
/** Arrowhead length or dot diameter, in pixels. Defaults to `6`. */
|
|
97
|
+
markerSize?: CalloutValue<number>;
|
|
98
|
+
/** Gap between the connector's end and the anchor, in pixels. Defaults to `0`. */
|
|
99
|
+
standoff?: CalloutValue<number>;
|
|
100
|
+
/** Whether the box is kept inside the plot area. Defaults to `true`. */
|
|
101
|
+
clamp?: CalloutValue<boolean>;
|
|
102
|
+
}
|
|
103
|
+
/** The line and label styles shared by reference lines and bands. */
|
|
104
|
+
export interface ReferenceStyle extends AnnotationTextStyle {
|
|
105
|
+
/** The text drawn with it. */
|
|
106
|
+
label?: string;
|
|
107
|
+
/** `"back"` (the default) or `"front"` of the data shapes. The label draws above the data either way. */
|
|
108
|
+
layer?: "back" | "front";
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
A full-width or full-height line across the plot at one value: give `x`
|
|
112
|
+
(a vertical line) or `y` (a horizontal one), or `x2`/`y2` for the
|
|
113
|
+
secondary axes. On a continuous or time axis the value widens the axis
|
|
114
|
+
domain to show the line, unless the user set that end of the domain.
|
|
115
|
+
*/
|
|
116
|
+
export interface ReferenceLineConfig extends ReferenceStyle {
|
|
117
|
+
x?: AnnotationValue;
|
|
118
|
+
y?: AnnotationValue;
|
|
119
|
+
x2?: AnnotationValue;
|
|
120
|
+
y2?: AnnotationValue;
|
|
121
|
+
/** How the value is read. Defaults to `"data"`. */
|
|
122
|
+
ref?: AnnotationRef;
|
|
123
|
+
/** Which end of the line the label sits at: `"end"` (the default: the right, or the top) or `"start"`. */
|
|
124
|
+
labelPosition?: "start" | "end";
|
|
125
|
+
/** Line color. Defaults to the chart's text color. */
|
|
126
|
+
stroke?: string;
|
|
127
|
+
/** Line opacity. Defaults to `0.6`. */
|
|
128
|
+
strokeOpacity?: number;
|
|
129
|
+
/** Line width. Defaults to `1`. */
|
|
130
|
+
strokeWidth?: number;
|
|
131
|
+
/** `true` dashes the line ("4 4"); a dash pattern string or numbers sets its own. */
|
|
132
|
+
dash?: boolean | string | number[];
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
A shaded span across the plot between two values: give `x` (a vertical
|
|
136
|
+
band) or `y` (a horizontal one) as `[start, end]`, or `x2`/`y2`. On a
|
|
137
|
+
category axis the band covers each end category's whole slot; on a
|
|
138
|
+
continuous or time axis its ends widen the axis domain, unless the user
|
|
139
|
+
set that end of the domain.
|
|
140
|
+
*/
|
|
141
|
+
export interface ReferenceBandConfig extends ReferenceStyle {
|
|
142
|
+
x?: [AnnotationValue, AnnotationValue];
|
|
143
|
+
y?: [AnnotationValue, AnnotationValue];
|
|
144
|
+
x2?: [AnnotationValue, AnnotationValue];
|
|
145
|
+
y2?: [AnnotationValue, AnnotationValue];
|
|
146
|
+
/** How the values are read. Defaults to `"data"`. */
|
|
147
|
+
ref?: AnnotationRef;
|
|
148
|
+
/** Which corner the label sits in: `"start"` (the default: the top left) or `"end"` (the top right). */
|
|
149
|
+
labelPosition?: "start" | "end";
|
|
150
|
+
/** Band fill. Defaults to the chart's text color. */
|
|
151
|
+
fill?: string;
|
|
152
|
+
/** Band fill opacity. Defaults to `0.08`. */
|
|
153
|
+
fillOpacity?: number;
|
|
154
|
+
/** Edge color; unset, the band has no edges. */
|
|
155
|
+
stroke?: string;
|
|
156
|
+
/** Edge opacity. Defaults to `0.4`. */
|
|
157
|
+
strokeOpacity?: number;
|
|
158
|
+
/** Edge width. Defaults to `1`. */
|
|
159
|
+
strokeWidth?: number;
|
|
160
|
+
}
|
|
161
|
+
export {};
|
|
@@ -20,6 +20,8 @@ export interface LineLabelMeasurement {
|
|
|
20
20
|
labelWidths: LabelWidth[];
|
|
21
21
|
largestLabel: number | undefined;
|
|
22
22
|
xRangeMax: number | undefined;
|
|
23
|
+
/** The room left of the x range for the lines' left-end labels. */
|
|
24
|
+
startLabelSpace?: number;
|
|
23
25
|
}
|
|
24
26
|
/**
|
|
25
27
|
The stable per-draw inputs the joint margin solve reads — exactly the
|
|
@@ -70,6 +72,8 @@ export interface AxisMeasureResult {
|
|
|
70
72
|
xRangeMax: number | undefined;
|
|
71
73
|
labelWidths: LabelWidth[];
|
|
72
74
|
largestLabel: number | undefined;
|
|
75
|
+
/** The room left of the x range for the lines' left-end labels. */
|
|
76
|
+
startLabelSpace: number;
|
|
73
77
|
xTestRange: number[];
|
|
74
78
|
x2TestRange: number[];
|
|
75
79
|
x2Height: number;
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { SceneEvent } from "@d3plus/render";
|
|
2
|
+
import type { AxisTooltipTarget } from "../../components/Axis/axisTooltipTargets.js";
|
|
3
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
4
|
+
/** What an axis tooltip shows. */
|
|
5
|
+
export interface AxisTooltipContent {
|
|
6
|
+
/** The label's whole text when it is drawn cut short, else `false`. */
|
|
7
|
+
title: string | false;
|
|
8
|
+
/** The text the axis option gives, else `false`. */
|
|
9
|
+
body: string | false;
|
|
10
|
+
/** The tooltip config the axis option gives, its accessors bound to the label. */
|
|
11
|
+
config?: Record<string, unknown>;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
A copy of a config value whose functions, at any depth, are called with
|
|
15
|
+
`args` whatever they are passed.
|
|
16
|
+
@param value A config object, or any value in one.
|
|
17
|
+
@param args What every function in it receives.
|
|
18
|
+
*/
|
|
19
|
+
export declare function bindAccessors(value: unknown, args: unknown[]): unknown;
|
|
20
|
+
/**
|
|
21
|
+
What hovering an axis label shows, from the axis's `titleTooltip` or
|
|
22
|
+
`tickTooltip`: a string is the body, a function returns it (given the
|
|
23
|
+
title, or the tick's value and index), and an object is a tooltip config
|
|
24
|
+
whose accessors receive the same. A label drawn cut short adds its whole
|
|
25
|
+
text as the title. Null when there is nothing to show: the option is
|
|
26
|
+
`false`, its function returns `false`, or the label is drawn whole and
|
|
27
|
+
the option is unset or its function returns nothing.
|
|
28
|
+
@param target The hovered label.
|
|
29
|
+
@param fullText Whether a cut label shows its whole text.
|
|
30
|
+
@param self The `this` the option's function is called with.
|
|
31
|
+
*/
|
|
32
|
+
export declare function resolveAxisTooltip(target: AxisTooltipTarget, fullText?: boolean, self?: unknown): AxisTooltipContent | null;
|
|
33
|
+
/**
|
|
34
|
+
Whether a tooltip datum is an axis tooltip's.
|
|
35
|
+
@param d The first of a tooltip's data.
|
|
36
|
+
*/
|
|
37
|
+
export declare function isAxisTooltipDatum(d: unknown): boolean;
|
|
38
|
+
/**
|
|
39
|
+
Shows, moves, or hides the axis tooltip for a pointer event. Moving onto
|
|
40
|
+
a label with something to show (see `resolveAxisTooltip`) shows it at the
|
|
41
|
+
pointer; moving anywhere else, or leaving the chart, hides it when it is
|
|
42
|
+
still the tooltip showing. Charts with `tooltip: false` skip the whole
|
|
43
|
+
text of cut labels, and show only what an axis option gives. Labels show
|
|
44
|
+
nothing while a transition is in flight.
|
|
45
|
+
@param viz The chart.
|
|
46
|
+
@param event The pointer event.
|
|
47
|
+
@returns Whether an axis tooltip is showing for the event.
|
|
48
|
+
*/
|
|
49
|
+
export declare function handleAxisTooltip(viz: VizInstance, event: SceneEvent): boolean;
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A callout's geometry in pixels: its box offset from the anchor and kept
|
|
3
|
+
inside the plot, the connector from the box's edge to the anchor, and the
|
|
4
|
+
arrowhead at the anchor.
|
|
5
|
+
*/
|
|
6
|
+
import type { PlotRect } from "./annotationFrame.js";
|
|
7
|
+
/** A pixel point. */
|
|
8
|
+
export type Point = [number, number];
|
|
9
|
+
/** A pixel rectangle, from its top-left corner. */
|
|
10
|
+
export interface Box {
|
|
11
|
+
x: number;
|
|
12
|
+
y: number;
|
|
13
|
+
width: number;
|
|
14
|
+
height: number;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
A `width` × `height` box centered `dx`/`dy` pixels from the anchor.
|
|
18
|
+
@param anchor The anchor.
|
|
19
|
+
@param size The box's size.
|
|
20
|
+
@param dx The horizontal offset of its center.
|
|
21
|
+
@param dy The vertical offset of its center.
|
|
22
|
+
*/
|
|
23
|
+
export declare function offsetBox(anchor: Point, size: {
|
|
24
|
+
width: number;
|
|
25
|
+
height: number;
|
|
26
|
+
}, dx: number, dy: number): Box;
|
|
27
|
+
/**
|
|
28
|
+
Moves a box the least distance that puts it inside the plot area; a box
|
|
29
|
+
larger than the plot keeps to its top-left corner.
|
|
30
|
+
@param box The box.
|
|
31
|
+
@param plot The plot area.
|
|
32
|
+
*/
|
|
33
|
+
export declare function clampBox(box: Box, plot: PlotRect): Box;
|
|
34
|
+
/**
|
|
35
|
+
Where the connector runs: `from` the point the line from the box's center
|
|
36
|
+
to the anchor leaves the box, `to` the anchor (pulled back toward the box
|
|
37
|
+
by `standoff`). Null when the anchor is inside the box or the connector
|
|
38
|
+
would be shorter than a pixel.
|
|
39
|
+
@param box The callout box.
|
|
40
|
+
@param anchor The anchor.
|
|
41
|
+
@param standoff The gap to leave before the anchor.
|
|
42
|
+
*/
|
|
43
|
+
export declare function connectorEndpoints(box: Box, anchor: Point, standoff?: number): {
|
|
44
|
+
from: Point;
|
|
45
|
+
to: Point;
|
|
46
|
+
} | null;
|
|
47
|
+
/**
|
|
48
|
+
The three corners of an arrowhead `size` pixels long with its tip at
|
|
49
|
+
`tip`, pointing along the line from `from`: the tip, then its base's two
|
|
50
|
+
corners.
|
|
51
|
+
@param from The line's start.
|
|
52
|
+
@param tip The arrow's tip.
|
|
53
|
+
@param size The arrowhead's length (its base is as wide).
|
|
54
|
+
*/
|
|
55
|
+
export declare function arrowheadPoints(from: Point, tip: Point, size: number): [Point, Point, Point];
|
|
56
|
+
/**
|
|
57
|
+
Where a point moves along the line from `from` by `distance` pixels back
|
|
58
|
+
from its end (the arrow's base, where the connector stops).
|
|
59
|
+
@param from The line's start.
|
|
60
|
+
@param to The line's end.
|
|
61
|
+
@param distance How far back from `to`.
|
|
62
|
+
*/
|
|
63
|
+
export declare function pullBack(from: Point, to: Point, distance: number): Point;
|
|
64
|
+
/**
|
|
65
|
+
Where a callout's box goes: centered `dx`/`dy` from the anchor and, when
|
|
66
|
+
`clamp` is on, moved inside the plot area. A box that clamping pushes
|
|
67
|
+
over its own anchor tries the opposite offset instead, and keeps it when
|
|
68
|
+
that leaves the anchor clear.
|
|
69
|
+
@param anchor The anchor.
|
|
70
|
+
@param size The box's size.
|
|
71
|
+
@param offset The box center's offset from the anchor.
|
|
72
|
+
@param plot The plot area.
|
|
73
|
+
@param clamp Whether the box stays inside the plot area.
|
|
74
|
+
*/
|
|
75
|
+
export declare function placeCalloutBox(anchor: Point, size: {
|
|
76
|
+
width: number;
|
|
77
|
+
height: number;
|
|
78
|
+
}, [dx, dy]: Point, plot: PlotRect, clamp?: boolean): Box;
|