@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,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Reads the page behind a chart (light or dark, and its background) and
|
|
3
|
+
redraws an `"auto"` themed chart when the page flips between the two.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
import type { PageTheme } from "../../utils/theme.js";
|
|
8
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
9
|
+
type PageTarget = Pick<VizInstance, "_select" | "_ssr">;
|
|
10
|
+
/**
|
|
11
|
+
The page behind the chart: the first non-transparent background among its
|
|
12
|
+
ancestors decides, or, when none sets one, the browser's own page canvas,
|
|
13
|
+
which is dark only when the page opts into a dark `color-scheme` and the
|
|
14
|
+
system prefers dark. Server renders are light.
|
|
15
|
+
*/
|
|
16
|
+
export declare function pageTheme(viz: PageTarget): PageTheme;
|
|
17
|
+
/** Whether the chart sits on a dark page (see `pageTheme`). */
|
|
18
|
+
export declare function pageIsDark(viz: PageTarget): boolean;
|
|
19
|
+
/**
|
|
20
|
+
Calls `onFlip` whenever the page might have changed theme: on a system
|
|
21
|
+
theme change, when the page flips a class/attribute/style on `<html>` or
|
|
22
|
+
`<body>` (how most theme toggles work), or when a background transition
|
|
23
|
+
ends. Returns the unsubscribe.
|
|
24
|
+
*/
|
|
25
|
+
export declare function watchPage(onFlip: () => void): () => void;
|
|
26
|
+
/**
|
|
27
|
+
Keeps an `"auto"` themed chart in step with its page: redraws it when the
|
|
28
|
+
page's dark state differs from the one it last drew with. Installed once
|
|
29
|
+
per chart; `unwatchPageTheme` removes it.
|
|
30
|
+
*/
|
|
31
|
+
export declare function watchPageTheme(viz: VizInstance): void;
|
|
32
|
+
/** Stops a chart's page-theme watcher, if it has one. */
|
|
33
|
+
export declare function unwatchPageTheme(viz: Pick<VizInstance, "_themeWatch">): void;
|
|
34
|
+
export {};
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Where a hovered point mark's tooltip points: the mark's painted box, in
|
|
3
|
+
client coordinates, so the tooltip's arrow meets the middle of its top
|
|
4
|
+
edge (its bottom edge when the tooltip flips below) and holds still
|
|
5
|
+
while the pointer moves within reach of the same point.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/
|
|
9
|
+
import type { VirtualElement } from "@floating-ui/dom";
|
|
10
|
+
import type { Bounds } from "@d3plus/math";
|
|
11
|
+
import type { SceneNode } from "@d3plus/render";
|
|
12
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
13
|
+
/** A client-space position. */
|
|
14
|
+
export interface ClientOrigin {
|
|
15
|
+
left: number;
|
|
16
|
+
top: number;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
The client position of the drawing surface's origin: the scene `<svg>`'s
|
|
20
|
+
user-space origin (read off its screen CTM: a nested svg's bounding rect
|
|
21
|
+
is the box of its painted content), or the `<canvas>`'s corner. Falls
|
|
22
|
+
back to the chart's own element, then to the viewport origin.
|
|
23
|
+
*/
|
|
24
|
+
export declare function surfaceOrigin(viz: VizInstance): ClientOrigin;
|
|
25
|
+
/**
|
|
26
|
+
A tooltip anchor (a Floating UI virtual element) for a box in surface
|
|
27
|
+
coordinates, moved to client coordinates by `origin`.
|
|
28
|
+
*/
|
|
29
|
+
export declare function clientAnchor(box: Bounds, origin: ClientOrigin): VirtualElement;
|
|
30
|
+
/**
|
|
31
|
+
The tooltip anchor for a hovered node: its point mark's painted box when
|
|
32
|
+
nearest-point hover applies to it (see `pointTarget`), whether the
|
|
33
|
+
pointer is on the mark or only near it. Undefined otherwise, for the
|
|
34
|
+
tooltip to follow the pointer.
|
|
35
|
+
*/
|
|
36
|
+
export declare function pointTooltipAnchor(viz: VizInstance, node: SceneNode | null | undefined): VirtualElement | undefined;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A Voronoi diagram over a set of points: the nearest point to a position
|
|
3
|
+
(within a distance, measured from each point's edge), and each point's
|
|
4
|
+
clipped cell and neighbors.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/
|
|
8
|
+
import type { Bounds } from "@d3plus/math";
|
|
9
|
+
/** One point in the diagram. */
|
|
10
|
+
export interface VoronoiPoint<T = unknown> {
|
|
11
|
+
/** The point's center. */
|
|
12
|
+
x: number;
|
|
13
|
+
/** The point's center. */
|
|
14
|
+
y: number;
|
|
15
|
+
/** The mark's radius: distances are measured from its edge (default 0; a non-finite or negative radius counts as 0). */
|
|
16
|
+
r?: number;
|
|
17
|
+
/** What the point stands for (a scene node, a datum). */
|
|
18
|
+
item: T;
|
|
19
|
+
}
|
|
20
|
+
/** A `nearest` match. */
|
|
21
|
+
export interface VoronoiMatch<T = unknown> {
|
|
22
|
+
/** The point's index in the input array. */
|
|
23
|
+
index: number;
|
|
24
|
+
point: VoronoiPoint<T>;
|
|
25
|
+
/** The distance from the position to the point's edge (0 inside it). */
|
|
26
|
+
distance: number;
|
|
27
|
+
}
|
|
28
|
+
/** The Voronoi structure `pointVoronoi` builds. */
|
|
29
|
+
export interface PointVoronoi<T = unknown> {
|
|
30
|
+
/** The points, in input order. */
|
|
31
|
+
readonly points: readonly VoronoiPoint<T>[];
|
|
32
|
+
/** The box the cells are clipped to: the bounds given, grown to hold every point. */
|
|
33
|
+
readonly bounds: Bounds;
|
|
34
|
+
/**
|
|
35
|
+
The point closest to `[x, y]` whose edge lies within `maxDistance`
|
|
36
|
+
(default Infinity), or null. Ties go to the point with the nearer
|
|
37
|
+
center, then the lower index.
|
|
38
|
+
*/
|
|
39
|
+
nearest(x: number, y: number, maxDistance?: number): VoronoiMatch<T> | null;
|
|
40
|
+
/**
|
|
41
|
+
The point's Voronoi cell clipped to `bounds`, as an open ring of
|
|
42
|
+
vertices (the first vertex is not repeated at the end): every position
|
|
43
|
+
in it is closer to this point's center than to any other. Null for an
|
|
44
|
+
out-of-range index or a point that coincides with an earlier one.
|
|
45
|
+
*/
|
|
46
|
+
cell(index: number): [number, number][] | null;
|
|
47
|
+
/**
|
|
48
|
+
The indices of the points whose cells share an edge or a corner with
|
|
49
|
+
this one's (its Delaunay neighbors), in ascending order. Empty for a
|
|
50
|
+
lone point or one that coincides with an earlier one.
|
|
51
|
+
*/
|
|
52
|
+
neighbors(index: number): number[];
|
|
53
|
+
}
|
|
54
|
+
/** The distance from `[x, y]` to a polygon (0 inside it). */
|
|
55
|
+
export declare function polygonDistance(x: number, y: number, ring: [number, number][]): number;
|
|
56
|
+
/**
|
|
57
|
+
Builds a Voronoi diagram over `points` (with d3-delaunay), clipped to
|
|
58
|
+
`bounds`. Points with a non-finite coordinate are left out of the
|
|
59
|
+
diagram: `nearest` never returns them and their `cell` is null. The
|
|
60
|
+
Delaunay triangulation is built up front; the clipped cells only on the
|
|
61
|
+
first call that needs them.
|
|
62
|
+
@param points The points, in surface coordinates.
|
|
63
|
+
@param bounds The box to clip cells to (grown to hold every point).
|
|
64
|
+
*/
|
|
65
|
+
export declare function pointVoronoi<T>(points: readonly VoronoiPoint<T>[], bounds: Bounds): PointVoronoi<T>;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/** The `reducedMotion` setting: follow the OS (`"auto"`), or force it on or off. */
|
|
2
|
+
export type ReducedMotionSetting = "auto" | boolean;
|
|
3
|
+
/** Anything with a `duration` and an optional `reducedMotion` in its schema. */
|
|
4
|
+
export interface MotionHost {
|
|
5
|
+
schema: {
|
|
6
|
+
duration?: number;
|
|
7
|
+
reducedMotion?: ReducedMotionSetting;
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
Whether the viewer's OS asks for reduced motion, read from the
|
|
12
|
+
`(prefers-reduced-motion: reduce)` media query. False without a `window`
|
|
13
|
+
or `matchMedia` (server-side rendering, older runtimes).
|
|
14
|
+
*/
|
|
15
|
+
export declare function prefersReducedMotion(): boolean;
|
|
16
|
+
/**
|
|
17
|
+
Whether a chart draws without motion: `reducedMotion` `true` always,
|
|
18
|
+
`false` never, and `"auto"` (or unset) when the OS asks for it.
|
|
19
|
+
*/
|
|
20
|
+
export declare function motionReduced(host: MotionHost): boolean;
|
|
21
|
+
/**
|
|
22
|
+
The transition duration a chart animates with: 0 when motion is reduced,
|
|
23
|
+
otherwise its `duration` (the stored `duration` is left as the user set it).
|
|
24
|
+
*/
|
|
25
|
+
export declare function effectiveDuration(host: MotionHost): number;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The name a chart reports itself by: its class's `_displayName` (kept
|
|
3
|
+
through minification), else the constructor's name.
|
|
4
|
+
@private
|
|
5
|
+
*/
|
|
6
|
+
export declare function chartName(viz: object): string;
|
|
7
|
+
/**
|
|
8
|
+
Logs an error a chart threw while drawing, naming the chart. The error
|
|
9
|
+
object is passed through, so the console shows its stack.
|
|
10
|
+
@private
|
|
11
|
+
*/
|
|
12
|
+
export declare function reportDrawError(viz: object, error: unknown): void;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The cursor a chart shows over its shapes and legend entries (the hand
|
|
3
|
+
over one a click acts on). It is set on the element under the pointer:
|
|
4
|
+
the chart's root `<svg>` or, with the Canvas renderer, its `<canvas>`
|
|
5
|
+
(the root svg sits above the canvas and passes pointer events through,
|
|
6
|
+
so its own cursor never shows).
|
|
7
|
+
*/
|
|
8
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
9
|
+
/**
|
|
10
|
+
The parts of a chart `setCursor` reads. (`schema` is not read: it ties
|
|
11
|
+
the type to a chart, every other part being optional.)
|
|
12
|
+
*/
|
|
13
|
+
export type CursorHost = Pick<VizInstance, "schema"> & Partial<Pick<VizInstance, "_renderer" | "_sceneRenderer" | "_select">>;
|
|
14
|
+
/**
|
|
15
|
+
Sets the cursor shown over the chart's drawing surface.
|
|
16
|
+
@param viz The chart.
|
|
17
|
+
@param cursor A CSS cursor.
|
|
18
|
+
*/
|
|
19
|
+
export declare function setCursor(viz: CursorHost, cursor: string): void;
|
|
20
|
+
/**
|
|
21
|
+
Returns both of the chart's drawing surfaces to the default cursor. Run
|
|
22
|
+
before the renderer is swapped for another: the pointer may rest on a
|
|
23
|
+
clickable shape, and the outgoing surface would keep its hand cursor.
|
|
24
|
+
@param viz The chart, still holding the outgoing renderer.
|
|
25
|
+
*/
|
|
26
|
+
export declare function resetCursor(viz: CursorHost): void;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Whether a hovered shape or legend entry shows a tooltip. Every caller asks
|
|
3
|
+
through `tooltipEnabled`, so the chart's `tooltip` accessor receives the
|
|
4
|
+
same arguments wherever it is consulted.
|
|
5
|
+
*/
|
|
6
|
+
import type { DataPoint } from "@d3plus/data";
|
|
7
|
+
import type { TooltipLevels } from "../../utils/D3plusConfig.js";
|
|
8
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
9
|
+
/** The parts of a chart `tooltipLevels` reads. */
|
|
10
|
+
export type TooltipHost = Pick<VizInstance, "schema"> & Partial<Pick<VizInstance, "_drawDepth" | "_legendDepth" | "_shapeDepth">>;
|
|
11
|
+
/**
|
|
12
|
+
The `groupBy` levels a `tooltip` accessor receives for `d`. `depth` is the
|
|
13
|
+
level `d` stands for: a group row's own level (see `groupRow.ts`), else
|
|
14
|
+
the level its chart reports for the shape (`ChartDefinition.shapeDepth`),
|
|
15
|
+
else the level the chart draws. A legend entry stands for the level its
|
|
16
|
+
label is read at. `maxDepth` is the deepest `groupBy` level, and `legend`
|
|
17
|
+
says which of the two `d` is.
|
|
18
|
+
@param viz The chart.
|
|
19
|
+
@param d The hovered shape's row, or the legend entry's.
|
|
20
|
+
@param legend Whether `d` is a legend entry.
|
|
21
|
+
*/
|
|
22
|
+
export declare function tooltipLevels(viz: TooltipHost, d: DataPoint | undefined | null, legend?: boolean): TooltipLevels;
|
|
23
|
+
/**
|
|
24
|
+
Whether `d` shows a tooltip: the chart's `tooltip` setting, called with
|
|
25
|
+
the datum, its index, and its `groupBy` levels (see `tooltipLevels`).
|
|
26
|
+
@param viz The chart.
|
|
27
|
+
@param d The hovered shape's row, or the legend entry's.
|
|
28
|
+
@param i The row's index.
|
|
29
|
+
@param legend Whether `d` is a legend entry.
|
|
30
|
+
*/
|
|
31
|
+
export declare function tooltipEnabled(viz: TooltipHost, d: DataPoint | undefined | null, i: number, legend?: boolean): boolean;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Which click handlers a chart's `on` holds for a shape or a legend entry:
|
|
3
|
+
one of the user's, or the chart's own. The hand cursor shows where a
|
|
4
|
+
click runs either. A chart registers each handler it installs as its own
|
|
5
|
+
(`setOwnClick`); any other handler is the user's, compared by identity.
|
|
6
|
+
*/
|
|
7
|
+
type ClickHandler = (...args: never[]) => unknown;
|
|
8
|
+
/** The parts of a chart these read: its `on` handlers. */
|
|
9
|
+
export interface ClickHost {
|
|
10
|
+
schema: {
|
|
11
|
+
on?: Record<string, unknown>;
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
Records `handler` as the chart's own handler for `key`, in place of any
|
|
16
|
+
recorded before.
|
|
17
|
+
@param viz The chart.
|
|
18
|
+
@param key The event the chart handles itself: `"click.shape"` or `"click.legend"`.
|
|
19
|
+
@param handler The handler the chart installs under `key`.
|
|
20
|
+
*/
|
|
21
|
+
export declare function setOwnClick(viz: object, key: string, handler: ClickHandler): void;
|
|
22
|
+
/**
|
|
23
|
+
Whether the chart's own handler is still the one under `key`.
|
|
24
|
+
@param viz The chart.
|
|
25
|
+
@param key The event the chart handles itself: `"click.shape"` or `"click.legend"`.
|
|
26
|
+
*/
|
|
27
|
+
export declare function hasOwnClick(viz: ClickHost, key: string): boolean;
|
|
28
|
+
/**
|
|
29
|
+
Whether a click runs a handler of the user's: any `click` handler, or one
|
|
30
|
+
under `key` that is not the chart's own.
|
|
31
|
+
@param viz The chart.
|
|
32
|
+
@param key The event the chart handles itself: `"click.shape"` or `"click.legend"`.
|
|
33
|
+
*/
|
|
34
|
+
export declare function hasUserClick(viz: ClickHost, key: string): boolean;
|
|
35
|
+
export {};
|
|
@@ -27,22 +27,13 @@ export declare const backControlStyleDefault: {
|
|
|
27
27
|
width: string;
|
|
28
28
|
};
|
|
29
29
|
export declare const attributionStyleDefault: {
|
|
30
|
-
background: string;
|
|
31
|
-
color: string;
|
|
32
30
|
"border-radius": string;
|
|
33
31
|
display: string;
|
|
34
32
|
"align-items": string;
|
|
35
33
|
gap: string;
|
|
36
34
|
font: string;
|
|
37
|
-
};
|
|
38
|
-
export declare const attributionStyleDarkDefault: {
|
|
39
35
|
background: string;
|
|
40
36
|
color: string;
|
|
41
|
-
"border-radius": string;
|
|
42
|
-
display: string;
|
|
43
|
-
"align-items": string;
|
|
44
|
-
gap: string;
|
|
45
|
-
font: string;
|
|
46
37
|
};
|
|
47
38
|
/**
|
|
48
39
|
Default inline styles for the zoom-control buttons — structural only
|
|
@@ -2,6 +2,8 @@ import type { ConfigField } from "../../fluent.js";
|
|
|
2
2
|
import type { VizInstance } from "./vizTypes.js";
|
|
3
3
|
/** A falsy value (no color) is stored as given, a key string read from each datum. */
|
|
4
4
|
export declare const optionalAccessor: (value: unknown) => unknown;
|
|
5
|
+
/** `optionalAccessor`, except that two keys or accessors make a bivariate accessor (see `colorScaleBivariate.ts`). */
|
|
6
|
+
export declare const colorScaleAccessor: (value: unknown) => unknown;
|
|
5
7
|
/**
|
|
6
8
|
The config keys every chart has, as generated accessors (`viz.<key>(value)`
|
|
7
9
|
sets, `viz.<key>()` gets): stored as given, wrapped as a constant
|
|
@@ -44,6 +46,7 @@ declare const fields: {
|
|
|
44
46
|
coerce: "const";
|
|
45
47
|
};
|
|
46
48
|
dataCutoff: {};
|
|
49
|
+
dataFormat: {};
|
|
47
50
|
dataPollingInterval: {
|
|
48
51
|
onSet: (viz: VizInstance) => void;
|
|
49
52
|
};
|
|
@@ -63,9 +66,27 @@ declare const fields: {
|
|
|
63
66
|
hiddenOpacity: {
|
|
64
67
|
coerce: "const";
|
|
65
68
|
};
|
|
69
|
+
hoverDistance: {
|
|
70
|
+
default: number;
|
|
71
|
+
};
|
|
72
|
+
keyboardNav: {
|
|
73
|
+
default: boolean;
|
|
74
|
+
onSet: (viz: VizInstance, value: unknown) => void;
|
|
75
|
+
};
|
|
76
|
+
keyboardNavConfig: {
|
|
77
|
+
merge: true;
|
|
78
|
+
default: {
|
|
79
|
+
padding: number;
|
|
80
|
+
strokeWidth: number;
|
|
81
|
+
};
|
|
82
|
+
};
|
|
66
83
|
label: {
|
|
67
84
|
coerce: "const";
|
|
68
85
|
};
|
|
86
|
+
labelPosition: {
|
|
87
|
+
coerce: "const";
|
|
88
|
+
default: string;
|
|
89
|
+
};
|
|
69
90
|
legend: {
|
|
70
91
|
coerce: "const";
|
|
71
92
|
};
|
|
@@ -75,6 +96,9 @@ declare const fields: {
|
|
|
75
96
|
legendFilterInvert: {
|
|
76
97
|
coerce: "const";
|
|
77
98
|
};
|
|
99
|
+
legendHistory: {
|
|
100
|
+
default: boolean;
|
|
101
|
+
};
|
|
78
102
|
legendInset: {};
|
|
79
103
|
legendInsetConfig: {
|
|
80
104
|
merge: true;
|
|
@@ -110,6 +134,15 @@ declare const fields: {
|
|
|
110
134
|
coerce: "const";
|
|
111
135
|
};
|
|
112
136
|
noDataMessage: {};
|
|
137
|
+
pointLabelConfig: {
|
|
138
|
+
merge: true;
|
|
139
|
+
default: {
|
|
140
|
+
fontMin: number;
|
|
141
|
+
fontSize: number;
|
|
142
|
+
padding: number;
|
|
143
|
+
};
|
|
144
|
+
};
|
|
145
|
+
reducedMotion: {};
|
|
113
146
|
saveControl: {};
|
|
114
147
|
saveControlClassName: {};
|
|
115
148
|
saveControlConfig: {
|
|
@@ -159,6 +192,7 @@ declare const fields: {
|
|
|
159
192
|
tableViewDownload: {};
|
|
160
193
|
tableViewPageSize: {};
|
|
161
194
|
tableViewSort: {};
|
|
195
|
+
theme: {};
|
|
162
196
|
thresholdName: {
|
|
163
197
|
coerce: "const";
|
|
164
198
|
};
|
|
@@ -199,9 +233,12 @@ declare const fields: {
|
|
|
199
233
|
zoomBrushSelectionStyle: {};
|
|
200
234
|
zoomControlClassName: {};
|
|
201
235
|
zoomControlIcons: {};
|
|
236
|
+
zoomControls: {};
|
|
202
237
|
zoomControlStyle: {};
|
|
203
238
|
zoomControlStyleActive: {};
|
|
204
239
|
zoomControlStyleHover: {};
|
|
240
|
+
zoomDoubleClick: {};
|
|
241
|
+
zoomDrag: {};
|
|
205
242
|
zoomFactor: {};
|
|
206
243
|
zoomMax: {};
|
|
207
244
|
zoomPadding: {};
|
|
@@ -2,7 +2,8 @@ import type Viz from "./Viz.js";
|
|
|
2
2
|
/**
|
|
3
3
|
Draws the visualization given the specified configuration.
|
|
4
4
|
@param viz The Viz instance to render.
|
|
5
|
-
@param callback Optional callback invoked after rendering completes
|
|
5
|
+
@param callback Optional callback invoked after rendering completes, and
|
|
6
|
+
after every later render that doesn't pass one of its own.
|
|
6
7
|
@private
|
|
7
8
|
*/
|
|
8
9
|
export declare function vizRender(viz: Viz, callback?: () => void): Viz;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Resolves a chart's `theme` once per draw and hands it to the chart's
|
|
3
|
+
components, and paints a forced theme's background into the scene.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
import type { PathNode, RectNode, SceneNode } from "@d3plus/render";
|
|
8
|
+
import type { ResolvedTheme, ThemeOverlayTokens } from "../../utils/theme.js";
|
|
9
|
+
import { unwatchPageTheme } from "./pageTheme.js";
|
|
10
|
+
export { unwatchPageTheme };
|
|
11
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
12
|
+
/**
|
|
13
|
+
Resolves the chart's theme for this draw onto `viz._theme` and its
|
|
14
|
+
components, and keeps an `"auto"` chart watching its page for a flip
|
|
15
|
+
between light and dark (a forced theme stops watching).
|
|
16
|
+
*/
|
|
17
|
+
export declare function applyVizTheme(viz: VizInstance): ResolvedTheme;
|
|
18
|
+
type BackgroundTarget = Pick<VizInstance, "_theme" | "schema"> & Partial<Pick<VizInstance, "_margin" | "_ssr" | "_tileGroup">>;
|
|
19
|
+
/**
|
|
20
|
+
The scene node a forced theme paints behind the chart, if it has one: a
|
|
21
|
+
rect over the whole chart, framing (not covering) a Geomap's basemap.
|
|
22
|
+
*/
|
|
23
|
+
export declare function themeBackgroundNode(viz: BackgroundTarget): RectNode | PathNode | undefined;
|
|
24
|
+
/** The forced theme's background rect, as the scene's first children. */
|
|
25
|
+
export declare function themeBackground(viz: BackgroundTarget): SceneNode[];
|
|
26
|
+
/**
|
|
27
|
+
The `color-scheme` the chart's overlays use, so their native controls
|
|
28
|
+
(buttons, the search input, the download menu) match the theme: the
|
|
29
|
+
theme's own when forced or dark, and the page's otherwise.
|
|
30
|
+
*/
|
|
31
|
+
export declare function themeColorScheme(theme: ResolvedTheme | undefined): string;
|
|
32
|
+
/** Sets the chart's overlay host's `color-scheme` (see `themeColorScheme`). */
|
|
33
|
+
export declare function applyOverlayColorScheme(viz: Pick<VizInstance, "_theme" | "_sceneRenderer">): void;
|
|
34
|
+
/**
|
|
35
|
+
An overlay style with each entry still at its built-in default swapped for
|
|
36
|
+
the theme's overlay color: `keys` maps a CSS property to the overlay token
|
|
37
|
+
it takes, and `format` wraps a token (`1px solid …`). Light charts keep
|
|
38
|
+
the built-in style (see `themed`).
|
|
39
|
+
*/
|
|
40
|
+
export declare function themeOverlayStyle<T extends Record<string, unknown>>(viz: Pick<VizInstance, "_theme">, style: T, defaults: Record<string, unknown>, keys: Record<string, (overlay: ThemeOverlayTokens) => string>): T;
|
|
@@ -21,6 +21,7 @@
|
|
|
21
21
|
@module
|
|
22
22
|
*/
|
|
23
23
|
import type { PlotZoomBase, ZoomState } from "../Plot/plotZoom.js";
|
|
24
|
+
import type { GestureHoverState, ZoomGesture } from "../drawSteps/zoomGesture.js";
|
|
24
25
|
import type { TrendFit, TrendLineType } from "../Plot/trendLines.js";
|
|
25
26
|
import type { SwarmState } from "../Plot/swarm.js";
|
|
26
27
|
import type { ShapeEmitter } from "../features/shapeEmit.js";
|
|
@@ -31,8 +32,12 @@ import type { AxisHoverState } from "../Plot/axisHover.js";
|
|
|
31
32
|
import type { ZoomControlIconKey } from "../drawSteps/zoomControlsMarkup.js";
|
|
32
33
|
import type { BottomRightBox } from "../drawSteps/bottomRightControlsMarkup.js";
|
|
33
34
|
import type { ZoomTransform } from "d3-zoom";
|
|
35
|
+
import type { KeyboardNavState } from "./keyboardNav.js";
|
|
36
|
+
import type { KeyboardGesture } from "./keyboardNavHost.js";
|
|
37
|
+
import type { NearestHoverState } from "./nearestHover.js";
|
|
38
|
+
import type { ResolvedTheme } from "../../utils/theme.js";
|
|
34
39
|
import type { DataPoint } from "@d3plus/data";
|
|
35
|
-
import type { ClipShape, Scene, SceneNode, Transform, TransitionRect } from "@d3plus/render";
|
|
40
|
+
import type { ClipShape, Scene, SceneEvent, SceneNode, Transform, TransitionRect } from "@d3plus/render";
|
|
36
41
|
import type { Axis, ColorScale, Legend, Message, SizeLegend, TextBox, Timeline, Tooltip } from "../../components/index.js";
|
|
37
42
|
import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
|
|
38
43
|
import type { InsetKey, InsetPlacement, InsetRegion } from "../features/insetState.js";
|
|
@@ -56,15 +61,29 @@ export interface Padding {
|
|
|
56
61
|
left: number;
|
|
57
62
|
right: number;
|
|
58
63
|
}
|
|
59
|
-
/**
|
|
64
|
+
/** A drill-down entry on the Back history (`Viz._history`), pushed by a click.shape drill-down or a partition zoom and popped by Back. */
|
|
60
65
|
export interface DrillDownHistoryEntry {
|
|
66
|
+
kind?: "drill";
|
|
61
67
|
depth: number;
|
|
62
68
|
filter?: (d: DataPoint, i: number) => boolean;
|
|
63
69
|
/** `groupBy[groupDepth]`'s value for the clicked node — identifies the reunion node the Back morph grows back into. */
|
|
64
70
|
groupId?: unknown;
|
|
65
71
|
/** The groupBy index `groupId` was read at (== `_drawDepth` when the node was clicked). */
|
|
66
72
|
groupDepth?: number;
|
|
73
|
+
/** The legend's hide/solo state a drill to a deeper level cleared, which Back puts back. */
|
|
74
|
+
legend?: LegendState;
|
|
67
75
|
}
|
|
76
|
+
/** The legend's hide/solo state: the legend ids hidden, and the ones shown alone. */
|
|
77
|
+
export interface LegendState {
|
|
78
|
+
hidden: (string | number)[];
|
|
79
|
+
solo: (string | number)[];
|
|
80
|
+
}
|
|
81
|
+
/** A legend entry on the Back history (`Viz._history`): the legend's hide/solo state before a legend click changed it. */
|
|
82
|
+
export interface LegendHistoryEntry extends LegendState {
|
|
83
|
+
kind: "legend";
|
|
84
|
+
}
|
|
85
|
+
/** One entry on the Back history (`Viz._history`). */
|
|
86
|
+
export type HistoryEntry = DrillDownHistoryEntry | LegendHistoryEntry;
|
|
68
87
|
/**
|
|
69
88
|
D3-style selection — deliberately loose. d3-selection's element/datum
|
|
70
89
|
generics are invariant, so a single typed alias can't accept every
|
|
@@ -139,6 +158,17 @@ export interface VizInstance {
|
|
|
139
158
|
passes such rows without running `filter` on them again.
|
|
140
159
|
*/
|
|
141
160
|
_filterApplied?: (d: DataPoint) => boolean;
|
|
161
|
+
/**
|
|
162
|
+
Shapes whose rows the pipeline keeps one by one instead of merging the
|
|
163
|
+
rows that share a group (Hexbin's observations, which it bins).
|
|
164
|
+
*/
|
|
165
|
+
_unmergedShapes?: string[];
|
|
166
|
+
/**
|
|
167
|
+
The rows the colorScale lays out from, for a chart whose colored marks
|
|
168
|
+
aren't its rows (Hexbin's bins). The chart's rows rolled up by group
|
|
169
|
+
when unset.
|
|
170
|
+
*/
|
|
171
|
+
_colorScaleRows?: () => DataPoint[];
|
|
142
172
|
_timeFilter?: (d: DataPoint, i: number) => boolean;
|
|
143
173
|
_groupBy: ((d: DataPoint, i: number) => DataPoint[keyof DataPoint])[];
|
|
144
174
|
_depth?: number;
|
|
@@ -168,6 +198,11 @@ export interface VizInstance {
|
|
|
168
198
|
_x2Config?: Record<string, unknown>;
|
|
169
199
|
_y2Config?: Record<string, unknown>;
|
|
170
200
|
_backgroundConfig?: Record<string, unknown>;
|
|
201
|
+
/**
|
|
202
|
+
Whether a chart other than a Plot can name every series along it, so
|
|
203
|
+
its default legend may stand aside (see `Plot/alongLegend.ts`).
|
|
204
|
+
*/
|
|
205
|
+
_alongLabelsPossible?: (viz: VizInstance) => boolean;
|
|
171
206
|
_chartScene?: SceneNode[];
|
|
172
207
|
/** The whole scene last painted (chart, legend, colorScale, chrome). */
|
|
173
208
|
_paintedScene?: Scene;
|
|
@@ -196,6 +231,17 @@ export interface VizInstance {
|
|
|
196
231
|
returns false to fall back to picture zoom (Plot rescales its axes).
|
|
197
232
|
*/
|
|
198
233
|
_zoomRescale?: (t: ZoomState, duration?: number) => boolean;
|
|
234
|
+
/** Chart-specific handling of zoom gestures (Geomap turns a globe on a drag). */
|
|
235
|
+
_zoomGesture?: ZoomGesture;
|
|
236
|
+
/** The zoom gesture holding off tooltips and hover, while one is in progress. */
|
|
237
|
+
_gestureHover?: GestureHoverState;
|
|
238
|
+
/** Whether a globe drag is turning the map (Geomap skips refitting meanwhile). */
|
|
239
|
+
_globeDragging?: boolean;
|
|
240
|
+
/** The rotation a Geomap globe had before it was first dragged, with its projection. */
|
|
241
|
+
_globeHome?: {
|
|
242
|
+
projection: unknown;
|
|
243
|
+
rotate: number[];
|
|
244
|
+
};
|
|
199
245
|
/** Cleanup functions returned by `zoomControlIcons`' mount functions, keyed by button. */
|
|
200
246
|
_zoomIconCleanup?: Partial<Record<ZoomControlIconKey, () => void>>;
|
|
201
247
|
/** Cleanup function returned by an `attributionIcon` mount function. */
|
|
@@ -205,10 +251,28 @@ export interface VizInstance {
|
|
|
205
251
|
_duration: number;
|
|
206
252
|
_renderer?: "svg" | "canvas";
|
|
207
253
|
_focus?: string | number | undefined;
|
|
254
|
+
/**
|
|
255
|
+
Runs when a click lands on no mark, given its point on the chart's
|
|
256
|
+
surface (see `routePointerEvent`): a Network or ArcDiagram clears its
|
|
257
|
+
focus there.
|
|
258
|
+
*/
|
|
259
|
+
_backgroundClick?: (point: [number, number]) => void;
|
|
208
260
|
_active?: ((d: DataPoint, i?: number) => boolean) | false;
|
|
209
261
|
_hover?: ((d: DataPoint, i?: number) => boolean) | false;
|
|
262
|
+
/**
|
|
263
|
+
The marks a hover stands for when its predicate lights more of them
|
|
264
|
+
(a Matrix cell lights its whole row and column): while `hover` is the
|
|
265
|
+
current hover, `hoverMatch` labels follow `rows` instead of every
|
|
266
|
+
matched mark.
|
|
267
|
+
*/
|
|
268
|
+
_hoverFocus?: {
|
|
269
|
+
hover: (d: DataPoint, i: number) => boolean;
|
|
270
|
+
rows: DataPoint[];
|
|
271
|
+
};
|
|
210
272
|
/** True while the current hover came from a colorScale bucket swatch. */
|
|
211
273
|
_hoverBucket?: boolean;
|
|
274
|
+
/** The colorScale bucket a hovered swatch label lights (see `handleSwatchLabelHover`). */
|
|
275
|
+
_swatchLabelBucket?: DataPoint;
|
|
212
276
|
/**
|
|
213
277
|
Hovering a shape outlines it even when nothing else dims
|
|
214
278
|
(`hoverOpacity` 1), as Calendar's days do (see `shapeHoverEnabled`).
|
|
@@ -231,6 +295,10 @@ export interface VizInstance {
|
|
|
231
295
|
_hoverDatum?: DataPoint | null;
|
|
232
296
|
/** Epoch ms until which an animated transition is in flight (pointer routing pauses). */
|
|
233
297
|
_transitionEndsAt?: number;
|
|
298
|
+
/** Keyboard navigation's host element and focused mark (see `keyboardNav.ts`). */
|
|
299
|
+
_keyboardNav?: KeyboardNavState;
|
|
300
|
+
/** A chart's own keys, taken before mark navigation (Geomap's globe keys). */
|
|
301
|
+
_keyboardGesture?: KeyboardGesture;
|
|
234
302
|
_userHover?: number;
|
|
235
303
|
_userDuration?: number;
|
|
236
304
|
_brushing?: boolean;
|
|
@@ -257,8 +325,8 @@ export interface VizInstance {
|
|
|
257
325
|
_trailSeq?: number;
|
|
258
326
|
/** The user-set data, retained to detect changes across `.data()` calls. */
|
|
259
327
|
_userData?: DataPoint[] | string;
|
|
260
|
-
/**
|
|
261
|
-
_history?:
|
|
328
|
+
/** The Back history: drill-downs and legend clicks, newest last. */
|
|
329
|
+
_history?: HistoryEntry[];
|
|
262
330
|
/**
|
|
263
331
|
The local, chart-family-defined "body rect" flip-morph fractions are
|
|
264
332
|
measured against — e.g. Treemap/Pack's margin-adjusted chart area at
|
|
@@ -418,6 +486,8 @@ export interface VizInstance {
|
|
|
418
486
|
_stackOffset?: (series: number[][][], order: number[]) => void;
|
|
419
487
|
/** d3-stack order: an accessor, or an explicit array of series keys. */
|
|
420
488
|
_stackOrder?: ((series: number[][][]) => number[]) | unknown[];
|
|
489
|
+
/** The series of the last stacked draw in reading order, which the default legend follows (see `Plot/stackLegendOrder.ts`). */
|
|
490
|
+
_stackLegendOrder?: string[];
|
|
421
491
|
/** The `confidence` bounds as `[lower, upper]` accessors (either may be `false`), or `false` when off. */
|
|
422
492
|
_confidence?: [
|
|
423
493
|
ConfidenceAccessor | false,
|
|
@@ -429,7 +499,6 @@ export interface VizInstance {
|
|
|
429
499
|
_groupPadding?: number;
|
|
430
500
|
_annotations?: Record<string, unknown>[];
|
|
431
501
|
_axisPersist?: boolean;
|
|
432
|
-
_labelPosition?: (d: DataPoint, i: number) => "auto" | "inside" | "outside";
|
|
433
502
|
_labelConnectorConfig?: Record<string, unknown>;
|
|
434
503
|
_lineMarkerConfig?: Record<string, unknown>;
|
|
435
504
|
_confidenceConfig?: Record<string, unknown>;
|
|
@@ -511,8 +580,20 @@ export interface VizInstance {
|
|
|
511
580
|
_legendDepth?: number;
|
|
512
581
|
/** The color category each legend entry stands for, when the legend is labelled by color rather than groupBy. */
|
|
513
582
|
_legendCategories?: WeakMap<DataPoint, string>;
|
|
583
|
+
/** The legend setting the chart starts with, which along labels may hide (see `Plot/alongLegend.ts`). */
|
|
584
|
+
_defaultLegend?: unknown;
|
|
585
|
+
/** Whether this draw hides the default legend for along labels. */
|
|
586
|
+
_alongLegendHide?: boolean;
|
|
587
|
+
/** This draw's along label counts (see `Plot/alongLegend.ts`). */
|
|
588
|
+
_alongStats?: {
|
|
589
|
+
series: number;
|
|
590
|
+
requested: number;
|
|
591
|
+
placed: number;
|
|
592
|
+
};
|
|
514
593
|
_colorScalePosition?: (config: VizInstance) => string | false;
|
|
515
594
|
_colorScale?: false | string | ((d: DataPoint, i: number) => string);
|
|
595
|
+
/** False when the chart's tooltip already shows its colorScale value (see `ChartDefinition.colorScaleTooltip`). */
|
|
596
|
+
_colorScaleTooltip?: boolean;
|
|
516
597
|
_timeline?: boolean;
|
|
517
598
|
_total?: boolean | ((d: DataPoint[], i: number) => number);
|
|
518
599
|
_container?: D3Selection;
|
|
@@ -530,8 +611,10 @@ export interface VizInstance {
|
|
|
530
611
|
_zoomSet?: boolean;
|
|
531
612
|
/** Whether a Geomap's themed basemap resolved dark on the latest draw. */
|
|
532
613
|
_basemapDark?: boolean;
|
|
533
|
-
/**
|
|
534
|
-
|
|
614
|
+
/** The chart's theme, resolved on its latest draw (see `applyVizTheme`). */
|
|
615
|
+
_theme?: ResolvedTheme;
|
|
616
|
+
/** Stops the `"auto"` theme's page watcher, while one is installed. */
|
|
617
|
+
_themeWatch?: () => void;
|
|
535
618
|
/** The attribution d3plus last set from the tile URL (vs. a user-set one). */
|
|
536
619
|
_tileAttribution?: string | false;
|
|
537
620
|
/** Whether a compact (ⓘ) attribution was clicked open. */
|
|
@@ -560,6 +643,12 @@ export interface VizInstance {
|
|
|
560
643
|
/** Plot's paint phase: builds `_chartScene` from the measured context. */
|
|
561
644
|
_paint?(pCtx: PlotPaintContext): VizInstance;
|
|
562
645
|
_drawSceneToTarget(durationOverride?: number): void;
|
|
646
|
+
/** Whether a painted node is a point mark nearest-point hover resolves to (see `hoverDistance`). */
|
|
647
|
+
_pointMark?(node: SceneNode): boolean;
|
|
648
|
+
/** Nearest-point hover's cached diagrams and resolved mark (see `nearestHover.ts`). */
|
|
649
|
+
_nearestHover?: NearestHoverState;
|
|
650
|
+
/** Routes a renderer pointer event (or a replayed one) to the chart's handlers. */
|
|
651
|
+
_routeSceneEvent?(event: SceneEvent): void;
|
|
563
652
|
_scheduleSceneRepaint(): void;
|
|
564
653
|
_sceneRepaintRAF?: number;
|
|
565
654
|
_thresholdLegend?(legendData: DataPoint[]): DataPoint[];
|
|
@@ -571,8 +660,12 @@ export interface VizInstance {
|
|
|
571
660
|
}): SizeLegendScale | null;
|
|
572
661
|
/** The region chart chrome may be drawn inside, with the chart's marks as obstacles (see `ChartDefinition.insetRegion`). */
|
|
573
662
|
_insetRegion?(): InsetRegion | null;
|
|
663
|
+
/** The table view's rows in place of the chart's data (see `ChartDefinition.tableData`). */
|
|
664
|
+
_tableData?(): DataPoint[] | null;
|
|
574
665
|
/** The shape a colorScale row draws as (see `ChartDefinition.colorScaleShape`). */
|
|
575
666
|
_colorScaleShape?(d: DataPoint, i: number): string;
|
|
667
|
+
/** The `groupBy` level a shape's row stands for (see `ChartDefinition.shapeDepth`). */
|
|
668
|
+
_shapeDepth?(d: DataPoint): number | undefined;
|
|
576
669
|
/** The chart's small-multiple hooks (see `ChartDefinition.facet`). */
|
|
577
670
|
_facetHooks?(): FacetHooks;
|
|
578
671
|
toScene?(): SceneNode;
|