@d3plus/core 4.10.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +167 -8
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +3 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +2 -1
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +86 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +5 -1
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +64 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +8 -2
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +18 -10
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +34 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +2 -2
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -35
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +2 -3
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +16 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +3 -7
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +61 -28
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +72 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +10 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +8 -1
- package/es/src/charts/events/mousemove.shape.js +5 -2
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +2 -1
- package/es/src/charts/features/axesFinal.js +3 -1
- package/es/src/charts/features/axesMeasure.js +7 -4
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +2 -1
- package/es/src/charts/features/colorScaleHover.js +3 -2
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +20 -6
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +38 -11
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +47 -31
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +2 -2
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +39 -36
- package/es/src/charts/viz/VizBase.js +18 -10
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -3
- package/es/src/charts/viz/vizDefaults.js +15 -23
- package/es/src/charts/viz/vizFields.js +35 -0
- package/es/src/charts/viz/vizRender.js +43 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +6 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +5 -9
- package/es/src/components/Axis/axisLayoutScale.js +7 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +15 -9
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +29 -65
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +7 -3
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +25 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +250 -8
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +15 -8
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +16 -2
- package/types/src/charts/viz/VizBase.d.ts +6 -6
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +32 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +84 -7
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +1 -0
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +981 -30
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +86811 -61031
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +28392 -6498
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin — a Plot of 2D binned density: raw observations on two continuous
|
|
3
|
+
axes, grouped into hexagons (or squares) of a fixed pixel size and
|
|
4
|
+
colored by how many each holds, with optional density contours.
|
|
5
|
+
*/
|
|
6
|
+
import type { ChartDefinition } from "../definition/ChartDefinition.js";
|
|
7
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
8
|
+
/**
|
|
9
|
+
Keeps the rows with numeric x and y as the chart's data; the rest are
|
|
10
|
+
skipped. The user's rows stay the chart's source data.
|
|
11
|
+
*/
|
|
12
|
+
export declare function keepNumericRows(viz: VizInstance): void;
|
|
13
|
+
export declare const hexbinDef: ChartDefinition;
|
|
14
|
+
/**
|
|
15
|
+
Creates a 2D binned density chart from raw observations: each row is a
|
|
16
|
+
point at its `x` and `y` values (rows without numeric values are
|
|
17
|
+
skipped), and the points are grouped into hexagons (`binShape`) of
|
|
18
|
+
`binSize` pixels, colored on the colorScale by how many each holds (or by
|
|
19
|
+
`binValue`). Empty bins aren't drawn. `contours` adds density contours,
|
|
20
|
+
and `points` draws the observations beneath. `groupBy` names the
|
|
21
|
+
observations for `filter` and the legend (off by default), and `facet`
|
|
22
|
+
bins each panel on its own, on one shared colorScale.
|
|
23
|
+
*/
|
|
24
|
+
declare const _default: new () => any;
|
|
25
|
+
export default _default;
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's per-draw state and the rows its emitter draws: bins and contour
|
|
3
|
+
levels measured from points in pixel space, and the rows the colorScale
|
|
4
|
+
is laid out from (estimated before the plot area is known, then measured
|
|
5
|
+
against it).
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/
|
|
9
|
+
import type { DataPoint } from "@d3plus/data";
|
|
10
|
+
import type { ShapeEmitContext } from "../features/shapeEmit.js";
|
|
11
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
12
|
+
import { type PixelBin, type PixelPoint } from "./binning.js";
|
|
13
|
+
import { type HexbinSettings } from "./settings.js";
|
|
14
|
+
/** The plot area in shape coordinates. */
|
|
15
|
+
export interface PlotFrame {
|
|
16
|
+
left: number;
|
|
17
|
+
top: number;
|
|
18
|
+
width: number;
|
|
19
|
+
height: number;
|
|
20
|
+
}
|
|
21
|
+
/** Per-instance state kept on `viz.ctx.hexbin`. */
|
|
22
|
+
export interface HexbinState {
|
|
23
|
+
/** The user's rows. */
|
|
24
|
+
raw: DataPoint[];
|
|
25
|
+
/** The rows with numeric x and y last written to `viz._data`. */
|
|
26
|
+
rows: DataPoint[];
|
|
27
|
+
/** The smallest x and y observed, where the bin grid is anchored. */
|
|
28
|
+
anchor?: [number, number];
|
|
29
|
+
/** Each small-multiples panel's observations, for the shared colorScale. */
|
|
30
|
+
panels?: DataPoint[][];
|
|
31
|
+
/** The colorScale's rows, once this draw's paint has measured them. */
|
|
32
|
+
colorRows?: DataPoint[];
|
|
33
|
+
}
|
|
34
|
+
/** A Hexbin's state. */
|
|
35
|
+
export declare function hexbinState(viz: VizInstance): HexbinState;
|
|
36
|
+
/** Whether a value is a finite number. */
|
|
37
|
+
export declare const isNumeric: (v: unknown) => v is number;
|
|
38
|
+
/** The plot area an emitter draws in. */
|
|
39
|
+
export declare function plotFrame(ctx: Pick<ShapeEmitContext, "xRange" | "yRange" | "x2Height">): PlotFrame;
|
|
40
|
+
/**
|
|
41
|
+
One row per bin, measured: its count and value, its bounds in data units
|
|
42
|
+
(through `invert`), and its outline. Bins whose value isn't a number (a
|
|
43
|
+
`mean` with nothing to average) are left out.
|
|
44
|
+
*/
|
|
45
|
+
export declare function binRows(bins: PixelBin[], settings: Pick<HexbinSettings, "shape" | "size" | "agg">, invert: {
|
|
46
|
+
x: (px: number) => number;
|
|
47
|
+
y: (px: number) => number;
|
|
48
|
+
}): DataPoint[];
|
|
49
|
+
/**
|
|
50
|
+
One row per contour level, lowest first. Levels are in points per bin, so
|
|
51
|
+
they share the bins' color scale; a `mean` measure contours the points'
|
|
52
|
+
density, unweighted.
|
|
53
|
+
*/
|
|
54
|
+
export declare function contourRows(points: PixelPoint[], frame: PlotFrame, settings: Pick<HexbinSettings, "shape" | "size" | "agg" | "contourConfig">): DataPoint[];
|
|
55
|
+
/** The bins that reach into the plot area: the ones a zoomed view shows. */
|
|
56
|
+
export declare function binsInView(bins: PixelBin[], frame: PlotFrame, settings: Pick<HexbinSettings, "shape" | "size">): PixelBin[];
|
|
57
|
+
/** The points as one path of `r`-pixel dots. */
|
|
58
|
+
export declare function pointPath(points: PixelPoint[], r: number): string;
|
|
59
|
+
/**
|
|
60
|
+
The rows the colorScale reads for some points: their bins in view, or
|
|
61
|
+
with no bins drawn, their contour levels.
|
|
62
|
+
*/
|
|
63
|
+
export declare function colorRows(points: PixelPoint[], frame: PlotFrame, origin: [number, number], settings: HexbinSettings): DataPoint[];
|
|
64
|
+
/**
|
|
65
|
+
Notes what the emitter needs from the whole chart before a draw: where
|
|
66
|
+
the bin grid is anchored, and with small multiples, every panel's rows.
|
|
67
|
+
The colorScale rows measured by the last draw are dropped.
|
|
68
|
+
*/
|
|
69
|
+
export declare function noteDrawRows(viz: VizInstance): void;
|
|
70
|
+
/**
|
|
71
|
+
The colorScale's rows for a panel's paint: the rows it measured, or with
|
|
72
|
+
small multiples, every panel's, binned at this panel's scale so all of
|
|
73
|
+
them share one colorScale.
|
|
74
|
+
*/
|
|
75
|
+
export declare function sharedColorRows(ctx: ShapeEmitContext, own: DataPoint[], frame: PlotFrame, origin: [number, number], settings: HexbinSettings): DataPoint[];
|
|
76
|
+
/**
|
|
77
|
+
The rows the colorScale lays out from: those this draw's paint measured,
|
|
78
|
+
or before the paint, an estimate (see `estimatedColorRows`).
|
|
79
|
+
*/
|
|
80
|
+
export declare function colorScaleRows(viz: VizInstance): DataPoint[];
|
|
81
|
+
/**
|
|
82
|
+
The colorScale's rows before the plot area is known (only its margin
|
|
83
|
+
depends on them): the observations measured in a plot area estimated
|
|
84
|
+
from the chart's size. The emitter refreshes the colorScale with the
|
|
85
|
+
rows it measures.
|
|
86
|
+
*/
|
|
87
|
+
export declare function estimatedColorRows(viz: VizInstance, settings: HexbinSettings): DataPoint[];
|
|
88
|
+
/**
|
|
89
|
+
Lays the colorScale out again with `rows`, in the frame it already
|
|
90
|
+
claimed, so its scale (which the bins' fills read) spans what's drawn.
|
|
91
|
+
The rows are kept for any later layout of the colorScale in this draw
|
|
92
|
+
(see `colorScaleRows`).
|
|
93
|
+
*/
|
|
94
|
+
export declare function refreshColorScale(viz: VizInstance, rows: DataPoint[]): void;
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's resolved options and the rows it draws: one row per bin or
|
|
3
|
+
contour level, each carrying what it measures under `HEXBIN_META`.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
9
|
+
import type { BinAgg, BinShape } from "./binning.js";
|
|
10
|
+
/** The shape key Hexbin's observations, bins and contours draw under. */
|
|
11
|
+
export declare const HEXBIN_SHAPE = "Hexbin";
|
|
12
|
+
/** The key a bin or contour row keeps its measure under. */
|
|
13
|
+
export declare const HEXBIN_META = "__d3plusHexbin";
|
|
14
|
+
/** What a bin row carries. */
|
|
15
|
+
export interface BinMeta {
|
|
16
|
+
kind: "bin";
|
|
17
|
+
/** How many observations the bin holds. */
|
|
18
|
+
count: number;
|
|
19
|
+
/** What the bin measures: its count, or the sum or mean of `binValue`. */
|
|
20
|
+
value: number;
|
|
21
|
+
/** The bin's bounds in data units. */
|
|
22
|
+
x0: number;
|
|
23
|
+
x1: number;
|
|
24
|
+
y0: number;
|
|
25
|
+
y1: number;
|
|
26
|
+
/** The bin's outline, in pixels. */
|
|
27
|
+
path: string;
|
|
28
|
+
/** The observations in the bin. */
|
|
29
|
+
rows: DataPoint[];
|
|
30
|
+
}
|
|
31
|
+
/** What a contour row carries. */
|
|
32
|
+
export interface ContourMeta {
|
|
33
|
+
kind: "contour";
|
|
34
|
+
/** The density level, in points per bin. */
|
|
35
|
+
level: number;
|
|
36
|
+
/** The next level up, if any: the region's density runs from `level` to it. */
|
|
37
|
+
next?: number;
|
|
38
|
+
/** The level's position, lowest first, and how many levels there are. */
|
|
39
|
+
index: number;
|
|
40
|
+
levels: number;
|
|
41
|
+
path: string;
|
|
42
|
+
}
|
|
43
|
+
export type HexbinMeta = BinMeta | ContourMeta;
|
|
44
|
+
/** The `binValue` option: a count, or a field aggregated per bin. */
|
|
45
|
+
export type BinValueOption = "count" | {
|
|
46
|
+
value: string | ((d: DataPoint, i: number) => unknown);
|
|
47
|
+
agg?: "sum" | "mean";
|
|
48
|
+
label?: string;
|
|
49
|
+
};
|
|
50
|
+
/** The `contours` option. */
|
|
51
|
+
export type ContoursOption = boolean | "lines" | "filled";
|
|
52
|
+
/** The `contourConfig` option. */
|
|
53
|
+
export interface ContourConfig {
|
|
54
|
+
bandwidth?: number;
|
|
55
|
+
thresholds?: number | number[];
|
|
56
|
+
strokeWidth?: number;
|
|
57
|
+
fillOpacity?: number;
|
|
58
|
+
/** Writes each level's value along its contour lines. */
|
|
59
|
+
labels?: boolean;
|
|
60
|
+
/** TextBox config for the level labels, such as `fontSize` or `fontWeight`. */
|
|
61
|
+
labelConfig?: Record<string, unknown>;
|
|
62
|
+
/**
|
|
63
|
+
The least distance between two labels along one contour line, in
|
|
64
|
+
pixels. `"auto"` (the default) takes 20 ems or half the plot's mean
|
|
65
|
+
side, whichever is longer.
|
|
66
|
+
*/
|
|
67
|
+
labelSpacing?: number | "auto";
|
|
68
|
+
/**
|
|
69
|
+
Labels every n-th level: `1` labels them all, `2` every other one
|
|
70
|
+
(the multiples of twice the levels' spacing), and so on. `"auto"`
|
|
71
|
+
(the default) labels all of up to five levels, and every other one
|
|
72
|
+
of more.
|
|
73
|
+
*/
|
|
74
|
+
labelStep?: number | "auto";
|
|
75
|
+
}
|
|
76
|
+
/** The `pointConfig` option. */
|
|
77
|
+
export interface PointConfig {
|
|
78
|
+
r?: number;
|
|
79
|
+
fill?: string;
|
|
80
|
+
fillOpacity?: number;
|
|
81
|
+
}
|
|
82
|
+
/** Hexbin's options, resolved for a draw. */
|
|
83
|
+
export interface HexbinSettings {
|
|
84
|
+
shape: BinShape | false;
|
|
85
|
+
size: number;
|
|
86
|
+
agg: BinAgg;
|
|
87
|
+
/** What `sum`/`mean` bins aggregate, read from each observation. */
|
|
88
|
+
weight?: (d: DataPoint, i: number) => unknown;
|
|
89
|
+
/** The name of what a bin measures. */
|
|
90
|
+
measure: string;
|
|
91
|
+
contours: false | "lines" | "filled";
|
|
92
|
+
contourConfig: Required<ContourConfig>;
|
|
93
|
+
points: boolean;
|
|
94
|
+
pointConfig: Required<Omit<PointConfig, "fill">> & {
|
|
95
|
+
fill?: string;
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
/** `contourConfig`'s defaults. */
|
|
99
|
+
export declare const CONTOUR_DEFAULTS: Required<ContourConfig>;
|
|
100
|
+
/** `pointConfig`'s defaults (the fill follows the chart's text color). */
|
|
101
|
+
export declare const POINT_DEFAULTS: Required<Omit<PointConfig, "fill">>;
|
|
102
|
+
/** The default `binSize`, in pixels. */
|
|
103
|
+
export declare const BIN_SIZE = 12;
|
|
104
|
+
/** Walks Plot's `__d3plus__` wrappers down to the row. */
|
|
105
|
+
export declare function unwrapHexbinRow(d: DataPoint): DataPoint;
|
|
106
|
+
/** The measure a (possibly wrapped) bin or contour row carries, if any. */
|
|
107
|
+
export declare function hexbinMeta(d: DataPoint | undefined): HexbinMeta | undefined;
|
|
108
|
+
/** A bin's measure or a contour's level: what Hexbin's colorScale reads. */
|
|
109
|
+
export declare function hexbinValue(d: DataPoint): number | undefined;
|
|
110
|
+
/** A row holding a bin's or contour's measure. */
|
|
111
|
+
export declare function hexbinRow(id: string, meta: HexbinMeta): DataPoint;
|
|
112
|
+
/**
|
|
113
|
+
Resolves `binValue` to an aggregation, the accessor it aggregates, and
|
|
114
|
+
the name of what each bin measures.
|
|
115
|
+
*/
|
|
116
|
+
export declare function resolveBinValue(option: unknown, translate: (s: string) => string): {
|
|
117
|
+
agg: BinAgg;
|
|
118
|
+
weight?: HexbinSettings["weight"];
|
|
119
|
+
measure: string;
|
|
120
|
+
};
|
|
121
|
+
/** Hexbin's options, resolved from its config for one draw. */
|
|
122
|
+
export declare function hexbinSettings(viz: VizInstance): HexbinSettings;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's tooltip and aria text: a bin's measure and its x and y ranges,
|
|
3
|
+
or a contour's density range.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/
|
|
7
|
+
import type { DataPoint } from "@d3plus/data";
|
|
8
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
9
|
+
/**
|
|
10
|
+
A contour level's value as text: through `levelFormat` when set, or
|
|
11
|
+
abbreviated (`1.5k`).
|
|
12
|
+
@param viz The chart.
|
|
13
|
+
@param level The level.
|
|
14
|
+
*/
|
|
15
|
+
export declare function contourLevelText(viz: VizInstance, level: number): string;
|
|
16
|
+
/** A bin's tooltip title: its measure, such as "Count: 42". */
|
|
17
|
+
export declare function hexbinTooltipTitle(viz: VizInstance, d: DataPoint): string;
|
|
18
|
+
/**
|
|
19
|
+
A bin's tooltip rows: its x and y ranges, and its count when it measures
|
|
20
|
+
something else. A contour's: its density range, in points per bin.
|
|
21
|
+
*/
|
|
22
|
+
export declare function hexbinTooltipRows(viz: VizInstance, d: DataPoint): [string, string][];
|
|
23
|
+
/** A bin's accessible name: its measure, then its x and y ranges. */
|
|
24
|
+
export declare function binAriaLabel(viz: VizInstance, d: DataPoint): string;
|
|
25
|
+
/** A contour's accessible name: "Density" and its range. */
|
|
26
|
+
export declare function contourAriaLabel(viz: VizInstance, d: DataPoint): string;
|
|
@@ -3,6 +3,12 @@ import type { DataPoint } from "@d3plus/data";
|
|
|
3
3
|
export type ThresholdGenerator = (values: ArrayLike<number>, min: number, max: number) => number | number[];
|
|
4
4
|
/** How bin heights are normalized. */
|
|
5
5
|
export type BinNormalize = "count" | "density" | "relative";
|
|
6
|
+
/**
|
|
7
|
+
Whether bin heights accumulate: `true` runs from the lowest bin up (values
|
|
8
|
+
below each bin's end), `"reverse"` from the highest bin down (values at or
|
|
9
|
+
above each bin's start).
|
|
10
|
+
*/
|
|
11
|
+
export type BinCumulative = boolean | "reverse";
|
|
6
12
|
export interface BinOptions {
|
|
7
13
|
/** Numeric observation accessor. */
|
|
8
14
|
value: (d: DataPoint, i: number) => unknown;
|
|
@@ -23,8 +29,13 @@ export interface BinOptions {
|
|
|
23
29
|
width?: number;
|
|
24
30
|
/** `"count"` (default), `"density"` (area sums to 1), or `"relative"` (heights sum to 1). */
|
|
25
31
|
normalize?: BinNormalize;
|
|
32
|
+
/** Accumulate each group's counts across its bins (see `BinCumulative`). */
|
|
33
|
+
cumulative?: BinCumulative;
|
|
26
34
|
}
|
|
27
|
-
/**
|
|
35
|
+
/**
|
|
36
|
+
One bin of one group. Carries the group's first row's fields and, with
|
|
37
|
+
`cumulative`, a `cumulativeCount`: the group's running count through it.
|
|
38
|
+
*/
|
|
28
39
|
export interface BinRow extends DataPoint {
|
|
29
40
|
/** Bin start (inclusive). */
|
|
30
41
|
x0: number;
|
|
@@ -37,6 +48,14 @@ export interface BinRow extends DataPoint {
|
|
|
37
48
|
/** The normalized height. */
|
|
38
49
|
y: number;
|
|
39
50
|
}
|
|
51
|
+
/**
|
|
52
|
+
The normalization a cumulative histogram draws: the running sum of a
|
|
53
|
+
density is the share of observations so far, so `"density"` reads as
|
|
54
|
+
`"relative"` (an empirical CDF).
|
|
55
|
+
*/
|
|
56
|
+
export declare function cumulativeNormalize(normalize?: BinNormalize, cumulative?: BinCumulative): BinNormalize;
|
|
57
|
+
/** Running sums of `counts`, from the first bin or, with `"reverse"`, the last. */
|
|
58
|
+
export declare function accumulate(counts: number[], cumulative: BinCumulative): number[];
|
|
40
59
|
/**
|
|
41
60
|
Bins `rows` by `options.value`. Non-finite values are dropped. Every group
|
|
42
61
|
gets a row for every bin of its panel (empty bins included, so stacks
|
|
@@ -7,8 +7,9 @@ export declare const histogramDef: ChartDefinition;
|
|
|
7
7
|
/**
|
|
8
8
|
Creates a histogram from an array of raw observations: the `value` of each
|
|
9
9
|
row is binned along a linear x axis, and bar heights show each bin's
|
|
10
|
-
count (or density / relative frequency via `binNormalize
|
|
11
|
-
`groupBy` share bin edges and are
|
|
10
|
+
count (or density / relative frequency via `binNormalize`, and running
|
|
11
|
+
totals via `cumulative`). Series set by `groupBy` share bin edges and are
|
|
12
|
+
stacked.
|
|
12
13
|
*/
|
|
13
14
|
declare const _default: new () => any;
|
|
14
15
|
export default _default;
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/** The English labels Histogram translates for its y axis and tooltip rows. */
|
|
2
|
+
import { type BinCumulative, type BinNormalize } from "./binData.js";
|
|
3
|
+
/**
|
|
4
|
+
The (untranslated) label for what a bar's height measures under
|
|
5
|
+
`binNormalize` and `cumulative`, used as the default y-axis title.
|
|
6
|
+
*/
|
|
7
|
+
export declare function heightLabel(normalize?: BinNormalize, cumulative?: BinCumulative): string;
|
|
@@ -10,7 +10,8 @@ export declare const marimekkoDef: ChartDefinition;
|
|
|
10
10
|
Creates a Marimekko (mosaic) chart from an array of data: one bar per
|
|
11
11
|
discrete value (`x`), as wide as its `barWidth` (by default its total),
|
|
12
12
|
with the bar's `groupBy` segments stacked to 100% of its height. Each
|
|
13
|
-
category
|
|
13
|
+
category is named beneath its bar, with the bar's share of the total
|
|
14
|
+
width above it (see `barWidthShare`), and tooltips
|
|
14
15
|
show each segment's value, its share of the bar, and the bar's width and
|
|
15
16
|
share of the total width. Set `stackOffset("none")` to stack absolute
|
|
16
17
|
values instead.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Network's `linkBundle`: each link between two distinct nodes takes a
|
|
3
|
+
bundled path (`points`, from its source's center to its target's), and
|
|
4
|
+
these helpers draw it: the visible stroke ending inside its arrowheads,
|
|
5
|
+
the heads aimed along the curve where it leaves each node, the label
|
|
6
|
+
anchor, and the box a click focus zooms to.
|
|
7
|
+
*/
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { SceneNode } from "@d3plus/render";
|
|
10
|
+
import type { LinkAnchor } from "../features/linkLabelGeometry.js";
|
|
11
|
+
import type { Point } from "../features/polyline.js";
|
|
12
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
13
|
+
/** What the bundling reads and writes on a laid-out link. */
|
|
14
|
+
export interface BundledLink {
|
|
15
|
+
source?: {
|
|
16
|
+
id?: unknown;
|
|
17
|
+
x?: number;
|
|
18
|
+
y?: number;
|
|
19
|
+
r?: number;
|
|
20
|
+
} | null;
|
|
21
|
+
target?: {
|
|
22
|
+
id?: unknown;
|
|
23
|
+
x?: number;
|
|
24
|
+
y?: number;
|
|
25
|
+
r?: number;
|
|
26
|
+
} | null;
|
|
27
|
+
loop?: unknown;
|
|
28
|
+
points?: Point[];
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
Gives each link between two distinct, placed nodes its bundled path
|
|
32
|
+
when `linkBundle` is on. Loops keep their own shape.
|
|
33
|
+
*/
|
|
34
|
+
export declare function bundleNetworkLinks(viz: VizInstance, links: BundledLink[]): void;
|
|
35
|
+
/**
|
|
36
|
+
How far along a bundled path each end's arrow tip sits: where the path
|
|
37
|
+
leaves a circle a pixel wider than the node at that end.
|
|
38
|
+
*/
|
|
39
|
+
export declare function bundledTipBack(points: Point[], rSource?: number, rTarget?: number): {
|
|
40
|
+
source: number;
|
|
41
|
+
target: number;
|
|
42
|
+
};
|
|
43
|
+
/**
|
|
44
|
+
A bundled link's visible stroke and arrowheads: the stroke follows the
|
|
45
|
+
path and ends inside each head, and each head's tip sits a pixel off its
|
|
46
|
+
node, aimed along the path (see `polylineArrowEdge`).
|
|
47
|
+
*/
|
|
48
|
+
export declare function bundledLinkEdge(viz: VizInstance, link: BundledLink & {
|
|
49
|
+
points: Point[];
|
|
50
|
+
}, opts: {
|
|
51
|
+
datum: DataPoint;
|
|
52
|
+
i: number;
|
|
53
|
+
strokeWidth: unknown;
|
|
54
|
+
keyPrefix: string;
|
|
55
|
+
fill?: string;
|
|
56
|
+
}): {
|
|
57
|
+
d: string;
|
|
58
|
+
arrows: SceneNode[];
|
|
59
|
+
};
|
|
60
|
+
/** A bundled link's run between the edges of its two nodes. */
|
|
61
|
+
export declare function bundledLinkPath(link: BundledLink & {
|
|
62
|
+
points: Point[];
|
|
63
|
+
}): Point[];
|
|
64
|
+
/** The middle of a bundled link's run between the edges of its two nodes. */
|
|
65
|
+
export declare function bundledLinkAnchor(link: BundledLink & {
|
|
66
|
+
points: Point[];
|
|
67
|
+
}): LinkAnchor;
|
|
@@ -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 {};
|