@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,119 @@
|
|
|
1
|
+
/** A point, `[x, y]`. */
|
|
2
|
+
export type Point = [number, number];
|
|
3
|
+
/** The label font size when the Path labelConfig sets none. */
|
|
4
|
+
export declare const OUTSIDE_LABEL_FONT_SIZE = 12;
|
|
5
|
+
/** How the leaders and labels sit beside the ring, in pixels. */
|
|
6
|
+
export interface OutsideMetrics {
|
|
7
|
+
/** The label's font size. */
|
|
8
|
+
fontSize: number;
|
|
9
|
+
/** The height each label takes in its column. */
|
|
10
|
+
lineHeight: number;
|
|
11
|
+
/** How far the leader runs straight out from the ring before it bends. */
|
|
12
|
+
elbow: number;
|
|
13
|
+
/** The shortest horizontal run of a leader before its label. */
|
|
14
|
+
tail: number;
|
|
15
|
+
/** The gap between the end of a leader and its label's text. */
|
|
16
|
+
gap: number;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
The metrics for labels at `fontSize`: a column line of 1.3em, and a
|
|
20
|
+
leader that runs out 10px, bends, and runs at least 8px across to a
|
|
21
|
+
label 4px past its end.
|
|
22
|
+
@param fontSize The label's font size.
|
|
23
|
+
*/
|
|
24
|
+
export declare function outsideMetrics(fontSize: number): OutsideMetrics;
|
|
25
|
+
/**
|
|
26
|
+
The side of the ring a slice's label goes on: `1` (right, its text
|
|
27
|
+
reading away from the ring) when the slice's middle faces right, else
|
|
28
|
+
`-1` (left). A slice facing straight up or down takes the right.
|
|
29
|
+
@param angle The slice's middle angle.
|
|
30
|
+
*/
|
|
31
|
+
export declare function outsideSide(angle: number): 1 | -1;
|
|
32
|
+
/**
|
|
33
|
+
How far from the ring's center each side's leaders end, where the
|
|
34
|
+
labels' text starts (less `gap`): past the ring by the elbow and the
|
|
35
|
+
shortest horizontal run.
|
|
36
|
+
@param radius The ring's outer radius.
|
|
37
|
+
@param metrics The label metrics.
|
|
38
|
+
*/
|
|
39
|
+
export declare function outsideColumn(radius: number, metrics: OutsideMetrics): number;
|
|
40
|
+
/**
|
|
41
|
+
The room labels need beside the ring on each side: the widest label on
|
|
42
|
+
that side, plus its leader and gap, or 0 for a side without labels.
|
|
43
|
+
@param labels Each label's middle angle and text width.
|
|
44
|
+
@param metrics The label metrics.
|
|
45
|
+
*/
|
|
46
|
+
export declare function outsideRoom(labels: {
|
|
47
|
+
angle: number;
|
|
48
|
+
width: number;
|
|
49
|
+
}[], metrics: OutsideMetrics): {
|
|
50
|
+
left: number;
|
|
51
|
+
right: number;
|
|
52
|
+
};
|
|
53
|
+
/** One label in a side's column. */
|
|
54
|
+
export interface StackItem {
|
|
55
|
+
/** The height it would like its middle to sit at. */
|
|
56
|
+
y: number;
|
|
57
|
+
/** How tall it is. */
|
|
58
|
+
size: number;
|
|
59
|
+
/** How much it matters: the smallest are dropped first. */
|
|
60
|
+
weight: number;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
Stacks one side's labels so none overlap and all stay between `bounds`:
|
|
64
|
+
sorted by the height each would like, then spread as little as they
|
|
65
|
+
must (see `spreadLabelPositions`). While they don't all fit, or `fits`
|
|
66
|
+
rejects one where it lands, the label with the smallest weight is
|
|
67
|
+
dropped and the rest are stacked again. Returns the height of each
|
|
68
|
+
label's middle, or null for a dropped one.
|
|
69
|
+
@param items The labels.
|
|
70
|
+
@param bounds The top and bottom of the room they share.
|
|
71
|
+
@param fits Whether label `i` may sit at height `y`.
|
|
72
|
+
*/
|
|
73
|
+
export declare function stackOutsideLabels(items: StackItem[], bounds: [number, number], fits?: (i: number, y: number) => boolean): (number | null)[];
|
|
74
|
+
/** The distance from the origin to the segment from `p` to `q`. */
|
|
75
|
+
export declare function segmentDistance(p: Point, q: Point): number;
|
|
76
|
+
/** A leader: from the slice's outer edge, through two bends, to the label's column. */
|
|
77
|
+
export type Leader = [Point, Point, Point, Point];
|
|
78
|
+
/**
|
|
79
|
+
The ways a leader can run from a slice to its label at height `y`, best
|
|
80
|
+
first. The first runs straight out from the middle of the slice's outer
|
|
81
|
+
edge by the elbow, across to the label's height, and level for the last
|
|
82
|
+
`tail` pixels into the label's column, when its run across keeps half an
|
|
83
|
+
elbow clear of the ring. The second leaves the ring leaning only as far
|
|
84
|
+
as it must to stay outside it, reaching the label's height before it
|
|
85
|
+
runs level into the column, when that is short of the column. Empty when
|
|
86
|
+
the label's height can't be reached without crossing the ring.
|
|
87
|
+
@param angle The slice's middle angle.
|
|
88
|
+
@param radius The ring's outer radius.
|
|
89
|
+
@param y The label's height.
|
|
90
|
+
@param metrics The label metrics.
|
|
91
|
+
*/
|
|
92
|
+
export declare function leaderRoutes(angle: number, radius: number, y: number, metrics: OutsideMetrics): Leader[];
|
|
93
|
+
/**
|
|
94
|
+
The leader from a slice to its label at height `y`: the best of
|
|
95
|
+
`leaderRoutes`, or null when there is none.
|
|
96
|
+
@param angle The slice's middle angle.
|
|
97
|
+
@param radius The ring's outer radius.
|
|
98
|
+
@param y The label's height.
|
|
99
|
+
@param metrics The label metrics.
|
|
100
|
+
*/
|
|
101
|
+
export declare function leaderPoints(angle: number, radius: number, y: number, metrics: OutsideMetrics): Leader | null;
|
|
102
|
+
/**
|
|
103
|
+
Whether two polylines cross: some segment of one passes through some
|
|
104
|
+
segment of the other more than `tolerance` pixels from either segment's
|
|
105
|
+
ends (merely touching, or meeting where two leaders leave neighboring
|
|
106
|
+
slivers together, doesn't count).
|
|
107
|
+
@param a One polyline.
|
|
108
|
+
@param b The other.
|
|
109
|
+
@param tolerance How far from a segment's ends a crossing must be.
|
|
110
|
+
*/
|
|
111
|
+
export declare function polylinesCross(a: Point[], b: Point[], tolerance?: number): boolean;
|
|
112
|
+
/**
|
|
113
|
+
The height a slice's label would like: level with the middle of the
|
|
114
|
+
slice's outer edge, pushed out by the leader's elbow.
|
|
115
|
+
@param angle The slice's middle angle.
|
|
116
|
+
@param radius The ring's outer radius.
|
|
117
|
+
@param metrics The label metrics.
|
|
118
|
+
*/
|
|
119
|
+
export declare function outsideIdealY(angle: number, radius: number, metrics: OutsideMetrics): number;
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
3
|
+
import type { Leader, OutsideMetrics } from "./outsideLabels.js";
|
|
4
|
+
import type { OutsideCandidate, PieSlice } from "./pieLabels.js";
|
|
5
|
+
/** The leader's opacity over the theme's ink. */
|
|
6
|
+
export declare const LEADER_OPACITY = 0.5;
|
|
7
|
+
/**
|
|
8
|
+
When an outside label and its leader fade in: over the second half of a
|
|
9
|
+
redraw, once the slices have mostly settled, so they don't fade in
|
|
10
|
+
where a label that is leaving still shows.
|
|
11
|
+
*/
|
|
12
|
+
export declare const OUTSIDE_ENTER: {
|
|
13
|
+
start: number;
|
|
14
|
+
end: number;
|
|
15
|
+
};
|
|
16
|
+
/** Where the ring sits: its radius, its center in the chart area, and the chart area's size. */
|
|
17
|
+
export interface OutsideFrame {
|
|
18
|
+
radius: number;
|
|
19
|
+
cx: number;
|
|
20
|
+
cy: number;
|
|
21
|
+
width: number;
|
|
22
|
+
height: number;
|
|
23
|
+
}
|
|
24
|
+
/** A label to stack beside the ring: its slice's middle angle, its weight, and how many lines it takes. */
|
|
25
|
+
export interface OutsideStackLabel {
|
|
26
|
+
angle: number;
|
|
27
|
+
weight: number;
|
|
28
|
+
lines: number;
|
|
29
|
+
}
|
|
30
|
+
/** Where a stacked label goes: the height of its middle, and its leader. */
|
|
31
|
+
export interface OutsidePlacement {
|
|
32
|
+
y: number;
|
|
33
|
+
leader: Leader;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
The room beside the ring on each side, from where the labels' text
|
|
37
|
+
starts to the chart area's edge.
|
|
38
|
+
@param frame The ring and the chart area.
|
|
39
|
+
@param metrics The label metrics.
|
|
40
|
+
*/
|
|
41
|
+
export declare function outsideSpace(frame: OutsideFrame, metrics: OutsideMetrics): {
|
|
42
|
+
left: number;
|
|
43
|
+
right: number;
|
|
44
|
+
};
|
|
45
|
+
/**
|
|
46
|
+
Stacks the outside labels: each side's labels in a column beside the
|
|
47
|
+
ring, within the chart area's height, the smallest slices' labels
|
|
48
|
+
dropped when they don't all fit or a leader can't reach one (see
|
|
49
|
+
`stackOutsideLabels`). Each leader takes the best of its routes (see
|
|
50
|
+
`leaderRoutes`) that crosses no leader above it; when every route
|
|
51
|
+
crosses one, the side's smallest slice gives up its label and the side
|
|
52
|
+
is stacked again. Returns each label's placement, or null for a
|
|
53
|
+
dropped one.
|
|
54
|
+
@param labels The labels.
|
|
55
|
+
@param frame The ring and the chart area.
|
|
56
|
+
@param metrics The label metrics.
|
|
57
|
+
*/
|
|
58
|
+
export declare function placeOutsideLabels(labels: OutsideStackLabel[], frame: OutsideFrame, metrics: OutsideMetrics): (OutsidePlacement | null)[];
|
|
59
|
+
/** A label that fit its side's room but found no place in its column. */
|
|
60
|
+
export interface CrowdedLabel {
|
|
61
|
+
/** Its slice's middle angle. */
|
|
62
|
+
angle: number;
|
|
63
|
+
/** Its height. */
|
|
64
|
+
size: number;
|
|
65
|
+
}
|
|
66
|
+
/** The outside labels' scene nodes, the slices they name, and the labels that found no place. */
|
|
67
|
+
export interface PieOutsideScene {
|
|
68
|
+
nodes: SceneNode[];
|
|
69
|
+
named: Set<PieSlice>;
|
|
70
|
+
crowded: CrowdedLabel[];
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
The outside labels' scene nodes, the slices they name, and the labels
|
|
74
|
+
their columns had no place for (see `CrowdedLabel`): a leader and
|
|
75
|
+
a label per slice placed beside the ring (see `placeOutsideLabels`), in
|
|
76
|
+
the theme's ink unless the Path labelConfig's `fontColor` sets a color.
|
|
77
|
+
A label wider than its side's room wraps onto a second line, between
|
|
78
|
+
words, and drops its share when even that is too narrow; a label that
|
|
79
|
+
can't show its slice's whole name within its room is left out, so the
|
|
80
|
+
slice keeps its label inside the ring.
|
|
81
|
+
@param viz The chart.
|
|
82
|
+
@param candidates The slices whose labels go outside.
|
|
83
|
+
@param frame The ring and the chart area.
|
|
84
|
+
*/
|
|
85
|
+
export declare function pieOutsideNodes(viz: VizInstance, candidates: OutsideCandidate[], frame: OutsideFrame): PieOutsideScene;
|
|
86
|
+
/**
|
|
87
|
+
The outside labels for the current layout (see `pieOutsideNodes`), with
|
|
88
|
+
the ring and the chart area read from the layout `applyPieLayout` kept
|
|
89
|
+
on `viz.ctx`. Worked out once per layout.
|
|
90
|
+
@param viz The chart, laid out by `applyPieLayout`.
|
|
91
|
+
@param slices The laid-out slices.
|
|
92
|
+
*/
|
|
93
|
+
export declare function pieOutsideLabels(viz: VizInstance, slices: PieSlice[]): PieOutsideScene;
|
|
@@ -0,0 +1,85 @@
|
|
|
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
|
+
*/
|
|
9
|
+
import type { PieArcDatum } from "d3-shape";
|
|
10
|
+
import type { DataPoint } from "@d3plus/data";
|
|
11
|
+
import type { SceneNode } from "@d3plus/render";
|
|
12
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
13
|
+
/** A laid-out slice. */
|
|
14
|
+
export type PieSlice = PieArcDatum<DataPoint> & {
|
|
15
|
+
__d3plus__?: true;
|
|
16
|
+
i?: number;
|
|
17
|
+
share?: number;
|
|
18
|
+
};
|
|
19
|
+
/** A slice whose label goes outside the ring. */
|
|
20
|
+
export interface OutsideCandidate {
|
|
21
|
+
slice: PieSlice;
|
|
22
|
+
/** The slice's index. */
|
|
23
|
+
index: number;
|
|
24
|
+
/** The slice's middle angle. */
|
|
25
|
+
angle: number;
|
|
26
|
+
/** The label: the slice's name and share. */
|
|
27
|
+
text: string;
|
|
28
|
+
/** The label's one-line width. */
|
|
29
|
+
width: number;
|
|
30
|
+
/** The narrowest it gets wrapped onto two lines between words. */
|
|
31
|
+
wrapWidth: number;
|
|
32
|
+
/** The slice's value: smaller slices give up their labels first. */
|
|
33
|
+
weight: number;
|
|
34
|
+
}
|
|
35
|
+
/** A Pie's labels for one layout. */
|
|
36
|
+
export interface PieLabelPlan {
|
|
37
|
+
/** The straight labels inside the slices. */
|
|
38
|
+
straight: SceneNode[];
|
|
39
|
+
/** The curved labels along the ring. */
|
|
40
|
+
curved: SceneNode[];
|
|
41
|
+
/** The slices whose label goes outside the ring, if there is room for it. */
|
|
42
|
+
outside: OutsideCandidate[];
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
The narrowest a text gets wrapped onto two lines between its words: the
|
|
46
|
+
wider of the two lines at the best break. A single word can't wrap, so
|
|
47
|
+
its width is its own.
|
|
48
|
+
@param text The text.
|
|
49
|
+
@param width A string's one-line width.
|
|
50
|
+
*/
|
|
51
|
+
export declare function twoLineWidth(text: string, width: (text: string) => number): number;
|
|
52
|
+
/**
|
|
53
|
+
Formats a slice's share as a percentage in the chart's locale.
|
|
54
|
+
@param viz The chart.
|
|
55
|
+
*/
|
|
56
|
+
export declare function pieSharePct(viz: VizInstance): (d: PieSlice) => string;
|
|
57
|
+
/**
|
|
58
|
+
The outside labels' font size: the Path labelConfig's `fontSize`, else
|
|
59
|
+
`OUTSIDE_LABEL_FONT_SIZE`.
|
|
60
|
+
@param labelConfig The Path labelConfig.
|
|
61
|
+
*/
|
|
62
|
+
export declare function outsideFontSize(labelConfig: Record<string, unknown>): number;
|
|
63
|
+
/**
|
|
64
|
+
Whether a slice's `labelPosition` puts its label outside the ring:
|
|
65
|
+
always for `"outside"`, never for `"inside"` or `"along"`, and for
|
|
66
|
+
`"auto"` only when its label inside doesn't show its whole name.
|
|
67
|
+
@param position The slice's `labelPosition`.
|
|
68
|
+
@param shownWhole Whether its label inside shows its whole name.
|
|
69
|
+
*/
|
|
70
|
+
export declare function labelGoesOutside(position: unknown, shownWhole: boolean): boolean;
|
|
71
|
+
/**
|
|
72
|
+
Whether any slice's `labelPosition` may put its label outside the ring:
|
|
73
|
+
false when every one is `"inside"` or `"along"`.
|
|
74
|
+
@param viz The chart.
|
|
75
|
+
@param slices The laid-out slices.
|
|
76
|
+
*/
|
|
77
|
+
export declare function pieMayLabelOutside(viz: VizInstance, slices: PieSlice[]): boolean;
|
|
78
|
+
/**
|
|
79
|
+
Works out every slice's label for the current layout (`viz.ctx.arcData`):
|
|
80
|
+
the labels inside the ring, and the slices whose label goes outside it.
|
|
81
|
+
Kept on `viz.ctx`, so the same layout is only worked out once.
|
|
82
|
+
@param viz The chart, laid out by `applyPieLayout`.
|
|
83
|
+
@param slices The laid-out slices.
|
|
84
|
+
*/
|
|
85
|
+
export declare function pieLabelPlan(viz: VizInstance, slices: PieSlice[]): PieLabelPlan;
|
|
@@ -0,0 +1,95 @@
|
|
|
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
|
+
*/
|
|
12
|
+
import type { RingArc } from "../features/ringLabels.js";
|
|
13
|
+
type Pt = [number, number];
|
|
14
|
+
/** A box by its top-left corner and size. */
|
|
15
|
+
export interface SectorBox {
|
|
16
|
+
x: number;
|
|
17
|
+
y: number;
|
|
18
|
+
width: number;
|
|
19
|
+
height: number;
|
|
20
|
+
}
|
|
21
|
+
/** One straight side of a segment: the line its pad leaves along a boundary ray. */
|
|
22
|
+
export interface SectorSide {
|
|
23
|
+
/** The unit normal pointing into the segment. */
|
|
24
|
+
normal: Pt;
|
|
25
|
+
/** The side's distance from the ring's center, along `normal`. */
|
|
26
|
+
offset: number;
|
|
27
|
+
/** The boundary ray's direction, away from the center. */
|
|
28
|
+
ray: Pt;
|
|
29
|
+
}
|
|
30
|
+
/** A segment's edges, as `sectorEdges` resolves them. */
|
|
31
|
+
export interface SectorEdges {
|
|
32
|
+
/** The bisector's angle. */
|
|
33
|
+
mid: number;
|
|
34
|
+
/** The bisector's direction, away from the center. */
|
|
35
|
+
dir: Pt;
|
|
36
|
+
/** The angle the segment spans, after its pad. */
|
|
37
|
+
span: number;
|
|
38
|
+
/** The radius a box stays outside of (0 for none). */
|
|
39
|
+
inner: number;
|
|
40
|
+
/** The radius a box stays inside of. */
|
|
41
|
+
outer: number;
|
|
42
|
+
/** The two straight sides, or none for a full turn. */
|
|
43
|
+
sides: SectorSide[];
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
Resolves a ring segment's edges, the way d3-shape's arc draws it: a
|
|
47
|
+
`padAngle` narrows a Pie wedge (no hole) by that angle, and offsets a
|
|
48
|
+
ring segment's sides by a constant gap (`padAngle` at the default pad
|
|
49
|
+
radius, `√(inner² + outer²)`). `padding` keeps a box that much further
|
|
50
|
+
inside every edge. A full turn has no sides; its bisector points up.
|
|
51
|
+
Null when the segment has no area.
|
|
52
|
+
@param arc The segment.
|
|
53
|
+
@param padding The room kept inside every edge, in pixels.
|
|
54
|
+
*/
|
|
55
|
+
export declare function sectorEdges(arc: RingArc, padding?: number): SectorEdges | null;
|
|
56
|
+
/**
|
|
57
|
+
The stretch of a segment's bisector where a `width`×`height` box can be
|
|
58
|
+
centered and stay inside the segment, as distances from the ring's
|
|
59
|
+
center: from `lo` to `hi`. For a whole disc it runs through the center,
|
|
60
|
+
from `-hi` to `hi`. Null when the box fits nowhere along it.
|
|
61
|
+
@param edges The segment's edges (see `sectorEdges`).
|
|
62
|
+
@param width The box's width.
|
|
63
|
+
@param height The box's height.
|
|
64
|
+
*/
|
|
65
|
+
export declare function sectorBoxRange(edges: SectorEdges, width: number, height: number): {
|
|
66
|
+
lo: number;
|
|
67
|
+
hi: number;
|
|
68
|
+
} | null;
|
|
69
|
+
/**
|
|
70
|
+
The box of the given size centered on the bisector at distance `t`.
|
|
71
|
+
@param edges The segment's edges.
|
|
72
|
+
@param t The center's distance from the ring's center.
|
|
73
|
+
@param width The box's width.
|
|
74
|
+
@param height The box's height.
|
|
75
|
+
*/
|
|
76
|
+
export declare function sectorBoxAt(edges: SectorEdges, t: number, width: number, height: number): SectorBox;
|
|
77
|
+
/**
|
|
78
|
+
A `width`×`height` box centered on a segment's bisector, halfway along
|
|
79
|
+
the stretch where it fits (see `sectorBoxRange`), so the room around it
|
|
80
|
+
is shared out evenly. Null when it fits nowhere.
|
|
81
|
+
@param edges The segment's edges.
|
|
82
|
+
@param width The box's width.
|
|
83
|
+
@param height The box's height.
|
|
84
|
+
*/
|
|
85
|
+
export declare function centeredSectorBox(edges: SectorEdges, width: number, height: number): SectorBox | null;
|
|
86
|
+
/**
|
|
87
|
+
The largest box of a given shape centered on a segment's bisector, at
|
|
88
|
+
the one place along it where that box fits. The scale is searched from
|
|
89
|
+
0 up to the ring's diameter.
|
|
90
|
+
@param edges The segment's edges.
|
|
91
|
+
@param size The box's width and height at a scale, growing with it.
|
|
92
|
+
@param iterations How finely the scale is searched.
|
|
93
|
+
*/
|
|
94
|
+
export declare function largestSectorBox(edges: SectorEdges, size: (scale: number) => [number, number], iterations?: number): SectorBox | null;
|
|
95
|
+
export {};
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { RingArc } from "../features/ringLabels.js";
|
|
3
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
4
|
+
import type { PieSlice } from "./pieLabels.js";
|
|
5
|
+
/** What placing the straight labels needs. */
|
|
6
|
+
export interface StraightLabelInputs {
|
|
7
|
+
viz: VizInstance;
|
|
8
|
+
slices: PieSlice[];
|
|
9
|
+
/** Each slice's ring segment. */
|
|
10
|
+
arcOf: (d: PieSlice) => RingArc;
|
|
11
|
+
/** The Path shape config, for each slice's fill. */
|
|
12
|
+
sc: Record<string, unknown>;
|
|
13
|
+
/** Each slice's share, as text. */
|
|
14
|
+
sharePct: (d: PieSlice) => string;
|
|
15
|
+
/** The Path shape's labelConfig. */
|
|
16
|
+
labelConfig: Record<string, unknown>;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
Each slice's straight label, centered on its bisector: the name, at the
|
|
20
|
+
largest size that shows it whole, and the share percentage beneath it
|
|
21
|
+
when there is room (see `straightLabelLayout`).
|
|
22
|
+
@param inputs The slices, their segments and fills, and the label config.
|
|
23
|
+
*/
|
|
24
|
+
export declare function pieStraightLabels(inputs: StraightLabelInputs): SceneNode[];
|
|
@@ -0,0 +1,88 @@
|
|
|
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
|
+
*/
|
|
7
|
+
import type { SceneNode } from "@d3plus/render";
|
|
8
|
+
import type { SectorBox, SectorEdges } from "./sectorBox.js";
|
|
9
|
+
/** How a straight label is sized. */
|
|
10
|
+
export interface StraightLabelOptions {
|
|
11
|
+
/** The smallest font size worth drawing. */
|
|
12
|
+
fontMin: number;
|
|
13
|
+
/** The largest font size to try. */
|
|
14
|
+
fontMax: number;
|
|
15
|
+
/** The room kept between the text and its box's edges, in pixels. */
|
|
16
|
+
padding: number;
|
|
17
|
+
/** The line height, as a multiple of the font size. */
|
|
18
|
+
lineHeight: number;
|
|
19
|
+
/** The share's font size, as a multiple of the name's. */
|
|
20
|
+
shareRatio: number;
|
|
21
|
+
/** The share is drawn when the name, with it, keeps at least this share of its size alone… */
|
|
22
|
+
shareKeep: number;
|
|
23
|
+
/** …or at least this font size. */
|
|
24
|
+
shareFont: number;
|
|
25
|
+
/** The room kept around the text inside its slice, as a multiple of the font size, when that is more than `padding`. */
|
|
26
|
+
margin: number;
|
|
27
|
+
/** The most lines the name wraps onto. */
|
|
28
|
+
maxLines: number;
|
|
29
|
+
}
|
|
30
|
+
/** The defaults for `StraightLabelOptions`. */
|
|
31
|
+
export declare const STRAIGHT_LABEL_DEFAULTS: StraightLabelOptions;
|
|
32
|
+
/**
|
|
33
|
+
The straight label options a labelConfig asks for: its `fontSize` alone
|
|
34
|
+
when it sets one, else `fontMin` to `fontMax` (10 to 32 by default), and
|
|
35
|
+
its `padding` (5 by default).
|
|
36
|
+
@param config The labelConfig.
|
|
37
|
+
*/
|
|
38
|
+
export declare function straightLabelOptions(config: Record<string, unknown>): StraightLabelOptions;
|
|
39
|
+
/**
|
|
40
|
+
The narrowest a text wraps between its words onto 1, 2, … lines: for
|
|
41
|
+
each line count, the widest line at the best breaks. Stops at
|
|
42
|
+
`maxLines`, or at one line per word.
|
|
43
|
+
@param text The text.
|
|
44
|
+
@param width A string's one-line width.
|
|
45
|
+
@param maxLines The most lines.
|
|
46
|
+
*/
|
|
47
|
+
export declare function wrapWidths(text: string, width: (text: string) => number, maxLines: number): number[];
|
|
48
|
+
/** A straight label's sizes and boxes. */
|
|
49
|
+
export interface StraightLabelLayout {
|
|
50
|
+
/** The name's font size. */
|
|
51
|
+
fontSize: number;
|
|
52
|
+
/** The lines the name wraps onto. */
|
|
53
|
+
lines: number;
|
|
54
|
+
/** The share's font size, or null when it isn't drawn. */
|
|
55
|
+
shareSize: number | null;
|
|
56
|
+
/** The name's box. */
|
|
57
|
+
name: SectorBox;
|
|
58
|
+
/** The share's box, beneath the name's. */
|
|
59
|
+
share: SectorBox | null;
|
|
60
|
+
/** The center of the whole label, on the slice's bisector. */
|
|
61
|
+
center: [number, number];
|
|
62
|
+
/** Whether no font size shows the whole name, so it is cut short at `fontMin`. */
|
|
63
|
+
truncated: boolean;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
Lays a straight label out in a slice: the largest whole font size (up to
|
|
67
|
+
`fontMax`) at which the name, wrapped onto some number of lines, and the
|
|
68
|
+
share beneath it fit in a box centered on the slice's bisector, with
|
|
69
|
+
room around them (see `margin`). The share is left off when it would
|
|
70
|
+
shrink the name too much (see `shareKeep` and `shareFont`); a name on
|
|
71
|
+
more lines must show larger than on fewer. The box goes halfway along
|
|
72
|
+
the stretch of the bisector where it fits. When even `fontMin` doesn't
|
|
73
|
+
fit the name whole, the label is one line at `fontMin`, as wide as the
|
|
74
|
+
slice allows, and is cut short; null when that has no room for a few
|
|
75
|
+
letters.
|
|
76
|
+
@param edges The slice's edges (see `sectorEdges`).
|
|
77
|
+
@param wraps The name's width at a font size of 1 on 1, 2, … lines (see `wrapWidths`).
|
|
78
|
+
@param shareWidth The share's width at a font size of 1, or null for none.
|
|
79
|
+
@param options How the label is sized.
|
|
80
|
+
*/
|
|
81
|
+
export declare function straightLabelLayout(edges: SectorEdges, wraps: number[], shareWidth: number | null, options?: StraightLabelOptions): StraightLabelLayout | null;
|
|
82
|
+
/**
|
|
83
|
+
Moves a label's text nodes up or down together, so their lines' glyphs
|
|
84
|
+
are centered on `y`.
|
|
85
|
+
@param nodes One label's nodes.
|
|
86
|
+
@param y Where the lines' middle goes.
|
|
87
|
+
*/
|
|
88
|
+
export declare function centerLabelLines(nodes: SceneNode[], y: number): void;
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
2
|
+
/** How many series (lines or stacked bands) a draw had, asked to be labeled along, and labeled. */
|
|
3
|
+
export interface AlongStats {
|
|
4
|
+
series: number;
|
|
5
|
+
requested: number;
|
|
6
|
+
placed: number;
|
|
7
|
+
}
|
|
8
|
+
/** Fresh counts for a draw. */
|
|
9
|
+
export declare const emptyAlongStats: () => AlongStats;
|
|
10
|
+
/**
|
|
11
|
+
Whether a chart draws stacked areas whose labels can run along their
|
|
12
|
+
bands: it stacks, draws its first row as an Area, and `labelPosition`
|
|
13
|
+
can ask for along labels.
|
|
14
|
+
@param viz The chart.
|
|
15
|
+
*/
|
|
16
|
+
export declare function bandLabelsPossible(viz: VizInstance): boolean;
|
|
17
|
+
/**
|
|
18
|
+
Whether this chart's legend may stand aside for its along labels: it is
|
|
19
|
+
the default legend (a user's `legend` always wins), no series is hidden
|
|
20
|
+
or soloed from it (the legend is the way back to them), and `lineLabels`
|
|
21
|
+
or stacked areas can ask for along labels, or the chart says its own
|
|
22
|
+
along labels can name every series (`_alongLabelsPossible`, such as a
|
|
23
|
+
RadialBar's curved track labels).
|
|
24
|
+
@param viz The chart.
|
|
25
|
+
*/
|
|
26
|
+
export declare function alongLegendAuto(viz: VizInstance): boolean;
|
|
27
|
+
/**
|
|
28
|
+
Whether a draw labeled every series along it: more than one series (a
|
|
29
|
+
lone one has no label to stand in for the legend), each of which asked
|
|
30
|
+
for an along label and got one.
|
|
31
|
+
@param stats The draw's counts.
|
|
32
|
+
*/
|
|
33
|
+
export declare function allAlongLabeled(stats: AlongStats | undefined): boolean;
|
|
34
|
+
/**
|
|
35
|
+
Runs a chart's draw, hiding its default legend when along labels name
|
|
36
|
+
every series: the first draw lays out without the legend, and when any
|
|
37
|
+
series goes unlabeled, the chart draws again, from the same margins,
|
|
38
|
+
with the legend.
|
|
39
|
+
@param viz The chart.
|
|
40
|
+
@param draw Draws the chart once.
|
|
41
|
+
*/
|
|
42
|
+
export declare function drawWithAlongLegend(viz: VizInstance, draw: () => void): void;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
How areas grow in: every band starts flat on the value axis's baseline
|
|
3
|
+
and rises into place. An unstacked area starts on its own baseline; a
|
|
4
|
+
stack starts on the zero line (or the `baseline`, kept inside the
|
|
5
|
+
domain), so its bands rise together, each riding on the one beneath it.
|
|
6
|
+
Their labels fade in as the bands finish growing, where the bands land.
|
|
7
|
+
*/
|
|
8
|
+
import type { EnterWindow, SceneNode } from "@d3plus/render";
|
|
9
|
+
import type { ShapeEmitContext } from "../features/shapeEmit.js";
|
|
10
|
+
/**
|
|
11
|
+
The pixel line, along the value axis, that areas grow out of.
|
|
12
|
+
@param ctx The Plot shape-emit context the areas were drawn with.
|
|
13
|
+
*/
|
|
14
|
+
export declare function areaBaseline(ctx: ShapeEmitContext): number | null;
|
|
15
|
+
/**
|
|
16
|
+
The share of an area's enter its labels wait out: they fade in over the
|
|
17
|
+
last part, once the bands have nearly reached the places they name.
|
|
18
|
+
*/
|
|
19
|
+
export declare const AREA_LABEL_ENTER: EnterWindow;
|
|
20
|
+
/**
|
|
21
|
+
Holds every text node under `nodes` back until late in its enter (see
|
|
22
|
+
`AREA_LABEL_ENTER`), so a label doesn't show where its band has yet to
|
|
23
|
+
grow.
|
|
24
|
+
@param nodes The label nodes, or the groups holding them.
|
|
25
|
+
*/
|
|
26
|
+
export declare function holdAreaLabels<T extends SceneNode>(nodes: T[]): T[];
|
|
27
|
+
/**
|
|
28
|
+
Sets each Area path's `enterD`: its outline flattened onto the baseline
|
|
29
|
+
(see `areaBaseline`), so it grows out of the axis and, on exit, sinks
|
|
30
|
+
back into it. The areas' own labels fade in late (see `holdAreaLabels`).
|
|
31
|
+
@param ctx The Plot shape-emit context the areas were drawn with.
|
|
32
|
+
@param nodes The areas' scene nodes.
|
|
33
|
+
*/
|
|
34
|
+
export declare function growAreasFromBaseline(ctx: ShapeEmitContext, nodes: SceneNode[]): void;
|