@d3plus/core 4.9.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +170 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +17 -12
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Funnel/index.js +2 -1
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Gauge/index.js +2 -1
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +60 -19
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +37 -16
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/index.js +3 -2
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +93 -108
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +7 -2
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +66 -32
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +14 -4
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +5 -5
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +65 -30
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +75 -77
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +42 -15
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +123 -0
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +34 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +67 -79
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/facet/facetData.d.ts +1 -1
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +13 -1
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/features.d.ts +8 -0
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +19 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/missingFields.d.ts +57 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +2 -8
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
2
|
+
import type { AnnotationRef } from "./annotationTypes.js";
|
|
3
|
+
import type { PlotAxisFn } from "./plotPaint.js";
|
|
4
|
+
/** A Plot axis an annotation can position against. */
|
|
5
|
+
export type AnnotationAxis = "x" | "y" | "x2" | "y2";
|
|
6
|
+
/** The plot area, in the chart's content pixels. */
|
|
7
|
+
export interface PlotRect {
|
|
8
|
+
x0: number;
|
|
9
|
+
y0: number;
|
|
10
|
+
x1: number;
|
|
11
|
+
y1: number;
|
|
12
|
+
}
|
|
13
|
+
/** One axis's mapping from data values to pixels. */
|
|
14
|
+
export interface AxisFrame {
|
|
15
|
+
/** Maps a (parsed) value to its pixel position. */
|
|
16
|
+
scale: (value: unknown) => number;
|
|
17
|
+
/** Whether the axis plots dates, so values parse as dates. */
|
|
18
|
+
time?: boolean;
|
|
19
|
+
/** A category axis's categories, which values must match (or fall between, when numeric). */
|
|
20
|
+
categories?: unknown[];
|
|
21
|
+
/** Whether each category fills a slot along the axis (bars), which spans take in whole. */
|
|
22
|
+
slots?: boolean;
|
|
23
|
+
}
|
|
24
|
+
/** The plot area and its axes, as annotations position against them. */
|
|
25
|
+
export interface AnnotationFrame {
|
|
26
|
+
plot: PlotRect;
|
|
27
|
+
axes: Partial<Record<AnnotationAxis, AxisFrame>>;
|
|
28
|
+
}
|
|
29
|
+
/** Whether an axis runs vertically. */
|
|
30
|
+
export declare const isVertical: (axis: AnnotationAxis) => boolean;
|
|
31
|
+
/**
|
|
32
|
+
The pixel position of `value` on `axis`, or NaN when it has none: the
|
|
33
|
+
axis is missing, the value is not one of a category axis's categories,
|
|
34
|
+
or it does not parse. A `"plot"` value is a fraction of the plot area
|
|
35
|
+
(`0` at the left or bottom edge, `1` at the right or top).
|
|
36
|
+
@param frame The plot area and its axes.
|
|
37
|
+
@param axis The axis the value is on.
|
|
38
|
+
@param value The value, in data units or as a fraction.
|
|
39
|
+
@param ref How the value is read.
|
|
40
|
+
*/
|
|
41
|
+
export declare function axisPixel(frame: AnnotationFrame, axis: AnnotationAxis, value: unknown, ref?: AnnotationRef): number;
|
|
42
|
+
/**
|
|
43
|
+
The pixel position of a number (or date) that is not itself a category
|
|
44
|
+
on an axis of numeric categories: interpolated between the categories on
|
|
45
|
+
either side of it, or NaN outside them or among non-numeric categories.
|
|
46
|
+
@param a The axis.
|
|
47
|
+
@param value The value.
|
|
48
|
+
*/
|
|
49
|
+
export declare function betweenCategories(a: AxisFrame, value: unknown): number;
|
|
50
|
+
/**
|
|
51
|
+
Half the pixel distance between neighboring categories on a category
|
|
52
|
+
axis whose categories fill slots (bars; half the plot's extent along it
|
|
53
|
+
when it has one category), or `0` on any other axis.
|
|
54
|
+
@param frame The plot area and its axes.
|
|
55
|
+
@param axis The axis.
|
|
56
|
+
*/
|
|
57
|
+
export declare function categoryHalfStep(frame: AnnotationFrame, axis: AnnotationAxis): number;
|
|
58
|
+
/**
|
|
59
|
+
The pixel extent `[lo, hi]` between two values on an axis, or null when
|
|
60
|
+
either has no position. On a category axis of bars it takes in each end
|
|
61
|
+
category's whole slot.
|
|
62
|
+
@param frame The plot area and its axes.
|
|
63
|
+
@param axis The axis the values are on.
|
|
64
|
+
@param values The two values.
|
|
65
|
+
@param ref How the values are read.
|
|
66
|
+
*/
|
|
67
|
+
export declare function axisSpan(frame: AnnotationFrame, axis: AnnotationAxis, values: [unknown, unknown], ref?: AnnotationRef): [number, number] | null;
|
|
68
|
+
/**
|
|
69
|
+
Clips a pixel extent to `[min, max]`, or null when nothing of it is left.
|
|
70
|
+
@param span The extent.
|
|
71
|
+
@param min The lower bound.
|
|
72
|
+
@param max The upper bound.
|
|
73
|
+
*/
|
|
74
|
+
export declare function clipSpan(span: [number, number], min: number, max: number): [number, number] | null;
|
|
75
|
+
/**
|
|
76
|
+
Whether a pixel point lies in the plot area, give or take `tolerance`.
|
|
77
|
+
@param point The point.
|
|
78
|
+
@param plot The plot area.
|
|
79
|
+
@param tolerance Pixels of slack on each side.
|
|
80
|
+
*/
|
|
81
|
+
export declare function inPlot([x, y]: [number, number], plot: PlotRect, tolerance?: number): boolean;
|
|
82
|
+
/**
|
|
83
|
+
The pixel position of an annotation row's anchor: its `x` (or `x2`, on
|
|
84
|
+
that axis) and `y` (or `y2`), or NaN coordinates when it has none.
|
|
85
|
+
@param frame The plot area and its axes.
|
|
86
|
+
@param d The row.
|
|
87
|
+
@param xRef How its x value is read.
|
|
88
|
+
@param yRef How its y value is read.
|
|
89
|
+
*/
|
|
90
|
+
export declare function anchorPoint(frame: AnnotationFrame, d: Record<string, unknown>, xRef?: AnnotationRef, yRef?: AnnotationRef): [number, number];
|
|
91
|
+
/**
|
|
92
|
+
The annotation frame of a painted Plot: its plot area in content pixels
|
|
93
|
+
and its rendered axes. `x2`/`y2` are present only when the chart plots
|
|
94
|
+
on them, and `slots` marks a bar chart, whose categories fill slots
|
|
95
|
+
along its discrete axis.
|
|
96
|
+
@param viz The chart.
|
|
97
|
+
@param measured The axis functions and ranges `renderAxes` solved.
|
|
98
|
+
*/
|
|
99
|
+
export declare function plotAnnotationFrame(viz: VizInstance, measured: {
|
|
100
|
+
x: PlotAxisFn;
|
|
101
|
+
y: PlotAxisFn;
|
|
102
|
+
xRange: number[];
|
|
103
|
+
yRange: number[];
|
|
104
|
+
x2Height: number;
|
|
105
|
+
x2Exists?: boolean;
|
|
106
|
+
y2Exists?: boolean;
|
|
107
|
+
slots?: boolean;
|
|
108
|
+
}): AnnotationFrame;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Text for callouts and reference labels: the theme-aware text style, the
|
|
3
|
+
label wrapped to a width, and the text node that draws it.
|
|
4
|
+
*/
|
|
5
|
+
import type { TextNode } from "@d3plus/render";
|
|
6
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
7
|
+
/** A resolved annotation text style. */
|
|
8
|
+
export interface AnnotationText {
|
|
9
|
+
fontColor: string;
|
|
10
|
+
fontFamily: string;
|
|
11
|
+
fontSize: number;
|
|
12
|
+
fontWeight: number | string;
|
|
13
|
+
lineHeight: number;
|
|
14
|
+
maxWidth: number;
|
|
15
|
+
}
|
|
16
|
+
/** A label wrapped into lines. */
|
|
17
|
+
export interface TextBlock {
|
|
18
|
+
lines: string[];
|
|
19
|
+
widths: number[];
|
|
20
|
+
/** The widest line's width. */
|
|
21
|
+
width: number;
|
|
22
|
+
/** All lines' height. */
|
|
23
|
+
height: number;
|
|
24
|
+
lineHeight: number;
|
|
25
|
+
}
|
|
26
|
+
/** Which way text lines up against its `x`. */
|
|
27
|
+
export type TextAlign = "start" | "middle" | "end";
|
|
28
|
+
/**
|
|
29
|
+
The text style for an annotation: each key from `config` (through `pick`,
|
|
30
|
+
which may read a row), else the defaults: the chart's text color for its
|
|
31
|
+
background and font family, 12px, weight 400, a 1.3 line height, and
|
|
32
|
+
a 150px wrap width.
|
|
33
|
+
@param viz The chart.
|
|
34
|
+
@param pick Reads one style key.
|
|
35
|
+
*/
|
|
36
|
+
export declare function annotationTextStyle(viz: VizInstance, pick: (key: string) => unknown): AnnotationText;
|
|
37
|
+
/**
|
|
38
|
+
Wraps `text` at the style's `maxWidth`, measuring each line.
|
|
39
|
+
@param text The label.
|
|
40
|
+
@param style The text style.
|
|
41
|
+
*/
|
|
42
|
+
export declare function wrapAnnotationText(text: string, style: AnnotationText): TextBlock;
|
|
43
|
+
/**
|
|
44
|
+
The text node that draws a wrapped label whose block's top edge sits at
|
|
45
|
+
`y`, lined up against `x` by `align` (its left edge, center, or right
|
|
46
|
+
edge). Inert: annotations take no pointer or keyboard focus.
|
|
47
|
+
@param block The wrapped label.
|
|
48
|
+
@param style Its text style.
|
|
49
|
+
@param at Where the block goes, and its key.
|
|
50
|
+
*/
|
|
51
|
+
export declare function annotationTextNode(block: TextBlock, style: AnnotationText, at: {
|
|
52
|
+
key: string;
|
|
53
|
+
x: number;
|
|
54
|
+
y: number;
|
|
55
|
+
align: TextAlign;
|
|
56
|
+
opacity?: number;
|
|
57
|
+
}): TextNode;
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The config shapes of a Plot's callout annotations, reference lines, and
|
|
3
|
+
reference bands.
|
|
4
|
+
*/
|
|
5
|
+
import type { DataPoint } from "@d3plus/data";
|
|
6
|
+
/**
|
|
7
|
+
How an annotation position is read on one axis: `"data"` (the default)
|
|
8
|
+
maps it through the axis scale, in data units (a number, a date, or a
|
|
9
|
+
category); `"plot"` reads it as a fraction of the plot area, from `0` at
|
|
10
|
+
the left (or bottom) edge to `1` at the right (or top) edge.
|
|
11
|
+
*/
|
|
12
|
+
export type AnnotationRef = "data" | "plot";
|
|
13
|
+
/** A value on a Plot axis: a number, a date (a Date, timestamp, or date string), or a category. */
|
|
14
|
+
export type AnnotationValue = number | string | Date;
|
|
15
|
+
/**
|
|
16
|
+
A user annotation: a shape key (a Shape class name such as `"Line"` or
|
|
17
|
+
`"Rect"`, or `"Callout"`, `"ReferenceLine"`, or `"ReferenceBand"`) plus
|
|
18
|
+
its config, optionally z-layered.
|
|
19
|
+
*/
|
|
20
|
+
export interface Annotation {
|
|
21
|
+
shape: string;
|
|
22
|
+
layer?: string;
|
|
23
|
+
[key: string]: unknown;
|
|
24
|
+
}
|
|
25
|
+
/** A constant, or a `(datum, index)` accessor over a callout's data rows. */
|
|
26
|
+
type CalloutValue<T> = T | ((d: DataPoint, i: number) => T);
|
|
27
|
+
/** The text and stroke styles shared by callouts and reference labels. */
|
|
28
|
+
export interface AnnotationTextStyle {
|
|
29
|
+
/** Text color. Defaults to the chart's text color for its background. */
|
|
30
|
+
fontColor?: string;
|
|
31
|
+
/** Font family. Defaults to the chart's `fontFamily`. */
|
|
32
|
+
fontFamily?: string | string[];
|
|
33
|
+
/** Font size, in pixels. Defaults to `12`. */
|
|
34
|
+
fontSize?: number;
|
|
35
|
+
/** Font weight. Defaults to `400`. */
|
|
36
|
+
fontWeight?: number | string;
|
|
37
|
+
/** Line height, in pixels. Defaults to 1.3 times `fontSize`. */
|
|
38
|
+
lineHeight?: number;
|
|
39
|
+
/** The width, in pixels, the text wraps at. Defaults to `150`. */
|
|
40
|
+
maxWidth?: number;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
A callout annotation (`{shape: "Callout", data: [...]}` in `annotations`):
|
|
44
|
+
a note anchored at each row's `x`/`y` (or `x2`/`y2`, on those axes), drawn
|
|
45
|
+
as wrapped text in a box offset from the anchor by `dx`/`dy` pixels, with
|
|
46
|
+
a connector line from the box to the anchor ending in an arrowhead or a
|
|
47
|
+
dot. Each style key takes a constant or a `(d, i)` accessor, and a row's
|
|
48
|
+
own key of the same name wins over a constant. The box stays inside the
|
|
49
|
+
plot area. Callouts draw in front of the data unless `layer: "back"`, and
|
|
50
|
+
never respond to the pointer or keyboard.
|
|
51
|
+
*/
|
|
52
|
+
export interface CalloutAnnotation extends AnnotationTextStyle {
|
|
53
|
+
shape: "Callout";
|
|
54
|
+
/** The anchors: each row's `x`/`y` (or `x2`/`y2`) and `label`. */
|
|
55
|
+
data: DataPoint[];
|
|
56
|
+
/** `"front"` (the default) or `"back"` of the data shapes. */
|
|
57
|
+
layer?: "back" | "front";
|
|
58
|
+
/** How the anchors' `x` values are read. Defaults to `"data"`. */
|
|
59
|
+
xRef?: AnnotationRef;
|
|
60
|
+
/** How the anchors' `y` values are read. Defaults to `"data"`. */
|
|
61
|
+
yRef?: AnnotationRef;
|
|
62
|
+
/** The text. Defaults to each row's `label`. */
|
|
63
|
+
label?: CalloutValue<string>;
|
|
64
|
+
/** Horizontal offset of the box's center from the anchor, in pixels. Defaults to `0`. */
|
|
65
|
+
dx?: CalloutValue<number>;
|
|
66
|
+
/** Vertical offset of the box's center from the anchor, in pixels (negative is up). Defaults to `-40`. */
|
|
67
|
+
dy?: CalloutValue<number>;
|
|
68
|
+
/** Text alignment in the box: `"start"`, `"middle"` (the default), or `"end"`. */
|
|
69
|
+
textAlign?: CalloutValue<"start" | "middle" | "end">;
|
|
70
|
+
/** Space between the text and the box's edge, in pixels. Defaults to `6`. */
|
|
71
|
+
padding?: CalloutValue<number>;
|
|
72
|
+
/** Box fill. Defaults to the chart's background; `false` or `"none"` draws no box. */
|
|
73
|
+
fill?: CalloutValue<string | false>;
|
|
74
|
+
/** Box fill opacity. Defaults to `1`. */
|
|
75
|
+
fillOpacity?: CalloutValue<number>;
|
|
76
|
+
/** Box border color. Defaults to the text color. `false` or `"none"` draws no border. */
|
|
77
|
+
stroke?: CalloutValue<string | false>;
|
|
78
|
+
/** Box border opacity. Defaults to `0.25`. */
|
|
79
|
+
strokeOpacity?: CalloutValue<number>;
|
|
80
|
+
/** Box border width. Defaults to `1`. */
|
|
81
|
+
strokeWidth?: CalloutValue<number>;
|
|
82
|
+
/** Box corner radius. Defaults to `3`. */
|
|
83
|
+
rx?: CalloutValue<number>;
|
|
84
|
+
/** Whether a line joins the box to its anchor. Defaults to `true`. */
|
|
85
|
+
connector?: CalloutValue<boolean>;
|
|
86
|
+
/** Connector color. Defaults to the text color. */
|
|
87
|
+
connectorStroke?: CalloutValue<string>;
|
|
88
|
+
/** Connector width. Defaults to `1`. */
|
|
89
|
+
connectorStrokeWidth?: CalloutValue<number>;
|
|
90
|
+
/** Connector opacity. Defaults to `1`. */
|
|
91
|
+
connectorStrokeOpacity?: CalloutValue<number>;
|
|
92
|
+
/** Connector dash pattern, as a string ("4 2") or numbers. */
|
|
93
|
+
connectorStrokeDasharray?: CalloutValue<string | number[]>;
|
|
94
|
+
/** What marks the anchor: `"arrow"` (the default), `"dot"`, or `"none"`. */
|
|
95
|
+
marker?: CalloutValue<"arrow" | "dot" | "none">;
|
|
96
|
+
/** Arrowhead length or dot diameter, in pixels. Defaults to `6`. */
|
|
97
|
+
markerSize?: CalloutValue<number>;
|
|
98
|
+
/** Gap between the connector's end and the anchor, in pixels. Defaults to `0`. */
|
|
99
|
+
standoff?: CalloutValue<number>;
|
|
100
|
+
/** Whether the box is kept inside the plot area. Defaults to `true`. */
|
|
101
|
+
clamp?: CalloutValue<boolean>;
|
|
102
|
+
}
|
|
103
|
+
/** The line and label styles shared by reference lines and bands. */
|
|
104
|
+
export interface ReferenceStyle extends AnnotationTextStyle {
|
|
105
|
+
/** The text drawn with it. */
|
|
106
|
+
label?: string;
|
|
107
|
+
/** `"back"` (the default) or `"front"` of the data shapes. The label draws above the data either way. */
|
|
108
|
+
layer?: "back" | "front";
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
A full-width or full-height line across the plot at one value: give `x`
|
|
112
|
+
(a vertical line) or `y` (a horizontal one), or `x2`/`y2` for the
|
|
113
|
+
secondary axes. On a continuous or time axis the value widens the axis
|
|
114
|
+
domain to show the line, unless the user set that end of the domain.
|
|
115
|
+
*/
|
|
116
|
+
export interface ReferenceLineConfig extends ReferenceStyle {
|
|
117
|
+
x?: AnnotationValue;
|
|
118
|
+
y?: AnnotationValue;
|
|
119
|
+
x2?: AnnotationValue;
|
|
120
|
+
y2?: AnnotationValue;
|
|
121
|
+
/** How the value is read. Defaults to `"data"`. */
|
|
122
|
+
ref?: AnnotationRef;
|
|
123
|
+
/** Which end of the line the label sits at: `"end"` (the default: the right, or the top) or `"start"`. */
|
|
124
|
+
labelPosition?: "start" | "end";
|
|
125
|
+
/** Line color. Defaults to the chart's text color. */
|
|
126
|
+
stroke?: string;
|
|
127
|
+
/** Line opacity. Defaults to `0.6`. */
|
|
128
|
+
strokeOpacity?: number;
|
|
129
|
+
/** Line width. Defaults to `1`. */
|
|
130
|
+
strokeWidth?: number;
|
|
131
|
+
/** `true` dashes the line ("4 4"); a dash pattern string or numbers sets its own. */
|
|
132
|
+
dash?: boolean | string | number[];
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
A shaded span across the plot between two values: give `x` (a vertical
|
|
136
|
+
band) or `y` (a horizontal one) as `[start, end]`, or `x2`/`y2`. On a
|
|
137
|
+
category axis the band covers each end category's whole slot; on a
|
|
138
|
+
continuous or time axis its ends widen the axis domain, unless the user
|
|
139
|
+
set that end of the domain.
|
|
140
|
+
*/
|
|
141
|
+
export interface ReferenceBandConfig extends ReferenceStyle {
|
|
142
|
+
x?: [AnnotationValue, AnnotationValue];
|
|
143
|
+
y?: [AnnotationValue, AnnotationValue];
|
|
144
|
+
x2?: [AnnotationValue, AnnotationValue];
|
|
145
|
+
y2?: [AnnotationValue, AnnotationValue];
|
|
146
|
+
/** How the values are read. Defaults to `"data"`. */
|
|
147
|
+
ref?: AnnotationRef;
|
|
148
|
+
/** Which corner the label sits in: `"start"` (the default: the top left) or `"end"` (the top right). */
|
|
149
|
+
labelPosition?: "start" | "end";
|
|
150
|
+
/** Band fill. Defaults to the chart's text color. */
|
|
151
|
+
fill?: string;
|
|
152
|
+
/** Band fill opacity. Defaults to `0.08`. */
|
|
153
|
+
fillOpacity?: number;
|
|
154
|
+
/** Edge color; unset, the band has no edges. */
|
|
155
|
+
stroke?: string;
|
|
156
|
+
/** Edge opacity. Defaults to `0.4`. */
|
|
157
|
+
strokeOpacity?: number;
|
|
158
|
+
/** Edge width. Defaults to `1`. */
|
|
159
|
+
strokeWidth?: number;
|
|
160
|
+
}
|
|
161
|
+
export {};
|
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
`viz._padding.*`. Runs BEFORE the base `Viz` draw finalizes margins.
|
|
6
6
|
*/
|
|
7
7
|
import type Axis from "../../components/Axis/Axis.js";
|
|
8
|
+
import { type BarLabelCheck } from "../Plot/barLabelFit.js";
|
|
8
9
|
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
9
10
|
import type { AxisBounds } from "./axesFinal.js";
|
|
10
11
|
import type { XLabelMode } from "./plotEndLabels.js";
|
|
@@ -19,6 +20,8 @@ export interface LineLabelMeasurement {
|
|
|
19
20
|
labelWidths: LabelWidth[];
|
|
20
21
|
largestLabel: number | undefined;
|
|
21
22
|
xRangeMax: number | undefined;
|
|
23
|
+
/** The room left of the x range for the lines' left-end labels. */
|
|
24
|
+
startLabelSpace?: number;
|
|
22
25
|
}
|
|
23
26
|
/**
|
|
24
27
|
The stable per-draw inputs the joint margin solve reads — exactly the
|
|
@@ -56,6 +59,8 @@ export interface AxisMeasureInputs {
|
|
|
56
59
|
xData: unknown[];
|
|
57
60
|
/** `x.padding()` when the x scale is banded, else 0 — feeds the x config. */
|
|
58
61
|
xScalePadding: number;
|
|
62
|
+
/** Category labels the bars carry in place of the category axis's ticks. */
|
|
63
|
+
barLabelCheck?: BarLabelCheck;
|
|
59
64
|
}
|
|
60
65
|
/** The four-side margin claim + offsets the joint solve produces. */
|
|
61
66
|
export interface AxisMeasureResult {
|
|
@@ -67,6 +72,8 @@ export interface AxisMeasureResult {
|
|
|
67
72
|
xRangeMax: number | undefined;
|
|
68
73
|
labelWidths: LabelWidth[];
|
|
69
74
|
largestLabel: number | undefined;
|
|
75
|
+
/** The room left of the x range for the lines' left-end labels. */
|
|
76
|
+
startLabelSpace: number;
|
|
70
77
|
xTestRange: number[];
|
|
71
78
|
x2TestRange: number[];
|
|
72
79
|
x2Height: number;
|
|
@@ -75,6 +82,11 @@ export interface AxisMeasureResult {
|
|
|
75
82
|
topOffset: number;
|
|
76
83
|
xHeight: number;
|
|
77
84
|
xLabelMode: XLabelMode;
|
|
85
|
+
/** The category axis keeps its ticks, which the bars had no room to label. */
|
|
86
|
+
barLabelsOnAxis: boolean;
|
|
87
|
+
/** The x and y ticks the axes were measured with (see `barLabelsOnAxis`). */
|
|
88
|
+
xTicks: unknown[] | null;
|
|
89
|
+
yTicks: unknown[] | null;
|
|
78
90
|
}
|
|
79
91
|
/**
|
|
80
92
|
MEASURE half of the joint axis solve. Configures + measures the four
|
|
@@ -85,4 +97,4 @@ export interface AxisMeasureResult {
|
|
|
85
97
|
`measureLineLabels` is invoked once, after the first x-axis measure and
|
|
86
98
|
before the re-measure, so its `xRangeMax` can re-bound the x range.
|
|
87
99
|
*/
|
|
88
|
-
export declare function measureAxes(viz: Viz,
|
|
100
|
+
export declare function measureAxes(viz: Viz, measureInputs: AxisMeasureInputs, measureLineLabels: () => LineLabelMeasurement): AxisMeasureResult;
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A callout's geometry in pixels: its box offset from the anchor and kept
|
|
3
|
+
inside the plot, the connector from the box's edge to the anchor, and the
|
|
4
|
+
arrowhead at the anchor.
|
|
5
|
+
*/
|
|
6
|
+
import type { PlotRect } from "./annotationFrame.js";
|
|
7
|
+
/** A pixel point. */
|
|
8
|
+
export type Point = [number, number];
|
|
9
|
+
/** A pixel rectangle, from its top-left corner. */
|
|
10
|
+
export interface Box {
|
|
11
|
+
x: number;
|
|
12
|
+
y: number;
|
|
13
|
+
width: number;
|
|
14
|
+
height: number;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
A `width` × `height` box centered `dx`/`dy` pixels from the anchor.
|
|
18
|
+
@param anchor The anchor.
|
|
19
|
+
@param size The box's size.
|
|
20
|
+
@param dx The horizontal offset of its center.
|
|
21
|
+
@param dy The vertical offset of its center.
|
|
22
|
+
*/
|
|
23
|
+
export declare function offsetBox(anchor: Point, size: {
|
|
24
|
+
width: number;
|
|
25
|
+
height: number;
|
|
26
|
+
}, dx: number, dy: number): Box;
|
|
27
|
+
/**
|
|
28
|
+
Moves a box the least distance that puts it inside the plot area; a box
|
|
29
|
+
larger than the plot keeps to its top-left corner.
|
|
30
|
+
@param box The box.
|
|
31
|
+
@param plot The plot area.
|
|
32
|
+
*/
|
|
33
|
+
export declare function clampBox(box: Box, plot: PlotRect): Box;
|
|
34
|
+
/**
|
|
35
|
+
Where the connector runs: `from` the point the line from the box's center
|
|
36
|
+
to the anchor leaves the box, `to` the anchor (pulled back toward the box
|
|
37
|
+
by `standoff`). Null when the anchor is inside the box or the connector
|
|
38
|
+
would be shorter than a pixel.
|
|
39
|
+
@param box The callout box.
|
|
40
|
+
@param anchor The anchor.
|
|
41
|
+
@param standoff The gap to leave before the anchor.
|
|
42
|
+
*/
|
|
43
|
+
export declare function connectorEndpoints(box: Box, anchor: Point, standoff?: number): {
|
|
44
|
+
from: Point;
|
|
45
|
+
to: Point;
|
|
46
|
+
} | null;
|
|
47
|
+
/**
|
|
48
|
+
The three corners of an arrowhead `size` pixels long with its tip at
|
|
49
|
+
`tip`, pointing along the line from `from`: the tip, then its base's two
|
|
50
|
+
corners.
|
|
51
|
+
@param from The line's start.
|
|
52
|
+
@param tip The arrow's tip.
|
|
53
|
+
@param size The arrowhead's length (its base is as wide).
|
|
54
|
+
*/
|
|
55
|
+
export declare function arrowheadPoints(from: Point, tip: Point, size: number): [Point, Point, Point];
|
|
56
|
+
/**
|
|
57
|
+
Where a point moves along the line from `from` by `distance` pixels back
|
|
58
|
+
from its end (the arrow's base, where the connector stops).
|
|
59
|
+
@param from The line's start.
|
|
60
|
+
@param to The line's end.
|
|
61
|
+
@param distance How far back from `to`.
|
|
62
|
+
*/
|
|
63
|
+
export declare function pullBack(from: Point, to: Point, distance: number): Point;
|
|
64
|
+
/**
|
|
65
|
+
Where a callout's box goes: centered `dx`/`dy` from the anchor and, when
|
|
66
|
+
`clamp` is on, moved inside the plot area. A box that clamping pushes
|
|
67
|
+
over its own anchor tries the opposite offset instead, and keeps it when
|
|
68
|
+
that leaves the anchor clear.
|
|
69
|
+
@param anchor The anchor.
|
|
70
|
+
@param size The box's size.
|
|
71
|
+
@param offset The box center's offset from the anchor.
|
|
72
|
+
@param plot The plot area.
|
|
73
|
+
@param clamp Whether the box stays inside the plot area.
|
|
74
|
+
*/
|
|
75
|
+
export declare function placeCalloutBox(anchor: Point, size: {
|
|
76
|
+
width: number;
|
|
77
|
+
height: number;
|
|
78
|
+
}, [dx, dy]: Point, plot: PlotRect, clamp?: boolean): Box;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene of a callout annotation: per row, a connector from the box to
|
|
3
|
+
the anchor, an arrowhead or dot at the anchor, the box, and its wrapped
|
|
4
|
+
text, all inert.
|
|
5
|
+
*/
|
|
6
|
+
import type { SceneNode } from "@d3plus/render";
|
|
7
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
8
|
+
import { type AnnotationFrame } from "./annotationFrame.js";
|
|
9
|
+
import type { Annotation } from "./annotationTypes.js";
|
|
10
|
+
type Row = Record<string, unknown>;
|
|
11
|
+
/**
|
|
12
|
+
Reads one style key for a callout row: an accessor on the annotation
|
|
13
|
+
called with the row, else the row's own value, else the annotation's.
|
|
14
|
+
@param annotation The callout annotation.
|
|
15
|
+
@param d The row.
|
|
16
|
+
@param i The row's index.
|
|
17
|
+
*/
|
|
18
|
+
export declare function calloutPicker(annotation: Annotation, d: Row, i: number): (key: string) => unknown;
|
|
19
|
+
/**
|
|
20
|
+
The scene nodes of one callout row, or nothing when it has no label or
|
|
21
|
+
its anchor lies outside the plot area (a zoom that pans it out of view).
|
|
22
|
+
@param viz The chart.
|
|
23
|
+
@param annotation The callout annotation.
|
|
24
|
+
@param frame The plot area and its axes.
|
|
25
|
+
@param row The row, its index, and its key.
|
|
26
|
+
*/
|
|
27
|
+
export declare function calloutRowNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, row: {
|
|
28
|
+
d: Row;
|
|
29
|
+
i: number;
|
|
30
|
+
key: string;
|
|
31
|
+
}): SceneNode[];
|
|
32
|
+
/**
|
|
33
|
+
The scene nodes of a callout annotation's rows.
|
|
34
|
+
@param viz The chart.
|
|
35
|
+
@param annotation The callout annotation.
|
|
36
|
+
@param frame The plot area and its axes.
|
|
37
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
38
|
+
*/
|
|
39
|
+
export declare function calloutNodes(viz: VizInstance, annotation: Annotation, frame: AnnotationFrame, key: string): SceneNode[];
|
|
40
|
+
export {};
|
|
@@ -53,7 +53,7 @@ export declare function marginOriginTransform(viz: Viz): Transform;
|
|
|
53
53
|
|
|
54
54
|
Width and height are the margin-adjusted chart-area dimensions —
|
|
55
55
|
callers usually have them on hand from `chartBounds(viz)` or from
|
|
56
|
-
fields a stage stashed (e.g. `
|
|
56
|
+
fields a stage stashed (e.g. `_radialMatrixWidth`).
|
|
57
57
|
*/
|
|
58
58
|
export declare function centerChartTransform(viz: Viz, width: number, height: number): Transform;
|
|
59
59
|
/**
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Placement of circle labels: each label sits inside its circle when it fits
|
|
3
|
+
there at a readable size, otherwise beside the circle on the side with the
|
|
4
|
+
most open room (Moritz Stefaner's Voronoi labeling), otherwise nowhere.
|
|
5
|
+
Pure geometry: text is measured by the caller.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/
|
|
9
|
+
import type { Bounds } from "@d3plus/math";
|
|
10
|
+
/** Where a circle's label goes: `"auto"` picks inside, beside, or hidden. */
|
|
11
|
+
export type LabelPosition = "auto" | "inside" | "outside";
|
|
12
|
+
/** A circle, in the same space as the bounds. */
|
|
13
|
+
export interface LabelCircle {
|
|
14
|
+
x: number;
|
|
15
|
+
y: number;
|
|
16
|
+
r: number;
|
|
17
|
+
}
|
|
18
|
+
/** An axis-aligned box: its top-left corner and size. */
|
|
19
|
+
export interface CircleLabelBox {
|
|
20
|
+
x: number;
|
|
21
|
+
y: number;
|
|
22
|
+
width: number;
|
|
23
|
+
height: number;
|
|
24
|
+
}
|
|
25
|
+
/** The sides of a circle a label can sit on. */
|
|
26
|
+
export type LabelSide = "right" | "left" | "top" | "bottom" | "top-right" | "top-left" | "bottom-right" | "bottom-left";
|
|
27
|
+
/** One label to place. */
|
|
28
|
+
export interface CircleLabelRequest {
|
|
29
|
+
/** The index, in the circles array, of the circle the label names. */
|
|
30
|
+
circle: number;
|
|
31
|
+
/** The label's size when it sits beside the circle. */
|
|
32
|
+
width: number;
|
|
33
|
+
height: number;
|
|
34
|
+
position: LabelPosition;
|
|
35
|
+
/** Whether the label fits inside its circle at a readable size. */
|
|
36
|
+
fitsInside: boolean;
|
|
37
|
+
}
|
|
38
|
+
/** Where a label went. */
|
|
39
|
+
export type CircleLabelPlacement = {
|
|
40
|
+
position: "inside";
|
|
41
|
+
} | {
|
|
42
|
+
position: "outside";
|
|
43
|
+
side: LabelSide;
|
|
44
|
+
box: CircleLabelBox;
|
|
45
|
+
} | {
|
|
46
|
+
position: "hidden";
|
|
47
|
+
};
|
|
48
|
+
/** Tuning for `placeCircleLabels`. */
|
|
49
|
+
export interface PlaceCircleLabelsOptions {
|
|
50
|
+
/** The space between a circle's edge and a label beside it (default 3). */
|
|
51
|
+
gap?: number;
|
|
52
|
+
/**
|
|
53
|
+
The share of a label's area that must lie in its circle's Voronoi cell,
|
|
54
|
+
the region closer to that circle's center than to any other (default
|
|
55
|
+
0.5): a label mostly in a neighbor's cell would read as the neighbor's.
|
|
56
|
+
*/
|
|
57
|
+
cellCoverage?: number;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
The box a `width` × `height` label takes on one side of a circle, `gap`
|
|
61
|
+
pixels clear of its edge: centered on the circle's axis for a straight
|
|
62
|
+
side, with its nearest corner on the circle's diagonal for a diagonal one.
|
|
63
|
+
*/
|
|
64
|
+
export declare function sideBox(circle: LabelCircle, side: LabelSide, width: number, height: number, gap?: number): CircleLabelBox;
|
|
65
|
+
/** A ring's centroid, or null when it has no area. */
|
|
66
|
+
export declare function ringCentroid(ring: [number, number][]): [number, number] | null;
|
|
67
|
+
/**
|
|
68
|
+
The sides of a circle, most open first: ordered by how closely each
|
|
69
|
+
points toward the centroid of the circle's Voronoi cell (diagonals
|
|
70
|
+
slightly discounted), or in the default order (right, left, top, bottom,
|
|
71
|
+
then the diagonals) when the centroid is too close to the center to point
|
|
72
|
+
anywhere, which is the case for an evenly surrounded circle.
|
|
73
|
+
@param circle The circle.
|
|
74
|
+
@param cell Its Voronoi cell, or null.
|
|
75
|
+
*/
|
|
76
|
+
export declare function sideOrder(circle: LabelCircle, cell: [number, number][] | null): LabelSide[];
|
|
77
|
+
/** The share (0–1) of a box's area that lies inside a ring. */
|
|
78
|
+
export declare function boxCoverage(box: CircleLabelBox, ring: [number, number][]): number;
|
|
79
|
+
/** Whether a box overlaps a circle's interior. */
|
|
80
|
+
export declare function boxHitsCircle(box: CircleLabelBox, circle: LabelCircle): boolean;
|
|
81
|
+
/** Whether two boxes overlap (touching edges don't count). */
|
|
82
|
+
export declare function boxesOverlap(a: CircleLabelBox, b: CircleLabelBox): boolean;
|
|
83
|
+
/**
|
|
84
|
+
Places circle labels. A label in `"inside"` mode stays inside its circle;
|
|
85
|
+
in `"auto"` mode it stays inside when `fitsInside`, and otherwise (or in
|
|
86
|
+
`"outside"` mode) it takes the first side of its circle, most open first
|
|
87
|
+
(see `sideOrder`), where it lies mostly in the circle's Voronoi cell, stays
|
|
88
|
+
in `bounds`, and overlaps no circle and no label placed before it. A label
|
|
89
|
+
with no such side, or whose circle is centered outside `bounds`, is
|
|
90
|
+
hidden. Labels are placed largest circle first
|
|
91
|
+
(ties in input order), so big circles win the room; the result is in
|
|
92
|
+
input order and depends only on the input.
|
|
93
|
+
@param circles Every circle, labeled or not: each is an obstacle.
|
|
94
|
+
@param labels The labels to place.
|
|
95
|
+
@param bounds The box labels must stay in.
|
|
96
|
+
*/
|
|
97
|
+
export declare function placeCircleLabels(circles: readonly LabelCircle[], labels: readonly CircleLabelRequest[], bounds: Bounds, options?: PlaceCircleLabelsOptions): CircleLabelPlacement[];
|