@d3plus/core 4.10.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +167 -8
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +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 +3 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +2 -1
- 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 +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +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 +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +86 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +5 -1
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +64 -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/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 +8 -2
- 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 +18 -10
- 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/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 +34 -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/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 +2 -2
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -35
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +2 -3
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +16 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +3 -7
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +61 -28
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +72 -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 +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +10 -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 +6 -5
- 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/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +8 -1
- package/es/src/charts/events/mousemove.shape.js +5 -2
- 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 +2 -1
- package/es/src/charts/features/axesFinal.js +3 -1
- package/es/src/charts/features/axesMeasure.js +7 -4
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +2 -1
- package/es/src/charts/features/colorScaleHover.js +3 -2
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +20 -6
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +38 -11
- 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 +47 -31
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +2 -2
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +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/config.js +2 -3
- package/es/src/charts/viz/Viz.js +39 -36
- package/es/src/charts/viz/VizBase.js +18 -10
- package/es/src/charts/viz/backgroundInk.js +13 -7
- 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/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/vizDataPolling.js +8 -3
- package/es/src/charts/viz/vizDefaults.js +15 -23
- package/es/src/charts/viz/vizFields.js +35 -0
- package/es/src/charts/viz/vizRender.js +43 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +6 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +5 -9
- package/es/src/components/Axis/axisLayoutScale.js +7 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -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 +15 -9
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +29 -65
- 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 +7 -3
- 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 +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +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 +25 -12
- package/es/src/utils/configPrep.js +2 -1
- 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 +250 -8
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/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 +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/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 +15 -8
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +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/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 +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +13 -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/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/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +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 +14 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +16 -2
- package/types/src/charts/viz/VizBase.d.ts +6 -6
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- 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/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +32 -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 +84 -7
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +1 -0
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -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 +1 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/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/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/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +981 -30
- package/types/src/utils/configPrep.d.ts +2 -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/umd/d3plus-core.full.js +86811 -61031
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +28392 -6498
- 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
|
@@ -5,48 +5,65 @@
|
|
|
5
5
|
- `applyLayout.ts` — chart-specific `TransformStage`.
|
|
6
6
|
- `emit.ts` — Path + label scene nodes from the laid-out slices.
|
|
7
7
|
*/ import { pie as d3Pie } from "d3-shape";
|
|
8
|
-
import { backgroundColor } from "@d3plus/dom";
|
|
9
8
|
import accessor from "../../utils/accessor.js";
|
|
10
9
|
import { fieldAccessor } from "../../utils/fieldAccessor.js";
|
|
11
|
-
import { centerChartTransform } from "../features/chartGeometry.js";
|
|
12
|
-
import { rowLegend, shareRow } from "../features/sharedFields.js";
|
|
10
|
+
import { chartBounds, centerChartTransform } from "../features/chartGeometry.js";
|
|
11
|
+
import { legendLargestFirst, rowLegend, shareRow } from "../features/sharedFields.js";
|
|
13
12
|
import { makeChart } from "../definition/makeChart.js";
|
|
14
|
-
import { applyPieLayout } from "./applyLayout.js";
|
|
13
|
+
import { applyPieLayout, pieAspect } from "./applyLayout.js";
|
|
15
14
|
import { pieEmit } from "./emit.js";
|
|
16
15
|
import { sceneInsetRegion } from "../pipeline/insetPlacement.js";
|
|
16
|
+
import { chartBackground } from "../viz/backgroundInk.js";
|
|
17
17
|
export const pieDef = {
|
|
18
18
|
name: "Pie",
|
|
19
19
|
layoutStage: applyPieLayout,
|
|
20
20
|
emit: pieEmit,
|
|
21
21
|
insetRegion: sceneInsetRegion,
|
|
22
|
-
|
|
23
|
-
//
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
22
|
+
// The origin sits at the ring's center, which applyPieLayout fits to the
|
|
23
|
+
// chart area along with the ring's own footprint.
|
|
24
|
+
chartTransform: (viz)=>{
|
|
25
|
+
const center = viz.ctx.pieCenter;
|
|
26
|
+
if (!center) {
|
|
27
|
+
const { width, height } = chartBounds(viz);
|
|
28
|
+
return centerChartTransform(viz, width, height);
|
|
29
|
+
}
|
|
30
|
+
return {
|
|
31
|
+
x: viz._margin.left + center.x,
|
|
32
|
+
y: viz._margin.top + center.y
|
|
33
|
+
};
|
|
34
|
+
},
|
|
35
|
+
// Wedges are drawn around the centered origin, not in the top-left-origin
|
|
36
|
+
// box the default chartBodyRect assumes (that default is only correct for
|
|
37
|
+
// a marginOriginTransform chart like Treemap); without this override, the
|
|
38
|
+
// drill-down morph's enter/exit fractions would be computed against the
|
|
39
|
+
// wrong origin.
|
|
29
40
|
//
|
|
30
|
-
// Uses the TIGHT
|
|
31
|
-
//
|
|
32
|
-
//
|
|
33
|
-
//
|
|
34
|
-
//
|
|
35
|
-
//
|
|
36
|
-
// case) uses this as the "whole pie" reference — a mismatched reference
|
|
37
|
-
// would stretch the circle into an ellipse, or off-scale it, as it grows.
|
|
41
|
+
// Uses the ring's TIGHT footprint (pieBox, at applyPieLayout's actual,
|
|
42
|
+
// buffer-reduced outerRadius — see its comment on strokeBuffer) rather
|
|
43
|
+
// than the loose available space: the drill-down morph's proportional
|
|
44
|
+
// remap (collapseTo's shapeType "Pie" case) uses this as the "whole pie"
|
|
45
|
+
// reference, and a mismatched reference would stretch the ring, or
|
|
46
|
+
// off-scale it, as it grows.
|
|
38
47
|
chartBodyRect: (viz)=>{
|
|
39
|
-
const
|
|
48
|
+
const b = viz.ctx.pieBox;
|
|
49
|
+
if (!b) return {
|
|
50
|
+
x: 0,
|
|
51
|
+
y: 0,
|
|
52
|
+
width: 0,
|
|
53
|
+
height: 0
|
|
54
|
+
};
|
|
40
55
|
return {
|
|
41
|
-
x:
|
|
42
|
-
y:
|
|
43
|
-
width:
|
|
44
|
-
height:
|
|
56
|
+
x: b.x0,
|
|
57
|
+
y: b.y0,
|
|
58
|
+
width: b.x1 - b.x0,
|
|
59
|
+
height: b.y1 - b.y0
|
|
45
60
|
};
|
|
46
61
|
},
|
|
47
|
-
// Small-multiple panels
|
|
62
|
+
// Small-multiple panels shaped like the ring's footprint: as close to
|
|
63
|
+
// square as the grid allows for a full circle, twice as wide as tall for a
|
|
64
|
+
// half ring.
|
|
48
65
|
facet: {
|
|
49
|
-
aspect:
|
|
66
|
+
aspect: pieAspect
|
|
50
67
|
},
|
|
51
68
|
ctx: {
|
|
52
69
|
pie: d3Pie()
|
|
@@ -61,6 +78,25 @@ export const pieDef = {
|
|
|
61
78
|
default: 0
|
|
62
79
|
},
|
|
63
80
|
/**
|
|
81
|
+
Where the slices start, in degrees clockwise from 12 o'clock, the same
|
|
82
|
+
convention Gauge, PolarArea and RadialBar use. With `endAngle`, draws a
|
|
83
|
+
partial ring: `startAngle: -90, endAngle: 90` makes a half pie (or,
|
|
84
|
+
with Donut, a half donut) that opens downward. A partial ring is sized
|
|
85
|
+
to its own footprint and centered, so a half ring fills the chart's
|
|
86
|
+
width.
|
|
87
|
+
*/ {
|
|
88
|
+
key: "startAngle",
|
|
89
|
+
default: 0
|
|
90
|
+
},
|
|
91
|
+
/**
|
|
92
|
+
Where the slices end, in degrees clockwise from 12 o'clock. Defaults to
|
|
93
|
+
one full turn past `startAngle`; an `endAngle` less than `startAngle`
|
|
94
|
+
lays the slices out counter-clockwise. The sweep is capped at one turn.
|
|
95
|
+
@type {number}
|
|
96
|
+
*/ {
|
|
97
|
+
key: "endAngle"
|
|
98
|
+
},
|
|
99
|
+
/**
|
|
64
100
|
The padding between each arc, in radians. When set, takes precedence
|
|
65
101
|
over `padPixel`.
|
|
66
102
|
@type {number}
|
|
@@ -101,10 +137,7 @@ export const pieDef = {
|
|
|
101
137
|
},
|
|
102
138
|
{
|
|
103
139
|
key: "legendSort",
|
|
104
|
-
factory: (viz)=>
|
|
105
|
-
const valueFn = viz.schema.value;
|
|
106
|
-
return (a, b)=>valueFn(b) - valueFn(a);
|
|
107
|
-
}
|
|
140
|
+
factory: (viz)=>legendLargestFirst(viz, "value")
|
|
108
141
|
},
|
|
109
142
|
{
|
|
110
143
|
key: "shapeConfig",
|
|
@@ -128,7 +161,7 @@ export const pieDef = {
|
|
|
128
161
|
// angular gap has nowhere left to taper from. Centered on each
|
|
129
162
|
// wedge's outline (SVG's default), so half its width falls on each
|
|
130
163
|
// side of an edge shared with a neighbor.
|
|
131
|
-
stroke: ()=>
|
|
164
|
+
stroke: ()=>chartBackground(viz),
|
|
132
165
|
strokeWidth: 2
|
|
133
166
|
})
|
|
134
167
|
},
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The room a Pie or Donut keeps around its ring for labels outside it (see
|
|
3
|
+
`labelPosition`): beside the ring, enough for the widest label on each
|
|
4
|
+
side that needs one; above and below it, enough for the labels its
|
|
5
|
+
columns had no place for; and never so much that the ring shrinks below
|
|
6
|
+
`PIE_MIN_SCALE` of its full size.
|
|
7
|
+
*/ import { chartBounds } from "../features/chartGeometry.js";
|
|
8
|
+
import { userLabelConfig } from "../features/emitHelpers.js";
|
|
9
|
+
import { outsideMetrics, outsideRoom, outsideSide } from "./outsideLabels.js";
|
|
10
|
+
import { pieOutsideLabels } from "./outsideNodes.js";
|
|
11
|
+
import { outsideFontSize, pieLabelPlan, pieMayLabelOutside } from "./pieLabels.js";
|
|
12
|
+
/** The smallest a ring shrinks to make room for labels outside it, as a share of its full radius. */ export const PIE_MIN_SCALE = 0.6;
|
|
13
|
+
/** The most room a single label claims beside the ring, as a share of the chart's width; a longer label wraps. */ export const OUTSIDE_MAX_SHARE = 0.3;
|
|
14
|
+
/** No room kept. */ export const NO_ROOM = {
|
|
15
|
+
left: 0,
|
|
16
|
+
right: 0,
|
|
17
|
+
top: 0,
|
|
18
|
+
bottom: 0
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
Scales the room on two opposite sides down, keeping their proportions,
|
|
22
|
+
so the ring keeps at least `min` of the chart's `size` between them.
|
|
23
|
+
@param a The room on one side.
|
|
24
|
+
@param b The room on the other.
|
|
25
|
+
@param size The chart area's size across both.
|
|
26
|
+
@param min The least the ring keeps.
|
|
27
|
+
*/ export function clampSides(a, b, size, min) {
|
|
28
|
+
const total = a + b;
|
|
29
|
+
const spare = Math.max(0, size - min);
|
|
30
|
+
if (total <= spare) return [
|
|
31
|
+
a,
|
|
32
|
+
b
|
|
33
|
+
];
|
|
34
|
+
const k = total > 0 ? spare / total : 0;
|
|
35
|
+
return [
|
|
36
|
+
a * k,
|
|
37
|
+
b * k
|
|
38
|
+
];
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
The width a label claims beside the ring: its own when it is at most
|
|
42
|
+
`cap`, else the narrowest it wraps onto two lines when that is, else
|
|
43
|
+
none (it is drawn only where the room happens to hold it).
|
|
44
|
+
@param width The label's one-line width.
|
|
45
|
+
@param wrapWidth The narrowest it wraps onto two lines.
|
|
46
|
+
@param cap The most a label claims.
|
|
47
|
+
*/ export function outsideClaim(width, wrapWidth, cap) {
|
|
48
|
+
if (width <= cap) return width;
|
|
49
|
+
return wrapWidth <= cap ? wrapWidth : 0;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
The room to keep beside the ring at the current layout: `room`, grown
|
|
53
|
+
on each side to fit that side's widest label outside the ring (see
|
|
54
|
+
`outsideClaim`; a label claims at most `OUTSIDE_MAX_SHARE` of the
|
|
55
|
+
chart's width), then scaled back so the ring keeps `minWidth`.
|
|
56
|
+
@param viz The chart, laid out with `room`.
|
|
57
|
+
@param slices The laid-out slices.
|
|
58
|
+
@param room The room the layout kept.
|
|
59
|
+
@param minWidth The least width the ring keeps.
|
|
60
|
+
*/ export function pieLabelRoom(viz, slices, room, minWidth) {
|
|
61
|
+
if (!pieMayLabelOutside(viz, slices)) return room;
|
|
62
|
+
const { outside } = pieLabelPlan(viz, slices);
|
|
63
|
+
if (!outside.length) return room;
|
|
64
|
+
const { width } = chartBounds(viz);
|
|
65
|
+
const metrics = outsideMetrics(outsideFontSize(userLabelConfig(viz, "Path")));
|
|
66
|
+
const cap = width * OUTSIDE_MAX_SHARE;
|
|
67
|
+
const need = outsideRoom(outside.map((c)=>({
|
|
68
|
+
angle: c.angle,
|
|
69
|
+
width: outsideClaim(c.width, c.wrapWidth, cap)
|
|
70
|
+
})).filter((c)=>c.width > 0), metrics);
|
|
71
|
+
const [left, right] = clampSides(Math.max(room.left, Math.ceil(need.left)), Math.max(room.right, Math.ceil(need.right)), width, minWidth);
|
|
72
|
+
return {
|
|
73
|
+
...room,
|
|
74
|
+
left,
|
|
75
|
+
right
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
The room to keep above and below the ring for the labels its columns
|
|
80
|
+
had no place for: each one's height, above the ring when its slice
|
|
81
|
+
faces up and below it when its slice faces down, added to `room`, then
|
|
82
|
+
scaled back so the ring keeps `minHeight` of the chart's `height`.
|
|
83
|
+
@param room The room the layout kept.
|
|
84
|
+
@param crowded The labels with no place.
|
|
85
|
+
@param height The chart area's height.
|
|
86
|
+
@param minHeight The least height the ring keeps.
|
|
87
|
+
*/ export function crowdedRoom(room, crowded, height, minHeight) {
|
|
88
|
+
let top = room.top;
|
|
89
|
+
let bottom = room.bottom;
|
|
90
|
+
for (const { angle, size } of crowded){
|
|
91
|
+
if (Math.cos(angle) >= 0) top += size;
|
|
92
|
+
else bottom += size;
|
|
93
|
+
}
|
|
94
|
+
[top, bottom] = clampSides(top, bottom, height, minHeight);
|
|
95
|
+
return {
|
|
96
|
+
...room,
|
|
97
|
+
top,
|
|
98
|
+
bottom
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
The room worth keeping once the labels are placed: a side where no
|
|
103
|
+
label was placed gives its room back to the ring.
|
|
104
|
+
@param room The room kept.
|
|
105
|
+
@param used Whether a label was placed on each side.
|
|
106
|
+
*/ export function usedRoom(room, used) {
|
|
107
|
+
return {
|
|
108
|
+
...room,
|
|
109
|
+
left: used.left ? room.left : 0,
|
|
110
|
+
right: used.right ? room.right : 0
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
/** Whether two rooms are the same. */ const sameRoom = (a, b)=>a.left === b.left && a.right === b.right && a.top === b.top && a.bottom === b.bottom;
|
|
114
|
+
/**
|
|
115
|
+
Lays the slices out, keeping room around the ring for the labels that
|
|
116
|
+
go outside it. Room beside the ring is grown twice at most (see
|
|
117
|
+
`pieLabelRoom`), since a smaller ring can send more labels outside; then
|
|
118
|
+
room above and below it is kept, once, for the labels the columns had
|
|
119
|
+
no place for (see `crowdedRoom`); last, a side whose labels couldn't be
|
|
120
|
+
placed gives its room back to the ring. The room only grows until that
|
|
121
|
+
last step, so the ring only shrinks, never below `min` (the ring's size
|
|
122
|
+
at `PIE_MIN_SCALE`).
|
|
123
|
+
@param viz The chart.
|
|
124
|
+
@param layout Lays the slices out with room kept around the ring.
|
|
125
|
+
@param min The least size the ring keeps.
|
|
126
|
+
*/ export function layoutWithLabelRoom(viz, layout, min) {
|
|
127
|
+
let room = NO_ROOM;
|
|
128
|
+
let slices = layout(room);
|
|
129
|
+
for(let pass = 0; pass < 2; pass++){
|
|
130
|
+
const next = pieLabelRoom(viz, slices, room, min.width);
|
|
131
|
+
if (sameRoom(next, room)) break;
|
|
132
|
+
room = next;
|
|
133
|
+
slices = layout(room);
|
|
134
|
+
}
|
|
135
|
+
if (!room.left && !room.right) return slices;
|
|
136
|
+
const { crowded } = pieOutsideLabels(viz, slices);
|
|
137
|
+
if (crowded.length) {
|
|
138
|
+
const next = crowdedRoom(room, crowded, chartBounds(viz).height, min.height);
|
|
139
|
+
if (!sameRoom(next, room)) {
|
|
140
|
+
room = next;
|
|
141
|
+
slices = layout(room);
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
const used = {
|
|
145
|
+
left: false,
|
|
146
|
+
right: false
|
|
147
|
+
};
|
|
148
|
+
for (const d of pieOutsideLabels(viz, slices).named){
|
|
149
|
+
const right = outsideSide((d.startAngle + d.endAngle) / 2) === 1;
|
|
150
|
+
used[right ? "right" : "left"] = true;
|
|
151
|
+
}
|
|
152
|
+
const kept = usedRoom(room, used);
|
|
153
|
+
return sameRoom(kept, room) ? slices : layout(kept);
|
|
154
|
+
}
|
|
@@ -0,0 +1,224 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure geometry for labels drawn outside a Pie or Donut's ring: which side
|
|
3
|
+
of the ring a slice's label takes, the room the labels need beside the
|
|
4
|
+
ring, how one side's labels stack without overlapping, and the leader
|
|
5
|
+
line that joins each label to its slice. Coordinates are relative to the
|
|
6
|
+
ring's center; angles are radians in d3's convention (0 at 12 o'clock,
|
|
7
|
+
increasing clockwise), so a point at angle `a` and radius `r` sits at
|
|
8
|
+
`(r·sin a, −r·cos a)`.
|
|
9
|
+
*/ import { spreadLabelPositions } from "../Plot/lineLabelSpread.js";
|
|
10
|
+
/** The label font size when the Path labelConfig sets none. */ export const OUTSIDE_LABEL_FONT_SIZE = 12;
|
|
11
|
+
/**
|
|
12
|
+
The metrics for labels at `fontSize`: a column line of 1.3em, and a
|
|
13
|
+
leader that runs out 10px, bends, and runs at least 8px across to a
|
|
14
|
+
label 4px past its end.
|
|
15
|
+
@param fontSize The label's font size.
|
|
16
|
+
*/ export function outsideMetrics(fontSize) {
|
|
17
|
+
return {
|
|
18
|
+
fontSize,
|
|
19
|
+
lineHeight: Math.ceil(fontSize * 1.3),
|
|
20
|
+
elbow: 10,
|
|
21
|
+
tail: 8,
|
|
22
|
+
gap: 4
|
|
23
|
+
};
|
|
24
|
+
}
|
|
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
|
+
*/ export function outsideSide(angle) {
|
|
31
|
+
return Math.sin(angle) >= -1e-9 ? 1 : -1;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
How far from the ring's center each side's leaders end, where the
|
|
35
|
+
labels' text starts (less `gap`): past the ring by the elbow and the
|
|
36
|
+
shortest horizontal run.
|
|
37
|
+
@param radius The ring's outer radius.
|
|
38
|
+
@param metrics The label metrics.
|
|
39
|
+
*/ export function outsideColumn(radius, metrics) {
|
|
40
|
+
return radius + metrics.elbow + metrics.tail;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
The room labels need beside the ring on each side: the widest label on
|
|
44
|
+
that side, plus its leader and gap, or 0 for a side without labels.
|
|
45
|
+
@param labels Each label's middle angle and text width.
|
|
46
|
+
@param metrics The label metrics.
|
|
47
|
+
*/ export function outsideRoom(labels, metrics) {
|
|
48
|
+
const room = {
|
|
49
|
+
left: 0,
|
|
50
|
+
right: 0
|
|
51
|
+
};
|
|
52
|
+
const leader = metrics.elbow + metrics.tail + metrics.gap;
|
|
53
|
+
for (const { angle, width } of labels){
|
|
54
|
+
const key = outsideSide(angle) === 1 ? "right" : "left";
|
|
55
|
+
room[key] = Math.max(room[key], width + leader);
|
|
56
|
+
}
|
|
57
|
+
return room;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
Stacks one side's labels so none overlap and all stay between `bounds`:
|
|
61
|
+
sorted by the height each would like, then spread as little as they
|
|
62
|
+
must (see `spreadLabelPositions`). While they don't all fit, or `fits`
|
|
63
|
+
rejects one where it lands, the label with the smallest weight is
|
|
64
|
+
dropped and the rest are stacked again. Returns the height of each
|
|
65
|
+
label's middle, or null for a dropped one.
|
|
66
|
+
@param items The labels.
|
|
67
|
+
@param bounds The top and bottom of the room they share.
|
|
68
|
+
@param fits Whether label `i` may sit at height `y`.
|
|
69
|
+
*/ export function stackOutsideLabels(items, bounds, fits = ()=>true) {
|
|
70
|
+
const out = items.map(()=>null);
|
|
71
|
+
const top = Math.min(...bounds);
|
|
72
|
+
const bottom = Math.max(...bounds);
|
|
73
|
+
let active = items.map((item, i)=>({
|
|
74
|
+
...item,
|
|
75
|
+
i
|
|
76
|
+
})).filter((d)=>d.size <= bottom - top).sort((a, b)=>a.y - b.y || a.i - b.i);
|
|
77
|
+
while(active.length){
|
|
78
|
+
// The column's centers run from the first label's half height below the
|
|
79
|
+
// top to the last label's half height above the bottom.
|
|
80
|
+
const first = active[0].size / 2;
|
|
81
|
+
const last = active[active.length - 1].size / 2;
|
|
82
|
+
const ys = spreadLabelPositions(active.map((d)=>d.y), active.map((d)=>d.size), [
|
|
83
|
+
top + first,
|
|
84
|
+
bottom - last
|
|
85
|
+
]);
|
|
86
|
+
const ok = ys.every((y, k)=>y + active[k].size / 2 <= bottom + 0.5 && fits(active[k].i, y));
|
|
87
|
+
if (ok) {
|
|
88
|
+
active.forEach((d, k)=>out[d.i] = ys[k]);
|
|
89
|
+
break;
|
|
90
|
+
}
|
|
91
|
+
const smallest = active.reduce((m, d)=>d.weight < m.weight || d.weight === m.weight && d.i > m.i ? d : m);
|
|
92
|
+
active = active.filter((d)=>d !== smallest);
|
|
93
|
+
}
|
|
94
|
+
return out;
|
|
95
|
+
}
|
|
96
|
+
/** The distance from the origin to the segment from `p` to `q`. */ export function segmentDistance(p, q) {
|
|
97
|
+
const dx = q[0] - p[0];
|
|
98
|
+
const dy = q[1] - p[1];
|
|
99
|
+
const len2 = dx * dx + dy * dy;
|
|
100
|
+
const t = len2 ? Math.max(0, Math.min(1, -(p[0] * dx + p[1] * dy) / len2)) : 0;
|
|
101
|
+
return Math.hypot(p[0] + t * dx, p[1] + t * dy);
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
The ways a leader can run from a slice to its label at height `y`, best
|
|
105
|
+
first. The first runs straight out from the middle of the slice's outer
|
|
106
|
+
edge by the elbow, across to the label's height, and level for the last
|
|
107
|
+
`tail` pixels into the label's column, when its run across keeps half an
|
|
108
|
+
elbow clear of the ring. The second leaves the ring leaning only as far
|
|
109
|
+
as it must to stay outside it, reaching the label's height before it
|
|
110
|
+
runs level into the column, when that is short of the column. Empty when
|
|
111
|
+
the label's height can't be reached without crossing the ring.
|
|
112
|
+
@param angle The slice's middle angle.
|
|
113
|
+
@param radius The ring's outer radius.
|
|
114
|
+
@param y The label's height.
|
|
115
|
+
@param metrics The label metrics.
|
|
116
|
+
*/ export function leaderRoutes(angle, radius, y, metrics) {
|
|
117
|
+
const side = outsideSide(angle);
|
|
118
|
+
const column = outsideColumn(radius, metrics);
|
|
119
|
+
const sin = Math.sin(angle);
|
|
120
|
+
const cos = Math.cos(angle);
|
|
121
|
+
const a = [
|
|
122
|
+
radius * sin,
|
|
123
|
+
-radius * cos
|
|
124
|
+
];
|
|
125
|
+
const end = [
|
|
126
|
+
side * column,
|
|
127
|
+
y
|
|
128
|
+
];
|
|
129
|
+
const knee = [
|
|
130
|
+
side * (column - metrics.tail),
|
|
131
|
+
y
|
|
132
|
+
];
|
|
133
|
+
const elbow = [
|
|
134
|
+
(radius + metrics.elbow) * sin,
|
|
135
|
+
-(radius + metrics.elbow) * cos
|
|
136
|
+
];
|
|
137
|
+
const routes = [];
|
|
138
|
+
if (segmentDistance(elbow, knee) >= radius + metrics.elbow / 2 - 1e-9) routes.push([
|
|
139
|
+
a,
|
|
140
|
+
elbow,
|
|
141
|
+
knee,
|
|
142
|
+
end
|
|
143
|
+
]);
|
|
144
|
+
// The run from the ring stays outside it while it heads away from the
|
|
145
|
+
// ring's center: (B − A) · A ≥ 0.
|
|
146
|
+
let bx = Math.abs(elbow[0]);
|
|
147
|
+
const need = radius * radius - a[1] * y;
|
|
148
|
+
const along = Math.abs(a[0]);
|
|
149
|
+
if (bx * along < need) bx = along < 1e-9 ? Infinity : need / along;
|
|
150
|
+
if (bx <= column - metrics.tail / 2 + 1e-9) {
|
|
151
|
+
const b = [
|
|
152
|
+
side * bx,
|
|
153
|
+
y
|
|
154
|
+
];
|
|
155
|
+
routes.push([
|
|
156
|
+
a,
|
|
157
|
+
[
|
|
158
|
+
(a[0] + b[0]) / 2,
|
|
159
|
+
(a[1] + b[1]) / 2
|
|
160
|
+
],
|
|
161
|
+
b,
|
|
162
|
+
end
|
|
163
|
+
]);
|
|
164
|
+
}
|
|
165
|
+
return routes;
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
The leader from a slice to its label at height `y`: the best of
|
|
169
|
+
`leaderRoutes`, or null when there is none.
|
|
170
|
+
@param angle The slice's middle angle.
|
|
171
|
+
@param radius The ring's outer radius.
|
|
172
|
+
@param y The label's height.
|
|
173
|
+
@param metrics The label metrics.
|
|
174
|
+
*/ export function leaderPoints(angle, radius, y, metrics) {
|
|
175
|
+
return leaderRoutes(angle, radius, y, metrics)[0] ?? null;
|
|
176
|
+
}
|
|
177
|
+
/**
|
|
178
|
+
Whether two polylines cross: some segment of one passes through some
|
|
179
|
+
segment of the other more than `tolerance` pixels from either segment's
|
|
180
|
+
ends (merely touching, or meeting where two leaders leave neighboring
|
|
181
|
+
slivers together, doesn't count).
|
|
182
|
+
@param a One polyline.
|
|
183
|
+
@param b The other.
|
|
184
|
+
@param tolerance How far from a segment's ends a crossing must be.
|
|
185
|
+
*/ export function polylinesCross(a, b, tolerance = 2) {
|
|
186
|
+
for(let i = 1; i < a.length; i++)for(let j = 1; j < b.length; j++){
|
|
187
|
+
const [p, q, r, s] = [
|
|
188
|
+
a[i - 1],
|
|
189
|
+
a[i],
|
|
190
|
+
b[j - 1],
|
|
191
|
+
b[j]
|
|
192
|
+
];
|
|
193
|
+
const d1 = [
|
|
194
|
+
q[0] - p[0],
|
|
195
|
+
q[1] - p[1]
|
|
196
|
+
];
|
|
197
|
+
const d2 = [
|
|
198
|
+
s[0] - r[0],
|
|
199
|
+
s[1] - r[1]
|
|
200
|
+
];
|
|
201
|
+
const denom = d1[0] * d2[1] - d1[1] * d2[0];
|
|
202
|
+
if (Math.abs(denom) < 1e-12) continue;
|
|
203
|
+
const e = [
|
|
204
|
+
r[0] - p[0],
|
|
205
|
+
r[1] - p[1]
|
|
206
|
+
];
|
|
207
|
+
const t = (e[0] * d2[1] - e[1] * d2[0]) / denom;
|
|
208
|
+
const u = (e[0] * d1[1] - e[1] * d1[0]) / denom;
|
|
209
|
+
const l1 = Math.hypot(...d1);
|
|
210
|
+
const l2 = Math.hypot(...d2);
|
|
211
|
+
const inside = (v, len)=>v * len > tolerance && (1 - v) * len > tolerance;
|
|
212
|
+
if (inside(t, l1) && inside(u, l2)) return true;
|
|
213
|
+
}
|
|
214
|
+
return false;
|
|
215
|
+
}
|
|
216
|
+
/**
|
|
217
|
+
The height a slice's label would like: level with the middle of the
|
|
218
|
+
slice's outer edge, pushed out by the leader's elbow.
|
|
219
|
+
@param angle The slice's middle angle.
|
|
220
|
+
@param radius The ring's outer radius.
|
|
221
|
+
@param metrics The label metrics.
|
|
222
|
+
*/ export function outsideIdealY(angle, radius, metrics) {
|
|
223
|
+
return -(radius + metrics.elbow) * Math.cos(angle);
|
|
224
|
+
}
|