@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,177 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The text a ring chart (Pie with a hole, Donut, Sunburst, RadialBar) draws
|
|
3
|
+
in its empty middle when `centerLabel` is set: the chart's total, a
|
|
4
|
+
string, or what a function returns, wrapped and shrunk to fit the largest
|
|
5
|
+
box in the hole (see `centerLabelBoxes`). It is chrome: it carries no
|
|
6
|
+
datum, takes no pointer events, and draws nothing when it can't fit whole.
|
|
7
|
+
*/ import { formatAbbreviate } from "@d3plus/format";
|
|
8
|
+
import constant from "../../utils/constant.js";
|
|
9
|
+
import { emitLabels } from "../../shapes/emitLabels.js";
|
|
10
|
+
import { isFullTurn } from "../Pie/arcFit.js";
|
|
11
|
+
import { largestSectorBox, sectorEdges } from "../Pie/sectorBox.js";
|
|
12
|
+
import { centerLabelLines } from "../Pie/straightLayout.js";
|
|
13
|
+
import { backgroundInk } from "../viz/backgroundInk.js";
|
|
14
|
+
/** The scene key of the center label's group. */ export const CENTER_LABEL_KEY = "center-label";
|
|
15
|
+
/** The width/height ratios tried for a partial sweep's hole. */ const SECTOR_ASPECTS = [
|
|
16
|
+
1,
|
|
17
|
+
2,
|
|
18
|
+
3
|
|
19
|
+
];
|
|
20
|
+
/**
|
|
21
|
+
The `centerLabelConfig` defaults: the chart's text color, sized between
|
|
22
|
+
10 and 40 pixels, 5 pixels clear of the ring.
|
|
23
|
+
@param viz The chart.
|
|
24
|
+
*/ export function centerLabelDefaults(viz) {
|
|
25
|
+
return {
|
|
26
|
+
fontColor: ()=>backgroundInk(viz),
|
|
27
|
+
fontMax: 40,
|
|
28
|
+
fontMin: 10,
|
|
29
|
+
padding: 5
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
The sum of `value` over `data`, leaving out values that aren't numbers.
|
|
34
|
+
@param data The drawn rows.
|
|
35
|
+
@param value The chart's value accessor.
|
|
36
|
+
*/ export function centerLabelTotal(data, value) {
|
|
37
|
+
return data.reduce((sum, d, i)=>{
|
|
38
|
+
const v = Number(value(d, i));
|
|
39
|
+
return Number.isFinite(v) ? sum + v : sum;
|
|
40
|
+
}, 0);
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
The text a `centerLabel` setting draws: the total, formatted the way the
|
|
44
|
+
chart's tooltips format values, for `true`; the string itself; or a
|
|
45
|
+
function's return value. Empty for a falsy setting or return value.
|
|
46
|
+
@param setting The `centerLabel` setting.
|
|
47
|
+
@param data The drawn rows.
|
|
48
|
+
@param total Their total.
|
|
49
|
+
@param locale The chart's locale.
|
|
50
|
+
*/ export function centerLabelText(setting, data, total, locale) {
|
|
51
|
+
if (!setting) return "";
|
|
52
|
+
if (typeof setting === "function") {
|
|
53
|
+
const out = setting(data, total);
|
|
54
|
+
return out || out === 0 ? String(out) : "";
|
|
55
|
+
}
|
|
56
|
+
if (typeof setting === "string") return setting;
|
|
57
|
+
return formatAbbreviate(total, locale);
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
The boxes the text may fill in a hole: the whole circle (its text wrapped
|
|
61
|
+
to the circle) for a full turn, or, for a partial sweep, the largest box
|
|
62
|
+
of each of a few shapes that fits in the slice of the circle it spans.
|
|
63
|
+
Empty when the hole has no room.
|
|
64
|
+
@param hole The hole.
|
|
65
|
+
*/ export function centerLabelBoxes(hole) {
|
|
66
|
+
const r = hole.radius;
|
|
67
|
+
if (!(r > 0)) return [];
|
|
68
|
+
const { startAngle, endAngle } = hole;
|
|
69
|
+
if (startAngle === undefined || endAngle === undefined || isFullTurn(startAngle, endAngle)) return [
|
|
70
|
+
{
|
|
71
|
+
x: -r,
|
|
72
|
+
y: -r,
|
|
73
|
+
width: r * 2,
|
|
74
|
+
height: r * 2,
|
|
75
|
+
shape: "circle"
|
|
76
|
+
}
|
|
77
|
+
];
|
|
78
|
+
const edges = sectorEdges({
|
|
79
|
+
innerRadius: 0,
|
|
80
|
+
outerRadius: r,
|
|
81
|
+
startAngle,
|
|
82
|
+
endAngle
|
|
83
|
+
});
|
|
84
|
+
if (!edges) return [];
|
|
85
|
+
return SECTOR_ASPECTS.flatMap((aspect)=>{
|
|
86
|
+
const box = largestSectorBox(edges, (s)=>[
|
|
87
|
+
s * aspect,
|
|
88
|
+
s
|
|
89
|
+
]);
|
|
90
|
+
return box ? [
|
|
91
|
+
{
|
|
92
|
+
...box,
|
|
93
|
+
shape: "square"
|
|
94
|
+
}
|
|
95
|
+
] : [];
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
The TextBox config the label is drawn with: the user's `centerLabelConfig`
|
|
100
|
+
over the centered defaults. A `fontSize` without `fontResize` fixes the
|
|
101
|
+
size; otherwise the text shrinks from `fontMax` to fit.
|
|
102
|
+
@param config The `centerLabelConfig`.
|
|
103
|
+
*/ export function centerLabelStyle(config) {
|
|
104
|
+
const fontResize = config.fontResize ?? config.fontSize === undefined;
|
|
105
|
+
return {
|
|
106
|
+
textAnchor: "middle",
|
|
107
|
+
verticalAlign: "middle",
|
|
108
|
+
...config,
|
|
109
|
+
fontResize,
|
|
110
|
+
pointerEvents: "none"
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
/** The label's text nodes in one box, or null when the text doesn't fit whole. */ function fitIn(text, box, style) {
|
|
114
|
+
const nodes = emitLabels({
|
|
115
|
+
data: [
|
|
116
|
+
{
|
|
117
|
+
text
|
|
118
|
+
}
|
|
119
|
+
],
|
|
120
|
+
label: ()=>text,
|
|
121
|
+
x: ()=>0,
|
|
122
|
+
y: ()=>0,
|
|
123
|
+
aes: ()=>({}),
|
|
124
|
+
rotate: constant(0),
|
|
125
|
+
id: ()=>CENTER_LABEL_KEY,
|
|
126
|
+
labelBounds: ()=>({
|
|
127
|
+
...box
|
|
128
|
+
}),
|
|
129
|
+
labelConfig: style
|
|
130
|
+
}).filter((n)=>n.type === "text");
|
|
131
|
+
if (!nodes.length || nodes.some((n)=>n.truncated)) return null;
|
|
132
|
+
return nodes;
|
|
133
|
+
}
|
|
134
|
+
/** The largest font size among text nodes. */ const fontSizeOf = (nodes)=>Math.max(...nodes.map((n)=>n.font?.size ?? 0));
|
|
135
|
+
/**
|
|
136
|
+
The center label's scene nodes: one inert group holding the text, at the
|
|
137
|
+
largest size that fits the hole whole, centered in it. Empty when
|
|
138
|
+
`centerLabel` is unset or the text fits nowhere.
|
|
139
|
+
@param viz The chart.
|
|
140
|
+
@param hole The chart's empty middle, around its origin.
|
|
141
|
+
@param value The chart's value accessor, summed for the total.
|
|
142
|
+
*/ export function centerLabelNodes(viz, hole, value) {
|
|
143
|
+
const setting = viz.schema.centerLabel;
|
|
144
|
+
if (!setting) return [];
|
|
145
|
+
const boxes = centerLabelBoxes(hole);
|
|
146
|
+
if (!boxes.length) return [];
|
|
147
|
+
const data = viz._filteredData ?? [];
|
|
148
|
+
const text = centerLabelText(setting, data, centerLabelTotal(data, value), viz.schema.locale);
|
|
149
|
+
if (!text) return [];
|
|
150
|
+
const config = viz.schema.centerLabelConfig ?? {};
|
|
151
|
+
const style = centerLabelStyle(config);
|
|
152
|
+
let best = null;
|
|
153
|
+
for (const box of boxes){
|
|
154
|
+
const nodes = fitIn(text, box, style);
|
|
155
|
+
if (nodes && (!best || fontSizeOf(nodes) > fontSizeOf(best.nodes))) best = {
|
|
156
|
+
nodes,
|
|
157
|
+
box
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
if (!best) return [];
|
|
161
|
+
// The text is chrome: no datum for hover to match or a tooltip to show.
|
|
162
|
+
const children = best.nodes.map((n)=>({
|
|
163
|
+
...n,
|
|
164
|
+
datum: undefined,
|
|
165
|
+
index: undefined,
|
|
166
|
+
interactive: false
|
|
167
|
+
}));
|
|
168
|
+
if (style.verticalAlign === "middle") centerLabelLines(children, best.box.y + best.box.height / 2);
|
|
169
|
+
return [
|
|
170
|
+
{
|
|
171
|
+
type: "group",
|
|
172
|
+
key: CENTER_LABEL_KEY,
|
|
173
|
+
interactive: false,
|
|
174
|
+
children
|
|
175
|
+
}
|
|
176
|
+
];
|
|
177
|
+
}
|
|
@@ -55,7 +55,7 @@
|
|
|
55
55
|
|
|
56
56
|
Width and height are the margin-adjusted chart-area dimensions —
|
|
57
57
|
callers usually have them on hand from `chartBounds(viz)` or from
|
|
58
|
-
fields a stage stashed (e.g. `
|
|
58
|
+
fields a stage stashed (e.g. `_radialMatrixWidth`).
|
|
59
59
|
*/ export function centerChartTransform(viz, width, height) {
|
|
60
60
|
return {
|
|
61
61
|
x: viz._margin.left + width / 2,
|
|
@@ -0,0 +1,297 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Placement of circle labels: each label sits inside its circle when it fits
|
|
3
|
+
there at a readable size, otherwise beside the circle on the side with the
|
|
4
|
+
most open room (Moritz Stefaner's Voronoi labeling), otherwise nowhere.
|
|
5
|
+
Pure geometry: text is measured by the caller.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ import { pointVoronoi } from "../viz/pointVoronoi.js";
|
|
9
|
+
/** The sides in their default order, with each one's direction (y down). */ const SIDES = [
|
|
10
|
+
[
|
|
11
|
+
"right",
|
|
12
|
+
1,
|
|
13
|
+
0
|
|
14
|
+
],
|
|
15
|
+
[
|
|
16
|
+
"left",
|
|
17
|
+
-1,
|
|
18
|
+
0
|
|
19
|
+
],
|
|
20
|
+
[
|
|
21
|
+
"top",
|
|
22
|
+
0,
|
|
23
|
+
-1
|
|
24
|
+
],
|
|
25
|
+
[
|
|
26
|
+
"bottom",
|
|
27
|
+
0,
|
|
28
|
+
1
|
|
29
|
+
],
|
|
30
|
+
[
|
|
31
|
+
"top-right",
|
|
32
|
+
Math.SQRT1_2,
|
|
33
|
+
-Math.SQRT1_2
|
|
34
|
+
],
|
|
35
|
+
[
|
|
36
|
+
"top-left",
|
|
37
|
+
-Math.SQRT1_2,
|
|
38
|
+
-Math.SQRT1_2
|
|
39
|
+
],
|
|
40
|
+
[
|
|
41
|
+
"bottom-right",
|
|
42
|
+
Math.SQRT1_2,
|
|
43
|
+
Math.SQRT1_2
|
|
44
|
+
],
|
|
45
|
+
[
|
|
46
|
+
"bottom-left",
|
|
47
|
+
-Math.SQRT1_2,
|
|
48
|
+
Math.SQRT1_2
|
|
49
|
+
]
|
|
50
|
+
];
|
|
51
|
+
/** Degrees added to a diagonal side's angle when ranking sides: straight sides read better. */ const DIAGONAL_PENALTY = 20;
|
|
52
|
+
/** Rounding slack for overlap and containment tests. */ const EPSILON = 1e-6;
|
|
53
|
+
/**
|
|
54
|
+
The box a `width` × `height` label takes on one side of a circle, `gap`
|
|
55
|
+
pixels clear of its edge: centered on the circle's axis for a straight
|
|
56
|
+
side, with its nearest corner on the circle's diagonal for a diagonal one.
|
|
57
|
+
*/ export function sideBox(circle, side, width, height, gap = 0) {
|
|
58
|
+
const d = circle.r + gap;
|
|
59
|
+
const { x, y } = circle;
|
|
60
|
+
switch(side){
|
|
61
|
+
case "right":
|
|
62
|
+
return {
|
|
63
|
+
x: x + d,
|
|
64
|
+
y: y - height / 2,
|
|
65
|
+
width,
|
|
66
|
+
height
|
|
67
|
+
};
|
|
68
|
+
case "left":
|
|
69
|
+
return {
|
|
70
|
+
x: x - d - width,
|
|
71
|
+
y: y - height / 2,
|
|
72
|
+
width,
|
|
73
|
+
height
|
|
74
|
+
};
|
|
75
|
+
case "top":
|
|
76
|
+
return {
|
|
77
|
+
x: x - width / 2,
|
|
78
|
+
y: y - d - height,
|
|
79
|
+
width,
|
|
80
|
+
height
|
|
81
|
+
};
|
|
82
|
+
case "bottom":
|
|
83
|
+
return {
|
|
84
|
+
x: x - width / 2,
|
|
85
|
+
y: y + d,
|
|
86
|
+
width,
|
|
87
|
+
height
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
const o = d * Math.SQRT1_2;
|
|
91
|
+
const right = side.endsWith("right");
|
|
92
|
+
const top = side.startsWith("top");
|
|
93
|
+
return {
|
|
94
|
+
x: right ? x + o : x - o - width,
|
|
95
|
+
y: top ? y - o - height : y + o,
|
|
96
|
+
width,
|
|
97
|
+
height
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
/** The signed area of a ring (positive when its vertices run clockwise in y-down space). */ function ringArea(ring) {
|
|
101
|
+
let a = 0;
|
|
102
|
+
for(let i = 0, j = ring.length - 1; i < ring.length; j = i++)a += ring[j][0] * ring[i][1] - ring[i][0] * ring[j][1];
|
|
103
|
+
return a / 2;
|
|
104
|
+
}
|
|
105
|
+
/** A ring's centroid, or null when it has no area. */ export function ringCentroid(ring) {
|
|
106
|
+
const area = ringArea(ring);
|
|
107
|
+
if (Math.abs(area) < EPSILON) return null;
|
|
108
|
+
let cx = 0, cy = 0;
|
|
109
|
+
for(let i = 0, j = ring.length - 1; i < ring.length; j = i++){
|
|
110
|
+
const f = ring[j][0] * ring[i][1] - ring[i][0] * ring[j][1];
|
|
111
|
+
cx += (ring[j][0] + ring[i][0]) * f;
|
|
112
|
+
cy += (ring[j][1] + ring[i][1]) * f;
|
|
113
|
+
}
|
|
114
|
+
return [
|
|
115
|
+
cx / (6 * area),
|
|
116
|
+
cy / (6 * area)
|
|
117
|
+
];
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
The sides of a circle, most open first: ordered by how closely each
|
|
121
|
+
points toward the centroid of the circle's Voronoi cell (diagonals
|
|
122
|
+
slightly discounted), or in the default order (right, left, top, bottom,
|
|
123
|
+
then the diagonals) when the centroid is too close to the center to point
|
|
124
|
+
anywhere, which is the case for an evenly surrounded circle.
|
|
125
|
+
@param circle The circle.
|
|
126
|
+
@param cell Its Voronoi cell, or null.
|
|
127
|
+
*/ export function sideOrder(circle, cell) {
|
|
128
|
+
const base = SIDES.map((s)=>s[0]);
|
|
129
|
+
const centroid = cell ? ringCentroid(cell) : null;
|
|
130
|
+
if (!centroid || !cell) return base;
|
|
131
|
+
const dx = centroid[0] - circle.x, dy = centroid[1] - circle.y;
|
|
132
|
+
const reach = Math.sqrt(Math.abs(ringArea(cell)));
|
|
133
|
+
if (Math.hypot(dx, dy) < reach * 0.1) return base;
|
|
134
|
+
const toward = Math.atan2(dy, dx);
|
|
135
|
+
const score = ([, sx, sy])=>{
|
|
136
|
+
let diff = Math.abs(Math.atan2(sy, sx) - toward);
|
|
137
|
+
if (diff > Math.PI) diff = 2 * Math.PI - diff;
|
|
138
|
+
const degrees = diff * 180 / Math.PI;
|
|
139
|
+
return degrees + (sx && sy ? DIAGONAL_PENALTY : 0);
|
|
140
|
+
};
|
|
141
|
+
return SIDES.map((s, i)=>({
|
|
142
|
+
side: s[0],
|
|
143
|
+
score: score(s),
|
|
144
|
+
i
|
|
145
|
+
})).sort((a, b)=>a.score - b.score || a.i - b.i).map((s)=>s.side);
|
|
146
|
+
}
|
|
147
|
+
/** Clips a ring to one half-plane of a box edge (Sutherland–Hodgman). */ function clipEdge(ring, inside, cross) {
|
|
148
|
+
const out = [];
|
|
149
|
+
for(let i = 0; i < ring.length; i++){
|
|
150
|
+
const cur = ring[i], prev = ring[(i + ring.length - 1) % ring.length];
|
|
151
|
+
if (inside(cur)) {
|
|
152
|
+
if (!inside(prev)) out.push(cross(prev, cur));
|
|
153
|
+
out.push(cur);
|
|
154
|
+
} else if (inside(prev)) out.push(cross(prev, cur));
|
|
155
|
+
}
|
|
156
|
+
return out;
|
|
157
|
+
}
|
|
158
|
+
/** Where the segment `a`–`b` crosses the vertical line at `x`. */ const atX = (a, b, x)=>[
|
|
159
|
+
x,
|
|
160
|
+
a[1] + (b[1] - a[1]) * (x - a[0]) / (b[0] - a[0])
|
|
161
|
+
];
|
|
162
|
+
/** Where the segment `a`–`b` crosses the horizontal line at `y`. */ const atY = (a, b, y)=>[
|
|
163
|
+
a[0] + (b[0] - a[0]) * (y - a[1]) / (b[1] - a[1]),
|
|
164
|
+
y
|
|
165
|
+
];
|
|
166
|
+
/** The share (0–1) of a box's area that lies inside a ring. */ export function boxCoverage(box, ring) {
|
|
167
|
+
const area = box.width * box.height;
|
|
168
|
+
if (!(area > 0) || ring.length < 3) return 0;
|
|
169
|
+
const x1 = box.x + box.width, y1 = box.y + box.height;
|
|
170
|
+
let r = clipEdge(ring, (p)=>p[0] >= box.x, (a, b)=>atX(a, b, box.x));
|
|
171
|
+
r = clipEdge(r, (p)=>p[0] <= x1, (a, b)=>atX(a, b, x1));
|
|
172
|
+
r = clipEdge(r, (p)=>p[1] >= box.y, (a, b)=>atY(a, b, box.y));
|
|
173
|
+
r = clipEdge(r, (p)=>p[1] <= y1, (a, b)=>atY(a, b, y1));
|
|
174
|
+
return r.length < 3 ? 0 : Math.min(1, Math.abs(ringArea(r)) / area);
|
|
175
|
+
}
|
|
176
|
+
/** Whether a box overlaps a circle's interior. */ export function boxHitsCircle(box, circle) {
|
|
177
|
+
const dx = Math.max(box.x - circle.x, 0, circle.x - (box.x + box.width));
|
|
178
|
+
const dy = Math.max(box.y - circle.y, 0, circle.y - (box.y + box.height));
|
|
179
|
+
return dx * dx + dy * dy < circle.r * circle.r - EPSILON;
|
|
180
|
+
}
|
|
181
|
+
/** Whether two boxes overlap (touching edges don't count). */ export function boxesOverlap(a, b) {
|
|
182
|
+
return a.x < b.x + b.width - EPSILON && b.x < a.x + a.width - EPSILON && a.y < b.y + b.height - EPSILON && b.y < a.y + a.height - EPSILON;
|
|
183
|
+
}
|
|
184
|
+
/** Whether a box lies inside the bounds. */ function inBounds(box, bounds) {
|
|
185
|
+
return box.x >= bounds.x - EPSILON && box.y >= bounds.y - EPSILON && box.x + box.width <= bounds.x + bounds.width + EPSILON && box.y + box.height <= bounds.y + bounds.height + EPSILON;
|
|
186
|
+
}
|
|
187
|
+
/** A uniform grid of buckets, so overlap tests only look at nearby items. */ class BoxGrid {
|
|
188
|
+
size;
|
|
189
|
+
cells = new Map();
|
|
190
|
+
constructor(size){
|
|
191
|
+
this.size = size;
|
|
192
|
+
}
|
|
193
|
+
keys(box) {
|
|
194
|
+
const s = this.size;
|
|
195
|
+
const out = [];
|
|
196
|
+
for(let i = Math.floor(box.x / s); i <= Math.floor((box.x + box.width) / s); i++)for(let j = Math.floor(box.y / s); j <= Math.floor((box.y + box.height) / s); j++)out.push(`${i},${j}`);
|
|
197
|
+
return out;
|
|
198
|
+
}
|
|
199
|
+
add(box, item) {
|
|
200
|
+
for (const k of this.keys(box)){
|
|
201
|
+
const list = this.cells.get(k);
|
|
202
|
+
if (list) list.push(item);
|
|
203
|
+
else this.cells.set(k, [
|
|
204
|
+
item
|
|
205
|
+
]);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
near(box) {
|
|
209
|
+
const out = new Set();
|
|
210
|
+
for (const k of this.keys(box))for (const item of this.cells.get(k) ?? [])out.add(item);
|
|
211
|
+
return out;
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
/** A circle's bounding box. */ const circleBox = (c)=>({
|
|
215
|
+
x: c.x - c.r,
|
|
216
|
+
y: c.y - c.r,
|
|
217
|
+
width: c.r * 2,
|
|
218
|
+
height: c.r * 2
|
|
219
|
+
});
|
|
220
|
+
/**
|
|
221
|
+
Places circle labels. A label in `"inside"` mode stays inside its circle;
|
|
222
|
+
in `"auto"` mode it stays inside when `fitsInside`, and otherwise (or in
|
|
223
|
+
`"outside"` mode) it takes the first side of its circle, most open first
|
|
224
|
+
(see `sideOrder`), where it lies mostly in the circle's Voronoi cell, stays
|
|
225
|
+
in `bounds`, and overlaps no circle and no label placed before it. A label
|
|
226
|
+
with no such side, or whose circle is centered outside `bounds`, is
|
|
227
|
+
hidden. Labels are placed largest circle first
|
|
228
|
+
(ties in input order), so big circles win the room; the result is in
|
|
229
|
+
input order and depends only on the input.
|
|
230
|
+
@param circles Every circle, labeled or not: each is an obstacle.
|
|
231
|
+
@param labels The labels to place.
|
|
232
|
+
@param bounds The box labels must stay in.
|
|
233
|
+
*/ export function placeCircleLabels(circles, labels, bounds, options = {}) {
|
|
234
|
+
const gap = options.gap ?? 3;
|
|
235
|
+
const coverage = options.cellCoverage ?? 0.5;
|
|
236
|
+
const result = labels.map(()=>({
|
|
237
|
+
position: "hidden"
|
|
238
|
+
}));
|
|
239
|
+
const valid = (c)=>!!c && [
|
|
240
|
+
c.x,
|
|
241
|
+
c.y,
|
|
242
|
+
c.r
|
|
243
|
+
].every(Number.isFinite);
|
|
244
|
+
const outside = [];
|
|
245
|
+
labels.forEach((label, i)=>{
|
|
246
|
+
if (!valid(circles[label.circle])) return;
|
|
247
|
+
if (label.position === "inside" || label.position !== "outside" && label.fitsInside) result[i] = {
|
|
248
|
+
position: "inside"
|
|
249
|
+
};
|
|
250
|
+
else if (label.width > 0 && label.height > 0) outside.push(i);
|
|
251
|
+
});
|
|
252
|
+
if (!outside.length) return result;
|
|
253
|
+
const voronoi = pointVoronoi(circles.map((c, i)=>({
|
|
254
|
+
x: c.x,
|
|
255
|
+
y: c.y,
|
|
256
|
+
r: c.r,
|
|
257
|
+
item: i
|
|
258
|
+
})), bounds);
|
|
259
|
+
const sizes = outside.map((i)=>Math.max(labels[i].width, labels[i].height));
|
|
260
|
+
const grid = new BoxGrid(Math.max(16, sizes.reduce((a, b)=>a + b, 0) / sizes.length));
|
|
261
|
+
circles.forEach((c, i)=>{
|
|
262
|
+
if (valid(c)) grid.add(circleBox(c), i);
|
|
263
|
+
});
|
|
264
|
+
const placed = new BoxGrid(grid.size);
|
|
265
|
+
outside.sort((a, b)=>circles[labels[b].circle].r - circles[labels[a].circle].r || a - b);
|
|
266
|
+
for (const i of outside){
|
|
267
|
+
const label = labels[i];
|
|
268
|
+
const circle = circles[label.circle];
|
|
269
|
+
const cell = voronoi.cell(label.circle);
|
|
270
|
+
// A circle centered outside the bounds (scrolled off by a zoom) is cut
|
|
271
|
+
// off there, so a label beside it would name nothing in view.
|
|
272
|
+
if (!cell || !inBounds({
|
|
273
|
+
...circle,
|
|
274
|
+
width: 0,
|
|
275
|
+
height: 0
|
|
276
|
+
}, bounds)) continue;
|
|
277
|
+
for (const side of sideOrder(circle, cell)){
|
|
278
|
+
const box = sideBox(circle, side, label.width, label.height, gap);
|
|
279
|
+
if (!inBounds(box, bounds)) continue;
|
|
280
|
+
if ([
|
|
281
|
+
...grid.near(box)
|
|
282
|
+
].some((c)=>boxHitsCircle(box, circles[c]))) continue;
|
|
283
|
+
if ([
|
|
284
|
+
...placed.near(box)
|
|
285
|
+
].some((b)=>boxesOverlap(box, b))) continue;
|
|
286
|
+
if (boxCoverage(box, cell) < coverage - EPSILON) continue;
|
|
287
|
+
result[i] = {
|
|
288
|
+
position: "outside",
|
|
289
|
+
side,
|
|
290
|
+
box
|
|
291
|
+
};
|
|
292
|
+
placed.add(box, box);
|
|
293
|
+
break;
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
return result;
|
|
297
|
+
}
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Circle labels on a chart: resolves each label's `labelPosition`, measures
|
|
3
|
+
its text, places it (see `circleLabelPlacement.ts`), and emits the labels
|
|
4
|
+
that sit beside their circles. Shared by Plot's point marks, Network's
|
|
5
|
+
nodes, and Geomap's coordinate points.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ import { fontExists, parseSides, rtl, textWidth } from "@d3plus/dom";
|
|
9
|
+
import { fontFamily as defaultFontFamily, textWrap } from "@d3plus/text";
|
|
10
|
+
import { emitLabels } from "../../shapes/emitLabels.js";
|
|
11
|
+
import constant from "../../utils/constant.js";
|
|
12
|
+
import { backgroundInk } from "../viz/backgroundInk.js";
|
|
13
|
+
import { placeCircleLabels } from "./circleLabelPlacement.js";
|
|
14
|
+
/** The resolved CSS font family, as TextBox renders it. */ const familyOf = (family)=>fontExists(family ?? defaultFontFamily);
|
|
15
|
+
/**
|
|
16
|
+
Whether `text` fits inside a box at `font.size`, wrapped the way a label
|
|
17
|
+
TextBox wraps it, without being cut short.
|
|
18
|
+
@param text The label text.
|
|
19
|
+
@param box The box, with its wrapping shape and padding.
|
|
20
|
+
@param font The font, at the smallest size that counts as fitting.
|
|
21
|
+
*/ export function labelFitsInside(text, box, font) {
|
|
22
|
+
const pad = parseSides(box.padding ?? 0);
|
|
23
|
+
const width = box.width - pad.left - pad.right;
|
|
24
|
+
const height = box.height - pad.top - pad.bottom;
|
|
25
|
+
const lineHeight = font.lineHeight ?? font.size * 1.2;
|
|
26
|
+
if (!text || width <= font.size || height < lineHeight) return false;
|
|
27
|
+
const wrapped = textWrap().fontFamily(familyOf(font.family)).fontSize(font.size).fontWeight(font.weight ?? 400).lineHeight(lineHeight).shape(box.shape ?? "square").width(width).height(height)(text);
|
|
28
|
+
return !wrapped.truncated && wrapped.lines.some((l)=>l !== "");
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
The box a one-line label takes: its measured width, plus a pixel of slack
|
|
32
|
+
on each side so the TextBox drawing it never wraps it, by a line's height
|
|
33
|
+
plus a pixel.
|
|
34
|
+
*/ export function measureLabel(text, font) {
|
|
35
|
+
const width = textWidth(text, {
|
|
36
|
+
"font-family": familyOf(font.family),
|
|
37
|
+
"font-size": font.size,
|
|
38
|
+
"font-weight": font.weight ?? 400
|
|
39
|
+
});
|
|
40
|
+
const lineHeight = font.lineHeight ?? font.size * 1.2;
|
|
41
|
+
return {
|
|
42
|
+
width: Math.ceil(width) + 2,
|
|
43
|
+
height: Math.ceil(lineHeight) + 1
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
/** Reads `pointLabelConfig`: numbers for fontMin/fontSize/padding, the rest as TextBox config. */ export function pointLabelSettings(viz) {
|
|
47
|
+
const cfg = viz.schema.pointLabelConfig ?? {};
|
|
48
|
+
const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
|
|
49
|
+
const { fontMin, fontSize, padding, ...text } = cfg;
|
|
50
|
+
return {
|
|
51
|
+
fontMin: num(fontMin, 10),
|
|
52
|
+
fontSize: num(fontSize, 11),
|
|
53
|
+
padding: num(padding, 3),
|
|
54
|
+
text
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
/** A row's `labelPosition`, with anything unrecognized read as `"auto"`. */ export function labelPositionOf(viz, d, i) {
|
|
58
|
+
const fn = viz.schema.labelPosition;
|
|
59
|
+
const value = typeof fn === "function" ? fn(d, i) : fn;
|
|
60
|
+
return value === "inside" || value === "outside" ? value : "auto";
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
Places every labeled circle's label (see `placeCircleLabels`), reading
|
|
64
|
+
each row's `labelPosition` and the chart's `pointLabelConfig`. An
|
|
65
|
+
`"auto"` label counts as fitting inside when it fits at
|
|
66
|
+
`pointLabelConfig.fontMin`.
|
|
67
|
+
@param viz The chart.
|
|
68
|
+
@param items Every circle, labeled or not.
|
|
69
|
+
@param bounds The box labels must stay in, in the circles' space.
|
|
70
|
+
*/ export function layoutCircleLabels(viz, items, bounds) {
|
|
71
|
+
const settings = pointLabelSettings(viz);
|
|
72
|
+
const font = outsideFont(settings);
|
|
73
|
+
const labeled = [];
|
|
74
|
+
items.forEach((item, at)=>{
|
|
75
|
+
const t = item.text;
|
|
76
|
+
if (typeof t === "string" && t.trim() || typeof t === "number") labeled.push({
|
|
77
|
+
item,
|
|
78
|
+
at,
|
|
79
|
+
text: `${t}`.trim()
|
|
80
|
+
});
|
|
81
|
+
});
|
|
82
|
+
const requests = labeled.map(({ item, at, text })=>{
|
|
83
|
+
const mode = labelPositionOf(viz, item.datum, item.index);
|
|
84
|
+
const inside = item.inside ?? {
|
|
85
|
+
width: item.r * 2,
|
|
86
|
+
height: item.r * 2
|
|
87
|
+
};
|
|
88
|
+
const fitsInside = mode === "auto" && labelFitsInside(text, inside, {
|
|
89
|
+
...inside.font,
|
|
90
|
+
size: settings.fontMin
|
|
91
|
+
});
|
|
92
|
+
// Only a label that may go beside its circle needs measuring.
|
|
93
|
+
const size = mode === "inside" || fitsInside ? {
|
|
94
|
+
width: 0,
|
|
95
|
+
height: 0
|
|
96
|
+
} : measureLabel(text, resolveFont(font, item));
|
|
97
|
+
return {
|
|
98
|
+
circle: at,
|
|
99
|
+
...size,
|
|
100
|
+
position: mode,
|
|
101
|
+
fitsInside
|
|
102
|
+
};
|
|
103
|
+
});
|
|
104
|
+
const placements = placeCircleLabels(items.map(({ x, y, r })=>({
|
|
105
|
+
x,
|
|
106
|
+
y,
|
|
107
|
+
r: Number.isFinite(r) ? r : 0
|
|
108
|
+
})), requests, bounds, {
|
|
109
|
+
gap: settings.padding
|
|
110
|
+
});
|
|
111
|
+
const out = new Map();
|
|
112
|
+
labeled.forEach(({ item, text }, j)=>out.set(item.key, {
|
|
113
|
+
...placements[j],
|
|
114
|
+
mode: requests[j].position,
|
|
115
|
+
text
|
|
116
|
+
}));
|
|
117
|
+
return out;
|
|
118
|
+
}
|
|
119
|
+
/** The font a label beside its circle is drawn in, as accessors of the row. */ function outsideFont(settings) {
|
|
120
|
+
const { fontFamily, fontWeight } = settings.text;
|
|
121
|
+
return {
|
|
122
|
+
size: settings.fontSize,
|
|
123
|
+
family: fontFamily,
|
|
124
|
+
weight: fontWeight
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
/** Resolves the outside font's accessors for one row. */ function resolveFont(font, item) {
|
|
128
|
+
const at = (v)=>typeof v === "function" ? v(item.datum, item.index) : v;
|
|
129
|
+
return {
|
|
130
|
+
size: font.size,
|
|
131
|
+
family: at(font.family),
|
|
132
|
+
weight: at(font.weight)
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
/** The text anchor that keeps a label flush against its circle. */ export function sideAnchor(side) {
|
|
136
|
+
const anchor = side.endsWith("right") ? "start" : side.endsWith("left") ? "end" : "middle";
|
|
137
|
+
// Right to left, TextBox reads "start" as the box's right edge.
|
|
138
|
+
if (anchor !== "middle" && rtl()) return anchor === "start" ? "end" : "start";
|
|
139
|
+
return anchor;
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
Text nodes for labels placed beside their circles: one line each, in the
|
|
143
|
+
chart's ink (`backgroundInk`) at `pointLabelConfig.fontSize`, flush
|
|
144
|
+
against the circle, and inert to the pointer.
|
|
145
|
+
@param viz The chart.
|
|
146
|
+
@param labels The labels, each with its placed box.
|
|
147
|
+
@param config TextBox config layered under `pointLabelConfig` (such as a
|
|
148
|
+
`fontOpacity` that follows the shapes).
|
|
149
|
+
*/ export function emitOutsideLabels(viz, labels, config = {}) {
|
|
150
|
+
if (!labels.length) return [];
|
|
151
|
+
const settings = pointLabelSettings(viz);
|
|
152
|
+
const byId = new Map(labels.map((l)=>[
|
|
153
|
+
`${l.id}_0`,
|
|
154
|
+
l
|
|
155
|
+
]));
|
|
156
|
+
const sideOf = (rec)=>byId.get(String(rec.id))?.side ?? "right";
|
|
157
|
+
const lineHeight = settings.fontSize * 1.2;
|
|
158
|
+
return emitLabels({
|
|
159
|
+
data: labels,
|
|
160
|
+
label: (d)=>d.text,
|
|
161
|
+
labelBounds: (d)=>({
|
|
162
|
+
...d.box
|
|
163
|
+
}),
|
|
164
|
+
x: constant(0),
|
|
165
|
+
y: constant(0),
|
|
166
|
+
aes: constant({}),
|
|
167
|
+
rotate: constant(0),
|
|
168
|
+
id: (d)=>d.id,
|
|
169
|
+
datum: (d)=>d.datum,
|
|
170
|
+
labelConfig: {
|
|
171
|
+
fontColor: ()=>backgroundInk(viz),
|
|
172
|
+
...config,
|
|
173
|
+
fontResize: false,
|
|
174
|
+
fontSize: settings.fontSize,
|
|
175
|
+
lineHeight,
|
|
176
|
+
padding: 0,
|
|
177
|
+
pointerEvents: "none",
|
|
178
|
+
textAnchor: (rec)=>sideAnchor(sideOf(rec)),
|
|
179
|
+
verticalAlign: "middle",
|
|
180
|
+
...settings.text
|
|
181
|
+
}
|
|
182
|
+
});
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
Splits laid-out labels into the ones drawn beside their circles, with the
|
|
186
|
+
id and scene datum each takes.
|
|
187
|
+
*/ export function outsideLabels(layout, describe) {
|
|
188
|
+
const out = [];
|
|
189
|
+
for (const [key, placed] of layout){
|
|
190
|
+
if (placed.position !== "outside") continue;
|
|
191
|
+
out.push({
|
|
192
|
+
...describe(key),
|
|
193
|
+
text: placed.text,
|
|
194
|
+
side: placed.side,
|
|
195
|
+
box: placed.box
|
|
196
|
+
});
|
|
197
|
+
}
|
|
198
|
+
return out;
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
The font size floor of an inside label: `pointLabelConfig.fontMin` when it
|
|
202
|
+
was placed in `"auto"` mode (so it never shrinks below the size it was
|
|
203
|
+
judged to fit at), else its own.
|
|
204
|
+
*/ export function insideFontMin(viz, placed, own) {
|
|
205
|
+
if (!placed || placed.mode !== "auto" || placed.position !== "inside") return own;
|
|
206
|
+
return Math.max(own, pointLabelSettings(viz).fontMin);
|
|
207
|
+
}
|