@d3plus/core 4.9.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 +170 -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 +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 +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- 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 +17 -12
- 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/Funnel/index.js +2 -1
- 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/Gauge/index.js +2 -1
- 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 +60 -19
- 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 +37 -16
- 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/Matrix/index.js +3 -2
- 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 +93 -108
- 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 +7 -2
- 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 +66 -32
- 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/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- 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 +14 -4
- 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 +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- 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/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- 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 +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -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 +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- 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 +5 -5
- 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 +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- 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 +65 -30
- 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 +75 -77
- 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/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- 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/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- 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 +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- 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 +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- 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 +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- 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 +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- 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 +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- 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 +42 -15
- 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 +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- 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 +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- 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 +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- 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 +123 -0
- 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/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -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 +34 -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 +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -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 +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- 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 +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- 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 +67 -79
- 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/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -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 +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/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -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/Candlestick/aggregate.d.ts +6 -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/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -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 +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- 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 +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -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/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- 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/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -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/facet/facetData.d.ts +1 -1
- 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 +13 -1
- 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/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -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/features.d.ts +8 -0
- 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 +19 -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 +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- 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 +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -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/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- 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/missingFields.d.ts +57 -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/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -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 +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- 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/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -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 +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- 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/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -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 +2 -8
- 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/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -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 +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- 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,267 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scene nodes for a Pie or Donut's labels outside its ring (see
|
|
3
|
+
`labelPosition`): each label horizontal, in a column beside the ring on
|
|
4
|
+
the side its slice faces, joined to its slice by a thin leader. Both are
|
|
5
|
+
inert and hidden from screen readers (the slice's own aria-label names
|
|
6
|
+
it), and carry the slice's row, so they dim with it on hover.
|
|
7
|
+
*/ import TextBox from "../../components/TextBox.js";
|
|
8
|
+
import { chartBounds } from "../features/chartGeometry.js";
|
|
9
|
+
import { resolveAccessor, userLabelConfig } from "../features/emitHelpers.js";
|
|
10
|
+
import { ringLabelFont } from "../features/ringLabelNodes.js";
|
|
11
|
+
import { backgroundInk } from "../viz/backgroundInk.js";
|
|
12
|
+
import { leaderRoutes, outsideColumn, outsideIdealY, outsideMetrics, outsideSide, polylinesCross, stackOutsideLabels } from "./outsideLabels.js";
|
|
13
|
+
import { outsideFontSize, pieLabelPlan } from "./pieLabels.js";
|
|
14
|
+
/** The leader's opacity over the theme's ink. */ export const LEADER_OPACITY = 0.5;
|
|
15
|
+
/**
|
|
16
|
+
When an outside label and its leader fade in: over the second half of a
|
|
17
|
+
redraw, once the slices have mostly settled, so they don't fade in
|
|
18
|
+
where a label that is leaving still shows.
|
|
19
|
+
*/ export const OUTSIDE_ENTER = {
|
|
20
|
+
start: 0.5,
|
|
21
|
+
end: 1
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
The room beside the ring on each side, from where the labels' text
|
|
25
|
+
starts to the chart area's edge.
|
|
26
|
+
@param frame The ring and the chart area.
|
|
27
|
+
@param metrics The label metrics.
|
|
28
|
+
*/ export function outsideSpace(frame, metrics) {
|
|
29
|
+
const start = outsideColumn(frame.radius, metrics) + metrics.gap;
|
|
30
|
+
return {
|
|
31
|
+
left: frame.cx - start,
|
|
32
|
+
right: frame.width - frame.cx - start
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
Stacks the outside labels: each side's labels in a column beside the
|
|
37
|
+
ring, within the chart area's height, the smallest slices' labels
|
|
38
|
+
dropped when they don't all fit or a leader can't reach one (see
|
|
39
|
+
`stackOutsideLabels`). Each leader takes the best of its routes (see
|
|
40
|
+
`leaderRoutes`) that crosses no leader above it; when every route
|
|
41
|
+
crosses one, the side's smallest slice gives up its label and the side
|
|
42
|
+
is stacked again. Returns each label's placement, or null for a
|
|
43
|
+
dropped one.
|
|
44
|
+
@param labels The labels.
|
|
45
|
+
@param frame The ring and the chart area.
|
|
46
|
+
@param metrics The label metrics.
|
|
47
|
+
*/ export function placeOutsideLabels(labels, frame, metrics) {
|
|
48
|
+
const { radius, cy, height } = frame;
|
|
49
|
+
const out = labels.map(()=>null);
|
|
50
|
+
const reach = (k, y)=>leaderRoutes(labels[k].angle, radius, y, metrics);
|
|
51
|
+
for (const side of [
|
|
52
|
+
1,
|
|
53
|
+
-1
|
|
54
|
+
]){
|
|
55
|
+
let index = labels.map((l, k)=>outsideSide(l.angle) === side ? k : -1).filter((k)=>k >= 0);
|
|
56
|
+
while(index.length){
|
|
57
|
+
const ys = stackOutsideLabels(index.map((k)=>({
|
|
58
|
+
y: outsideIdealY(labels[k].angle, radius, metrics),
|
|
59
|
+
size: labels[k].lines * metrics.lineHeight,
|
|
60
|
+
weight: labels[k].weight
|
|
61
|
+
})), [
|
|
62
|
+
-cy,
|
|
63
|
+
height - cy
|
|
64
|
+
], (j, y)=>reach(index[j], y).length > 0);
|
|
65
|
+
const order = index.map((k, j)=>({
|
|
66
|
+
k,
|
|
67
|
+
y: ys[j]
|
|
68
|
+
})).filter((d)=>d.y !== null).sort((p, q)=>p.y - q.y);
|
|
69
|
+
const chosen = [];
|
|
70
|
+
let clash = false;
|
|
71
|
+
for (const { k, y } of order){
|
|
72
|
+
const leader = reach(k, y).find((r)=>chosen.every((c)=>!polylinesCross(r, c.leader)));
|
|
73
|
+
if (!leader) {
|
|
74
|
+
clash = true;
|
|
75
|
+
break;
|
|
76
|
+
}
|
|
77
|
+
chosen.push({
|
|
78
|
+
k,
|
|
79
|
+
y,
|
|
80
|
+
leader
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
if (!clash) {
|
|
84
|
+
for (const { k, y, leader } of chosen)out[k] = {
|
|
85
|
+
y,
|
|
86
|
+
leader
|
|
87
|
+
};
|
|
88
|
+
break;
|
|
89
|
+
}
|
|
90
|
+
const drop = index.reduce((m, k)=>labels[k].weight < labels[m].weight ? k : m);
|
|
91
|
+
index = index.filter((k)=>k !== drop);
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
return out;
|
|
95
|
+
}
|
|
96
|
+
/** Splits text into words at its spaces, so a label wraps between words and never mid-word. */ const splitWords = (text)=>text.match(/\S+\s*/g) ?? [];
|
|
97
|
+
/** Letters only, to compare a label's laid-out lines with its name. */ const letters = (text)=>text.replace(/[\s\u00ad\u2010-]/g, "");
|
|
98
|
+
/** The line height of the outside labels' text, as a multiple of its font size. */ const TEXT_LINE_HEIGHT = 1.2;
|
|
99
|
+
/**
|
|
100
|
+
Lays each outside label's text out in its side's room, wrapping between
|
|
101
|
+
words onto a second line when one is too narrow and dropping the share
|
|
102
|
+
when even two lines are. A label kept is one that shows its slice's
|
|
103
|
+
whole name within its room; it sits with its top at height 0.
|
|
104
|
+
*/ function layoutOutsideText(viz, candidates, frame, metrics) {
|
|
105
|
+
const labelConfig = userLabelConfig(viz, "Path");
|
|
106
|
+
const space = outsideSpace(frame, metrics);
|
|
107
|
+
const start = outsideColumn(frame.radius, metrics) + metrics.gap;
|
|
108
|
+
const right = (c)=>outsideSide(c.angle) === 1;
|
|
109
|
+
const roomOf = (c)=>right(c) ? space.right : space.left;
|
|
110
|
+
const fitting = candidates.filter((c)=>roomOf(c) >= metrics.fontSize * 3);
|
|
111
|
+
if (!fitting.length) return [];
|
|
112
|
+
const ink = backgroundInk(viz);
|
|
113
|
+
const box = new TextBox().renderMode("compute").locale(viz.schema.locale).data(fitting.map((c, k)=>({
|
|
114
|
+
id: `${k}`,
|
|
115
|
+
c
|
|
116
|
+
}))).config({
|
|
117
|
+
fontWeight: 400,
|
|
118
|
+
...ringLabelFont(labelConfig),
|
|
119
|
+
fontSize: metrics.fontSize,
|
|
120
|
+
lineHeight: metrics.fontSize * TEXT_LINE_HEIGHT,
|
|
121
|
+
fontColor: ({ c })=>{
|
|
122
|
+
const color = resolveAccessor(labelConfig.fontColor, c.slice.data, c.index);
|
|
123
|
+
return typeof color === "string" ? color : ink;
|
|
124
|
+
},
|
|
125
|
+
text: ({ c })=>c.text,
|
|
126
|
+
split: splitWords,
|
|
127
|
+
textAnchor: ({ c })=>right(c) ? "start" : "end",
|
|
128
|
+
maxLines: 2,
|
|
129
|
+
// A label whose share doesn't fit drops it whole, without an ellipsis.
|
|
130
|
+
ellipsis: (text)=>text,
|
|
131
|
+
padding: 0,
|
|
132
|
+
x: ({ c })=>right(c) ? start : -start - space.left,
|
|
133
|
+
y: 0,
|
|
134
|
+
width: ({ c })=>roomOf(c),
|
|
135
|
+
height: metrics.lineHeight * 2
|
|
136
|
+
});
|
|
137
|
+
return box.toScene().children.flatMap((node)=>{
|
|
138
|
+
const c = node.datum?.c;
|
|
139
|
+
if (!c || node.type !== "text" || !node.lines.length) return [];
|
|
140
|
+
const name = letters(viz._drawLabel(c.slice.data, c.index));
|
|
141
|
+
const room = roomOf(c) + 0.5;
|
|
142
|
+
const whole = letters(node.lines.map((l)=>l.text).join("")).startsWith(name) && node.lines.every((l)=>l.width <= room);
|
|
143
|
+
return whole ? [
|
|
144
|
+
{
|
|
145
|
+
c,
|
|
146
|
+
node
|
|
147
|
+
}
|
|
148
|
+
] : [];
|
|
149
|
+
});
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
The outside labels' scene nodes, the slices they name, and the labels
|
|
153
|
+
their columns had no place for (see `CrowdedLabel`): a leader and
|
|
154
|
+
a label per slice placed beside the ring (see `placeOutsideLabels`), in
|
|
155
|
+
the theme's ink unless the Path labelConfig's `fontColor` sets a color.
|
|
156
|
+
A label wider than its side's room wraps onto a second line, between
|
|
157
|
+
words, and drops its share when even that is too narrow; a label that
|
|
158
|
+
can't show its slice's whole name within its room is left out, so the
|
|
159
|
+
slice keeps its label inside the ring.
|
|
160
|
+
@param viz The chart.
|
|
161
|
+
@param candidates The slices whose labels go outside.
|
|
162
|
+
@param frame The ring and the chart area.
|
|
163
|
+
*/ export function pieOutsideNodes(viz, candidates, frame) {
|
|
164
|
+
const named = new Set();
|
|
165
|
+
const crowded = [];
|
|
166
|
+
const metrics = outsideMetrics(outsideFontSize(userLabelConfig(viz, "Path")));
|
|
167
|
+
const laid = layoutOutsideText(viz, candidates, frame, metrics);
|
|
168
|
+
if (!laid.length) return {
|
|
169
|
+
nodes: [],
|
|
170
|
+
named,
|
|
171
|
+
crowded
|
|
172
|
+
};
|
|
173
|
+
const placements = placeOutsideLabels(laid.map(({ c, node })=>({
|
|
174
|
+
angle: c.angle,
|
|
175
|
+
weight: c.weight,
|
|
176
|
+
lines: node.lines.length
|
|
177
|
+
})), frame, metrics);
|
|
178
|
+
const ink = backgroundInk(viz);
|
|
179
|
+
const lineHeight = metrics.fontSize * TEXT_LINE_HEIGHT;
|
|
180
|
+
const labels = [];
|
|
181
|
+
const leaders = [];
|
|
182
|
+
laid.forEach(({ c, node }, k)=>{
|
|
183
|
+
const placement = placements[k];
|
|
184
|
+
if (!placement) {
|
|
185
|
+
crowded.push({
|
|
186
|
+
angle: c.angle,
|
|
187
|
+
size: node.lines.length * metrics.lineHeight
|
|
188
|
+
});
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
named.add(c.slice);
|
|
192
|
+
const key = `pie-outside-${viz._ids(c.slice.data, c.index).join("-")}`;
|
|
193
|
+
const own = {
|
|
194
|
+
interactive: false,
|
|
195
|
+
datum: c.slice.data,
|
|
196
|
+
index: c.index,
|
|
197
|
+
aria: {
|
|
198
|
+
hidden: true
|
|
199
|
+
},
|
|
200
|
+
enterWindow: OUTSIDE_ENTER
|
|
201
|
+
};
|
|
202
|
+
const tr = node.transform ?? {};
|
|
203
|
+
labels.push({
|
|
204
|
+
...node,
|
|
205
|
+
...own,
|
|
206
|
+
key,
|
|
207
|
+
transform: {
|
|
208
|
+
...tr,
|
|
209
|
+
y: (tr.y ?? 0) + placement.y - node.lines.length * lineHeight / 2
|
|
210
|
+
},
|
|
211
|
+
paint: {
|
|
212
|
+
...node.paint,
|
|
213
|
+
opacity: 1
|
|
214
|
+
}
|
|
215
|
+
});
|
|
216
|
+
leaders.push({
|
|
217
|
+
type: "line",
|
|
218
|
+
key: `${key}-leader`,
|
|
219
|
+
...own,
|
|
220
|
+
points: placement.leader,
|
|
221
|
+
curve: "linear",
|
|
222
|
+
paint: {
|
|
223
|
+
fill: "none",
|
|
224
|
+
stroke: ink,
|
|
225
|
+
strokeWidth: 1,
|
|
226
|
+
strokeOpacity: LEADER_OPACITY,
|
|
227
|
+
opacity: 1
|
|
228
|
+
}
|
|
229
|
+
});
|
|
230
|
+
});
|
|
231
|
+
return {
|
|
232
|
+
nodes: [
|
|
233
|
+
...leaders,
|
|
234
|
+
...labels
|
|
235
|
+
],
|
|
236
|
+
named,
|
|
237
|
+
crowded
|
|
238
|
+
};
|
|
239
|
+
}
|
|
240
|
+
/** The outside labels each plan placed. */ const placedByPlan = new WeakMap();
|
|
241
|
+
/**
|
|
242
|
+
The outside labels for the current layout (see `pieOutsideNodes`), with
|
|
243
|
+
the ring and the chart area read from the layout `applyPieLayout` kept
|
|
244
|
+
on `viz.ctx`. Worked out once per layout.
|
|
245
|
+
@param viz The chart, laid out by `applyPieLayout`.
|
|
246
|
+
@param slices The laid-out slices.
|
|
247
|
+
*/ export function pieOutsideLabels(viz, slices) {
|
|
248
|
+
const plan = pieLabelPlan(viz, slices);
|
|
249
|
+
const cached = placedByPlan.get(plan);
|
|
250
|
+
if (cached) return cached;
|
|
251
|
+
const arcGen = viz.ctx.arcData;
|
|
252
|
+
const center = viz.ctx.pieCenter;
|
|
253
|
+
const { width, height } = chartBounds(viz);
|
|
254
|
+
const placed = slices.length ? pieOutsideNodes(viz, plan.outside, {
|
|
255
|
+
radius: arcGen.outerRadius()(slices[0], slices[0].i ?? 0),
|
|
256
|
+
cx: center?.x ?? width / 2,
|
|
257
|
+
cy: center?.y ?? height / 2,
|
|
258
|
+
width,
|
|
259
|
+
height
|
|
260
|
+
}) : {
|
|
261
|
+
nodes: [],
|
|
262
|
+
named: new Set(),
|
|
263
|
+
crowded: []
|
|
264
|
+
};
|
|
265
|
+
placedByPlan.set(plan, placed);
|
|
266
|
+
return placed;
|
|
267
|
+
}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Every label a Pie or Donut draws for its slices: the labels inside the
|
|
3
|
+
ring (straight or curved, see `curvedLabels.ts`), and which slices take
|
|
4
|
+
a label outside the ring instead (see `labelPosition`). The plan is
|
|
5
|
+
worked out once per layout and kept on the chart's context, so the
|
|
6
|
+
layout stage, which sizes the ring to leave room for the outside labels,
|
|
7
|
+
and the emit step share it.
|
|
8
|
+
*/ import { formatAbbreviate } from "@d3plus/format";
|
|
9
|
+
import { resolveAccessor, shapeConfigFor, userLabelConfig } from "../features/emitHelpers.js";
|
|
10
|
+
import { ringLabelFont, ringTextWidth } from "../features/ringLabelNodes.js";
|
|
11
|
+
import { ringLabelPosition } from "../features/ringLabels.js";
|
|
12
|
+
import { pieSliceLabels } from "./curvedLabels.js";
|
|
13
|
+
import { OUTSIDE_LABEL_FONT_SIZE } from "./outsideLabels.js";
|
|
14
|
+
import { pieStraightLabels } from "./straightLabels.js";
|
|
15
|
+
/**
|
|
16
|
+
The narrowest a text gets wrapped onto two lines between its words: the
|
|
17
|
+
wider of the two lines at the best break. A single word can't wrap, so
|
|
18
|
+
its width is its own.
|
|
19
|
+
@param text The text.
|
|
20
|
+
@param width A string's one-line width.
|
|
21
|
+
*/ export function twoLineWidth(text, width) {
|
|
22
|
+
const words = text.split(/\s+/).filter(Boolean);
|
|
23
|
+
let best = width(words.join(" "));
|
|
24
|
+
for(let k = 1; k < words.length; k++)best = Math.min(best, Math.max(width(words.slice(0, k).join(" ")), width(words.slice(k).join(" "))));
|
|
25
|
+
return best;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
Formats a slice's share as a percentage in the chart's locale.
|
|
29
|
+
@param viz The chart.
|
|
30
|
+
*/ export function pieSharePct(viz) {
|
|
31
|
+
const locale = viz.schema.locale;
|
|
32
|
+
return (d)=>`${formatAbbreviate((d.share ?? 0) * 100, locale)}%`;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
The outside labels' font size: the Path labelConfig's `fontSize`, else
|
|
36
|
+
`OUTSIDE_LABEL_FONT_SIZE`.
|
|
37
|
+
@param labelConfig The Path labelConfig.
|
|
38
|
+
*/ export function outsideFontSize(labelConfig) {
|
|
39
|
+
const size = labelConfig.fontSize;
|
|
40
|
+
return typeof size === "number" && size > 0 ? size : OUTSIDE_LABEL_FONT_SIZE;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
Whether a slice's `labelPosition` puts its label outside the ring:
|
|
44
|
+
always for `"outside"`, never for `"inside"` or `"along"`, and for
|
|
45
|
+
`"auto"` only when its label inside doesn't show its whole name.
|
|
46
|
+
@param position The slice's `labelPosition`.
|
|
47
|
+
@param shownWhole Whether its label inside shows its whole name.
|
|
48
|
+
*/ export function labelGoesOutside(position, shownWhole) {
|
|
49
|
+
if (position === "outside") return true;
|
|
50
|
+
if (position === "inside" || position === "along") return false;
|
|
51
|
+
return !shownWhole;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
Whether any slice's `labelPosition` may put its label outside the ring:
|
|
55
|
+
false when every one is `"inside"` or `"along"`.
|
|
56
|
+
@param viz The chart.
|
|
57
|
+
@param slices The laid-out slices.
|
|
58
|
+
*/ export function pieMayLabelOutside(viz, slices) {
|
|
59
|
+
return slices.some((d, k)=>{
|
|
60
|
+
const position = ringLabelPosition(viz, d.data, d.i ?? k);
|
|
61
|
+
return position !== "inside" && position !== "along";
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
Works out every slice's label for the current layout (`viz.ctx.arcData`):
|
|
66
|
+
the labels inside the ring, and the slices whose label goes outside it.
|
|
67
|
+
Kept on `viz.ctx`, so the same layout is only worked out once.
|
|
68
|
+
@param viz The chart, laid out by `applyPieLayout`.
|
|
69
|
+
@param slices The laid-out slices.
|
|
70
|
+
*/ export function pieLabelPlan(viz, slices) {
|
|
71
|
+
const arcGen = viz.ctx.arcData;
|
|
72
|
+
const cached = viz.ctx.pieLabelPlan;
|
|
73
|
+
if (cached && cached.arc === arcGen && cached.slices === slices) return cached.plan;
|
|
74
|
+
const resolveInnerRadius = arcGen.innerRadius();
|
|
75
|
+
const resolveOuterRadius = arcGen.outerRadius();
|
|
76
|
+
const sc = shapeConfigFor(viz, "Path");
|
|
77
|
+
const labelConfig = userLabelConfig(viz, "Path");
|
|
78
|
+
const sharePct = pieSharePct(viz);
|
|
79
|
+
const nameOf = (d)=>viz._drawLabel(d.data, d.i ?? 0);
|
|
80
|
+
const arcOf = (d)=>({
|
|
81
|
+
innerRadius: resolveInnerRadius(d, d.i ?? 0),
|
|
82
|
+
outerRadius: resolveOuterRadius(d, d.i ?? 0),
|
|
83
|
+
startAngle: d.startAngle,
|
|
84
|
+
endAngle: d.endAngle,
|
|
85
|
+
padAngle: d.padAngle
|
|
86
|
+
});
|
|
87
|
+
const inside = pieSliceLabels({
|
|
88
|
+
viz,
|
|
89
|
+
slices,
|
|
90
|
+
arcOf,
|
|
91
|
+
nameOf,
|
|
92
|
+
shareOf: sharePct,
|
|
93
|
+
fillOf: (d)=>resolveAccessor(sc.fill, d.data, d.i ?? 0),
|
|
94
|
+
straight: pieStraightLabels({
|
|
95
|
+
viz,
|
|
96
|
+
slices,
|
|
97
|
+
arcOf,
|
|
98
|
+
sc,
|
|
99
|
+
sharePct,
|
|
100
|
+
labelConfig
|
|
101
|
+
}),
|
|
102
|
+
labelConfig
|
|
103
|
+
});
|
|
104
|
+
const outside = [];
|
|
105
|
+
if (pieMayLabelOutside(viz, slices)) {
|
|
106
|
+
const font = ringLabelFont(labelConfig);
|
|
107
|
+
const fontSize = outsideFontSize(labelConfig);
|
|
108
|
+
slices.forEach((slice, k)=>{
|
|
109
|
+
const index = slice.i ?? k;
|
|
110
|
+
const name = nameOf(slice);
|
|
111
|
+
const position = ringLabelPosition(viz, slice.data, index);
|
|
112
|
+
if (!name || !labelGoesOutside(position, inside.whole.has(slice))) return;
|
|
113
|
+
const text = `${name} ${sharePct(slice)}`;
|
|
114
|
+
const measure = (t)=>ringTextWidth(t, font)(fontSize);
|
|
115
|
+
outside.push({
|
|
116
|
+
slice,
|
|
117
|
+
index,
|
|
118
|
+
angle: (slice.startAngle + slice.endAngle) / 2,
|
|
119
|
+
text,
|
|
120
|
+
width: measure(text),
|
|
121
|
+
wrapWidth: twoLineWidth(text, measure),
|
|
122
|
+
weight: slice.value
|
|
123
|
+
});
|
|
124
|
+
});
|
|
125
|
+
}
|
|
126
|
+
const plan = {
|
|
127
|
+
straight: inside.straight,
|
|
128
|
+
curved: inside.curved,
|
|
129
|
+
outside
|
|
130
|
+
};
|
|
131
|
+
viz.ctx.pieLabelPlan = {
|
|
132
|
+
arc: arcGen,
|
|
133
|
+
slices,
|
|
134
|
+
plan
|
|
135
|
+
};
|
|
136
|
+
return plan;
|
|
137
|
+
}
|
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Axis-aligned boxes centered on a ring segment's bisector: the line from
|
|
3
|
+
the ring's center through the middle of the segment. A box centered on
|
|
4
|
+
it reads as centered in its slice. Every box here is symmetric about its
|
|
5
|
+
center, so where it goes is a single number, the center's distance from
|
|
6
|
+
the ring's center along the bisector.
|
|
7
|
+
|
|
8
|
+
Angles are radians in d3-shape's convention (0 at 12 o'clock, increasing
|
|
9
|
+
clockwise), so a point at angle `a` and radius `r` sits at
|
|
10
|
+
`(r·sin a, −r·cos a)`.
|
|
11
|
+
*/ const TAU = Math.PI * 2;
|
|
12
|
+
const EPSILON = 1e-9;
|
|
13
|
+
/** The point at angle `a` on the unit circle. */ const unit = (a)=>[
|
|
14
|
+
Math.sin(a),
|
|
15
|
+
-Math.cos(a)
|
|
16
|
+
];
|
|
17
|
+
/**
|
|
18
|
+
Resolves a ring segment's edges, the way d3-shape's arc draws it: a
|
|
19
|
+
`padAngle` narrows a Pie wedge (no hole) by that angle, and offsets a
|
|
20
|
+
ring segment's sides by a constant gap (`padAngle` at the default pad
|
|
21
|
+
radius, `√(inner² + outer²)`). `padding` keeps a box that much further
|
|
22
|
+
inside every edge. A full turn has no sides; its bisector points up.
|
|
23
|
+
Null when the segment has no area.
|
|
24
|
+
@param arc The segment.
|
|
25
|
+
@param padding The room kept inside every edge, in pixels.
|
|
26
|
+
*/ export function sectorEdges(arc, padding = 0) {
|
|
27
|
+
let a0 = Math.min(arc.startAngle, arc.endAngle);
|
|
28
|
+
let a1 = Math.max(arc.startAngle, arc.endAngle);
|
|
29
|
+
const inner = arc.innerRadius > 0 ? arc.innerRadius + padding : 0;
|
|
30
|
+
const outer = arc.outerRadius - padding;
|
|
31
|
+
if (!(a1 - a0 > EPSILON) || !(outer > inner)) return null;
|
|
32
|
+
if (a1 - a0 >= TAU - 1e-6) return {
|
|
33
|
+
mid: 0,
|
|
34
|
+
dir: unit(0),
|
|
35
|
+
span: TAU,
|
|
36
|
+
inner,
|
|
37
|
+
outer,
|
|
38
|
+
sides: []
|
|
39
|
+
};
|
|
40
|
+
const half = (arc.padAngle ?? 0) / 2;
|
|
41
|
+
let gap = 0;
|
|
42
|
+
if (half > 0 && arc.innerRadius > 0) gap = Math.hypot(arc.innerRadius, arc.outerRadius) * Math.sin(half);
|
|
43
|
+
else if (half > 0) {
|
|
44
|
+
a0 += half;
|
|
45
|
+
a1 -= half;
|
|
46
|
+
}
|
|
47
|
+
const span = a1 - a0;
|
|
48
|
+
if (!(span > EPSILON)) return null;
|
|
49
|
+
const mid = (a0 + a1) / 2;
|
|
50
|
+
const offset = gap + padding;
|
|
51
|
+
const sides = [
|
|
52
|
+
{
|
|
53
|
+
normal: [
|
|
54
|
+
Math.cos(a0),
|
|
55
|
+
Math.sin(a0)
|
|
56
|
+
],
|
|
57
|
+
offset,
|
|
58
|
+
ray: unit(a0)
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
normal: [
|
|
62
|
+
-Math.cos(a1),
|
|
63
|
+
-Math.sin(a1)
|
|
64
|
+
],
|
|
65
|
+
offset,
|
|
66
|
+
ray: unit(a1)
|
|
67
|
+
}
|
|
68
|
+
];
|
|
69
|
+
return {
|
|
70
|
+
mid,
|
|
71
|
+
dir: unit(mid),
|
|
72
|
+
span,
|
|
73
|
+
inner,
|
|
74
|
+
outer,
|
|
75
|
+
sides
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
/** The least `t` at which a box of half-size `a`×`b` centered at `t·dir` clears a circle of radius `r` around the center. */ function clearInner(dir, a, b, r) {
|
|
79
|
+
if (!(r > 0)) return -Infinity;
|
|
80
|
+
const ux = Math.abs(dir[0]);
|
|
81
|
+
const uy = Math.abs(dir[1]);
|
|
82
|
+
const found = [];
|
|
83
|
+
// The nearest point is on the box's side facing the center…
|
|
84
|
+
if (ux > EPSILON) {
|
|
85
|
+
const t = (a + r) / ux;
|
|
86
|
+
if (t * uy <= b + EPSILON) found.push(t);
|
|
87
|
+
}
|
|
88
|
+
// …or on its top or bottom…
|
|
89
|
+
if (uy > EPSILON) {
|
|
90
|
+
const t = (b + r) / uy;
|
|
91
|
+
if (t * ux <= a + EPSILON) found.push(t);
|
|
92
|
+
}
|
|
93
|
+
// …or its corner nearest the center.
|
|
94
|
+
const k = a * ux + b * uy;
|
|
95
|
+
const disc = k * k - (a * a + b * b - r * r);
|
|
96
|
+
if (disc >= 0) {
|
|
97
|
+
const t = k + Math.sqrt(disc);
|
|
98
|
+
if (t * ux >= a - EPSILON && t * uy >= b - EPSILON) found.push(t);
|
|
99
|
+
}
|
|
100
|
+
return found.length ? Math.min(...found) : Infinity;
|
|
101
|
+
}
|
|
102
|
+
/** The least `t` at which a box of half-size `a`×`b` centered at `t·dir` sits inside `side`. */ function insideSide(side, dir, a, b) {
|
|
103
|
+
const [nx, ny] = side.normal;
|
|
104
|
+
const along = nx * dir[0] + ny * dir[1];
|
|
105
|
+
const need = side.offset + a * Math.abs(nx) + b * Math.abs(ny);
|
|
106
|
+
return along > EPSILON ? need / along : Infinity;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
The least `t` at which a box centered at `t·dir` keeps clear of a
|
|
110
|
+
segment's gap when the segment spans more than half a turn. The gap is
|
|
111
|
+
then a convex wedge, so the box clears it when one of the box's own
|
|
112
|
+
axes, or a side's normal, separates the two.
|
|
113
|
+
*/ function clearGap(edges, a, b) {
|
|
114
|
+
const { dir, sides, span } = edges;
|
|
115
|
+
let least = Math.min(...sides.map((s)=>insideSide(s, dir, a, b)));
|
|
116
|
+
// The gap's apex sits on the bisector, where the two sides meet.
|
|
117
|
+
const apex = sides[0].offset / Math.sin(span / 2);
|
|
118
|
+
const axes = [
|
|
119
|
+
[
|
|
120
|
+
1,
|
|
121
|
+
0
|
|
122
|
+
],
|
|
123
|
+
[
|
|
124
|
+
-1,
|
|
125
|
+
0
|
|
126
|
+
],
|
|
127
|
+
[
|
|
128
|
+
0,
|
|
129
|
+
1
|
|
130
|
+
],
|
|
131
|
+
[
|
|
132
|
+
0,
|
|
133
|
+
-1
|
|
134
|
+
]
|
|
135
|
+
];
|
|
136
|
+
for (const e of axes){
|
|
137
|
+
const dot = (p)=>e[0] * p[0] + e[1] * p[1];
|
|
138
|
+
// The gap reaches no further than its apex along `e` only when both of
|
|
139
|
+
// its edges run that way.
|
|
140
|
+
if (dot(sides[0].ray) < -EPSILON || dot(sides[1].ray) < -EPSILON) continue;
|
|
141
|
+
const reach = a * Math.abs(e[0]) + b * Math.abs(e[1]);
|
|
142
|
+
const toward = dot(dir);
|
|
143
|
+
const limit = apex * toward;
|
|
144
|
+
if (toward < -EPSILON) least = Math.min(least, (reach - limit) / -toward);
|
|
145
|
+
else if (reach <= limit + EPSILON) least = -Infinity;
|
|
146
|
+
}
|
|
147
|
+
return least;
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
The stretch of a segment's bisector where a `width`×`height` box can be
|
|
151
|
+
centered and stay inside the segment, as distances from the ring's
|
|
152
|
+
center: from `lo` to `hi`. For a whole disc it runs through the center,
|
|
153
|
+
from `-hi` to `hi`. Null when the box fits nowhere along it.
|
|
154
|
+
@param edges The segment's edges (see `sectorEdges`).
|
|
155
|
+
@param width The box's width.
|
|
156
|
+
@param height The box's height.
|
|
157
|
+
*/ export function sectorBoxRange(edges, width, height) {
|
|
158
|
+
const a = width / 2;
|
|
159
|
+
const b = height / 2;
|
|
160
|
+
const { dir, inner, outer, sides, span } = edges;
|
|
161
|
+
const ux = Math.abs(dir[0]);
|
|
162
|
+
const uy = Math.abs(dir[1]);
|
|
163
|
+
// The corner furthest from the center reaches the outer edge at `hi`.
|
|
164
|
+
const k = a * ux + b * uy;
|
|
165
|
+
const disc = k * k - (a * a + b * b - outer * outer);
|
|
166
|
+
if (a * a + b * b > outer * outer || disc < 0) return null;
|
|
167
|
+
const hi = -k + Math.sqrt(disc);
|
|
168
|
+
if (!sides.length && !(inner > 0)) return {
|
|
169
|
+
lo: -hi,
|
|
170
|
+
hi
|
|
171
|
+
};
|
|
172
|
+
let lo = Math.max(0, clearInner(dir, a, b, inner));
|
|
173
|
+
if (sides.length) lo = Math.max(lo, span > Math.PI ? clearGap(edges, a, b) : Math.max(...sides.map((s)=>insideSide(s, dir, a, b))));
|
|
174
|
+
return lo <= hi + EPSILON ? {
|
|
175
|
+
lo,
|
|
176
|
+
hi: Math.max(lo, hi)
|
|
177
|
+
} : null;
|
|
178
|
+
}
|
|
179
|
+
/**
|
|
180
|
+
The box of the given size centered on the bisector at distance `t`.
|
|
181
|
+
@param edges The segment's edges.
|
|
182
|
+
@param t The center's distance from the ring's center.
|
|
183
|
+
@param width The box's width.
|
|
184
|
+
@param height The box's height.
|
|
185
|
+
*/ export function sectorBoxAt(edges, t, width, height) {
|
|
186
|
+
return {
|
|
187
|
+
x: t * edges.dir[0] - width / 2,
|
|
188
|
+
y: t * edges.dir[1] - height / 2,
|
|
189
|
+
width,
|
|
190
|
+
height
|
|
191
|
+
};
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
A `width`×`height` box centered on a segment's bisector, halfway along
|
|
195
|
+
the stretch where it fits (see `sectorBoxRange`), so the room around it
|
|
196
|
+
is shared out evenly. Null when it fits nowhere.
|
|
197
|
+
@param edges The segment's edges.
|
|
198
|
+
@param width The box's width.
|
|
199
|
+
@param height The box's height.
|
|
200
|
+
*/ export function centeredSectorBox(edges, width, height) {
|
|
201
|
+
const range = sectorBoxRange(edges, width, height);
|
|
202
|
+
if (!range) return null;
|
|
203
|
+
return sectorBoxAt(edges, (range.lo + range.hi) / 2, width, height);
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
The largest box of a given shape centered on a segment's bisector, at
|
|
207
|
+
the one place along it where that box fits. The scale is searched from
|
|
208
|
+
0 up to the ring's diameter.
|
|
209
|
+
@param edges The segment's edges.
|
|
210
|
+
@param size The box's width and height at a scale, growing with it.
|
|
211
|
+
@param iterations How finely the scale is searched.
|
|
212
|
+
*/ export function largestSectorBox(edges, size, iterations = 40) {
|
|
213
|
+
const fits = (s)=>sectorBoxRange(edges, ...size(s)) !== null;
|
|
214
|
+
let lo = 0;
|
|
215
|
+
let hi = edges.outer * 2;
|
|
216
|
+
if (!fits(lo)) return null;
|
|
217
|
+
for(let n = 0; n < iterations; n++){
|
|
218
|
+
const s = (lo + hi) / 2;
|
|
219
|
+
if (fits(s)) lo = s;
|
|
220
|
+
else hi = s;
|
|
221
|
+
}
|
|
222
|
+
return lo > 0 ? centeredSectorBox(edges, ...size(lo)) : null;
|
|
223
|
+
}
|