@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,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene nodes for curved ring labels (see `ringLabels.ts`): text along
|
|
3
|
+
each label's arc in a color that reads on what lies under it, carrying
|
|
4
|
+
its segment's datum so it dims with it, inert, and fading rather than
|
|
5
|
+
gliding when a redraw moves it.
|
|
6
|
+
*/ import { fontExists, textWidth } from "@d3plus/dom";
|
|
7
|
+
import { fontFamily as defaultFontFamily } from "@d3plus/text";
|
|
8
|
+
import { labelsOverlap } from "./linkLabelGeometry.js";
|
|
9
|
+
import { textLineBoxes } from "./linkLabels.js";
|
|
10
|
+
import { pathLabelNodes } from "./pathLabels.js";
|
|
11
|
+
/**
|
|
12
|
+
How a curved label fades through a redraw that moves it: out over the
|
|
13
|
+
first 6% of the eased progress, back in over the last 6%, so it never
|
|
14
|
+
slides along the ring while its segment's arc tweens.
|
|
15
|
+
*/ export const RING_LABEL_FADE = {
|
|
16
|
+
out: 0.06,
|
|
17
|
+
in: 0.06
|
|
18
|
+
};
|
|
19
|
+
/**
|
|
20
|
+
The label font a shape's labelConfig sets, as plain values (accessors
|
|
21
|
+
are left to the defaults).
|
|
22
|
+
@param config The labelConfig.
|
|
23
|
+
*/ export function ringLabelFont(config) {
|
|
24
|
+
const out = {};
|
|
25
|
+
const { fontFamily, fontWeight } = config;
|
|
26
|
+
if (typeof fontFamily === "string" || Array.isArray(fontFamily)) out.fontFamily = fontFamily;
|
|
27
|
+
if (typeof fontWeight === "number" || typeof fontWeight === "string") out.fontWeight = fontWeight;
|
|
28
|
+
return out;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
A text's one-line width in a ring label font, by font size.
|
|
32
|
+
@param text The text.
|
|
33
|
+
@param font The label font.
|
|
34
|
+
*/ export function ringTextWidth(text, font) {
|
|
35
|
+
const style = {
|
|
36
|
+
"font-family": fontExists(font.fontFamily ?? defaultFontFamily),
|
|
37
|
+
"font-size": 100,
|
|
38
|
+
"font-weight": font.fontWeight ?? 400
|
|
39
|
+
};
|
|
40
|
+
const at100 = textWidth(text, style);
|
|
41
|
+
return (fontSize)=>at100 * fontSize / 100;
|
|
42
|
+
}
|
|
43
|
+
/** Whether a text node shows more than its ellipsis. */ const hasText = (node)=>node.type === "text" && node.lines.some((l)=>l.text.replace(/(\.\.\.|…)$/, "").trim().length > 0);
|
|
44
|
+
/**
|
|
45
|
+
The text nodes for curved labels: one per label that keeps some text
|
|
46
|
+
after it is cut to its path, each in its own font size and color.
|
|
47
|
+
@param viz The chart, for its locale.
|
|
48
|
+
@param labels The labels.
|
|
49
|
+
@param font The label font.
|
|
50
|
+
*/ export function ringLabelNodes(viz, labels, font = {}) {
|
|
51
|
+
if (!labels.length) return [];
|
|
52
|
+
const sizes = new Map(labels.map((l)=>[
|
|
53
|
+
l.key,
|
|
54
|
+
l.fit.fontSize
|
|
55
|
+
]));
|
|
56
|
+
const pathLabels = labels.map((l)=>({
|
|
57
|
+
key: l.key,
|
|
58
|
+
text: l.text,
|
|
59
|
+
d: l.fit.d,
|
|
60
|
+
color: l.color,
|
|
61
|
+
anchor: "middle",
|
|
62
|
+
datum: l.datum,
|
|
63
|
+
index: l.index
|
|
64
|
+
}));
|
|
65
|
+
const nodes = pathLabelNodes(viz, pathLabels, {
|
|
66
|
+
fontWeight: 400,
|
|
67
|
+
...font,
|
|
68
|
+
fontColor: (d)=>d.color,
|
|
69
|
+
fontSize: (d)=>sizes.get(d.key) ?? 10
|
|
70
|
+
}, {
|
|
71
|
+
halo: false
|
|
72
|
+
});
|
|
73
|
+
return nodes.filter(hasText).map((node)=>({
|
|
74
|
+
...node,
|
|
75
|
+
fadeSwap: RING_LABEL_FADE
|
|
76
|
+
}));
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
The labels that stay clear of each other and of `obstacles`, earlier
|
|
80
|
+
labels winning.
|
|
81
|
+
@param nodes The label nodes, in priority order.
|
|
82
|
+
@param obstacles Boxes they must stay clear of, such as other labels.
|
|
83
|
+
*/ export function clearRingLabels(nodes, obstacles = []) {
|
|
84
|
+
const placed = obstacles.slice();
|
|
85
|
+
return nodes.filter((node)=>{
|
|
86
|
+
const boxes = textLineBoxes([
|
|
87
|
+
node
|
|
88
|
+
]);
|
|
89
|
+
if (boxes.some((b)=>placed.some((o)=>labelsOverlap(b, o)))) return false;
|
|
90
|
+
placed.push(...boxes);
|
|
91
|
+
return true;
|
|
92
|
+
});
|
|
93
|
+
}
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Curved labels for ring segments (Pie and Donut slices, Sunburst arcs,
|
|
3
|
+
Chord groups, RadialBar tracks): text that runs along a circular arc
|
|
4
|
+
through the segment, reading upright, and the fit that finds how large it
|
|
5
|
+
can be. Angles are radians in d3-shape's convention (0 at 12 o'clock,
|
|
6
|
+
increasing clockwise), so a point at angle `a` and radius `r` sits at
|
|
7
|
+
`(r·sin a, −r·cos a)`.
|
|
8
|
+
*/ import { largestFontSize } from "../partition/labelWords.js";
|
|
9
|
+
import { uprightPoints } from "./pathLabelGeometry.js";
|
|
10
|
+
const TAU = Math.PI * 2;
|
|
11
|
+
const EPSILON = 1e-6;
|
|
12
|
+
/** The room a curved label keeps from its segment's edges by default, in pixels: the padding straight labels keep inside their box. */ export const RING_LABEL_PADDING = 5;
|
|
13
|
+
/**
|
|
14
|
+
The room a curved label keeps at each end of its text: `padding`, but
|
|
15
|
+
never less than 0.3em, so the first and last letters stay clear of the
|
|
16
|
+
segment's ends.
|
|
17
|
+
@param padding The padding in pixels.
|
|
18
|
+
@param fontSize The font size.
|
|
19
|
+
*/ export function ringLabelEnd(padding, fontSize) {
|
|
20
|
+
return Math.max(padding, 0.3 * fontSize);
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
The point at angle `a` on a circle of radius `r`.
|
|
24
|
+
@param r The radius.
|
|
25
|
+
@param a The angle.
|
|
26
|
+
*/ export function ringPoint(r, a) {
|
|
27
|
+
return [
|
|
28
|
+
r * Math.sin(a),
|
|
29
|
+
-r * Math.cos(a)
|
|
30
|
+
];
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
Whether text along the arc from `a0` to `a1` (clockwise) reads upright
|
|
34
|
+
running clockwise: on the top half it does, and on the bottom half it
|
|
35
|
+
runs the other way so it reads left to right. The arc's chord is parallel
|
|
36
|
+
to its tangent at the middle, so the upright test for a straight line
|
|
37
|
+
(`uprightPoints`) decides it.
|
|
38
|
+
@param a0 Where the arc starts.
|
|
39
|
+
@param a1 Where it ends, clockwise from `a0`.
|
|
40
|
+
*/ export function ringReadsClockwise(a0, a1) {
|
|
41
|
+
const ends = [
|
|
42
|
+
ringPoint(1, a0),
|
|
43
|
+
ringPoint(1, a1)
|
|
44
|
+
];
|
|
45
|
+
return uprightPoints(ends) === ends;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
The SVG path along a circle of radius `r` from angle `a0` to `a1`
|
|
49
|
+
(clockwise, under a full turn), drawn clockwise or, for text on the
|
|
50
|
+
bottom half, from `a1` back to `a0`.
|
|
51
|
+
@param r The radius.
|
|
52
|
+
@param a0 Where the arc starts.
|
|
53
|
+
@param a1 Where it ends, clockwise from `a0`.
|
|
54
|
+
@param clockwise Which way the path runs.
|
|
55
|
+
*/ export function ringTextPath(r, a0, a1, clockwise) {
|
|
56
|
+
const round = (n)=>Math.round(n * 100) / 100;
|
|
57
|
+
const [from, to] = clockwise ? [
|
|
58
|
+
a0,
|
|
59
|
+
a1
|
|
60
|
+
] : [
|
|
61
|
+
a1,
|
|
62
|
+
a0
|
|
63
|
+
];
|
|
64
|
+
const [x0, y0] = ringPoint(r, from);
|
|
65
|
+
const [x1, y1] = ringPoint(r, to);
|
|
66
|
+
const large = a1 - a0 > Math.PI ? 1 : 0;
|
|
67
|
+
const R = round(r);
|
|
68
|
+
return `M${round(x0)},${round(y0)}A${R},${R} 0 ${large} ${clockwise ? 1 : 0} ${round(x1)},${round(y1)}`;
|
|
69
|
+
}
|
|
70
|
+
/** The glyphs' center radius across the ring at `fontSize`, or null when they don't fit across it. */ function bandCenter(arc, fontSize, padding, align) {
|
|
71
|
+
const lo = arc.innerRadius + padding + fontSize / 2;
|
|
72
|
+
const hi = arc.outerRadius - padding - fontSize / 2;
|
|
73
|
+
if (hi < lo - EPSILON) return null;
|
|
74
|
+
if (align === "outer") return hi;
|
|
75
|
+
if (align === "inner") return lo;
|
|
76
|
+
return (arc.innerRadius + arc.outerRadius) / 2;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
Fits a one-line label along a ring segment: the largest font size (from
|
|
80
|
+
`fontMax` down to `fontMin`) at which its glyphs fit across the ring and
|
|
81
|
+
its text along the arc, `padding` pixels clear of the ring's edges and
|
|
82
|
+
at least 0.3em clear of the segment's ends and pad (see `ringLabelEnd`).
|
|
83
|
+
When no size fits the whole text, it sits at `fontMin` and is cut
|
|
84
|
+
short with an ellipsis (unless `truncate` is false), as long as its arc
|
|
85
|
+
holds a few letters. Null when the label has no room. The glyphs span
|
|
86
|
+
0.8em above the baseline to 0.2em below, so the baseline sits 0.3em
|
|
87
|
+
below (or, on the bottom half, above) their center.
|
|
88
|
+
@param arc The segment.
|
|
89
|
+
@param width The text's one-line width at a font size.
|
|
90
|
+
@param options The font range, padding, and where the glyphs sit.
|
|
91
|
+
*/ export function ringLabelFit(arc, width, options = {}) {
|
|
92
|
+
const { fontMin = 8, fontMax = 24, padding = RING_LABEL_PADDING, endPadding = padding, align = "middle", minRadius = 2.5, maxTurn = Math.PI, truncate = true } = options;
|
|
93
|
+
const a0 = Math.min(arc.startAngle, arc.endAngle);
|
|
94
|
+
const span = Math.min(TAU, Math.abs(arc.endAngle - arc.startAngle));
|
|
95
|
+
if (!(span > 0) || !(arc.outerRadius > arc.innerRadius) || !(fontMin > 0)) return null;
|
|
96
|
+
// A whole disc has no ring for the text to follow.
|
|
97
|
+
if (arc.innerRadius <= 0 && span >= TAU - EPSILON) return null;
|
|
98
|
+
const mid = a0 + span / 2;
|
|
99
|
+
const clockwise = ringReadsClockwise(mid - 0.01, mid + 0.01);
|
|
100
|
+
const padRadius = Math.sqrt(arc.innerRadius ** 2 + arc.outerRadius ** 2);
|
|
101
|
+
const padLength = (arc.padAngle ?? 0) * padRadius;
|
|
102
|
+
/** The baseline radius and the turn the text may take, at `fontSize`. */ const room = (fontSize)=>{
|
|
103
|
+
const center = bandCenter(arc, fontSize, padding, align);
|
|
104
|
+
if (center === null) return null;
|
|
105
|
+
const radius = center + (clockwise ? -0.3 : 0.3) * fontSize;
|
|
106
|
+
if (radius < minRadius * fontSize) return null;
|
|
107
|
+
// The glyphs' inner edge is where the segment is narrowest.
|
|
108
|
+
const inner = center - fontSize / 2;
|
|
109
|
+
if (!(inner > 0)) return null;
|
|
110
|
+
const turn = Math.min(maxTurn, span - (padLength + ringLabelEnd(endPadding, fontSize) * 2) / inner, TAU - EPSILON);
|
|
111
|
+
return turn > 0 ? {
|
|
112
|
+
radius,
|
|
113
|
+
turn
|
|
114
|
+
} : null;
|
|
115
|
+
};
|
|
116
|
+
const fits = (fontSize)=>{
|
|
117
|
+
const r = room(fontSize);
|
|
118
|
+
return Boolean(r && width(fontSize) <= r.radius * r.turn + EPSILON);
|
|
119
|
+
};
|
|
120
|
+
let fontSize = largestFontSize(fits, fontMin, Math.max(fontMin, fontMax));
|
|
121
|
+
const truncated = fontSize === null;
|
|
122
|
+
if (truncated) {
|
|
123
|
+
if (!truncate) return null;
|
|
124
|
+
fontSize = fontMin;
|
|
125
|
+
}
|
|
126
|
+
const r = room(fontSize);
|
|
127
|
+
if (!r) return null;
|
|
128
|
+
const length = r.radius * r.turn;
|
|
129
|
+
// A cut-short label keeps room for a few letters and its ellipsis.
|
|
130
|
+
if (truncated && length < fontSize * 3) return null;
|
|
131
|
+
return {
|
|
132
|
+
d: ringTextPath(r.radius, mid - r.turn / 2, mid + r.turn / 2, clockwise),
|
|
133
|
+
fontSize: fontSize,
|
|
134
|
+
radius: r.radius,
|
|
135
|
+
clockwise,
|
|
136
|
+
length,
|
|
137
|
+
truncated
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
Fits a label and a smaller second line beneath it (such as a slice's
|
|
142
|
+
share) along a ring segment: the largest font size at which both lines,
|
|
143
|
+
the second at three quarters of the first's size (never below
|
|
144
|
+
`fontMin`), fit across the ring and along the arc whole. "Beneath" is
|
|
145
|
+
toward the center on the top half and away from it on the bottom half,
|
|
146
|
+
where the text reads the other way round. Null when they don't both fit.
|
|
147
|
+
@param arc The segment.
|
|
148
|
+
@param width The first line's one-line width at a font size.
|
|
149
|
+
@param subWidth The second line's.
|
|
150
|
+
@param options The font range, padding, and where the lines sit.
|
|
151
|
+
*/ export function ringLabelPair(arc, width, subWidth, options = {}) {
|
|
152
|
+
const { fontMin = 8, fontMax = 24, padding = RING_LABEL_PADDING, align = "middle" } = options;
|
|
153
|
+
const span = Math.abs(arc.endAngle - arc.startAngle);
|
|
154
|
+
const mid = Math.min(arc.startAngle, arc.endAngle) + span / 2;
|
|
155
|
+
const up = ringReadsClockwise(mid - 0.01, mid + 0.01) ? 1 : -1;
|
|
156
|
+
const place = (fontSize)=>{
|
|
157
|
+
const sub = Math.max(fontMin, Math.round(fontSize * 0.75));
|
|
158
|
+
const block = fontSize + sub * 1.3;
|
|
159
|
+
const center = bandCenter(arc, block, padding, align);
|
|
160
|
+
if (center === null) return null;
|
|
161
|
+
const line = (c, size, w)=>ringLabelFit({
|
|
162
|
+
...arc,
|
|
163
|
+
innerRadius: c - size / 2,
|
|
164
|
+
outerRadius: c + size / 2
|
|
165
|
+
}, w, {
|
|
166
|
+
...options,
|
|
167
|
+
fontMin: size,
|
|
168
|
+
fontMax: size,
|
|
169
|
+
padding: 0,
|
|
170
|
+
endPadding: options.endPadding ?? padding,
|
|
171
|
+
align: "middle",
|
|
172
|
+
truncate: false
|
|
173
|
+
});
|
|
174
|
+
const first = line(center + up * (block - fontSize) / 2, fontSize, width);
|
|
175
|
+
const second = line(center - up * (block - sub) / 2, sub, subWidth);
|
|
176
|
+
return first && second ? [
|
|
177
|
+
first,
|
|
178
|
+
second
|
|
179
|
+
] : null;
|
|
180
|
+
};
|
|
181
|
+
const fontSize = largestFontSize((fs)=>Boolean(place(fs)), fontMin, Math.max(fontMin, fontMax));
|
|
182
|
+
return fontSize === null ? null : place(fontSize);
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
Picks a segment's label for its `labelPosition`. `"inside"` and
|
|
186
|
+
`"outside"` keep the straight label; `"along"` keeps the curved one. Any
|
|
187
|
+
other value (`"auto"`) takes the curve when it shows the whole text and
|
|
188
|
+
the straight label doesn't, or shows it larger (or as large, when `ties`
|
|
189
|
+
is `"curved"`); else the straight label, when there is one; else a
|
|
190
|
+
cut-short curve.
|
|
191
|
+
@param position The segment's `labelPosition`.
|
|
192
|
+
@param straight The straight label, if it fits.
|
|
193
|
+
@param curved The curved label, if it fits.
|
|
194
|
+
@param ties Which label wins at the same font size. Defaults to `"straight"`.
|
|
195
|
+
*/ export function chooseRingLabel(position, straight, curved, ties = "straight") {
|
|
196
|
+
if (position === "inside" || position === "outside") return straight ? "straight" : null;
|
|
197
|
+
if (position === "along") return curved ? "curved" : null;
|
|
198
|
+
const larger = (a, b)=>ties === "curved" ? a >= b : a > b;
|
|
199
|
+
if (curved && !curved.truncated && (!straight || straight.truncated || larger(curved.fontSize, straight.fontSize))) return "curved";
|
|
200
|
+
if (straight) return "straight";
|
|
201
|
+
return curved ? "curved" : null;
|
|
202
|
+
}
|
|
203
|
+
/**
|
|
204
|
+
A row's `labelPosition`.
|
|
205
|
+
@param viz The chart.
|
|
206
|
+
@param d The row.
|
|
207
|
+
@param i Its index.
|
|
208
|
+
*/ export function ringLabelPosition(viz, d, i) {
|
|
209
|
+
const position = viz.schema.labelPosition;
|
|
210
|
+
return typeof position === "function" ? position(d, i) : position;
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
Whether laid-out lines show less than the whole `text`: cut short with an
|
|
214
|
+
ellipsis, or a word broken across lines.
|
|
215
|
+
@param lines The laid-out lines' text.
|
|
216
|
+
@param text The label's text.
|
|
217
|
+
*/ export function textBroken(lines, text) {
|
|
218
|
+
const words = (s)=>s.split(/\s+/).filter(Boolean);
|
|
219
|
+
const shown = lines.flatMap(words);
|
|
220
|
+
const whole = words(text);
|
|
221
|
+
return shown.length !== whole.length || shown.some((w, k)=>w !== whole[k]);
|
|
222
|
+
}
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
@module
|
|
6
6
|
*/ import { path2polygon, pathBounds } from "@d3plus/math";
|
|
7
|
+
import { lineLeft, pathTextBoxes, rotatedBoxBounds } from "@d3plus/render";
|
|
7
8
|
/** Maps a point through a node transform: rotate (about its anchor), scale, then translate. */ export function applyTransform([px, py], t) {
|
|
8
9
|
if (!t) return [
|
|
9
10
|
px,
|
|
@@ -34,21 +35,27 @@
|
|
|
34
35
|
height: 0
|
|
35
36
|
});
|
|
36
37
|
/** One box per laid-out line of a text node, from its anchor, baseline, and font size. */ function textBoxes(node) {
|
|
38
|
+
if (node.path) return pathTextBoxes(node).map((box)=>{
|
|
39
|
+
const b = rotatedBoxBounds(box);
|
|
40
|
+
return {
|
|
41
|
+
...b,
|
|
42
|
+
x: node.x + b.x,
|
|
43
|
+
y: node.y + b.y
|
|
44
|
+
};
|
|
45
|
+
});
|
|
37
46
|
const size = node.font?.size ?? 0;
|
|
38
|
-
const anchor = node.font?.anchor ?? "start";
|
|
39
47
|
const baseline = node.font?.baseline ?? "alphabetic";
|
|
40
48
|
const above = baseline === "hanging" ? 0 : baseline === "middle" ? size / 2 : size * 0.8;
|
|
41
49
|
return (node.lines || []).filter((line)=>line.text && line.width).map((line)=>{
|
|
42
|
-
const shift = anchor === "middle" ? line.width / 2 : anchor === "end" ? line.width : 0;
|
|
43
50
|
return {
|
|
44
|
-
x: node.x + line.
|
|
51
|
+
x: node.x + lineLeft(line, node.font),
|
|
45
52
|
y: node.y + line.y - above,
|
|
46
53
|
width: line.width,
|
|
47
54
|
height: size
|
|
48
55
|
};
|
|
49
56
|
});
|
|
50
57
|
}
|
|
51
|
-
/** Boxes of a node's own geometry, before its transform. Line/area series and paths contribute one box per outline point. */ function ownBoxes(node) {
|
|
58
|
+
/** Boxes of a node's own geometry, before its transform. Line/area series and paths contribute one box per outline point. */ export function ownBoxes(node) {
|
|
52
59
|
switch(node.type){
|
|
53
60
|
case "rect":
|
|
54
61
|
case "image":
|
|
@@ -91,10 +98,23 @@
|
|
|
91
98
|
return [];
|
|
92
99
|
}
|
|
93
100
|
}
|
|
94
|
-
/** Composes a chain of transforms (outermost first) into one point mapper. */ function mapper(chain) {
|
|
101
|
+
/** Composes a chain of transforms (outermost first) into one point mapper. */ export function mapper(chain) {
|
|
95
102
|
return (p)=>chain.reduceRight((q, t)=>applyTransform(q, t), p);
|
|
96
103
|
}
|
|
97
|
-
/** The axis-aligned box around a box mapped through `map`. */ function mapBox(b, map) {
|
|
104
|
+
/** The axis-aligned box around a box mapped through `map`. */ export function mapBox(b, map) {
|
|
105
|
+
// A point's four corners all map to the same place.
|
|
106
|
+
if (b.width === 0 && b.height === 0) {
|
|
107
|
+
const [x, y] = map([
|
|
108
|
+
b.x,
|
|
109
|
+
b.y
|
|
110
|
+
]);
|
|
111
|
+
return {
|
|
112
|
+
x,
|
|
113
|
+
y,
|
|
114
|
+
width: x - x,
|
|
115
|
+
height: y - y
|
|
116
|
+
};
|
|
117
|
+
}
|
|
98
118
|
const corners = [
|
|
99
119
|
map([
|
|
100
120
|
b.x,
|
|
@@ -0,0 +1,306 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Self-loops on the node-link charts: a link whose source and target are
|
|
3
|
+
the same node draws as a teardrop loop outside the node. Pure geometry
|
|
4
|
+
(the loop's path, its far point, its ends, its box), the direction a
|
|
5
|
+
node's loops point, the fan that keeps several loops on one node apart,
|
|
6
|
+
and the loop's arrowheads.
|
|
7
|
+
*/ import { cubicPathD, edgeArrowTrims } from "./edgeArrows.js";
|
|
8
|
+
import { chordArrowNodes, cubicArrowEdge } from "./curvedArrows.js";
|
|
9
|
+
import { linkMeta } from "./linkInteraction.js";
|
|
10
|
+
import { cubicPoint } from "./linkLabelGeometry.js";
|
|
11
|
+
/** Whether a link's two ends are the same node. */ export function isSelfLoop(link) {
|
|
12
|
+
return !!link.source && !!link.target && (link.source === link.target || link.source.id === link.target.id);
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
Whether a scene node draws a link from a node to itself (or is its hit
|
|
16
|
+
path). Charts with nearest-point hover treat these as point marks: a
|
|
17
|
+
loop lies within reach of its node, so it would otherwise always lose
|
|
18
|
+
the pointer to it.
|
|
19
|
+
*/ export function isSelfLoopMark(node) {
|
|
20
|
+
if (node.type !== "path") return false;
|
|
21
|
+
const meta = linkMeta(node.datum);
|
|
22
|
+
return !!meta && meta.source.id === meta.target.id;
|
|
23
|
+
}
|
|
24
|
+
/** A usable stroke width: finite and not negative, else none. */ const strokeWidthOf = (sw)=>Number.isFinite(sw) ? Math.max(0, sw) : 0;
|
|
25
|
+
/**
|
|
26
|
+
How far a hairline loop reaches past the edge of a node of radius `r`:
|
|
27
|
+
a little more than the radius, and at least 10 pixels. A stroked loop
|
|
28
|
+
is sized from it (see `selfLoopGeometry`).
|
|
29
|
+
*/ export function selfLoopReach(r) {
|
|
30
|
+
return Math.max((Number.isFinite(r) ? r : 0) * 1.25, 10);
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
How far a loop's outer edge reaches past its node's edge, for a loop of
|
|
34
|
+
`reach` (see `selfLoopReach`) drawn with a `strokeWidth` stroke.
|
|
35
|
+
*/ export function selfLoopExtent(reach, strokeWidth = 0) {
|
|
36
|
+
return selfLoopOpening(reach, strokeWidth) + strokeWidthOf(strokeWidth);
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
How far a loop's opening (inside its stroke) reaches past its node's
|
|
40
|
+
edge: a hairline loop's `reach`, plus one stroke width, so the opening
|
|
41
|
+
grows with the stroke and the arrowhead (which grows with the stroke
|
|
42
|
+
too) leaves it clear. The loop's line sits half a stroke further out.
|
|
43
|
+
*/ export function selfLoopOpening(reach, strokeWidth = 0) {
|
|
44
|
+
return Math.max(0, reach) + strokeWidthOf(strokeWidth);
|
|
45
|
+
}
|
|
46
|
+
/** The widest a loop's ends spread on its node, either side of its direction (radians). */ const MAX_END_ANGLE = 1.2;
|
|
47
|
+
/**
|
|
48
|
+
The loop's four Bézier points, pointing along `angle` from `node`. The
|
|
49
|
+
opening's edge is a hairline loop reaching `selfLoopOpening` past the
|
|
50
|
+
node: its ends sit on the node's edge, close enough together for that
|
|
51
|
+
reach, and its control points put its middle that far out. The loop's
|
|
52
|
+
line runs half a stroke outside it all round (its ends further apart
|
|
53
|
+
along the node's edge, its middle and sides further out), so the
|
|
54
|
+
stroke's inner edge follows the opening rather than closing it.
|
|
55
|
+
*/ function loopPoints(node, angle, reach, strokeWidth = 0) {
|
|
56
|
+
const r = Math.max(0, node.r || 0);
|
|
57
|
+
const half = strokeWidthOf(strokeWidth) / 2;
|
|
58
|
+
const opening = selfLoopOpening(reach, strokeWidth);
|
|
59
|
+
const ux = Math.cos(angle);
|
|
60
|
+
const uy = Math.sin(angle);
|
|
61
|
+
// Across the loop: from its source side to its target side.
|
|
62
|
+
const vx = -uy;
|
|
63
|
+
const vy = ux;
|
|
64
|
+
// The opening's half-angle between its two ends on the node's edge.
|
|
65
|
+
const s = r > 0 ? Math.min(0.5, Math.asin(Math.min(1, opening * 0.3 / r))) : 0;
|
|
66
|
+
const hairAcross = r * Math.sin(s);
|
|
67
|
+
// The line's ends, half a stroke further apart on each side.
|
|
68
|
+
const end = r > 0 ? Math.min(MAX_END_ANGLE, Math.asin(Math.min(1, (hairAcross + half) / r))) : 0;
|
|
69
|
+
const along = r * Math.cos(end);
|
|
70
|
+
const across = r * Math.sin(end);
|
|
71
|
+
// Control points far enough out that the curve's middle is half a stroke past the opening.
|
|
72
|
+
const far = (8 * (r + opening + half) - 2 * along) / 6;
|
|
73
|
+
// 1.5× the offset at the control points moves the curve's sides out by about the offset.
|
|
74
|
+
const wide = opening * 0.8 + hairAcross + half * 1.5;
|
|
75
|
+
const at = (a, b)=>[
|
|
76
|
+
node.x + ux * a + vx * b,
|
|
77
|
+
node.y + uy * a + vy * b
|
|
78
|
+
];
|
|
79
|
+
return [
|
|
80
|
+
at(along, -across),
|
|
81
|
+
at(far, -wide),
|
|
82
|
+
at(far, wide),
|
|
83
|
+
at(along, across)
|
|
84
|
+
];
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
A loop on `node`, pointing out from it along `angle` (radians). A
|
|
88
|
+
hairline loop's far point sits `reach` pixels past the node's edge. A
|
|
89
|
+
loop with a `strokeWidth` stroke keeps an opening inside its stroke
|
|
90
|
+
that grows with it (see `selfLoopOpening`), and its outer edge reaches
|
|
91
|
+
`selfLoopExtent` past the node's edge. The loop leaves the node on one
|
|
92
|
+
side of `angle` and comes back on the other, clockwise on screen.
|
|
93
|
+
*/ export function selfLoopGeometry(node, angle, reach, strokeWidth = 0) {
|
|
94
|
+
const [p0, p1, p2, p3] = loopPoints(node, angle, Math.max(0, reach), strokeWidth);
|
|
95
|
+
const pad = strokeWidthOf(strokeWidth) / 2;
|
|
96
|
+
const apexPoint = cubicPoint(p0, p1, p2, p3, 0.5);
|
|
97
|
+
const end = (from, to)=>{
|
|
98
|
+
const dx = to[0] - from[0];
|
|
99
|
+
const dy = to[1] - from[1];
|
|
100
|
+
const len = Math.hypot(dx, dy) || 1;
|
|
101
|
+
// A pixel outside the node's edge, as straight links' arrows sit.
|
|
102
|
+
return {
|
|
103
|
+
x: to[0] - dx / len,
|
|
104
|
+
y: to[1] - dy / len,
|
|
105
|
+
angle: Math.atan2(dy, dx)
|
|
106
|
+
};
|
|
107
|
+
};
|
|
108
|
+
const samples = Array.from({
|
|
109
|
+
length: 25
|
|
110
|
+
}, (_, k)=>cubicPoint(p0, p1, p2, p3, k / 24));
|
|
111
|
+
const xs = samples.map((p)=>p[0]);
|
|
112
|
+
const ys = samples.map((p)=>p[1]);
|
|
113
|
+
return {
|
|
114
|
+
d: cubicPathD([
|
|
115
|
+
p0,
|
|
116
|
+
p1,
|
|
117
|
+
p2,
|
|
118
|
+
p3
|
|
119
|
+
]),
|
|
120
|
+
apex: {
|
|
121
|
+
x: apexPoint[0],
|
|
122
|
+
y: apexPoint[1],
|
|
123
|
+
angle: angle + Math.PI / 2
|
|
124
|
+
},
|
|
125
|
+
source: end(p1, p0),
|
|
126
|
+
target: end(p2, p3),
|
|
127
|
+
box: [
|
|
128
|
+
[
|
|
129
|
+
Math.min(...xs) - pad,
|
|
130
|
+
Math.min(...ys) - pad
|
|
131
|
+
],
|
|
132
|
+
[
|
|
133
|
+
Math.max(...xs) + pad,
|
|
134
|
+
Math.max(...ys) + pad
|
|
135
|
+
]
|
|
136
|
+
],
|
|
137
|
+
angle,
|
|
138
|
+
points: [
|
|
139
|
+
p0,
|
|
140
|
+
p1,
|
|
141
|
+
p2,
|
|
142
|
+
p3
|
|
143
|
+
]
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
/** How far back along a loop from its end each arrow tip sits: a pixel off the node's edge. */ const LOOP_TIP_BACK = {
|
|
147
|
+
source: 1,
|
|
148
|
+
target: 1
|
|
149
|
+
};
|
|
150
|
+
/**
|
|
151
|
+
A loop's visible stroke: along the loop up to the base of the arrowhead
|
|
152
|
+
at each end that has one (`trims`, see `edgeArrowTrims`), then straight
|
|
153
|
+
along the head's axis to end inside it (see `cubicArrowEdge`). The full
|
|
154
|
+
loop stays its hit area.
|
|
155
|
+
*/ export function selfLoopD(loop, trims) {
|
|
156
|
+
if (!trims.ends.source && !trims.ends.target) return loop.d;
|
|
157
|
+
return cubicArrowEdge(loop.points, trims, LOOP_TIP_BACK).d;
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
The angle (radians) a loop on `node` covers, seen from the node's center,
|
|
161
|
+
stroke included, with a little air either side: how much of the turn
|
|
162
|
+
around the node it takes in a fan.
|
|
163
|
+
*/ export function selfLoopSpread(node, reach, strokeWidth = 0) {
|
|
164
|
+
const local = {
|
|
165
|
+
x: 0,
|
|
166
|
+
y: 0,
|
|
167
|
+
r: node.r
|
|
168
|
+
};
|
|
169
|
+
const sw = strokeWidthOf(strokeWidth);
|
|
170
|
+
const [p0, p1, p2, p3] = loopPoints(local, 0, Math.max(0, reach), sw);
|
|
171
|
+
let half = 0;
|
|
172
|
+
for(let k = 0; k <= 24; k++){
|
|
173
|
+
const [x, y] = cubicPoint(p0, p1, p2, p3, k / 24);
|
|
174
|
+
half = Math.max(half, Math.abs(Math.atan2(y, x)));
|
|
175
|
+
}
|
|
176
|
+
const stroke = Math.atan2(sw / 2, Math.max(0, node.r) + reach / 2);
|
|
177
|
+
// A little air between neighbors.
|
|
178
|
+
return (half + stroke) * 2 * 1.1;
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
The directions for a fan of loops on one node, one per entry in
|
|
182
|
+
`spreads` (each the angle its loop covers, see `selfLoopSpread`), in
|
|
183
|
+
order around the node: neighbors sit half of each one's spread apart,
|
|
184
|
+
and the fan is centered on `angle`. When the fan needs more than a full
|
|
185
|
+
turn, every gap shrinks in proportion so the fan closes into one turn.
|
|
186
|
+
*/ export function selfLoopAngles(angle, spreads) {
|
|
187
|
+
const count = spreads.length;
|
|
188
|
+
if (!count) return [];
|
|
189
|
+
const gaps = spreads.slice(1).map((s, k)=>(spreads[k] + s) / 2);
|
|
190
|
+
const span = gaps.reduce((sum, g)=>sum + g, 0);
|
|
191
|
+
// The whole turn the fan would take, closing back round to its first loop.
|
|
192
|
+
const ring = span + (spreads[0] + spreads[count - 1]) / 2;
|
|
193
|
+
const scale = count > 1 && ring > Math.PI * 2 ? Math.PI * 2 / ring : 1;
|
|
194
|
+
let at = angle - span * scale / 2;
|
|
195
|
+
return spreads.map((_, k)=>{
|
|
196
|
+
if (k) at += gaps[k - 1] * scale;
|
|
197
|
+
return at;
|
|
198
|
+
});
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
The positions in a fan of `count`, from its middle outward: the middle
|
|
202
|
+
first, then alternating to either side.
|
|
203
|
+
*/ export function fanOrder(count) {
|
|
204
|
+
const mid = Math.floor((count - 1) / 2);
|
|
205
|
+
const out = [];
|
|
206
|
+
for(let k = 0; out.length < count; k++){
|
|
207
|
+
const offset = k % 2 ? (k + 1) / 2 : -k / 2;
|
|
208
|
+
const slot = mid + offset;
|
|
209
|
+
if (slot >= 0 && slot < count) out.push(slot);
|
|
210
|
+
}
|
|
211
|
+
return out;
|
|
212
|
+
}
|
|
213
|
+
/**
|
|
214
|
+
The direction (radians) out of `origin` with the most room: the middle of
|
|
215
|
+
the widest gap between the directions to `points` (one point leaves the
|
|
216
|
+
whole turn, so the loop points straight away from it). Points on `origin`
|
|
217
|
+
are ignored; with none left, `fallback`.
|
|
218
|
+
*/ export function widestGapAngle(origin, points, fallback) {
|
|
219
|
+
const angles = points.filter((p)=>p[0] !== origin[0] || p[1] !== origin[1]).map((p)=>Math.atan2(p[1] - origin[1], p[0] - origin[0])).sort((a, b)=>a - b);
|
|
220
|
+
if (!angles.length) return fallback;
|
|
221
|
+
let best = Math.PI * 2 - (angles[angles.length - 1] - angles[0]);
|
|
222
|
+
let start = angles[angles.length - 1];
|
|
223
|
+
for(let k = 1; k < angles.length; k++){
|
|
224
|
+
const gap = angles[k] - angles[k - 1];
|
|
225
|
+
if (gap > best + 1e-9) {
|
|
226
|
+
best = gap;
|
|
227
|
+
start = angles[k - 1];
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
const mid = start + best / 2;
|
|
231
|
+
return Math.atan2(Math.sin(mid), Math.cos(mid));
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
The direction (radians) pointing from `center` out through `point`, or
|
|
235
|
+
`fallback` (straight up by default) when they coincide.
|
|
236
|
+
*/ export function awayFromAngle(point, center, fallback = -Math.PI / 2) {
|
|
237
|
+
const dx = point[0] - center[0];
|
|
238
|
+
const dy = point[1] - center[1];
|
|
239
|
+
return dx || dy ? Math.atan2(dy, dx) : fallback;
|
|
240
|
+
}
|
|
241
|
+
/**
|
|
242
|
+
Lays out a set of loops: every node's loops share one hairline size (the
|
|
243
|
+
largest `reach` among them), each stroked by its own `strokeWidth`, and
|
|
244
|
+
fan out around the node's direction so they don't draw over each other,
|
|
245
|
+
the heaviest in the middle. Each loop takes as much of the fan as its
|
|
246
|
+
own stroke needs.
|
|
247
|
+
@param loops The loops, each a link from a node to itself.
|
|
248
|
+
@param opts `node` gives a loop's node (with an `id`), `angle` the
|
|
249
|
+
direction a node's loops point, `reach` how far a hairline loop reaches,
|
|
250
|
+
and `strokeWidth` (optional) its stroke.
|
|
251
|
+
*/ export function layoutSelfLoops(loops, opts) {
|
|
252
|
+
const byNode = new Map();
|
|
253
|
+
for (const loop of loops){
|
|
254
|
+
const id = opts.node(loop).id;
|
|
255
|
+
if (!byNode.has(id)) byNode.set(id, []);
|
|
256
|
+
byNode.get(id).push(loop);
|
|
257
|
+
}
|
|
258
|
+
const out = new Map();
|
|
259
|
+
for (const group of byNode.values()){
|
|
260
|
+
const node = opts.node(group[0]);
|
|
261
|
+
if (![
|
|
262
|
+
node.x,
|
|
263
|
+
node.y
|
|
264
|
+
].every(Number.isFinite)) continue;
|
|
265
|
+
const reach = Math.max(...group.map((l)=>opts.reach(l)));
|
|
266
|
+
// The heaviest loop takes the middle of the fan, where the most room is.
|
|
267
|
+
const heaviest = group.map((loop, k)=>({
|
|
268
|
+
loop,
|
|
269
|
+
k,
|
|
270
|
+
w: strokeWidthOf(opts.strokeWidth?.(loop) ?? 0)
|
|
271
|
+
})).sort((a, b)=>b.w - a.w || a.k - b.k);
|
|
272
|
+
const slots = fanOrder(group.length);
|
|
273
|
+
const bySlot = new Array(group.length);
|
|
274
|
+
heaviest.forEach((entry, k)=>bySlot[slots[k]] = entry);
|
|
275
|
+
const angles = selfLoopAngles(opts.angle(node), bySlot.map(({ w })=>selfLoopSpread(node, reach, w)));
|
|
276
|
+
bySlot.forEach(({ loop, w }, slot)=>out.set(loop, selfLoopGeometry(node, angles[slot], reach, w)));
|
|
277
|
+
}
|
|
278
|
+
return out;
|
|
279
|
+
}
|
|
280
|
+
/** The union of two boxes. */ export function unionBox(a, b) {
|
|
281
|
+
return [
|
|
282
|
+
[
|
|
283
|
+
Math.min(a[0][0], b[0][0]),
|
|
284
|
+
Math.min(a[0][1], b[0][1])
|
|
285
|
+
],
|
|
286
|
+
[
|
|
287
|
+
Math.max(a[1][0], b[1][0]),
|
|
288
|
+
Math.max(a[1][1], b[1][1])
|
|
289
|
+
]
|
|
290
|
+
];
|
|
291
|
+
}
|
|
292
|
+
/**
|
|
293
|
+
Arrowheads for a loop at the ends `arrows` selects: at its target end
|
|
294
|
+
where it comes back into the node, at its source end where it leaves,
|
|
295
|
+
each aimed along the loop's chord from its base to its tip.
|
|
296
|
+
*/ export function selfLoopArrows(opts) {
|
|
297
|
+
const trims = edgeArrowTrims(opts);
|
|
298
|
+
if (!trims.ends.source && !trims.ends.target) return [];
|
|
299
|
+
return chordArrowNodes({
|
|
300
|
+
ends: cubicArrowEdge(opts.loop.points, trims, LOOP_TIP_BACK),
|
|
301
|
+
size: trims.size,
|
|
302
|
+
datum: opts.datum,
|
|
303
|
+
keyPrefix: opts.keyPrefix,
|
|
304
|
+
fill: opts.fill
|
|
305
|
+
});
|
|
306
|
+
}
|