@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,340 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkLabel` on the node-link charts: a line of text at the middle of each
|
|
3
|
+
link, along it or level, on a pad of the chart's background so it reads
|
|
4
|
+
over the links. Along a curved link, the text and its pad follow the
|
|
5
|
+
curve. Labels that would cover a node or another label are left out, the
|
|
6
|
+
most prominent links' first. Labels are inert to the pointer and
|
|
7
|
+
keyboard, and dim with their link on hover.
|
|
8
|
+
*/ import { formatAbbreviate } from "@d3plus/format";
|
|
9
|
+
import { lineLeft, pathTextBoxes } from "@d3plus/render";
|
|
10
|
+
import { emitLabels } from "../../shapes/emitLabels.js";
|
|
11
|
+
import constant from "../../utils/constant.js";
|
|
12
|
+
import { backgroundInk, chartBackground } from "../viz/backgroundInk.js";
|
|
13
|
+
import { measureLabel } from "./circleLabels.js";
|
|
14
|
+
import { linkRow } from "./linkColor.js";
|
|
15
|
+
import { placeLinkLabels, uprightAngle } from "./linkLabelGeometry.js";
|
|
16
|
+
import { curvedLabelPad, curvedLabelSpot, distanceAlong, LINK_LABEL_MIN_RADIUS } from "./linkLabelPath.js";
|
|
17
|
+
import { polylineD, polylineLength } from "./pathLabelGeometry.js";
|
|
18
|
+
import { pathLabelNodes } from "./pathLabels.js";
|
|
19
|
+
/** `linkLabelConfig`'s defaults. */ export const LINK_LABEL_DEFAULTS = {
|
|
20
|
+
rotate: "along",
|
|
21
|
+
fontSize: 10,
|
|
22
|
+
padding: 2,
|
|
23
|
+
backgroundOpacity: 0.85,
|
|
24
|
+
minRadius: LINK_LABEL_MIN_RADIUS
|
|
25
|
+
};
|
|
26
|
+
/** Reads `linkLabelConfig`, with its defaults for anything missing or invalid. */ export function linkLabelSettings(viz) {
|
|
27
|
+
const cfg = viz.schema.linkLabelConfig ?? {};
|
|
28
|
+
const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) && v >= 0 ? v : fallback;
|
|
29
|
+
const { rotate, fontSize, padding, backgroundOpacity, minRadius, ...text } = cfg;
|
|
30
|
+
return {
|
|
31
|
+
rotate: rotate === "horizontal" ? "horizontal" : "along",
|
|
32
|
+
fontSize: num(fontSize, LINK_LABEL_DEFAULTS.fontSize) || 1,
|
|
33
|
+
padding: num(padding, LINK_LABEL_DEFAULTS.padding),
|
|
34
|
+
backgroundOpacity: Math.min(1, num(backgroundOpacity, LINK_LABEL_DEFAULTS.backgroundOpacity)),
|
|
35
|
+
minRadius: num(minRadius, LINK_LABEL_DEFAULTS.minRadius),
|
|
36
|
+
text
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
A `linkLabel` value as text: a number abbreviated in the chart's locale,
|
|
41
|
+
a string as given, and nothing for anything else.
|
|
42
|
+
*/ export function linkLabelText(value, locale) {
|
|
43
|
+
if (typeof value === "number") return Number.isFinite(value) ? formatAbbreviate(value, locale) : "";
|
|
44
|
+
if (typeof value === "string") return value.trim() ? value : "";
|
|
45
|
+
return "";
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
The boxes the lines of text scene nodes (such as a chart's node labels)
|
|
49
|
+
cover, each rotated with its node: about a line's glyphs, from 0.8em
|
|
50
|
+
above its baseline to 0.2em below.
|
|
51
|
+
@param nodes Scene nodes; text nodes inside groups are included.
|
|
52
|
+
*/ export function textLineBoxes(nodes) {
|
|
53
|
+
const out = [];
|
|
54
|
+
const visit = (node)=>{
|
|
55
|
+
const kids = node.children;
|
|
56
|
+
if (kids) kids.forEach(visit);
|
|
57
|
+
if (node.type !== "text") return;
|
|
58
|
+
const size = node.font?.size ?? 0;
|
|
59
|
+
const tr = node.transform ?? {};
|
|
60
|
+
const [ax, ay] = tr.rotateAnchor ?? [
|
|
61
|
+
0,
|
|
62
|
+
0
|
|
63
|
+
];
|
|
64
|
+
const angle = tr.rotate ?? 0;
|
|
65
|
+
const rad = angle * Math.PI / 180;
|
|
66
|
+
const cos = Math.cos(rad);
|
|
67
|
+
const sin = Math.sin(rad);
|
|
68
|
+
// Text on a path: a box for each stretch of the path its glyphs cover.
|
|
69
|
+
if (node.path) {
|
|
70
|
+
for (const box of pathTextBoxes(node)){
|
|
71
|
+
const cx = box.x - ax, cy = box.y - ay;
|
|
72
|
+
out.push({
|
|
73
|
+
x: (tr.x ?? 0) + ax + cx * cos - cy * sin,
|
|
74
|
+
y: (tr.y ?? 0) + ay + cx * sin + cy * cos,
|
|
75
|
+
width: box.width,
|
|
76
|
+
height: box.height,
|
|
77
|
+
angle: angle + box.angle
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
for (const line of node.lines ?? []){
|
|
83
|
+
if (!line.text || !size) continue;
|
|
84
|
+
const width = line.width || measureLabel(line.text, {
|
|
85
|
+
family: node.font.family,
|
|
86
|
+
size,
|
|
87
|
+
weight: node.font.weight
|
|
88
|
+
}).width;
|
|
89
|
+
const left = lineLeft({
|
|
90
|
+
x: line.x,
|
|
91
|
+
width
|
|
92
|
+
}, node.font);
|
|
93
|
+
// The line's center in the node's frame, then rotated about its anchor.
|
|
94
|
+
const cx = left + width / 2 - ax;
|
|
95
|
+
const cy = line.y - size * 0.3 - ay;
|
|
96
|
+
out.push({
|
|
97
|
+
x: (tr.x ?? 0) + ax + cx * cos - cy * sin,
|
|
98
|
+
y: (tr.y ?? 0) + ay + cx * sin + cy * cos,
|
|
99
|
+
width,
|
|
100
|
+
height: size,
|
|
101
|
+
angle
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
};
|
|
105
|
+
nodes.forEach(visit);
|
|
106
|
+
return out;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
The labels for the drawn links, as scene nodes: for each link with
|
|
110
|
+
`linkLabel` text that fits, a group at the link's middle, rotated with
|
|
111
|
+
the link unless `linkLabelConfig.rotate` is `"horizontal"`, holding a pad
|
|
112
|
+
in the chart's background and the text in the chart's ink. Along a
|
|
113
|
+
curved link (one with a `path`), the text follows the curve over a pad
|
|
114
|
+
that follows it too.
|
|
115
|
+
@param obstacles The nodes labels stay clear of.
|
|
116
|
+
*/ export function emitLinkLabels(viz, requests, obstacles) {
|
|
117
|
+
const accessor = viz.schema.linkLabel;
|
|
118
|
+
if (typeof accessor !== "function" || !requests.length) return [];
|
|
119
|
+
const settings = linkLabelSettings(viz);
|
|
120
|
+
const font = {
|
|
121
|
+
family: settings.text.fontFamily,
|
|
122
|
+
size: settings.fontSize,
|
|
123
|
+
weight: settings.text.fontWeight
|
|
124
|
+
};
|
|
125
|
+
const pad = settings.padding;
|
|
126
|
+
const candidates = [];
|
|
127
|
+
const curved = [];
|
|
128
|
+
requests.forEach((req, order)=>{
|
|
129
|
+
const { row, index } = linkRow(req.link, req.i);
|
|
130
|
+
const text = linkLabelText(accessor(row, index), viz.schema.locale);
|
|
131
|
+
if (!text) return;
|
|
132
|
+
const size = measureLabel(text, font);
|
|
133
|
+
const base = {
|
|
134
|
+
key: req.key,
|
|
135
|
+
link: row,
|
|
136
|
+
text,
|
|
137
|
+
textWidth: size.width,
|
|
138
|
+
textHeight: size.height,
|
|
139
|
+
priority: req.priority ?? 0,
|
|
140
|
+
order
|
|
141
|
+
};
|
|
142
|
+
const path = settings.rotate === "along" ? req.path : null;
|
|
143
|
+
if (path && path.length > 1) {
|
|
144
|
+
const at = req.anchor ? distanceAlong(path, [
|
|
145
|
+
req.anchor.x,
|
|
146
|
+
req.anchor.y
|
|
147
|
+
]) : polylineLength(path) / 2;
|
|
148
|
+
const spot = curvedLabelSpot(path, at, size.width, settings.fontSize, pad, settings.minRadius);
|
|
149
|
+
if (spot) {
|
|
150
|
+
const [x, y] = spot.stretch[Math.floor(spot.stretch.length / 2)];
|
|
151
|
+
curved.push({
|
|
152
|
+
base: {
|
|
153
|
+
...base,
|
|
154
|
+
box: {
|
|
155
|
+
x,
|
|
156
|
+
y,
|
|
157
|
+
width: 0,
|
|
158
|
+
height: 0,
|
|
159
|
+
angle: 0
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
spot
|
|
163
|
+
});
|
|
164
|
+
return;
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
if (!req.anchor) return;
|
|
168
|
+
candidates.push({
|
|
169
|
+
...base,
|
|
170
|
+
box: {
|
|
171
|
+
x: req.anchor.x,
|
|
172
|
+
y: req.anchor.y,
|
|
173
|
+
width: size.width + pad * 2,
|
|
174
|
+
height: size.height + pad * 2,
|
|
175
|
+
angle: settings.rotate === "horizontal" ? 0 : uprightAngle(req.anchor.angle)
|
|
176
|
+
}
|
|
177
|
+
});
|
|
178
|
+
});
|
|
179
|
+
candidates.push(...curvedCandidates(viz, curved, settings));
|
|
180
|
+
candidates.sort((a, b)=>b.priority - a.priority || a.order - b.order);
|
|
181
|
+
const placed = placeLinkLabels(candidates, obstacles);
|
|
182
|
+
return placed.map((label)=>label.curve ? curvedGroup(viz, label, label.curve, settings) : labelGroup(viz, label, settings));
|
|
183
|
+
}
|
|
184
|
+
/** Whether text cut short keeps fewer than three letters before its ellipsis. */ const tooShort = (drawn, full)=>drawn !== full && drawn.replace(/[\s.\u2026]+$/, "").length < 3;
|
|
185
|
+
/**
|
|
186
|
+
The curved labels as candidates: each one's text laid along its spot
|
|
187
|
+
(cut short with an ellipsis where the stretch is too short for it), its
|
|
188
|
+
pad's stretch, and the boxes its glyphs and pad cover. A label whose
|
|
189
|
+
stretch has room for fewer than three letters is left out.
|
|
190
|
+
*/ function curvedCandidates(viz, curved, settings) {
|
|
191
|
+
if (!curved.length) return [];
|
|
192
|
+
const pad = settings.padding;
|
|
193
|
+
const nodes = pathLabelNodes(viz, curved.map(({ base, spot })=>({
|
|
194
|
+
key: `${base.key}-label`,
|
|
195
|
+
text: base.text,
|
|
196
|
+
d: polylineD(spot.text),
|
|
197
|
+
color: "",
|
|
198
|
+
anchor: "middle"
|
|
199
|
+
})), {
|
|
200
|
+
fontColor: ()=>backgroundInk(viz),
|
|
201
|
+
fontWeight: 400,
|
|
202
|
+
...settings.text,
|
|
203
|
+
fontResize: false,
|
|
204
|
+
fontSize: settings.fontSize,
|
|
205
|
+
lineHeight: settings.fontSize * 1.2,
|
|
206
|
+
pointerEvents: "none"
|
|
207
|
+
}, {
|
|
208
|
+
halo: false
|
|
209
|
+
});
|
|
210
|
+
const byKey = new Map(nodes.map((n)=>[
|
|
211
|
+
String(n.key),
|
|
212
|
+
n
|
|
213
|
+
]));
|
|
214
|
+
return curved.flatMap(({ base, spot })=>{
|
|
215
|
+
const node = byKey.get(`${base.key}-label`);
|
|
216
|
+
const line = node?.type === "text" ? node.lines[0] : undefined;
|
|
217
|
+
if (!node || !line || tooShort(line.text, base.text)) return [];
|
|
218
|
+
const boxes = textLineBoxes([
|
|
219
|
+
node
|
|
220
|
+
]).map((b)=>({
|
|
221
|
+
...b,
|
|
222
|
+
width: b.width + pad * 2,
|
|
223
|
+
height: b.height + pad * 2
|
|
224
|
+
}));
|
|
225
|
+
if (!boxes.length) return [];
|
|
226
|
+
return [
|
|
227
|
+
{
|
|
228
|
+
...base,
|
|
229
|
+
box: boxes[Math.floor(boxes.length / 2)],
|
|
230
|
+
boxes,
|
|
231
|
+
curve: {
|
|
232
|
+
node,
|
|
233
|
+
pad: curvedLabelPad(spot, line.width ?? 0, pad)
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
];
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
One curved label's group: a stroke of the chart's background along the
|
|
241
|
+
stretch its text covers, as thick as the text and its pad, then the
|
|
242
|
+
text along the curve.
|
|
243
|
+
*/ function curvedGroup(viz, label, curve, settings) {
|
|
244
|
+
const pad = {
|
|
245
|
+
type: "path",
|
|
246
|
+
key: `${label.key}-label-pad`,
|
|
247
|
+
d: polylineD(curve.pad),
|
|
248
|
+
interactive: false,
|
|
249
|
+
paint: {
|
|
250
|
+
fill: "none",
|
|
251
|
+
stroke: chartBackground(viz),
|
|
252
|
+
strokeOpacity: settings.backgroundOpacity,
|
|
253
|
+
strokeWidth: label.textHeight + settings.padding * 2,
|
|
254
|
+
strokeLinecap: "butt"
|
|
255
|
+
}
|
|
256
|
+
};
|
|
257
|
+
return {
|
|
258
|
+
type: "group",
|
|
259
|
+
key: `${label.key}-label-group`,
|
|
260
|
+
datum: label.link,
|
|
261
|
+
interactive: false,
|
|
262
|
+
children: [
|
|
263
|
+
pad,
|
|
264
|
+
curve.node
|
|
265
|
+
]
|
|
266
|
+
};
|
|
267
|
+
}
|
|
268
|
+
/** One label's group: the pad, then the text, both centered on the group's origin. */ function labelGroup(viz, label, settings) {
|
|
269
|
+
const { box } = label;
|
|
270
|
+
const pad = {
|
|
271
|
+
type: "rect",
|
|
272
|
+
key: `${label.key}-label-pad`,
|
|
273
|
+
x: -box.width / 2,
|
|
274
|
+
y: -box.height / 2,
|
|
275
|
+
width: box.width,
|
|
276
|
+
height: box.height,
|
|
277
|
+
rx: Math.min(box.height / 2, 3),
|
|
278
|
+
interactive: false,
|
|
279
|
+
paint: {
|
|
280
|
+
fill: chartBackground(viz),
|
|
281
|
+
fillOpacity: settings.backgroundOpacity
|
|
282
|
+
}
|
|
283
|
+
};
|
|
284
|
+
const text = emitLabels({
|
|
285
|
+
data: [
|
|
286
|
+
{
|
|
287
|
+
text: label.text
|
|
288
|
+
}
|
|
289
|
+
],
|
|
290
|
+
label: (d)=>d.text,
|
|
291
|
+
labelBounds: ()=>({
|
|
292
|
+
x: -label.textWidth / 2,
|
|
293
|
+
y: -label.textHeight / 2,
|
|
294
|
+
width: label.textWidth,
|
|
295
|
+
height: label.textHeight
|
|
296
|
+
}),
|
|
297
|
+
x: constant(0),
|
|
298
|
+
y: constant(0),
|
|
299
|
+
aes: constant({}),
|
|
300
|
+
rotate: constant(0),
|
|
301
|
+
id: ()=>`${label.key}-label`,
|
|
302
|
+
labelConfig: {
|
|
303
|
+
fontColor: ()=>backgroundInk(viz),
|
|
304
|
+
...settings.text,
|
|
305
|
+
fontResize: false,
|
|
306
|
+
fontSize: settings.fontSize,
|
|
307
|
+
lineHeight: settings.fontSize * 1.2,
|
|
308
|
+
padding: 0,
|
|
309
|
+
pointerEvents: "none",
|
|
310
|
+
textAnchor: "middle",
|
|
311
|
+
verticalAlign: "middle"
|
|
312
|
+
}
|
|
313
|
+
}).map((node)=>{
|
|
314
|
+
// The group carries the link's datum, so the text dims once, with it.
|
|
315
|
+
const { datum: _datum, ...rest } = node;
|
|
316
|
+
void _datum;
|
|
317
|
+
return {
|
|
318
|
+
...rest,
|
|
319
|
+
interactive: false
|
|
320
|
+
};
|
|
321
|
+
});
|
|
322
|
+
return {
|
|
323
|
+
type: "group",
|
|
324
|
+
key: `${label.key}-label-group`,
|
|
325
|
+
datum: label.link,
|
|
326
|
+
interactive: false,
|
|
327
|
+
transform: box.angle ? {
|
|
328
|
+
x: box.x,
|
|
329
|
+
y: box.y,
|
|
330
|
+
rotate: box.angle
|
|
331
|
+
} : {
|
|
332
|
+
x: box.x,
|
|
333
|
+
y: box.y
|
|
334
|
+
},
|
|
335
|
+
children: [
|
|
336
|
+
pad,
|
|
337
|
+
...text
|
|
338
|
+
]
|
|
339
|
+
};
|
|
340
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The stroke widths the node-link charts size their links between when
|
|
3
|
+
`linkSize` values differ.
|
|
4
|
+
*/ /**
|
|
5
|
+
The share of the smallest node's radius the heaviest link is drawn at
|
|
6
|
+
by default: a quarter of the node's width, so links read as weighted
|
|
7
|
+
lines beside their nodes rather than bands as wide as them, and a
|
|
8
|
+
heavy link's arrowhead (1.5× its stroke) stays narrower than the node.
|
|
9
|
+
*/ export const LINK_SIZE_SHARE = 0.5;
|
|
10
|
+
/** A finite, non-negative number, or `undefined`. */ const width = (value)=>{
|
|
11
|
+
const n = typeof value === "number" ? value : NaN;
|
|
12
|
+
return Number.isFinite(n) && n >= 0 ? n : undefined;
|
|
13
|
+
};
|
|
14
|
+
/**
|
|
15
|
+
The thinnest and widest link, in pixels, for links whose `linkSize`
|
|
16
|
+
values differ. The thinnest is `sizeMin` (1 when unset). The widest is
|
|
17
|
+
`sizeMax` when set, which also caps the thinnest; otherwise it is half
|
|
18
|
+
the smallest node's radius (`rMin`), and never thinner than the
|
|
19
|
+
thinnest.
|
|
20
|
+
*/ export function linkWidthRange(sizeMin, sizeMax, rMin) {
|
|
21
|
+
const lo = width(sizeMin) ?? 1;
|
|
22
|
+
const hi = width(sizeMax);
|
|
23
|
+
if (hi !== undefined) return [
|
|
24
|
+
Math.min(lo, hi),
|
|
25
|
+
hi
|
|
26
|
+
];
|
|
27
|
+
const share = Number.isFinite(rMin) ? Math.max(0, rMin) * LINK_SIZE_SHARE : 0;
|
|
28
|
+
return [
|
|
29
|
+
lo,
|
|
30
|
+
Math.max(lo, share)
|
|
31
|
+
];
|
|
32
|
+
}
|
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Polyline geometry for labels drawn along a line (trend line labels, line
|
|
3
|
+
labels that follow their series): trimming a line to the plot, keeping
|
|
4
|
+
its text upright, lifting it clear of the stroke, and the path `d` a
|
|
5
|
+
TextBox `textPath` follows.
|
|
6
|
+
*/ /** A point in pixels. */ /**
|
|
7
|
+
The polyline's length.
|
|
8
|
+
@param points The polyline.
|
|
9
|
+
*/ export function polylineLength(points) {
|
|
10
|
+
let total = 0;
|
|
11
|
+
for(let i = 1; i < points.length; i++)total += Math.hypot(points[i][0] - points[i - 1][0], points[i][1] - points[i - 1][1]);
|
|
12
|
+
return total;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
The polyline in the direction its text reads upright: left to right, or
|
|
16
|
+
bottom to top when it runs (near enough) straight up or down. A line
|
|
17
|
+
running right to left in screen space (a reversed axis, or a fit along
|
|
18
|
+
the y axis) is reversed, so its text never reads upside down.
|
|
19
|
+
@param points The polyline.
|
|
20
|
+
@param steep How far across, for each pixel up or down, a line can run
|
|
21
|
+
and still read bottom to top. Defaults to `0.02`.
|
|
22
|
+
*/ export function uprightPoints(points, steep = 0.02) {
|
|
23
|
+
if (points.length < 2) return points;
|
|
24
|
+
const [x0, y0] = points[0];
|
|
25
|
+
const [x1, y1] = points[points.length - 1];
|
|
26
|
+
const dx = x1 - x0, dy = y1 - y0;
|
|
27
|
+
const upright = Math.abs(dx) < Math.abs(dy) * steep;
|
|
28
|
+
return (upright ? dy > 0 : dx < 0) ? [
|
|
29
|
+
...points
|
|
30
|
+
].reverse() : points;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
The polyline moved `distance` pixels to its left (above a line running
|
|
34
|
+
left to right), each vertex along the average of its segments' normals.
|
|
35
|
+
@param points The polyline.
|
|
36
|
+
@param distance How far to move it.
|
|
37
|
+
*/ export function offsetPolyline(points, distance) {
|
|
38
|
+
if (points.length < 2 || !distance) return points;
|
|
39
|
+
const normal = (a, b)=>{
|
|
40
|
+
const len = Math.hypot(b[0] - a[0], b[1] - a[1]) || 1;
|
|
41
|
+
return [
|
|
42
|
+
(b[1] - a[1]) / len,
|
|
43
|
+
-(b[0] - a[0]) / len
|
|
44
|
+
];
|
|
45
|
+
};
|
|
46
|
+
// Each segment's normal, shared by the vertices at its ends.
|
|
47
|
+
const normals = points.slice(1).map((p, i)=>normal(points[i], p));
|
|
48
|
+
return points.map((p, i)=>{
|
|
49
|
+
const before = i > 0 ? normals[i - 1] : null;
|
|
50
|
+
const after = i < points.length - 1 ? normals[i] : null;
|
|
51
|
+
const n = before && after ? [
|
|
52
|
+
before[0] + after[0],
|
|
53
|
+
before[1] + after[1]
|
|
54
|
+
] : before ?? after;
|
|
55
|
+
const len = Math.hypot(n[0], n[1]) || 1;
|
|
56
|
+
return [
|
|
57
|
+
p[0] + n[0] / len * distance,
|
|
58
|
+
p[1] + n[1] / len * distance
|
|
59
|
+
];
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
The stretch of the polyline from `from` to `to` pixels along it, its ends
|
|
64
|
+
interpolated.
|
|
65
|
+
@param points The polyline.
|
|
66
|
+
@param from The distance along it where the stretch starts.
|
|
67
|
+
@param to The distance along it where the stretch ends.
|
|
68
|
+
*/ export function trimPolyline(points, from, to) {
|
|
69
|
+
const out = [];
|
|
70
|
+
let walked = 0;
|
|
71
|
+
for(let i = 1; i < points.length; i++){
|
|
72
|
+
const [ax, ay] = points[i - 1];
|
|
73
|
+
const [bx, by] = points[i];
|
|
74
|
+
const len = Math.hypot(bx - ax, by - ay);
|
|
75
|
+
const next = walked + len;
|
|
76
|
+
const at = (s)=>{
|
|
77
|
+
const t = len ? (s - walked) / len : 0;
|
|
78
|
+
return [
|
|
79
|
+
ax + (bx - ax) * t,
|
|
80
|
+
ay + (by - ay) * t
|
|
81
|
+
];
|
|
82
|
+
};
|
|
83
|
+
if (next >= from && walked <= to) {
|
|
84
|
+
if (!out.length) out.push(at(Math.max(from, walked)));
|
|
85
|
+
if (next <= to) out.push([
|
|
86
|
+
bx,
|
|
87
|
+
by
|
|
88
|
+
]);
|
|
89
|
+
else {
|
|
90
|
+
out.push(at(to));
|
|
91
|
+
break;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
walked = next;
|
|
95
|
+
}
|
|
96
|
+
return out;
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
A polyline with the distance along it to each of its points, for taking
|
|
100
|
+
many stretches or samples of it in one pass: `trim` and `at` give what
|
|
101
|
+
`trimPolyline` does, but start from the first segment the stretch
|
|
102
|
+
reaches instead of the polyline's first point. Walking forward is
|
|
103
|
+
cheapest; a shorter distance than the last searches back.
|
|
104
|
+
*/ export class PolylineRuler {
|
|
105
|
+
points;
|
|
106
|
+
/** The polyline's length. */ length;
|
|
107
|
+
/** The distance along the polyline to each point. */ cum;
|
|
108
|
+
/** The segment (its end point's index) the last lookup stopped at. */ i = 1;
|
|
109
|
+
/** @param points The polyline. */ constructor(points){
|
|
110
|
+
this.points = points;
|
|
111
|
+
const cum = [
|
|
112
|
+
0
|
|
113
|
+
];
|
|
114
|
+
let walked = 0;
|
|
115
|
+
for(let i = 1; i < points.length; i++){
|
|
116
|
+
walked += Math.hypot(points[i][0] - points[i - 1][0], points[i][1] - points[i - 1][1]);
|
|
117
|
+
cum.push(walked);
|
|
118
|
+
}
|
|
119
|
+
this.cum = cum;
|
|
120
|
+
this.length = walked;
|
|
121
|
+
}
|
|
122
|
+
/** The first segment ending `distance` or more along the polyline (`points.length` when none does). */ seek(distance) {
|
|
123
|
+
const { cum } = this;
|
|
124
|
+
const n = this.points.length;
|
|
125
|
+
let i = this.i;
|
|
126
|
+
if (i > 1 && cum[i - 1] >= distance) {
|
|
127
|
+
let lo = 1, hi = i - 1;
|
|
128
|
+
while(lo < hi){
|
|
129
|
+
const mid = lo + hi >> 1;
|
|
130
|
+
if (cum[mid] >= distance) hi = mid;
|
|
131
|
+
else lo = mid + 1;
|
|
132
|
+
}
|
|
133
|
+
i = lo;
|
|
134
|
+
}
|
|
135
|
+
while(i < n && cum[i] < distance)i++;
|
|
136
|
+
this.i = i;
|
|
137
|
+
return i;
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
The stretch from `from` to `to` pixels along the polyline, the same
|
|
141
|
+
points `trimPolyline` gives.
|
|
142
|
+
@param from The distance along it where the stretch starts.
|
|
143
|
+
@param to The distance along it where the stretch ends.
|
|
144
|
+
*/ trim(from, to) {
|
|
145
|
+
const { points, cum } = this;
|
|
146
|
+
const out = [];
|
|
147
|
+
// Every segment before the first one reaching `from` adds nothing.
|
|
148
|
+
for(let i = this.seek(from); i < points.length; i++){
|
|
149
|
+
const [ax, ay] = points[i - 1];
|
|
150
|
+
const [bx, by] = points[i];
|
|
151
|
+
const len = Math.hypot(bx - ax, by - ay);
|
|
152
|
+
const walked = cum[i - 1];
|
|
153
|
+
const next = cum[i];
|
|
154
|
+
const at = (s)=>{
|
|
155
|
+
const t = len ? (s - walked) / len : 0;
|
|
156
|
+
return [
|
|
157
|
+
ax + (bx - ax) * t,
|
|
158
|
+
ay + (by - ay) * t
|
|
159
|
+
];
|
|
160
|
+
};
|
|
161
|
+
if (next >= from && walked <= to) {
|
|
162
|
+
if (!out.length) out.push(at(Math.max(from, walked)));
|
|
163
|
+
if (next <= to) out.push([
|
|
164
|
+
bx,
|
|
165
|
+
by
|
|
166
|
+
]);
|
|
167
|
+
else {
|
|
168
|
+
out.push(at(to));
|
|
169
|
+
break;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
return out;
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
The point `distance` pixels along the polyline, as `trimPolyline`'s
|
|
177
|
+
first point for a stretch from there to there, or undefined past its
|
|
178
|
+
end.
|
|
179
|
+
@param distance The distance along it.
|
|
180
|
+
*/ at(distance) {
|
|
181
|
+
const i = this.seek(distance);
|
|
182
|
+
if (i >= this.points.length || !(this.cum[i - 1] <= distance)) return undefined;
|
|
183
|
+
const [ax, ay] = this.points[i - 1];
|
|
184
|
+
const [bx, by] = this.points[i];
|
|
185
|
+
const len = Math.hypot(bx - ax, by - ay);
|
|
186
|
+
const walked = this.cum[i - 1];
|
|
187
|
+
const t = len ? (Math.max(distance, walked) - walked) / len : 0;
|
|
188
|
+
return [
|
|
189
|
+
ax + (bx - ax) * t,
|
|
190
|
+
ay + (by - ay) * t
|
|
191
|
+
];
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
The longest run of consecutive points inside `rect`: the part of a line a
|
|
196
|
+
label can sit on where the plot's domains don't cut it off.
|
|
197
|
+
@param points The polyline.
|
|
198
|
+
@param rect The plot area.
|
|
199
|
+
*/ export function visibleRun(points, rect) {
|
|
200
|
+
const inside = ([x, y])=>x >= rect.x0 - 0.5 && x <= rect.x1 + 0.5 && y >= rect.y0 - 0.5 && y <= rect.y1 + 0.5;
|
|
201
|
+
let best = [];
|
|
202
|
+
let run = [];
|
|
203
|
+
for (const p of points){
|
|
204
|
+
if (Number.isFinite(p[0]) && Number.isFinite(p[1]) && inside(p)) run.push(p);
|
|
205
|
+
else run = [];
|
|
206
|
+
if (polylineLength(run) > polylineLength(best)) best = run.slice();
|
|
207
|
+
}
|
|
208
|
+
return best;
|
|
209
|
+
}
|
|
210
|
+
/**
|
|
211
|
+
The SVG path `d` through a polyline's points.
|
|
212
|
+
@param points The polyline.
|
|
213
|
+
*/ export function polylineD(points) {
|
|
214
|
+
const r = (n)=>Math.round(n * 100) / 100;
|
|
215
|
+
return points.map(([x, y], i)=>`${i ? "L" : "M"}${r(x)},${r(y)}`).join("");
|
|
216
|
+
}
|
|
217
|
+
/**
|
|
218
|
+
The plot area's edges from its x and y ranges, the y range shifted up by
|
|
219
|
+
the top x axis's height, as the plot's clip reads them.
|
|
220
|
+
@param xRange The x range in pixels.
|
|
221
|
+
@param yRange The y range in pixels.
|
|
222
|
+
@param x2Height The top x axis's height.
|
|
223
|
+
*/ export function plotEdges(xRange, yRange, x2Height = 0) {
|
|
224
|
+
const xs = xRange.slice(0, 2).map(Number);
|
|
225
|
+
const ys = yRange.slice(0, 2).map((r)=>Number(r) - x2Height);
|
|
226
|
+
return {
|
|
227
|
+
x0: Math.min(...xs),
|
|
228
|
+
y0: Math.min(...ys),
|
|
229
|
+
x1: Math.max(...xs),
|
|
230
|
+
y1: Math.max(...ys)
|
|
231
|
+
};
|
|
232
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Labels drawn along a line with a TextBox `textPath`: in their line's
|
|
3
|
+
color, legible on the chart's background, over a halo of that background,
|
|
4
|
+
and inert (no hover, click, or keyboard stop). A label given its mark's
|
|
5
|
+
datum dims and highlights with that mark.
|
|
6
|
+
*/ import TextBox from "../../components/TextBox.js";
|
|
7
|
+
import { legibleOn } from "../../utils/themeInk.js";
|
|
8
|
+
import { chartBackground } from "../viz/backgroundInk.js";
|
|
9
|
+
import { textHalo } from "./textHalo.js";
|
|
10
|
+
/** The label font size when a config sets none. */ export const PATH_LABEL_FONT_SIZE = 11;
|
|
11
|
+
/**
|
|
12
|
+
The scene nodes for labels along paths, each cut short with an ellipsis
|
|
13
|
+
when its path is too short for it.
|
|
14
|
+
@param viz The chart, for its theme, background, and locale.
|
|
15
|
+
@param labels The labels.
|
|
16
|
+
@param config TextBox config laid over the defaults.
|
|
17
|
+
@param options Whether the text takes a halo.
|
|
18
|
+
*/ export function pathLabelNodes(viz, labels, config = {}, options = {}) {
|
|
19
|
+
if (!labels.length) return [];
|
|
20
|
+
const dark = Boolean(viz._theme?.dark);
|
|
21
|
+
const box = new TextBox().renderMode("compute").locale(viz.schema.locale).data(labels.map((l)=>({
|
|
22
|
+
...l,
|
|
23
|
+
id: l.key
|
|
24
|
+
}))).config({
|
|
25
|
+
fontSize: PATH_LABEL_FONT_SIZE,
|
|
26
|
+
fontWeight: 600,
|
|
27
|
+
fontColor: (d)=>legibleOn(d.color, dark),
|
|
28
|
+
text: (d)=>d.text,
|
|
29
|
+
textAnchor: (d)=>d.anchor,
|
|
30
|
+
textPath: (d)=>d.d,
|
|
31
|
+
truncateWord: true,
|
|
32
|
+
x: 0,
|
|
33
|
+
y: 0,
|
|
34
|
+
...config
|
|
35
|
+
});
|
|
36
|
+
const scene = box.toScene().children;
|
|
37
|
+
const nodes = options.halo === false ? scene : textHalo(scene, chartBackground(viz), 3);
|
|
38
|
+
return nodes.map((node)=>{
|
|
39
|
+
const label = node.datum;
|
|
40
|
+
return {
|
|
41
|
+
...node,
|
|
42
|
+
interactive: false,
|
|
43
|
+
datum: label?.datum,
|
|
44
|
+
index: label?.index ?? node.index,
|
|
45
|
+
aria: {
|
|
46
|
+
hidden: true
|
|
47
|
+
}
|
|
48
|
+
};
|
|
49
|
+
});
|
|
50
|
+
}
|