@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,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Cluster names on a Network: each cluster's name (see `clusters.ts`)
|
|
3
|
+
written inside the hull of its nodes, at the open spot nearest the
|
|
4
|
+
cluster's middle, clear of every node, every node label beside its node,
|
|
5
|
+
and the other names. A name shrinks to fit, down to `fontMin`, and a
|
|
6
|
+
cluster with no room for it goes unnamed. Names are inert to the pointer
|
|
7
|
+
and keyboard, in the chart's ink over a halo of its background.
|
|
8
|
+
*/
|
|
9
|
+
import type { Bounds } from "@d3plus/math";
|
|
10
|
+
import type { SceneNode } from "@d3plus/render";
|
|
11
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
12
|
+
type Point = [number, number];
|
|
13
|
+
/** `clusterConfig.labelConfig`'s defaults. */
|
|
14
|
+
export declare const CLUSTER_LABEL_DEFAULTS: {
|
|
15
|
+
fontMax: number;
|
|
16
|
+
fontMin: number;
|
|
17
|
+
padding: number;
|
|
18
|
+
};
|
|
19
|
+
/** The resolved `clusterConfig.labelConfig`, or null when names stay off the chart. */
|
|
20
|
+
export interface ClusterLabelSettings {
|
|
21
|
+
fontMax: number;
|
|
22
|
+
fontMin: number;
|
|
23
|
+
padding: number;
|
|
24
|
+
/** The rest, as TextBox config (fontColor, fontFamily, fontWeight, …). */
|
|
25
|
+
text: Record<string, unknown>;
|
|
26
|
+
}
|
|
27
|
+
/** Reads `clusterConfig.labelConfig`, with its defaults for anything missing or invalid. */
|
|
28
|
+
export declare function clusterLabelSettings(viz: VizInstance): ClusterLabelSettings | null;
|
|
29
|
+
/** A circle a name keeps clear of. */
|
|
30
|
+
export interface ClusterLabelCircle {
|
|
31
|
+
x: number;
|
|
32
|
+
y: number;
|
|
33
|
+
r: number;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
A grid of buckets over the circles and boxes names keep clear of, so a
|
|
37
|
+
test only checks the obstacles near it. `add` puts a placed name in.
|
|
38
|
+
*/
|
|
39
|
+
export declare function clusterLabelObstacles(circles: readonly ClusterLabelCircle[], boxes: readonly Bounds[], cell?: number): {
|
|
40
|
+
hits: (box: Bounds) => boolean;
|
|
41
|
+
add: (box: Bounds) => void;
|
|
42
|
+
};
|
|
43
|
+
/**
|
|
44
|
+
The nearest of `points` to a position, found ring by ring through a grid
|
|
45
|
+
of `cell`-pixel buckets, or undefined when there are none.
|
|
46
|
+
*/
|
|
47
|
+
export declare function nearestPoint<T extends {
|
|
48
|
+
x: number;
|
|
49
|
+
y: number;
|
|
50
|
+
}>(points: readonly T[], cell?: number): (x: number, y: number) => T | undefined;
|
|
51
|
+
/**
|
|
52
|
+
The spot for a `width` × `height` box inside the convex `hull` whose
|
|
53
|
+
middle is nearest `target`, among a grid of middles at most `step`
|
|
54
|
+
pixels apart, where `blocked` is false; or null when there is none.
|
|
55
|
+
`blocked` receives the box grown by `padding`. A box is inside when
|
|
56
|
+
`polygonContains` holds at its four corners; the spots of a grid row
|
|
57
|
+
share their corners' rows, so each row's edge crossings are found once.
|
|
58
|
+
*/
|
|
59
|
+
export declare function placeClusterLabel(hull: readonly Point[], size: {
|
|
60
|
+
width: number;
|
|
61
|
+
height: number;
|
|
62
|
+
}, target: Point, blocked: (box: Bounds) => boolean, padding?: number, step?: number): Bounds | null;
|
|
63
|
+
/** A laid-out node, as Network's emitter holds it. */
|
|
64
|
+
interface ClusterNode {
|
|
65
|
+
id: string;
|
|
66
|
+
x: number;
|
|
67
|
+
y: number;
|
|
68
|
+
r: number;
|
|
69
|
+
shape?: string;
|
|
70
|
+
width?: number;
|
|
71
|
+
height?: number;
|
|
72
|
+
}
|
|
73
|
+
/** A placed name: its text, font size, and box. */
|
|
74
|
+
export interface ClusterLabel {
|
|
75
|
+
key: string;
|
|
76
|
+
text: string;
|
|
77
|
+
fontSize: number;
|
|
78
|
+
box: Bounds;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
Where a cluster's name may go: the convex hull around its nodes, grown
|
|
82
|
+
by `margin` past each node's edge, and the members' mean position.
|
|
83
|
+
*/
|
|
84
|
+
export declare function clusterRegion(members: readonly ClusterLabelCircle[], margin: number): {
|
|
85
|
+
hull: Point[];
|
|
86
|
+
target: Point;
|
|
87
|
+
} | null;
|
|
88
|
+
/**
|
|
89
|
+
Places each cluster's name (largest cluster first) in its region (see
|
|
90
|
+
`clusterRegion`, grown by `fontMax`), at the open spot nearest its
|
|
91
|
+
middle whose ends and middle all lie nearer one of its own nodes than
|
|
92
|
+
any other node, at the largest font size from `fontMax` down to
|
|
93
|
+
`fontMin` that finds one. A cluster with fewer than three drawn nodes
|
|
94
|
+
goes unnamed.
|
|
95
|
+
@param besides The boxes of node labels drawn beside their nodes.
|
|
96
|
+
*/
|
|
97
|
+
export declare function layoutClusterLabels(viz: VizInstance, nodes: readonly ClusterNode[], besides: readonly Bounds[]): ClusterLabel[];
|
|
98
|
+
/** The placed names as text nodes, inert, in the chart's ink over a halo of its background. */
|
|
99
|
+
export declare function emitClusterLabels(viz: VizInstance, labels: readonly ClusterLabel[]): SceneNode[];
|
|
100
|
+
/**
|
|
101
|
+
Network's cluster names, as text nodes, and the boxes they cover (which
|
|
102
|
+
link labels keep clear of).
|
|
103
|
+
@param placed Each node's label placement; those beside a node are obstacles.
|
|
104
|
+
*/
|
|
105
|
+
export declare function networkClusterLabels(viz: VizInstance, nodes: readonly ClusterNode[], placed: ReadonlyMap<unknown, {
|
|
106
|
+
position: string;
|
|
107
|
+
box?: Bounds;
|
|
108
|
+
}>): {
|
|
109
|
+
scene: SceneNode[];
|
|
110
|
+
boxes: Bounds[];
|
|
111
|
+
};
|
|
112
|
+
export {};
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Cluster colors for the node-link charts (Network, ArcDiagram): when the
|
|
3
|
+
chart's color is left to its defaults, each node takes the color of the
|
|
4
|
+
community `louvain` finds it in, named after the community's
|
|
5
|
+
most-connected node, so the legend lists the clusters.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { ConfigField } from "../../fluent.js";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { GraphLink, GraphNode } from "./graph.js";
|
|
11
|
+
type Comparator = (a: DataPoint, b: DataPoint) => number;
|
|
12
|
+
/** A cluster's index, name, members, and most-connected node. */
|
|
13
|
+
export interface ClusterInfo {
|
|
14
|
+
/** 0 is the largest cluster. */
|
|
15
|
+
index: number;
|
|
16
|
+
name: string;
|
|
17
|
+
/** The members' node ids. */
|
|
18
|
+
ids: string[];
|
|
19
|
+
/** The id of the member with the most links. */
|
|
20
|
+
hub: string;
|
|
21
|
+
}
|
|
22
|
+
/** What the chart's clusters are, for its color accessor and its labels. */
|
|
23
|
+
export interface ClusterState {
|
|
24
|
+
/** Whether nodes are colored by cluster in this draw. */
|
|
25
|
+
active: boolean;
|
|
26
|
+
/** Each node id's color value: its cluster's name, or its own label when it is in no cluster. */
|
|
27
|
+
names: Map<string, string>;
|
|
28
|
+
/** The clusters of two or more nodes, largest first (ties by name). */
|
|
29
|
+
clusters: ClusterInfo[];
|
|
30
|
+
}
|
|
31
|
+
/** The `cluster` and `clusterConfig` fields. */
|
|
32
|
+
export declare function clusterFields(): ConfigField[];
|
|
33
|
+
/** The `color` and `shapeConfig.fill` the chart started with. */
|
|
34
|
+
export interface ClusterDefaults {
|
|
35
|
+
color: unknown;
|
|
36
|
+
fill: unknown;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
Whether nodes are colored by cluster: `cluster` is on, and the chart's
|
|
40
|
+
colors are its defaults (no `colorScale`, no `colorOrdinal`, the
|
|
41
|
+
starting `color` and `shapeConfig.fill`, and no fill on the Circle or
|
|
42
|
+
Rect shape config), with a single `groupBy` level.
|
|
43
|
+
@param schema The chart's config.
|
|
44
|
+
@param defaults The `color` and `shapeConfig.fill` the chart started with.
|
|
45
|
+
*/
|
|
46
|
+
export declare function clusterAutoActive(schema: Record<string, unknown>, defaults: ClusterDefaults): boolean;
|
|
47
|
+
/**
|
|
48
|
+
The clusters `louvain` finds among the nodes, as lists of node ids,
|
|
49
|
+
largest first, weighted by each link's `linkSize` value (1 when it isn't
|
|
50
|
+
a positive number). Links from a node to itself are left out.
|
|
51
|
+
*/
|
|
52
|
+
export declare function findClusters(nodes: Pick<GraphNode, "id">[], links: Pick<GraphLink, "source" | "target" | "size">[]): string[][];
|
|
53
|
+
/**
|
|
54
|
+
Whether clusters say more than one color per node would: at least two
|
|
55
|
+
clusters of two or more nodes. One cluster holding every linked node
|
|
56
|
+
(or no links at all) leaves each node its own color.
|
|
57
|
+
*/
|
|
58
|
+
export declare function clustersMeaningful(clusters: string[][]): boolean;
|
|
59
|
+
/** The most clusters `clusterConfig.max` keeps by default. */
|
|
60
|
+
export declare const CLUSTER_MAX = 12;
|
|
61
|
+
/**
|
|
62
|
+
Keeps at most `max` clusters of two or more nodes (lone nodes are left
|
|
63
|
+
as they are). While there are more, the smallest (the last listed of the
|
|
64
|
+
smallest) joins the cluster it shares the most link weight with (ties go
|
|
65
|
+
to the larger cluster, then the one listed first), or the largest
|
|
66
|
+
cluster when it has no links to any other. Returns the clusters largest
|
|
67
|
+
first (ties in their listed order), lone nodes last.
|
|
68
|
+
@param clusters Node id lists, largest first (see `findClusters`).
|
|
69
|
+
@param max The most clusters to keep; anything below 1 keeps them all.
|
|
70
|
+
*/
|
|
71
|
+
export declare function capClusters(clusters: string[][], links: Pick<GraphLink, "source" | "target" | "size">[], max: number): string[][];
|
|
72
|
+
/**
|
|
73
|
+
Each cluster's most-connected node: the member with the most links to
|
|
74
|
+
other nodes, then the greatest total `size`, then the first listed.
|
|
75
|
+
*/
|
|
76
|
+
export declare function clusterHubs(clusters: string[][], links: Pick<GraphLink, "source" | "target" | "size">[]): string[];
|
|
77
|
+
/**
|
|
78
|
+
A cluster's default name: the translated "{node} cluster" with its hub's
|
|
79
|
+
label in place of `{node}`.
|
|
80
|
+
*/
|
|
81
|
+
export declare function clusterName(translate: (s: string) => string, label: string): string;
|
|
82
|
+
/**
|
|
83
|
+
The legend's rows: one per cluster, its members' rows merged, and one
|
|
84
|
+
per node in no cluster. A key holding each member's own id (such as
|
|
85
|
+
`id`) is kept as the list of member ids, not merged by value, so the row
|
|
86
|
+
still names every member even when the ids are numbers.
|
|
87
|
+
*/
|
|
88
|
+
export declare function clusterLegendRows(viz: VizInstance, clusters: ClusterInfo[], nodes: GraphNode[]): DataPoint[];
|
|
89
|
+
/**
|
|
90
|
+
Works out this draw's clusters onto `viz.ctx.clusterState`: inactive
|
|
91
|
+
unless `clusterAutoActive` holds and the clusters are meaningful. While
|
|
92
|
+
active, the legend lists every node's row (so a network with `nodes` and
|
|
93
|
+
no `data` gets one), and the clusters claim the palette largest first.
|
|
94
|
+
*/
|
|
95
|
+
export declare function prepareClusters(viz: VizInstance): void;
|
|
96
|
+
/**
|
|
97
|
+
The cluster a row's node (or every node of a merged row) belongs to, or
|
|
98
|
+
undefined when clusters are off or the row's nodes differ.
|
|
99
|
+
*/
|
|
100
|
+
export declare function clusterOf(viz: VizInstance, d: DataPoint, i: number): string | undefined;
|
|
101
|
+
/**
|
|
102
|
+
The legend order: while clusters are active, the clusters largest first
|
|
103
|
+
(the order they take the palette in), then any lone nodes by `base`;
|
|
104
|
+
otherwise `base`.
|
|
105
|
+
*/
|
|
106
|
+
export declare function clusterLegendSort(viz: VizInstance, base: Comparator): Comparator;
|
|
107
|
+
/**
|
|
108
|
+
Installs cluster colors on a Network or ArcDiagram: `color` becomes an
|
|
109
|
+
accessor returning a node's cluster name while clusters are active (and
|
|
110
|
+
the default `groupBy` color otherwise), `legendSort` lists the clusters
|
|
111
|
+
largest first (see `clusterLegendSort`), and `_preDraw` works out the
|
|
112
|
+
clusters before the legend is laid out.
|
|
113
|
+
*/
|
|
114
|
+
export declare function installClusters(viz: VizInstance): void;
|
|
115
|
+
export {};
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Node and link resolution shared by the node-link charts (Network,
|
|
3
|
+
ArcDiagram): merges `data` onto `nodes` by id, and resolves each link's
|
|
4
|
+
`source`/`target` (an index into `nodes`, a node object, or an id string)
|
|
5
|
+
to its node record.
|
|
6
|
+
*/
|
|
7
|
+
import type { SimulationNodeDatum } from "d3-force";
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { LinkDatum, LinkEnd } from "../features/linkInteraction.js";
|
|
11
|
+
import type { SelfLoopGeometry } from "../features/selfLoops.js";
|
|
12
|
+
/** One resolved node: its merged row, its `nodes` entry, and its sizing inputs. */
|
|
13
|
+
export interface GraphNode extends SimulationNodeDatum {
|
|
14
|
+
__d3plus__: true;
|
|
15
|
+
/** The `data` row for this node, or its `nodes` entry when no row matches. */
|
|
16
|
+
data: DataPoint;
|
|
17
|
+
i: number;
|
|
18
|
+
id: string;
|
|
19
|
+
fx: number;
|
|
20
|
+
fy: number;
|
|
21
|
+
/** The node's entry in `nodes`. */
|
|
22
|
+
node: DataPoint;
|
|
23
|
+
/** The node's raw `size` value (or `sizeMin` when unsized), before scaling. */
|
|
24
|
+
r: number;
|
|
25
|
+
shape: string;
|
|
26
|
+
width?: number;
|
|
27
|
+
height?: number;
|
|
28
|
+
}
|
|
29
|
+
/** One resolved link: its endpoints' node records and its raw `linkSize` value. */
|
|
30
|
+
export interface GraphLink {
|
|
31
|
+
source: GraphNode;
|
|
32
|
+
target: GraphNode;
|
|
33
|
+
size: number;
|
|
34
|
+
/** The datum the link is drawn with, when both its ends resolve (see `makeLinkDatum`). */
|
|
35
|
+
datum?: LinkDatum;
|
|
36
|
+
/** The loop a link from a node to itself draws as, once laid out. */
|
|
37
|
+
loop?: SelfLoopGeometry;
|
|
38
|
+
/** The link's bundled path, from its source to its target (see `linkBundle`). */
|
|
39
|
+
points?: [number, number][];
|
|
40
|
+
}
|
|
41
|
+
/** A node record as a link end. */
|
|
42
|
+
export declare const graphLinkEnd: (n: GraphNode) => LinkEnd;
|
|
43
|
+
/** A node row's id: its `groupBy` id, else its `nodeGroupBy` id at the drawn depth. */
|
|
44
|
+
export declare function graphNodeId(viz: VizInstance, d: Record<string, unknown>, i: number): string;
|
|
45
|
+
/**
|
|
46
|
+
Resolves the filtered data and `nodes` into node records, in the order the
|
|
47
|
+
ids first appear (data rows, then nodes). Only ids present in `nodes`
|
|
48
|
+
become nodes; a matching data row supplies a node's values. `fx`/`fy` read
|
|
49
|
+
the chart's `x`/`y` accessors when it has them.
|
|
50
|
+
*/
|
|
51
|
+
export declare function resolveGraphNodes(v: VizInstance): GraphNode[];
|
|
52
|
+
/**
|
|
53
|
+
Resolves `links` against `nodes`, index-aligned with `links`: an endpoint
|
|
54
|
+
that matches no node is undefined. A link whose ends both resolve gets its
|
|
55
|
+
datum, which `linkSize` receives (with the link's index). Stashes the id → node lookup on
|
|
56
|
+
`v.ctx.nodeLookup` and the id → neighbor nodes lookup on
|
|
57
|
+
`v.ctx.linkLookup` (a link from a node to itself adds no neighbor).
|
|
58
|
+
*/
|
|
59
|
+
export declare function resolveGraphLinks(v: VizInstance, nodes: GraphNode[]): GraphLink[];
|
|
60
|
+
/**
|
|
61
|
+
Zooms to a node-space extent. Node coordinates sit under the chart's
|
|
62
|
+
margin-origin transform and the current zoom, so they're mapped to their
|
|
63
|
+
on-screen position first — the space `_zoomToBounds` expects.
|
|
64
|
+
*/
|
|
65
|
+
export declare function zoomToNodeBounds(viz: VizInstance, xDomain: number[], yDomain: number[]): void;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The per-instance fluent methods every node-link chart (Network,
|
|
3
|
+
ArcDiagram) installs in its `setup`: `links`, `nodes`, `nodeGroupBy`,
|
|
4
|
+
`size`, and `hover`. They need imperative bodies (queue loading, `aggs`
|
|
5
|
+
side effects), so they are installed per instance rather than as fields.
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
9
|
+
type Predicate = boolean | ((d: DataPoint, i: number) => boolean);
|
|
10
|
+
/** The fluent methods `installGraphFluent` adds. */
|
|
11
|
+
export type GraphFluent = {
|
|
12
|
+
hover: (predicate?: Predicate) => unknown;
|
|
13
|
+
links: (data?: DataPoint[], formatter?: unknown) => unknown;
|
|
14
|
+
nodes: (data?: DataPoint[], formatter?: unknown) => unknown;
|
|
15
|
+
nodeGroupBy: (keys?: unknown) => unknown;
|
|
16
|
+
size: (value?: unknown) => unknown;
|
|
17
|
+
};
|
|
18
|
+
/** Installs `links`, `nodes`, `nodeGroupBy`, `size`, and `hover` on a node-link chart. */
|
|
19
|
+
export declare function installGraphFluent(v: VizInstance & GraphFluent): void;
|
|
20
|
+
export {};
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The closest pair of Network nodes, which caps the largest node radius.
|
|
3
|
+
|
|
4
|
+
@module
|
|
5
|
+
*/
|
|
6
|
+
/** A positioned node; a missing coordinate counts as 0. */
|
|
7
|
+
export interface PositionedNode {
|
|
8
|
+
x?: number;
|
|
9
|
+
y?: number;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
The smallest `pointDistance` between two different nodes, or undefined
|
|
13
|
+
when no pair has one (fewer than two nodes, or none with a numeric
|
|
14
|
+
position). Distances that aren't numbers are skipped, as `d3.min` skips
|
|
15
|
+
them. Sorts the nodes by x and sweeps, skipping pairs further apart in x
|
|
16
|
+
than the closest pair found so far.
|
|
17
|
+
*/
|
|
18
|
+
export declare function minNodeDistance(nodes: readonly PositionedNode[]): number | undefined;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A `polygonContains` for one polygon tested at many points that share
|
|
3
|
+
rows: the edge crossings along each row are found once.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
type Point = [number, number];
|
|
8
|
+
/** A polygon's edge crossings by row, and the test they answer. */
|
|
9
|
+
export interface PolygonRows {
|
|
10
|
+
/** Whether `point` lies inside, as `polygonContains(polygon, point)`. */
|
|
11
|
+
contains: (point: Point) => boolean;
|
|
12
|
+
/** Where the polygon's edges cross the row at `y` (see `insideRow`). */
|
|
13
|
+
row: (y: number) => number[];
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
Whether `x` lies inside a polygon along a row whose edge crossings are
|
|
17
|
+
`xs`: d3-polygon's ray cast, toggling at each crossing past `x`.
|
|
18
|
+
*/
|
|
19
|
+
export declare function insideRow(xs: readonly number[], x: number): boolean;
|
|
20
|
+
/**
|
|
21
|
+
Tests points against `polygon` with d3-polygon's `polygonContains` rule
|
|
22
|
+
(a ray cast along the point's row, toggling at each edge it crosses).
|
|
23
|
+
The crossings are worked out with the same arithmetic, so each answer
|
|
24
|
+
equals `polygonContains(polygon, point)`; they are kept per row, so the
|
|
25
|
+
points of a grid cost one pass over the edges per row instead of per
|
|
26
|
+
point.
|
|
27
|
+
*/
|
|
28
|
+
export declare function polygonRows(polygon: readonly Point[]): PolygonRows;
|
|
29
|
+
export {};
|
|
@@ -1,8 +1,36 @@
|
|
|
1
1
|
/**
|
|
2
2
|
`applyPieLayout` — Pie's chart-specific layout stage. Runs the d3-shape
|
|
3
|
-
pie layout against `viz._filteredData
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
pie layout against `viz._filteredData` over the configured sweep, fits the
|
|
4
|
+
ring's footprint to the chart area, tags each slice with `__d3plus__` +
|
|
5
|
+
index, builds the arc generator from the current schema values, and
|
|
6
|
+
stores `pieData`/`arcData`/`pieSweep`/`pieCenter`/`pieBox` on `viz.ctx`.
|
|
6
7
|
*/
|
|
7
8
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
import type { PieSweep } from "./arcFit.js";
|
|
11
|
+
import type { PieRoom } from "./labelRoom.js";
|
|
12
|
+
import type { PieSlice } from "./pieLabels.js";
|
|
13
|
+
/** Pie's resolved sweep, from its `startAngle` and `endAngle` settings. */
|
|
14
|
+
export declare function pieSweepOf(viz: VizInstance): PieSweep;
|
|
15
|
+
/**
|
|
16
|
+
The outer radius a hole-less ring of this Pie's sweep gets in the chart
|
|
17
|
+
area, before any room is kept for the hover stroke. Donut's default
|
|
18
|
+
`innerRadius` is half of it.
|
|
19
|
+
*/
|
|
20
|
+
export declare function pieBaseRadius(viz: VizInstance): number;
|
|
21
|
+
/** The width/height ratio of this Pie's hole-less footprint: 1 for a full circle, 2 for a half ring. */
|
|
22
|
+
export declare function pieAspect(viz: VizInstance): number;
|
|
23
|
+
/**
|
|
24
|
+
Lays the slices out with `room` kept around the ring for labels outside
|
|
25
|
+
it: the ring fits the chart area less that room, its inner radius shrinks
|
|
26
|
+
with it, and it sits within the room left. Stores the layout on
|
|
27
|
+
`viz.ctx` (see `applyPieLayout`) and returns the slices.
|
|
28
|
+
@param viz The chart.
|
|
29
|
+
@param room The room kept on each side.
|
|
30
|
+
*/
|
|
31
|
+
export declare function pieRingLayout(viz: VizInstance, room?: PieRoom): PieSlice[];
|
|
32
|
+
/**
|
|
33
|
+
Lays the slices out, keeping room around the ring for the labels that
|
|
34
|
+
go outside it (see `layoutWithLabelRoom`).
|
|
35
|
+
*/
|
|
8
36
|
export declare const applyPieLayout: TransformStage;
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure geometry for a Pie's sweep: the angular range its slices fill, the
|
|
3
|
+
bounding box of the ring they draw, and where that ring sits in the chart
|
|
4
|
+
area. Angles are radians in d3's convention (0 at 12 o'clock, increasing
|
|
5
|
+
clockwise), so a point at angle `a` and radius `r` sits at
|
|
6
|
+
`(r·sin a, −r·cos a)`.
|
|
7
|
+
*/
|
|
8
|
+
/** The angular range a Pie's slices fill, in radians. `end` may be less than `start` (a counter-clockwise sweep). */
|
|
9
|
+
export interface PieSweep {
|
|
10
|
+
start: number;
|
|
11
|
+
end: number;
|
|
12
|
+
}
|
|
13
|
+
/** An axis-aligned box around the ring's center. */
|
|
14
|
+
export interface ArcBox {
|
|
15
|
+
x0: number;
|
|
16
|
+
x1: number;
|
|
17
|
+
y0: number;
|
|
18
|
+
y1: number;
|
|
19
|
+
}
|
|
20
|
+
/** Where the ring sits in the chart area, how large it is, and its footprint in pixels around its center. */
|
|
21
|
+
export interface RingFit {
|
|
22
|
+
cx: number;
|
|
23
|
+
cy: number;
|
|
24
|
+
radius: number;
|
|
25
|
+
box: ArcBox;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
Resolves the `startAngle` and `endAngle` settings (degrees clockwise from
|
|
29
|
+
12 o'clock) to a sweep in radians. An unset `endAngle` makes a full turn
|
|
30
|
+
from `startAngle`, and the sweep never exceeds one turn in either direction.
|
|
31
|
+
*/
|
|
32
|
+
export declare function pieSweep(startAngle: unknown, endAngle: unknown): PieSweep;
|
|
33
|
+
/** Whether a sweep goes all the way around. */
|
|
34
|
+
export declare function isFullTurn(start: number, end: number): boolean;
|
|
35
|
+
/** Where `angle` falls within the sweep, from 0 at its start to 1 at its end, wrapping around the circle. */
|
|
36
|
+
export declare function sweepFraction(angle: number, sweep: PieSweep): number;
|
|
37
|
+
/**
|
|
38
|
+
The bounding box of a ring's slice from `start` to `end`, in units of its
|
|
39
|
+
outer radius: the outer arc's ends, every 12, 3, 6 and 9 o'clock extreme
|
|
40
|
+
it passes, and the inner arc's ends at `inner` (a fraction of the outer
|
|
41
|
+
radius; 0 puts them at the center).
|
|
42
|
+
*/
|
|
43
|
+
export declare function ringExtent(start: number, end: number, inner?: number): ArcBox;
|
|
44
|
+
/**
|
|
45
|
+
Fits a ring sweeping from `start` to `end` (radians) into `width` ×
|
|
46
|
+
`height`, inset by `pad` on every side: the largest outer radius at which
|
|
47
|
+
the ring's own footprint fits, with an inner radius of `innerRadius`
|
|
48
|
+
pixels. The footprint is centered in any room left over.
|
|
49
|
+
*/
|
|
50
|
+
export declare function fitRing(width: number, height: number, start: number, end: number, innerRadius?: number, pad?: number): RingFit;
|
|
51
|
+
/**
|
|
52
|
+
The size a ring sweeping from `start` to `end` needs for an outer radius
|
|
53
|
+
of `radius`, inset by `pad` on every side (the inverse of `fitRing`, for
|
|
54
|
+
a ring without a hole).
|
|
55
|
+
@param radius The outer radius.
|
|
56
|
+
@param start Where the sweep starts.
|
|
57
|
+
@param end Where it ends.
|
|
58
|
+
@param pad The inset on each side.
|
|
59
|
+
*/
|
|
60
|
+
export declare function ringSizeFor(radius: number, start: number, end: number, pad?: number): {
|
|
61
|
+
width: number;
|
|
62
|
+
height: number;
|
|
63
|
+
};
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import type { DataPoint } from "@d3plus/data";
|
|
2
|
+
import type { SceneNode } from "@d3plus/render";
|
|
3
|
+
import type { RingArc } from "../features/ringLabels.js";
|
|
4
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
5
|
+
/** A laid-out slice, as `pieEmit` sees it. */
|
|
6
|
+
export interface PieLabelSlice {
|
|
7
|
+
data: DataPoint;
|
|
8
|
+
i?: number;
|
|
9
|
+
}
|
|
10
|
+
/** What placing the curved labels needs from `pieEmit`. */
|
|
11
|
+
export interface PieCurvedInputs<S extends PieLabelSlice> {
|
|
12
|
+
viz: VizInstance;
|
|
13
|
+
slices: S[];
|
|
14
|
+
/** Each slice's ring segment. */
|
|
15
|
+
arcOf: (slice: S) => RingArc;
|
|
16
|
+
/** Each slice's name. */
|
|
17
|
+
nameOf: (slice: S) => string;
|
|
18
|
+
/** Each slice's share, as text. */
|
|
19
|
+
shareOf: (slice: S) => string;
|
|
20
|
+
/** Each slice's fill. */
|
|
21
|
+
fillOf: (slice: S) => unknown;
|
|
22
|
+
/** The straight labels, as `emitLabels` drew them. */
|
|
23
|
+
straight: SceneNode[];
|
|
24
|
+
/** The Path shape's labelConfig. */
|
|
25
|
+
labelConfig: Record<string, unknown>;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
The font range curved labels try: the labelConfig's `fontSize` alone,
|
|
29
|
+
else `fontMin` to `fontMax`, 8 to 24 by default.
|
|
30
|
+
@param config The labelConfig.
|
|
31
|
+
*/
|
|
32
|
+
export declare function ringFontRange(config: Record<string, unknown>): {
|
|
33
|
+
fontMin: number;
|
|
34
|
+
fontMax: number;
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
Whether laid-out lines show all of `text`: every letter, in order, with
|
|
38
|
+
nothing cut short. A word hyphenated across two lines still counts as
|
|
39
|
+
shown whole.
|
|
40
|
+
@param lines The laid-out lines' text.
|
|
41
|
+
@param text The label's text.
|
|
42
|
+
*/
|
|
43
|
+
export declare function textShownWhole(lines: string[], text: string): boolean;
|
|
44
|
+
/** The labels for every slice, and which slices they name in full. */
|
|
45
|
+
export interface PieSliceLabelNodes<S> {
|
|
46
|
+
straight: SceneNode[];
|
|
47
|
+
curved: SceneNode[];
|
|
48
|
+
/** The slices whose label shows their whole name. */
|
|
49
|
+
whole: Set<S>;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
The labels for every slice: each slice's straight label (from
|
|
53
|
+
`straight`) or its curved one, whichever its `labelPosition` and the fit
|
|
54
|
+
choose (see `chooseRingLabel`).
|
|
55
|
+
@param inputs The slices and their geometry, fills, and straight labels.
|
|
56
|
+
*/
|
|
57
|
+
export declare function pieSliceLabels<S extends PieLabelSlice>(inputs: PieCurvedInputs<S>): PieSliceLabelNodes<S>;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
2
|
+
import type { CrowdedLabel } from "./outsideNodes.js";
|
|
3
|
+
import type { PieSlice } from "./pieLabels.js";
|
|
4
|
+
/** The smallest a ring shrinks to make room for labels outside it, as a share of its full radius. */
|
|
5
|
+
export declare const PIE_MIN_SCALE = 0.6;
|
|
6
|
+
/** The most room a single label claims beside the ring, as a share of the chart's width; a longer label wraps. */
|
|
7
|
+
export declare const OUTSIDE_MAX_SHARE = 0.3;
|
|
8
|
+
/** The room kept on each side of the ring, in pixels. */
|
|
9
|
+
export interface PieRoom {
|
|
10
|
+
left: number;
|
|
11
|
+
right: number;
|
|
12
|
+
top: number;
|
|
13
|
+
bottom: number;
|
|
14
|
+
}
|
|
15
|
+
/** No room kept. */
|
|
16
|
+
export declare const NO_ROOM: PieRoom;
|
|
17
|
+
/**
|
|
18
|
+
Scales the room on two opposite sides down, keeping their proportions,
|
|
19
|
+
so the ring keeps at least `min` of the chart's `size` between them.
|
|
20
|
+
@param a The room on one side.
|
|
21
|
+
@param b The room on the other.
|
|
22
|
+
@param size The chart area's size across both.
|
|
23
|
+
@param min The least the ring keeps.
|
|
24
|
+
*/
|
|
25
|
+
export declare function clampSides(a: number, b: number, size: number, min: number): [number, number];
|
|
26
|
+
/**
|
|
27
|
+
The width a label claims beside the ring: its own when it is at most
|
|
28
|
+
`cap`, else the narrowest it wraps onto two lines when that is, else
|
|
29
|
+
none (it is drawn only where the room happens to hold it).
|
|
30
|
+
@param width The label's one-line width.
|
|
31
|
+
@param wrapWidth The narrowest it wraps onto two lines.
|
|
32
|
+
@param cap The most a label claims.
|
|
33
|
+
*/
|
|
34
|
+
export declare function outsideClaim(width: number, wrapWidth: number, cap: number): number;
|
|
35
|
+
/**
|
|
36
|
+
The room to keep beside the ring at the current layout: `room`, grown
|
|
37
|
+
on each side to fit that side's widest label outside the ring (see
|
|
38
|
+
`outsideClaim`; a label claims at most `OUTSIDE_MAX_SHARE` of the
|
|
39
|
+
chart's width), then scaled back so the ring keeps `minWidth`.
|
|
40
|
+
@param viz The chart, laid out with `room`.
|
|
41
|
+
@param slices The laid-out slices.
|
|
42
|
+
@param room The room the layout kept.
|
|
43
|
+
@param minWidth The least width the ring keeps.
|
|
44
|
+
*/
|
|
45
|
+
export declare function pieLabelRoom(viz: VizInstance, slices: PieSlice[], room: PieRoom, minWidth: number): PieRoom;
|
|
46
|
+
/**
|
|
47
|
+
The room to keep above and below the ring for the labels its columns
|
|
48
|
+
had no place for: each one's height, above the ring when its slice
|
|
49
|
+
faces up and below it when its slice faces down, added to `room`, then
|
|
50
|
+
scaled back so the ring keeps `minHeight` of the chart's `height`.
|
|
51
|
+
@param room The room the layout kept.
|
|
52
|
+
@param crowded The labels with no place.
|
|
53
|
+
@param height The chart area's height.
|
|
54
|
+
@param minHeight The least height the ring keeps.
|
|
55
|
+
*/
|
|
56
|
+
export declare function crowdedRoom(room: PieRoom, crowded: CrowdedLabel[], height: number, minHeight: number): PieRoom;
|
|
57
|
+
/**
|
|
58
|
+
The room worth keeping once the labels are placed: a side where no
|
|
59
|
+
label was placed gives its room back to the ring.
|
|
60
|
+
@param room The room kept.
|
|
61
|
+
@param used Whether a label was placed on each side.
|
|
62
|
+
*/
|
|
63
|
+
export declare function usedRoom(room: PieRoom, used: {
|
|
64
|
+
left: boolean;
|
|
65
|
+
right: boolean;
|
|
66
|
+
}): PieRoom;
|
|
67
|
+
/**
|
|
68
|
+
Lays the slices out, keeping room around the ring for the labels that
|
|
69
|
+
go outside it. Room beside the ring is grown twice at most (see
|
|
70
|
+
`pieLabelRoom`), since a smaller ring can send more labels outside; then
|
|
71
|
+
room above and below it is kept, once, for the labels the columns had
|
|
72
|
+
no place for (see `crowdedRoom`); last, a side whose labels couldn't be
|
|
73
|
+
placed gives its room back to the ring. The room only grows until that
|
|
74
|
+
last step, so the ring only shrinks, never below `min` (the ring's size
|
|
75
|
+
at `PIE_MIN_SCALE`).
|
|
76
|
+
@param viz The chart.
|
|
77
|
+
@param layout Lays the slices out with room kept around the ring.
|
|
78
|
+
@param min The least size the ring keeps.
|
|
79
|
+
*/
|
|
80
|
+
export declare function layoutWithLabelRoom(viz: VizInstance, layout: (room: PieRoom) => PieSlice[], min: {
|
|
81
|
+
width: number;
|
|
82
|
+
height: number;
|
|
83
|
+
}): PieSlice[];
|