@d3plus/core 4.10.0 → 4.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +178 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +176 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +101 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +192 -0
- package/es/src/charts/ArcDiagram/events.js +148 -0
- package/es/src/charts/ArcDiagram/index.js +217 -0
- package/es/src/charts/BarChart/index.js +12 -7
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +6 -11
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +160 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +137 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +206 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +6 -4
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/applyLayout.js +20 -9
- package/es/src/charts/Matrix/index.js +19 -1
- package/es/src/charts/Network/applyLayout.js +171 -96
- package/es/src/charts/Network/bundle.js +82 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +257 -75
- package/es/src/charts/Network/graph.js +146 -0
- package/es/src/charts/Network/graphFluent.js +81 -0
- package/es/src/charts/Network/index.js +91 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +15 -8
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +8 -1
- package/es/src/charts/Pack/neutralPaint.js +20 -0
- package/es/src/charts/Pack/nodeNames.js +35 -0
- package/es/src/charts/ParallelCoordinates/axes.js +22 -22
- package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +51 -96
- package/es/src/charts/Pie/index.js +74 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaEnter.js +68 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +34 -14
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +19 -17
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +40 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +2 -1
- package/es/src/charts/Plot/sharedTooltip.js +13 -3
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +4 -3
- package/es/src/charts/Priestley/applyLayout.js +21 -23
- package/es/src/charts/Priestley/index.js +4 -37
- package/es/src/charts/Priestley/timeAxis.js +103 -0
- package/es/src/charts/Pyramid/gutter.js +52 -16
- package/es/src/charts/Pyramid/index.js +55 -7
- package/es/src/charts/Pyramid/scene.js +4 -4
- package/es/src/charts/Radar/applyLayout.js +31 -33
- package/es/src/charts/Radar/axisDecorations.js +62 -13
- package/es/src/charts/Radar/curvedLabels.js +228 -0
- package/es/src/charts/Radar/emit.js +30 -15
- package/es/src/charts/Radar/index.js +43 -5
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +9 -1
- package/es/src/charts/RadialBar/index.js +26 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/index.js +18 -9
- package/es/src/charts/Rings/applyLayout.js +39 -161
- package/es/src/charts/Rings/emit.js +219 -63
- package/es/src/charts/Rings/index.js +88 -32
- package/es/src/charts/Rings/ringsCurves.js +156 -0
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +183 -0
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +61 -38
- package/es/src/charts/Sankey/applyLayout.js +130 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +78 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +83 -64
- package/es/src/charts/Sunburst/index.js +16 -4
- package/es/src/charts/Tree/applyLayout.js +44 -14
- package/es/src/charts/Tree/emit.js +5 -5
- package/es/src/charts/Tree/index.js +12 -18
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +14 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +10 -25
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +52 -23
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
- package/es/src/charts/drawSteps/zoomDrag.js +188 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +11 -4
- package/es/src/charts/events/click.shape.js +13 -4
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +9 -2
- package/es/src/charts/events/mousemove.legend.js +28 -32
- package/es/src/charts/events/mousemove.shape.js +45 -42
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +17 -5
- package/es/src/charts/features/axesFinal.js +10 -3
- package/es/src/charts/features/axesMeasure.js +33 -12
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/centerLabel.js +177 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +20 -1
- package/es/src/charts/features/colorScaleHover.js +33 -7
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +77 -0
- package/es/src/charts/features/colorScaleTop.js +61 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +191 -0
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +220 -5
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +75 -20
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/hoverTicks.js +41 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +364 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeStats.js +309 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +46 -12
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +54 -32
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +30 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +14 -5
- package/es/src/charts/partition/interaction.js +19 -10
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +22 -9
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/chrome.js +81 -9
- package/es/src/charts/polar/config.js +6 -3
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +61 -49
- package/es/src/charts/viz/VizBase.js +57 -14
- package/es/src/charts/viz/backgroundInk.js +23 -7
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +115 -32
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +29 -0
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +34 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -4
- package/es/src/charts/viz/vizDefaults.js +28 -57
- package/es/src/charts/viz/vizFields.js +41 -1
- package/es/src/charts/viz/vizRender.js +76 -31
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +26 -2
- package/es/src/components/Axis/Axis.js +35 -2
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +33 -8
- package/es/src/components/Axis/axisDefaults.js +16 -9
- package/es/src/components/Axis/axisLabelKinds.js +36 -0
- package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
- package/es/src/components/Axis/axisLabelRoom.js +37 -0
- package/es/src/components/Axis/axisLabelSize.js +171 -0
- package/es/src/components/Axis/axisLabelThinning.js +98 -4
- package/es/src/components/Axis/axisLayout.js +71 -46
- package/es/src/components/Axis/axisLayoutLabels.js +82 -140
- package/es/src/components/Axis/axisLayoutScale.js +16 -11
- package/es/src/components/Axis/axisLimit.js +27 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +20 -8
- package/es/src/components/Axis/axisRounding.js +16 -1
- package/es/src/components/Axis/axisScene.js +11 -2
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +128 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +77 -27
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +13 -2
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/Legend/legendCut.js +108 -0
- package/es/src/components/Legend/legendRender.js +38 -13
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +34 -67
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +9 -4
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +226 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +8 -5
- package/es/src/fluent.js +48 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +30 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configValue.js +9 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +268 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +46 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
- package/types/src/charts/ArcDiagram/events.d.ts +29 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
- package/types/src/charts/Network/applyLayout.d.ts +11 -0
- package/types/src/charts/Network/bundle.d.ts +69 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +73 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pack/applyLayout.d.ts +2 -0
- package/types/src/charts/Pack/groupRows.d.ts +46 -0
- package/types/src/charts/Pack/index.d.ts +3 -0
- package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
- package/types/src/charts/Pack/nodeNames.d.ts +23 -0
- package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
- package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
- package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaEnter.d.ts +34 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +16 -15
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
- package/types/src/charts/Pyramid/gutter.d.ts +28 -6
- package/types/src/charts/Pyramid/scene.d.ts +1 -1
- package/types/src/charts/Radar/applyLayout.d.ts +2 -3
- package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
- package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
- package/types/src/charts/Radar/emit.d.ts +5 -2
- package/types/src/charts/Radar/index.d.ts +7 -2
- package/types/src/charts/Radar/points.d.ts +50 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/Rings/emit.d.ts +72 -0
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
- package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/axisTooltip.d.ts +49 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/centerLabel.d.ts +75 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
- package/types/src/charts/features/colorScaleHover.d.ts +13 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +119 -0
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +103 -4
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/hoverTicks.d.ts +30 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +192 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotEndLabels.d.ts +14 -1
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +15 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +25 -4
- package/types/src/charts/viz/VizBase.d.ts +37 -8
- package/types/src/charts/viz/backgroundInk.d.ts +19 -4
- package/types/src/charts/viz/emphasis.d.ts +17 -0
- package/types/src/charts/viz/fillStroke.d.ts +7 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +26 -0
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +35 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +37 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +100 -7
- package/types/src/charts/viz/vizVisibility.d.ts +13 -0
- package/types/src/components/Axis/Axis.d.ts +34 -3
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +21 -3
- package/types/src/components/Axis/axisDefaults.d.ts +12 -0
- package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
- package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
- package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
- package/types/src/components/Axis/axisLayout.d.ts +9 -2
- package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
- package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
- package/types/src/components/Axis/axisLimit.d.ts +18 -0
- package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +8 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
- package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
- package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +6 -0
- package/types/src/components/Legend/legendCut.d.ts +31 -0
- package/types/src/components/Legend/legendRender.d.ts +6 -1
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +5 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/components/textEllipsis.d.ts +6 -0
- package/types/src/fluent.d.ts +18 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +1093 -266
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configValue.d.ts +8 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +72239 -41465
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +46249 -19519
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { Edges, Pt } from "../features/pathLabelGeometry.js";
|
|
3
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
4
|
+
/**
|
|
5
|
+
Obstacle points, bucketed by cell for nearest-distance lookups. Each
|
|
6
|
+
point may carry a tag, so a lookup can ignore the points of the line a
|
|
7
|
+
label sits on.
|
|
8
|
+
*/
|
|
9
|
+
export declare class PointGrid {
|
|
10
|
+
private cell;
|
|
11
|
+
private cells;
|
|
12
|
+
/** @param cell The cell size: lookups see obstacles this far away. */
|
|
13
|
+
constructor(cell: number);
|
|
14
|
+
/** A cell's key: its column and row, packed into one number. */
|
|
15
|
+
private static key;
|
|
16
|
+
/**
|
|
17
|
+
Adds obstacle points.
|
|
18
|
+
@param points The points.
|
|
19
|
+
@param tag A tag `nearest` can ignore them by.
|
|
20
|
+
*/
|
|
21
|
+
add(points: Pt[], tag?: number): void;
|
|
22
|
+
/**
|
|
23
|
+
The distance from `p` to its nearest obstacle within one cell, or `Infinity`.
|
|
24
|
+
@param p The point.
|
|
25
|
+
@param ignore A tag whose points are left out.
|
|
26
|
+
*/
|
|
27
|
+
nearest(p: Pt, ignore?: number): number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
Points every `step` pixels along a polyline.
|
|
31
|
+
@param points The polyline.
|
|
32
|
+
@param step The spacing.
|
|
33
|
+
*/
|
|
34
|
+
export declare function resample(points: Pt[], step: number): Pt[];
|
|
35
|
+
/**
|
|
36
|
+
How much a stretch bends: the sum of its turns, in radians.
|
|
37
|
+
@param points The stretch.
|
|
38
|
+
*/
|
|
39
|
+
export declare function curvature(points: Pt[]): number;
|
|
40
|
+
/** What scoring a stretch needs. */
|
|
41
|
+
export interface StretchContext {
|
|
42
|
+
grid: PointGrid;
|
|
43
|
+
rect: Edges;
|
|
44
|
+
fontSize: number;
|
|
45
|
+
/** How far above the line the text's baseline sits (below it when negative). */
|
|
46
|
+
lift: number;
|
|
47
|
+
/** The least room a label needs from every obstacle. Defaults to `2`. */
|
|
48
|
+
minClearance?: number;
|
|
49
|
+
/** The room past which a stretch scores no better. Defaults to the font size. */
|
|
50
|
+
roomReach?: number;
|
|
51
|
+
/** How much room counts against bends and slope. Defaults to `0.5`. */
|
|
52
|
+
roomWeight?: number;
|
|
53
|
+
/** How steep a stretch reads bottom to top (see `uprightPoints`). */
|
|
54
|
+
steep?: number;
|
|
55
|
+
/** A grid tag to ignore: the points of the line the label sits on. */
|
|
56
|
+
ignore?: number;
|
|
57
|
+
/** The most a stretch may turn in all, in radians (default a right angle). */
|
|
58
|
+
maxTurn?: number;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
The points a label along `points` would cover: its baseline and two rows
|
|
62
|
+
above it, up to its letters' height.
|
|
63
|
+
@param points The upright stretch.
|
|
64
|
+
@param ctx The font size and lift.
|
|
65
|
+
*/
|
|
66
|
+
export declare function labelBand(points: Pt[], ctx: StretchContext): Pt[];
|
|
67
|
+
/**
|
|
68
|
+
A stretch's score, lower being better: how much it bends and slopes, less
|
|
69
|
+
a bonus for room around its label (up to `roomReach`, weighted by
|
|
70
|
+
`roomWeight`); null when its label would leave the
|
|
71
|
+
plot or come within `minClearance` of an obstacle (another line or
|
|
72
|
+
label, or the edges of the band it runs in).
|
|
73
|
+
@param points The upright stretch.
|
|
74
|
+
@param ctx The obstacles, plot area, and font.
|
|
75
|
+
*/
|
|
76
|
+
export declare function scoreStretch(points: Pt[], ctx: StretchContext): number | null;
|
|
77
|
+
/** A stretch `bestStretchAt` found: its points, its piece, and where along the piece it starts. */
|
|
78
|
+
export interface StretchSpot {
|
|
79
|
+
points: Pt[];
|
|
80
|
+
piece: number;
|
|
81
|
+
from: number;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
The best-scoring stretch of `length` pixels along any of a line's
|
|
85
|
+
pieces, upright, with where it lies, or null when every stretch is
|
|
86
|
+
blocked or too bent.
|
|
87
|
+
@param pieces The line's pieces (where its data has gaps), in pixels.
|
|
88
|
+
@param length The stretch's length.
|
|
89
|
+
@param ctx The obstacles, plot area, and font.
|
|
90
|
+
@param allow Which stretches may be taken, by their piece and start.
|
|
91
|
+
*/
|
|
92
|
+
export declare function bestStretchAt(pieces: Pt[][], length: number, ctx: StretchContext, allow?: (from: number, piece: number) => boolean): StretchSpot | null;
|
|
93
|
+
/**
|
|
94
|
+
The best-scoring stretch of `length` pixels along any of a line's
|
|
95
|
+
pieces, upright, or null when every stretch is blocked or too bent.
|
|
96
|
+
@param pieces The line's pieces (where its data has gaps), in pixels.
|
|
97
|
+
@param length The stretch's length.
|
|
98
|
+
@param ctx The obstacles, plot area, and font.
|
|
99
|
+
*/
|
|
100
|
+
export declare function bestStretch(pieces: Pt[][], length: number, ctx: StretchContext): Pt[] | null;
|
|
101
|
+
/**
|
|
102
|
+
The label font a shape's labelConfig sets, as plain values.
|
|
103
|
+
@param viz The chart.
|
|
104
|
+
@param shape The shape whose labelConfig to read.
|
|
105
|
+
*/
|
|
106
|
+
export declare function labelFont(viz: VizInstance, shape?: string): Record<string, unknown>;
|
|
107
|
+
/**
|
|
108
|
+
The labels for every series `lineLabels` runs along its line, placed one
|
|
109
|
+
by one so each stays clear of the lines and the labels before it. A
|
|
110
|
+
plot (or panel) with a single line labels none. Counts the lines and
|
|
111
|
+
labels into `viz._alongStats`, for the legend (see `alongLegend.ts`).
|
|
112
|
+
@param viz The chart.
|
|
113
|
+
@param marks The plot's drawn marks, its Lines among them.
|
|
114
|
+
@param rect The plot area.
|
|
115
|
+
*/
|
|
116
|
+
export declare function emitAlongLabels(viz: VizInstance, marks: SceneNode[], rect: Edges): SceneNode[];
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { PlotDatum } from "../features/plotPaint.js";
|
|
2
|
+
/**
|
|
3
|
+
A unique scene key for each line marker. A marker is its series and its
|
|
4
|
+
discrete value, or its x/y position when the chart has no discrete axis;
|
|
5
|
+
a series that repeats one of those numbers its repeats, so no two markers
|
|
6
|
+
share a key (the renderer keeps one node per key, which would give every
|
|
7
|
+
marker that shares one the last one's datum).
|
|
8
|
+
@param values The markers' points.
|
|
9
|
+
@param discrete The chart's discrete axis, if any.
|
|
10
|
+
*/
|
|
11
|
+
export declare function lineMarkerKeys(values: PlotDatum[], discrete: unknown): Map<PlotDatum, string>;
|
|
@@ -9,9 +9,23 @@ export { preparePlotAxisLayout } from "./pipelineAxisLayout.js";
|
|
|
9
9
|
/**
|
|
10
10
|
The bubble radius scale: `sizeScale` over the extent of `sizes`, ranging
|
|
11
11
|
from `sizeMin` (capped at half of `sizeMax`) to `sizeMax`. A single-value
|
|
12
|
-
extent maps everything to `sizeMax`.
|
|
12
|
+
extent maps everything to `sizeMax`. With `sizeZero`, the smallest value's
|
|
13
|
+
radius is where a scale anchored at zero puts it instead (see
|
|
14
|
+
`zeroAnchoredRadius`).
|
|
13
15
|
*/
|
|
14
16
|
export declare function plotSizeScale(viz: Parameters<TransformStage>[0]["viz"], sizes: number[]): D3Scale;
|
|
17
|
+
/**
|
|
18
|
+
The radius a size scale anchored at zero (domain `[0, max]`, range
|
|
19
|
+
`[0, sizeMax]`) gives the smallest of `[min, max]`. A scale over
|
|
20
|
+
`[min, max]` starting at this radius draws every value where the anchored
|
|
21
|
+
one does: with a `"sqrt"` scale, each mark's area is proportional to its
|
|
22
|
+
value; with `"linear"`, its radius. NaN when the extent can't be anchored
|
|
23
|
+
at zero (a negative or non-positive extent, or a log scale).
|
|
24
|
+
@param make The size scale's constructor.
|
|
25
|
+
@param extent The size values' `[min, max]`.
|
|
26
|
+
@param sizeMax The largest radius.
|
|
27
|
+
*/
|
|
28
|
+
export declare function zeroAnchoredRadius(make: () => D3Scale, [lo, hi]: [number, number], sizeMax: number): number;
|
|
15
29
|
/**
|
|
16
30
|
Plot's size-legend scale, available before layout: the same scale
|
|
17
31
|
`formatPlotData` builds, over the plottable rows. Null when there's no
|
|
@@ -1,2 +1,70 @@
|
|
|
1
1
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
2
|
+
import { type LineLabelSide } from "./lineLabelSides.js";
|
|
3
|
+
/** A d3plus config value: a constant or a `(datum, index)` accessor. */
|
|
4
|
+
type ConfigAccessor<T> = T | ((d: Record<string, unknown>, i?: number) => T);
|
|
5
|
+
interface LineLabelCtx {
|
|
6
|
+
labelFunction: ConfigAccessor<string>;
|
|
7
|
+
fontColorAccessor: ConfigAccessor<string>;
|
|
8
|
+
fontSizeAccessor: ConfigAccessor<number>;
|
|
9
|
+
fontWeightAccessor: ConfigAccessor<number | string>;
|
|
10
|
+
fontFamilyAccessor: ConfigAccessor<string | string[]>;
|
|
11
|
+
paddingAccessor: ConfigAccessor<number>;
|
|
12
|
+
xEstimate: (d: unknown) => number;
|
|
13
|
+
yEstimate: (d: unknown) => number;
|
|
14
|
+
/** The value text for a label's point, or `undefined` without one. */
|
|
15
|
+
valueText: (value: unknown, d: Record<string, unknown>) => string | undefined;
|
|
16
|
+
/** The most room a label may take past its line's end, padding included. */
|
|
17
|
+
maxSpace?: number;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
Shortens a label to fit `maxWidth`: the name and value when both fit,
|
|
21
|
+
else the name alone, else the name cut short with an ellipsis, else
|
|
22
|
+
`null` (no room for even one letter).
|
|
23
|
+
*/
|
|
24
|
+
export declare function fitLineLabelText(name: string, value: string | undefined, maxWidth: number, measure: (text: string) => number): {
|
|
25
|
+
name: string;
|
|
26
|
+
value?: string;
|
|
27
|
+
} | null;
|
|
28
|
+
/**
|
|
29
|
+
The most room the labels at one end of a line chart may take: a quarter
|
|
30
|
+
of its `width` past its y axis (`yWidth`), so labels at both ends leave
|
|
31
|
+
the plot at least half of that, and labels never crowd the plot out of a
|
|
32
|
+
narrow chart or a small-multiples panel.
|
|
33
|
+
*/
|
|
34
|
+
export declare function lineLabelCap(width: number, yWidth?: number): number;
|
|
35
|
+
/**
|
|
36
|
+
Measures one end of a line's label (width, position, overlap coords): its
|
|
37
|
+
right end (`"end"`, the last point across) or its left end (`"start"`).
|
|
38
|
+
*/
|
|
39
|
+
export declare function measureLineLabel([lineKey, lineValues]: [unknown, Record<string, unknown>[]], ctx: LineLabelCtx, side?: LineLabelSide): {
|
|
40
|
+
id: unknown;
|
|
41
|
+
side: LineLabelSide;
|
|
42
|
+
name: string | undefined;
|
|
43
|
+
valueText: string | undefined;
|
|
44
|
+
labelWidth: number;
|
|
45
|
+
spaceNeeded: number;
|
|
46
|
+
value: unknown;
|
|
47
|
+
yEstimate: number;
|
|
48
|
+
padding: number;
|
|
49
|
+
fontSize: number;
|
|
50
|
+
fontColor: string;
|
|
51
|
+
edgeX: number;
|
|
52
|
+
xValue: unknown;
|
|
53
|
+
coords: number[][];
|
|
54
|
+
} | null;
|
|
55
|
+
/** A measured line label (see `measureLineLabel`). */
|
|
56
|
+
type LineLabel = NonNullable<ReturnType<typeof measureLineLabel>>;
|
|
57
|
+
/**
|
|
58
|
+
Whether another line passes through the space `label` would occupy past
|
|
59
|
+
its line's end: right of its last point, or left of its first point for a
|
|
60
|
+
`"start"` label.
|
|
61
|
+
*/
|
|
62
|
+
export declare function labelOverlapsLine(label: LineLabel, labels: LineLabel[]): boolean;
|
|
63
|
+
/**
|
|
64
|
+
The room the labels at one end of the plot claim: the widest label among
|
|
65
|
+
the lines that end at the x range's `edge`, at most `cap`; 0 when no line
|
|
66
|
+
reaches that edge.
|
|
67
|
+
*/
|
|
68
|
+
export declare function lineLabelSpace(labels: Pick<LineLabel, "edgeX" | "spaceNeeded">[], edge: number, cap: number): number;
|
|
2
69
|
export declare const measurePlotLineLabels: TransformStage;
|
|
70
|
+
export {};
|
|
@@ -14,6 +14,11 @@ import type { DomainValue, PlotFacetScales } from "./facetScales.js";
|
|
|
14
14
|
export declare function listAxis(viz: VizInstance, axis: string): boolean;
|
|
15
15
|
/** The `[min, max]` covering every extent (dates stay dates); undefined when none are numeric. */
|
|
16
16
|
export declare function unionExtent(extents: DomainValue[][]): DomainValue[] | undefined;
|
|
17
|
+
/**
|
|
18
|
+
Orders a stacked chart's legend by every panel's stacks, pooled (see
|
|
19
|
+
`stackLegendOrder.ts`), before the chrome lays the legend out.
|
|
20
|
+
*/
|
|
21
|
+
export declare function plotFacetChrome(viz: VizInstance, panels: DataPoint[][]): void;
|
|
17
22
|
/**
|
|
18
23
|
The domains (and size scale) that fit every panel's rows: a category axis
|
|
19
24
|
lists every panel's categories, in the order one chart of all the rows
|
|
@@ -29,6 +29,20 @@ export declare const plotSchema: ({
|
|
|
29
29
|
factory: typeof fillBetweenDefaults;
|
|
30
30
|
coerce?: undefined;
|
|
31
31
|
default?: undefined;
|
|
32
|
+
} | {
|
|
33
|
+
key: string;
|
|
34
|
+
merge: boolean;
|
|
35
|
+
factory: () => {
|
|
36
|
+
value: boolean;
|
|
37
|
+
};
|
|
38
|
+
coerce?: undefined;
|
|
39
|
+
default?: undefined;
|
|
40
|
+
} | {
|
|
41
|
+
key: string;
|
|
42
|
+
coerce: "identity";
|
|
43
|
+
factory: () => never[];
|
|
44
|
+
default?: undefined;
|
|
45
|
+
merge?: undefined;
|
|
32
46
|
} | {
|
|
33
47
|
key: string;
|
|
34
48
|
coerce: "identity";
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { type RangeBreakRule } from "../../components/Axis/rangeBreaks.js";
|
|
2
|
+
import type { D3Scale } from "../../utils/index.js";
|
|
3
|
+
import type { TransformStage } from "../pipeline/stages.js";
|
|
4
|
+
/** The viz a Plot pipeline stage reads. */
|
|
5
|
+
type PlotViz = Parameters<TransformStage>[0]["viz"];
|
|
6
|
+
/** The axes a Plot can draw time on. */
|
|
7
|
+
declare const AXES: readonly ["x", "x2", "y", "y2"];
|
|
8
|
+
/** One of a Plot's four axes. */
|
|
9
|
+
export type AxisName = (typeof AXES)[number];
|
|
10
|
+
/** An axis's `rangeBreaks` rules, from its axis config, when it plots time. */
|
|
11
|
+
export declare function plotRangeBreaks(viz: PlotViz, axis: AxisName): RangeBreakRule[];
|
|
12
|
+
/**
|
|
13
|
+
Whether an axis's `rangeBreaks` make it a time axis without `time`: the
|
|
14
|
+
axis config has rules, and `value` (the first row's) reads as a date — a
|
|
15
|
+
Date, a timestamp, or a date string.
|
|
16
|
+
*/
|
|
17
|
+
export declare function rangeBreaksTimeAxis(viz: PlotViz, axis: AxisName, value: unknown): boolean;
|
|
18
|
+
/**
|
|
19
|
+
The `rangeBreaks` a chart's timeline takes by default: those of the axis
|
|
20
|
+
that plots the chart's `time` values (the first row's time equals that
|
|
21
|
+
axis's value), else none.
|
|
22
|
+
*/
|
|
23
|
+
export declare function timelineRangeBreaks(viz: PlotViz): RangeBreakRule[];
|
|
24
|
+
/**
|
|
25
|
+
The rows to draw: those whose time every time axis shows. Rows inside
|
|
26
|
+
an axis's `rangeBreaks` are dropped, with a warning naming the axis.
|
|
27
|
+
*/
|
|
28
|
+
export declare function dropHiddenRows<T extends Record<string, unknown>>(viz: PlotViz, rows: T[]): T[];
|
|
29
|
+
/**
|
|
30
|
+
A Plot pipeline scale for `axis`: a broken time scale over the same
|
|
31
|
+
domain and range when the axis plots time with `rangeBreaks`, else the
|
|
32
|
+
scale as given.
|
|
33
|
+
*/
|
|
34
|
+
export declare function plotTimeScale(viz: PlotViz, axis: AxisName, scale: D3Scale): D3Scale;
|
|
35
|
+
export {};
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { Annotation } from "../features/annotationTypes.js";
|
|
2
|
+
import type { TransformStage } from "../pipeline/stages.js";
|
|
3
|
+
import type { DomainValue } from "./pipelineScales.js";
|
|
4
|
+
/** The viz a Plot pipeline stage reads. */
|
|
5
|
+
type PlotViz = Parameters<TransformStage>[0]["viz"];
|
|
6
|
+
/** The four Plot axes. */
|
|
7
|
+
type AxisKey = "x" | "y" | "x2" | "y2";
|
|
8
|
+
/**
|
|
9
|
+
The data-unit values reference lines and bands place on each axis, from
|
|
10
|
+
a list of annotations (`"plot"`-fraction entries and other kinds left
|
|
11
|
+
out).
|
|
12
|
+
@param annotations The chart's annotations, with `referenceLines` and `referenceBands` expanded.
|
|
13
|
+
*/
|
|
14
|
+
export declare function referenceDomainValues(annotations: Annotation[]): Record<AxisKey, unknown[]>;
|
|
15
|
+
/**
|
|
16
|
+
A continuous or time domain stretched to take in `values`, keeping its
|
|
17
|
+
orientation. Only the ends marked `open` move (an end the user set stays
|
|
18
|
+
put), and a log axis ignores values at or below zero. Returns the domain
|
|
19
|
+
itself when nothing changes.
|
|
20
|
+
@param domain The axis's `[start, end]` domain.
|
|
21
|
+
@param values The values to take in.
|
|
22
|
+
@param options Whether the axis is a time or log axis, and which ends may move.
|
|
23
|
+
*/
|
|
24
|
+
export declare function widenToValues(domain: DomainValue[], values: unknown[], options?: {
|
|
25
|
+
time?: boolean;
|
|
26
|
+
log?: boolean;
|
|
27
|
+
open?: [boolean, boolean];
|
|
28
|
+
}): DomainValue[];
|
|
29
|
+
/**
|
|
30
|
+
Which ends of an axis's domain may widen: those the user's domain leaves
|
|
31
|
+
unset (both, without one; the end, for a one-value `[start]`).
|
|
32
|
+
@param user The user's domain for the axis, if any.
|
|
33
|
+
*/
|
|
34
|
+
export declare function openDomainEnds(user: unknown): [boolean, boolean];
|
|
35
|
+
/**
|
|
36
|
+
Widens a Plot's auto domains to take in its reference lines and bands
|
|
37
|
+
(from `referenceLines`, `referenceBands`, and `"ReferenceLine"`/
|
|
38
|
+
`"ReferenceBand"` annotations), on continuous and time axes only. An
|
|
39
|
+
end set by the user's domain (`xDomain`, `xConfig.domain`, …) stays put.
|
|
40
|
+
@param viz The chart.
|
|
41
|
+
@param autoDomains Each axis's domain before the baseline is applied.
|
|
42
|
+
@param scales Each axis's scale type (`"Linear"`, `"Time"`, `"Point"`, …) and configured scale (`"log"`, …).
|
|
43
|
+
@param user The user's x and y domains, as `computePlotScales` reads them.
|
|
44
|
+
*/
|
|
45
|
+
export declare function widenReferenceDomains(viz: PlotViz, autoDomains: Record<AxisKey, DomainValue[] | undefined>, scales: Record<AxisKey, {
|
|
46
|
+
type: string;
|
|
47
|
+
config: string;
|
|
48
|
+
}>, user: Record<string, DomainValue[] | undefined>): Record<AxisKey, DomainValue[] | undefined>;
|
|
49
|
+
export {};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
3
|
+
/** The shapes whose own labels can name their legend entries. */
|
|
4
|
+
export declare const LEGEND_LABEL_SHAPES: string[];
|
|
5
|
+
/**
|
|
6
|
+
Whether a Plot's shape labels could name every legend entry: it draws
|
|
7
|
+
only Circles, Rects, and Bars, none of them with `label: false`.
|
|
8
|
+
@param viz The chart.
|
|
9
|
+
*/
|
|
10
|
+
export declare function shapeLabelsPossible(viz: VizInstance): boolean;
|
|
11
|
+
/**
|
|
12
|
+
Counts a Plot's labelable shapes and the ones whose drawn label matches
|
|
13
|
+
their legend entry's into `viz._alongStats`, when every shape could be
|
|
14
|
+
named that way (see `shapeLabelsPossible`). A label cut short, or a
|
|
15
|
+
legend entry named by its color category, doesn't match.
|
|
16
|
+
@param viz The chart.
|
|
17
|
+
@param nodes The plot's shapes and their labels.
|
|
18
|
+
*/
|
|
19
|
+
export declare function countShapeLabels(viz: VizInstance, nodes: SceneNode[]): void;
|
|
@@ -37,11 +37,17 @@ export declare const SHARED_MEMBER_LIMIT = 5;
|
|
|
37
37
|
User `tooltipConfig` styles apply first; the shared title/rows win.
|
|
38
38
|
*/
|
|
39
39
|
export declare function renderSharedTooltip(viz: VizInstance, hover: SharedHover, event: SceneEvent): void;
|
|
40
|
+
/**
|
|
41
|
+
The single-mark tooltip's click hint: "Click to Expand" while the chart's
|
|
42
|
+
own `click.shape` handler is installed and a deeper `groupBy` level
|
|
43
|
+
exists for a click to drill into, else none.
|
|
44
|
+
*/
|
|
45
|
+
export declare function singleTooltipFooter(viz: VizInstance): string | false;
|
|
40
46
|
/**
|
|
41
47
|
The single-mark tooltip (one series, `tooltipShared(false)`, or a
|
|
42
48
|
side-by-side bar): the default title (the mark's label, unless
|
|
43
49
|
`tooltipConfig` sets one), its x and y values, its `confidence` bounds,
|
|
44
|
-
then any rows the chart's `tooltipConfig` adds, and a threshold bucket's
|
|
50
|
+
its colorScale value, then any rows the chart's `tooltipConfig` adds, and a threshold bucket's
|
|
45
51
|
series.
|
|
46
52
|
*/
|
|
47
53
|
export declare function renderSingleTooltip(viz: VizInstance, hover: SharedHover, event: SceneEvent): void;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A stacked Plot's legend order: its series in stacking order, from the
|
|
3
|
+
baseline outward, so the default `"descending"` order lists the largest
|
|
4
|
+
series first. The order is d3-stack's own (each drawn series' `index`),
|
|
5
|
+
which the chart's `stackOrder` sets, whatever the `stackOffset` does
|
|
6
|
+
with it: a diverging stack's negative series and a streamgraph's
|
|
7
|
+
centered layers keep the order they were stacked in.
|
|
8
|
+
|
|
9
|
+
@module
|
|
10
|
+
*/
|
|
11
|
+
import type { DataPoint } from "@d3plus/data";
|
|
12
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
13
|
+
/** Each series' summed fractional position across the stacks it appears in, and how many that is. */
|
|
14
|
+
export type StackPositions = Map<string, {
|
|
15
|
+
total: number;
|
|
16
|
+
count: number;
|
|
17
|
+
}>;
|
|
18
|
+
type Comparator = (a: DataPoint, b: DataPoint) => number;
|
|
19
|
+
/** A d3-stack series: its segments, and its place in the stacking order. */
|
|
20
|
+
type StackSeries = ArrayLike<ArrayLike<number>> & {
|
|
21
|
+
index?: number;
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
Where each series sits in the drawn stacks. Each stack (one per discrete
|
|
25
|
+
group) lists its non-empty segments in stacking order (each series'
|
|
26
|
+
d3-stack `index`, else its place in `stackData`), and each segment adds
|
|
27
|
+
its fractional position, `(rank + 0.5) / segments`, to its series. A
|
|
28
|
+
stacked bar keys each segment as its own series, so this also averages
|
|
29
|
+
bars that stack in different orders.
|
|
30
|
+
@param stackData The d3-stack output, `[series][group] = [start, end]`.
|
|
31
|
+
@param stackKeys Each series' stack key, in `stackData` order.
|
|
32
|
+
@param seriesOf The legend series a stack key belongs to; undefined skips it.
|
|
33
|
+
*/
|
|
34
|
+
export declare function stackPositions(stackData: StackSeries[], stackKeys: unknown[], seriesOf: (key: string) => string | undefined): StackPositions;
|
|
35
|
+
/**
|
|
36
|
+
Combines the positions of several sets of stacks (such as each small
|
|
37
|
+
multiple's) into one.
|
|
38
|
+
@param all Each set's positions.
|
|
39
|
+
*/
|
|
40
|
+
export declare function poolStackPositions(all: StackPositions[]): StackPositions;
|
|
41
|
+
/**
|
|
42
|
+
The series in reading order: by mean position, ties in the order the
|
|
43
|
+
positions list them.
|
|
44
|
+
@param positions Each series' stack positions.
|
|
45
|
+
*/
|
|
46
|
+
export declare function stackReadingOrder(positions: StackPositions): string[];
|
|
47
|
+
/**
|
|
48
|
+
The drawn order with the series it left out (hidden or soloed away)
|
|
49
|
+
kept in their previous place: each follows the series it followed
|
|
50
|
+
before, so hiding a series doesn't move it in the legend.
|
|
51
|
+
@param previous The order of the previous draw.
|
|
52
|
+
@param drawn The order of this draw.
|
|
53
|
+
@param keep The series still in the legend; others in `previous` drop out.
|
|
54
|
+
*/
|
|
55
|
+
export declare function mergeStackOrder(previous: string[], drawn: string[], keep: Set<string>): string[];
|
|
56
|
+
/**
|
|
57
|
+
The ids of the Plot series a row or legend entry stands for: its groupBy
|
|
58
|
+
values down to the drawn depth, joined like a Plot row's `id`. A legend
|
|
59
|
+
entry merging several series (an array at some level) stands for each
|
|
60
|
+
combination.
|
|
61
|
+
@param viz The chart.
|
|
62
|
+
@param d A row or legend entry.
|
|
63
|
+
@param i Its index.
|
|
64
|
+
*/
|
|
65
|
+
export declare function plotSeriesIds(viz: VizInstance, d: DataPoint, i: number): string[];
|
|
66
|
+
/**
|
|
67
|
+
Records a draw's stack positions as the legend's order (see
|
|
68
|
+
`stackLegendSort`), keeping series the draw left out where they were.
|
|
69
|
+
Undefined positions (an unstacked draw) clear it.
|
|
70
|
+
@param viz The chart.
|
|
71
|
+
@param positions The draw's stack positions.
|
|
72
|
+
*/
|
|
73
|
+
export declare function recordStackLegendOrder(viz: VizInstance, positions: StackPositions | undefined): void;
|
|
74
|
+
/**
|
|
75
|
+
A stacked Plot's default legend comparator: entries in the order of
|
|
76
|
+
`viz._stackLegendOrder` (an entry merging several series sits at their
|
|
77
|
+
mean place), then the entries the stacks don't place, with ties broken
|
|
78
|
+
by `fallback`. An unstacked chart sorts by `fallback` alone.
|
|
79
|
+
@param viz The chart.
|
|
80
|
+
@param fallback The comparator for everything the stack order doesn't settle.
|
|
81
|
+
*/
|
|
82
|
+
export declare function stackLegendSort(viz: VizInstance, fallback: Comparator): Comparator;
|
|
83
|
+
export {};
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { LinkLabelBox } from "../features/linkLabelGeometry.js";
|
|
3
|
+
import type { PlotAxisFn } from "../features/plotPaint.js";
|
|
4
|
+
import type { Edges, Pt } from "../features/pathLabelGeometry.js";
|
|
5
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
6
|
+
import type { TrendFit } from "./trendLines.js";
|
|
7
|
+
/** What `trendLineConfig.label` takes. */
|
|
8
|
+
export type TrendLabelSetting = boolean | "equation" | ((fit: TrendFit) => string | false | null | undefined);
|
|
9
|
+
/**
|
|
10
|
+
A fit's equation and R² as label text, e.g. `y = 2.1x + 3.4, R² = 0.84`,
|
|
11
|
+
its coefficients abbreviated as the axes abbreviate numbers. A fit along
|
|
12
|
+
a time axis shows only its R² (an equation in milliseconds since 1970
|
|
13
|
+
says nothing a reader can use).
|
|
14
|
+
@param fit The fitted trend line.
|
|
15
|
+
@param locale The chart's locale.
|
|
16
|
+
@param time Whether the fit runs along a time axis.
|
|
17
|
+
*/
|
|
18
|
+
export declare function trendEquationLabel(fit: Pick<TrendFit, "fit" | "axis">, locale: string, time?: boolean): string;
|
|
19
|
+
/**
|
|
20
|
+
A fit's label text for a `trendLineConfig.label` setting, or null for
|
|
21
|
+
none: `true` names the series ("Trend" for a line fit to every point),
|
|
22
|
+
`"equation"` gives its equation and R², and a function returns any text.
|
|
23
|
+
@param viz The chart.
|
|
24
|
+
@param fit The fitted trend line.
|
|
25
|
+
@param setting The configured label.
|
|
26
|
+
*/
|
|
27
|
+
export declare function trendLabelText(viz: VizInstance, fit: TrendFit, setting: unknown): string | null;
|
|
28
|
+
/** A label's box: its center, size, and turn in degrees. */
|
|
29
|
+
type Box = LinkLabelBox;
|
|
30
|
+
/** What placing a trend label needs. */
|
|
31
|
+
export interface TrendPlacement {
|
|
32
|
+
fontSize: number;
|
|
33
|
+
/** How far above the line's center the text's baseline sits. */
|
|
34
|
+
lift: number;
|
|
35
|
+
/** The label text's width. */
|
|
36
|
+
width: number;
|
|
37
|
+
/** The boxes of the labels already placed, which this one must clear. */
|
|
38
|
+
obstacles: Box[];
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
The path a fit's label follows and the boxes it covers, or null when its
|
|
42
|
+
line has no clear spot for it: the drawn (not projected) stretch inside
|
|
43
|
+
the plot, upright, stopped short of its end. The label prefers the end of
|
|
44
|
+
the line, just above it; when that spot overlaps an earlier label it
|
|
45
|
+
slides back along the line to the nearest clear stretch, then tries the
|
|
46
|
+
same below the line. A line too short for a few letters gets none.
|
|
47
|
+
@param points The fitted stretch's points, in pixels.
|
|
48
|
+
@param rect The plot area.
|
|
49
|
+
@param place The font, lift, text width, and labels to clear.
|
|
50
|
+
*/
|
|
51
|
+
export declare function trendLabelSpot(points: Pt[], rect: Edges, place: TrendPlacement): {
|
|
52
|
+
d: string;
|
|
53
|
+
boxes: Box[];
|
|
54
|
+
} | null;
|
|
55
|
+
/**
|
|
56
|
+
The boxes of the labels a trend label must clear: the line labels at the
|
|
57
|
+
lines' ends and along them, and Hexbin's contour labels, wherever they
|
|
58
|
+
sit among the marks.
|
|
59
|
+
@param marks The plot's marks.
|
|
60
|
+
*/
|
|
61
|
+
export declare function lineLabelBoxes(marks: SceneNode[]): Box[];
|
|
62
|
+
/**
|
|
63
|
+
The label nodes for every fitted trend line, when `trendLineConfig.label`
|
|
64
|
+
asks for them, placed one at a time (in series order) so none overlaps
|
|
65
|
+
another or the plot's line labels.
|
|
66
|
+
@param viz The chart.
|
|
67
|
+
@param x Maps an x value to pixels.
|
|
68
|
+
@param y Maps a y value to pixels.
|
|
69
|
+
@param rect The plot area.
|
|
70
|
+
@param marks The plot's marks, for the line labels to clear.
|
|
71
|
+
*/
|
|
72
|
+
export declare function emitTrendLabels(viz: VizInstance, x: PlotAxisFn, y: PlotAxisFn, rect: Edges, marks?: SceneNode[]): SceneNode[];
|
|
73
|
+
export {};
|
|
@@ -13,6 +13,12 @@ export declare const trendTypeNames: Record<string, string>;
|
|
|
13
13
|
@param axis The independent axis the fit runs along.
|
|
14
14
|
*/
|
|
15
15
|
export declare function trendEquation(fit: Pick<RegressionResult, "type" | "coefficients">, format?: (n: number) => string, axis?: "x" | "y"): string;
|
|
16
|
+
/**
|
|
17
|
+
Abbreviates a coefficient as the axes abbreviate their numbers, keeping
|
|
18
|
+
three significant digits on tiny values.
|
|
19
|
+
@param locale The chart's locale.
|
|
20
|
+
*/
|
|
21
|
+
export declare function coefficientFormat(locale: string): (n: number) => string;
|
|
16
22
|
/**
|
|
17
23
|
The tooltip rows for a fit: type, equation, R², and observations. Given a
|
|
18
24
|
projected sample, it leads with that projection: its independent-axis
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Time helpers Priestley and Gantt share: the `start`/`end` accessor
|
|
3
|
+
fields, the min/max aggregation seeds they register, date parsing for a
|
|
4
|
+
time-scaled axis, and the time axis render that pushes the axis scene and
|
|
5
|
+
returns its scale.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { Transform } from "@d3plus/render";
|
|
9
|
+
import type { AxisConfig } from "../../utils/D3plusConfig.js";
|
|
10
|
+
import type { ConfigField } from "../../fluent.js";
|
|
11
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
12
|
+
/** A start or end value: a date on a time axis, a number otherwise. */
|
|
13
|
+
export type TimeValue = number | Date;
|
|
14
|
+
/** The Axis surface the time axis render drives. */
|
|
15
|
+
export interface TimeAxisLike {
|
|
16
|
+
config: (c: unknown) => TimeAxisLike;
|
|
17
|
+
measure: () => TimeAxisLike;
|
|
18
|
+
renderMode: (m: string) => TimeAxisLike;
|
|
19
|
+
select: (el: HTMLElement | undefined) => TimeAxisLike;
|
|
20
|
+
render: () => TimeAxisLike;
|
|
21
|
+
outerBounds: () => {
|
|
22
|
+
height: number;
|
|
23
|
+
};
|
|
24
|
+
toScene: () => {
|
|
25
|
+
children?: unknown[];
|
|
26
|
+
} | undefined;
|
|
27
|
+
schema: {
|
|
28
|
+
padding: number;
|
|
29
|
+
orient?: string;
|
|
30
|
+
height: number;
|
|
31
|
+
maxSize?: AxisConfig["maxSize"];
|
|
32
|
+
};
|
|
33
|
+
_d3Scale: (v: TimeValue) => number;
|
|
34
|
+
}
|
|
35
|
+
/** The `start` and `end` accessor fields. */
|
|
36
|
+
export declare function timeFields(): ConfigField[];
|
|
37
|
+
/**
|
|
38
|
+
Seeds the `start`/`end` reducers for the default accessors, which are
|
|
39
|
+
functions the fields' `onSet` can't read a data key from, so the time
|
|
40
|
+
domain spans min(start)…max(end) instead of summing them.
|
|
41
|
+
*/
|
|
42
|
+
export declare function seedTimeAggs(viz: VizInstance): void;
|
|
43
|
+
/** Whether the chart's `axisConfig` plots dates. */
|
|
44
|
+
export declare function isTimeAxis(viz: VizInstance): boolean;
|
|
45
|
+
/**
|
|
46
|
+
Reads a start or end value: parsed as a date on a time axis, else a
|
|
47
|
+
number. Missing or unparseable values return null.
|
|
48
|
+
*/
|
|
49
|
+
export declare function parseTime(value: unknown, time: boolean): TimeValue | null;
|
|
50
|
+
/** Where the time axis draws, in the chart scene's coordinates. */
|
|
51
|
+
export interface TimeAxisFrame {
|
|
52
|
+
domain: number[];
|
|
53
|
+
width: number;
|
|
54
|
+
height: number;
|
|
55
|
+
/** Where the axis group sits. */
|
|
56
|
+
transform: Transform;
|
|
57
|
+
/** The axis group's scene key. */
|
|
58
|
+
key: string;
|
|
59
|
+
/** Extra config applied after `axisConfig` (e.g. a Gantt's default orient). */
|
|
60
|
+
config?: Record<string, unknown>;
|
|
61
|
+
}
|
|
62
|
+
/** The time axis's measured height and padding. */
|
|
63
|
+
export interface TimeAxisSize {
|
|
64
|
+
height: number;
|
|
65
|
+
padding: number;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
Measures the chart's time axis (`viz.ctx.axisTest`) over `frame`: the
|
|
69
|
+
height its ticks and labels take, and its padding.
|
|
70
|
+
*/
|
|
71
|
+
export declare function measureTimeAxis(viz: VizInstance, frame: Pick<TimeAxisFrame, "domain" | "width" | "height" | "config">): TimeAxisSize;
|
|
72
|
+
/**
|
|
73
|
+
Renders the chart's time axis (`viz.ctx.axis`) over `frame`, pushes its
|
|
74
|
+
scene onto `viz._chartScene` as chrome (see `inertAxis`), and returns its
|
|
75
|
+
scale.
|
|
76
|
+
*/
|
|
77
|
+
export declare function renderTimeAxis(viz: VizInstance, frame: TimeAxisFrame): (v: TimeValue) => number;
|
|
78
|
+
/** Reads a row's raw start or end through the chart's accessor. */
|
|
79
|
+
export declare function rowTime(viz: VizInstance, key: "start" | "end", d: DataPoint, i: number): unknown;
|