@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,234 @@
|
|
|
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
|
+
*/ import { fontExists, textWidth } from "@d3plus/dom";
|
|
10
|
+
import { fontFamily as defaultFontFamily } from "@d3plus/text";
|
|
11
|
+
import { offsetPolyline, polylineD, polylineLength, trimPolyline } from "../features/pathLabelGeometry.js";
|
|
12
|
+
import { pathLabelNodes } from "../features/pathLabels.js";
|
|
13
|
+
import { bestStretchAt, labelBand, PointGrid, resample } from "../Plot/lineLabelsAlong.js";
|
|
14
|
+
import { backgroundInk, chartBackground } from "../viz/backgroundInk.js";
|
|
15
|
+
import { hexbinMeta } from "./settings.js";
|
|
16
|
+
import { contourLevelText } from "./tooltip.js";
|
|
17
|
+
/** The labels' font size when `labelConfig` sets none. */ export const CONTOUR_LABEL_FONT_SIZE = 10;
|
|
18
|
+
/** With more levels than this, `labelStep: "auto"` labels every other level. */ export const CONTOUR_LABEL_MAX_LEVELS = 5;
|
|
19
|
+
/** How far below the line a label's baseline sits, in ems, so its digits' middles sit on the line. */ const BASELINE_DROP = 0.3;
|
|
20
|
+
/** The gap the line breaks for at each end of a label, in ems. */ const END_GAP = 0.4;
|
|
21
|
+
/** The least room a label keeps from the other lines and labels, in ems. */ const CLEARANCE = 0.3;
|
|
22
|
+
/** The most a label's stretch may turn in all, in radians. */ const MAX_TURN = Math.PI / 3;
|
|
23
|
+
/**
|
|
24
|
+
A contour path's rings as closed polylines (the last point repeats the
|
|
25
|
+
first).
|
|
26
|
+
@param d The contour's path: `M x,y L x,y … Z` per ring.
|
|
27
|
+
*/ export function contourRings(d) {
|
|
28
|
+
return (d.match(/M[^MZ]*/g) ?? []).map((ring)=>ring.slice(1).split("L").map((pair)=>pair.split(",").map(Number)).filter(([x, y])=>Number.isFinite(x) && Number.isFinite(y))).filter((points)=>points.length > 2).map((points)=>[
|
|
29
|
+
...points,
|
|
30
|
+
points[0]
|
|
31
|
+
]);
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
How many levels apart labelled levels are (see `contourConfig.labelStep`):
|
|
35
|
+
a whole number of at least 1, or with `"auto"` (or anything else), 1
|
|
36
|
+
with up to `CONTOUR_LABEL_MAX_LEVELS` levels and 2 with more.
|
|
37
|
+
@param option The `labelStep` option.
|
|
38
|
+
@param count How many levels there are.
|
|
39
|
+
*/ export function contourLabelStep(option, count) {
|
|
40
|
+
if (typeof option === "number" && Number.isFinite(option)) return Math.max(1, Math.round(option));
|
|
41
|
+
return count > CONTOUR_LABEL_MAX_LEVELS ? 2 : 1;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
Which levels take labels: every `step`-th one, keeping the levels at
|
|
45
|
+
multiples of `step` times their spacing (the "index" contours), or
|
|
46
|
+
every `step`-th position, from the `step`-th lowest, when the levels
|
|
47
|
+
aren't evenly spaced from zero.
|
|
48
|
+
@param levels The levels, lowest first.
|
|
49
|
+
@param step How many levels apart labelled levels are (see `contourLabelStep`).
|
|
50
|
+
*/ export function labelledLevels(levels, step = contourLabelStep("auto", levels.length)) {
|
|
51
|
+
if (step <= 1) return levels.map(()=>true);
|
|
52
|
+
const spacing = levels[1] - levels[0];
|
|
53
|
+
const even = spacing > 0 && levels.every((l, i)=>!i || Math.abs(l - levels[i - 1] - spacing) < 1e-9);
|
|
54
|
+
const multiple = (l)=>Math.round(l / spacing) % step === 0;
|
|
55
|
+
if (even && Math.abs(levels[0] / spacing - Math.round(levels[0] / spacing)) < 1e-9) return levels.map(multiple);
|
|
56
|
+
return levels.map((_, i)=>(i + 1) % step === 0);
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
The least distance between two labels' middles along one contour line,
|
|
60
|
+
in pixels (see `contourConfig.labelSpacing`): a positive number as
|
|
61
|
+
given, or with `"auto"` (or anything else), 20 ems or half the plot's
|
|
62
|
+
mean side, whichever is longer.
|
|
63
|
+
@param option The `labelSpacing` option.
|
|
64
|
+
@param fontSize The labels' font size.
|
|
65
|
+
@param frame The plot area.
|
|
66
|
+
*/ export function contourLabelSpacing(option, fontSize, frame) {
|
|
67
|
+
if (typeof option === "number" && option > 0 && Number.isFinite(option)) return option;
|
|
68
|
+
return Math.max(fontSize * 20, (frame.width + frame.height) / 4);
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
The distance between two points along a closed ring of length `total`,
|
|
72
|
+
whichever way round is shorter.
|
|
73
|
+
@param a How far along the ring the first point lies.
|
|
74
|
+
@param b How far along the ring the second point lies.
|
|
75
|
+
@param total The ring's length.
|
|
76
|
+
*/ export function ringDistance(a, b, total) {
|
|
77
|
+
const d = Math.abs(((a - b) % total + total) % total);
|
|
78
|
+
return Math.min(d, total - d);
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
The points a placed label keeps other labels from: its band (see
|
|
82
|
+
`labelBand`), widened by half an em above and below, so stacked labels
|
|
83
|
+
on neighboring contours keep a gap between them.
|
|
84
|
+
@param points The label's upright stretch.
|
|
85
|
+
@param ctx The font size and lift.
|
|
86
|
+
*/ export function paddedBand(points, ctx) {
|
|
87
|
+
const pad = ctx.fontSize / 2;
|
|
88
|
+
return [
|
|
89
|
+
-pad,
|
|
90
|
+
0,
|
|
91
|
+
pad
|
|
92
|
+
].flatMap((d)=>labelBand(points, {
|
|
93
|
+
...ctx,
|
|
94
|
+
lift: ctx.lift + d
|
|
95
|
+
}));
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
The stretches labels along a closed ring take: as many as its length
|
|
99
|
+
allows at `spacing` pixels apart (at least one), each the best-scoring
|
|
100
|
+
stretch left that is clear of the obstacles and at least `spacing` along
|
|
101
|
+
the ring from the others. Each one's padded band (see `paddedBand`) is
|
|
102
|
+
added to the obstacles.
|
|
103
|
+
@param ring The closed ring.
|
|
104
|
+
@param length Each label's length.
|
|
105
|
+
@param ctx The obstacles (ignoring the ring's own points), plot area, and font.
|
|
106
|
+
@param spacing The least distance between two labels' middles along the ring (at least a label's length).
|
|
107
|
+
*/ export function ringLabelStretches(ring, length, ctx, spacing) {
|
|
108
|
+
const total = polylineLength(ring);
|
|
109
|
+
if (!(total > length * 2)) return [];
|
|
110
|
+
// Labels closer than their own length would overlap.
|
|
111
|
+
const gap = Math.max(spacing, length);
|
|
112
|
+
// Twice round, so a stretch can cross where the ring starts and ends.
|
|
113
|
+
const loop = trimPolyline([
|
|
114
|
+
...ring,
|
|
115
|
+
...ring.slice(1)
|
|
116
|
+
], 0, total + length);
|
|
117
|
+
const count = Math.max(1, Math.floor(total / gap));
|
|
118
|
+
const middles = [];
|
|
119
|
+
const out = [];
|
|
120
|
+
while(out.length < count){
|
|
121
|
+
const spot = bestStretchAt([
|
|
122
|
+
loop
|
|
123
|
+
], length, ctx, (from)=>from < total && middles.every((m)=>ringDistance(from + length / 2, m, total) >= gap));
|
|
124
|
+
if (!spot) break;
|
|
125
|
+
middles.push(spot.from + length / 2);
|
|
126
|
+
out.push(spot.points);
|
|
127
|
+
ctx.grid.add(paddedBand(spot.points, ctx));
|
|
128
|
+
}
|
|
129
|
+
return out;
|
|
130
|
+
}
|
|
131
|
+
/** Each contour level's drawn color, by its index: its stroke, or for filled contours its fill. */ function levelColors(nodes) {
|
|
132
|
+
const colors = new Map();
|
|
133
|
+
for (const node of nodes){
|
|
134
|
+
const meta = hexbinMeta(node.datum);
|
|
135
|
+
if (meta?.kind !== "contour") continue;
|
|
136
|
+
const paint = node.paint ?? {};
|
|
137
|
+
const color = (paint.strokeWidth ?? 0) > 0 ? paint.stroke : paint.fill;
|
|
138
|
+
if (color) colors.set(meta.index, color);
|
|
139
|
+
}
|
|
140
|
+
return colors;
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
The labels along a Hexbin's contour lines (`contourConfig.labels`): for
|
|
144
|
+
each labelled level, its formatted value along its rings, centered on
|
|
145
|
+
the line, upright, on a pad of the chart's background that breaks the
|
|
146
|
+
line beneath (when the contours are lines). Inert: no hover, click, or
|
|
147
|
+
keyboard stop.
|
|
148
|
+
@param viz The chart.
|
|
149
|
+
@param rows The contour rows, lowest level first.
|
|
150
|
+
@param nodes The contours' drawn nodes, for their colors.
|
|
151
|
+
@param frame The plot area.
|
|
152
|
+
@param settings The chart's resolved options.
|
|
153
|
+
@param obstacles Other lines to keep clear of, such as trend lines.
|
|
154
|
+
*/ export function emitContourLabels(viz, rows, nodes, frame, settings, obstacles = []) {
|
|
155
|
+
const { labels, labelConfig, labelSpacing, labelStep, strokeWidth } = settings.contourConfig;
|
|
156
|
+
if (!labels || !rows.length) return [];
|
|
157
|
+
const metas = rows.map((row)=>hexbinMeta(row)).filter((m)=>m?.kind === "contour");
|
|
158
|
+
const rings = metas.map((meta)=>contourRings(meta.path));
|
|
159
|
+
const fontSize = typeof labelConfig.fontSize === "number" ? labelConfig.fontSize : CONTOUR_LABEL_FONT_SIZE;
|
|
160
|
+
const style = {
|
|
161
|
+
"font-family": fontExists(labelConfig.fontFamily ?? defaultFontFamily),
|
|
162
|
+
"font-size": fontSize,
|
|
163
|
+
"font-weight": labelConfig.fontWeight ?? 600
|
|
164
|
+
};
|
|
165
|
+
const rect = {
|
|
166
|
+
x0: frame.left,
|
|
167
|
+
y0: frame.top,
|
|
168
|
+
x1: frame.left + frame.width,
|
|
169
|
+
y1: frame.top + frame.height
|
|
170
|
+
};
|
|
171
|
+
const grid = new PointGrid(fontSize);
|
|
172
|
+
for (const line of obstacles)grid.add(resample(line, 2));
|
|
173
|
+
let tag = 0;
|
|
174
|
+
const tags = rings.map((level)=>level.map((ring)=>{
|
|
175
|
+
grid.add(resample(ring, 2), tag);
|
|
176
|
+
return tag++;
|
|
177
|
+
}));
|
|
178
|
+
const ctx = {
|
|
179
|
+
grid,
|
|
180
|
+
rect,
|
|
181
|
+
fontSize,
|
|
182
|
+
lift: -BASELINE_DROP * fontSize,
|
|
183
|
+
maxTurn: MAX_TURN,
|
|
184
|
+
// Wide enough that no line slips between the band's rows.
|
|
185
|
+
minClearance: Math.max(2, CLEARANCE * fontSize)
|
|
186
|
+
};
|
|
187
|
+
const spacing = contourLabelSpacing(labelSpacing, fontSize, frame);
|
|
188
|
+
const colors = levelColors(nodes);
|
|
189
|
+
const lines = settings.contours === "lines" && strokeWidth > 0;
|
|
190
|
+
const labelled = labelledLevels(metas.map((m)=>m.level), contourLabelStep(labelStep, metas.length));
|
|
191
|
+
const pads = [];
|
|
192
|
+
const texts = [];
|
|
193
|
+
metas.forEach((meta, l)=>{
|
|
194
|
+
if (!labelled[l]) return;
|
|
195
|
+
const text = contourLevelText(viz, meta.level);
|
|
196
|
+
if (!text) return;
|
|
197
|
+
const length = textWidth(text, style) + 2 * END_GAP * fontSize;
|
|
198
|
+
rings[l].forEach((ring, r)=>{
|
|
199
|
+
ctx.ignore = tags[l][r];
|
|
200
|
+
ringLabelStretches(ring, length, ctx, spacing).forEach((stretch, k)=>{
|
|
201
|
+
const key = `contour-label-${meta.index}-${r}-${k}`;
|
|
202
|
+
if (lines) pads.push({
|
|
203
|
+
type: "path",
|
|
204
|
+
key: `${key}-pad`,
|
|
205
|
+
d: polylineD(stretch),
|
|
206
|
+
interactive: false,
|
|
207
|
+
aria: {
|
|
208
|
+
hidden: true
|
|
209
|
+
},
|
|
210
|
+
paint: {
|
|
211
|
+
fill: "none",
|
|
212
|
+
stroke: chartBackground(viz),
|
|
213
|
+
strokeWidth: strokeWidth + 2,
|
|
214
|
+
strokeLinecap: "butt"
|
|
215
|
+
}
|
|
216
|
+
});
|
|
217
|
+
texts.push({
|
|
218
|
+
key,
|
|
219
|
+
text,
|
|
220
|
+
d: polylineD(offsetPolyline(stretch, ctx.lift)),
|
|
221
|
+
color: colors.get(meta.index) ?? backgroundInk(viz),
|
|
222
|
+
anchor: "middle"
|
|
223
|
+
});
|
|
224
|
+
});
|
|
225
|
+
});
|
|
226
|
+
});
|
|
227
|
+
return [
|
|
228
|
+
...pads,
|
|
229
|
+
...pathLabelNodes(viz, texts, {
|
|
230
|
+
fontSize,
|
|
231
|
+
...labelConfig
|
|
232
|
+
})
|
|
233
|
+
];
|
|
234
|
+
}
|
|
@@ -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
|
+
*/ import { contourDensity } from "d3-contour";
|
|
12
|
+
import { ticks } from "d3-array";
|
|
13
|
+
/**
|
|
14
|
+
The levels to cut a density whose peak is `max` at: the given levels
|
|
15
|
+
above zero (sorted), or about `thresholds` nice values between zero and
|
|
16
|
+
the peak.
|
|
17
|
+
*/ export function contourLevels(max, thresholds) {
|
|
18
|
+
if (Array.isArray(thresholds)) return thresholds.filter((t)=>Number.isFinite(t) && t > 0).sort((a, b)=>a - b);
|
|
19
|
+
if (!(max > 0) || !(thresholds > 0)) return [];
|
|
20
|
+
return ticks(0, max, thresholds).filter((t)=>t > 0 && t < max);
|
|
21
|
+
}
|
|
22
|
+
/** A MultiPolygon's rings as one absolute SVG path, shifted by `[dx, dy]`. */ export function contourPath(coordinates, [dx, dy] = [
|
|
23
|
+
0,
|
|
24
|
+
0
|
|
25
|
+
]) {
|
|
26
|
+
const round = (n)=>Math.round(n * 100) / 100;
|
|
27
|
+
return coordinates.flatMap((polygon)=>polygon.map((ring)=>`M${ring.map(([x, y])=>`${round(x + dx)},${round(y + dy)}`).join("L")}Z`)).join("");
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
The density contours of `points`, one per level that encloses any area,
|
|
31
|
+
lowest level first.
|
|
32
|
+
*/ export function densityContours(points, options) {
|
|
33
|
+
const { left, top, width, height, bandwidth, unit } = options;
|
|
34
|
+
const valid = points.filter((p)=>Number.isFinite(p.x) && Number.isFinite(p.y));
|
|
35
|
+
if (!valid.length || !(width > 0) || !(height > 0) || !(unit > 0)) return [];
|
|
36
|
+
const density = contourDensity().x((p)=>p.x - left).y((p)=>p.y - top).weight((p)=>typeof p.weight === "number" && Number.isFinite(p.weight) ? p.weight : 1).size([
|
|
37
|
+
Math.ceil(width),
|
|
38
|
+
Math.ceil(height)
|
|
39
|
+
]).bandwidth(Math.max(bandwidth, 0.5));
|
|
40
|
+
const contours = density.contours(valid);
|
|
41
|
+
return contourLevels(contours.max * unit, options.thresholds).map((level)=>({
|
|
42
|
+
level,
|
|
43
|
+
path: contourPath(contours(level / unit).coordinates, [
|
|
44
|
+
left,
|
|
45
|
+
top
|
|
46
|
+
])
|
|
47
|
+
})).filter((c)=>c.path.length);
|
|
48
|
+
}
|
|
@@ -0,0 +1,142 @@
|
|
|
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
|
+
*/ import { collectComputed, makeShape, shapeConfigFor } from "../features/emitHelpers.js";
|
|
10
|
+
import { backgroundInk } from "../viz/backgroundInk.js";
|
|
11
|
+
import { binPoints } from "./binning.js";
|
|
12
|
+
import { emitContourLabels } from "./contourLabels.js";
|
|
13
|
+
import { binRows, binsInView, contourRows, hexbinState, plotFrame, pointPath, refreshColorScale, sharedColorRows } from "./layers.js";
|
|
14
|
+
import { binAriaLabel, contourAriaLabel } from "./tooltip.js";
|
|
15
|
+
import { HEXBIN_SHAPE, hexbinMeta, hexbinSettings } from "./settings.js";
|
|
16
|
+
/** An axis's pixel-to-value function for this paint, or `NaN` without one. */ function pixelInverse(viz, axis, offset) {
|
|
17
|
+
const scale = (axis === "x" ? viz._xAxis : viz._yAxis)?._d3Scale;
|
|
18
|
+
return (px)=>scale && scale.invert ? Number(scale.invert(px + offset)) : NaN;
|
|
19
|
+
}
|
|
20
|
+
/** The observations of a shape group, placed in pixels. */ export function pixelPoints(ctx, settings) {
|
|
21
|
+
const rows = ctx.values;
|
|
22
|
+
const { weight } = settings;
|
|
23
|
+
return rows.map((d)=>({
|
|
24
|
+
x: ctx.x(d.x),
|
|
25
|
+
y: ctx.y(d.y),
|
|
26
|
+
row: d.data,
|
|
27
|
+
weight: weight ? Number(weight(d.data, d.i)) : undefined
|
|
28
|
+
}));
|
|
29
|
+
}
|
|
30
|
+
/** The paint a level's contour takes: colored by level, filled with an opacity ramp. */ function contourStyle(viz, settings, fill) {
|
|
31
|
+
const { strokeWidth, fillOpacity } = settings.contourConfig;
|
|
32
|
+
const overBins = Boolean(settings.shape);
|
|
33
|
+
const ramp = (d)=>{
|
|
34
|
+
const meta = hexbinMeta(d);
|
|
35
|
+
return meta && meta.kind === "contour" ? fillOpacity * (meta.index + 1) / meta.levels : fillOpacity;
|
|
36
|
+
};
|
|
37
|
+
if (settings.contours === "filled") return {
|
|
38
|
+
fillOpacity: ramp,
|
|
39
|
+
stroke: fill,
|
|
40
|
+
strokeWidth: 0
|
|
41
|
+
};
|
|
42
|
+
// Lines over bins take the chart's ink, so they show against the bins'
|
|
43
|
+
// colors. The fill stays, invisible, so a region hovers anywhere inside.
|
|
44
|
+
return {
|
|
45
|
+
fillOpacity: 0,
|
|
46
|
+
stroke: overBins ? ()=>backgroundInk(viz) : fill,
|
|
47
|
+
strokeWidth
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
/** Draws bin or contour rows as `"Hexbin"` Paths. */ function emitPaths(ctx, rows, style, interactive) {
|
|
51
|
+
if (!rows.length) return [];
|
|
52
|
+
const { viz } = ctx;
|
|
53
|
+
const base = shapeConfigFor(viz, HEXBIN_SHAPE);
|
|
54
|
+
const path = makeShape("Path").renderMode("compute").config(base).config(style(base)).config({
|
|
55
|
+
ariaLabel: (d)=>hexbinMeta(d)?.kind === "contour" ? contourAriaLabel(viz, d) : binAriaLabel(viz, d),
|
|
56
|
+
d: (d)=>hexbinMeta(d)?.path ?? "",
|
|
57
|
+
id: (d)=>d.id,
|
|
58
|
+
label: false,
|
|
59
|
+
x: 0,
|
|
60
|
+
y: 0
|
|
61
|
+
}).data(rows);
|
|
62
|
+
if (interactive) viz._wirePlotShapeEvents(path, HEXBIN_SHAPE, ctx.events);
|
|
63
|
+
return collectComputed(path).map((node)=>({
|
|
64
|
+
...node,
|
|
65
|
+
shapeType: HEXBIN_SHAPE,
|
|
66
|
+
...interactive ? {} : {
|
|
67
|
+
interactive: false
|
|
68
|
+
}
|
|
69
|
+
}));
|
|
70
|
+
}
|
|
71
|
+
/** The observations as one inert path of dots beneath the bins and contours. */ function emitPoints(viz, points, settings) {
|
|
72
|
+
const d = pointPath(points, settings.pointConfig.r);
|
|
73
|
+
if (!d) return [];
|
|
74
|
+
return [
|
|
75
|
+
{
|
|
76
|
+
type: "path",
|
|
77
|
+
key: "hexbin-points",
|
|
78
|
+
d,
|
|
79
|
+
interactive: false,
|
|
80
|
+
aria: {
|
|
81
|
+
hidden: true
|
|
82
|
+
},
|
|
83
|
+
paint: {
|
|
84
|
+
fill: settings.pointConfig.fill ?? backgroundInk(viz),
|
|
85
|
+
fillOpacity: settings.pointConfig.fillOpacity
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
];
|
|
89
|
+
}
|
|
90
|
+
/** The trend lines in pixels, for the contour labels to keep clear of. */ function trendPoints(ctx) {
|
|
91
|
+
return (ctx.viz._trendFits ?? []).map((fit)=>fit.samples.map((s)=>[
|
|
92
|
+
ctx.x(s.x),
|
|
93
|
+
ctx.y(s.y)
|
|
94
|
+
]).filter(([x, y])=>Number.isFinite(x) && Number.isFinite(y)));
|
|
95
|
+
}
|
|
96
|
+
/** Where the bin grid is anchored: the smallest observation, so a pan moves the grid with the data. */ function gridOrigin(ctx, frame) {
|
|
97
|
+
const anchor = hexbinState(ctx.viz).anchor;
|
|
98
|
+
const ox = anchor ? ctx.x(anchor[0]) : NaN;
|
|
99
|
+
const oy = anchor ? ctx.y(anchor[1]) : NaN;
|
|
100
|
+
return [
|
|
101
|
+
Number.isFinite(ox) ? ox : frame.left,
|
|
102
|
+
Number.isFinite(oy) ? oy : frame.top + frame.height
|
|
103
|
+
];
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
Emits a Hexbin's observations: the raw points (`points`), the bins
|
|
107
|
+
(`binShape`), then the density contours (`contours`) and their level
|
|
108
|
+
labels. Each paint, zoomed
|
|
109
|
+
or not, refits the colorScale to the bins in view (or the contour
|
|
110
|
+
levels), so the fills and the colorScale agree and the densest bin in
|
|
111
|
+
view takes the top color.
|
|
112
|
+
*/ export const hexbinEmit = (ctx)=>{
|
|
113
|
+
const { viz } = ctx;
|
|
114
|
+
const settings = hexbinSettings(viz);
|
|
115
|
+
const frame = plotFrame(ctx);
|
|
116
|
+
const points = pixelPoints(ctx, settings);
|
|
117
|
+
const invert = {
|
|
118
|
+
x: pixelInverse(viz, "x", 0),
|
|
119
|
+
y: pixelInverse(viz, "y", ctx.x2Height ?? 0)
|
|
120
|
+
};
|
|
121
|
+
const origin = gridOrigin(ctx, frame);
|
|
122
|
+
const pixelBins = settings.shape ? binPoints(points, {
|
|
123
|
+
shape: settings.shape,
|
|
124
|
+
size: settings.size,
|
|
125
|
+
origin
|
|
126
|
+
}) : [];
|
|
127
|
+
const bins = binRows(pixelBins, settings, invert);
|
|
128
|
+
const contours = settings.contours ? contourRows(points, frame, settings) : [];
|
|
129
|
+
const inView = new Set(binsInView(pixelBins, frame, settings).map((b)=>`bin-${b.key}`));
|
|
130
|
+
refreshColorScale(viz, sharedColorRows(ctx, settings.shape ? bins.filter((r)=>inView.has(String(r.id))) : contours, frame, origin, settings));
|
|
131
|
+
const fillOf = (base)=>{
|
|
132
|
+
const fill = base.fill;
|
|
133
|
+
return (d, i)=>typeof fill === "function" ? fill(d, i) : fill;
|
|
134
|
+
};
|
|
135
|
+
const contourNodes = emitPaths(ctx, contours, (base)=>contourStyle(viz, settings, fillOf(base)), !settings.shape);
|
|
136
|
+
return [
|
|
137
|
+
...settings.points ? emitPoints(viz, points, settings) : [],
|
|
138
|
+
...emitPaths(ctx, bins, ()=>({}), true),
|
|
139
|
+
...contourNodes,
|
|
140
|
+
...emitContourLabels(viz, contours, contourNodes, frame, settings, trendPoints(ctx))
|
|
141
|
+
];
|
|
142
|
+
};
|
|
@@ -0,0 +1,206 @@
|
|
|
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
|
+
*/ import constant from "../../utils/constant.js";
|
|
6
|
+
import { makeChart } from "../definition/makeChart.js";
|
|
7
|
+
import Plot from "../Plot/index.js";
|
|
8
|
+
import { chartBackground } from "../viz/backgroundInk.js";
|
|
9
|
+
import { optionalAccessor } from "../viz/vizFields.js";
|
|
10
|
+
import { hexbinBuffer } from "./buffer.js";
|
|
11
|
+
import { hexbinEmit } from "./emit.js";
|
|
12
|
+
import { colorScaleRows, hexbinState, isNumeric, noteDrawRows } from "./layers.js";
|
|
13
|
+
import { BIN_SIZE, CONTOUR_DEFAULTS, HEXBIN_SHAPE, POINT_DEFAULTS, hexbinMeta, hexbinValue, unwrapHexbinRow } from "./settings.js";
|
|
14
|
+
import { hexbinTooltipRows, hexbinTooltipTitle } from "./tooltip.js";
|
|
15
|
+
/**
|
|
16
|
+
Keeps the rows with numeric x and y as the chart's data; the rest are
|
|
17
|
+
skipped. The user's rows stay the chart's source data.
|
|
18
|
+
*/ export function keepNumericRows(viz) {
|
|
19
|
+
const state = hexbinState(viz);
|
|
20
|
+
if (viz._data !== state.rows) state.raw = viz._data;
|
|
21
|
+
viz._sourceData = state.raw;
|
|
22
|
+
const valid = state.raw.filter((d, i)=>isNumeric(viz._x(d, i)) && isNumeric(viz._y(d, i)));
|
|
23
|
+
state.rows = viz._data = valid.length === state.raw.length ? state.raw : valid;
|
|
24
|
+
}
|
|
25
|
+
/** Hovering a bin or contour highlights just that mark. */ function installHover(viz) {
|
|
26
|
+
const base = viz.schema.on.mouseenter;
|
|
27
|
+
viz.schema.on.mouseenter = (d, i, ...rest)=>{
|
|
28
|
+
if (!hexbinMeta(d) || viz.schema.shapeConfig.hoverOpacity === 1) return base(d, i, ...rest);
|
|
29
|
+
const target = unwrapHexbinRow(d);
|
|
30
|
+
viz._hoverBucket = false;
|
|
31
|
+
viz.hover((h)=>unwrapHexbinRow(h) === target);
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
export const hexbinDef = {
|
|
35
|
+
name: "Hexbin",
|
|
36
|
+
paintDriven: true,
|
|
37
|
+
setup: (viz)=>{
|
|
38
|
+
viz.ctx.hexbin = {
|
|
39
|
+
raw: [],
|
|
40
|
+
rows: []
|
|
41
|
+
};
|
|
42
|
+
viz._buffer = {
|
|
43
|
+
...viz._buffer,
|
|
44
|
+
[HEXBIN_SHAPE]: hexbinBuffer
|
|
45
|
+
};
|
|
46
|
+
viz._plotShapeEmitters = {
|
|
47
|
+
[HEXBIN_SHAPE]: hexbinEmit
|
|
48
|
+
};
|
|
49
|
+
// Every observation is binned on its own, whatever its groupBy id.
|
|
50
|
+
viz._unmergedShapes = [
|
|
51
|
+
HEXBIN_SHAPE
|
|
52
|
+
];
|
|
53
|
+
// The colorScale reads the bins, which are measured in the plot area.
|
|
54
|
+
viz._colorScaleRows = ()=>colorScaleRows(viz);
|
|
55
|
+
// The tooltip's own rows give a bin's ranges.
|
|
56
|
+
viz._tooltipAxisRows = false;
|
|
57
|
+
// A bin has no single point to snap a tooltip to.
|
|
58
|
+
viz._sharedHover = ()=>undefined;
|
|
59
|
+
installHover(viz);
|
|
60
|
+
const preDraw = viz._preDraw.bind(viz);
|
|
61
|
+
viz._preDraw = ()=>{
|
|
62
|
+
keepNumericRows(viz);
|
|
63
|
+
preDraw();
|
|
64
|
+
};
|
|
65
|
+
const draw = viz._draw.bind(viz);
|
|
66
|
+
viz._draw = (callback)=>{
|
|
67
|
+
// Small-multiples panels share the grid anchor and colorScale noted
|
|
68
|
+
// from every panel's rows.
|
|
69
|
+
if (viz._facetStep !== "panel") noteDrawRows(viz);
|
|
70
|
+
return draw(callback);
|
|
71
|
+
};
|
|
72
|
+
},
|
|
73
|
+
// Its tooltip title reads each bin's measure, its colorScale value.
|
|
74
|
+
colorScaleTooltip: false,
|
|
75
|
+
ctx: {},
|
|
76
|
+
fields: [
|
|
77
|
+
/**
|
|
78
|
+
The bin shape: `"hex"` (default) for hexagons, `"square"` for
|
|
79
|
+
squares, or `false` to draw no bins (for contours alone).
|
|
80
|
+
@type {"hex" | "square" | false}
|
|
81
|
+
*/ {
|
|
82
|
+
key: "binShape",
|
|
83
|
+
default: "hex"
|
|
84
|
+
},
|
|
85
|
+
/**
|
|
86
|
+
The bin size in pixels: a hexagon's radius, or a square's side.
|
|
87
|
+
Bins keep this size at any zoom: the observations are binned again
|
|
88
|
+
for each view, and the colorScale refits to the bins in view.
|
|
89
|
+
Defaults to 12.
|
|
90
|
+
*/ {
|
|
91
|
+
key: "binSize",
|
|
92
|
+
default: BIN_SIZE
|
|
93
|
+
},
|
|
94
|
+
/**
|
|
95
|
+
What each bin measures, which its color shows: `"count"` (default),
|
|
96
|
+
the number of observations in the bin; or `{value, agg, label}`,
|
|
97
|
+
the `"sum"` (default) or `"mean"` of `value` (a data key or
|
|
98
|
+
accessor) over the bin's observations, named `label` in the
|
|
99
|
+
tooltip.
|
|
100
|
+
@type {"count" | {value: string | function, agg?: "sum" | "mean", label?: string}}
|
|
101
|
+
*/ {
|
|
102
|
+
key: "binValue",
|
|
103
|
+
default: "count"
|
|
104
|
+
},
|
|
105
|
+
/**
|
|
106
|
+
Draws density contours: `"lines"` (or `true`) outlines each density
|
|
107
|
+
level in its color, and `"filled"` fills each level with an opacity
|
|
108
|
+
ramp. Levels are in observations per bin (the count a bin would hold
|
|
109
|
+
there), so contours share the bins' colorScale. Contours over bins
|
|
110
|
+
are drawn in the chart's text color and don't take hover. Defaults to
|
|
111
|
+
`false`.
|
|
112
|
+
@type {boolean | "lines" | "filled"}
|
|
113
|
+
*/ {
|
|
114
|
+
key: "contours",
|
|
115
|
+
default: false
|
|
116
|
+
},
|
|
117
|
+
/**
|
|
118
|
+
Contour options: `bandwidth`, the density kernel's standard deviation
|
|
119
|
+
in pixels (default 20); `thresholds`, about how many levels to draw
|
|
120
|
+
(default 8, rounded to nice values) or the levels themselves;
|
|
121
|
+
`strokeWidth`, the outline width of `"lines"` (default 1.5);
|
|
122
|
+
`fillOpacity`, the opacity of the highest `"filled"` level (default
|
|
123
|
+
0.8); `labels`, which writes each level's value along its contour
|
|
124
|
+
(default `true`); `labelConfig`, TextBox config for those labels
|
|
125
|
+
(`fontSize` defaults to 10); `labelSpacing`, the least distance
|
|
126
|
+
between two labels along a line, in pixels (default `"auto"`); and
|
|
127
|
+
`labelStep`, which labels every n-th level (default `"auto"`: all of
|
|
128
|
+
up to five levels, else every other one).
|
|
129
|
+
@type {{bandwidth?: number, thresholds?: number | number[], strokeWidth?: number, fillOpacity?: number, labels?: boolean, labelConfig?: object, labelSpacing?: number | "auto", labelStep?: number | "auto"}}
|
|
130
|
+
*/ {
|
|
131
|
+
key: "contourConfig",
|
|
132
|
+
merge: true,
|
|
133
|
+
default: CONTOUR_DEFAULTS
|
|
134
|
+
},
|
|
135
|
+
/** Formats the contour labels' and tooltips' level values. Defaults to the abbreviated number format (`1.5k`). */ {
|
|
136
|
+
key: "levelFormat"
|
|
137
|
+
},
|
|
138
|
+
/** Draws the raw observations as small dots beneath the bins and contours. Defaults to `false`. */ {
|
|
139
|
+
key: "points",
|
|
140
|
+
default: false
|
|
141
|
+
},
|
|
142
|
+
/**
|
|
143
|
+
The raw observations' style: `r`, the dot radius in pixels (default
|
|
144
|
+
1.5); `fill` (defaults to the chart's text color); and `fillOpacity`
|
|
145
|
+
(default 0.35).
|
|
146
|
+
@type {{r?: number, fill?: string, fillOpacity?: number}}
|
|
147
|
+
*/ {
|
|
148
|
+
key: "pointConfig",
|
|
149
|
+
merge: true,
|
|
150
|
+
default: POINT_DEFAULTS
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
key: "colorScale",
|
|
154
|
+
coerce: optionalAccessor,
|
|
155
|
+
default: hexbinValue
|
|
156
|
+
},
|
|
157
|
+
/** A continuous color scale: bins and contours shade smoothly by value. */ {
|
|
158
|
+
key: "colorScaleConfig",
|
|
159
|
+
merge: true,
|
|
160
|
+
default: {
|
|
161
|
+
scale: "linear"
|
|
162
|
+
}
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
key: "legend",
|
|
166
|
+
default: false,
|
|
167
|
+
coerce: "const"
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
key: "shape",
|
|
171
|
+
default: constant(HEXBIN_SHAPE),
|
|
172
|
+
coerce: "const"
|
|
173
|
+
},
|
|
174
|
+
/**
|
|
175
|
+
Bins are outlined in the chart's background color, so neighbors stay
|
|
176
|
+
distinct.
|
|
177
|
+
*/ {
|
|
178
|
+
key: "shapeConfig",
|
|
179
|
+
merge: true,
|
|
180
|
+
factory: (viz)=>({
|
|
181
|
+
[HEXBIN_SHAPE]: {
|
|
182
|
+
stroke: ()=>chartBackground(viz),
|
|
183
|
+
strokeWidth: constant(0.5)
|
|
184
|
+
}
|
|
185
|
+
})
|
|
186
|
+
},
|
|
187
|
+
{
|
|
188
|
+
key: "tooltipConfig",
|
|
189
|
+
merge: true,
|
|
190
|
+
factory: (viz)=>({
|
|
191
|
+
title: (d)=>hexbinTooltipTitle(viz, d),
|
|
192
|
+
tbody: (d)=>hexbinTooltipRows(viz, d)
|
|
193
|
+
})
|
|
194
|
+
}
|
|
195
|
+
]
|
|
196
|
+
};
|
|
197
|
+
/**
|
|
198
|
+
Creates a 2D binned density chart from raw observations: each row is a
|
|
199
|
+
point at its `x` and `y` values (rows without numeric values are
|
|
200
|
+
skipped), and the points are grouped into hexagons (`binShape`) of
|
|
201
|
+
`binSize` pixels, colored on the colorScale by how many each holds (or by
|
|
202
|
+
`binValue`). Empty bins aren't drawn. `contours` adds density contours,
|
|
203
|
+
and `points` draws the observations beneath. `groupBy` names the
|
|
204
|
+
observations for `filter` and the legend (off by default), and `facet`
|
|
205
|
+
bins each panel on its own, on one shared colorScale.
|
|
206
|
+
*/ export default makeChart(hexbinDef, Plot);
|