@d3plus/core 4.10.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +167 -8
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +3 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +2 -1
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +86 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +5 -1
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +64 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +8 -2
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +18 -10
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +34 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +2 -2
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -35
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +2 -3
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +16 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +3 -7
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +61 -28
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +72 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +10 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +8 -1
- package/es/src/charts/events/mousemove.shape.js +5 -2
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +2 -1
- package/es/src/charts/features/axesFinal.js +3 -1
- package/es/src/charts/features/axesMeasure.js +7 -4
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +2 -1
- package/es/src/charts/features/colorScaleHover.js +3 -2
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +20 -6
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +38 -11
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +47 -31
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +2 -2
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +39 -36
- package/es/src/charts/viz/VizBase.js +18 -10
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -3
- package/es/src/charts/viz/vizDefaults.js +15 -23
- package/es/src/charts/viz/vizFields.js +35 -0
- package/es/src/charts/viz/vizRender.js +43 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +6 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +5 -9
- package/es/src/components/Axis/axisLayoutScale.js +7 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +15 -9
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +29 -65
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +7 -3
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +25 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +250 -8
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +15 -8
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +16 -2
- package/types/src/charts/viz/VizBase.d.ts +6 -6
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +32 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +84 -7
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +1 -0
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +981 -30
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +86811 -61031
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +28392 -6498
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
package/es/src/charts/viz/Viz.js
CHANGED
|
@@ -12,13 +12,20 @@ import { unregisterLink } from "./linkGroup.js";
|
|
|
12
12
|
import { stopDataPolling } from "./vizDataPolling.js";
|
|
13
13
|
import { facetPanelAt, withFacetPanel } from "../facet/facetPanel.js";
|
|
14
14
|
import { vizRender } from "./vizRender.js";
|
|
15
|
+
import { motionReduced } from "./reducedMotion.js";
|
|
15
16
|
import { vizDraw } from "../pipeline/vizDraw.js";
|
|
16
17
|
import { vizPreDraw } from "../pipeline/vizPreDraw.js";
|
|
17
18
|
import { handlerDatum, shapeClassTargets } from "./shapeClassTargets.js";
|
|
18
19
|
import { reportHandlerError } from "./reportHandlerError.js";
|
|
19
20
|
import { vizClassNameTargets } from "./vizClassName.js";
|
|
21
|
+
import { themeBackground, unwatchPageTheme } from "./vizTheme.js";
|
|
22
|
+
import { stopVisibilityWatch } from "./vizVisibility.js";
|
|
20
23
|
import { applyClassName, withRootClasses } from "../../utils/className.js";
|
|
21
24
|
import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
25
|
+
import { appendFocusRing, syncKeyboardNav, teardownKeyboardNav } from "./keyboardNav.js";
|
|
26
|
+
import { mountTargetFor } from "./mountTarget.js";
|
|
27
|
+
import { routePointerEvent } from "./nearestHover.js";
|
|
28
|
+
import { nearestHoverSurface } from "./nearestHoverSurface.js";
|
|
22
29
|
/**
|
|
23
30
|
Stamps `interactionGroup` onto a component's scene subtree so the pointer
|
|
24
31
|
bridge can route its nodes to component-scoped handlers (e.g. legend) on
|
|
@@ -28,18 +35,10 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
28
35
|
const kids = node.children;
|
|
29
36
|
if (kids) for (const child of kids)tagInteractionGroup(child, group);
|
|
30
37
|
}
|
|
31
|
-
/**
|
|
32
|
-
Resolves the element a renderer mounts into. A `<canvas>` cannot paint inside
|
|
33
|
-
an `<svg>`, so when the scene target is the compute svg, the canvas mounts
|
|
34
|
-
into that svg's parent (the user's element); the emptied, position:absolute
|
|
35
|
-
compute svg overlays the same top-left box. SVG mounts into the target as-is.
|
|
36
|
-
*/ function mountTargetFor(kind, target) {
|
|
37
|
-
if (kind === "canvas" && typeof Element !== "undefined" && target instanceof Element && target.tagName.toLowerCase() === "svg") return target.parentNode ?? target;
|
|
38
|
-
return target;
|
|
39
|
-
}
|
|
40
38
|
/**
|
|
41
39
|
The base class every d3plus chart extends. Owns the shared configuration surface (data, groupBy, size and color accessors, title, legend, tooltip, timeline, zoom, table view) and the render lifecycle that each chart type's definition plugs its layout into. Not used directly; see the chart classes (BarChart, Treemap, …).
|
|
42
40
|
*/ export default class Viz extends VizBase {
|
|
41
|
+
static _displayName = "Viz";
|
|
43
42
|
/**
|
|
44
43
|
Invoked when creating a new class instance, and sets any default parameters.
|
|
45
44
|
@private
|
|
@@ -62,7 +61,7 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
62
61
|
- chart-level components (Legend/ColorScale/Timeline) via their toScene
|
|
63
62
|
- `_featurePanels` (from FeatureModule layouts) wrapped in viz-features
|
|
64
63
|
*/ toScene() {
|
|
65
|
-
const children =
|
|
64
|
+
const children = themeBackground(this);
|
|
66
65
|
// Chart cells stashed on _chartScene — via `chartDef.emit(ctx)` for
|
|
67
66
|
// data-driven charts, or `Plot._paint` for the paint-driven Plot family.
|
|
68
67
|
// Wraps in three groups:
|
|
@@ -169,6 +168,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
169
168
|
children: this._featurePanels
|
|
170
169
|
});
|
|
171
170
|
}
|
|
171
|
+
// Keyboard navigation's focus ring, above everything else.
|
|
172
|
+
appendFocusRing(this, children);
|
|
172
173
|
return {
|
|
173
174
|
width: this.schema.width,
|
|
174
175
|
height: this.schema.height,
|
|
@@ -200,6 +201,13 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
200
201
|
*/ _insetRegion() {
|
|
201
202
|
return null;
|
|
202
203
|
}
|
|
204
|
+
/**
|
|
205
|
+
The table view's rows, when the chart shows more than its data (see
|
|
206
|
+
`ChartDefinition.tableData`). The base chart shows its data.
|
|
207
|
+
@private
|
|
208
|
+
*/ _tableData() {
|
|
209
|
+
return null;
|
|
210
|
+
}
|
|
203
211
|
/**
|
|
204
212
|
The shape a colorScale row draws as (see
|
|
205
213
|
`ChartDefinition.colorScaleShape`): the row's `shape`, unless the chart
|
|
@@ -249,7 +257,7 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
249
257
|
}
|
|
250
258
|
/**
|
|
251
259
|
Draws the visualization given the specified configuration.
|
|
252
|
-
@param callback Optional callback invoked after rendering completes.
|
|
260
|
+
@param callback Optional callback invoked after rendering completes. It also runs after every later redraw that doesn't pass a callback of its own, including the ones the chart starts itself (legend clicks, resizes, reloading after scrolling back into view), so it can redraw anything it adds to the chart.
|
|
253
261
|
*/ render(callback) {
|
|
254
262
|
return vizRender(this, callback);
|
|
255
263
|
}
|
|
@@ -301,8 +309,9 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
301
309
|
// `durationOverride` defaults to the chart's `_duration` for normal
|
|
302
310
|
// re-renders. Interaction handlers (zoomed, hover, etc.) pass 0 to
|
|
303
311
|
// skip the transition machinery — animating every wheel/drag tick
|
|
304
|
-
// accumulates `setTimeout(duration+10)` per event.
|
|
305
|
-
|
|
312
|
+
// accumulates `setTimeout(duration+10)` per event. Reduced motion
|
|
313
|
+
// zeroes every draw, overrides included.
|
|
314
|
+
const drawDuration = motionReduced(this) ? 0 : durationOverride !== undefined ? durationOverride : this._instantNextDraw ? 0 : this.schema.duration;
|
|
306
315
|
// A duration>0 render (drill-down, zoom, re-center) must win over any
|
|
307
316
|
// pending coalesced duration-0 repaint — otherwise that repaint fires on
|
|
308
317
|
// the next frame and interrupts this transition, snapping shapes to their
|
|
@@ -375,6 +384,8 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
375
384
|
applyZoomPointerEvents(this);
|
|
376
385
|
if (this._select && kind === "canvas") this._select.selectAll("g.d3plus-viz-timeline, g.d3plus-viz-brush").style("pointer-events", "auto");
|
|
377
386
|
if (kind === "canvas") bindCanvasZoom(this);
|
|
387
|
+
nearestHoverSurface(this);
|
|
388
|
+
syncKeyboardNav(this);
|
|
378
389
|
// The timeline brush (d3-brush DOM, mounted in `g.d3plus-viz-timeline` in
|
|
379
390
|
// the outer svg) must paint above the scene-rendered timeline buttons/ticks
|
|
380
391
|
// so its selection tint + handles sit on top of them (matching v3). The
|
|
@@ -403,6 +414,14 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
403
414
|
*/ _interactionDatum(pick, _event) {
|
|
404
415
|
return handlerDatum(pick.datum, pick.index ?? 0);
|
|
405
416
|
}
|
|
417
|
+
/**
|
|
418
|
+
Whether a painted scene node is a point mark that nearest-point hover
|
|
419
|
+
(`hoverDistance`) resolves the pointer to. None in the base chart;
|
|
420
|
+
charts drawn with points (Plot, Network, Geomap) accept theirs.
|
|
421
|
+
@private
|
|
422
|
+
*/ _pointMark(_node) {
|
|
423
|
+
return false;
|
|
424
|
+
}
|
|
406
425
|
/**
|
|
407
426
|
Pointer hook run by `_routeSceneEvent` before any handler routing, for
|
|
408
427
|
every event including ones over empty space. No-op here; Plot overrides
|
|
@@ -457,13 +476,12 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
457
476
|
// tooltips never fire on the v4 scene-rendered path because
|
|
458
477
|
// `shape.on(evt, fn)` in plotPaint only wires d3-selection
|
|
459
478
|
// listeners on DOM nodes the scene renderer doesn't create.
|
|
460
|
-
// Renderer events carry the picked scene node;
|
|
461
|
-
// `_routeSceneEvent`
|
|
462
|
-
// readable). `_lastScenePick` remembers the most recently hovered node
|
|
479
|
+
// Renderer events carry the picked scene node; `routePointerEvent`
|
|
480
|
+
// resolves nearest-point hover, then `_routeSceneEvent` routes them. `_lastScenePick` remembers the most recently hovered node
|
|
463
481
|
// so `mouseleave` — fired with a null pick — can still tell the matching
|
|
464
482
|
// handlers which shape/legend item was left (so the tooltip clears).
|
|
465
483
|
this._lastScenePick = null;
|
|
466
|
-
this._sceneRenderer.on((event)=>this
|
|
484
|
+
this._sceneRenderer.on((event)=>routePointerEvent(this, event));
|
|
467
485
|
} else {
|
|
468
486
|
this._sceneRenderer.resize(w, h);
|
|
469
487
|
}
|
|
@@ -604,35 +622,20 @@ import { handleColorScaleHover } from "../features/colorScaleHover.js";
|
|
|
604
622
|
Tears down the visualization: disconnects the ResizeObserver, stops listening for web font loads and polling for data, and removes DOM event listeners. Call this when unmounting to avoid memory leaks.
|
|
605
623
|
*/ destroy() {
|
|
606
624
|
unregisterLink(this);
|
|
625
|
+
teardownKeyboardNav(this);
|
|
626
|
+
nearestHoverSurface(this, true);
|
|
627
|
+
unwatchPageTheme(this);
|
|
607
628
|
stopDataPolling(this);
|
|
608
629
|
this._resizeObserver?.disconnect();
|
|
609
630
|
this._fontsUnsubscribe?.();
|
|
610
631
|
this._fontsUnsubscribe = undefined;
|
|
611
632
|
this._tooltipClass.data([]).render();
|
|
612
633
|
select("body").on(`touchstart.${this._uuid}`, null);
|
|
613
|
-
|
|
614
|
-
// so a destroyed chart doesn't keep firing intervals/timeouts that
|
|
615
|
-
// hold the entire viz instance alive. Without this, an SPA that
|
|
616
|
-
// mounts/unmounts charts on tab switches leaks the scene tree +
|
|
617
|
-
// a 200ms-interval timer per leaked chart.
|
|
618
|
-
if (this._visiblePoll) {
|
|
619
|
-
this._visiblePoll = clearInterval(this._visiblePoll);
|
|
620
|
-
}
|
|
621
|
-
if (this._resizePoll) {
|
|
622
|
-
this._resizePoll = clearTimeout(this._resizePoll);
|
|
623
|
-
}
|
|
624
|
-
if (this._scrollPoll) {
|
|
625
|
-
this._scrollPoll = clearTimeout(this._scrollPoll);
|
|
626
|
-
}
|
|
627
|
-
this._visibleUnobserve?.();
|
|
628
|
-
this._visibleUnobserve = undefined;
|
|
629
|
-
this._unloadUnobserve?.();
|
|
630
|
-
this._unloadUnobserve = undefined;
|
|
634
|
+
stopVisibilityWatch(this);
|
|
631
635
|
if (this._sceneRepaintRAF != null) {
|
|
632
636
|
if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(this._sceneRepaintRAF);
|
|
633
637
|
this._sceneRepaintRAF = undefined;
|
|
634
638
|
}
|
|
635
|
-
if (this.schema.scrollContainer) select(this.schema.scrollContainer).on(`scroll.${this._uuid}`, null);
|
|
636
639
|
// Destroy the active scene renderer (clears its own pointer-rect
|
|
637
640
|
// listeners, overlay host, canvas/svg DOM, timers).
|
|
638
641
|
if (this._sceneRenderer && typeof this._sceneRenderer.destroy === "function") {
|
|
@@ -1,21 +1,25 @@
|
|
|
1
1
|
import { select } from "d3-selection";
|
|
2
|
-
import {
|
|
2
|
+
import { unique } from "@d3plus/data";
|
|
3
3
|
import { fontFamilyStringify } from "@d3plus/text";
|
|
4
4
|
import { date } from "@d3plus/dom";
|
|
5
5
|
import { BaseClass, constant } from "../../utils/index.js";
|
|
6
6
|
import { fieldAccessor } from "../../utils/fieldAccessor.js";
|
|
7
7
|
import { coerceFacet } from "../facet/facetConfig.js";
|
|
8
8
|
import { groupDepthOf } from "./groupRow.js";
|
|
9
|
+
import { dropLegendHistory } from "./history.js";
|
|
9
10
|
import { broadcastLink } from "./linkGroup.js";
|
|
10
11
|
import { shapeHoverEnabled } from "./shapeHover.js";
|
|
12
|
+
import { setLoaderValue } from "./loaderFormat.js";
|
|
11
13
|
import { stopDataPolling } from "./vizDataPolling.js";
|
|
12
14
|
import { isPlainObject, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
13
15
|
import validateShapeConfig from "../../shapes/validateShapeConfig.js";
|
|
16
|
+
import { displayName } from "../../utils/displayName.js";
|
|
14
17
|
/**
|
|
15
18
|
The fluent config accessors shared by every Viz chart that need more than
|
|
16
19
|
storing their value (most are generated from `vizFields.ts`); `Viz` adds
|
|
17
20
|
the render lifecycle.
|
|
18
21
|
*/ class VizBase extends BaseClass {
|
|
22
|
+
static _displayName = "VizBase";
|
|
19
23
|
/**
|
|
20
24
|
The active callback function for highlighting shapes.
|
|
21
25
|
*/ active(_) {
|
|
@@ -35,25 +39,29 @@ import validateShapeConfig from "../../shapes/validateShapeConfig.js";
|
|
|
35
39
|
|
|
36
40
|
If your data URL needs specific headers to be set, an Object with a "url" and "headers" (or any other `fetch` request option) may also be passed. An Object with any other key is a data row, not a request.
|
|
37
41
|
|
|
38
|
-
|
|
42
|
+
To transform the data before it is drawn (for example, a JSON API that returns its headers split from its values), set `dataFormat`. Passing a formatter as a second argument to this method sets `dataFormat`; calling it with only data keeps the current `dataFormat`.
|
|
39
43
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs the same formatter.
|
|
44
|
+
To re-fetch a URL on an interval and redraw when its data changes, set `dataPollingInterval`; each poll runs `dataFormat`.
|
|
43
45
|
|
|
44
46
|
Defaults to an empty array (`[]`).
|
|
45
|
-
@param
|
|
47
|
+
@param _ The data array or a URL string to load data from.
|
|
48
|
+
@param f Sets `dataFormat`.
|
|
46
49
|
*/ data(_, f) {
|
|
47
50
|
if (arguments.length) {
|
|
48
|
-
|
|
51
|
+
setLoaderValue(this, "data", arguments.length > 1 ? [
|
|
52
|
+
_,
|
|
53
|
+
f
|
|
54
|
+
] : [
|
|
55
|
+
_
|
|
56
|
+
]);
|
|
49
57
|
this._hidden = [];
|
|
50
58
|
this._solo = [];
|
|
59
|
+
dropLegendHistory(this);
|
|
51
60
|
if (this._userData && JSON.stringify(_) !== JSON.stringify(this._userData)) {
|
|
52
61
|
this.schema.timeFilter = false;
|
|
53
62
|
this._timelineSelection = false;
|
|
54
63
|
}
|
|
55
64
|
this._userData = _;
|
|
56
|
-
this._userDataFormat = f;
|
|
57
65
|
this._dataSignature = undefined;
|
|
58
66
|
stopDataPolling(this);
|
|
59
67
|
return this;
|
|
@@ -205,7 +213,7 @@ Defaults to an empty array (`[]`).
|
|
|
205
213
|
}
|
|
206
214
|
shapeConfig(_) {
|
|
207
215
|
if (!arguments.length) return this.schema.shapeConfig;
|
|
208
|
-
if (isPlainObject(_)) validateShapeConfig(this
|
|
216
|
+
if (isPlainObject(_)) validateShapeConfig(displayName(this), _);
|
|
209
217
|
this.schema.shapeConfig = mergeConfigBag(this, "shapeConfig", _);
|
|
210
218
|
return this;
|
|
211
219
|
}
|
|
@@ -269,7 +277,7 @@ Defaults to an empty array (`[]`).
|
|
|
269
277
|
} else return this.schema.time;
|
|
270
278
|
}
|
|
271
279
|
/**
|
|
272
|
-
The starting time or range for the timeline. Can be a single Date/String, or an Array of 2 values representing the min and max.
|
|
280
|
+
The starting time or range for the timeline, which the chart starts on too. Can be a single Date/String, or an Array of 2 values representing the min and max. A viewer's pick on the timeline replaces it.
|
|
273
281
|
*/ timelineDefault(_) {
|
|
274
282
|
if (arguments.length) {
|
|
275
283
|
if (!(_ instanceof Array)) _ = [
|
|
@@ -1,17 +1,23 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { backgroundColor } from "@d3plus/dom";
|
|
1
|
+
import { inkBackground, inkGrid, inkText } from "../../utils/themeInk.js";
|
|
3
2
|
/**
|
|
4
|
-
The chart's background
|
|
3
|
+
The chart's background: its theme's (the page's own in `"auto"` mode), or,
|
|
4
|
+
before the chart has drawn, the one detected behind its container (white
|
|
5
5
|
before the chart is mounted).
|
|
6
6
|
@private
|
|
7
7
|
*/ export function chartBackground(viz) {
|
|
8
|
-
|
|
9
|
-
return node ? backgroundColor(node) : "rgb(255, 255, 255)";
|
|
8
|
+
return inkBackground(viz);
|
|
10
9
|
}
|
|
11
10
|
/**
|
|
12
11
|
The text color that reads against the chart's own background: dark on a
|
|
13
|
-
light page, light on a dark one
|
|
12
|
+
light page, light on a dark one, or the theme's `text`.
|
|
14
13
|
@private
|
|
15
14
|
*/ export function backgroundInk(viz) {
|
|
16
|
-
return
|
|
15
|
+
return inkText(viz);
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
The chart's gridline color: the theme's `gridline`, a faint step off the
|
|
19
|
+
chart's background.
|
|
20
|
+
@private
|
|
21
|
+
*/ export function chartGridline(viz) {
|
|
22
|
+
return inkGrid(viz);
|
|
17
23
|
}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The ring drawn around the mark keyboard focus rests on.
|
|
3
|
+
|
|
4
|
+
@module
|
|
5
|
+
*/ /** The radius of the ring around a series point, before padding. */ const POINT_RADIUS = 5;
|
|
6
|
+
/** A ring outline drawn as `type`, as a halo underneath a stroke. */ function strokes(geom, style, type) {
|
|
7
|
+
const base = {
|
|
8
|
+
fill: "none",
|
|
9
|
+
vectorEffect: "non-scaling-stroke"
|
|
10
|
+
};
|
|
11
|
+
return [
|
|
12
|
+
{
|
|
13
|
+
...geom,
|
|
14
|
+
key: `viz-focus-halo-${type}`,
|
|
15
|
+
paint: {
|
|
16
|
+
...base,
|
|
17
|
+
stroke: style.halo,
|
|
18
|
+
strokeWidth: style.strokeWidth + 2
|
|
19
|
+
}
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
...geom,
|
|
23
|
+
key: `viz-focus-ring-${type}`,
|
|
24
|
+
paint: {
|
|
25
|
+
...base,
|
|
26
|
+
stroke: style.stroke,
|
|
27
|
+
strokeWidth: style.strokeWidth
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
].map((n)=>({
|
|
31
|
+
...n,
|
|
32
|
+
interactive: false,
|
|
33
|
+
aria: {
|
|
34
|
+
hidden: true
|
|
35
|
+
}
|
|
36
|
+
}));
|
|
37
|
+
}
|
|
38
|
+
/** Whether a node paints a visible fill. */ function filled(node) {
|
|
39
|
+
const fill = node.paint?.fill;
|
|
40
|
+
return !!fill && fill !== "none" && fill !== "transparent";
|
|
41
|
+
}
|
|
42
|
+
/** Nests `children` in one group per transform, outermost first. */ function nest(chain, children) {
|
|
43
|
+
return chain.reduceRight((inner, transform, i)=>[
|
|
44
|
+
{
|
|
45
|
+
type: "group",
|
|
46
|
+
key: `viz-focus-t${i}`,
|
|
47
|
+
transform,
|
|
48
|
+
children: inner,
|
|
49
|
+
interactive: false
|
|
50
|
+
}
|
|
51
|
+
], children);
|
|
52
|
+
}
|
|
53
|
+
/** The ring's own geometry, in surface coordinates unless it follows a path. */ function ringChildren(target, style) {
|
|
54
|
+
const { node, box, center, chain } = target;
|
|
55
|
+
const pad = style.padding;
|
|
56
|
+
if (target.pointIndex !== undefined) return strokes({
|
|
57
|
+
type: "circle",
|
|
58
|
+
cx: center[0],
|
|
59
|
+
cy: center[1],
|
|
60
|
+
r: POINT_RADIUS + pad
|
|
61
|
+
}, style, "circle");
|
|
62
|
+
if (node.type === "circle") return strokes({
|
|
63
|
+
type: "circle",
|
|
64
|
+
cx: center[0],
|
|
65
|
+
cy: center[1],
|
|
66
|
+
r: box.width / 2 + pad
|
|
67
|
+
}, style, "circle");
|
|
68
|
+
// A filled path's own outline (a pie wedge, a map region), through the
|
|
69
|
+
// same transforms that place the mark. A stroke-only path (a network link)
|
|
70
|
+
// is boxed instead, since tracing it would only redraw the line.
|
|
71
|
+
if (node.type === "path" && filled(node)) {
|
|
72
|
+
const full = node.transform ? [
|
|
73
|
+
...chain,
|
|
74
|
+
node.transform
|
|
75
|
+
] : chain;
|
|
76
|
+
return nest(full, strokes({
|
|
77
|
+
type: "path",
|
|
78
|
+
d: node.d
|
|
79
|
+
}, style, "path"));
|
|
80
|
+
}
|
|
81
|
+
return strokes({
|
|
82
|
+
type: "rect",
|
|
83
|
+
x: box.x - pad,
|
|
84
|
+
y: box.y - pad,
|
|
85
|
+
width: box.width + pad * 2,
|
|
86
|
+
height: box.height + pad * 2
|
|
87
|
+
}, style, "rect");
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
The `viz-focus` scene group outlining `target`: a padded rectangle around
|
|
91
|
+
a rect-like mark or a stroke-only path, a circle around a circle or series
|
|
92
|
+
point, and the mark's own outline for a filled path. Inert and hidden from
|
|
93
|
+
assistive tech.
|
|
94
|
+
*/ export function focusRingNode(target, style) {
|
|
95
|
+
return {
|
|
96
|
+
type: "group",
|
|
97
|
+
key: "viz-focus",
|
|
98
|
+
interactive: false,
|
|
99
|
+
aria: {
|
|
100
|
+
hidden: true
|
|
101
|
+
},
|
|
102
|
+
children: ringChildren(target, style)
|
|
103
|
+
};
|
|
104
|
+
}
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The marks keyboard navigation moves between, read off a painted scene,
|
|
3
|
+
and the spatial rules for moving from one to the next.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/ import { mapBox, mapper, ownBoxes } from "../features/sceneBounds.js";
|
|
7
|
+
import { MARK_TYPES } from "./sceneRows.js";
|
|
8
|
+
/** Root groups that hold navigable marks, and the handler group each routes to. */ const ROOT_GROUPS = {
|
|
9
|
+
"viz-chart-cells": "shape",
|
|
10
|
+
"viz-legend": "legend"
|
|
11
|
+
};
|
|
12
|
+
/** Interaction groups that are chart chrome rather than data marks. */ const CHROME_GROUPS = new Set([
|
|
13
|
+
"axis",
|
|
14
|
+
"timeline",
|
|
15
|
+
"trend"
|
|
16
|
+
]);
|
|
17
|
+
/** Whether a node (and everything inside it) is out of keyboard reach. */ function skipped(node) {
|
|
18
|
+
const n = node;
|
|
19
|
+
return String(n.key).endsWith("::hit") || n.interactive === false || !!n.aria?.hidden || n.interactionGroup !== undefined && CHROME_GROUPS.has(n.interactionGroup);
|
|
20
|
+
}
|
|
21
|
+
/** The source row a node's datum wraps, so a mark drawn twice counts once. */ function rowOf(datum) {
|
|
22
|
+
const raw = datum;
|
|
23
|
+
return raw && raw.data ? raw.data : raw;
|
|
24
|
+
}
|
|
25
|
+
/** The box around a list of boxes. */ function union(boxes) {
|
|
26
|
+
const x = Math.min(...boxes.map((b)=>b.x)), y = Math.min(...boxes.map((b)=>b.y));
|
|
27
|
+
const x2 = Math.max(...boxes.map((b)=>b.x + b.width)), y2 = Math.max(...boxes.map((b)=>b.y + b.height));
|
|
28
|
+
return {
|
|
29
|
+
x,
|
|
30
|
+
y,
|
|
31
|
+
width: x2 - x,
|
|
32
|
+
height: y2 - y
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/** Whether a point lies within a box, give or take a pixel. */ const inside = ([x, y], b)=>x >= b.x - 1 && x <= b.x + b.width + 1 && y >= b.y - 1 && y <= b.y + b.height + 1;
|
|
36
|
+
const finite = (b)=>[
|
|
37
|
+
b.x,
|
|
38
|
+
b.y,
|
|
39
|
+
b.width,
|
|
40
|
+
b.height
|
|
41
|
+
].every(Number.isFinite);
|
|
42
|
+
/** One target per series point of a Line/Area node. */ function pointTargets(node, chain, group, seen) {
|
|
43
|
+
const map = mapper(chain);
|
|
44
|
+
const out = [];
|
|
45
|
+
(node.interactionPoints || []).forEach((p, pointIndex)=>{
|
|
46
|
+
if (seen.has(p.datum)) return;
|
|
47
|
+
seen.add(p.datum);
|
|
48
|
+
const center = map([
|
|
49
|
+
p.x,
|
|
50
|
+
p.y
|
|
51
|
+
]);
|
|
52
|
+
const box = {
|
|
53
|
+
x: center[0],
|
|
54
|
+
y: center[1],
|
|
55
|
+
width: 0,
|
|
56
|
+
height: 0
|
|
57
|
+
};
|
|
58
|
+
if (!finite(box)) return;
|
|
59
|
+
const id = `${node.key}@${pointIndex}`;
|
|
60
|
+
out.push({
|
|
61
|
+
id,
|
|
62
|
+
node,
|
|
63
|
+
pointIndex,
|
|
64
|
+
center,
|
|
65
|
+
box,
|
|
66
|
+
group,
|
|
67
|
+
chain
|
|
68
|
+
});
|
|
69
|
+
});
|
|
70
|
+
return out;
|
|
71
|
+
}
|
|
72
|
+
/** The target for a single mark, or null when it has no finite geometry. */ function markTarget(node, chain, group) {
|
|
73
|
+
const full = node.transform ? [
|
|
74
|
+
...chain,
|
|
75
|
+
node.transform
|
|
76
|
+
] : chain;
|
|
77
|
+
const map = mapper(full);
|
|
78
|
+
const boxes = ownBoxes(node).filter(finite).map((b)=>mapBox(b, map));
|
|
79
|
+
if (!boxes.length) return null;
|
|
80
|
+
const box = union(boxes);
|
|
81
|
+
// A path's boxes are its outline's vertices; their mean sits inside a
|
|
82
|
+
// curved shape (a pie wedge) more often than its bounding box's center.
|
|
83
|
+
const center = node.type === "path" ? [
|
|
84
|
+
boxes.reduce((s, b)=>s + b.x, 0) / boxes.length,
|
|
85
|
+
boxes.reduce((s, b)=>s + b.y, 0) / boxes.length
|
|
86
|
+
] : [
|
|
87
|
+
box.x + box.width / 2,
|
|
88
|
+
box.y + box.height / 2
|
|
89
|
+
];
|
|
90
|
+
return {
|
|
91
|
+
id: String(node.key),
|
|
92
|
+
node,
|
|
93
|
+
center,
|
|
94
|
+
box,
|
|
95
|
+
group,
|
|
96
|
+
chain
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
Sorts targets left to right by their left edge, then top to bottom: bars
|
|
101
|
+
and series points read along the x axis, a stack or a vertical legend
|
|
102
|
+
reads downward, and a treemap starts at its top-left cell.
|
|
103
|
+
*/ export function readingOrder(targets) {
|
|
104
|
+
return [
|
|
105
|
+
...targets
|
|
106
|
+
].sort((a, b)=>Math.round(a.box.x) - Math.round(b.box.x) || Math.round(a.box.y) - Math.round(b.box.y));
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
Every mark keyboard focus can visit in a painted scene, chart marks first
|
|
110
|
+
and then legend items, each in reading order (see `readingOrder`).
|
|
111
|
+
Visits the chart cells and the legend only (not the colorScale, timeline,
|
|
112
|
+
or chrome), skipping `::hit` duplicates, inert or aria-hidden nodes,
|
|
113
|
+
text, axis/trend chrome, nodes without a datum, and marks a rectangular
|
|
114
|
+
clip hides (a zoomed chart's off-screen marks). A Line or Area node
|
|
115
|
+
becomes one target per point, and a row drawn by several nodes counts
|
|
116
|
+
once.
|
|
117
|
+
@param nodes The scene root's children (`viz._paintedScene.root.children`).
|
|
118
|
+
*/ export function focusTargets(nodes) {
|
|
119
|
+
const lists = {
|
|
120
|
+
shape: [],
|
|
121
|
+
legend: []
|
|
122
|
+
};
|
|
123
|
+
for (const top of nodes){
|
|
124
|
+
const group = ROOT_GROUPS[String(top.key)];
|
|
125
|
+
if (!group) continue;
|
|
126
|
+
const seen = new Set();
|
|
127
|
+
const walk = (node, chain, clips)=>{
|
|
128
|
+
if (skipped(node)) return;
|
|
129
|
+
if (node.type === "group") {
|
|
130
|
+
const next = node.transform ? [
|
|
131
|
+
...chain,
|
|
132
|
+
node.transform
|
|
133
|
+
] : chain;
|
|
134
|
+
const clip = node.clip;
|
|
135
|
+
const inner = clip && clip.type === "rect" ? [
|
|
136
|
+
...clips,
|
|
137
|
+
mapBox(clip, mapper(next))
|
|
138
|
+
] : clips;
|
|
139
|
+
for (const child of node.children)walk(child, next, inner);
|
|
140
|
+
return;
|
|
141
|
+
}
|
|
142
|
+
if (!MARK_TYPES.has(node.type) || node.datum === undefined) return;
|
|
143
|
+
if (node.paint?.opacity === 0) return;
|
|
144
|
+
const visible = (t)=>clips.every((c)=>inside(t.center, c));
|
|
145
|
+
if (node.interactionPoints?.length) {
|
|
146
|
+
const points = pointTargets(node, chain, group, seen);
|
|
147
|
+
lists[group].push(...points.filter(visible));
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
const row = rowOf(node.datum);
|
|
151
|
+
if (seen.has(row)) return;
|
|
152
|
+
const target = markTarget(node, chain, group);
|
|
153
|
+
if (!target || !visible(target)) return;
|
|
154
|
+
seen.add(row);
|
|
155
|
+
lists[group].push(target);
|
|
156
|
+
};
|
|
157
|
+
walk(top, [], []);
|
|
158
|
+
}
|
|
159
|
+
return [
|
|
160
|
+
...readingOrder(lists.shape),
|
|
161
|
+
...readingOrder(lists.legend)
|
|
162
|
+
];
|
|
163
|
+
}
|
|
164
|
+
/** The vertical (or horizontal) overlap of two boxes, in pixels. */ function overlap(a, b, axis) {
|
|
165
|
+
const size = axis === "x" ? "width" : "height";
|
|
166
|
+
return Math.min(a[axis] + a[size], b[axis] + b[size]) - Math.max(a[axis], b[axis]);
|
|
167
|
+
}
|
|
168
|
+
/** The axis a Line/Area node's points run along: the one they spread farther across. */ function seriesAxis(node) {
|
|
169
|
+
const points = node.interactionPoints || [];
|
|
170
|
+
const spread = (k)=>Math.max(...points.map((p)=>p[k])) - Math.min(...points.map((p)=>p[k]));
|
|
171
|
+
return spread("x") >= spread("y") ? "x" : "y";
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
The target an arrow key moves to from `current`: the nearest one in that
|
|
175
|
+
direction whose center lies within a 45° cone of it, where two marks that
|
|
176
|
+
overlap across the direction of travel (bars sharing a baseline, cells
|
|
177
|
+
in one row) count as level with each other. Without one in the cone, the
|
|
178
|
+
nearest center anywhere in that half-plane. Returns `current` when
|
|
179
|
+
nothing lies that way, and the first target when there is no current
|
|
180
|
+
one. Moving along a series (Line/Area points), its own next point counts
|
|
181
|
+
as level, so the series is followed rather than a neighbor's point.
|
|
182
|
+
*/ export function nextTarget(targets, current, direction) {
|
|
183
|
+
if (!current) return targets[0] ?? null;
|
|
184
|
+
const horizontal = direction === "left" || direction === "right";
|
|
185
|
+
const sign = direction === "right" || direction === "down" ? 1 : -1;
|
|
186
|
+
const across = horizontal ? "y" : "x";
|
|
187
|
+
const alongSeries = current.pointIndex !== undefined && seriesAxis(current.node) === (horizontal ? "x" : "y");
|
|
188
|
+
let cone = null, coneScore = Infinity;
|
|
189
|
+
let plane = null, planeScore = Infinity;
|
|
190
|
+
for (const t of targets){
|
|
191
|
+
if (t.id === current.id) continue;
|
|
192
|
+
const dx = t.center[0] - current.center[0], dy = t.center[1] - current.center[1];
|
|
193
|
+
const ahead = sign * (horizontal ? dx : dy);
|
|
194
|
+
if (ahead <= 0.5) continue;
|
|
195
|
+
const level = alongSeries && t.node === current.node || overlap(t.box, current.box, across) > 0;
|
|
196
|
+
const side = level ? 0 : Math.abs(horizontal ? dy : dx);
|
|
197
|
+
if (side <= ahead && ahead + 2 * side < coneScore) {
|
|
198
|
+
cone = t;
|
|
199
|
+
coneScore = ahead + 2 * side;
|
|
200
|
+
}
|
|
201
|
+
const dist = Math.hypot(dx, dy);
|
|
202
|
+
if (dist < planeScore) {
|
|
203
|
+
plane = t;
|
|
204
|
+
planeScore = dist;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
return cone ?? plane ?? current;
|
|
208
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The chart's Back history (`viz._history`): one stack holding drill-downs
|
|
3
|
+
and legend hide/solo clicks in the order they happened, so Back undoes
|
|
4
|
+
them in reverse.
|
|
5
|
+
*/ /** Whether a Back history entry records a legend click. */ export function isLegendEntry(entry) {
|
|
6
|
+
return entry.kind === "legend";
|
|
7
|
+
}
|
|
8
|
+
/** The newest drill-down entry on a Back history, skipping legend entries. */ export function latestDrillEntry(history) {
|
|
9
|
+
if (!history) return undefined;
|
|
10
|
+
for(let i = history.length - 1; i >= 0; i--){
|
|
11
|
+
const entry = history[i];
|
|
12
|
+
if (!isLegendEntry(entry)) return entry;
|
|
13
|
+
}
|
|
14
|
+
return undefined;
|
|
15
|
+
}
|
|
16
|
+
/** Removes and returns the newest drill-down entry, leaving the legend entries around it in place. */ export function removeLatestDrillEntry(history) {
|
|
17
|
+
const entry = latestDrillEntry(history);
|
|
18
|
+
if (entry) history.splice(history.lastIndexOf(entry), 1);
|
|
19
|
+
return entry;
|
|
20
|
+
}
|
|
21
|
+
/** Whether two legend id lists hold the same ids, in any order. */ export function sameLegendIds(a, b) {
|
|
22
|
+
return a.length === b.length && a.every((id)=>b.includes(id));
|
|
23
|
+
}
|
|
24
|
+
/** The chart's current legend hide/solo state, as a Back history entry. */ export function legendSnapshot(viz) {
|
|
25
|
+
return {
|
|
26
|
+
kind: "legend",
|
|
27
|
+
hidden: [
|
|
28
|
+
...viz._hidden
|
|
29
|
+
],
|
|
30
|
+
solo: [
|
|
31
|
+
...viz._solo
|
|
32
|
+
]
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
Records a legend click on the Back history: pushes `before` (the state
|
|
37
|
+
the click started from) when the click changed what is hidden or solo'd
|
|
38
|
+
and `legendHistory` is on. Returns whether it pushed.
|
|
39
|
+
*/ export function recordLegendChange(viz, before) {
|
|
40
|
+
if (!viz.schema.legendHistory) return false;
|
|
41
|
+
if (sameLegendIds(before.hidden, viz._hidden) && sameLegendIds(before.solo, viz._solo)) return false;
|
|
42
|
+
(viz._history ??= []).push(before);
|
|
43
|
+
return true;
|
|
44
|
+
}
|
|
45
|
+
/** Puts back the legend state a history entry recorded. */ export function restoreLegendEntry(viz, entry) {
|
|
46
|
+
viz._hidden = [
|
|
47
|
+
...entry.hidden
|
|
48
|
+
];
|
|
49
|
+
viz._solo = [
|
|
50
|
+
...entry.solo
|
|
51
|
+
];
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
Clears the legend's hide/solo state for a drill to a deeper level, whose
|
|
55
|
+
legend lists other groups, and returns the state it cleared for the
|
|
56
|
+
drill's history entry (undefined when nothing was hidden or solo'd).
|
|
57
|
+
*/ export function takeLegendState(viz) {
|
|
58
|
+
if (!viz._hidden.length && !viz._solo.length) return undefined;
|
|
59
|
+
const state = {
|
|
60
|
+
hidden: viz._hidden,
|
|
61
|
+
solo: viz._solo
|
|
62
|
+
};
|
|
63
|
+
viz._hidden = [];
|
|
64
|
+
viz._solo = [];
|
|
65
|
+
return state;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
Drops the legend's steps from the Back history: every legend entry, and
|
|
69
|
+
the legend state drill-down entries would put back. The drill-downs stay.
|
|
70
|
+
*/ export function dropLegendHistory(viz) {
|
|
71
|
+
if (!viz._history) return;
|
|
72
|
+
viz._history = viz._history.filter((e)=>!isLegendEntry(e));
|
|
73
|
+
for (const entry of viz._history)delete entry.legend;
|
|
74
|
+
}
|