@d3plus/core 4.10.0 → 4.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +178 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +176 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +101 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +192 -0
- package/es/src/charts/ArcDiagram/events.js +148 -0
- package/es/src/charts/ArcDiagram/index.js +217 -0
- package/es/src/charts/BarChart/index.js +12 -7
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +6 -11
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +160 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +137 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +206 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +6 -4
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/applyLayout.js +20 -9
- package/es/src/charts/Matrix/index.js +19 -1
- package/es/src/charts/Network/applyLayout.js +171 -96
- package/es/src/charts/Network/bundle.js +82 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +257 -75
- package/es/src/charts/Network/graph.js +146 -0
- package/es/src/charts/Network/graphFluent.js +81 -0
- package/es/src/charts/Network/index.js +91 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +15 -8
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +8 -1
- package/es/src/charts/Pack/neutralPaint.js +20 -0
- package/es/src/charts/Pack/nodeNames.js +35 -0
- package/es/src/charts/ParallelCoordinates/axes.js +22 -22
- package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +51 -96
- package/es/src/charts/Pie/index.js +74 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaEnter.js +68 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +34 -14
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +19 -17
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +40 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +2 -1
- package/es/src/charts/Plot/sharedTooltip.js +13 -3
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +4 -3
- package/es/src/charts/Priestley/applyLayout.js +21 -23
- package/es/src/charts/Priestley/index.js +4 -37
- package/es/src/charts/Priestley/timeAxis.js +103 -0
- package/es/src/charts/Pyramid/gutter.js +52 -16
- package/es/src/charts/Pyramid/index.js +55 -7
- package/es/src/charts/Pyramid/scene.js +4 -4
- package/es/src/charts/Radar/applyLayout.js +31 -33
- package/es/src/charts/Radar/axisDecorations.js +62 -13
- package/es/src/charts/Radar/curvedLabels.js +228 -0
- package/es/src/charts/Radar/emit.js +30 -15
- package/es/src/charts/Radar/index.js +43 -5
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +9 -1
- package/es/src/charts/RadialBar/index.js +26 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/index.js +18 -9
- package/es/src/charts/Rings/applyLayout.js +39 -161
- package/es/src/charts/Rings/emit.js +219 -63
- package/es/src/charts/Rings/index.js +88 -32
- package/es/src/charts/Rings/ringsCurves.js +156 -0
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +183 -0
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +61 -38
- package/es/src/charts/Sankey/applyLayout.js +130 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +78 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +83 -64
- package/es/src/charts/Sunburst/index.js +16 -4
- package/es/src/charts/Tree/applyLayout.js +44 -14
- package/es/src/charts/Tree/emit.js +5 -5
- package/es/src/charts/Tree/index.js +12 -18
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +14 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +10 -25
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +52 -23
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
- package/es/src/charts/drawSteps/zoomDrag.js +188 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +11 -4
- package/es/src/charts/events/click.shape.js +13 -4
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +9 -2
- package/es/src/charts/events/mousemove.legend.js +28 -32
- package/es/src/charts/events/mousemove.shape.js +45 -42
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +17 -5
- package/es/src/charts/features/axesFinal.js +10 -3
- package/es/src/charts/features/axesMeasure.js +33 -12
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/centerLabel.js +177 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +20 -1
- package/es/src/charts/features/colorScaleHover.js +33 -7
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +77 -0
- package/es/src/charts/features/colorScaleTop.js +61 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +191 -0
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +220 -5
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +75 -20
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/hoverTicks.js +41 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +364 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeStats.js +309 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +46 -12
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +54 -32
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +30 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +14 -5
- package/es/src/charts/partition/interaction.js +19 -10
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +22 -9
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/chrome.js +81 -9
- package/es/src/charts/polar/config.js +6 -3
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +61 -49
- package/es/src/charts/viz/VizBase.js +57 -14
- package/es/src/charts/viz/backgroundInk.js +23 -7
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +115 -32
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +29 -0
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +34 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -4
- package/es/src/charts/viz/vizDefaults.js +28 -57
- package/es/src/charts/viz/vizFields.js +41 -1
- package/es/src/charts/viz/vizRender.js +76 -31
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +26 -2
- package/es/src/components/Axis/Axis.js +35 -2
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +33 -8
- package/es/src/components/Axis/axisDefaults.js +16 -9
- package/es/src/components/Axis/axisLabelKinds.js +36 -0
- package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
- package/es/src/components/Axis/axisLabelRoom.js +37 -0
- package/es/src/components/Axis/axisLabelSize.js +171 -0
- package/es/src/components/Axis/axisLabelThinning.js +98 -4
- package/es/src/components/Axis/axisLayout.js +71 -46
- package/es/src/components/Axis/axisLayoutLabels.js +82 -140
- package/es/src/components/Axis/axisLayoutScale.js +16 -11
- package/es/src/components/Axis/axisLimit.js +27 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +20 -8
- package/es/src/components/Axis/axisRounding.js +16 -1
- package/es/src/components/Axis/axisScene.js +11 -2
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +128 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +77 -27
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +13 -2
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/Legend/legendCut.js +108 -0
- package/es/src/components/Legend/legendRender.js +38 -13
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +34 -67
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +9 -4
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +226 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +8 -5
- package/es/src/fluent.js +48 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +30 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configValue.js +9 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +268 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +46 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +24 -0
- package/types/src/charts/ArcDiagram/events.d.ts +29 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +36 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Matrix/applyLayout.d.ts +4 -2
- package/types/src/charts/Network/applyLayout.d.ts +11 -0
- package/types/src/charts/Network/bundle.d.ts +69 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +73 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pack/applyLayout.d.ts +2 -0
- package/types/src/charts/Pack/groupRows.d.ts +46 -0
- package/types/src/charts/Pack/index.d.ts +3 -0
- package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
- package/types/src/charts/Pack/nodeNames.d.ts +23 -0
- package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
- package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
- package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaEnter.d.ts +34 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +16 -15
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +79 -0
- package/types/src/charts/Pyramid/gutter.d.ts +28 -6
- package/types/src/charts/Pyramid/scene.d.ts +1 -1
- package/types/src/charts/Radar/applyLayout.d.ts +2 -3
- package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
- package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
- package/types/src/charts/Radar/emit.d.ts +5 -2
- package/types/src/charts/Radar/index.d.ts +7 -2
- package/types/src/charts/Radar/points.d.ts +50 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/Rings/emit.d.ts +72 -0
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
- package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/axisTooltip.d.ts +49 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/centerLabel.d.ts +75 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBivariate.d.ts +50 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
- package/types/src/charts/features/colorScaleHover.d.ts +13 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +119 -0
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +103 -4
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/hoverTicks.d.ts +30 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +192 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotEndLabels.d.ts +14 -1
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +15 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +25 -4
- package/types/src/charts/viz/VizBase.d.ts +37 -8
- package/types/src/charts/viz/backgroundInk.d.ts +19 -4
- package/types/src/charts/viz/emphasis.d.ts +17 -0
- package/types/src/charts/viz/fillStroke.d.ts +7 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +26 -0
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +35 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +37 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +100 -7
- package/types/src/charts/viz/vizVisibility.d.ts +13 -0
- package/types/src/components/Axis/Axis.d.ts +34 -3
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +21 -3
- package/types/src/components/Axis/axisDefaults.d.ts +12 -0
- package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
- package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
- package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
- package/types/src/components/Axis/axisLayout.d.ts +9 -2
- package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
- package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
- package/types/src/components/Axis/axisLimit.d.ts +18 -0
- package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +8 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +22 -11
- package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
- package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +6 -0
- package/types/src/components/Legend/legendCut.d.ts +31 -0
- package/types/src/components/Legend/legendRender.d.ts +6 -1
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +5 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/components/textEllipsis.d.ts +6 -0
- package/types/src/fluent.d.ts +18 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +1093 -266
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configValue.d.ts +8 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +72239 -41465
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +46249 -19519
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Measuring and drawing polylines: a sampled curve, a map's projected
|
|
3
|
+
link, or a bundled edge, as a list of `[x, y]` points.
|
|
4
|
+
*/ const round = (n)=>Math.round(n * 100) / 100;
|
|
5
|
+
/** A polyline as a path `d`. */ export function polylinePath(points) {
|
|
6
|
+
return points.map(([x, y], k)=>`${k ? "L" : "M"}${round(x)},${round(y)}`).join("");
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
A polyline shortened along its length by `start` pixels at its first
|
|
10
|
+
end and `end` at its last. When the cuts meet, it collapses to the
|
|
11
|
+
point where they do.
|
|
12
|
+
*/ export function trimPolyline(points, start, end) {
|
|
13
|
+
const length = polylineLength(points);
|
|
14
|
+
const s = Math.max(0, start);
|
|
15
|
+
const e = Math.max(0, end);
|
|
16
|
+
if (!s && !e) return points.slice();
|
|
17
|
+
if (s + e >= length) {
|
|
18
|
+
const at = polylineAt(points, length * s / (s + e || 1));
|
|
19
|
+
return [
|
|
20
|
+
[
|
|
21
|
+
at.x,
|
|
22
|
+
at.y
|
|
23
|
+
],
|
|
24
|
+
[
|
|
25
|
+
at.x,
|
|
26
|
+
at.y
|
|
27
|
+
]
|
|
28
|
+
];
|
|
29
|
+
}
|
|
30
|
+
const out = [];
|
|
31
|
+
let walked = 0;
|
|
32
|
+
const first = polylineAt(points, s);
|
|
33
|
+
const last = polylineAt(points, length - e);
|
|
34
|
+
out.push([
|
|
35
|
+
first.x,
|
|
36
|
+
first.y
|
|
37
|
+
]);
|
|
38
|
+
for(let k = 1; k < points.length - 1; k++){
|
|
39
|
+
walked += Math.hypot(points[k][0] - points[k - 1][0], points[k][1] - points[k - 1][1]);
|
|
40
|
+
if (walked > s && walked < length - e) out.push(points[k]);
|
|
41
|
+
}
|
|
42
|
+
out.push([
|
|
43
|
+
last.x,
|
|
44
|
+
last.y
|
|
45
|
+
]);
|
|
46
|
+
return out;
|
|
47
|
+
}
|
|
48
|
+
/** A polyline's length. */ export function polylineLength(points) {
|
|
49
|
+
let length = 0;
|
|
50
|
+
for(let k = 1; k < points.length; k++)length += Math.hypot(points[k][0] - points[k - 1][0], points[k][1] - points[k - 1][1]);
|
|
51
|
+
return length;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
The point `distance` along a polyline from its start (clamped to its
|
|
55
|
+
ends), and the direction the polyline runs there, in radians.
|
|
56
|
+
*/ export function polylineAt(points, distance) {
|
|
57
|
+
const last = points.length - 1;
|
|
58
|
+
let left = Math.max(0, distance);
|
|
59
|
+
for(let k = 1; k <= last; k++){
|
|
60
|
+
const [x0, y0] = points[k - 1];
|
|
61
|
+
const [x1, y1] = points[k];
|
|
62
|
+
const step = Math.hypot(x1 - x0, y1 - y0);
|
|
63
|
+
if (!step) continue;
|
|
64
|
+
const angle = Math.atan2(y1 - y0, x1 - x0);
|
|
65
|
+
if (left <= step || k === last) {
|
|
66
|
+
const t = Math.min(1, left / step);
|
|
67
|
+
return {
|
|
68
|
+
x: x0 + (x1 - x0) * t,
|
|
69
|
+
y: y0 + (y1 - y0) * t,
|
|
70
|
+
angle
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
left -= step;
|
|
74
|
+
}
|
|
75
|
+
const [x, y] = points[0] ?? [
|
|
76
|
+
0,
|
|
77
|
+
0
|
|
78
|
+
];
|
|
79
|
+
return {
|
|
80
|
+
x,
|
|
81
|
+
y,
|
|
82
|
+
angle: 0
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
/** The middle of a polyline's length, and its direction there. */ export function polylineMidpoint(points) {
|
|
86
|
+
return polylineAt(points, polylineLength(points) / 2);
|
|
87
|
+
}
|
|
88
|
+
/** The box around a polyline, as `[[x0, y0], [x1, y1]]`. */ export function polylineBox(points) {
|
|
89
|
+
const xs = points.map((p)=>p[0]);
|
|
90
|
+
const ys = points.map((p)=>p[1]);
|
|
91
|
+
return [
|
|
92
|
+
[
|
|
93
|
+
Math.min(...xs),
|
|
94
|
+
Math.min(...ys)
|
|
95
|
+
],
|
|
96
|
+
[
|
|
97
|
+
Math.max(...xs),
|
|
98
|
+
Math.max(...ys)
|
|
99
|
+
]
|
|
100
|
+
];
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
How far along a polyline, from its first point, it first gets `radius`
|
|
104
|
+
pixels away from that point: where it leaves a circle of that radius
|
|
105
|
+
around its start. The polyline's whole length when it never does.
|
|
106
|
+
*/ export function polylineReach(points, radius) {
|
|
107
|
+
if (!points.length || radius <= 0) return 0;
|
|
108
|
+
const [cx, cy] = points[0];
|
|
109
|
+
let walked = 0;
|
|
110
|
+
for(let k = 1; k < points.length; k++){
|
|
111
|
+
const [x0, y0] = points[k - 1];
|
|
112
|
+
const [x1, y1] = points[k];
|
|
113
|
+
const dx = x1 - x0;
|
|
114
|
+
const dy = y1 - y0;
|
|
115
|
+
const step = Math.hypot(dx, dy);
|
|
116
|
+
if (Math.hypot(x1 - cx, y1 - cy) >= radius && step) {
|
|
117
|
+
// Where the segment crosses the circle: |p0 + t·d − c| = radius.
|
|
118
|
+
const fx = x0 - cx;
|
|
119
|
+
const fy = y0 - cy;
|
|
120
|
+
const a = dx * dx + dy * dy;
|
|
121
|
+
const b = 2 * (fx * dx + fy * dy);
|
|
122
|
+
const c = fx * fx + fy * fy - radius * radius;
|
|
123
|
+
const t = (-b + Math.sqrt(Math.max(0, b * b - 4 * a * c))) / (2 * a);
|
|
124
|
+
return walked + Math.min(1, Math.max(0, t)) * step;
|
|
125
|
+
}
|
|
126
|
+
walked += step;
|
|
127
|
+
}
|
|
128
|
+
return walked;
|
|
129
|
+
}
|
|
@@ -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
|
+
}
|