@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
|
@@ -1,15 +1,22 @@
|
|
|
1
1
|
import type { VizInstance } from "./vizTypes.js";
|
|
2
|
-
type InkTarget = Pick<VizInstance, "schema"> & Partial<Pick<VizInstance, "_select">>;
|
|
2
|
+
type InkTarget = Pick<VizInstance, "schema"> & Partial<Pick<VizInstance, "_select" | "_theme">>;
|
|
3
3
|
/**
|
|
4
|
-
The chart's background
|
|
4
|
+
The chart's background: its theme's (the page's own in `"auto"` mode), or,
|
|
5
|
+
before the chart has drawn, the one detected behind its container (white
|
|
5
6
|
before the chart is mounted).
|
|
6
7
|
@private
|
|
7
8
|
*/
|
|
8
|
-
export declare function chartBackground(viz: Partial<Pick<VizInstance, "_select">>): string;
|
|
9
|
+
export declare function chartBackground(viz: Partial<Pick<VizInstance, "_select" | "_theme">>): string;
|
|
9
10
|
/**
|
|
10
11
|
The text color that reads against the chart's own background: dark on a
|
|
11
|
-
light page, light on a dark one
|
|
12
|
+
light page, light on a dark one, or the theme's `text`.
|
|
12
13
|
@private
|
|
13
14
|
*/
|
|
14
15
|
export declare function backgroundInk(viz: InkTarget): string;
|
|
16
|
+
/**
|
|
17
|
+
The chart's gridline color: the theme's `gridline`, a faint step off the
|
|
18
|
+
chart's background.
|
|
19
|
+
@private
|
|
20
|
+
*/
|
|
21
|
+
export declare function chartGridline(viz: InkTarget): string;
|
|
15
22
|
export {};
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The ring drawn around the mark keyboard focus rests on.
|
|
3
|
+
|
|
4
|
+
@module
|
|
5
|
+
*/
|
|
6
|
+
import type { GroupNode } from "@d3plus/render";
|
|
7
|
+
import type { FocusTarget } from "./focusTargets.js";
|
|
8
|
+
/** How the focus ring is drawn, resolved to plain values. */
|
|
9
|
+
export interface FocusRingStyle {
|
|
10
|
+
/** The ring's color. */
|
|
11
|
+
stroke: string;
|
|
12
|
+
/** The ring's width, in pixels. */
|
|
13
|
+
strokeWidth: number;
|
|
14
|
+
/** Space between the mark and a rectangular or circular ring, in pixels. */
|
|
15
|
+
padding: number;
|
|
16
|
+
/** A wider band drawn beneath the ring (the chart's background color), so the ring reads over any mark color. */
|
|
17
|
+
halo: string;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
The `viz-focus` scene group outlining `target`: a padded rectangle around
|
|
21
|
+
a rect-like mark or a stroke-only path, a circle around a circle or series
|
|
22
|
+
point, and the mark's own outline for a filled path. Inert and hidden from
|
|
23
|
+
assistive tech.
|
|
24
|
+
*/
|
|
25
|
+
export declare function focusRingNode(target: FocusTarget, style: FocusRingStyle): GroupNode;
|
|
@@ -0,0 +1,56 @@
|
|
|
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
|
+
*/
|
|
7
|
+
import type { Bounds } from "@d3plus/math";
|
|
8
|
+
import type { SceneNode, Transform } from "@d3plus/render";
|
|
9
|
+
/** A data mark (or one point of a Line/Area) keyboard focus can rest on. */
|
|
10
|
+
export interface FocusTarget {
|
|
11
|
+
/** Unique within a scene: the node's key, plus `@<point>` for a series point. */
|
|
12
|
+
id: string;
|
|
13
|
+
/** The scene node an event over this target picks. */
|
|
14
|
+
node: SceneNode;
|
|
15
|
+
/** Which of the node's `interactionPoints` this target is, for a series point. */
|
|
16
|
+
pointIndex?: number;
|
|
17
|
+
/** The target's center, in surface coordinates. */
|
|
18
|
+
center: [number, number];
|
|
19
|
+
/** The target's bounding box, in surface coordinates (zero-size for a series point). */
|
|
20
|
+
box: Bounds;
|
|
21
|
+
/** Whether events over it route to the chart's shape or legend handlers. */
|
|
22
|
+
group: "shape" | "legend";
|
|
23
|
+
/** The transforms above the node, outermost first (not its own). */
|
|
24
|
+
chain: Transform[];
|
|
25
|
+
}
|
|
26
|
+
/** The arrow-key directions. */
|
|
27
|
+
export type FocusDirection = "up" | "down" | "left" | "right";
|
|
28
|
+
/**
|
|
29
|
+
Sorts targets left to right by their left edge, then top to bottom: bars
|
|
30
|
+
and series points read along the x axis, a stack or a vertical legend
|
|
31
|
+
reads downward, and a treemap starts at its top-left cell.
|
|
32
|
+
*/
|
|
33
|
+
export declare function readingOrder(targets: FocusTarget[]): FocusTarget[];
|
|
34
|
+
/**
|
|
35
|
+
Every mark keyboard focus can visit in a painted scene, chart marks first
|
|
36
|
+
and then legend items, each in reading order (see `readingOrder`).
|
|
37
|
+
Visits the chart cells and the legend only (not the colorScale, timeline,
|
|
38
|
+
or chrome), skipping `::hit` duplicates, inert or aria-hidden nodes,
|
|
39
|
+
text, axis/trend chrome, nodes without a datum, and marks a rectangular
|
|
40
|
+
clip hides (a zoomed chart's off-screen marks). A Line or Area node
|
|
41
|
+
becomes one target per point, and a row drawn by several nodes counts
|
|
42
|
+
once.
|
|
43
|
+
@param nodes The scene root's children (`viz._paintedScene.root.children`).
|
|
44
|
+
*/
|
|
45
|
+
export declare function focusTargets(nodes: SceneNode[]): FocusTarget[];
|
|
46
|
+
/**
|
|
47
|
+
The target an arrow key moves to from `current`: the nearest one in that
|
|
48
|
+
direction whose center lies within a 45° cone of it, where two marks that
|
|
49
|
+
overlap across the direction of travel (bars sharing a baseline, cells
|
|
50
|
+
in one row) count as level with each other. Without one in the cone, the
|
|
51
|
+
nearest center anywhere in that half-plane. Returns `current` when
|
|
52
|
+
nothing lies that way, and the first target when there is no current
|
|
53
|
+
one. Moving along a series (Line/Area points), its own next point counts
|
|
54
|
+
as level, so the series is followed rather than a neighbor's point.
|
|
55
|
+
*/
|
|
56
|
+
export declare function nextTarget(targets: FocusTarget[], current: FocusTarget | null | undefined, direction: FocusDirection): FocusTarget | null;
|
|
@@ -0,0 +1,35 @@
|
|
|
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
|
+
*/
|
|
6
|
+
import type { DrillDownHistoryEntry, HistoryEntry, LegendHistoryEntry, LegendState, VizInstance } from "./vizTypes.js";
|
|
7
|
+
/** Whether a Back history entry records a legend click. */
|
|
8
|
+
export declare function isLegendEntry(entry: HistoryEntry): entry is LegendHistoryEntry;
|
|
9
|
+
/** The newest drill-down entry on a Back history, skipping legend entries. */
|
|
10
|
+
export declare function latestDrillEntry(history: HistoryEntry[] | undefined): DrillDownHistoryEntry | undefined;
|
|
11
|
+
/** Removes and returns the newest drill-down entry, leaving the legend entries around it in place. */
|
|
12
|
+
export declare function removeLatestDrillEntry(history: HistoryEntry[] | undefined): DrillDownHistoryEntry | undefined;
|
|
13
|
+
/** Whether two legend id lists hold the same ids, in any order. */
|
|
14
|
+
export declare function sameLegendIds(a: (string | number)[], b: (string | number)[]): boolean;
|
|
15
|
+
/** The chart's current legend hide/solo state, as a Back history entry. */
|
|
16
|
+
export declare function legendSnapshot(viz: VizInstance): LegendHistoryEntry;
|
|
17
|
+
/**
|
|
18
|
+
Records a legend click on the Back history: pushes `before` (the state
|
|
19
|
+
the click started from) when the click changed what is hidden or solo'd
|
|
20
|
+
and `legendHistory` is on. Returns whether it pushed.
|
|
21
|
+
*/
|
|
22
|
+
export declare function recordLegendChange(viz: VizInstance, before: LegendHistoryEntry): boolean;
|
|
23
|
+
/** Puts back the legend state a history entry recorded. */
|
|
24
|
+
export declare function restoreLegendEntry(viz: VizInstance, entry: LegendState): void;
|
|
25
|
+
/**
|
|
26
|
+
Clears the legend's hide/solo state for a drill to a deeper level, whose
|
|
27
|
+
legend lists other groups, and returns the state it cleared for the
|
|
28
|
+
drill's history entry (undefined when nothing was hidden or solo'd).
|
|
29
|
+
*/
|
|
30
|
+
export declare function takeLegendState(viz: VizInstance): LegendState | undefined;
|
|
31
|
+
/**
|
|
32
|
+
Drops the legend's steps from the Back history: every legend entry, and
|
|
33
|
+
the legend state drill-down entries would put back. The drill-downs stay.
|
|
34
|
+
*/
|
|
35
|
+
export declare function dropLegendHistory(viz: VizInstance): void;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Keyboard navigation between a chart's data marks (`keyboardNav`). The
|
|
3
|
+
chart is one Tab stop: a focusable host beside its root svg (see
|
|
4
|
+
`keyboardNavHost.ts`). Arrow keys move between marks spatially, and each
|
|
5
|
+
move is replayed through the pointer bridge as the events a mouse would
|
|
6
|
+
send over that mark, so tooltips, hover highlights, the shared tooltip,
|
|
7
|
+
click handlers, and drill-down all behave as they do for the pointer.
|
|
8
|
+
|
|
9
|
+
@module
|
|
10
|
+
*/
|
|
11
|
+
import type { SceneNode, Transform } from "@d3plus/render";
|
|
12
|
+
import type { FocusRingStyle } from "./focusRing.js";
|
|
13
|
+
import type { FocusTarget } from "./focusTargets.js";
|
|
14
|
+
import type { KeyboardNavHost } from "./keyboardNavHost.js";
|
|
15
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
16
|
+
/** A chart's keyboard-navigation state, kept on `viz._keyboardNav`. */
|
|
17
|
+
export interface KeyboardNavState extends KeyboardNavHost {
|
|
18
|
+
/** The `id` of the focused target, or null when no mark is focused. */
|
|
19
|
+
current: string | null;
|
|
20
|
+
/** The target the replayed pointer last entered, for the matching leave. */
|
|
21
|
+
hovered: FocusTarget | null;
|
|
22
|
+
/** The chart scene and zoom the focused target was last resolved against. */
|
|
23
|
+
chartScene?: SceneNode[];
|
|
24
|
+
zoom?: Transform;
|
|
25
|
+
/** Set when a redraw moved or replaced the focused mark, so it is re-entered. */
|
|
26
|
+
stale: boolean;
|
|
27
|
+
/** Replayed events waiting for an animated transition to settle. */
|
|
28
|
+
queue: (() => void)[];
|
|
29
|
+
timer?: ReturnType<typeof setTimeout>;
|
|
30
|
+
/** The host's DOM listeners, for removal. */
|
|
31
|
+
listeners: [string, EventListener][];
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
What the live region announces for a target: a series point's label from
|
|
35
|
+
the chart's `ariaLabel` accessor, a mark's own `aria-label`, or else its
|
|
36
|
+
label as the tooltip titles it.
|
|
37
|
+
*/
|
|
38
|
+
export declare function targetLabel(viz: VizInstance, target: FocusTarget): string;
|
|
39
|
+
/** The focus ring's style for a target, from `keyboardNavConfig`. */
|
|
40
|
+
export declare function focusRingStyle(viz: VizInstance, target: FocusTarget): FocusRingStyle;
|
|
41
|
+
/** Removes the host and its listeners, clearing any replayed hover. */
|
|
42
|
+
export declare function teardownKeyboardNav(viz: VizInstance): void;
|
|
43
|
+
/**
|
|
44
|
+
Brings the host in line with the chart after a paint: creates it (or
|
|
45
|
+
removes it under `keyboardNav(false)`), refreshes its name and box, and
|
|
46
|
+
re-enters the focused mark when a redraw moved or replaced it.
|
|
47
|
+
*/
|
|
48
|
+
export declare function syncKeyboardNav(viz: VizInstance): void;
|
|
49
|
+
/**
|
|
50
|
+
The focus ring for the scene being built, appended last so it draws above
|
|
51
|
+
everything. Resolves the focused mark by its id in `children`, falling
|
|
52
|
+
back to the first mark when a redraw removed it (and marking the state
|
|
53
|
+
stale so `syncKeyboardNav` re-enters it).
|
|
54
|
+
*/
|
|
55
|
+
export declare function appendFocusRing(viz: VizInstance, children: SceneNode[]): void;
|
|
@@ -0,0 +1,53 @@
|
|
|
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
|
+
*/
|
|
9
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
10
|
+
/** The host's elements. */
|
|
11
|
+
export interface KeyboardNavHost {
|
|
12
|
+
/** The focusable element, laid over the chart without taking pointer events. */
|
|
13
|
+
host: HTMLDivElement;
|
|
14
|
+
/** Visually hidden instructions, referenced by the host's `aria-describedby`. */
|
|
15
|
+
desc: HTMLSpanElement;
|
|
16
|
+
/** Visually hidden `aria-live` region announcing the focused mark. */
|
|
17
|
+
live: HTMLSpanElement;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
A chart's own keys, consulted before mark navigation (a Geomap globe
|
|
21
|
+
turns on Shift and the arrow keys).
|
|
22
|
+
*/
|
|
23
|
+
export interface KeyboardGesture {
|
|
24
|
+
/** Handles a keydown; true when the chart took the key. */
|
|
25
|
+
keydown(event: KeyboardEvent): boolean;
|
|
26
|
+
/**
|
|
27
|
+
The keys the chart takes now, as `aria-keyshortcuts` lists them, and
|
|
28
|
+
their translated instructions; null when it takes none.
|
|
29
|
+
*/
|
|
30
|
+
keys(): {
|
|
31
|
+
shortcuts: string;
|
|
32
|
+
instructions: string;
|
|
33
|
+
} | null;
|
|
34
|
+
}
|
|
35
|
+
/** The instructions read when the chart gains focus. */
|
|
36
|
+
export declare const KEYBOARD_NAV_INSTRUCTIONS = "Use arrow keys to move between data points, Enter to select, and Escape to exit.";
|
|
37
|
+
/** The text of an HTML string, tags removed and whitespace collapsed. */
|
|
38
|
+
export declare function plainText(html: unknown): string;
|
|
39
|
+
/**
|
|
40
|
+
The chart's accessible name: its `svgTitle`, else its `title` text, else
|
|
41
|
+
the translated word "Chart".
|
|
42
|
+
*/
|
|
43
|
+
export declare function chartName(viz: Pick<VizInstance, "schema">): string;
|
|
44
|
+
/**
|
|
45
|
+
Creates the host inside `parent`: a `tabindex="0"`, `role="application"`
|
|
46
|
+
element laid over the chart, with its instructions and live region.
|
|
47
|
+
*/
|
|
48
|
+
export declare function createKeyboardNavHost(parent: HTMLElement, uuid: string): KeyboardNavHost;
|
|
49
|
+
/**
|
|
50
|
+
Refreshes the host's name, description, and box from the chart's current
|
|
51
|
+
config and size, laying it over the chart's root svg.
|
|
52
|
+
*/
|
|
53
|
+
export declare function updateKeyboardNavHost(viz: VizInstance, { host, desc }: KeyboardNavHost): void;
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import type { ConfigField } from "../../fluent.js";
|
|
2
|
+
/** The loaders whose payload a `<key>Format` config key transforms. */
|
|
3
|
+
export declare const FORMAT_KEYS: readonly ["data", "links", "nodes", "topojson"];
|
|
4
|
+
/** A loader with a matching `<key>Format` config key. */
|
|
5
|
+
export type FormatKey = (typeof FORMAT_KEYS)[number];
|
|
6
|
+
/** Transforms a loader's payload (a loaded file or an inline value). */
|
|
7
|
+
export type LoadFormatter = (data: unknown) => unknown;
|
|
8
|
+
/** A loader's last value, and the formatter its stored payload went through. */
|
|
9
|
+
export interface LoaderState {
|
|
10
|
+
source: unknown;
|
|
11
|
+
applied: LoadFormatter | undefined;
|
|
12
|
+
}
|
|
13
|
+
/** A queued load: `[load, paths, formatter, key]`. */
|
|
14
|
+
type QueueEntry = [unknown, unknown, unknown, string];
|
|
15
|
+
/** The chart state the loaders read and write. */
|
|
16
|
+
export interface LoaderHost {
|
|
17
|
+
schema: Record<string, unknown>;
|
|
18
|
+
config?(config: Record<string, unknown>): unknown;
|
|
19
|
+
_loaders?: Partial<Record<FormatKey, LoaderState>>;
|
|
20
|
+
_queue?: QueueEntry[];
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
Whether `key` names a loader with a `<key>Format` config key.
|
|
24
|
+
@private
|
|
25
|
+
*/
|
|
26
|
+
export declare function isFormatKey(key: string): key is FormatKey;
|
|
27
|
+
/**
|
|
28
|
+
The `<key>Format` function set on a chart, or `undefined` when none is set.
|
|
29
|
+
@private
|
|
30
|
+
*/
|
|
31
|
+
export declare function formatterFor(viz: LoaderHost, key: FormatKey): LoadFormatter | undefined;
|
|
32
|
+
/**
|
|
33
|
+
Runs `formatter` over a payload the way a loaded file is formatted: a
|
|
34
|
+
`data` formatter may return `{data, ...config}`, whose config is applied to
|
|
35
|
+
the chart. Without a formatter the payload passes through.
|
|
36
|
+
@private
|
|
37
|
+
*/
|
|
38
|
+
export declare function formatPayload(viz: LoaderHost, key: FormatKey, payload: unknown, formatter: LoadFormatter | undefined): unknown;
|
|
39
|
+
/**
|
|
40
|
+
Stores a loader's payload where its getter reads it: a `_<key>` slot when
|
|
41
|
+
the chart has one (`_data`), its schema otherwise.
|
|
42
|
+
@private
|
|
43
|
+
*/
|
|
44
|
+
export declare function storePayload(viz: LoaderHost, key: string, value: unknown): void;
|
|
45
|
+
/**
|
|
46
|
+
Sets a loader's value (`data`, `links`, `nodes`, `topojson`): a URL or
|
|
47
|
+
request object is queued to load on the next render, and an inline value is
|
|
48
|
+
stored at once. Passing a formatter as the second argument sets
|
|
49
|
+
`<key>Format`; leaving it out keeps the current one.
|
|
50
|
+
@param viz The chart.
|
|
51
|
+
@param key The loader.
|
|
52
|
+
@param args The loader's arguments: the value, then an optional formatter.
|
|
53
|
+
@private
|
|
54
|
+
*/
|
|
55
|
+
export declare function setLoaderValue(viz: LoaderHost, key: FormatKey, args: ArrayLike<unknown>): void;
|
|
56
|
+
/**
|
|
57
|
+
Brings each loader's stored payload in line with its current `<key>Format`
|
|
58
|
+
before a render draws: a URL whose formatter changed since it loaded is
|
|
59
|
+
queued to load again (from the chart's cache when it holds the response),
|
|
60
|
+
and an inline value is formatted in place from the
|
|
61
|
+
value it was given. Queued loads already use the current formatter.
|
|
62
|
+
@private
|
|
63
|
+
*/
|
|
64
|
+
export declare function syncLoaderFormats(viz: LoaderHost): void;
|
|
65
|
+
/**
|
|
66
|
+
The formatter a queued load of `key` runs: the chart's current
|
|
67
|
+
`<key>Format` for a loader that has one (recorded as applied), otherwise
|
|
68
|
+
the formatter queued with it.
|
|
69
|
+
@private
|
|
70
|
+
*/
|
|
71
|
+
export declare function queuedFormatter(viz: LoaderHost, key: string, queued: unknown): LoadFormatter | undefined;
|
|
72
|
+
/**
|
|
73
|
+
The `<key>Format` config fields for a chart's loaders. A new
|
|
74
|
+
`topojsonFormat` re-fits the map to the reformatted topojson.
|
|
75
|
+
@param keys The loaders the chart has.
|
|
76
|
+
*/
|
|
77
|
+
export declare function loaderFormatFields(...keys: FormatKey[]): ConfigField[];
|
|
78
|
+
export {};
|
|
@@ -0,0 +1,7 @@
|
|
|
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
|
+
*/
|
|
7
|
+
export declare function mountTargetFor(kind: string, target: Element): Element;
|
|
@@ -0,0 +1,75 @@
|
|
|
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
|
+
*/
|
|
9
|
+
import type { PickResult, SceneEvent, SceneNode } from "@d3plus/render";
|
|
10
|
+
import type { FocusTarget } from "./focusTargets.js";
|
|
11
|
+
import type { PointVoronoi, VoronoiPoint } from "./pointVoronoi.js";
|
|
12
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
13
|
+
/** A chart's point-mark Voronoi diagrams, built from one painted scene. */
|
|
14
|
+
interface PointIndex {
|
|
15
|
+
scene: unknown;
|
|
16
|
+
/** One diagram per small-multiples panel (keyed by panel key; `""` without panels). */
|
|
17
|
+
panels: Map<string, PointVoronoi<FocusTarget>>;
|
|
18
|
+
/** Every point mark's target, by node key. */
|
|
19
|
+
byKey: Map<string, FocusTarget>;
|
|
20
|
+
}
|
|
21
|
+
/** Per-chart nearest-hover state: the cached diagrams and the mark the pointer acts on. */
|
|
22
|
+
export interface NearestHoverState {
|
|
23
|
+
index?: PointIndex;
|
|
24
|
+
/** The key of the node the pointer resolves to, or null over nothing. */
|
|
25
|
+
key: string | null;
|
|
26
|
+
/** The outer `<svg>` `nearestHoverSurface` listens on, while it does. */
|
|
27
|
+
surface?: {
|
|
28
|
+
el: Element;
|
|
29
|
+
/** Whether an element lies in the empty space around the SVG scene. */
|
|
30
|
+
aroundScene: (el: EventTarget | null) => boolean;
|
|
31
|
+
/** Removes the listeners. */
|
|
32
|
+
unbind: () => void;
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
Whether a scene node draws a point: a Circle or Rect shape (or another of
|
|
37
|
+
`shapes`) that isn't part of a composite (a Box's rect).
|
|
38
|
+
*/
|
|
39
|
+
export declare function isPointShape(node: SceneNode, shapes?: readonly string[]): boolean;
|
|
40
|
+
/**
|
|
41
|
+
The point marks of a painted scene, as Voronoi points: every chart mark
|
|
42
|
+
keyboard navigation could visit (so `::hit` duplicates, inert nodes, and
|
|
43
|
+
marks clipped out by a zoom are left out) that `isPoint` accepts, at its
|
|
44
|
+
surface-space center with its inscribed radius.
|
|
45
|
+
@param nodes The scene root's children (`viz._paintedScene.root.children`).
|
|
46
|
+
@param isPoint Which nodes count as point marks.
|
|
47
|
+
*/
|
|
48
|
+
export declare function pointMarkTargets(nodes: SceneNode[], isPoint: (node: SceneNode) => boolean): VoronoiPoint<FocusTarget>[];
|
|
49
|
+
/** The pixel reach of nearest-point hover, or 0 when it is off for this chart. */
|
|
50
|
+
export declare function hoverReach(viz: VizInstance): number;
|
|
51
|
+
/**
|
|
52
|
+
The painted point mark a picked node stands for, while nearest-point
|
|
53
|
+
hover applies: the mark itself, or the one its `::hit` duplicate
|
|
54
|
+
widens. Undefined for anything else (bars, lines, legend items).
|
|
55
|
+
*/
|
|
56
|
+
export declare function pointTarget(viz: VizInstance, node: SceneNode | null | undefined): FocusTarget | undefined;
|
|
57
|
+
/**
|
|
58
|
+
The pick the pointer at `point` acts on, in place of `pick`: the nearest
|
|
59
|
+
point mark within `hoverDistance` (in the same small-multiples panel),
|
|
60
|
+
when `pick` is empty or something other than a point mark. A point mark,
|
|
61
|
+
a legend or timeline item, a trend line, or a mark's own label is kept as
|
|
62
|
+
picked, as is everything when nearest-point hover is off.
|
|
63
|
+
*/
|
|
64
|
+
export declare function nearestPick(viz: VizInstance, pick: PickResult | null, point: [number, number] | undefined): PickResult | null;
|
|
65
|
+
/**
|
|
66
|
+
The renderer's pointer bridge: resolves each event's pick through
|
|
67
|
+
`nearestPick` and hands it to `viz._routeSceneEvent` (a click that
|
|
68
|
+
resolves to nothing also runs `viz._backgroundClick`), firing
|
|
69
|
+
mouseleave/mouseenter whenever the mark the pointer resolves to changes
|
|
70
|
+
(in place of the renderer's own, which follow the raw pick). Events that
|
|
71
|
+
don't come from the renderer's pointer listeners pass through unchanged
|
|
72
|
+
apart from the pick.
|
|
73
|
+
*/
|
|
74
|
+
export declare function routePointerEvent(viz: VizInstance, event: SceneEvent): void;
|
|
75
|
+
export {};
|
|
@@ -0,0 +1,21 @@
|
|
|
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
|
+
*/
|
|
12
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
13
|
+
/**
|
|
14
|
+
Routes pointer events from the empty space around an SVG chart's scene
|
|
15
|
+
(see the module comment) while `hoverDistance` applies, binding to the
|
|
16
|
+
chart's outer `<svg>` once and rebinding when it changes. A click there
|
|
17
|
+
that resolves to a point is that point's alone: it stops before reaching
|
|
18
|
+
the chart DOM under the pointer (a Network's background, which clears
|
|
19
|
+
its focus). Removes the listeners on the Canvas renderer.
|
|
20
|
+
*/
|
|
21
|
+
export declare function nearestHoverSurface(viz: VizInstance, unbind?: boolean): void;
|
|
@@ -2,13 +2,15 @@ import type { VizInstance } from "./vizTypes.js";
|
|
|
2
2
|
/**
|
|
3
3
|
Stamps `viz._ordinalColorScale` for ordinal color mode.
|
|
4
4
|
|
|
5
|
-
When `colorOrdinal` is on (and no continuous `colorScale` is set), a
|
|
6
|
-
color field is treated as *ordered*: its distinct values take a
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
(pre-sort your data, or drive it
|
|
11
|
-
control non-numeric ramps) — then
|
|
12
|
-
|
|
5
|
+
When `colorOrdinal` is on (and no continuous `colorScale` is set), a
|
|
6
|
+
discrete color field is treated as *ordered*: its distinct values take a
|
|
7
|
+
single-hue ramp so the color encodes the order (light→dark, or dim→bright
|
|
8
|
+
on a dark theme). This walks the drawn data to collect the distinct values
|
|
9
|
+
in a stable order — numeric values sort ascending; everything else keeps
|
|
10
|
+
the order it first appears in the data (pre-sort your data, or drive it
|
|
11
|
+
with the existing ordering config, to control non-numeric ramps) — then
|
|
12
|
+
maps them onto an OKLab ramp of the default sequential hue (the theme's
|
|
13
|
+
`colorScale.max` on a dark or custom theme). Clears the scale when the
|
|
14
|
+
mode is off.
|
|
13
15
|
*/
|
|
14
16
|
export declare function configureOrdinalColor(viz: VizInstance): void;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Reads the page behind a chart (light or dark, and its background) and
|
|
3
|
+
redraws an `"auto"` themed chart when the page flips between the two.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
import type { PageTheme } from "../../utils/theme.js";
|
|
8
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
9
|
+
type PageTarget = Pick<VizInstance, "_select" | "_ssr">;
|
|
10
|
+
/**
|
|
11
|
+
The page behind the chart: the first non-transparent background among its
|
|
12
|
+
ancestors decides, or, when none sets one, the browser's own page canvas,
|
|
13
|
+
which is dark only when the page opts into a dark `color-scheme` and the
|
|
14
|
+
system prefers dark. Server renders are light.
|
|
15
|
+
*/
|
|
16
|
+
export declare function pageTheme(viz: PageTarget): PageTheme;
|
|
17
|
+
/** Whether the chart sits on a dark page (see `pageTheme`). */
|
|
18
|
+
export declare function pageIsDark(viz: PageTarget): boolean;
|
|
19
|
+
/**
|
|
20
|
+
Calls `onFlip` whenever the page might have changed theme: on a system
|
|
21
|
+
theme change, when the page flips a class/attribute/style on `<html>` or
|
|
22
|
+
`<body>` (how most theme toggles work), or when a background transition
|
|
23
|
+
ends. Returns the unsubscribe.
|
|
24
|
+
*/
|
|
25
|
+
export declare function watchPage(onFlip: () => void): () => void;
|
|
26
|
+
/**
|
|
27
|
+
Keeps an `"auto"` themed chart in step with its page: redraws it when the
|
|
28
|
+
page's dark state differs from the one it last drew with. Installed once
|
|
29
|
+
per chart; `unwatchPageTheme` removes it.
|
|
30
|
+
*/
|
|
31
|
+
export declare function watchPageTheme(viz: VizInstance): void;
|
|
32
|
+
/** Stops a chart's page-theme watcher, if it has one. */
|
|
33
|
+
export declare function unwatchPageTheme(viz: Pick<VizInstance, "_themeWatch">): void;
|
|
34
|
+
export {};
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Where a hovered point mark's tooltip points: the mark's painted box, in
|
|
3
|
+
client coordinates, so the tooltip's arrow meets the middle of its top
|
|
4
|
+
edge (its bottom edge when the tooltip flips below) and holds still
|
|
5
|
+
while the pointer moves within reach of the same point.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/
|
|
9
|
+
import type { VirtualElement } from "@floating-ui/dom";
|
|
10
|
+
import type { Bounds } from "@d3plus/math";
|
|
11
|
+
import type { SceneNode } from "@d3plus/render";
|
|
12
|
+
import type { VizInstance } from "./vizTypes.js";
|
|
13
|
+
/** A client-space position. */
|
|
14
|
+
export interface ClientOrigin {
|
|
15
|
+
left: number;
|
|
16
|
+
top: number;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
The client position of the drawing surface's origin: the scene `<svg>`'s
|
|
20
|
+
user-space origin (read off its screen CTM: a nested svg's bounding rect
|
|
21
|
+
is the box of its painted content), or the `<canvas>`'s corner. Falls
|
|
22
|
+
back to the chart's own element, then to the viewport origin.
|
|
23
|
+
*/
|
|
24
|
+
export declare function surfaceOrigin(viz: VizInstance): ClientOrigin;
|
|
25
|
+
/**
|
|
26
|
+
A tooltip anchor (a Floating UI virtual element) for a box in surface
|
|
27
|
+
coordinates, moved to client coordinates by `origin`.
|
|
28
|
+
*/
|
|
29
|
+
export declare function clientAnchor(box: Bounds, origin: ClientOrigin): VirtualElement;
|
|
30
|
+
/**
|
|
31
|
+
The tooltip anchor for a hovered node: its point mark's painted box when
|
|
32
|
+
nearest-point hover applies to it (see `pointTarget`), whether the
|
|
33
|
+
pointer is on the mark or only near it. Undefined otherwise, for the
|
|
34
|
+
tooltip to follow the pointer.
|
|
35
|
+
*/
|
|
36
|
+
export declare function pointTooltipAnchor(viz: VizInstance, node: SceneNode | null | undefined): VirtualElement | undefined;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A Voronoi diagram over a set of points: the nearest point to a position
|
|
3
|
+
(within a distance, measured from each point's edge), and each point's
|
|
4
|
+
clipped cell and neighbors.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/
|
|
8
|
+
import type { Bounds } from "@d3plus/math";
|
|
9
|
+
/** One point in the diagram. */
|
|
10
|
+
export interface VoronoiPoint<T = unknown> {
|
|
11
|
+
/** The point's center. */
|
|
12
|
+
x: number;
|
|
13
|
+
/** The point's center. */
|
|
14
|
+
y: number;
|
|
15
|
+
/** The mark's radius: distances are measured from its edge (default 0; a non-finite or negative radius counts as 0). */
|
|
16
|
+
r?: number;
|
|
17
|
+
/** What the point stands for (a scene node, a datum). */
|
|
18
|
+
item: T;
|
|
19
|
+
}
|
|
20
|
+
/** A `nearest` match. */
|
|
21
|
+
export interface VoronoiMatch<T = unknown> {
|
|
22
|
+
/** The point's index in the input array. */
|
|
23
|
+
index: number;
|
|
24
|
+
point: VoronoiPoint<T>;
|
|
25
|
+
/** The distance from the position to the point's edge (0 inside it). */
|
|
26
|
+
distance: number;
|
|
27
|
+
}
|
|
28
|
+
/** The Voronoi structure `pointVoronoi` builds. */
|
|
29
|
+
export interface PointVoronoi<T = unknown> {
|
|
30
|
+
/** The points, in input order. */
|
|
31
|
+
readonly points: readonly VoronoiPoint<T>[];
|
|
32
|
+
/** The box the cells are clipped to: the bounds given, grown to hold every point. */
|
|
33
|
+
readonly bounds: Bounds;
|
|
34
|
+
/**
|
|
35
|
+
The point closest to `[x, y]` whose edge lies within `maxDistance`
|
|
36
|
+
(default Infinity), or null. Ties go to the point with the nearer
|
|
37
|
+
center, then the lower index.
|
|
38
|
+
*/
|
|
39
|
+
nearest(x: number, y: number, maxDistance?: number): VoronoiMatch<T> | null;
|
|
40
|
+
/**
|
|
41
|
+
The point's Voronoi cell clipped to `bounds`, as an open ring of
|
|
42
|
+
vertices (the first vertex is not repeated at the end): every position
|
|
43
|
+
in it is closer to this point's center than to any other. Null for an
|
|
44
|
+
out-of-range index or a point that coincides with an earlier one.
|
|
45
|
+
*/
|
|
46
|
+
cell(index: number): [number, number][] | null;
|
|
47
|
+
/**
|
|
48
|
+
The indices of the points whose cells share an edge or a corner with
|
|
49
|
+
this one's (its Delaunay neighbors), in ascending order. Empty for a
|
|
50
|
+
lone point or one that coincides with an earlier one.
|
|
51
|
+
*/
|
|
52
|
+
neighbors(index: number): number[];
|
|
53
|
+
}
|
|
54
|
+
/** The distance from `[x, y]` to a polygon (0 inside it). */
|
|
55
|
+
export declare function polygonDistance(x: number, y: number, ring: [number, number][]): number;
|
|
56
|
+
/**
|
|
57
|
+
Builds a Voronoi diagram over `points` (with d3-delaunay), clipped to
|
|
58
|
+
`bounds`. Points with a non-finite coordinate are left out of the
|
|
59
|
+
diagram: `nearest` never returns them and their `cell` is null. The
|
|
60
|
+
Delaunay triangulation is built up front; the clipped cells only on the
|
|
61
|
+
first call that needs them.
|
|
62
|
+
@param points The points, in surface coordinates.
|
|
63
|
+
@param bounds The box to clip cells to (grown to hold every point).
|
|
64
|
+
*/
|
|
65
|
+
export declare function pointVoronoi<T>(points: readonly VoronoiPoint<T>[], bounds: Bounds): PointVoronoi<T>;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/** The `reducedMotion` setting: follow the OS (`"auto"`), or force it on or off. */
|
|
2
|
+
export type ReducedMotionSetting = "auto" | boolean;
|
|
3
|
+
/** Anything with a `duration` and an optional `reducedMotion` in its schema. */
|
|
4
|
+
export interface MotionHost {
|
|
5
|
+
schema: {
|
|
6
|
+
duration?: number;
|
|
7
|
+
reducedMotion?: ReducedMotionSetting;
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
Whether the viewer's OS asks for reduced motion, read from the
|
|
12
|
+
`(prefers-reduced-motion: reduce)` media query. False without a `window`
|
|
13
|
+
or `matchMedia` (server-side rendering, older runtimes).
|
|
14
|
+
*/
|
|
15
|
+
export declare function prefersReducedMotion(): boolean;
|
|
16
|
+
/**
|
|
17
|
+
Whether a chart draws without motion: `reducedMotion` `true` always,
|
|
18
|
+
`false` never, and `"auto"` (or unset) when the OS asks for it.
|
|
19
|
+
*/
|
|
20
|
+
export declare function motionReduced(host: MotionHost): boolean;
|
|
21
|
+
/**
|
|
22
|
+
The transition duration a chart animates with: 0 when motion is reduced,
|
|
23
|
+
otherwise its `duration` (the stored `duration` is left as the user set it).
|
|
24
|
+
*/
|
|
25
|
+
export declare function effectiveDuration(host: MotionHost): number;
|
|
@@ -27,22 +27,13 @@ export declare const backControlStyleDefault: {
|
|
|
27
27
|
width: string;
|
|
28
28
|
};
|
|
29
29
|
export declare const attributionStyleDefault: {
|
|
30
|
-
background: string;
|
|
31
|
-
color: string;
|
|
32
30
|
"border-radius": string;
|
|
33
31
|
display: string;
|
|
34
32
|
"align-items": string;
|
|
35
33
|
gap: string;
|
|
36
34
|
font: string;
|
|
37
|
-
};
|
|
38
|
-
export declare const attributionStyleDarkDefault: {
|
|
39
35
|
background: string;
|
|
40
36
|
color: string;
|
|
41
|
-
"border-radius": string;
|
|
42
|
-
display: string;
|
|
43
|
-
"align-items": string;
|
|
44
|
-
gap: string;
|
|
45
|
-
font: string;
|
|
46
37
|
};
|
|
47
38
|
/**
|
|
48
39
|
Default inline styles for the zoom-control buttons — structural only
|