@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,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Every label a Pie or Donut draws for its slices: the labels inside the
|
|
3
|
+
ring (straight or curved, see `curvedLabels.ts`), and which slices take
|
|
4
|
+
a label outside the ring instead (see `labelPosition`). The plan is
|
|
5
|
+
worked out once per layout and kept on the chart's context, so the
|
|
6
|
+
layout stage, which sizes the ring to leave room for the outside labels,
|
|
7
|
+
and the emit step share it.
|
|
8
|
+
*/ import { formatAbbreviate } from "@d3plus/format";
|
|
9
|
+
import { resolveAccessor, shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
|
|
10
|
+
import { ringLabelFont, ringTextWidth } from "../features/ringLabelNodes.js";
|
|
11
|
+
import { ringLabelPosition } from "../features/ringLabels.js";
|
|
12
|
+
import { pieSliceLabels } from "./curvedLabels.js";
|
|
13
|
+
import { OUTSIDE_LABEL_FONT_SIZE } from "./outsideLabels.js";
|
|
14
|
+
import { pieStraightLabels } from "./straightLabels.js";
|
|
15
|
+
/**
|
|
16
|
+
The narrowest a text gets wrapped onto two lines between its words: the
|
|
17
|
+
wider of the two lines at the best break. A single word can't wrap, so
|
|
18
|
+
its width is its own.
|
|
19
|
+
@param text The text.
|
|
20
|
+
@param width A string's one-line width.
|
|
21
|
+
*/ export function twoLineWidth(text, width) {
|
|
22
|
+
const words = text.split(/\s+/).filter(Boolean);
|
|
23
|
+
let best = width(words.join(" "));
|
|
24
|
+
for(let k = 1; k < words.length; k++)best = Math.min(best, Math.max(width(words.slice(0, k).join(" ")), width(words.slice(k).join(" "))));
|
|
25
|
+
return best;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
Formats a slice's share as a percentage in the chart's locale.
|
|
29
|
+
@param viz The chart.
|
|
30
|
+
*/ export function pieSharePct(viz) {
|
|
31
|
+
const locale = viz.schema.locale;
|
|
32
|
+
return (d)=>`${formatAbbreviate((d.share ?? 0) * 100, locale)}%`;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
The outside labels' font size: the Path labelConfig's `fontSize`, else
|
|
36
|
+
`OUTSIDE_LABEL_FONT_SIZE`.
|
|
37
|
+
@param labelConfig The Path labelConfig.
|
|
38
|
+
*/ export function outsideFontSize(labelConfig) {
|
|
39
|
+
const size = labelConfig.fontSize;
|
|
40
|
+
return typeof size === "number" && size > 0 ? size : OUTSIDE_LABEL_FONT_SIZE;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
Whether a slice's `labelPosition` puts its label outside the ring:
|
|
44
|
+
always for `"outside"`, never for `"inside"` or `"along"`, and for
|
|
45
|
+
`"auto"` only when its label inside doesn't show its whole name.
|
|
46
|
+
@param position The slice's `labelPosition`.
|
|
47
|
+
@param shownWhole Whether its label inside shows its whole name.
|
|
48
|
+
*/ export function labelGoesOutside(position, shownWhole) {
|
|
49
|
+
if (position === "outside") return true;
|
|
50
|
+
if (position === "inside" || position === "along") return false;
|
|
51
|
+
return !shownWhole;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
Whether any slice's `labelPosition` may put its label outside the ring:
|
|
55
|
+
false when every one is `"inside"` or `"along"`.
|
|
56
|
+
@param viz The chart.
|
|
57
|
+
@param slices The laid-out slices.
|
|
58
|
+
*/ export function pieMayLabelOutside(viz, slices) {
|
|
59
|
+
return slices.some((d, k)=>{
|
|
60
|
+
const position = ringLabelPosition(viz, d.data, d.i ?? k);
|
|
61
|
+
return position !== "inside" && position !== "along";
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
Works out every slice's label for the current layout (`viz.ctx.arcData`):
|
|
66
|
+
the labels inside the ring, and the slices whose label goes outside it.
|
|
67
|
+
Kept on `viz.ctx`, so the same layout is only worked out once.
|
|
68
|
+
@param viz The chart, laid out by `applyPieLayout`.
|
|
69
|
+
@param slices The laid-out slices.
|
|
70
|
+
*/ export function pieLabelPlan(viz, slices) {
|
|
71
|
+
const arcGen = viz.ctx.arcData;
|
|
72
|
+
const cached = viz.ctx.pieLabelPlan;
|
|
73
|
+
if (cached && cached.arc === arcGen && cached.slices === slices) return cached.plan;
|
|
74
|
+
const resolveInnerRadius = arcGen.innerRadius();
|
|
75
|
+
const resolveOuterRadius = arcGen.outerRadius();
|
|
76
|
+
const sc = shapeConfigFor(viz, "Path");
|
|
77
|
+
const labelConfig = userLabelConfig(viz, "Path");
|
|
78
|
+
const sharePct = pieSharePct(viz);
|
|
79
|
+
const nameOf = (d)=>viz._drawLabel(d.data, d.i ?? 0);
|
|
80
|
+
const arcOf = (d)=>({
|
|
81
|
+
innerRadius: resolveInnerRadius(d, d.i ?? 0),
|
|
82
|
+
outerRadius: resolveOuterRadius(d, d.i ?? 0),
|
|
83
|
+
startAngle: d.startAngle,
|
|
84
|
+
endAngle: d.endAngle,
|
|
85
|
+
padAngle: d.padAngle
|
|
86
|
+
});
|
|
87
|
+
const inside = pieSliceLabels({
|
|
88
|
+
viz,
|
|
89
|
+
slices,
|
|
90
|
+
arcOf,
|
|
91
|
+
nameOf,
|
|
92
|
+
shareOf: sharePct,
|
|
93
|
+
fillOf: (d)=>resolveAccessor(sc.fill, d.data, d.i ?? 0),
|
|
94
|
+
straight: pieStraightLabels({
|
|
95
|
+
viz,
|
|
96
|
+
slices,
|
|
97
|
+
arcOf,
|
|
98
|
+
sc,
|
|
99
|
+
sharePct,
|
|
100
|
+
labelConfig
|
|
101
|
+
}),
|
|
102
|
+
labelConfig
|
|
103
|
+
});
|
|
104
|
+
const outside = [];
|
|
105
|
+
if (pieMayLabelOutside(viz, slices)) {
|
|
106
|
+
const font = ringLabelFont(labelConfig);
|
|
107
|
+
const fontSize = outsideFontSize(labelConfig);
|
|
108
|
+
slices.forEach((slice, k)=>{
|
|
109
|
+
const index = slice.i ?? k;
|
|
110
|
+
const name = nameOf(slice);
|
|
111
|
+
const position = ringLabelPosition(viz, slice.data, index);
|
|
112
|
+
if (!name || !labelGoesOutside(position, inside.whole.has(slice))) return;
|
|
113
|
+
const text = `${name} ${sharePct(slice)}`;
|
|
114
|
+
const measure = (t)=>ringTextWidth(t, font)(fontSize);
|
|
115
|
+
outside.push({
|
|
116
|
+
slice,
|
|
117
|
+
index,
|
|
118
|
+
angle: (slice.startAngle + slice.endAngle) / 2,
|
|
119
|
+
text,
|
|
120
|
+
width: measure(text),
|
|
121
|
+
wrapWidth: twoLineWidth(text, measure),
|
|
122
|
+
weight: slice.value
|
|
123
|
+
});
|
|
124
|
+
});
|
|
125
|
+
}
|
|
126
|
+
const plan = {
|
|
127
|
+
straight: inside.straight,
|
|
128
|
+
curved: inside.curved,
|
|
129
|
+
outside
|
|
130
|
+
};
|
|
131
|
+
viz.ctx.pieLabelPlan = {
|
|
132
|
+
arc: arcGen,
|
|
133
|
+
slices,
|
|
134
|
+
plan
|
|
135
|
+
};
|
|
136
|
+
return plan;
|
|
137
|
+
}
|
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Axis-aligned boxes centered on a ring segment's bisector: the line from
|
|
3
|
+
the ring's center through the middle of the segment. A box centered on
|
|
4
|
+
it reads as centered in its slice. Every box here is symmetric about its
|
|
5
|
+
center, so where it goes is a single number, the center's distance from
|
|
6
|
+
the ring's center along the bisector.
|
|
7
|
+
|
|
8
|
+
Angles are radians in d3-shape's convention (0 at 12 o'clock, increasing
|
|
9
|
+
clockwise), so a point at angle `a` and radius `r` sits at
|
|
10
|
+
`(r·sin a, −r·cos a)`.
|
|
11
|
+
*/ const TAU = Math.PI * 2;
|
|
12
|
+
const EPSILON = 1e-9;
|
|
13
|
+
/** The point at angle `a` on the unit circle. */ const unit = (a)=>[
|
|
14
|
+
Math.sin(a),
|
|
15
|
+
-Math.cos(a)
|
|
16
|
+
];
|
|
17
|
+
/**
|
|
18
|
+
Resolves a ring segment's edges, the way d3-shape's arc draws it: a
|
|
19
|
+
`padAngle` narrows a Pie wedge (no hole) by that angle, and offsets a
|
|
20
|
+
ring segment's sides by a constant gap (`padAngle` at the default pad
|
|
21
|
+
radius, `√(inner² + outer²)`). `padding` keeps a box that much further
|
|
22
|
+
inside every edge. A full turn has no sides; its bisector points up.
|
|
23
|
+
Null when the segment has no area.
|
|
24
|
+
@param arc The segment.
|
|
25
|
+
@param padding The room kept inside every edge, in pixels.
|
|
26
|
+
*/ export function sectorEdges(arc, padding = 0) {
|
|
27
|
+
let a0 = Math.min(arc.startAngle, arc.endAngle);
|
|
28
|
+
let a1 = Math.max(arc.startAngle, arc.endAngle);
|
|
29
|
+
const inner = arc.innerRadius > 0 ? arc.innerRadius + padding : 0;
|
|
30
|
+
const outer = arc.outerRadius - padding;
|
|
31
|
+
if (!(a1 - a0 > EPSILON) || !(outer > inner)) return null;
|
|
32
|
+
if (a1 - a0 >= TAU - 1e-6) return {
|
|
33
|
+
mid: 0,
|
|
34
|
+
dir: unit(0),
|
|
35
|
+
span: TAU,
|
|
36
|
+
inner,
|
|
37
|
+
outer,
|
|
38
|
+
sides: []
|
|
39
|
+
};
|
|
40
|
+
const half = (arc.padAngle ?? 0) / 2;
|
|
41
|
+
let gap = 0;
|
|
42
|
+
if (half > 0 && arc.innerRadius > 0) gap = Math.hypot(arc.innerRadius, arc.outerRadius) * Math.sin(half);
|
|
43
|
+
else if (half > 0) {
|
|
44
|
+
a0 += half;
|
|
45
|
+
a1 -= half;
|
|
46
|
+
}
|
|
47
|
+
const span = a1 - a0;
|
|
48
|
+
if (!(span > EPSILON)) return null;
|
|
49
|
+
const mid = (a0 + a1) / 2;
|
|
50
|
+
const offset = gap + padding;
|
|
51
|
+
const sides = [
|
|
52
|
+
{
|
|
53
|
+
normal: [
|
|
54
|
+
Math.cos(a0),
|
|
55
|
+
Math.sin(a0)
|
|
56
|
+
],
|
|
57
|
+
offset,
|
|
58
|
+
ray: unit(a0)
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
normal: [
|
|
62
|
+
-Math.cos(a1),
|
|
63
|
+
-Math.sin(a1)
|
|
64
|
+
],
|
|
65
|
+
offset,
|
|
66
|
+
ray: unit(a1)
|
|
67
|
+
}
|
|
68
|
+
];
|
|
69
|
+
return {
|
|
70
|
+
mid,
|
|
71
|
+
dir: unit(mid),
|
|
72
|
+
span,
|
|
73
|
+
inner,
|
|
74
|
+
outer,
|
|
75
|
+
sides
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
/** The least `t` at which a box of half-size `a`×`b` centered at `t·dir` clears a circle of radius `r` around the center. */ function clearInner(dir, a, b, r) {
|
|
79
|
+
if (!(r > 0)) return -Infinity;
|
|
80
|
+
const ux = Math.abs(dir[0]);
|
|
81
|
+
const uy = Math.abs(dir[1]);
|
|
82
|
+
const found = [];
|
|
83
|
+
// The nearest point is on the box's side facing the center…
|
|
84
|
+
if (ux > EPSILON) {
|
|
85
|
+
const t = (a + r) / ux;
|
|
86
|
+
if (t * uy <= b + EPSILON) found.push(t);
|
|
87
|
+
}
|
|
88
|
+
// …or on its top or bottom…
|
|
89
|
+
if (uy > EPSILON) {
|
|
90
|
+
const t = (b + r) / uy;
|
|
91
|
+
if (t * ux <= a + EPSILON) found.push(t);
|
|
92
|
+
}
|
|
93
|
+
// …or its corner nearest the center.
|
|
94
|
+
const k = a * ux + b * uy;
|
|
95
|
+
const disc = k * k - (a * a + b * b - r * r);
|
|
96
|
+
if (disc >= 0) {
|
|
97
|
+
const t = k + Math.sqrt(disc);
|
|
98
|
+
if (t * ux >= a - EPSILON && t * uy >= b - EPSILON) found.push(t);
|
|
99
|
+
}
|
|
100
|
+
return found.length ? Math.min(...found) : Infinity;
|
|
101
|
+
}
|
|
102
|
+
/** The least `t` at which a box of half-size `a`×`b` centered at `t·dir` sits inside `side`. */ function insideSide(side, dir, a, b) {
|
|
103
|
+
const [nx, ny] = side.normal;
|
|
104
|
+
const along = nx * dir[0] + ny * dir[1];
|
|
105
|
+
const need = side.offset + a * Math.abs(nx) + b * Math.abs(ny);
|
|
106
|
+
return along > EPSILON ? need / along : Infinity;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
The least `t` at which a box centered at `t·dir` keeps clear of a
|
|
110
|
+
segment's gap when the segment spans more than half a turn. The gap is
|
|
111
|
+
then a convex wedge, so the box clears it when one of the box's own
|
|
112
|
+
axes, or a side's normal, separates the two.
|
|
113
|
+
*/ function clearGap(edges, a, b) {
|
|
114
|
+
const { dir, sides, span } = edges;
|
|
115
|
+
let least = Math.min(...sides.map((s)=>insideSide(s, dir, a, b)));
|
|
116
|
+
// The gap's apex sits on the bisector, where the two sides meet.
|
|
117
|
+
const apex = sides[0].offset / Math.sin(span / 2);
|
|
118
|
+
const axes = [
|
|
119
|
+
[
|
|
120
|
+
1,
|
|
121
|
+
0
|
|
122
|
+
],
|
|
123
|
+
[
|
|
124
|
+
-1,
|
|
125
|
+
0
|
|
126
|
+
],
|
|
127
|
+
[
|
|
128
|
+
0,
|
|
129
|
+
1
|
|
130
|
+
],
|
|
131
|
+
[
|
|
132
|
+
0,
|
|
133
|
+
-1
|
|
134
|
+
]
|
|
135
|
+
];
|
|
136
|
+
for (const e of axes){
|
|
137
|
+
const dot = (p)=>e[0] * p[0] + e[1] * p[1];
|
|
138
|
+
// The gap reaches no further than its apex along `e` only when both of
|
|
139
|
+
// its edges run that way.
|
|
140
|
+
if (dot(sides[0].ray) < -EPSILON || dot(sides[1].ray) < -EPSILON) continue;
|
|
141
|
+
const reach = a * Math.abs(e[0]) + b * Math.abs(e[1]);
|
|
142
|
+
const toward = dot(dir);
|
|
143
|
+
const limit = apex * toward;
|
|
144
|
+
if (toward < -EPSILON) least = Math.min(least, (reach - limit) / -toward);
|
|
145
|
+
else if (reach <= limit + EPSILON) least = -Infinity;
|
|
146
|
+
}
|
|
147
|
+
return least;
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
The stretch of a segment's bisector where a `width`×`height` box can be
|
|
151
|
+
centered and stay inside the segment, as distances from the ring's
|
|
152
|
+
center: from `lo` to `hi`. For a whole disc it runs through the center,
|
|
153
|
+
from `-hi` to `hi`. Null when the box fits nowhere along it.
|
|
154
|
+
@param edges The segment's edges (see `sectorEdges`).
|
|
155
|
+
@param width The box's width.
|
|
156
|
+
@param height The box's height.
|
|
157
|
+
*/ export function sectorBoxRange(edges, width, height) {
|
|
158
|
+
const a = width / 2;
|
|
159
|
+
const b = height / 2;
|
|
160
|
+
const { dir, inner, outer, sides, span } = edges;
|
|
161
|
+
const ux = Math.abs(dir[0]);
|
|
162
|
+
const uy = Math.abs(dir[1]);
|
|
163
|
+
// The corner furthest from the center reaches the outer edge at `hi`.
|
|
164
|
+
const k = a * ux + b * uy;
|
|
165
|
+
const disc = k * k - (a * a + b * b - outer * outer);
|
|
166
|
+
if (a * a + b * b > outer * outer || disc < 0) return null;
|
|
167
|
+
const hi = -k + Math.sqrt(disc);
|
|
168
|
+
if (!sides.length && !(inner > 0)) return {
|
|
169
|
+
lo: -hi,
|
|
170
|
+
hi
|
|
171
|
+
};
|
|
172
|
+
let lo = Math.max(0, clearInner(dir, a, b, inner));
|
|
173
|
+
if (sides.length) lo = Math.max(lo, span > Math.PI ? clearGap(edges, a, b) : Math.max(...sides.map((s)=>insideSide(s, dir, a, b))));
|
|
174
|
+
return lo <= hi + EPSILON ? {
|
|
175
|
+
lo,
|
|
176
|
+
hi: Math.max(lo, hi)
|
|
177
|
+
} : null;
|
|
178
|
+
}
|
|
179
|
+
/**
|
|
180
|
+
The box of the given size centered on the bisector at distance `t`.
|
|
181
|
+
@param edges The segment's edges.
|
|
182
|
+
@param t The center's distance from the ring's center.
|
|
183
|
+
@param width The box's width.
|
|
184
|
+
@param height The box's height.
|
|
185
|
+
*/ export function sectorBoxAt(edges, t, width, height) {
|
|
186
|
+
return {
|
|
187
|
+
x: t * edges.dir[0] - width / 2,
|
|
188
|
+
y: t * edges.dir[1] - height / 2,
|
|
189
|
+
width,
|
|
190
|
+
height
|
|
191
|
+
};
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
A `width`×`height` box centered on a segment's bisector, halfway along
|
|
195
|
+
the stretch where it fits (see `sectorBoxRange`), so the room around it
|
|
196
|
+
is shared out evenly. Null when it fits nowhere.
|
|
197
|
+
@param edges The segment's edges.
|
|
198
|
+
@param width The box's width.
|
|
199
|
+
@param height The box's height.
|
|
200
|
+
*/ export function centeredSectorBox(edges, width, height) {
|
|
201
|
+
const range = sectorBoxRange(edges, width, height);
|
|
202
|
+
if (!range) return null;
|
|
203
|
+
return sectorBoxAt(edges, (range.lo + range.hi) / 2, width, height);
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
The largest box of a given shape centered on a segment's bisector, at
|
|
207
|
+
the one place along it where that box fits. The scale is searched from
|
|
208
|
+
0 up to the ring's diameter.
|
|
209
|
+
@param edges The segment's edges.
|
|
210
|
+
@param size The box's width and height at a scale, growing with it.
|
|
211
|
+
@param iterations How finely the scale is searched.
|
|
212
|
+
*/ export function largestSectorBox(edges, size, iterations = 40) {
|
|
213
|
+
const fits = (s)=>sectorBoxRange(edges, ...size(s)) !== null;
|
|
214
|
+
let lo = 0;
|
|
215
|
+
let hi = edges.outer * 2;
|
|
216
|
+
if (!fits(lo)) return null;
|
|
217
|
+
for(let n = 0; n < iterations; n++){
|
|
218
|
+
const s = (lo + hi) / 2;
|
|
219
|
+
if (fits(s)) lo = s;
|
|
220
|
+
else hi = s;
|
|
221
|
+
}
|
|
222
|
+
return lo > 0 ? centeredSectorBox(edges, ...size(lo)) : null;
|
|
223
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A Pie's straight slice labels, each centered on its slice's bisector
|
|
3
|
+
(see `straightLayout.ts`).
|
|
4
|
+
*/ import { colorContrast } from "@d3plus/color";
|
|
5
|
+
import constant from "../../utils/constant.js";
|
|
6
|
+
import { emitLabels } from "../../shapes/emitLabels.js";
|
|
7
|
+
import { resolveAccessor } from "../features/emitHelpers.js";
|
|
8
|
+
import { ringLabelFont, ringTextWidth } from "../features/ringLabelNodes.js";
|
|
9
|
+
import { sectorEdges } from "./sectorBox.js";
|
|
10
|
+
import { centerLabelLines, straightLabelLayout, straightLabelOptions, wrapWidths } from "./straightLayout.js";
|
|
11
|
+
/** The slice a label node names. */ const sliceOf = (node)=>node.datum?.data;
|
|
12
|
+
/**
|
|
13
|
+
Each slice's straight label, centered on its bisector: the name, at the
|
|
14
|
+
largest size that shows it whole, and the share percentage beneath it
|
|
15
|
+
when there is room (see `straightLabelLayout`).
|
|
16
|
+
@param inputs The slices, their segments and fills, and the label config.
|
|
17
|
+
*/ export function pieStraightLabels(inputs) {
|
|
18
|
+
const { viz, slices, arcOf, sc, sharePct, labelConfig } = inputs;
|
|
19
|
+
const options = straightLabelOptions(labelConfig);
|
|
20
|
+
const font = ringLabelFont(labelConfig);
|
|
21
|
+
const unitWidth = (text)=>ringTextWidth(text, font)(1);
|
|
22
|
+
const layouts = new Map();
|
|
23
|
+
slices.forEach((d, i)=>{
|
|
24
|
+
const name = viz._drawLabel(d.data, d.i ?? i);
|
|
25
|
+
const edges = name ? sectorEdges(arcOf(d)) : null;
|
|
26
|
+
if (!edges) return;
|
|
27
|
+
const layout = straightLabelLayout(edges, wrapWidths(String(name), unitWidth, options.maxLines), unitWidth(sharePct(d)), options);
|
|
28
|
+
if (layout) layouts.set(d, layout);
|
|
29
|
+
});
|
|
30
|
+
const nodes = emitLabels({
|
|
31
|
+
data: slices,
|
|
32
|
+
label: (_d, i)=>{
|
|
33
|
+
const name = viz._drawLabel(slices[i].data, slices[i].i ?? i);
|
|
34
|
+
return layouts.get(slices[i])?.share ? [
|
|
35
|
+
name,
|
|
36
|
+
sharePct(slices[i])
|
|
37
|
+
] : [
|
|
38
|
+
name
|
|
39
|
+
];
|
|
40
|
+
},
|
|
41
|
+
// The boxes are in chart-centered path coordinates, so the anchor is
|
|
42
|
+
// the origin and labelBounds carries each absolute box.
|
|
43
|
+
x: ()=>0,
|
|
44
|
+
y: ()=>0,
|
|
45
|
+
aes: ()=>({}),
|
|
46
|
+
rotate: constant(0),
|
|
47
|
+
id: (_d, i)=>`pie-label-${i}`,
|
|
48
|
+
labelBounds: (_d, i)=>{
|
|
49
|
+
const layout = layouts.get(slices[i]);
|
|
50
|
+
if (!layout) return false;
|
|
51
|
+
const boxes = layout.share ? [
|
|
52
|
+
layout.name,
|
|
53
|
+
layout.share
|
|
54
|
+
] : [
|
|
55
|
+
layout.name
|
|
56
|
+
];
|
|
57
|
+
return boxes.map((b)=>({
|
|
58
|
+
...b,
|
|
59
|
+
angle: 0
|
|
60
|
+
}));
|
|
61
|
+
},
|
|
62
|
+
labelConfig: {
|
|
63
|
+
fontColor: (d)=>{
|
|
64
|
+
const slice = d.data ?? d;
|
|
65
|
+
const fill = resolveAccessor(sc.fill, slice.data, slice.i ?? 0);
|
|
66
|
+
return colorContrast(typeof fill === "string" ? fill : "rgb(255, 255, 255)", viz.schema.colorDefaults);
|
|
67
|
+
},
|
|
68
|
+
textAnchor: "middle",
|
|
69
|
+
verticalAlign: "middle",
|
|
70
|
+
...labelConfig,
|
|
71
|
+
// Each label's size is worked out to fit its slice.
|
|
72
|
+
fontResize: false,
|
|
73
|
+
fontSize: (d)=>{
|
|
74
|
+
const layout = d.data ? layouts.get(d.data) : undefined;
|
|
75
|
+
if (!layout) return options.fontMin;
|
|
76
|
+
return d.l === 1 && layout.shareSize ? layout.shareSize : layout.fontSize;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
});
|
|
80
|
+
if (labelConfig.verticalAlign === undefined) {
|
|
81
|
+
const bySlice = new Map();
|
|
82
|
+
for (const node of nodes){
|
|
83
|
+
const slice = sliceOf(node);
|
|
84
|
+
if (!slice) continue;
|
|
85
|
+
bySlice.set(slice, [
|
|
86
|
+
...bySlice.get(slice) ?? [],
|
|
87
|
+
node
|
|
88
|
+
]);
|
|
89
|
+
}
|
|
90
|
+
bySlice.forEach((list, slice)=>{
|
|
91
|
+
const layout = layouts.get(slice);
|
|
92
|
+
if (layout) centerLabelLines(list, layout.center[1]);
|
|
93
|
+
});
|
|
94
|
+
}
|
|
95
|
+
return nodes;
|
|
96
|
+
}
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Sizes a Pie slice's straight label to its slice: the name, wrapped
|
|
3
|
+
between words onto as many lines as shows it largest, and the share on a
|
|
4
|
+
smaller line beneath it, in a box centered on the slice's bisector (see
|
|
5
|
+
`sectorBox.ts`).
|
|
6
|
+
*/ import { textLineBoxes } from "../features/linkLabels.js";
|
|
7
|
+
import { centeredSectorBox, largestSectorBox, sectorBoxRange } from "./sectorBox.js";
|
|
8
|
+
/** The defaults for `StraightLabelOptions`. */ export const STRAIGHT_LABEL_DEFAULTS = {
|
|
9
|
+
fontMin: 10,
|
|
10
|
+
fontMax: 32,
|
|
11
|
+
padding: 5,
|
|
12
|
+
lineHeight: 1.2,
|
|
13
|
+
shareRatio: 0.7,
|
|
14
|
+
shareKeep: 0.75,
|
|
15
|
+
shareFont: 16,
|
|
16
|
+
margin: 0.2,
|
|
17
|
+
maxLines: 4
|
|
18
|
+
};
|
|
19
|
+
/** A positive number, or undefined. */ const num = (v)=>typeof v === "number" && Number.isFinite(v) && v > 0 ? v : undefined;
|
|
20
|
+
/**
|
|
21
|
+
The straight label options a labelConfig asks for: its `fontSize` alone
|
|
22
|
+
when it sets one, else `fontMin` to `fontMax` (10 to 32 by default), and
|
|
23
|
+
its `padding` (5 by default).
|
|
24
|
+
@param config The labelConfig.
|
|
25
|
+
*/ export function straightLabelOptions(config) {
|
|
26
|
+
const size = num(config.fontSize);
|
|
27
|
+
const fontMax = size ?? num(config.fontMax) ?? STRAIGHT_LABEL_DEFAULTS.fontMax;
|
|
28
|
+
const fontMin = Math.min(fontMax, size ?? num(config.fontMin) ?? STRAIGHT_LABEL_DEFAULTS.fontMin);
|
|
29
|
+
const padding = typeof config.padding === "number" && config.padding >= 0 ? config.padding : STRAIGHT_LABEL_DEFAULTS.padding;
|
|
30
|
+
return {
|
|
31
|
+
...STRAIGHT_LABEL_DEFAULTS,
|
|
32
|
+
fontMin,
|
|
33
|
+
fontMax,
|
|
34
|
+
padding
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
The narrowest a text wraps between its words onto 1, 2, … lines: for
|
|
39
|
+
each line count, the widest line at the best breaks. Stops at
|
|
40
|
+
`maxLines`, or at one line per word.
|
|
41
|
+
@param text The text.
|
|
42
|
+
@param width A string's one-line width.
|
|
43
|
+
@param maxLines The most lines.
|
|
44
|
+
*/ export function wrapWidths(text, width, maxLines) {
|
|
45
|
+
const words = text.split(/\s+/).filter(Boolean);
|
|
46
|
+
const n = words.length;
|
|
47
|
+
if (!n) return [];
|
|
48
|
+
const cache = new Map();
|
|
49
|
+
const line = (i, j)=>{
|
|
50
|
+
const key = `${i},${j}`;
|
|
51
|
+
let w = cache.get(key);
|
|
52
|
+
if (w === undefined) {
|
|
53
|
+
w = width(words.slice(i, j).join(" "));
|
|
54
|
+
cache.set(key, w);
|
|
55
|
+
}
|
|
56
|
+
return w;
|
|
57
|
+
};
|
|
58
|
+
// best[j] is the narrowest the first j words wrap onto the current count.
|
|
59
|
+
let best = Array.from({
|
|
60
|
+
length: n + 1
|
|
61
|
+
}, (_, j)=>j ? line(0, j) : 0);
|
|
62
|
+
const out = [
|
|
63
|
+
best[n]
|
|
64
|
+
];
|
|
65
|
+
for(let k = 2; k <= Math.min(maxLines, n); k++){
|
|
66
|
+
const next = best.map(()=>Infinity);
|
|
67
|
+
for(let j = k; j <= n; j++)for(let i = k - 1; i < j; i++)next[j] = Math.min(next[j], Math.max(best[i], line(i, j)));
|
|
68
|
+
best = next;
|
|
69
|
+
out.push(best[n]);
|
|
70
|
+
}
|
|
71
|
+
return out;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
Lays a straight label out in a slice: the largest whole font size (up to
|
|
75
|
+
`fontMax`) at which the name, wrapped onto some number of lines, and the
|
|
76
|
+
share beneath it fit in a box centered on the slice's bisector, with
|
|
77
|
+
room around them (see `margin`). The share is left off when it would
|
|
78
|
+
shrink the name too much (see `shareKeep` and `shareFont`); a name on
|
|
79
|
+
more lines must show larger than on fewer. The box goes halfway along
|
|
80
|
+
the stretch of the bisector where it fits. When even `fontMin` doesn't
|
|
81
|
+
fit the name whole, the label is one line at `fontMin`, as wide as the
|
|
82
|
+
slice allows, and is cut short; null when that has no room for a few
|
|
83
|
+
letters.
|
|
84
|
+
@param edges The slice's edges (see `sectorEdges`).
|
|
85
|
+
@param wraps The name's width at a font size of 1 on 1, 2, … lines (see `wrapWidths`).
|
|
86
|
+
@param shareWidth The share's width at a font size of 1, or null for none.
|
|
87
|
+
@param options How the label is sized.
|
|
88
|
+
*/ export function straightLabelLayout(edges, wraps, shareWidth, options = STRAIGHT_LABEL_DEFAULTS) {
|
|
89
|
+
const { fontMin, fontMax, padding: p, lineHeight: lh } = options;
|
|
90
|
+
if (!wraps.length) return null;
|
|
91
|
+
const sizeAt = (lines, s, share)=>{
|
|
92
|
+
const shareSize = share ? Math.max(fontMin, Math.round(s * options.shareRatio)) : null;
|
|
93
|
+
// A pixel or two of slack, so the text wraps the same when it is drawn.
|
|
94
|
+
const nameHeight = lines * lh * s + 1;
|
|
95
|
+
const width = Math.max(wraps[lines - 1] * s, shareSize ? shareWidth * shareSize : 0) * 1.02 + 2;
|
|
96
|
+
const height = nameHeight + (shareSize ? p + lh * shareSize + 1 : 0);
|
|
97
|
+
const margin = Math.max(p, s * options.margin);
|
|
98
|
+
return {
|
|
99
|
+
width,
|
|
100
|
+
height,
|
|
101
|
+
nameHeight,
|
|
102
|
+
shareSize,
|
|
103
|
+
margin
|
|
104
|
+
};
|
|
105
|
+
};
|
|
106
|
+
const fits = (z)=>sectorBoxRange(edges, z.width + z.margin * 2, z.height + z.margin * 2) !== null;
|
|
107
|
+
/** The largest whole font size that fits, from fontMin to fontMax. */ const largest = (lines, share)=>{
|
|
108
|
+
let lo = Math.ceil(fontMin);
|
|
109
|
+
let hi = Math.floor(fontMax);
|
|
110
|
+
if (hi < lo) hi = lo = fontMin;
|
|
111
|
+
if (!fits(sizeAt(lines, lo, share))) return 0;
|
|
112
|
+
while(lo < hi){
|
|
113
|
+
const s = Math.ceil((lo + hi) / 2);
|
|
114
|
+
if (fits(sizeAt(lines, s, share))) lo = s;
|
|
115
|
+
else hi = s - 1;
|
|
116
|
+
}
|
|
117
|
+
return lo;
|
|
118
|
+
};
|
|
119
|
+
const best = (share)=>{
|
|
120
|
+
let pick = {
|
|
121
|
+
lines: 0,
|
|
122
|
+
size: 0
|
|
123
|
+
};
|
|
124
|
+
wraps.forEach((_, k)=>{
|
|
125
|
+
const size = largest(k + 1, share);
|
|
126
|
+
if (size > pick.size) pick = {
|
|
127
|
+
lines: k + 1,
|
|
128
|
+
size
|
|
129
|
+
};
|
|
130
|
+
});
|
|
131
|
+
return pick;
|
|
132
|
+
};
|
|
133
|
+
const alone = best(false);
|
|
134
|
+
const withShare = shareWidth !== null ? best(true) : {
|
|
135
|
+
lines: 0,
|
|
136
|
+
size: 0
|
|
137
|
+
};
|
|
138
|
+
const keep = Math.min(alone.size * options.shareKeep, options.shareFont);
|
|
139
|
+
const pick = withShare.size > 0 && withShare.size >= keep ? {
|
|
140
|
+
...withShare,
|
|
141
|
+
share: true
|
|
142
|
+
} : {
|
|
143
|
+
...alone,
|
|
144
|
+
share: false
|
|
145
|
+
};
|
|
146
|
+
if (!pick.size) return cutShort(edges, options);
|
|
147
|
+
const z = sizeAt(pick.lines, pick.size, pick.share);
|
|
148
|
+
const outer = centeredSectorBox(edges, z.width + z.margin * 2, z.height + z.margin * 2);
|
|
149
|
+
const center = [
|
|
150
|
+
outer.x + outer.width / 2,
|
|
151
|
+
outer.y + outer.height / 2
|
|
152
|
+
];
|
|
153
|
+
// The boxes the text is drawn in: the block, and its padding.
|
|
154
|
+
const x = center[0] - z.width / 2 - p;
|
|
155
|
+
const top = center[1] - z.height / 2;
|
|
156
|
+
return {
|
|
157
|
+
fontSize: pick.size,
|
|
158
|
+
lines: pick.lines,
|
|
159
|
+
shareSize: z.shareSize,
|
|
160
|
+
name: {
|
|
161
|
+
x,
|
|
162
|
+
y: top - p,
|
|
163
|
+
width: z.width + p * 2,
|
|
164
|
+
height: z.nameHeight + p * 2
|
|
165
|
+
},
|
|
166
|
+
share: z.shareSize ? {
|
|
167
|
+
x,
|
|
168
|
+
y: top + z.nameHeight,
|
|
169
|
+
width: z.width + p * 2,
|
|
170
|
+
height: lh * z.shareSize + p * 2 + 1
|
|
171
|
+
} : null,
|
|
172
|
+
center,
|
|
173
|
+
truncated: false
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
/** One line at `fontMin`, as wide as the slice allows along its bisector, or null when that holds less than a few letters. */ function cutShort(edges, options) {
|
|
177
|
+
const { fontMin, padding: p, lineHeight: lh } = options;
|
|
178
|
+
const height = lh * fontMin + p * 2 + 1;
|
|
179
|
+
const box = largestSectorBox(edges, (w)=>[
|
|
180
|
+
w,
|
|
181
|
+
height
|
|
182
|
+
]);
|
|
183
|
+
if (!box || box.width - p * 2 < fontMin * 2) return null;
|
|
184
|
+
return {
|
|
185
|
+
fontSize: fontMin,
|
|
186
|
+
lines: 1,
|
|
187
|
+
shareSize: null,
|
|
188
|
+
name: box,
|
|
189
|
+
share: null,
|
|
190
|
+
center: [
|
|
191
|
+
box.x + box.width / 2,
|
|
192
|
+
box.y + box.height / 2
|
|
193
|
+
],
|
|
194
|
+
truncated: true
|
|
195
|
+
};
|
|
196
|
+
}
|
|
197
|
+
/**
|
|
198
|
+
Moves a label's text nodes up or down together, so their lines' glyphs
|
|
199
|
+
are centered on `y`.
|
|
200
|
+
@param nodes One label's nodes.
|
|
201
|
+
@param y Where the lines' middle goes.
|
|
202
|
+
*/ export function centerLabelLines(nodes, y) {
|
|
203
|
+
const boxes = textLineBoxes(nodes);
|
|
204
|
+
if (!boxes.length) return;
|
|
205
|
+
const top = Math.min(...boxes.map((b)=>b.y - b.height / 2));
|
|
206
|
+
const bottom = Math.max(...boxes.map((b)=>b.y + b.height / 2));
|
|
207
|
+
const shift = y - (top + bottom) / 2;
|
|
208
|
+
const moved = new Set();
|
|
209
|
+
for (const node of nodes){
|
|
210
|
+
const tr = node.transform;
|
|
211
|
+
if (!tr || moved.has(tr)) continue;
|
|
212
|
+
moved.add(tr);
|
|
213
|
+
tr.y = (tr.y ?? 0) + shift;
|
|
214
|
+
}
|
|
215
|
+
}
|