@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,95 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The focusable element keyboard navigation listens on: one per chart,
|
|
3
|
+
beside its root svg (outside that svg's `aria-hidden` subtree), holding
|
|
4
|
+
the navigation instructions and the live region that announces the
|
|
5
|
+
focused mark.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ /** The instructions read when the chart gains focus. */ export const KEYBOARD_NAV_INSTRUCTIONS = "Use arrow keys to move between data points, Enter to select, and Escape to exit.";
|
|
9
|
+
/** Hides an element from sight while leaving it in the accessibility tree. */ const VISUALLY_HIDDEN = {
|
|
10
|
+
position: "absolute",
|
|
11
|
+
width: "1px",
|
|
12
|
+
height: "1px",
|
|
13
|
+
margin: "-1px",
|
|
14
|
+
padding: "0",
|
|
15
|
+
border: "0",
|
|
16
|
+
overflow: "hidden",
|
|
17
|
+
clip: "rect(0 0 0 0)",
|
|
18
|
+
clipPath: "inset(50%)",
|
|
19
|
+
whiteSpace: "nowrap"
|
|
20
|
+
};
|
|
21
|
+
/** The text of an HTML string, tags removed and whitespace collapsed. */ export function plainText(html) {
|
|
22
|
+
return String(html ?? "").replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
The chart's accessible name: its `svgTitle`, else its `title` text, else
|
|
26
|
+
the translated word "Chart".
|
|
27
|
+
*/ export function chartName(viz) {
|
|
28
|
+
const { schema } = viz;
|
|
29
|
+
const svgTitle = plainText(schema.svgTitle);
|
|
30
|
+
if (svgTitle) return svgTitle;
|
|
31
|
+
if (typeof schema.title === "function") {
|
|
32
|
+
try {
|
|
33
|
+
const title = plainText(schema.title(viz._filteredData || []));
|
|
34
|
+
if (title) return title;
|
|
35
|
+
} catch {
|
|
36
|
+
// A title accessor that needs data the chart has not loaded names nothing.
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
return schema.translate("Chart");
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
Creates the host inside `parent`: a `tabindex="0"`, `role="application"`
|
|
43
|
+
element laid over the chart, with its instructions and live region.
|
|
44
|
+
*/ export function createKeyboardNavHost(parent, uuid) {
|
|
45
|
+
const doc = parent.ownerDocument;
|
|
46
|
+
const host = doc.createElement("div");
|
|
47
|
+
host.className = "d3plus-keyboard-nav";
|
|
48
|
+
host.setAttribute("tabindex", "0");
|
|
49
|
+
host.setAttribute("role", "application");
|
|
50
|
+
Object.assign(host.style, {
|
|
51
|
+
position: "absolute",
|
|
52
|
+
pointerEvents: "none",
|
|
53
|
+
outline: "none"
|
|
54
|
+
});
|
|
55
|
+
const desc = doc.createElement("span");
|
|
56
|
+
desc.id = `${uuid}-keyboard-desc`;
|
|
57
|
+
const live = doc.createElement("span");
|
|
58
|
+
live.setAttribute("aria-live", "polite");
|
|
59
|
+
live.setAttribute("aria-atomic", "true");
|
|
60
|
+
for (const el of [
|
|
61
|
+
desc,
|
|
62
|
+
live
|
|
63
|
+
]){
|
|
64
|
+
Object.assign(el.style, VISUALLY_HIDDEN);
|
|
65
|
+
host.appendChild(el);
|
|
66
|
+
}
|
|
67
|
+
parent.appendChild(host);
|
|
68
|
+
return {
|
|
69
|
+
host,
|
|
70
|
+
desc,
|
|
71
|
+
live
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
Refreshes the host's name, description, and box from the chart's current
|
|
76
|
+
config and size, laying it over the chart's root svg.
|
|
77
|
+
*/ export function updateKeyboardNavHost(viz, { host, desc }) {
|
|
78
|
+
const t = (s)=>viz.schema.translate(s);
|
|
79
|
+
host.setAttribute("aria-label", chartName(viz));
|
|
80
|
+
host.setAttribute("aria-roledescription", t("interactive chart"));
|
|
81
|
+
const describedBy = viz.schema.svgDesc ? `${viz._uuid}-desc ${desc.id}` : desc.id;
|
|
82
|
+
host.setAttribute("aria-describedby", describedBy);
|
|
83
|
+
const own = viz._keyboardGesture?.keys() ?? null;
|
|
84
|
+
const instructions = t(KEYBOARD_NAV_INSTRUCTIONS);
|
|
85
|
+
desc.textContent = own ? `${instructions} ${own.instructions}` : instructions;
|
|
86
|
+
if (own) host.setAttribute("aria-keyshortcuts", own.shortcuts);
|
|
87
|
+
else host.removeAttribute("aria-keyshortcuts");
|
|
88
|
+
const svg = viz._select?.node?.();
|
|
89
|
+
Object.assign(host.style, {
|
|
90
|
+
top: svg?.style.top || "0px",
|
|
91
|
+
left: svg?.style.left || "0px",
|
|
92
|
+
width: `${viz.schema.width || 0}px`,
|
|
93
|
+
height: `${viz.schema.height || 0}px`
|
|
94
|
+
});
|
|
95
|
+
}
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import { addToQueue } from "@d3plus/data";
|
|
2
|
+
import { isPlainObject } from "../../fluent.js";
|
|
3
|
+
import { isPollable } from "./vizDataPolling.js";
|
|
4
|
+
/** The loaders whose payload a `<key>Format` config key transforms. */ export const FORMAT_KEYS = [
|
|
5
|
+
"data",
|
|
6
|
+
"links",
|
|
7
|
+
"nodes",
|
|
8
|
+
"topojson"
|
|
9
|
+
];
|
|
10
|
+
/**
|
|
11
|
+
Whether `key` names a loader with a `<key>Format` config key.
|
|
12
|
+
@private
|
|
13
|
+
*/ export function isFormatKey(key) {
|
|
14
|
+
return FORMAT_KEYS.includes(key);
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
The `<key>Format` function set on a chart, or `undefined` when none is set.
|
|
18
|
+
@private
|
|
19
|
+
*/ export function formatterFor(viz, key) {
|
|
20
|
+
const f = viz.schema[`${key}Format`];
|
|
21
|
+
return typeof f === "function" ? f : undefined;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
Runs `formatter` over a payload the way a loaded file is formatted: a
|
|
25
|
+
`data` formatter may return `{data, ...config}`, whose config is applied to
|
|
26
|
+
the chart. Without a formatter the payload passes through.
|
|
27
|
+
@private
|
|
28
|
+
*/ export function formatPayload(viz, key, payload, formatter) {
|
|
29
|
+
if (!formatter) return payload;
|
|
30
|
+
const out = formatter(payload);
|
|
31
|
+
if (key === "data" && isPlainObject(out)) {
|
|
32
|
+
const { data, ...config } = out;
|
|
33
|
+
viz.config?.(config);
|
|
34
|
+
return data || [];
|
|
35
|
+
}
|
|
36
|
+
return out || [];
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
Stores a loader's payload where its getter reads it: a `_<key>` slot when
|
|
40
|
+
the chart has one (`_data`), its schema otherwise.
|
|
41
|
+
@private
|
|
42
|
+
*/ export function storePayload(viz, key, value) {
|
|
43
|
+
const slots = viz;
|
|
44
|
+
if (`_${key}` in slots) slots[`_${key}`] = value;
|
|
45
|
+
else viz.schema[key] = value;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
Sets a loader's value (`data`, `links`, `nodes`, `topojson`): a URL or
|
|
49
|
+
request object is queued to load on the next render, and an inline value is
|
|
50
|
+
stored at once. Passing a formatter as the second argument sets
|
|
51
|
+
`<key>Format`; leaving it out keeps the current one.
|
|
52
|
+
@param viz The chart.
|
|
53
|
+
@param key The loader.
|
|
54
|
+
@param args The loader's arguments: the value, then an optional formatter.
|
|
55
|
+
@private
|
|
56
|
+
*/ export function setLoaderValue(viz, key, args) {
|
|
57
|
+
const value = args[0];
|
|
58
|
+
if (args.length > 1) viz.schema[`${key}Format`] = args[1];
|
|
59
|
+
addToQueue.call(viz, value, undefined, key);
|
|
60
|
+
(viz._loaders ??= {})[key] = {
|
|
61
|
+
source: value,
|
|
62
|
+
applied: undefined
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
Brings each loader's stored payload in line with its current `<key>Format`
|
|
67
|
+
before a render draws: a URL whose formatter changed since it loaded is
|
|
68
|
+
queued to load again (from the chart's cache when it holds the response),
|
|
69
|
+
and an inline value is formatted in place from the
|
|
70
|
+
value it was given. Queued loads already use the current formatter.
|
|
71
|
+
@private
|
|
72
|
+
*/ export function syncLoaderFormats(viz) {
|
|
73
|
+
const loaders = viz._loaders;
|
|
74
|
+
if (!loaders) return;
|
|
75
|
+
const queue = viz._queue ?? [];
|
|
76
|
+
for (const key of FORMAT_KEYS){
|
|
77
|
+
const state = loaders[key];
|
|
78
|
+
if (!state || queue.some((q)=>q[3] === key)) continue;
|
|
79
|
+
const formatter = formatterFor(viz, key);
|
|
80
|
+
if (state.applied === formatter) continue;
|
|
81
|
+
if (isPollable(state.source)) {
|
|
82
|
+
addToQueue.call(viz, state.source, undefined, key);
|
|
83
|
+
} else {
|
|
84
|
+
storePayload(viz, key, formatPayload(viz, key, state.source, formatter));
|
|
85
|
+
state.applied = formatter;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
The formatter a queued load of `key` runs: the chart's current
|
|
91
|
+
`<key>Format` for a loader that has one (recorded as applied), otherwise
|
|
92
|
+
the formatter queued with it.
|
|
93
|
+
@private
|
|
94
|
+
*/ export function queuedFormatter(viz, key, queued) {
|
|
95
|
+
if (!isFormatKey(key)) return queued;
|
|
96
|
+
const formatter = formatterFor(viz, key);
|
|
97
|
+
const state = viz._loaders?.[key];
|
|
98
|
+
if (state) state.applied = formatter;
|
|
99
|
+
return formatter;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
The `<key>Format` config fields for a chart's loaders. A new
|
|
103
|
+
`topojsonFormat` re-fits the map to the reformatted topojson.
|
|
104
|
+
@param keys The loaders the chart has.
|
|
105
|
+
*/ export function loaderFormatFields(...keys) {
|
|
106
|
+
return keys.map((key)=>key === "topojson" ? {
|
|
107
|
+
key: "topojsonFormat",
|
|
108
|
+
onSet: (viz)=>{
|
|
109
|
+
viz._zoomSet = false;
|
|
110
|
+
}
|
|
111
|
+
} : {
|
|
112
|
+
key: `${key}Format`
|
|
113
|
+
});
|
|
114
|
+
}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Warns when a config key names a data field that no row of the chart's data
|
|
3
|
+
has (a typo like `y: "vlaue"` otherwise draws an empty chart in silence).
|
|
4
|
+
Only field names the user gave are checked: string config values become
|
|
5
|
+
accessors remembered by `fieldAccessor`, while function accessors,
|
|
6
|
+
constants, and defaults are never checked.
|
|
7
|
+
*/ import { canWarnOnce, warnConfigOnce } from "../../utils/configWarnings.js";
|
|
8
|
+
import { fieldNameOf } from "../../utils/fieldAccessor.js";
|
|
9
|
+
import { displayName } from "../../utils/displayName.js";
|
|
10
|
+
/** Config keys a chart stores outside `viz.schema`. */ const SLOT_KEYS = {
|
|
11
|
+
x: "_x",
|
|
12
|
+
x2: "_x2",
|
|
13
|
+
y: "_y",
|
|
14
|
+
y2: "_y2",
|
|
15
|
+
size: "_size",
|
|
16
|
+
stackOrder: "_stackOrder"
|
|
17
|
+
};
|
|
18
|
+
/** Schema keys that hold field names as plain strings. */ const NAME_KEYS = [
|
|
19
|
+
"dimensions"
|
|
20
|
+
];
|
|
21
|
+
/** The most field names a warning lists. */ export const MAX_LISTED_FIELDS = 10;
|
|
22
|
+
/**
|
|
23
|
+
The data fields a chart's config names, each under the first key that
|
|
24
|
+
holds its accessor (so `thresholdKey`, which some charts point at `sum` or
|
|
25
|
+
`y`, only names a field the user gave it alone).
|
|
26
|
+
@param viz The chart.
|
|
27
|
+
*/ export function fieldUses(viz) {
|
|
28
|
+
const uses = new Map();
|
|
29
|
+
const add = (key, fn)=>{
|
|
30
|
+
const field = fieldNameOf(fn);
|
|
31
|
+
if (field !== undefined && !uses.has(fn)) uses.set(fn, {
|
|
32
|
+
key,
|
|
33
|
+
field
|
|
34
|
+
});
|
|
35
|
+
};
|
|
36
|
+
for (const [key, slot] of Object.entries(SLOT_KEYS))add(key, viz[slot]);
|
|
37
|
+
for (const band of viz._confidenceBands ?? []){
|
|
38
|
+
add("confidence", band.lower);
|
|
39
|
+
add("confidence", band.upper);
|
|
40
|
+
}
|
|
41
|
+
const keys = Object.keys(viz.schema).filter((k)=>k !== "thresholdKey");
|
|
42
|
+
for (const key of [
|
|
43
|
+
...keys,
|
|
44
|
+
"thresholdKey"
|
|
45
|
+
]){
|
|
46
|
+
const value = viz.schema[key];
|
|
47
|
+
// An array of accessors, like `groupBy`; other arrays (such as `nodes`)
|
|
48
|
+
// hold data, not config.
|
|
49
|
+
if (Array.isArray(value) && typeof value[0] === "function") value.forEach((fn)=>add(key, fn));
|
|
50
|
+
else add(key, value);
|
|
51
|
+
}
|
|
52
|
+
const out = Array.from(uses.values());
|
|
53
|
+
for (const key of NAME_KEYS){
|
|
54
|
+
const value = viz.schema[key];
|
|
55
|
+
const names = Array.isArray(value) ? value : [
|
|
56
|
+
value
|
|
57
|
+
];
|
|
58
|
+
for (const field of names)if (typeof field === "string") out.push({
|
|
59
|
+
key,
|
|
60
|
+
field
|
|
61
|
+
});
|
|
62
|
+
}
|
|
63
|
+
return out;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
The rows a chart's field names are read from: its data (the user's rows,
|
|
67
|
+
when the chart derives `_data` from them), plus the `nodes` and `links`
|
|
68
|
+
arrays of a network chart.
|
|
69
|
+
@param viz The chart.
|
|
70
|
+
*/ export function fieldRows(viz) {
|
|
71
|
+
const data = viz._sourceData ?? viz._data;
|
|
72
|
+
return [
|
|
73
|
+
data,
|
|
74
|
+
viz.schema.nodes,
|
|
75
|
+
viz.schema.links
|
|
76
|
+
].filter((rows)=>Array.isArray(rows));
|
|
77
|
+
}
|
|
78
|
+
const isRow = (d)=>d !== null && typeof d === "object";
|
|
79
|
+
/**
|
|
80
|
+
Whether any row in `rowSets` has `field`.
|
|
81
|
+
@param rowSets Arrays of data rows.
|
|
82
|
+
@param field The field name.
|
|
83
|
+
*/ export function rowsHaveField(rowSets, field) {
|
|
84
|
+
return rowSets.some((rows)=>rows.some((d)=>isRow(d) && field in d));
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
Every field name in `rowSets`, in the order first seen.
|
|
88
|
+
@param rowSets Arrays of data rows.
|
|
89
|
+
*/ export function rowFields(rowSets) {
|
|
90
|
+
const names = new Set();
|
|
91
|
+
for (const rows of rowSets)for (const d of rows)if (isRow(d)) for(const k in d)names.add(k);
|
|
92
|
+
return Array.from(names);
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
The warning for a config key whose field no row has, listing the first
|
|
96
|
+
`MAX_LISTED_FIELDS` fields the rows do have.
|
|
97
|
+
@param chart The chart's name.
|
|
98
|
+
@param use The config key and the field it names.
|
|
99
|
+
@param fields The fields the rows have.
|
|
100
|
+
*/ export function missingFieldMessage(chart, { key, field }, fields) {
|
|
101
|
+
const listed = fields.slice(0, MAX_LISTED_FIELDS);
|
|
102
|
+
if (fields.length > MAX_LISTED_FIELDS) listed.push("…");
|
|
103
|
+
return `${chart} ${key}: no rows have '${field}'; fields are: ${listed.join(", ")}`;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
Warns, once per key and field for each chart, about every config key that
|
|
107
|
+
names a field none of the chart's rows have. Rows missing some fields are
|
|
108
|
+
normal (sparse data), so a field any row has never warns, and a chart with
|
|
109
|
+
no rows warns about nothing.
|
|
110
|
+
@param viz The chart.
|
|
111
|
+
*/ export function warnMissingFields(viz) {
|
|
112
|
+
const id = ({ key, field })=>`missing-field:${key}:${field}`;
|
|
113
|
+
const uses = fieldUses(viz).filter((use)=>canWarnOnce(viz, id(use)));
|
|
114
|
+
if (!uses.length) return;
|
|
115
|
+
const rowSets = fieldRows(viz);
|
|
116
|
+
if (!rowSets.some((rows)=>rows.some(isRow))) return;
|
|
117
|
+
let fields;
|
|
118
|
+
for (const use of uses){
|
|
119
|
+
if (rowsHaveField(rowSets, use.field)) continue;
|
|
120
|
+
fields ??= rowFields(rowSets);
|
|
121
|
+
warnConfigOnce(viz, id(use), missingFieldMessage(displayName(viz), use, fields));
|
|
122
|
+
}
|
|
123
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Resolves the element a renderer mounts into. A `<canvas>` cannot paint inside
|
|
3
|
+
an `<svg>`, so when the scene target is the compute svg, the canvas mounts
|
|
4
|
+
into that svg's parent (the user's element); the emptied, position:absolute
|
|
5
|
+
compute svg overlays the same top-left box. SVG mounts into the target as-is.
|
|
6
|
+
*/ export function mountTargetFor(kind, target) {
|
|
7
|
+
if (kind === "canvas" && typeof Element !== "undefined" && target instanceof Element && target.tagName.toLowerCase() === "svg") return target.parentNode ?? target;
|
|
8
|
+
return target;
|
|
9
|
+
}
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Nearest-point hover (`hoverDistance`): a pointer over empty space, or over
|
|
3
|
+
something other than a point mark, acts on the closest point mark within
|
|
4
|
+
`hoverDistance` pixels, read off the painted scene through a Voronoi
|
|
5
|
+
diagram.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ import { gestureHolds } from "../drawSteps/gestureHover.js";
|
|
9
|
+
import { facetPanelAt } from "../facet/facetPanel.js";
|
|
10
|
+
import { focusTargets } from "./focusTargets.js";
|
|
11
|
+
import { pointVoronoi } from "./pointVoronoi.js";
|
|
12
|
+
import { nodeShapeType } from "./shapeClassTargets.js";
|
|
13
|
+
/** The shape classes that draw a point. */ const POINT_SHAPES = [
|
|
14
|
+
"Circle",
|
|
15
|
+
"Rect"
|
|
16
|
+
];
|
|
17
|
+
/**
|
|
18
|
+
Whether a scene node draws a point: a Circle or Rect shape (or another of
|
|
19
|
+
`shapes`) that isn't part of a composite (a Box's rect).
|
|
20
|
+
*/ export function isPointShape(node, shapes = POINT_SHAPES) {
|
|
21
|
+
const shape = nodeShapeType(node);
|
|
22
|
+
return !!shape && shapes.includes(shape) && !node.owners?.length;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
The point marks of a painted scene, as Voronoi points: every chart mark
|
|
26
|
+
keyboard navigation could visit (so `::hit` duplicates, inert nodes, and
|
|
27
|
+
marks clipped out by a zoom are left out) that `isPoint` accepts, at its
|
|
28
|
+
surface-space center with its inscribed radius.
|
|
29
|
+
@param nodes The scene root's children (`viz._paintedScene.root.children`).
|
|
30
|
+
@param isPoint Which nodes count as point marks.
|
|
31
|
+
*/ export function pointMarkTargets(nodes, isPoint) {
|
|
32
|
+
return focusTargets(nodes).filter((t)=>t.group === "shape" && t.pointIndex === undefined && isPoint(t.node)).map((t)=>({
|
|
33
|
+
x: t.center[0],
|
|
34
|
+
y: t.center[1],
|
|
35
|
+
r: Math.min(t.box.width, t.box.height) / 2,
|
|
36
|
+
item: t
|
|
37
|
+
}));
|
|
38
|
+
}
|
|
39
|
+
/** The pixel reach of nearest-point hover, or 0 when it is off for this chart. */ export function hoverReach(viz) {
|
|
40
|
+
const distance = Number(viz.schema.hoverDistance);
|
|
41
|
+
if (!(distance > 0) || !viz._pointMark) return 0;
|
|
42
|
+
// Plot's shared tooltip already snaps to the nearest discrete position.
|
|
43
|
+
const discrete = viz.schema.discrete === "x" || viz.schema.discrete === "y";
|
|
44
|
+
if (viz.schema.tooltipShared && discrete) return 0;
|
|
45
|
+
return distance;
|
|
46
|
+
}
|
|
47
|
+
/** The chart's diagrams for its current painted scene, rebuilt once per paint. */ function pointIndex(viz, state) {
|
|
48
|
+
const scene = viz._paintedScene;
|
|
49
|
+
if (state.index && state.index.scene === scene) return state.index;
|
|
50
|
+
const isPoint = (node)=>!!viz._pointMark?.(node);
|
|
51
|
+
const points = pointMarkTargets(scene?.root.children ?? [], isPoint);
|
|
52
|
+
const groups = new Map();
|
|
53
|
+
for (const p of points){
|
|
54
|
+
const key = facetPanelAt(viz, [
|
|
55
|
+
p.x,
|
|
56
|
+
p.y
|
|
57
|
+
])?.key ?? "";
|
|
58
|
+
if (!groups.has(key)) groups.set(key, []);
|
|
59
|
+
groups.get(key).push(p);
|
|
60
|
+
}
|
|
61
|
+
const bounds = {
|
|
62
|
+
x: 0,
|
|
63
|
+
y: 0,
|
|
64
|
+
width: Number(viz.schema.width) || 0,
|
|
65
|
+
height: Number(viz.schema.height) || 0
|
|
66
|
+
};
|
|
67
|
+
const panels = new Map([
|
|
68
|
+
...groups
|
|
69
|
+
].map(([key, list])=>[
|
|
70
|
+
key,
|
|
71
|
+
pointVoronoi(list, bounds)
|
|
72
|
+
]));
|
|
73
|
+
const byKey = new Map(points.map((p)=>[
|
|
74
|
+
String(p.item.node.key),
|
|
75
|
+
p.item
|
|
76
|
+
]));
|
|
77
|
+
state.index = {
|
|
78
|
+
scene,
|
|
79
|
+
panels,
|
|
80
|
+
byKey
|
|
81
|
+
};
|
|
82
|
+
return state.index;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
The painted point mark a picked node stands for, while nearest-point
|
|
86
|
+
hover applies: the mark itself, or the one its `::hit` duplicate
|
|
87
|
+
widens. Undefined for anything else (bars, lines, legend items).
|
|
88
|
+
*/ export function pointTarget(viz, node) {
|
|
89
|
+
if (!node || !hoverReach(viz) || !viz._pointMark(node)) return undefined;
|
|
90
|
+
const state = viz._nearestHover ??= {
|
|
91
|
+
key: null
|
|
92
|
+
};
|
|
93
|
+
const key = String(node.key).replace(/::hit$/, "");
|
|
94
|
+
return pointIndex(viz, state).byKey.get(key);
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
The pick the pointer at `point` acts on, in place of `pick`: the nearest
|
|
98
|
+
point mark within `hoverDistance` (in the same small-multiples panel),
|
|
99
|
+
when `pick` is empty or something other than a point mark. A point mark,
|
|
100
|
+
a legend or timeline item, a trend line, or a mark's own label is kept as
|
|
101
|
+
picked, as is everything when nearest-point hover is off.
|
|
102
|
+
*/ export function nearestPick(viz, pick, point) {
|
|
103
|
+
const reach = hoverReach(viz);
|
|
104
|
+
if (!reach || !point) return pick;
|
|
105
|
+
if (pick) {
|
|
106
|
+
const node = pick.node;
|
|
107
|
+
if (viz._pointMark(node)) return pick;
|
|
108
|
+
if (node.interactionGroup && node.interactionGroup !== "axis") return pick;
|
|
109
|
+
if (node.type === "text" && node.datum !== undefined) return pick;
|
|
110
|
+
}
|
|
111
|
+
const state = viz._nearestHover ??= {
|
|
112
|
+
key: null
|
|
113
|
+
};
|
|
114
|
+
const index = pointIndex(viz, state);
|
|
115
|
+
const panel = viz._facetPanels?.length ? facetPanelAt(viz, point) : null;
|
|
116
|
+
if (panel === undefined) return pick;
|
|
117
|
+
const voronoi = index.panels.get(panel?.key ?? "");
|
|
118
|
+
const match = voronoi?.nearest(point[0], point[1], reach);
|
|
119
|
+
if (!match) return pick;
|
|
120
|
+
const node = match.point.item.node;
|
|
121
|
+
return {
|
|
122
|
+
node,
|
|
123
|
+
datum: node.datum,
|
|
124
|
+
index: node.index
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
The renderer's pointer bridge: resolves each event's pick through
|
|
129
|
+
`nearestPick` and hands it to `viz._routeSceneEvent` (a click that
|
|
130
|
+
resolves to nothing also runs `viz._backgroundClick`), firing
|
|
131
|
+
mouseleave/mouseenter whenever the mark the pointer resolves to changes
|
|
132
|
+
(in place of the renderer's own, which follow the raw pick). Events that
|
|
133
|
+
don't come from the renderer's pointer listeners pass through unchanged
|
|
134
|
+
apart from the pick.
|
|
135
|
+
*/ export function routePointerEvent(viz, event) {
|
|
136
|
+
// A zoom gesture moving the chart holds pointer events until it ends.
|
|
137
|
+
if (gestureHolds(viz)) return;
|
|
138
|
+
const route = (e)=>viz._routeSceneEvent?.(e);
|
|
139
|
+
const state = viz._nearestHover ??= {
|
|
140
|
+
key: null
|
|
141
|
+
};
|
|
142
|
+
const native = event.nativeEvent?.type;
|
|
143
|
+
const fromMove = native === "mousemove";
|
|
144
|
+
if (event.type === "mouseenter" || event.type === "mouseleave") {
|
|
145
|
+
// The renderer's own crossing between picks: replaced below.
|
|
146
|
+
if (fromMove) return;
|
|
147
|
+
// Leaving the SVG scene for the empty space around it, which routes its
|
|
148
|
+
// own moves (see `nearestHoverSurface`): not leaving the chart.
|
|
149
|
+
const to = event.nativeEvent?.relatedTarget;
|
|
150
|
+
if (event.type === "mouseleave" && state.surface?.aroundScene(to ?? null) && hoverReach(viz)) return;
|
|
151
|
+
state.key = event.type === "mouseenter" && event.pick ? String(event.pick.node.key) : null;
|
|
152
|
+
route(event);
|
|
153
|
+
return;
|
|
154
|
+
}
|
|
155
|
+
const pick = nearestPick(viz, event.pick, event.point);
|
|
156
|
+
const resolved = pick === event.pick ? event : {
|
|
157
|
+
...event,
|
|
158
|
+
pick
|
|
159
|
+
};
|
|
160
|
+
// A click on no mark reaches the chart's background (on SVG, a Network's
|
|
161
|
+
// background rect takes it before the renderer does).
|
|
162
|
+
if (event.type === "click" && !pick && event.point) viz._backgroundClick?.(event.point);
|
|
163
|
+
if (event.type === "mousemove" && fromMove) {
|
|
164
|
+
const key = pick ? String(pick.node.key) : null;
|
|
165
|
+
if (key !== state.key) {
|
|
166
|
+
const { point, nativeEvent } = event;
|
|
167
|
+
if (state.key !== null) route({
|
|
168
|
+
type: "mouseleave",
|
|
169
|
+
point,
|
|
170
|
+
pick: null,
|
|
171
|
+
nativeEvent
|
|
172
|
+
});
|
|
173
|
+
state.key = key;
|
|
174
|
+
if (pick) route({
|
|
175
|
+
type: "mouseenter",
|
|
176
|
+
point,
|
|
177
|
+
pick,
|
|
178
|
+
nativeEvent
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
route(resolved);
|
|
183
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Nearest-point hover over the empty space of an SVG chart. A nested `<svg>`
|
|
3
|
+
only receives pointer events over what it paints, so moves and clicks over
|
|
4
|
+
the space between marks land on the chart's outer `<svg>` (or the zoom
|
|
5
|
+
surface, map tiles, or Network background inside it) and never reach the
|
|
6
|
+
SVG renderer. This routes them to the chart as pointer events over
|
|
7
|
+
nothing, which `routePointerEvent` resolves to the nearest point. The
|
|
8
|
+
Canvas renderer's surface covers the whole chart and needs none of it.
|
|
9
|
+
|
|
10
|
+
@module
|
|
11
|
+
*/ import { hoverReach, nearestPick, routePointerEvent } from "./nearestHover.js";
|
|
12
|
+
import { surfaceOrigin } from "./pointTooltipAnchor.js";
|
|
13
|
+
/** Chart DOM that keeps its own pointer handling (the timeline and brushes). */ const OWN_POINTER = "g.d3plus-viz-timeline, g.d3plus-viz-brush, g.d3plus-zoom-brush";
|
|
14
|
+
/** The SVG renderer's own `<svg>`, if it is mounted. */ function sceneSvg(viz) {
|
|
15
|
+
const elements = viz._sceneRenderer?.elements?.() ?? [];
|
|
16
|
+
return elements.find((el)=>el.localName === "svg");
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
Routes pointer events from the empty space around an SVG chart's scene
|
|
20
|
+
(see the module comment) while `hoverDistance` applies, binding to the
|
|
21
|
+
chart's outer `<svg>` once and rebinding when it changes. A click there
|
|
22
|
+
that resolves to a point is that point's alone: it stops before reaching
|
|
23
|
+
the chart DOM under the pointer (a Network's background, which clears
|
|
24
|
+
its focus). Removes the listeners on the Canvas renderer.
|
|
25
|
+
*/ export function nearestHoverSurface(viz, unbind = false) {
|
|
26
|
+
const state = viz._nearestHover ??= {
|
|
27
|
+
key: null
|
|
28
|
+
};
|
|
29
|
+
const outer = viz._select?.node?.();
|
|
30
|
+
const svg = viz._renderer === "canvas" || unbind ? undefined : outer;
|
|
31
|
+
if (state.surface && state.surface.el === svg) return;
|
|
32
|
+
state.surface?.unbind();
|
|
33
|
+
state.surface = undefined;
|
|
34
|
+
if (!svg || typeof svg.addEventListener !== "function") return;
|
|
35
|
+
const aroundScene = (el)=>{
|
|
36
|
+
const node = el;
|
|
37
|
+
const scene = sceneSvg(viz);
|
|
38
|
+
return !!node && typeof node.closest === "function" && svg.contains(node) && !(scene && scene.contains(node)) && !node.closest(OWN_POINTER);
|
|
39
|
+
};
|
|
40
|
+
const local = (e)=>{
|
|
41
|
+
const origin = surfaceOrigin(viz);
|
|
42
|
+
return [
|
|
43
|
+
e.clientX - origin.left,
|
|
44
|
+
e.clientY - origin.top
|
|
45
|
+
];
|
|
46
|
+
};
|
|
47
|
+
const applies = (e)=>aroundScene(e.target) && hoverReach(viz) > 0;
|
|
48
|
+
const move = (e)=>{
|
|
49
|
+
if (!applies(e)) return;
|
|
50
|
+
const point = local(e);
|
|
51
|
+
routePointerEvent(viz, {
|
|
52
|
+
type: "mousemove",
|
|
53
|
+
point,
|
|
54
|
+
pick: null,
|
|
55
|
+
nativeEvent: e
|
|
56
|
+
});
|
|
57
|
+
};
|
|
58
|
+
const click = (e)=>{
|
|
59
|
+
if (!applies(e)) return;
|
|
60
|
+
const point = local(e);
|
|
61
|
+
if (!nearestPick(viz, null, point)) return;
|
|
62
|
+
e.stopPropagation();
|
|
63
|
+
routePointerEvent(viz, {
|
|
64
|
+
type: "click",
|
|
65
|
+
point,
|
|
66
|
+
pick: null,
|
|
67
|
+
nativeEvent: e
|
|
68
|
+
});
|
|
69
|
+
};
|
|
70
|
+
const leave = (e)=>{
|
|
71
|
+
if (state.key === null) return;
|
|
72
|
+
const point = local(e);
|
|
73
|
+
routePointerEvent(viz, {
|
|
74
|
+
type: "mouseleave",
|
|
75
|
+
point,
|
|
76
|
+
pick: null,
|
|
77
|
+
nativeEvent: e
|
|
78
|
+
});
|
|
79
|
+
};
|
|
80
|
+
svg.addEventListener("mousemove", move);
|
|
81
|
+
svg.addEventListener("click", click, true);
|
|
82
|
+
svg.addEventListener("mouseleave", leave);
|
|
83
|
+
state.surface = {
|
|
84
|
+
el: svg,
|
|
85
|
+
aroundScene,
|
|
86
|
+
unbind: ()=>{
|
|
87
|
+
svg.removeEventListener("mousemove", move);
|
|
88
|
+
svg.removeEventListener("click", click, true);
|
|
89
|
+
svg.removeEventListener("mouseleave", leave);
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
}
|
|
@@ -1,16 +1,19 @@
|
|
|
1
1
|
import { scaleOrdinal } from "d3-scale";
|
|
2
|
-
import { colorDefaults
|
|
2
|
+
import { colorDefaults } from "@d3plus/color";
|
|
3
|
+
import { themeRamp, themeScaleColor } from "../../utils/theme.js";
|
|
3
4
|
/**
|
|
4
5
|
Stamps `viz._ordinalColorScale` for ordinal color mode.
|
|
5
6
|
|
|
6
|
-
When `colorOrdinal` is on (and no continuous `colorScale` is set), a
|
|
7
|
-
color field is treated as *ordered*: its distinct values take a
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
(pre-sort your data, or drive it
|
|
12
|
-
control non-numeric ramps) — then
|
|
13
|
-
|
|
7
|
+
When `colorOrdinal` is on (and no continuous `colorScale` is set), a
|
|
8
|
+
discrete color field is treated as *ordered*: its distinct values take a
|
|
9
|
+
single-hue ramp so the color encodes the order (light→dark, or dim→bright
|
|
10
|
+
on a dark theme). This walks the drawn data to collect the distinct values
|
|
11
|
+
in a stable order — numeric values sort ascending; everything else keeps
|
|
12
|
+
the order it first appears in the data (pre-sort your data, or drive it
|
|
13
|
+
with the existing ordering config, to control non-numeric ramps) — then
|
|
14
|
+
maps them onto an OKLab ramp of the default sequential hue (the theme's
|
|
15
|
+
`colorScale.max` on a dark or custom theme). Clears the scale when the
|
|
16
|
+
mode is off.
|
|
14
17
|
*/ export function configureOrdinalColor(viz) {
|
|
15
18
|
if (!viz.schema.colorOrdinal || viz.schema.colorScale) {
|
|
16
19
|
viz._ordinalColorScale = undefined;
|
|
@@ -32,8 +35,7 @@ import { colorDefaults, colorRamp } from "@d3plus/color";
|
|
|
32
35
|
...values
|
|
33
36
|
].sort((a, b)=>a - b) : values;
|
|
34
37
|
const keys = ordered.map((v)=>typeof v === "string" ? v : JSON.stringify(v));
|
|
35
|
-
const
|
|
36
|
-
|
|
37
|
-
});
|
|
38
|
+
const base = themeScaleColor(viz._theme, "max", (viz.schema.colorDefaults ?? colorDefaults).sequential);
|
|
39
|
+
const range = themeRamp(viz._theme, base, keys.length || 1, true);
|
|
38
40
|
viz._ordinalColorScale = scaleOrdinal().domain(keys).range(range);
|
|
39
41
|
}
|