@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,95 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's contour labels: each labelled level's value written along its
|
|
3
|
+
contour lines, the way a topographic map labels elevation. Labels sit
|
|
4
|
+
centered on the line, read upright, break the line beneath them, and
|
|
5
|
+
keep clear of the other contours and labels; long rings take several,
|
|
6
|
+
`labelSpacing` apart, and dense levels are labelled every `labelStep`-th.
|
|
7
|
+
|
|
8
|
+
@module
|
|
9
|
+
*/
|
|
10
|
+
import type { DataPoint } from "@d3plus/data";
|
|
11
|
+
import type { SceneNode } from "@d3plus/render";
|
|
12
|
+
import { type Pt } from "../features/pathLabelGeometry.js";
|
|
13
|
+
import { type StretchContext } from "../Plot/lineLabelsAlong.js";
|
|
14
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
15
|
+
import type { PlotFrame } from "./layers.js";
|
|
16
|
+
import { type HexbinSettings } from "./settings.js";
|
|
17
|
+
/** The labels' font size when `labelConfig` sets none. */
|
|
18
|
+
export declare const CONTOUR_LABEL_FONT_SIZE = 10;
|
|
19
|
+
/** With more levels than this, `labelStep: "auto"` labels every other level. */
|
|
20
|
+
export declare const CONTOUR_LABEL_MAX_LEVELS = 5;
|
|
21
|
+
/**
|
|
22
|
+
A contour path's rings as closed polylines (the last point repeats the
|
|
23
|
+
first).
|
|
24
|
+
@param d The contour's path: `M x,y L x,y … Z` per ring.
|
|
25
|
+
*/
|
|
26
|
+
export declare function contourRings(d: string): Pt[][];
|
|
27
|
+
/**
|
|
28
|
+
How many levels apart labelled levels are (see `contourConfig.labelStep`):
|
|
29
|
+
a whole number of at least 1, or with `"auto"` (or anything else), 1
|
|
30
|
+
with up to `CONTOUR_LABEL_MAX_LEVELS` levels and 2 with more.
|
|
31
|
+
@param option The `labelStep` option.
|
|
32
|
+
@param count How many levels there are.
|
|
33
|
+
*/
|
|
34
|
+
export declare function contourLabelStep(option: unknown, count: number): number;
|
|
35
|
+
/**
|
|
36
|
+
Which levels take labels: every `step`-th one, keeping the levels at
|
|
37
|
+
multiples of `step` times their spacing (the "index" contours), or
|
|
38
|
+
every `step`-th position, from the `step`-th lowest, when the levels
|
|
39
|
+
aren't evenly spaced from zero.
|
|
40
|
+
@param levels The levels, lowest first.
|
|
41
|
+
@param step How many levels apart labelled levels are (see `contourLabelStep`).
|
|
42
|
+
*/
|
|
43
|
+
export declare function labelledLevels(levels: number[], step?: number): boolean[];
|
|
44
|
+
/**
|
|
45
|
+
The least distance between two labels' middles along one contour line,
|
|
46
|
+
in pixels (see `contourConfig.labelSpacing`): a positive number as
|
|
47
|
+
given, or with `"auto"` (or anything else), 20 ems or half the plot's
|
|
48
|
+
mean side, whichever is longer.
|
|
49
|
+
@param option The `labelSpacing` option.
|
|
50
|
+
@param fontSize The labels' font size.
|
|
51
|
+
@param frame The plot area.
|
|
52
|
+
*/
|
|
53
|
+
export declare function contourLabelSpacing(option: unknown, fontSize: number, frame: Pick<PlotFrame, "width" | "height">): number;
|
|
54
|
+
/**
|
|
55
|
+
The distance between two points along a closed ring of length `total`,
|
|
56
|
+
whichever way round is shorter.
|
|
57
|
+
@param a How far along the ring the first point lies.
|
|
58
|
+
@param b How far along the ring the second point lies.
|
|
59
|
+
@param total The ring's length.
|
|
60
|
+
*/
|
|
61
|
+
export declare function ringDistance(a: number, b: number, total: number): number;
|
|
62
|
+
/**
|
|
63
|
+
The points a placed label keeps other labels from: its band (see
|
|
64
|
+
`labelBand`), widened by half an em above and below, so stacked labels
|
|
65
|
+
on neighboring contours keep a gap between them.
|
|
66
|
+
@param points The label's upright stretch.
|
|
67
|
+
@param ctx The font size and lift.
|
|
68
|
+
*/
|
|
69
|
+
export declare function paddedBand(points: Pt[], ctx: StretchContext): Pt[];
|
|
70
|
+
/**
|
|
71
|
+
The stretches labels along a closed ring take: as many as its length
|
|
72
|
+
allows at `spacing` pixels apart (at least one), each the best-scoring
|
|
73
|
+
stretch left that is clear of the obstacles and at least `spacing` along
|
|
74
|
+
the ring from the others. Each one's padded band (see `paddedBand`) is
|
|
75
|
+
added to the obstacles.
|
|
76
|
+
@param ring The closed ring.
|
|
77
|
+
@param length Each label's length.
|
|
78
|
+
@param ctx The obstacles (ignoring the ring's own points), plot area, and font.
|
|
79
|
+
@param spacing The least distance between two labels' middles along the ring (at least a label's length).
|
|
80
|
+
*/
|
|
81
|
+
export declare function ringLabelStretches(ring: Pt[], length: number, ctx: StretchContext, spacing: number): Pt[][];
|
|
82
|
+
/**
|
|
83
|
+
The labels along a Hexbin's contour lines (`contourConfig.labels`): for
|
|
84
|
+
each labelled level, its formatted value along its rings, centered on
|
|
85
|
+
the line, upright, on a pad of the chart's background that breaks the
|
|
86
|
+
line beneath (when the contours are lines). Inert: no hover, click, or
|
|
87
|
+
keyboard stop.
|
|
88
|
+
@param viz The chart.
|
|
89
|
+
@param rows The contour rows, lowest level first.
|
|
90
|
+
@param nodes The contours' drawn nodes, for their colors.
|
|
91
|
+
@param frame The plot area.
|
|
92
|
+
@param settings The chart's resolved options.
|
|
93
|
+
@param obstacles Other lines to keep clear of, such as trend lines.
|
|
94
|
+
*/
|
|
95
|
+
export declare function emitContourLabels(viz: VizInstance, rows: DataPoint[], nodes: SceneNode[], frame: PlotFrame, settings: HexbinSettings, obstacles?: Pt[][]): SceneNode[];
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's pure density-contour helpers: a kernel density estimate of the
|
|
3
|
+
points in pixel space (d3-contour's `contourDensity`), cut at threshold
|
|
4
|
+
levels, each level's region as an SVG path.
|
|
5
|
+
|
|
6
|
+
Levels are in points per bin: the density (points per square pixel)
|
|
7
|
+
times the area of one bin, so a level reads as the count a bin would
|
|
8
|
+
hold there and shares the bins' color scale.
|
|
9
|
+
|
|
10
|
+
@module
|
|
11
|
+
*/
|
|
12
|
+
import type { PixelPoint } from "./binning.js";
|
|
13
|
+
/** A GeoJSON MultiPolygon's coordinates: polygons of rings of points. */
|
|
14
|
+
type MultiPolygonCoords = number[][][][];
|
|
15
|
+
/** One contour level: its threshold and its region's outline. */
|
|
16
|
+
export interface ContourLevel {
|
|
17
|
+
level: number;
|
|
18
|
+
path: string;
|
|
19
|
+
}
|
|
20
|
+
/** What a density contour pass needs. */
|
|
21
|
+
export interface ContourOptions {
|
|
22
|
+
/** The plot's left and top edge, in pixels: the density grid's origin. */
|
|
23
|
+
left: number;
|
|
24
|
+
top: number;
|
|
25
|
+
/** The plot's size, in pixels. */
|
|
26
|
+
width: number;
|
|
27
|
+
height: number;
|
|
28
|
+
/** The kernel's standard deviation, in pixels. */
|
|
29
|
+
bandwidth: number;
|
|
30
|
+
/** About how many levels to draw (rounded to nice values), or the levels themselves. */
|
|
31
|
+
thresholds: number | number[];
|
|
32
|
+
/** Square pixels per level unit: the area of one bin. */
|
|
33
|
+
unit: number;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
The levels to cut a density whose peak is `max` at: the given levels
|
|
37
|
+
above zero (sorted), or about `thresholds` nice values between zero and
|
|
38
|
+
the peak.
|
|
39
|
+
*/
|
|
40
|
+
export declare function contourLevels(max: number, thresholds: number | number[]): number[];
|
|
41
|
+
/** A MultiPolygon's rings as one absolute SVG path, shifted by `[dx, dy]`. */
|
|
42
|
+
export declare function contourPath(coordinates: MultiPolygonCoords, [dx, dy]?: [number, number]): string;
|
|
43
|
+
/**
|
|
44
|
+
The density contours of `points`, one per level that encloses any area,
|
|
45
|
+
lowest level first.
|
|
46
|
+
*/
|
|
47
|
+
export declare function densityContours(points: PixelPoint[], options: ContourOptions): ContourLevel[];
|
|
48
|
+
export {};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's Plot shape emitter: the observations binned in pixel space and
|
|
3
|
+
drawn as hexagons or squares, with optional density contours and the raw
|
|
4
|
+
observations beneath. Bins and contours are Paths stamped as `"Hexbin"`
|
|
5
|
+
marks, each carrying a bin or contour row as its datum, so tooltips,
|
|
6
|
+
hover, events and keyboard navigation treat them like any other mark.
|
|
7
|
+
|
|
8
|
+
@module
|
|
9
|
+
*/
|
|
10
|
+
import type { ShapeEmitContext, ShapeEmitter } from "../features/shapeEmit.js";
|
|
11
|
+
import { type PixelPoint } from "./binning.js";
|
|
12
|
+
import { type HexbinSettings } from "./settings.js";
|
|
13
|
+
/** The observations of a shape group, placed in pixels. */
|
|
14
|
+
export declare function pixelPoints(ctx: Pick<ShapeEmitContext, "x" | "y" | "values">, settings: Pick<HexbinSettings, "weight">): PixelPoint[];
|
|
15
|
+
/**
|
|
16
|
+
Emits a Hexbin's observations: the raw points (`points`), the bins
|
|
17
|
+
(`binShape`), then the density contours (`contours`) and their level
|
|
18
|
+
labels. Each paint, zoomed
|
|
19
|
+
or not, refits the colorScale to the bins in view (or the contour
|
|
20
|
+
levels), so the fills and the colorScale agree and the densest bin in
|
|
21
|
+
view takes the top color.
|
|
22
|
+
*/
|
|
23
|
+
export declare const hexbinEmit: ShapeEmitter;
|
|
@@ -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;
|