@d3plus/core 4.9.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +170 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +17 -12
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Funnel/index.js +2 -1
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Gauge/index.js +2 -1
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +60 -19
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +37 -16
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/index.js +3 -2
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +93 -108
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +7 -2
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +66 -32
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +14 -4
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +5 -5
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +65 -30
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +75 -77
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +42 -15
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +123 -0
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +34 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +67 -79
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/facet/facetData.d.ts +1 -1
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +13 -1
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/features.d.ts +8 -0
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +19 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/missingFields.d.ts +57 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +2 -8
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,83 @@
|
|
|
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
|
+
*/ import { isDarkColor } from "../../utils/theme.js";
|
|
7
|
+
const WHITE = "rgb(255, 255, 255)";
|
|
8
|
+
/** Whether a computed background paints anything. */ const opaque = (bg)=>Boolean(bg) && bg !== "transparent" && bg !== "rgba(0, 0, 0, 0)";
|
|
9
|
+
/**
|
|
10
|
+
The page behind the chart: the first non-transparent background among its
|
|
11
|
+
ancestors decides, or, when none sets one, the browser's own page canvas,
|
|
12
|
+
which is dark only when the page opts into a dark `color-scheme` and the
|
|
13
|
+
system prefers dark. Server renders are light.
|
|
14
|
+
*/ export function pageTheme(viz) {
|
|
15
|
+
if (viz._ssr || typeof window === "undefined" || typeof getComputedStyle !== "function") return {
|
|
16
|
+
dark: false,
|
|
17
|
+
background: WHITE
|
|
18
|
+
};
|
|
19
|
+
let node = viz._select?.node?.() ?? null;
|
|
20
|
+
while(node){
|
|
21
|
+
const bg = getComputedStyle(node).backgroundColor;
|
|
22
|
+
if (opaque(bg)) return {
|
|
23
|
+
dark: isDarkColor(bg),
|
|
24
|
+
background: bg
|
|
25
|
+
};
|
|
26
|
+
node = node.parentElement;
|
|
27
|
+
}
|
|
28
|
+
const scheme = getComputedStyle(document.documentElement).colorScheme || "";
|
|
29
|
+
const dark = scheme.includes("dark") && (!scheme.includes("light") || typeof matchMedia === "function" && matchMedia("(prefers-color-scheme: dark)").matches);
|
|
30
|
+
return dark ? {
|
|
31
|
+
dark
|
|
32
|
+
} : {
|
|
33
|
+
dark,
|
|
34
|
+
background: WHITE
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
/** Whether the chart sits on a dark page (see `pageTheme`). */ export function pageIsDark(viz) {
|
|
38
|
+
return pageTheme(viz).dark;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
Calls `onFlip` whenever the page might have changed theme: on a system
|
|
42
|
+
theme change, when the page flips a class/attribute/style on `<html>` or
|
|
43
|
+
`<body>` (how most theme toggles work), or when a background transition
|
|
44
|
+
ends. Returns the unsubscribe.
|
|
45
|
+
*/ export function watchPage(onFlip) {
|
|
46
|
+
if (typeof window === "undefined" || typeof document === "undefined") return ()=>undefined;
|
|
47
|
+
const media = typeof matchMedia === "function" ? matchMedia("(prefers-color-scheme: dark)") : null;
|
|
48
|
+
media?.addEventListener?.("change", onFlip);
|
|
49
|
+
const observer = typeof MutationObserver === "function" ? new MutationObserver(onFlip) : null;
|
|
50
|
+
for (const el of [
|
|
51
|
+
document.documentElement,
|
|
52
|
+
document.body
|
|
53
|
+
])if (el) observer?.observe(el, {
|
|
54
|
+
attributes: true
|
|
55
|
+
});
|
|
56
|
+
// A page that animates its background lands on the new color only once the
|
|
57
|
+
// transition ends.
|
|
58
|
+
const onTransition = (event)=>{
|
|
59
|
+
if (/background/.test(event.propertyName || "")) onFlip();
|
|
60
|
+
};
|
|
61
|
+
document.addEventListener("transitionend", onTransition);
|
|
62
|
+
return ()=>{
|
|
63
|
+
media?.removeEventListener?.("change", onFlip);
|
|
64
|
+
observer?.disconnect();
|
|
65
|
+
document.removeEventListener("transitionend", onTransition);
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
Keeps an `"auto"` themed chart in step with its page: redraws it when the
|
|
70
|
+
page's dark state differs from the one it last drew with. Installed once
|
|
71
|
+
per chart; `unwatchPageTheme` removes it.
|
|
72
|
+
*/ export function watchPageTheme(viz) {
|
|
73
|
+
if (viz._themeWatch || viz._ssr || typeof window === "undefined") return;
|
|
74
|
+
viz._themeWatch = watchPage(()=>{
|
|
75
|
+
const host = viz._select?.node?.();
|
|
76
|
+
if (!host || !host.isConnected || !viz._theme || viz._theme.painted) return;
|
|
77
|
+
if (pageIsDark(viz) !== viz._theme.dark) viz.render?.();
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
/** Stops a chart's page-theme watcher, if it has one. */ export function unwatchPageTheme(viz) {
|
|
81
|
+
viz._themeWatch?.();
|
|
82
|
+
viz._themeWatch = undefined;
|
|
83
|
+
}
|
|
@@ -0,0 +1,59 @@
|
|
|
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
|
+
*/ import { pointTarget } from "./nearestHover.js";
|
|
9
|
+
/**
|
|
10
|
+
The client position of the drawing surface's origin: the scene `<svg>`'s
|
|
11
|
+
user-space origin (read off its screen CTM: a nested svg's bounding rect
|
|
12
|
+
is the box of its painted content), or the `<canvas>`'s corner. Falls
|
|
13
|
+
back to the chart's own element, then to the viewport origin.
|
|
14
|
+
*/ export function surfaceOrigin(viz) {
|
|
15
|
+
const elements = viz._sceneRenderer?.elements?.() ?? [];
|
|
16
|
+
const surface = elements.find((el)=>el.localName === "svg" || el.localName === "canvas") ?? viz._select?.node?.();
|
|
17
|
+
if (!surface) return {
|
|
18
|
+
left: 0,
|
|
19
|
+
top: 0
|
|
20
|
+
};
|
|
21
|
+
const ctm = surface.localName === "svg" && typeof surface.getScreenCTM === "function" ? surface.getScreenCTM() : null;
|
|
22
|
+
if (ctm) return {
|
|
23
|
+
left: ctm.e,
|
|
24
|
+
top: ctm.f
|
|
25
|
+
};
|
|
26
|
+
const rect = surface.getBoundingClientRect();
|
|
27
|
+
return {
|
|
28
|
+
left: rect.left,
|
|
29
|
+
top: rect.top
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
A tooltip anchor (a Floating UI virtual element) for a box in surface
|
|
34
|
+
coordinates, moved to client coordinates by `origin`.
|
|
35
|
+
*/ export function clientAnchor(box, origin) {
|
|
36
|
+
const x = origin.left + box.x, y = origin.top + box.y;
|
|
37
|
+
const rect = {
|
|
38
|
+
x,
|
|
39
|
+
y,
|
|
40
|
+
left: x,
|
|
41
|
+
top: y,
|
|
42
|
+
right: x + box.width,
|
|
43
|
+
bottom: y + box.height,
|
|
44
|
+
width: box.width,
|
|
45
|
+
height: box.height
|
|
46
|
+
};
|
|
47
|
+
return {
|
|
48
|
+
getBoundingClientRect: ()=>rect
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
The tooltip anchor for a hovered node: its point mark's painted box when
|
|
53
|
+
nearest-point hover applies to it (see `pointTarget`), whether the
|
|
54
|
+
pointer is on the mark or only near it. Undefined otherwise, for the
|
|
55
|
+
tooltip to follow the pointer.
|
|
56
|
+
*/ export function pointTooltipAnchor(viz, node) {
|
|
57
|
+
const target = pointTarget(viz, node);
|
|
58
|
+
return target ? clientAnchor(target.box, surfaceOrigin(viz)) : undefined;
|
|
59
|
+
}
|
|
@@ -0,0 +1,124 @@
|
|
|
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
|
+
*/ import { Delaunay } from "d3-delaunay";
|
|
8
|
+
/** The smallest box holding `bounds` and every point. */ function grownBounds(points, bounds) {
|
|
9
|
+
let x0 = bounds.x, y0 = bounds.y, x1 = bounds.x + bounds.width, y1 = bounds.y + bounds.height;
|
|
10
|
+
for (const p of points){
|
|
11
|
+
x0 = Math.min(x0, p.x);
|
|
12
|
+
y0 = Math.min(y0, p.y);
|
|
13
|
+
x1 = Math.max(x1, p.x);
|
|
14
|
+
y1 = Math.max(y1, p.y);
|
|
15
|
+
}
|
|
16
|
+
return {
|
|
17
|
+
x: x0,
|
|
18
|
+
y: y0,
|
|
19
|
+
width: x1 - x0,
|
|
20
|
+
height: y1 - y0
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
/** The distance from `[x, y]` to the segment `a`–`b`. */ function segmentDistance(x, y, [ax, ay], [bx, by]) {
|
|
24
|
+
const dx = bx - ax, dy = by - ay;
|
|
25
|
+
const len = dx * dx + dy * dy;
|
|
26
|
+
const t = len ? Math.max(0, Math.min(1, ((x - ax) * dx + (y - ay) * dy) / len)) : 0;
|
|
27
|
+
return Math.hypot(x - (ax + t * dx), y - (ay + t * dy));
|
|
28
|
+
}
|
|
29
|
+
/** The distance from `[x, y]` to a polygon (0 inside it). */ export function polygonDistance(x, y, ring) {
|
|
30
|
+
let inside = false, min = Infinity;
|
|
31
|
+
for(let i = 0, j = ring.length - 1; i < ring.length; j = i++){
|
|
32
|
+
const [xi, yi] = ring[i], [xj, yj] = ring[j];
|
|
33
|
+
if (yi > y !== yj > y && x < (xj - xi) * (y - yi) / (yj - yi) + xi) inside = !inside;
|
|
34
|
+
min = Math.min(min, segmentDistance(x, y, ring[j], ring[i]));
|
|
35
|
+
}
|
|
36
|
+
return inside ? 0 : min;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
Builds a Voronoi diagram over `points` (with d3-delaunay), clipped to
|
|
40
|
+
`bounds`. Points with a non-finite coordinate are left out of the
|
|
41
|
+
diagram: `nearest` never returns them and their `cell` is null. The
|
|
42
|
+
Delaunay triangulation is built up front; the clipped cells only on the
|
|
43
|
+
first call that needs them.
|
|
44
|
+
@param points The points, in surface coordinates.
|
|
45
|
+
@param bounds The box to clip cells to (grown to hold every point).
|
|
46
|
+
*/ export function pointVoronoi(points, bounds) {
|
|
47
|
+
const valid = points.map((_, i)=>i).filter((i)=>Number.isFinite(points[i].x) && Number.isFinite(points[i].y));
|
|
48
|
+
const box = grownBounds(valid.map((i)=>points[i]), bounds);
|
|
49
|
+
const delaunay = Delaunay.from(valid, (i)=>points[i].x, (i)=>points[i].y);
|
|
50
|
+
// Positions in `valid` (the diagram's own indices) for each input index.
|
|
51
|
+
const slot = new Map(valid.map((i, s)=>[
|
|
52
|
+
i,
|
|
53
|
+
s
|
|
54
|
+
]));
|
|
55
|
+
const radius = (p)=>Number.isFinite(p.r) ? Math.max(0, p.r) : 0;
|
|
56
|
+
const maxRadius = valid.reduce((m, i)=>Math.max(m, radius(points[i])), 0);
|
|
57
|
+
let voronoi;
|
|
58
|
+
const diagram = ()=>voronoi ??= delaunay.voronoi([
|
|
59
|
+
box.x,
|
|
60
|
+
box.y,
|
|
61
|
+
box.x + box.width,
|
|
62
|
+
box.y + box.height
|
|
63
|
+
]);
|
|
64
|
+
const cellOf = (s)=>{
|
|
65
|
+
const polygon = diagram().cellPolygon(s);
|
|
66
|
+
return polygon ? polygon.slice(0, -1) : null;
|
|
67
|
+
};
|
|
68
|
+
const neighborSlots = (s)=>[
|
|
69
|
+
...delaunay.neighbors(s)
|
|
70
|
+
].filter((n)=>n >= 0);
|
|
71
|
+
const nearest = (x, y, maxDistance = Infinity)=>{
|
|
72
|
+
if (!valid.length || !Number.isFinite(x) || !Number.isFinite(y)) return null;
|
|
73
|
+
const start = delaunay.find(x, y);
|
|
74
|
+
const centerOf = (s)=>Math.hypot(points[valid[s]].x - x, points[valid[s]].y - y);
|
|
75
|
+
// Every point whose edge is within reach has its center within `reach`,
|
|
76
|
+
// so its cell meets the disk of that radius; those cells are connected,
|
|
77
|
+
// so a walk out from the nearest center finds them all.
|
|
78
|
+
const reach = maxDistance + maxRadius;
|
|
79
|
+
if (centerOf(start) > reach) return null;
|
|
80
|
+
let best = null, bestCenter = Infinity;
|
|
81
|
+
const seen = new Set([
|
|
82
|
+
start
|
|
83
|
+
]);
|
|
84
|
+
const queue = [
|
|
85
|
+
start
|
|
86
|
+
];
|
|
87
|
+
while(queue.length){
|
|
88
|
+
const s = queue.shift();
|
|
89
|
+
const index = valid[s];
|
|
90
|
+
const point = points[index];
|
|
91
|
+
const center = centerOf(s);
|
|
92
|
+
const distance = Math.max(0, center - radius(point));
|
|
93
|
+
if (distance <= maxDistance && (!best || distance < best.distance || distance === best.distance && (center < bestCenter || center === bestCenter && index < best.index))) {
|
|
94
|
+
best = {
|
|
95
|
+
index,
|
|
96
|
+
point,
|
|
97
|
+
distance
|
|
98
|
+
};
|
|
99
|
+
bestCenter = center;
|
|
100
|
+
}
|
|
101
|
+
for (const n of neighborSlots(s)){
|
|
102
|
+
if (seen.has(n)) continue;
|
|
103
|
+
seen.add(n);
|
|
104
|
+
const ring = cellOf(n);
|
|
105
|
+
if (ring && polygonDistance(x, y, ring) <= reach) queue.push(n);
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return best;
|
|
109
|
+
};
|
|
110
|
+
return {
|
|
111
|
+
points,
|
|
112
|
+
bounds: box,
|
|
113
|
+
nearest,
|
|
114
|
+
cell: (index)=>{
|
|
115
|
+
const s = slot.get(index);
|
|
116
|
+
return s === undefined ? null : cellOf(s);
|
|
117
|
+
},
|
|
118
|
+
neighbors: (index)=>{
|
|
119
|
+
const s = slot.get(index);
|
|
120
|
+
if (s === undefined) return [];
|
|
121
|
+
return neighborSlots(s).map((n)=>valid[n]).sort((a, b)=>a - b);
|
|
122
|
+
}
|
|
123
|
+
};
|
|
124
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/** The `reducedMotion` setting: follow the OS (`"auto"`), or force it on or off. */ /**
|
|
2
|
+
Whether the viewer's OS asks for reduced motion, read from the
|
|
3
|
+
`(prefers-reduced-motion: reduce)` media query. False without a `window`
|
|
4
|
+
or `matchMedia` (server-side rendering, older runtimes).
|
|
5
|
+
*/ export function prefersReducedMotion() {
|
|
6
|
+
if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
|
|
7
|
+
try {
|
|
8
|
+
return !!window.matchMedia("(prefers-reduced-motion: reduce)").matches;
|
|
9
|
+
} catch {
|
|
10
|
+
return false;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
Whether a chart draws without motion: `reducedMotion` `true` always,
|
|
15
|
+
`false` never, and `"auto"` (or unset) when the OS asks for it.
|
|
16
|
+
*/ export function motionReduced(host) {
|
|
17
|
+
const setting = host.schema.reducedMotion;
|
|
18
|
+
if (setting === true) return true;
|
|
19
|
+
if (setting === false) return false;
|
|
20
|
+
return prefersReducedMotion();
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
The transition duration a chart animates with: 0 when motion is reduced,
|
|
24
|
+
otherwise its `duration` (the stored `duration` is left as the user set it).
|
|
25
|
+
*/ export function effectiveDuration(host) {
|
|
26
|
+
return motionReduced(host) ? 0 : Number(host.schema.duration) || 0;
|
|
27
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Reports an error an event handler threw without interrupting the event:
|
|
3
|
+
`reportError` logs it as an uncaught error (with its stack) and fires the
|
|
4
|
+
window's `error` event, so the remaining handlers still run. Falls back to
|
|
5
|
+
`console.error` where `reportError` doesn't exist.
|
|
6
|
+
*/ export function reportHandlerError(error) {
|
|
7
|
+
const report = globalThis.reportError;
|
|
8
|
+
if (typeof report === "function") report(error);
|
|
9
|
+
else console.error(error);
|
|
10
|
+
}
|
|
@@ -10,6 +10,21 @@
|
|
|
10
10
|
x: raw
|
|
11
11
|
};
|
|
12
12
|
}
|
|
13
|
+
/** The shape class of a mark a chart emits as a bare scene node, without a `shapeType`. */ const nodeShapes = {
|
|
14
|
+
area: "Area",
|
|
15
|
+
circle: "Circle",
|
|
16
|
+
line: "Line",
|
|
17
|
+
path: "Path",
|
|
18
|
+
rect: "Rect"
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
A picked node's shape class: its stamped `shapeType`, else the shape its
|
|
22
|
+
node type draws (a Treemap tile is a `"Rect"`, a Geomap region a
|
|
23
|
+
`"Path"`). Text, images, and groups have none.
|
|
24
|
+
*/ export function nodeShapeType(node) {
|
|
25
|
+
if (typeof node.shapeType === "string") return node.shapeType;
|
|
26
|
+
return nodeShapes[node.type];
|
|
27
|
+
}
|
|
13
28
|
/**
|
|
14
29
|
The shape classes a picked chart node fires `"<event>.<shapeType>"`
|
|
15
30
|
handlers for: the shape that drew it, with the pick's own `(d, i, x)`, then
|
|
@@ -18,8 +33,9 @@
|
|
|
18
33
|
`.Box`, once each.
|
|
19
34
|
*/ export function shapeClassTargets(node, own) {
|
|
20
35
|
const targets = [];
|
|
21
|
-
|
|
22
|
-
|
|
36
|
+
const shapeType = nodeShapeType(node);
|
|
37
|
+
if (shapeType) targets.push({
|
|
38
|
+
shapeType,
|
|
23
39
|
...own
|
|
24
40
|
});
|
|
25
41
|
for (const owner of node.owners ?? []){
|
|
@@ -4,8 +4,10 @@ import { broadcastLink } from "./linkGroup.js";
|
|
|
4
4
|
(Chord, Network, Rings, Sankey): stores the predicate, hands it to the
|
|
5
5
|
legend, schedules a repaint so the scene's interaction-opacity pass
|
|
6
6
|
re-reads it, and broadcasts it to linked charts.
|
|
7
|
+
With no argument, returns the current predicate.
|
|
7
8
|
@param _ The hover predicate, or `false` to clear it.
|
|
8
9
|
*/ export function simpleHover(_) {
|
|
10
|
+
if (!arguments.length) return this._hover;
|
|
9
11
|
this._hover = _;
|
|
10
12
|
if (this.schema.legend && this._legendClass) this._legendClass.hover(_);
|
|
11
13
|
if (this._sceneRenderer) this._scheduleSceneRepaint();
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Where a chart's `className` goes: the element its pixels are drawn on, the
|
|
3
|
+
root `<svg class="d3plus-viz">` or, with the Canvas renderer, its
|
|
4
|
+
`<canvas>`. (With Canvas the root svg stays in place above the canvas for
|
|
5
|
+
the zoom brush, so it takes no classes: a background on it would hide the
|
|
6
|
+
chart.)
|
|
7
|
+
*/ import { RENDERER_CLASSES, rendererSurfaces } from "../../utils/className.js";
|
|
8
|
+
/** A chart's fixed root class. */ export const ROOT_CLASS = "d3plus-viz";
|
|
9
|
+
/**
|
|
10
|
+
The elements a chart's `className` applies to, each with the fixed
|
|
11
|
+
classes it keeps. Before the first render the chart's `select` is still the
|
|
12
|
+
page's own container, which never takes the classes.
|
|
13
|
+
@param root The chart's `select` node.
|
|
14
|
+
@param renderer The chart's scene renderer, once it has rendered.
|
|
15
|
+
@param kind The chart's renderer setting.
|
|
16
|
+
@private
|
|
17
|
+
*/ export function vizClassNameTargets(root, renderer, kind) {
|
|
18
|
+
if (kind === "canvas") return rendererSurfaces(renderer).filter((el)=>el.localName === "canvas").map((el)=>({
|
|
19
|
+
el,
|
|
20
|
+
keep: RENDERER_CLASSES
|
|
21
|
+
}));
|
|
22
|
+
const svg = typeof Element !== "undefined" && root instanceof Element && root.classList.contains(ROOT_CLASS) ? root : undefined;
|
|
23
|
+
return svg ? [
|
|
24
|
+
{
|
|
25
|
+
el: svg,
|
|
26
|
+
keep: [
|
|
27
|
+
ROOT_CLASS
|
|
28
|
+
]
|
|
29
|
+
}
|
|
30
|
+
] : [];
|
|
31
|
+
}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
import { isData, load } from "@d3plus/data";
|
|
2
|
+
import { warnConfig } from "../../utils/configWarnings.js";
|
|
3
|
+
import { createDataPoller } from "./dataPoller.js";
|
|
4
|
+
import { canObserveVisibility, observeVisibility } from "./vizVisibility.js";
|
|
5
|
+
import { displayName } from "../../utils/displayName.js";
|
|
6
|
+
/**
|
|
7
|
+
Whether a `data` value is fetched: a URL, a request object, or an Array
|
|
8
|
+
holding at least one of them.
|
|
9
|
+
@private
|
|
10
|
+
*/ export function isPollable(source) {
|
|
11
|
+
return source instanceof Array ? source.some(isData) : isData(source);
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
The paths a poll fetches: `source` as an Array, with each URL and request
|
|
15
|
+
object revalidated with the server (`cache: "no-cache"`) unless the request
|
|
16
|
+
sets its own `cache`.
|
|
17
|
+
@private
|
|
18
|
+
*/ export function pollPaths(source) {
|
|
19
|
+
const paths = source instanceof Array ? source : [
|
|
20
|
+
source
|
|
21
|
+
];
|
|
22
|
+
return paths.map((p)=>{
|
|
23
|
+
if (!isData(p)) return p;
|
|
24
|
+
if (typeof p === "string") return {
|
|
25
|
+
url: p,
|
|
26
|
+
cache: "no-cache"
|
|
27
|
+
};
|
|
28
|
+
const request = p;
|
|
29
|
+
return "cache" in request ? request : {
|
|
30
|
+
...request,
|
|
31
|
+
cache: "no-cache"
|
|
32
|
+
};
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
A short fingerprint of a JSON-serializable value (its JSON length plus a
|
|
37
|
+
32-bit FNV-1a hash), used to skip redrawing when a poll returns the same
|
|
38
|
+
data.
|
|
39
|
+
@private
|
|
40
|
+
*/ export function dataSignature(value) {
|
|
41
|
+
const json = JSON.stringify(value) ?? "";
|
|
42
|
+
let hash = 0x811c9dc5;
|
|
43
|
+
for(let i = 0; i < json.length; i++){
|
|
44
|
+
hash ^= json.charCodeAt(i);
|
|
45
|
+
hash = Math.imul(hash, 0x01000193);
|
|
46
|
+
}
|
|
47
|
+
return `${json.length}:${(hash >>> 0).toString(36)}`;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
Loads `source` the way `data()` does (the same formatter, and a formatter
|
|
51
|
+
may return `{data, ...config}`) without storing it on the chart.
|
|
52
|
+
@private
|
|
53
|
+
*/ function fetchPoll(viz, source, formatter) {
|
|
54
|
+
return new Promise((resolve, reject)=>{
|
|
55
|
+
let config;
|
|
56
|
+
const ctx = {
|
|
57
|
+
_cache: false,
|
|
58
|
+
_lrucache: viz._lrucache,
|
|
59
|
+
_data: [],
|
|
60
|
+
config: (obj)=>{
|
|
61
|
+
config = obj;
|
|
62
|
+
}
|
|
63
|
+
};
|
|
64
|
+
const paths = pollPaths(source);
|
|
65
|
+
load.call(ctx, paths, formatter, "data", (err, data)=>{
|
|
66
|
+
if (err) reject(err);
|
|
67
|
+
else resolve({
|
|
68
|
+
data: data ?? [],
|
|
69
|
+
config
|
|
70
|
+
});
|
|
71
|
+
});
|
|
72
|
+
});
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
Records the fingerprint of freshly loaded data, so a poll returning the
|
|
76
|
+
same data skips its redraw.
|
|
77
|
+
@private
|
|
78
|
+
*/ export function recordDataSignature(viz, data) {
|
|
79
|
+
viz._dataSignature = viz.schema.dataPollingInterval ? dataSignature(data) : undefined;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
Stops a chart's data polling and its visibility listeners.
|
|
83
|
+
@private
|
|
84
|
+
*/ export function stopDataPolling(viz) {
|
|
85
|
+
viz._dataPollStop?.();
|
|
86
|
+
viz._dataPollStop = undefined;
|
|
87
|
+
viz._dataPollFor = undefined;
|
|
88
|
+
}
|
|
89
|
+
/** The chart's `dataFormat`, which every poll runs. */ function dataFormatter(viz) {
|
|
90
|
+
const f = viz.schema.dataFormat;
|
|
91
|
+
return typeof f === "function" ? f : undefined;
|
|
92
|
+
}
|
|
93
|
+
/** What a running poll was started for; a change restarts it. */ function pollKey(viz) {
|
|
94
|
+
return [
|
|
95
|
+
viz.schema.dataPollingInterval,
|
|
96
|
+
viz._userData,
|
|
97
|
+
dataFormatter(viz),
|
|
98
|
+
viz.schema.detectVisible,
|
|
99
|
+
viz.schema.scrollContainer
|
|
100
|
+
];
|
|
101
|
+
}
|
|
102
|
+
/** Applies a poll's result and redraws, unless it matches the drawn data. */ function applyPoll(viz, { data, config }) {
|
|
103
|
+
const signature = dataSignature(data);
|
|
104
|
+
if (signature === viz._dataSignature) return;
|
|
105
|
+
viz._dataSignature = signature;
|
|
106
|
+
if (config) viz.config(config);
|
|
107
|
+
viz._data = data;
|
|
108
|
+
// A timeline the user hasn't brushed re-defaults, following a new latest period.
|
|
109
|
+
if (!viz.schema.timeFilter) viz._timelineSelection = false;
|
|
110
|
+
viz.render();
|
|
111
|
+
}
|
|
112
|
+
/** Starts polling `viz._userData` every `interval` ms. */ function startDataPolling(viz, interval) {
|
|
113
|
+
const source = viz._userData;
|
|
114
|
+
const formatter = dataFormatter(viz);
|
|
115
|
+
const doc = viz._select?.node()?.ownerDocument;
|
|
116
|
+
let offscreen = false;
|
|
117
|
+
const poller = createDataPoller({
|
|
118
|
+
interval,
|
|
119
|
+
fetch: ()=>fetchPoll(viz, source, formatter),
|
|
120
|
+
onData: (result)=>applyPoll(viz, result),
|
|
121
|
+
onError: (err)=>{
|
|
122
|
+
console.warn("d3plus: dataPollingInterval could not refresh the data; keeping the last data and retrying.", err);
|
|
123
|
+
},
|
|
124
|
+
paused: ()=>offscreen || doc?.visibilityState === "hidden"
|
|
125
|
+
});
|
|
126
|
+
const onVisibilityChange = ()=>{
|
|
127
|
+
if (doc?.visibilityState !== "hidden") poller.resume();
|
|
128
|
+
};
|
|
129
|
+
doc?.addEventListener("visibilitychange", onVisibilityChange);
|
|
130
|
+
const unobserve = viz.schema.detectVisible && canObserveVisibility() ? observeVisibility(viz._select.node(), viz.schema.scrollContainer, ()=>{
|
|
131
|
+
offscreen = false;
|
|
132
|
+
poller.resume();
|
|
133
|
+
}, 0, ()=>{
|
|
134
|
+
offscreen = true;
|
|
135
|
+
}) : undefined;
|
|
136
|
+
viz._dataPollFor = pollKey(viz);
|
|
137
|
+
viz._dataPollStop = ()=>{
|
|
138
|
+
poller.stop();
|
|
139
|
+
doc?.removeEventListener("visibilitychange", onVisibilityChange);
|
|
140
|
+
unobserve?.();
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
Starts, restarts or stops a drawn chart's data polling to match its
|
|
145
|
+
`dataPollingInterval` and `data`. A no-op while the poll it would start is
|
|
146
|
+
already running, and never polls during server-side rendering.
|
|
147
|
+
@private
|
|
148
|
+
*/ export function syncDataPolling(viz) {
|
|
149
|
+
const interval = viz.schema.dataPollingInterval;
|
|
150
|
+
const wanted = typeof interval === "number" && interval > 0 && isFinite(interval);
|
|
151
|
+
if (wanted && !isPollable(viz._userData)) {
|
|
152
|
+
warnConfig(`${displayName(viz)}: dataPollingInterval only polls data loaded from a URL.`);
|
|
153
|
+
}
|
|
154
|
+
if (!wanted || viz._ssr || !isPollable(viz._userData)) {
|
|
155
|
+
stopDataPolling(viz);
|
|
156
|
+
return;
|
|
157
|
+
}
|
|
158
|
+
const key = pollKey(viz);
|
|
159
|
+
const running = viz._dataPollFor;
|
|
160
|
+
if (running && running.every((v, i)=>v === key[i])) return;
|
|
161
|
+
stopDataPolling(viz);
|
|
162
|
+
startDataPolling(viz, interval);
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
Applies a `dataPollingInterval` change to a chart that has finished its
|
|
166
|
+
data load; a chart still loading starts polling once it draws.
|
|
167
|
+
@private
|
|
168
|
+
*/ export function onDataPollingIntervalSet(viz) {
|
|
169
|
+
if (!viz._dataPollStop && !viz._sceneRenderer) return;
|
|
170
|
+
if (viz._queue?.some((q)=>q[3] === "data")) return;
|
|
171
|
+
syncDataPolling(viz);
|
|
172
|
+
}
|