@d3plus/core 4.10.0 → 4.12.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 +178 -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 +176 -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 +101 -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 +192 -0
- package/es/src/charts/ArcDiagram/events.js +148 -0
- package/es/src/charts/ArcDiagram/index.js +217 -0
- package/es/src/charts/BarChart/index.js +12 -7
- 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 +5 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +6 -11
- 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 +160 -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 +137 -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 +206 -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 +6 -4
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/applyLayout.js +20 -9
- package/es/src/charts/Matrix/index.js +19 -1
- package/es/src/charts/Network/applyLayout.js +171 -96
- package/es/src/charts/Network/bundle.js +82 -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 +257 -75
- package/es/src/charts/Network/graph.js +146 -0
- package/es/src/charts/Network/graphFluent.js +81 -0
- package/es/src/charts/Network/index.js +91 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +15 -8
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +8 -1
- package/es/src/charts/Pack/neutralPaint.js +20 -0
- package/es/src/charts/Pack/nodeNames.js +35 -0
- package/es/src/charts/ParallelCoordinates/axes.js +22 -22
- package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- 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 +51 -96
- package/es/src/charts/Pie/index.js +74 -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/areaEnter.js +68 -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 +34 -14
- 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 +19 -17
- 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/lineMarkerKeys.js +19 -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 +40 -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/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +2 -1
- package/es/src/charts/Plot/sharedTooltip.js +13 -3
- 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 +4 -3
- package/es/src/charts/Priestley/applyLayout.js +21 -23
- package/es/src/charts/Priestley/index.js +4 -37
- package/es/src/charts/Priestley/timeAxis.js +103 -0
- package/es/src/charts/Pyramid/gutter.js +52 -16
- package/es/src/charts/Pyramid/index.js +55 -7
- package/es/src/charts/Pyramid/scene.js +4 -4
- package/es/src/charts/Radar/applyLayout.js +31 -33
- package/es/src/charts/Radar/axisDecorations.js +62 -13
- package/es/src/charts/Radar/curvedLabels.js +228 -0
- package/es/src/charts/Radar/emit.js +30 -15
- package/es/src/charts/Radar/index.js +43 -5
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +9 -1
- package/es/src/charts/RadialBar/index.js +26 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/index.js +18 -9
- package/es/src/charts/Rings/applyLayout.js +39 -161
- package/es/src/charts/Rings/emit.js +219 -63
- package/es/src/charts/Rings/index.js +88 -32
- package/es/src/charts/Rings/ringsCurves.js +156 -0
- 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 +183 -0
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +61 -38
- package/es/src/charts/Sankey/applyLayout.js +130 -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 +78 -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 +83 -64
- package/es/src/charts/Sunburst/index.js +16 -4
- package/es/src/charts/Tree/applyLayout.js +44 -14
- package/es/src/charts/Tree/emit.js +5 -5
- package/es/src/charts/Tree/index.js +12 -18
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- 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 +14 -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 +10 -25
- 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/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +52 -23
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
- package/es/src/charts/drawSteps/zoomDrag.js +188 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +11 -4
- package/es/src/charts/events/click.shape.js +13 -4
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +9 -2
- package/es/src/charts/events/mousemove.legend.js +28 -32
- package/es/src/charts/events/mousemove.shape.js +45 -42
- 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 +17 -5
- package/es/src/charts/features/axesFinal.js +10 -3
- package/es/src/charts/features/axesMeasure.js +33 -12
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/centerLabel.js +177 -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/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +20 -1
- package/es/src/charts/features/colorScaleHover.js +33 -7
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +77 -0
- package/es/src/charts/features/colorScaleTop.js +61 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +191 -0
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +220 -5
- 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 +75 -20
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/hoverTicks.js +41 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- 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 +364 -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/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeStats.js +309 -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/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +46 -12
- 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 +54 -32
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +30 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +14 -5
- package/es/src/charts/partition/interaction.js +19 -10
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +22 -9
- 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/chrome.js +81 -9
- package/es/src/charts/polar/config.js +6 -3
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +61 -49
- package/es/src/charts/viz/VizBase.js +57 -14
- package/es/src/charts/viz/backgroundInk.js +23 -7
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- 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/interactionOpacity.js +115 -32
- 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/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +29 -0
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +34 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -4
- package/es/src/charts/viz/vizDefaults.js +28 -57
- package/es/src/charts/viz/vizFields.js +41 -1
- package/es/src/charts/viz/vizRender.js +76 -31
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +26 -2
- package/es/src/components/Axis/Axis.js +35 -2
- 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 +33 -8
- package/es/src/components/Axis/axisDefaults.js +16 -9
- package/es/src/components/Axis/axisLabelKinds.js +36 -0
- package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
- package/es/src/components/Axis/axisLabelRoom.js +37 -0
- package/es/src/components/Axis/axisLabelSize.js +171 -0
- package/es/src/components/Axis/axisLabelThinning.js +98 -4
- package/es/src/components/Axis/axisLayout.js +71 -46
- package/es/src/components/Axis/axisLayoutLabels.js +82 -140
- package/es/src/components/Axis/axisLayoutScale.js +16 -11
- package/es/src/components/Axis/axisLimit.js +27 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +20 -8
- package/es/src/components/Axis/axisRounding.js +16 -1
- package/es/src/components/Axis/axisScene.js +11 -2
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +128 -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 +77 -27
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +13 -2
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/Legend/legendCut.js +108 -0
- package/es/src/components/Legend/legendRender.js +38 -13
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +34 -67
- 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 +9 -4
- 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 +226 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +8 -5
- package/es/src/fluent.js +48 -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 +30 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configValue.js +9 -0
- 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 +268 -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 +46 -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 +24 -0
- package/types/src/charts/ArcDiagram/events.d.ts +29 -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 +36 -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/Matrix/applyLayout.d.ts +4 -2
- package/types/src/charts/Network/applyLayout.d.ts +11 -0
- package/types/src/charts/Network/bundle.d.ts +69 -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 +73 -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/Pack/applyLayout.d.ts +2 -0
- package/types/src/charts/Pack/groupRows.d.ts +46 -0
- package/types/src/charts/Pack/index.d.ts +3 -0
- package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
- package/types/src/charts/Pack/nodeNames.d.ts +23 -0
- package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
- package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
- package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
- 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/areaEnter.d.ts +34 -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 +16 -15
- 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/lineMarkerKeys.d.ts +11 -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/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
- 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 +79 -0
- package/types/src/charts/Pyramid/gutter.d.ts +28 -6
- package/types/src/charts/Pyramid/scene.d.ts +1 -1
- package/types/src/charts/Radar/applyLayout.d.ts +2 -3
- package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
- package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
- package/types/src/charts/Radar/emit.d.ts +5 -2
- package/types/src/charts/Radar/index.d.ts +7 -2
- package/types/src/charts/Radar/points.d.ts +50 -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/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/Rings/emit.d.ts +72 -0
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
- 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/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -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/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
- package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- 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/axisTooltip.d.ts +49 -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/centerLabel.d.ts +75 -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/colorScaleBivariate.d.ts +50 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
- package/types/src/charts/features/colorScaleHover.d.ts +13 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +119 -0
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +103 -4
- 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/hoverTicks.d.ts +30 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- 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 +192 -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/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -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/plotEndLabels.d.ts +14 -1
- 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 +15 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- 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/insetPlacement.d.ts +6 -0
- 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/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +25 -4
- package/types/src/charts/viz/VizBase.d.ts +37 -8
- package/types/src/charts/viz/backgroundInk.d.ts +19 -4
- package/types/src/charts/viz/emphasis.d.ts +17 -0
- package/types/src/charts/viz/fillStroke.d.ts +7 -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/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/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +26 -0
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +35 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +37 -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 +100 -7
- package/types/src/charts/viz/vizVisibility.d.ts +13 -0
- package/types/src/components/Axis/Axis.d.ts +34 -3
- 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 +21 -3
- package/types/src/components/Axis/axisDefaults.d.ts +12 -0
- package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
- package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
- package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
- package/types/src/components/Axis/axisLayout.d.ts +9 -2
- package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
- package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
- package/types/src/components/Axis/axisLimit.d.ts +18 -0
- package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +8 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -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 +22 -11
- package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
- package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +6 -0
- package/types/src/components/Legend/legendCut.d.ts +31 -0
- package/types/src/components/Legend/legendRender.d.ts +6 -1
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +5 -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/components/textEllipsis.d.ts +6 -0
- package/types/src/fluent.d.ts +18 -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/shapes/emitLabels.d.ts +1 -1
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +1093 -266
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configValue.d.ts +8 -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/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +72239 -41465
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +46249 -19519
- 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,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.
|
|
@@ -2,8 +2,10 @@
|
|
|
2
2
|
`applyMatrixLayout` — Matrix's chart-specific layout stage.
|
|
3
3
|
|
|
4
4
|
Two-pass axis layout: measure-only pass for padding, then compute-mode
|
|
5
|
-
render that absorbs row/column axis scenes into `_chartScene
|
|
6
|
-
`
|
|
5
|
+
render that absorbs row/column axis scenes into `_chartScene` as chrome
|
|
6
|
+
(see `inertAxis`), their labels following the hover (see
|
|
7
|
+
`tagHoverTicks`). Stashes `columnScale`/`rowScale`/`cellWidth`/
|
|
8
|
+
`cellHeight` on `viz.ctx`.
|
|
7
9
|
*/
|
|
8
10
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
9
11
|
export declare const applyMatrixLayout: TransformStage;
|
|
@@ -8,6 +8,16 @@
|
|
|
8
8
|
*/
|
|
9
9
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
10
10
|
import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
|
|
11
|
+
import type { GraphNode } from "./graph.js";
|
|
12
|
+
/** Single laid-out node — accreted across the layout's passes. */
|
|
13
|
+
type NetworkNode = GraphNode;
|
|
14
|
+
/**
|
|
15
|
+
Places `lone` (nodes no link pulls on) in rows under `placed`, as far
|
|
16
|
+
apart as the placed nodes typically sit from their nearest neighbor,
|
|
17
|
+
the rows centered beneath them. Without placed nodes the rows form a
|
|
18
|
+
square-ish grid.
|
|
19
|
+
*/
|
|
20
|
+
export declare function placeLoneNodes(placed: NetworkNode[], lone: NetworkNode[]): void;
|
|
11
21
|
/**
|
|
12
22
|
Network's size-legend scale for a chart area of `width` × `height`: the
|
|
13
23
|
same node set, positions, and fitted radius scale the layout builds, run
|
|
@@ -16,3 +26,4 @@ import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayo
|
|
|
16
26
|
*/
|
|
17
27
|
export declare function networkSizeLegendScale(v: Parameters<TransformStage>[0]["viz"], width: number, height: number): SizeLegendScale | null;
|
|
18
28
|
export declare const applyNetworkLayout: TransformStage;
|
|
29
|
+
export {};
|
|
@@ -0,0 +1,69 @@
|
|
|
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`). `arrowSize`
|
|
47
|
+
defaults to the chart's.
|
|
48
|
+
*/
|
|
49
|
+
export declare function bundledLinkEdge(viz: VizInstance, link: BundledLink & {
|
|
50
|
+
points: Point[];
|
|
51
|
+
}, opts: {
|
|
52
|
+
datum: DataPoint;
|
|
53
|
+
i: number;
|
|
54
|
+
strokeWidth: unknown;
|
|
55
|
+
arrowSize?: unknown;
|
|
56
|
+
keyPrefix: string;
|
|
57
|
+
fill?: string;
|
|
58
|
+
}): {
|
|
59
|
+
d: string;
|
|
60
|
+
arrows: SceneNode[];
|
|
61
|
+
};
|
|
62
|
+
/** A bundled link's run between the edges of its two nodes. */
|
|
63
|
+
export declare function bundledLinkPath(link: BundledLink & {
|
|
64
|
+
points: Point[];
|
|
65
|
+
}): Point[];
|
|
66
|
+
/** The middle of a bundled link's run between the edges of its two nodes. */
|
|
67
|
+
export declare function bundledLinkAnchor(link: BundledLink & {
|
|
68
|
+
points: Point[];
|
|
69
|
+
}): 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 {};
|