@d3plus/core 4.9.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +170 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +17 -12
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Funnel/index.js +2 -1
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Gauge/index.js +2 -1
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +60 -19
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +37 -16
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/index.js +3 -2
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +93 -108
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +7 -2
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +66 -32
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +14 -4
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +5 -5
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +65 -30
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +75 -77
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +42 -15
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +123 -0
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +34 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +67 -79
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/facet/facetData.d.ts +1 -1
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +13 -1
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/features.d.ts +8 -0
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +19 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/missingFields.d.ts +57 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +2 -8
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's pure binning helpers: points in pixel space grouped into
|
|
3
|
+
hexagons (d3-hexbin) or squares of a fixed pixel size, each bin's
|
|
4
|
+
measure (a count, or a sum or mean of a value), and its outline.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/ import { hexbin } from "d3-hexbin";
|
|
8
|
+
const SQRT3 = Math.sqrt(3);
|
|
9
|
+
/** Whether a point has finite pixel coordinates. */ const placed = (p)=>Number.isFinite(p.x) && Number.isFinite(p.y);
|
|
10
|
+
/**
|
|
11
|
+
Groups points into bins of a fixed pixel size: pointy-top hexagons of
|
|
12
|
+
radius `size`, or `size`-pixel squares. The grid is anchored at `origin`,
|
|
13
|
+
so a grid anchored to a data point moves with it when the view pans.
|
|
14
|
+
Points without finite coordinates are skipped, and only bins holding a
|
|
15
|
+
point are returned.
|
|
16
|
+
@param points The points, in pixels.
|
|
17
|
+
@param options `shape`, `size` (hexagon radius or square side, in
|
|
18
|
+
pixels), and the grid's `origin`.
|
|
19
|
+
*/ export function binPoints(points, options) {
|
|
20
|
+
const { shape, size } = options;
|
|
21
|
+
const [ox, oy] = options.origin ?? [
|
|
22
|
+
0,
|
|
23
|
+
0
|
|
24
|
+
];
|
|
25
|
+
const valid = points.filter(placed);
|
|
26
|
+
if (!(size > 0) || !valid.length) return [];
|
|
27
|
+
if (shape === "square") {
|
|
28
|
+
const bins = new Map();
|
|
29
|
+
for (const p of valid){
|
|
30
|
+
const col = Math.floor((p.x - ox) / size);
|
|
31
|
+
const row = Math.floor((p.y - oy) / size);
|
|
32
|
+
const key = `s${col}_${row}`;
|
|
33
|
+
let bin = bins.get(key);
|
|
34
|
+
if (!bin) {
|
|
35
|
+
bin = {
|
|
36
|
+
key,
|
|
37
|
+
cx: ox + (col + 0.5) * size,
|
|
38
|
+
cy: oy + (row + 0.5) * size,
|
|
39
|
+
points: []
|
|
40
|
+
};
|
|
41
|
+
bins.set(key, bin);
|
|
42
|
+
}
|
|
43
|
+
bin.points.push(p);
|
|
44
|
+
}
|
|
45
|
+
return Array.from(bins.values());
|
|
46
|
+
}
|
|
47
|
+
const dx = size * SQRT3;
|
|
48
|
+
const dy = size * 1.5;
|
|
49
|
+
return hexbin().radius(size).x((p)=>p.x - ox).y((p)=>p.y - oy)(valid).map((bin)=>({
|
|
50
|
+
key: `h${Math.round(2 * bin.x / dx)}_${Math.round(bin.y / dy)}`,
|
|
51
|
+
cx: ox + bin.x,
|
|
52
|
+
cy: oy + bin.y,
|
|
53
|
+
points: Array.from(bin)
|
|
54
|
+
}));
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
A bin's pixel bounds: a hexagon's bounding box (it is `√3 × size` wide
|
|
58
|
+
and `2 × size` tall), or a square's sides.
|
|
59
|
+
*/ export function binBounds(bin, shape, size) {
|
|
60
|
+
const halfW = shape === "square" ? size / 2 : size * SQRT3 / 2;
|
|
61
|
+
const halfH = shape === "square" ? size / 2 : size;
|
|
62
|
+
return {
|
|
63
|
+
x0: bin.cx - halfW,
|
|
64
|
+
x1: bin.cx + halfW,
|
|
65
|
+
y0: bin.cy - halfH,
|
|
66
|
+
y1: bin.cy + halfH
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
/** A bin's outline as an absolute SVG path. */ export function binPath(bin, shape, size) {
|
|
70
|
+
const round = (n)=>Math.round(n * 100) / 100;
|
|
71
|
+
if (shape === "square") {
|
|
72
|
+
const { x0, x1, y0, y1 } = binBounds(bin, shape, size);
|
|
73
|
+
return `M${round(x0)},${round(y0)}H${round(x1)}V${round(y1)}H${round(x0)}Z`;
|
|
74
|
+
}
|
|
75
|
+
const corners = [
|
|
76
|
+
0,
|
|
77
|
+
1,
|
|
78
|
+
2,
|
|
79
|
+
3,
|
|
80
|
+
4,
|
|
81
|
+
5
|
|
82
|
+
].map((k)=>{
|
|
83
|
+
const angle = k * Math.PI / 3;
|
|
84
|
+
return `${round(bin.cx + Math.sin(angle) * size)},${round(bin.cy - Math.cos(angle) * size)}`;
|
|
85
|
+
});
|
|
86
|
+
return `M${corners.join("L")}Z`;
|
|
87
|
+
}
|
|
88
|
+
/** The area one bin covers, in square pixels. */ export function binArea(shape, size) {
|
|
89
|
+
return shape === "square" ? size * size : 3 * SQRT3 / 2 * size * size;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
A bin's measure: its point count, or the sum or mean of its points'
|
|
93
|
+
finite weights. A mean with no finite weight is `NaN`.
|
|
94
|
+
*/ export function binMeasure(points, agg) {
|
|
95
|
+
if (agg === "count") return points.length;
|
|
96
|
+
let total = 0, n = 0;
|
|
97
|
+
for (const p of points)if (typeof p.weight === "number" && Number.isFinite(p.weight)) {
|
|
98
|
+
total += p.weight;
|
|
99
|
+
n++;
|
|
100
|
+
}
|
|
101
|
+
if (agg === "sum") return total;
|
|
102
|
+
return n ? total / n : NaN;
|
|
103
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's axis buffer (see `Plot.buffer`): fits each axis to its numeric
|
|
3
|
+
observations and pads it by a bin, so the outermost bins sit inside the
|
|
4
|
+
plot.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/ import { extent } from "d3-array";
|
|
8
|
+
import numericBuffer from "../plotBuffers/numericBuffer.js";
|
|
9
|
+
import { isNumeric } from "./layers.js";
|
|
10
|
+
import { hexbinSettings } from "./settings.js";
|
|
11
|
+
/** Pads one axis's domain so `values`' extremes sit `size` pixels inside it. */ function padAxis(scale, type, values, size, vertical) {
|
|
12
|
+
if (!scale.invert) return;
|
|
13
|
+
const [lo, hi] = extent(values.filter(isNumeric));
|
|
14
|
+
if (lo === undefined || hi === undefined) return;
|
|
15
|
+
let domain = scale.domain().slice();
|
|
16
|
+
domain = numericBuffer(scale, type, lo, size, domain, 0, vertical);
|
|
17
|
+
numericBuffer(scale, type, hi, size, domain, 1, vertical);
|
|
18
|
+
}
|
|
19
|
+
export function hexbinBuffer({ data, x, y, x2, y2, xScale, yScale }) {
|
|
20
|
+
if (x2 || y2) return [
|
|
21
|
+
x,
|
|
22
|
+
y
|
|
23
|
+
];
|
|
24
|
+
const { size } = hexbinSettings(this);
|
|
25
|
+
x = x.copy();
|
|
26
|
+
y = y.copy();
|
|
27
|
+
padAxis(x, xScale ?? "linear", data.map((d)=>d.x), size, false);
|
|
28
|
+
padAxis(y, yScale ?? "linear", data.map((d)=>d.y), size, true);
|
|
29
|
+
return [
|
|
30
|
+
x,
|
|
31
|
+
y
|
|
32
|
+
];
|
|
33
|
+
}
|
|
@@ -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
|
+
};
|