@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,403 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Reference lines and bands: `referenceLines`/`referenceBands` entries
|
|
3
|
+
expand into `"ReferenceLine"`/`"ReferenceBand"` annotations, drawn as a
|
|
4
|
+
line across the whole plot at one value, or a shaded span between two,
|
|
5
|
+
with an optional label. Both sit behind the data unless `layer: "front"`;
|
|
6
|
+
their labels draw above it, clear of the data labels (see
|
|
7
|
+
`placeReferenceLabels`).
|
|
8
|
+
*/ import { parseDash } from "../../shapes/Shape.js";
|
|
9
|
+
import { axisPixel, axisSpan, clipSpan, isVertical } from "./annotationFrame.js";
|
|
10
|
+
import { annotationTextNode, annotationTextStyle, wrapAnnotationText } from "./annotationText.js";
|
|
11
|
+
import { LABEL_PAD as PAD, registerLabelSpots, slideSteps } from "./referenceLabelPlacement.js";
|
|
12
|
+
/** The annotation shape a `referenceLines` entry expands into. */ export const REFERENCE_LINE = "ReferenceLine";
|
|
13
|
+
/** The annotation shape a `referenceBands` entry expands into. */ export const REFERENCE_BAND = "ReferenceBand";
|
|
14
|
+
const AXES = [
|
|
15
|
+
"x",
|
|
16
|
+
"y",
|
|
17
|
+
"x2",
|
|
18
|
+
"y2"
|
|
19
|
+
];
|
|
20
|
+
const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
|
|
21
|
+
/** The entries of a `referenceLines`/`referenceBands` setting: a list, one entry, or nothing. */ function entries(setting) {
|
|
22
|
+
const list = Array.isArray(setting) ? setting : setting ? [
|
|
23
|
+
setting
|
|
24
|
+
] : [];
|
|
25
|
+
return list.filter((d)=>!!d && typeof d === "object");
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
Expands `referenceLines` into `"ReferenceLine"` annotations, in the back
|
|
29
|
+
layer unless an entry sets its own.
|
|
30
|
+
@param setting The `referenceLines` setting.
|
|
31
|
+
*/ export function expandReferenceLines(setting) {
|
|
32
|
+
return entries(setting).map((d)=>({
|
|
33
|
+
layer: "back",
|
|
34
|
+
...d,
|
|
35
|
+
shape: REFERENCE_LINE
|
|
36
|
+
}));
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
Expands `referenceBands` into `"ReferenceBand"` annotations, in the back
|
|
40
|
+
layer unless an entry sets its own.
|
|
41
|
+
@param setting The `referenceBands` setting.
|
|
42
|
+
*/ export function expandReferenceBands(setting) {
|
|
43
|
+
return entries(setting).map((d)=>({
|
|
44
|
+
layer: "back",
|
|
45
|
+
...d,
|
|
46
|
+
shape: REFERENCE_BAND
|
|
47
|
+
}));
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
The axis a reference entry is on: the first of `x`, `y`, `x2`, `y2` it
|
|
51
|
+
sets, or null.
|
|
52
|
+
@param entry The entry.
|
|
53
|
+
*/ export function referenceAxis(entry) {
|
|
54
|
+
return AXES.find((a)=>entry[a] !== undefined && entry[a] !== null) ?? null;
|
|
55
|
+
}
|
|
56
|
+
/** The plot's pixel extent along an axis. */ const extent = (frame, axis)=>isVertical(axis) ? [
|
|
57
|
+
frame.plot.y0,
|
|
58
|
+
frame.plot.y1
|
|
59
|
+
] : [
|
|
60
|
+
frame.plot.x0,
|
|
61
|
+
frame.plot.x1
|
|
62
|
+
];
|
|
63
|
+
/**
|
|
64
|
+
Where a reference line runs: its axis, its pixel position `at` along that
|
|
65
|
+
axis, and its two end points across the plot (start first). Null when it
|
|
66
|
+
has no position or falls outside the plot area.
|
|
67
|
+
@param frame The plot area and its axes.
|
|
68
|
+
@param entry The reference line.
|
|
69
|
+
*/ export function referenceLinePoints(frame, entry) {
|
|
70
|
+
const axis = referenceAxis(entry);
|
|
71
|
+
if (!axis) return null;
|
|
72
|
+
const at = axisPixel(frame, axis, entry[axis], entry.ref);
|
|
73
|
+
const [lo, hi] = extent(frame, axis);
|
|
74
|
+
if (!Number.isFinite(at) || at < lo - 0.5 || at > hi + 0.5) return null;
|
|
75
|
+
const { plot } = frame;
|
|
76
|
+
const points = isVertical(axis) ? [
|
|
77
|
+
[
|
|
78
|
+
plot.x0,
|
|
79
|
+
at
|
|
80
|
+
],
|
|
81
|
+
[
|
|
82
|
+
plot.x1,
|
|
83
|
+
at
|
|
84
|
+
]
|
|
85
|
+
] : [
|
|
86
|
+
[
|
|
87
|
+
at,
|
|
88
|
+
plot.y1
|
|
89
|
+
],
|
|
90
|
+
[
|
|
91
|
+
at,
|
|
92
|
+
plot.y0
|
|
93
|
+
]
|
|
94
|
+
];
|
|
95
|
+
return {
|
|
96
|
+
axis,
|
|
97
|
+
at,
|
|
98
|
+
points
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
The rect a reference band shades, clipped to the plot area, and its
|
|
103
|
+
axis. Null when it has no position or lies wholly outside the plot.
|
|
104
|
+
@param frame The plot area and its axes.
|
|
105
|
+
@param entry The reference band.
|
|
106
|
+
*/ export function referenceBandRect(frame, entry) {
|
|
107
|
+
const axis = referenceAxis(entry);
|
|
108
|
+
const values = axis ? entry[axis] : undefined;
|
|
109
|
+
if (!axis || !Array.isArray(values) || values.length < 2) return null;
|
|
110
|
+
const span = axisSpan(frame, axis, [
|
|
111
|
+
values[0],
|
|
112
|
+
values[1]
|
|
113
|
+
], entry.ref);
|
|
114
|
+
const [lo, hi] = extent(frame, axis);
|
|
115
|
+
const clipped = span && clipSpan(span, lo, hi);
|
|
116
|
+
if (!clipped) return null;
|
|
117
|
+
const { plot } = frame;
|
|
118
|
+
const box = isVertical(axis) ? {
|
|
119
|
+
x: plot.x0,
|
|
120
|
+
y: clipped[0],
|
|
121
|
+
width: plot.x1 - plot.x0,
|
|
122
|
+
height: clipped[1] - clipped[0]
|
|
123
|
+
} : {
|
|
124
|
+
x: clipped[0],
|
|
125
|
+
y: plot.y0,
|
|
126
|
+
width: clipped[1] - clipped[0],
|
|
127
|
+
height: plot.y1 - plot.y0
|
|
128
|
+
};
|
|
129
|
+
return {
|
|
130
|
+
axis,
|
|
131
|
+
box
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
Where a reference line's label goes (the top-left of its text block, and
|
|
136
|
+
its alignment): beside the line's `"end"` (the right of a horizontal line,
|
|
137
|
+
the top of a vertical one) or `"start"`, above a horizontal line (below
|
|
138
|
+
it near the plot's top) and right of a vertical one (left of it near the
|
|
139
|
+
plot's right edge).
|
|
140
|
+
@param frame The plot area and its axes.
|
|
141
|
+
@param line The line's axis and pixel position.
|
|
142
|
+
@param block The wrapped label.
|
|
143
|
+
@param position Which end of the line.
|
|
144
|
+
*/ export function referenceLineLabelAt(frame, line, block, position = "end") {
|
|
145
|
+
const { plot } = frame;
|
|
146
|
+
if (isVertical(line.axis)) {
|
|
147
|
+
const above = line.at - PAD - block.height;
|
|
148
|
+
return {
|
|
149
|
+
x: position === "start" ? plot.x0 + PAD : plot.x1 - PAD,
|
|
150
|
+
y: above >= plot.y0 ? above : line.at + PAD,
|
|
151
|
+
align: position === "start" ? "start" : "end"
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
const right = line.at + PAD + block.width <= plot.x1;
|
|
155
|
+
return {
|
|
156
|
+
x: right ? line.at + PAD : line.at - PAD,
|
|
157
|
+
y: position === "start" ? plot.y1 - PAD - block.height : plot.y0 + PAD,
|
|
158
|
+
align: right ? "start" : "end"
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
Where a reference band's label goes: inside its top-left corner
|
|
163
|
+
(`"start"`) or top-right (`"end"`).
|
|
164
|
+
@param box The band's rect.
|
|
165
|
+
@param position Which corner.
|
|
166
|
+
*/ export function referenceBandLabelAt(box, position = "start") {
|
|
167
|
+
return position === "end" ? {
|
|
168
|
+
x: box.x + box.width - PAD,
|
|
169
|
+
y: box.y + PAD,
|
|
170
|
+
align: "end"
|
|
171
|
+
} : {
|
|
172
|
+
x: box.x + PAD,
|
|
173
|
+
y: box.y + PAD,
|
|
174
|
+
align: "start"
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
/** Each spot of `firsts` crossed with each of `seconds`, `firsts` varying slowest. */ const cross = (firsts, seconds)=>firsts.flatMap((a)=>seconds.map((b)=>[
|
|
178
|
+
a,
|
|
179
|
+
b
|
|
180
|
+
]));
|
|
181
|
+
/**
|
|
182
|
+
Every spot a reference line's label may take, the one
|
|
183
|
+
`referenceLineLabelAt` picks first: then the other side of the line, then
|
|
184
|
+
the line's other end on either side, then along the line from the
|
|
185
|
+
preferred end on either side.
|
|
186
|
+
@param frame The plot area and its axes.
|
|
187
|
+
@param line The line's axis and pixel position.
|
|
188
|
+
@param block The wrapped label.
|
|
189
|
+
@param position Which end of the line is preferred.
|
|
190
|
+
*/ export function referenceLineLabelSpots(frame, line, block, position = "end") {
|
|
191
|
+
const { plot } = frame;
|
|
192
|
+
const first = referenceLineLabelAt(frame, line, block, position);
|
|
193
|
+
const other = position === "start" ? "end" : "start";
|
|
194
|
+
if (isVertical(line.axis)) {
|
|
195
|
+
// A horizontal line: its ends are the plot's sides; its sides, above and below.
|
|
196
|
+
const sides = [
|
|
197
|
+
first.y,
|
|
198
|
+
first.y === line.at + PAD ? line.at - PAD - block.height : line.at + PAD
|
|
199
|
+
];
|
|
200
|
+
const ends = [
|
|
201
|
+
[
|
|
202
|
+
first.x,
|
|
203
|
+
first.align
|
|
204
|
+
],
|
|
205
|
+
other === "start" ? [
|
|
206
|
+
plot.x0 + PAD,
|
|
207
|
+
"start"
|
|
208
|
+
] : [
|
|
209
|
+
plot.x1 - PAD,
|
|
210
|
+
"end"
|
|
211
|
+
]
|
|
212
|
+
];
|
|
213
|
+
const along = slideSteps(first.align === "end" ? plot.x1 - PAD - block.width : plot.x0 + PAD, first.align === "end" ? plot.x0 + PAD : plot.x1 - PAD - block.width);
|
|
214
|
+
return [
|
|
215
|
+
...cross(ends, sides).map(([[x, align], y])=>({
|
|
216
|
+
x,
|
|
217
|
+
y,
|
|
218
|
+
align
|
|
219
|
+
})),
|
|
220
|
+
...cross(along, sides).map(([x, y])=>({
|
|
221
|
+
x,
|
|
222
|
+
y,
|
|
223
|
+
align: "start"
|
|
224
|
+
}))
|
|
225
|
+
];
|
|
226
|
+
}
|
|
227
|
+
// A vertical line: its ends are the plot's top and bottom; its sides, right and left.
|
|
228
|
+
const sides = [
|
|
229
|
+
[
|
|
230
|
+
first.x,
|
|
231
|
+
first.align
|
|
232
|
+
],
|
|
233
|
+
first.align === "start" ? [
|
|
234
|
+
line.at - PAD,
|
|
235
|
+
"end"
|
|
236
|
+
] : [
|
|
237
|
+
line.at + PAD,
|
|
238
|
+
"start"
|
|
239
|
+
]
|
|
240
|
+
];
|
|
241
|
+
const top = plot.y0 + PAD, bottom = plot.y1 - PAD - block.height;
|
|
242
|
+
const ends = [
|
|
243
|
+
first.y,
|
|
244
|
+
first.y === top ? bottom : top
|
|
245
|
+
];
|
|
246
|
+
const along = slideSteps(first.y, first.y === top ? bottom : top);
|
|
247
|
+
return cross([
|
|
248
|
+
...ends,
|
|
249
|
+
...along
|
|
250
|
+
], sides).map(([y, [x, align]])=>({
|
|
251
|
+
x,
|
|
252
|
+
y,
|
|
253
|
+
align
|
|
254
|
+
}));
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
Every spot a reference band's label may take, inside the band: the
|
|
258
|
+
corner `referenceBandLabelAt` picks first, then the other top corner,
|
|
259
|
+
then the bottom corners, then along the band's length from its top (or,
|
|
260
|
+
across the plot, from its preferred side).
|
|
261
|
+
@param box The band's rect.
|
|
262
|
+
@param axis The band's axis.
|
|
263
|
+
@param block The wrapped label.
|
|
264
|
+
@param position Which top corner is preferred.
|
|
265
|
+
*/ export function referenceBandLabelSpots(box, axis, block, position = "start") {
|
|
266
|
+
const startX = [
|
|
267
|
+
box.x + PAD,
|
|
268
|
+
"start"
|
|
269
|
+
], endX = [
|
|
270
|
+
box.x + box.width - PAD,
|
|
271
|
+
"end"
|
|
272
|
+
];
|
|
273
|
+
const xs = position === "end" ? [
|
|
274
|
+
endX,
|
|
275
|
+
startX
|
|
276
|
+
] : [
|
|
277
|
+
startX,
|
|
278
|
+
endX
|
|
279
|
+
];
|
|
280
|
+
const top = box.y + PAD, bottom = box.y + box.height - PAD - block.height;
|
|
281
|
+
const corners = cross([
|
|
282
|
+
top,
|
|
283
|
+
bottom
|
|
284
|
+
], xs).map(([y, [x, align]])=>({
|
|
285
|
+
x,
|
|
286
|
+
y,
|
|
287
|
+
align
|
|
288
|
+
}));
|
|
289
|
+
if (isVertical(axis)) {
|
|
290
|
+
const [[x0], [x1]] = xs;
|
|
291
|
+
const fromX = position === "end" ? x0 - block.width : x0;
|
|
292
|
+
const toX = position === "end" ? x1 : x1 - block.width;
|
|
293
|
+
return [
|
|
294
|
+
...corners,
|
|
295
|
+
...cross(slideSteps(fromX, toX), [
|
|
296
|
+
top,
|
|
297
|
+
bottom
|
|
298
|
+
]).map(([x, y])=>({
|
|
299
|
+
x,
|
|
300
|
+
y,
|
|
301
|
+
align: "start"
|
|
302
|
+
}))
|
|
303
|
+
];
|
|
304
|
+
}
|
|
305
|
+
return [
|
|
306
|
+
...corners,
|
|
307
|
+
...cross(slideSteps(top, bottom), xs).map(([y, [x, align]])=>({
|
|
308
|
+
x,
|
|
309
|
+
y,
|
|
310
|
+
align
|
|
311
|
+
}))
|
|
312
|
+
];
|
|
313
|
+
}
|
|
314
|
+
/**
|
|
315
|
+
The label's text node at its preferred spot, registered with the rest of
|
|
316
|
+
its spots (see `placeReferenceLabels`), or null when the entry has no label.
|
|
317
|
+
*/ function labelNode(viz, annotation, key, spotsFor) {
|
|
318
|
+
const text = annotation.label;
|
|
319
|
+
if (text === undefined || text === null || text === false || text === "") return null;
|
|
320
|
+
const style = annotationTextStyle(viz, (k)=>annotation[k]);
|
|
321
|
+
const block = wrapAnnotationText(`${text}`, style);
|
|
322
|
+
if (!block.lines.length) return null;
|
|
323
|
+
const spots = spotsFor(block);
|
|
324
|
+
const node = annotationTextNode(block, style, {
|
|
325
|
+
key,
|
|
326
|
+
...spots[0]
|
|
327
|
+
});
|
|
328
|
+
registerLabelSpots(node, block, spots);
|
|
329
|
+
return node;
|
|
330
|
+
}
|
|
331
|
+
/** A `dash` setting's pattern: `true` is "4 4". */ function dashOf(annotation) {
|
|
332
|
+
const dash = annotation.dash ?? annotation.strokeDasharray;
|
|
333
|
+
if (dash === true) return [
|
|
334
|
+
4,
|
|
335
|
+
4
|
|
336
|
+
];
|
|
337
|
+
if (dash === false) return undefined;
|
|
338
|
+
return parseDash(dash);
|
|
339
|
+
}
|
|
340
|
+
/**
|
|
341
|
+
The scene nodes of a reference line: the line and its label.
|
|
342
|
+
@param viz The chart.
|
|
343
|
+
@param annotation The `"ReferenceLine"` annotation.
|
|
344
|
+
@param frame The plot area and its axes.
|
|
345
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
346
|
+
*/ export function referenceLineNodes(viz, annotation, frame, key) {
|
|
347
|
+
const line = referenceLinePoints(frame, annotation);
|
|
348
|
+
if (!line) return [];
|
|
349
|
+
const style = annotationTextStyle(viz, (k)=>annotation[k]);
|
|
350
|
+
const paint = {
|
|
351
|
+
fill: "none",
|
|
352
|
+
stroke: annotation.stroke || style.fontColor,
|
|
353
|
+
strokeWidth: num(annotation.strokeWidth, 1),
|
|
354
|
+
strokeOpacity: num(annotation.strokeOpacity, 0.6)
|
|
355
|
+
};
|
|
356
|
+
const dash = dashOf(annotation);
|
|
357
|
+
if (dash) paint.strokeDasharray = dash;
|
|
358
|
+
const out = [
|
|
359
|
+
{
|
|
360
|
+
type: "line",
|
|
361
|
+
key: `${key}-line`,
|
|
362
|
+
interactive: false,
|
|
363
|
+
points: line.points,
|
|
364
|
+
curve: "linear",
|
|
365
|
+
paint
|
|
366
|
+
}
|
|
367
|
+
];
|
|
368
|
+
const label = labelNode(viz, annotation, `${key}-label`, (block)=>referenceLineLabelSpots(frame, line, block, annotation.labelPosition === "start" ? "start" : "end"));
|
|
369
|
+
if (label) out.push(label);
|
|
370
|
+
return out;
|
|
371
|
+
}
|
|
372
|
+
/**
|
|
373
|
+
The scene nodes of a reference band: the shaded rect and its label.
|
|
374
|
+
@param viz The chart.
|
|
375
|
+
@param annotation The `"ReferenceBand"` annotation.
|
|
376
|
+
@param frame The plot area and its axes.
|
|
377
|
+
@param key The annotation's key, which prefixes its nodes'.
|
|
378
|
+
*/ export function referenceBandNodes(viz, annotation, frame, key) {
|
|
379
|
+
const band = referenceBandRect(frame, annotation);
|
|
380
|
+
if (!band) return [];
|
|
381
|
+
const style = annotationTextStyle(viz, (k)=>annotation[k]);
|
|
382
|
+
const paint = {
|
|
383
|
+
fill: annotation.fill || style.fontColor,
|
|
384
|
+
fillOpacity: num(annotation.fillOpacity, 0.08)
|
|
385
|
+
};
|
|
386
|
+
if (annotation.stroke) {
|
|
387
|
+
paint.stroke = annotation.stroke;
|
|
388
|
+
paint.strokeWidth = num(annotation.strokeWidth, 1);
|
|
389
|
+
paint.strokeOpacity = num(annotation.strokeOpacity, 0.4);
|
|
390
|
+
}
|
|
391
|
+
const out = [
|
|
392
|
+
{
|
|
393
|
+
type: "rect",
|
|
394
|
+
key: `${key}-band`,
|
|
395
|
+
interactive: false,
|
|
396
|
+
...band.box,
|
|
397
|
+
paint
|
|
398
|
+
}
|
|
399
|
+
];
|
|
400
|
+
const label = labelNode(viz, annotation, `${key}-label`, (block)=>referenceBandLabelSpots(band.box, band.axis, block, annotation.labelPosition === "end" ? "end" : "start"));
|
|
401
|
+
if (label) out.push(label);
|
|
402
|
+
return out;
|
|
403
|
+
}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Where reference line and band labels go once the data is drawn: each
|
|
3
|
+
label has a list of spots, its preferred one first, and takes the first
|
|
4
|
+
whose box is clear of the data labels and of the reference labels placed
|
|
5
|
+
before it, inside the plot. A label with no clear spot is hidden.
|
|
6
|
+
*/ /** Gap between a reference label and its line or band edge, in pixels. */ export const LABEL_PAD = 4;
|
|
7
|
+
/** How far apart the spots along a line or band edge are, in pixels. */ const SLIDE_STEP = 6;
|
|
8
|
+
/** Each label node's block and spots, for `placeReferenceLabels`. */ const labelSpots = new WeakMap();
|
|
9
|
+
/**
|
|
10
|
+
Records the spots a reference label node may move to (its preferred spot
|
|
11
|
+
first, where it is drawn), for `placeReferenceLabels`.
|
|
12
|
+
@param node The label's text node.
|
|
13
|
+
@param block The wrapped label.
|
|
14
|
+
@param spots Its spots, preferred first.
|
|
15
|
+
*/ export function registerLabelSpots(node, block, spots) {
|
|
16
|
+
labelSpots.set(node, {
|
|
17
|
+
block,
|
|
18
|
+
spots
|
|
19
|
+
});
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
The box a label's block covers at a spot.
|
|
23
|
+
@param spot The spot.
|
|
24
|
+
@param block The wrapped label.
|
|
25
|
+
*/ export function labelSpotBox(spot, block) {
|
|
26
|
+
const shift = spot.align === "end" ? block.width : spot.align === "middle" ? block.width / 2 : 0;
|
|
27
|
+
return {
|
|
28
|
+
x: spot.x - shift,
|
|
29
|
+
y: spot.y,
|
|
30
|
+
width: block.width,
|
|
31
|
+
height: block.height
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
/** Whether two boxes overlap by more than a hair. */ const overlaps = (a, b)=>a.x < b.x + b.width - 0.5 && b.x < a.x + a.width - 0.5 && a.y < b.y + b.height - 0.5 && b.y < a.y + a.height - 0.5;
|
|
35
|
+
/** Whether a box lies inside the plot, to half a pixel. */ const inside = (b, plot)=>b.x >= plot.x0 - 0.5 && b.y >= plot.y0 - 0.5 && b.x + b.width <= plot.x1 + 0.5 && b.y + b.height <= plot.y1 + 0.5;
|
|
36
|
+
/**
|
|
37
|
+
The first of `spots` whose box is clear of every obstacle and inside the
|
|
38
|
+
plot (the first spot, the preferred one, need only be clear), or null
|
|
39
|
+
when none is.
|
|
40
|
+
@param spots The spots, preferred first.
|
|
41
|
+
@param block The wrapped label.
|
|
42
|
+
@param obstacles The boxes to stay clear of.
|
|
43
|
+
@param plot The plot area.
|
|
44
|
+
*/ export function pickLabelSpot(spots, block, obstacles, plot) {
|
|
45
|
+
return spots.find((spot, i)=>{
|
|
46
|
+
const b = labelSpotBox(spot, block);
|
|
47
|
+
return (!i || inside(b, plot)) && !obstacles.some((o)=>overlaps(b, o));
|
|
48
|
+
}) ?? null;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
Positions from `from` toward `to`, `SLIDE_STEP` apart, both ends included.
|
|
52
|
+
@param from The first position.
|
|
53
|
+
@param to The last.
|
|
54
|
+
*/ export function slideSteps(from, to) {
|
|
55
|
+
const steps = Math.floor(Math.abs(to - from) / SLIDE_STEP);
|
|
56
|
+
const dir = to < from ? -1 : 1;
|
|
57
|
+
const out = Array.from({
|
|
58
|
+
length: steps + 1
|
|
59
|
+
}, (_, i)=>from + dir * i * SLIDE_STEP);
|
|
60
|
+
if (out[out.length - 1] !== to) out.push(to);
|
|
61
|
+
return out;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
Moves each registered reference label among `nodes` to its first clear
|
|
65
|
+
spot (see `pickLabelSpot`), in order, each placed label joining the
|
|
66
|
+
obstacles of the ones after it, and drops a label with no clear spot.
|
|
67
|
+
Returns the nodes with the labels moved; unregistered nodes pass through.
|
|
68
|
+
@param nodes Scene nodes holding reference labels, at any depth.
|
|
69
|
+
@param obstacles The boxes to keep clear of, such as the data labels'.
|
|
70
|
+
@param plot The plot area.
|
|
71
|
+
*/ export function placeReferenceLabels(nodes, obstacles, plot) {
|
|
72
|
+
const taken = [
|
|
73
|
+
...obstacles
|
|
74
|
+
];
|
|
75
|
+
const visit = (list)=>list.flatMap((node)=>{
|
|
76
|
+
if (node.type === "group") return [
|
|
77
|
+
{
|
|
78
|
+
...node,
|
|
79
|
+
children: visit(node.children)
|
|
80
|
+
}
|
|
81
|
+
];
|
|
82
|
+
const entry = labelSpots.get(node);
|
|
83
|
+
if (!entry || node.type !== "text") return [
|
|
84
|
+
node
|
|
85
|
+
];
|
|
86
|
+
const spot = pickLabelSpot(entry.spots, entry.block, taken, plot);
|
|
87
|
+
if (!spot) return [];
|
|
88
|
+
taken.push(labelSpotBox(spot, entry.block));
|
|
89
|
+
const moved = {
|
|
90
|
+
...node,
|
|
91
|
+
transform: {
|
|
92
|
+
...node.transform,
|
|
93
|
+
x: spot.x,
|
|
94
|
+
y: spot.y
|
|
95
|
+
},
|
|
96
|
+
font: {
|
|
97
|
+
...node.font,
|
|
98
|
+
anchor: spot.align
|
|
99
|
+
}
|
|
100
|
+
};
|
|
101
|
+
return [
|
|
102
|
+
moved
|
|
103
|
+
];
|
|
104
|
+
});
|
|
105
|
+
return visit(nodes);
|
|
106
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene nodes for curved ring labels (see `ringLabels.ts`): text along
|
|
3
|
+
each label's arc in a color that reads on what lies under it, carrying
|
|
4
|
+
its segment's datum so it dims with it, inert, and fading rather than
|
|
5
|
+
gliding when a redraw moves it.
|
|
6
|
+
*/ import { fontExists, textWidth } from "@d3plus/dom";
|
|
7
|
+
import { fontFamily as defaultFontFamily } from "@d3plus/text";
|
|
8
|
+
import { labelsOverlap } from "./linkLabelGeometry.js";
|
|
9
|
+
import { textLineBoxes } from "./linkLabels.js";
|
|
10
|
+
import { pathLabelNodes } from "./pathLabels.js";
|
|
11
|
+
/**
|
|
12
|
+
How a curved label fades through a redraw that moves it: out over the
|
|
13
|
+
first 6% of the eased progress, back in over the last 6%, so it never
|
|
14
|
+
slides along the ring while its segment's arc tweens.
|
|
15
|
+
*/ export const RING_LABEL_FADE = {
|
|
16
|
+
out: 0.06,
|
|
17
|
+
in: 0.06
|
|
18
|
+
};
|
|
19
|
+
/**
|
|
20
|
+
The label font a shape's labelConfig sets, as plain values (accessors
|
|
21
|
+
are left to the defaults).
|
|
22
|
+
@param config The labelConfig.
|
|
23
|
+
*/ export function ringLabelFont(config) {
|
|
24
|
+
const out = {};
|
|
25
|
+
const { fontFamily, fontWeight } = config;
|
|
26
|
+
if (typeof fontFamily === "string" || Array.isArray(fontFamily)) out.fontFamily = fontFamily;
|
|
27
|
+
if (typeof fontWeight === "number" || typeof fontWeight === "string") out.fontWeight = fontWeight;
|
|
28
|
+
return out;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
A text's one-line width in a ring label font, by font size.
|
|
32
|
+
@param text The text.
|
|
33
|
+
@param font The label font.
|
|
34
|
+
*/ export function ringTextWidth(text, font) {
|
|
35
|
+
const style = {
|
|
36
|
+
"font-family": fontExists(font.fontFamily ?? defaultFontFamily),
|
|
37
|
+
"font-size": 100,
|
|
38
|
+
"font-weight": font.fontWeight ?? 400
|
|
39
|
+
};
|
|
40
|
+
const at100 = textWidth(text, style);
|
|
41
|
+
return (fontSize)=>at100 * fontSize / 100;
|
|
42
|
+
}
|
|
43
|
+
/** Whether a text node shows more than its ellipsis. */ const hasText = (node)=>node.type === "text" && node.lines.some((l)=>l.text.replace(/(\.\.\.|…)$/, "").trim().length > 0);
|
|
44
|
+
/**
|
|
45
|
+
The text nodes for curved labels: one per label that keeps some text
|
|
46
|
+
after it is cut to its path, each in its own font size and color.
|
|
47
|
+
@param viz The chart, for its locale.
|
|
48
|
+
@param labels The labels.
|
|
49
|
+
@param font The label font.
|
|
50
|
+
*/ export function ringLabelNodes(viz, labels, font = {}) {
|
|
51
|
+
if (!labels.length) return [];
|
|
52
|
+
const sizes = new Map(labels.map((l)=>[
|
|
53
|
+
l.key,
|
|
54
|
+
l.fit.fontSize
|
|
55
|
+
]));
|
|
56
|
+
const pathLabels = labels.map((l)=>({
|
|
57
|
+
key: l.key,
|
|
58
|
+
text: l.text,
|
|
59
|
+
d: l.fit.d,
|
|
60
|
+
color: l.color,
|
|
61
|
+
anchor: "middle",
|
|
62
|
+
datum: l.datum,
|
|
63
|
+
index: l.index
|
|
64
|
+
}));
|
|
65
|
+
const nodes = pathLabelNodes(viz, pathLabels, {
|
|
66
|
+
fontWeight: 400,
|
|
67
|
+
...font,
|
|
68
|
+
fontColor: (d)=>d.color,
|
|
69
|
+
fontSize: (d)=>sizes.get(d.key) ?? 10
|
|
70
|
+
}, {
|
|
71
|
+
halo: false
|
|
72
|
+
});
|
|
73
|
+
return nodes.filter(hasText).map((node)=>({
|
|
74
|
+
...node,
|
|
75
|
+
fadeSwap: RING_LABEL_FADE
|
|
76
|
+
}));
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
The labels that stay clear of each other and of `obstacles`, earlier
|
|
80
|
+
labels winning.
|
|
81
|
+
@param nodes The label nodes, in priority order.
|
|
82
|
+
@param obstacles Boxes they must stay clear of, such as other labels.
|
|
83
|
+
*/ export function clearRingLabels(nodes, obstacles = []) {
|
|
84
|
+
const placed = obstacles.slice();
|
|
85
|
+
return nodes.filter((node)=>{
|
|
86
|
+
const boxes = textLineBoxes([
|
|
87
|
+
node
|
|
88
|
+
]);
|
|
89
|
+
if (boxes.some((b)=>placed.some((o)=>labelsOverlap(b, o)))) return false;
|
|
90
|
+
placed.push(...boxes);
|
|
91
|
+
return true;
|
|
92
|
+
});
|
|
93
|
+
}
|