@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,353 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The bivariate ColorScale's key: its grid of colors turned 45° into a
|
|
3
|
+
diamond, low/low at the bottom corner and high/high at the top, the first
|
|
4
|
+
variable rising toward the right corner and the second toward the left,
|
|
5
|
+
each named along its lower edge.
|
|
6
|
+
*/ import { textWidth } from "@d3plus/dom";
|
|
7
|
+
import { formatAbbreviate } from "@d3plus/format";
|
|
8
|
+
import { fontFamilyStringify, textWrap } from "@d3plus/text";
|
|
9
|
+
import { formatYear, isYearLike } from "../Axis/yearValues.js";
|
|
10
|
+
import { bivariateBucketCount, bivariatePalette, bivariateScale, isBivariatePair } from "./bivariateScale.js";
|
|
11
|
+
/** The side of the key's grid before it turns, in pixels, when it fits. */ const GRID_SIDE = 80;
|
|
12
|
+
/** The gap between the diamond's edge and its labels. */ const LABEL_GAP = 4;
|
|
13
|
+
/** Grid point `(u, v)` (`u` along the first variable, `v` the second) turned into the diamond, low/low at the origin. */ function toDiamond(u, v) {
|
|
14
|
+
return [
|
|
15
|
+
(u - v) * Math.SQRT1_2,
|
|
16
|
+
-(u + v) * Math.SQRT1_2
|
|
17
|
+
];
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
The names the key gives its two variables: `bivariateLabels`, else the
|
|
21
|
+
names the chart passes (its field names).
|
|
22
|
+
@param cs The ColorScale.
|
|
23
|
+
*/ export function bivariateAxisLabels(cs) {
|
|
24
|
+
const own = cs.schema.bivariateLabels;
|
|
25
|
+
const fields = cs._bivariateFields ?? [];
|
|
26
|
+
const pick = (k)=>{
|
|
27
|
+
const label = Array.isArray(own) ? own[k] : undefined;
|
|
28
|
+
const value = label ?? fields[k];
|
|
29
|
+
return value === undefined || value === null ? "" : `${value}`;
|
|
30
|
+
};
|
|
31
|
+
return [
|
|
32
|
+
pick(0),
|
|
33
|
+
pick(1)
|
|
34
|
+
];
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
How a ColorScale's values read in a bivariate key's ranges and in a
|
|
38
|
+
chart's tooltip: `axisConfig.tickFormat`, else a variable whose values
|
|
39
|
+
all read as years as years, else abbreviated (`formatAbbreviate`).
|
|
40
|
+
@param cs The ColorScale.
|
|
41
|
+
@param values The variable's values.
|
|
42
|
+
*/ export function colorScaleValueFormat(cs, values) {
|
|
43
|
+
const tickFormat = cs.schema.axisConfig?.tickFormat;
|
|
44
|
+
if (tickFormat) return tickFormat;
|
|
45
|
+
if (values.length && isYearLike(values)) return (v)=>formatYear(v, cs.schema.locale);
|
|
46
|
+
return (v)=>formatAbbreviate(v, cs.schema.locale);
|
|
47
|
+
}
|
|
48
|
+
/** A bin's range as text (`"lo - hi"`, or one value), or "" for an empty bin. */ function rangeText(cs, bins, b, format) {
|
|
49
|
+
const range = bins.ranges[b];
|
|
50
|
+
if (!range) return "";
|
|
51
|
+
return cs.schema.bucketJoiner(format(range[0]), format(range[1]));
|
|
52
|
+
}
|
|
53
|
+
/** A cell's title: each variable's name and the range of its bin. */ function cellTitle(cs, scale, [i, j], labels, formats) {
|
|
54
|
+
return [
|
|
55
|
+
[
|
|
56
|
+
labels[0],
|
|
57
|
+
rangeText(cs, scale.x, i, formats[0])
|
|
58
|
+
],
|
|
59
|
+
[
|
|
60
|
+
labels[1],
|
|
61
|
+
rangeText(cs, scale.y, j, formats[1])
|
|
62
|
+
]
|
|
63
|
+
].filter(([, range])=>range).map(([label, range])=>label ? `${label}: ${range}` : range).join(", ");
|
|
64
|
+
}
|
|
65
|
+
/** The label font the key reads off `labelConfig`, for `text`. */ function labelFont(cs, text) {
|
|
66
|
+
const read = (key)=>{
|
|
67
|
+
const v = cs._labelClass[key]();
|
|
68
|
+
return typeof v === "function" ? v(text, 0) : v;
|
|
69
|
+
};
|
|
70
|
+
const family = read("fontFamily");
|
|
71
|
+
return {
|
|
72
|
+
family: fontFamilyStringify(family),
|
|
73
|
+
size: Number(read("fontSize")) || 12,
|
|
74
|
+
weight: read("fontWeight") ?? 400,
|
|
75
|
+
color: `${read("fontColor")}`
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
One variable's name along its lower edge of the diamond: up to two lines
|
|
80
|
+
as long as the edge, an arrow pointing the way the variable rises.
|
|
81
|
+
*/ function edgeLabel(cs, text, axis, side) {
|
|
82
|
+
if (!text) return null;
|
|
83
|
+
const font = labelFont(cs, text);
|
|
84
|
+
const style = {
|
|
85
|
+
"font-family": font.family,
|
|
86
|
+
"font-size": font.size,
|
|
87
|
+
"font-weight": font.weight
|
|
88
|
+
};
|
|
89
|
+
const arrow = axis === 0 ? " →" : "← ";
|
|
90
|
+
const arrowWidth = textWidth(arrow, style);
|
|
91
|
+
// Lines as long as the edge, never splitting a word.
|
|
92
|
+
const widest = Math.max(...text.split(/\s+/).map((word)=>textWidth(word, style)));
|
|
93
|
+
const wrapped = textWrap().fontFamily(font.family).fontSize(font.size).fontWeight(font.weight).lineHeight(font.size * 1.2).maxLines(2)// Whole words only: no hyphenating a long one across the lines.
|
|
94
|
+
.split((sentence)=>sentence.match(/\S+\s*/g) ?? []).width(Math.max(side - arrowWidth, widest + 1)).height(font.size * 1.2 * 2 + 1)(text);
|
|
95
|
+
const lines = wrapped.lines.length ? wrapped.lines.slice() : [
|
|
96
|
+
text
|
|
97
|
+
];
|
|
98
|
+
// The arrow rides the line nearest the far corner: the first variable's
|
|
99
|
+
// reads toward its corner at the end of the last line, the second's
|
|
100
|
+
// toward its corner at the start of the first.
|
|
101
|
+
if (axis === 0) lines[lines.length - 1] += arrow;
|
|
102
|
+
else lines[0] = arrow + lines[0];
|
|
103
|
+
const lineHeight = font.size * 1.2;
|
|
104
|
+
const widths = lines.map((l)=>textWidth(l, style));
|
|
105
|
+
const width = Math.max(...widths);
|
|
106
|
+
// The edge's direction (x) and outward normal (y) the label's lines lie
|
|
107
|
+
// along, and the label's center: the edge's midpoint, or, for a label
|
|
108
|
+
// longer than the edge, past it toward the far corner, so the two labels
|
|
109
|
+
// never meet below the bottom corner.
|
|
110
|
+
const rotate = axis === 0 ? -45 : 45;
|
|
111
|
+
const ex = axis === 0 ? [
|
|
112
|
+
Math.SQRT1_2,
|
|
113
|
+
-Math.SQRT1_2
|
|
114
|
+
] : [
|
|
115
|
+
Math.SQRT1_2,
|
|
116
|
+
Math.SQRT1_2
|
|
117
|
+
];
|
|
118
|
+
const shift = (axis === 0 ? 1 : -1) * Math.max(0, width - side) / 2;
|
|
119
|
+
const [ox, oy] = axis === 0 ? toDiamond(side / 2, 0) : toDiamond(0, side / 2);
|
|
120
|
+
const mx = ox + ex[0] * shift;
|
|
121
|
+
const my = oy + ex[1] * shift;
|
|
122
|
+
const ey = axis === 0 ? [
|
|
123
|
+
Math.SQRT1_2,
|
|
124
|
+
Math.SQRT1_2
|
|
125
|
+
] : [
|
|
126
|
+
-Math.SQRT1_2,
|
|
127
|
+
Math.SQRT1_2
|
|
128
|
+
];
|
|
129
|
+
const depth = LABEL_GAP + lineHeight * lines.length;
|
|
130
|
+
const corners = [
|
|
131
|
+
[
|
|
132
|
+
-width / 2,
|
|
133
|
+
LABEL_GAP
|
|
134
|
+
],
|
|
135
|
+
[
|
|
136
|
+
width / 2,
|
|
137
|
+
LABEL_GAP
|
|
138
|
+
],
|
|
139
|
+
[
|
|
140
|
+
-width / 2,
|
|
141
|
+
depth
|
|
142
|
+
],
|
|
143
|
+
[
|
|
144
|
+
width / 2,
|
|
145
|
+
depth
|
|
146
|
+
]
|
|
147
|
+
].map(([lx, ly])=>[
|
|
148
|
+
mx + ex[0] * lx + ey[0] * ly,
|
|
149
|
+
my + ex[1] * lx + ey[1] * ly
|
|
150
|
+
]);
|
|
151
|
+
const node = {
|
|
152
|
+
type: "text",
|
|
153
|
+
key: `bivariate-label-${axis}`,
|
|
154
|
+
x: 0,
|
|
155
|
+
y: 0,
|
|
156
|
+
transform: {
|
|
157
|
+
x: mx,
|
|
158
|
+
y: my,
|
|
159
|
+
rotate
|
|
160
|
+
},
|
|
161
|
+
lines: lines.map((line, k)=>({
|
|
162
|
+
text: line,
|
|
163
|
+
x: 0,
|
|
164
|
+
y: LABEL_GAP + lineHeight * (k + 0.5),
|
|
165
|
+
width: widths[k]
|
|
166
|
+
})),
|
|
167
|
+
font: {
|
|
168
|
+
family: font.family,
|
|
169
|
+
size: font.size,
|
|
170
|
+
weight: font.weight,
|
|
171
|
+
anchor: "middle",
|
|
172
|
+
baseline: "middle"
|
|
173
|
+
},
|
|
174
|
+
paint: {
|
|
175
|
+
fill: font.color
|
|
176
|
+
},
|
|
177
|
+
interactive: false,
|
|
178
|
+
aria: {
|
|
179
|
+
hidden: true
|
|
180
|
+
}
|
|
181
|
+
};
|
|
182
|
+
return {
|
|
183
|
+
node,
|
|
184
|
+
corners
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
/**
|
|
188
|
+
A key cell's stroke: the one `legendConfig.shapeConfig` gives the
|
|
189
|
+
colorScale's swatches, which a chart sets to its own shapes' stroke.
|
|
190
|
+
*/ function cellStroke(cs, datum, i) {
|
|
191
|
+
const sc = cs.schema.legendConfig?.shapeConfig ?? {};
|
|
192
|
+
const read = (key)=>{
|
|
193
|
+
const v = sc[key];
|
|
194
|
+
return typeof v === "function" ? v(datum, i) : v;
|
|
195
|
+
};
|
|
196
|
+
const stroke = read("stroke");
|
|
197
|
+
const strokeWidth = Number(read("strokeWidth"));
|
|
198
|
+
const strokeOpacity = read("strokeOpacity");
|
|
199
|
+
if (typeof stroke !== "string" || !stroke || !(strokeWidth > 0)) return {};
|
|
200
|
+
return {
|
|
201
|
+
stroke,
|
|
202
|
+
strokeWidth,
|
|
203
|
+
...typeof strokeOpacity === "number" ? {
|
|
204
|
+
strokeOpacity
|
|
205
|
+
} : {}
|
|
206
|
+
};
|
|
207
|
+
}
|
|
208
|
+
/** The key's cells, a path each, and their corners. */ function cellNodes(cs, scale, side) {
|
|
209
|
+
const n = scale.size;
|
|
210
|
+
const step = side / n;
|
|
211
|
+
const labels = bivariateAxisLabels(cs);
|
|
212
|
+
const values = (bins)=>scale.domain().map((p)=>p[bins]);
|
|
213
|
+
const formats = [
|
|
214
|
+
colorScaleValueFormat(cs, values(0)),
|
|
215
|
+
colorScaleValueFormat(cs, values(1))
|
|
216
|
+
];
|
|
217
|
+
const nodes = [];
|
|
218
|
+
for(let j = 0; j < n; j++)for(let i = 0; i < n; i++){
|
|
219
|
+
const points = [
|
|
220
|
+
toDiamond(i * step, j * step),
|
|
221
|
+
toDiamond((i + 1) * step, j * step),
|
|
222
|
+
toDiamond((i + 1) * step, (j + 1) * step),
|
|
223
|
+
toDiamond(i * step, (j + 1) * step)
|
|
224
|
+
];
|
|
225
|
+
const datum = {
|
|
226
|
+
color: scale.colors[j * n + i],
|
|
227
|
+
id: cellTitle(cs, scale, [
|
|
228
|
+
i,
|
|
229
|
+
j
|
|
230
|
+
], labels, formats),
|
|
231
|
+
_isColorScaleBucket: true,
|
|
232
|
+
_bivariateX: i,
|
|
233
|
+
_bivariateY: j
|
|
234
|
+
};
|
|
235
|
+
nodes.push({
|
|
236
|
+
type: "path",
|
|
237
|
+
key: `bivariate-cell-${i}-${j}`,
|
|
238
|
+
d: `M${points.map((p)=>p.map((v)=>+v.toFixed(3)).join(",")).join("L")}Z`,
|
|
239
|
+
datum,
|
|
240
|
+
index: j * n + i,
|
|
241
|
+
paint: {
|
|
242
|
+
fill: datum.color,
|
|
243
|
+
...cellStroke(cs, datum, j * n + i)
|
|
244
|
+
},
|
|
245
|
+
aria: {
|
|
246
|
+
label: datum.id
|
|
247
|
+
}
|
|
248
|
+
});
|
|
249
|
+
}
|
|
250
|
+
return {
|
|
251
|
+
nodes,
|
|
252
|
+
corners: [
|
|
253
|
+
toDiamond(0, 0),
|
|
254
|
+
toDiamond(side, 0),
|
|
255
|
+
toDiamond(0, side),
|
|
256
|
+
toDiamond(side, side)
|
|
257
|
+
]
|
|
258
|
+
};
|
|
259
|
+
}
|
|
260
|
+
/** Lays the key out with a grid `side` pixels across, low/low corner at the origin. */ function layoutAt(cs, scale, side) {
|
|
261
|
+
const cells = cellNodes(cs, scale, side);
|
|
262
|
+
const labels = bivariateAxisLabels(cs);
|
|
263
|
+
const edges = [
|
|
264
|
+
edgeLabel(cs, labels[0], 0, side),
|
|
265
|
+
edgeLabel(cs, labels[1], 1, side)
|
|
266
|
+
].filter(Boolean);
|
|
267
|
+
const corners = cells.corners.concat(...edges.map((e)=>e.corners));
|
|
268
|
+
const xs = corners.map((c)=>c[0]);
|
|
269
|
+
const ys = corners.map((c)=>c[1]);
|
|
270
|
+
const x = Math.min(...xs);
|
|
271
|
+
const y = Math.min(...ys);
|
|
272
|
+
return {
|
|
273
|
+
nodes: [
|
|
274
|
+
...cells.nodes,
|
|
275
|
+
...edges.map((e)=>e.node)
|
|
276
|
+
],
|
|
277
|
+
bounds: {
|
|
278
|
+
x,
|
|
279
|
+
y,
|
|
280
|
+
width: Math.max(...xs) - x,
|
|
281
|
+
height: Math.max(...ys) - y
|
|
282
|
+
}
|
|
283
|
+
};
|
|
284
|
+
}
|
|
285
|
+
/**
|
|
286
|
+
Lays the key out within the ColorScale's `width` × `height`: its grid
|
|
287
|
+
shrinks from its full size to fit, and it sits along the side its labels
|
|
288
|
+
face (`orient`) at its `align`ment, as the swatch legend does.
|
|
289
|
+
@param cs The ColorScale.
|
|
290
|
+
@param scale Its bivariate scale.
|
|
291
|
+
*/ export function layoutBivariate(cs, scale) {
|
|
292
|
+
const width = Number(cs.schema.width) || 0;
|
|
293
|
+
const height = Number(cs.schema.height) || 0;
|
|
294
|
+
let side = GRID_SIDE;
|
|
295
|
+
let layout = layoutAt(cs, scale, side);
|
|
296
|
+
// Labels keep their size as the grid shrinks (and may wrap anew): shrink
|
|
297
|
+
// the grid by what the whole key overflows until it fits, down to a third
|
|
298
|
+
// of its size.
|
|
299
|
+
for(let tries = 0; tries < 4 && side > GRID_SIDE / 3; tries++){
|
|
300
|
+
const over = Math.max(layout.bounds.width - width, layout.bounds.height - height);
|
|
301
|
+
if (over <= 0 || !width || !height) break;
|
|
302
|
+
side = Math.max(GRID_SIDE / 3, side - over * Math.SQRT1_2 - 1);
|
|
303
|
+
layout = layoutAt(cs, scale, side);
|
|
304
|
+
}
|
|
305
|
+
const horizontal = [
|
|
306
|
+
"bottom",
|
|
307
|
+
"top"
|
|
308
|
+
].includes(cs.schema.orient);
|
|
309
|
+
const spare = (room, size)=>{
|
|
310
|
+
const align = cs.schema.align;
|
|
311
|
+
const free = Math.max(0, room - size);
|
|
312
|
+
return align === "start" ? 0 : align === "end" ? free : free / 2;
|
|
313
|
+
};
|
|
314
|
+
const left = horizontal ? Math.max(0, width - layout.bounds.width) / 2 : spare(width, layout.bounds.width);
|
|
315
|
+
const top = horizontal ? spare(height, layout.bounds.height) : Math.max(0, height - layout.bounds.height) / 2;
|
|
316
|
+
const dx = left - layout.bounds.x;
|
|
317
|
+
const dy = top - layout.bounds.y;
|
|
318
|
+
return {
|
|
319
|
+
nodes: [
|
|
320
|
+
{
|
|
321
|
+
type: "group",
|
|
322
|
+
key: "bivariate-key",
|
|
323
|
+
transform: {
|
|
324
|
+
x: dx,
|
|
325
|
+
y: dy
|
|
326
|
+
},
|
|
327
|
+
children: layout.nodes
|
|
328
|
+
}
|
|
329
|
+
],
|
|
330
|
+
bounds: {
|
|
331
|
+
x: left,
|
|
332
|
+
y: top,
|
|
333
|
+
width: layout.bounds.width,
|
|
334
|
+
height: layout.bounds.height
|
|
335
|
+
}
|
|
336
|
+
};
|
|
337
|
+
}
|
|
338
|
+
/**
|
|
339
|
+
Builds a bivariate ColorScale's scale from its data (each row's `value`
|
|
340
|
+
a pair of numbers), assigns it as the ColorScale's `_colorScale`, and
|
|
341
|
+
lays out its diamond key.
|
|
342
|
+
@param cs The ColorScale.
|
|
343
|
+
*/ export function renderBivariate(cs) {
|
|
344
|
+
const n = bivariateBucketCount(cs.schema.bivariateBuckets);
|
|
345
|
+
const pairs = cs._data.map((d, i)=>cs.schema.value(d, i)).filter(isBivariatePair);
|
|
346
|
+
const scale = bivariateScale(pairs, n, bivariatePalette(cs.schema.bivariateColors, n));
|
|
347
|
+
cs._colorScale = scale;
|
|
348
|
+
cs._barGeometry = undefined;
|
|
349
|
+
cs._labelClass.config(cs.schema.labelConfig);
|
|
350
|
+
const layout = layoutBivariate(cs, scale);
|
|
351
|
+
cs._outerBounds = layout.bounds;
|
|
352
|
+
return layout;
|
|
353
|
+
}
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The scale behind a bivariate ColorScale: each of two variables split into
|
|
3
|
+
quantile bins, and the grid of colors the pair of bins picks from.
|
|
4
|
+
*/ import { ascending, bisectLeft, bisectRight } from "d3-array";
|
|
5
|
+
import { rgb } from "d3-color";
|
|
6
|
+
import { interpolateRgb } from "d3-interpolate";
|
|
7
|
+
/**
|
|
8
|
+
Joshua Stevens' blue–red 3×3 scheme, from "Bivariate Choropleth Maps: A
|
|
9
|
+
How-to Guide" (joshuastevens.net/cartography/make-a-bivariate-choropleth-map/),
|
|
10
|
+
with the hex values as published in the R `pals` package
|
|
11
|
+
(`stevens.bluered`). Row-major from the low/low corner: each row is one
|
|
12
|
+
bin of the second variable (low to high), each column one bin of the
|
|
13
|
+
first (low to high). The first variable rises toward red (#c85a5a), the
|
|
14
|
+
second toward blue (#64acbe), and both together toward #574249. Each
|
|
15
|
+
inner color is the two ramps multiplied over the shared #e8e8e8 base.
|
|
16
|
+
*/ export const BIVARIATE_COLORS = [
|
|
17
|
+
"#e8e8e8",
|
|
18
|
+
"#e4acac",
|
|
19
|
+
"#c85a5a",
|
|
20
|
+
"#b0d5df",
|
|
21
|
+
"#ad9ea5",
|
|
22
|
+
"#985356",
|
|
23
|
+
"#64acbe",
|
|
24
|
+
"#627f8c",
|
|
25
|
+
"#574249"
|
|
26
|
+
];
|
|
27
|
+
/** The fewest and most bins a bivariate ColorScale splits each variable into. */ export const BIVARIATE_MIN_BUCKETS = 2;
|
|
28
|
+
export const BIVARIATE_MAX_BUCKETS = 4;
|
|
29
|
+
/** The bins per variable when none is set. */ export const BIVARIATE_BUCKETS = 3;
|
|
30
|
+
/**
|
|
31
|
+
The number of bins per variable: `value` rounded and held within 2–4, or
|
|
32
|
+
3 when it isn't a number.
|
|
33
|
+
@param value The configured bin count.
|
|
34
|
+
*/ export function bivariateBucketCount(value) {
|
|
35
|
+
if (typeof value !== "number" || !Number.isFinite(value)) return BIVARIATE_BUCKETS;
|
|
36
|
+
return Math.min(BIVARIATE_MAX_BUCKETS, Math.max(BIVARIATE_MIN_BUCKETS, Math.round(value)));
|
|
37
|
+
}
|
|
38
|
+
/** The side of a square grid of `length` colors, or 0 when it isn't one of at least 2×2. */ function gridSide(length) {
|
|
39
|
+
const side = Math.round(Math.sqrt(length));
|
|
40
|
+
return side >= 2 && side * side === length ? side : 0;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
Resamples a square grid of colors (row-major, `k×k`) to `n×n`: a grid
|
|
44
|
+
already `n×n` is returned as given, and any other is blended
|
|
45
|
+
bilinearly between its nearest colors, so its corners stay put. A 3×3
|
|
46
|
+
scheme resampled to 4×4 keeps its corners and blends its middle colors
|
|
47
|
+
across the new cells; one resampled to 2×2 keeps only its corners.
|
|
48
|
+
@param grid The colors, row-major.
|
|
49
|
+
@param n The side of the grid to return.
|
|
50
|
+
*/ export function resampleGrid(grid, n) {
|
|
51
|
+
const k = gridSide(grid.length);
|
|
52
|
+
if (!k) return [];
|
|
53
|
+
if (k === n) return grid.slice();
|
|
54
|
+
const at = (x, y)=>grid[y * k + x];
|
|
55
|
+
const out = [];
|
|
56
|
+
const position = (step)=>{
|
|
57
|
+
const g = n > 1 ? step * (k - 1) / (n - 1) : 0;
|
|
58
|
+
const lo = Math.min(k - 2, Math.floor(g));
|
|
59
|
+
return [
|
|
60
|
+
lo,
|
|
61
|
+
g - lo
|
|
62
|
+
];
|
|
63
|
+
};
|
|
64
|
+
for(let j = 0; j < n; j++){
|
|
65
|
+
const [y, ty] = position(j);
|
|
66
|
+
for(let i = 0; i < n; i++){
|
|
67
|
+
const [x, tx] = position(i);
|
|
68
|
+
const low = interpolateRgb(at(x, y), at(x + 1, y))(tx);
|
|
69
|
+
const high = interpolateRgb(at(x, y + 1), at(x + 1, y + 1))(tx);
|
|
70
|
+
out.push(rgb(interpolateRgb(low, high)(ty)).formatHex());
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return out;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
The `n×n` colors a bivariate ColorScale paints with (row-major, as
|
|
77
|
+
`BIVARIATE_COLORS`): `colors` when it is a square grid of at least 2×2
|
|
78
|
+
color strings, resampled to `n×n` (see `resampleGrid`), else Stevens'
|
|
79
|
+
3×3 scheme resampled the same way.
|
|
80
|
+
@param colors The configured grid.
|
|
81
|
+
@param n The bins per variable.
|
|
82
|
+
*/ export function bivariatePalette(colors, n) {
|
|
83
|
+
const valid = Array.isArray(colors) && gridSide(colors.length) > 0 && colors.every((c)=>typeof c === "string" && rgb(c).displayable());
|
|
84
|
+
return resampleGrid(valid ? colors : BIVARIATE_COLORS, n);
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
Splits one variable's values into `n` quantile bins by rank: a value's
|
|
88
|
+
bin is its share of the values ranked below it (ties counted at their
|
|
89
|
+
middle rank), so each bin holds about as many values as the next, and
|
|
90
|
+
equal values always share a bin. A value outside the data ranks by
|
|
91
|
+
where it would sort.
|
|
92
|
+
@param values The variable's values (non-finite ones are ignored).
|
|
93
|
+
@param n The number of bins.
|
|
94
|
+
*/ export function bivariateBins(values, n) {
|
|
95
|
+
const sorted = values.filter(Number.isFinite).sort(ascending);
|
|
96
|
+
const count = sorted.length;
|
|
97
|
+
const bin = (value)=>{
|
|
98
|
+
if (!count || !Number.isFinite(value)) return 0;
|
|
99
|
+
// Twice the tie group's middle rank, in whole numbers so a value right
|
|
100
|
+
// on a bin's edge doesn't slip below it to float error.
|
|
101
|
+
const ranks = bisectLeft(sorted, value) + bisectRight(sorted, value);
|
|
102
|
+
return Math.min(n - 1, Math.floor(ranks * n / (2 * count)));
|
|
103
|
+
};
|
|
104
|
+
const ranges = Array.from({
|
|
105
|
+
length: n
|
|
106
|
+
}, ()=>null);
|
|
107
|
+
for (const v of sorted){
|
|
108
|
+
const b = bin(v);
|
|
109
|
+
const range = ranges[b];
|
|
110
|
+
if (!range) ranges[b] = [
|
|
111
|
+
v,
|
|
112
|
+
v
|
|
113
|
+
];
|
|
114
|
+
else range[1] = v;
|
|
115
|
+
}
|
|
116
|
+
return {
|
|
117
|
+
bin,
|
|
118
|
+
ranges
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
/** Whether `value` is a pair of finite numbers. */ export function isBivariatePair(value) {
|
|
122
|
+
return Array.isArray(value) && value.length === 2 && Number.isFinite(value[0]) && Number.isFinite(value[1]);
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
Builds a bivariate color scale from the value pairs in the data: each
|
|
126
|
+
variable binned into `n` quantiles (see `bivariateBins`), colored from
|
|
127
|
+
`colors`, an `n×n` grid (see `bivariatePalette`).
|
|
128
|
+
@param pairs The data's value pairs.
|
|
129
|
+
@param n The bins per variable.
|
|
130
|
+
@param colors The `n×n` colors, row-major.
|
|
131
|
+
*/ export function bivariateScale(pairs, n, colors) {
|
|
132
|
+
const x = bivariateBins(pairs.map((p)=>p[0]), n);
|
|
133
|
+
const y = bivariateBins(pairs.map((p)=>p[1]), n);
|
|
134
|
+
const cell = (value)=>isBivariatePair(value) ? [
|
|
135
|
+
x.bin(value[0]),
|
|
136
|
+
y.bin(value[1])
|
|
137
|
+
] : null;
|
|
138
|
+
const scale = (value)=>{
|
|
139
|
+
const c = cell(value);
|
|
140
|
+
return c ? colors[c[1] * n + c[0]] : undefined;
|
|
141
|
+
};
|
|
142
|
+
scale.cell = cell;
|
|
143
|
+
scale.size = n;
|
|
144
|
+
scale.x = x;
|
|
145
|
+
scale.y = y;
|
|
146
|
+
scale.colors = colors;
|
|
147
|
+
scale.domain = ()=>pairs;
|
|
148
|
+
scale.range = ()=>colors;
|
|
149
|
+
return scale;
|
|
150
|
+
}
|
|
@@ -8,17 +8,46 @@ import { max } from "d3-array";
|
|
|
8
8
|
return Math.max(0, decimals.length - Number(exponent));
|
|
9
9
|
}
|
|
10
10
|
/** `value` counted in steps of `10^-places`, with float noise rounded off. */ const toSteps = (value, places)=>+(value * 10 ** places).toPrecision(15);
|
|
11
|
-
/** The value of `steps` steps of `10^-places
|
|
11
|
+
/** The value of `steps` steps of `10^-places` (never `-0`). */ const fromSteps = (steps, places)=>+(steps / 10 ** places).toPrecision(15) || 0;
|
|
12
|
+
/** Significant digits from which a value reads as computed rather than written. */ const COMPUTED_DIGITS = 12;
|
|
13
|
+
/** The number of significant digits `value` is written with, at 15 digits. */ export function significantDigits(value) {
|
|
14
|
+
const mantissa = value.toExponential(14).split("e")[0];
|
|
15
|
+
return mantissa.replace(/[-.]/g, "").replace(/0+$/, "").length || 1;
|
|
16
|
+
}
|
|
17
|
+
/** How small, as a share of the values' span, a value is float noise around zero. */ const NOISE = 1e-9;
|
|
18
|
+
/**
|
|
19
|
+
The decimal places bucket labels step at: the most any value is written
|
|
20
|
+
with. A computed value (a mean such as `1 / 3`) carries float precision
|
|
21
|
+
no label should step at, so its own places count only to the data's
|
|
22
|
+
display precision: three significant digits of the values' span. A value
|
|
23
|
+
within float noise of zero (`-1.4e-14`) counts as zero.
|
|
24
|
+
*/ export function labelPlaces(allValues) {
|
|
25
|
+
const finite = allValues.filter(Number.isFinite);
|
|
26
|
+
if (!finite.length) return 0;
|
|
27
|
+
const span = max(finite) - Math.min(...finite) || Math.abs(finite[0]);
|
|
28
|
+
const values = finite.map((v)=>Math.abs(v) < span * NOISE ? 0 : v);
|
|
29
|
+
const written = values.filter((v)=>significantDigits(v) < COMPUTED_DIGITS);
|
|
30
|
+
const places = max(written.map(decimalPlaces)) ?? 0;
|
|
31
|
+
if (written.length === values.length) return places;
|
|
32
|
+
const display = span ? Math.max(0, 2 - Math.floor(Math.log10(span))) : 0;
|
|
33
|
+
return Math.max(places, display);
|
|
34
|
+
}
|
|
35
|
+
/** `value` rounded to the places bucket labels step at (see `labelPlaces`). */ export function labelValue(value, allValues) {
|
|
36
|
+
const places = labelPlaces(allValues);
|
|
37
|
+
return fromSteps(Math.round(toSteps(value, places)), places);
|
|
38
|
+
}
|
|
12
39
|
/**
|
|
13
40
|
The `[lower, upper]` values a ColorScale label shows for the bucket
|
|
14
41
|
`[ticks[i], ticks[i + 1])`: the first and last values the data's own
|
|
15
|
-
precision can write inside it, so integer data reads
|
|
42
|
+
precision (see `labelPlaces`) can write inside it, so integer data reads
|
|
43
|
+
"1 - 2", "3 - 4", and computed values such as means don't step at float
|
|
44
|
+
precision (a bucket ending at 0 reads "-9.5 - -0.1", not "-9.5 - -1f").
|
|
16
45
|
When `format` prints the upper bound the same as the next bucket's lower
|
|
17
46
|
one (an abbreviation like "1.5k"), the upper bound drops a decimal place
|
|
18
47
|
at a time until it reads differently ("1.49k").
|
|
19
48
|
*/ export function bucketBounds(tick, i, ticks, allValues, format) {
|
|
20
49
|
const next = ticks[i + 1];
|
|
21
|
-
const places =
|
|
50
|
+
const places = labelPlaces(allValues);
|
|
22
51
|
const tickSteps = toSteps(tick, places);
|
|
23
52
|
// A repeated first tick labels its own value, so the bucket after it
|
|
24
53
|
// starts one step above.
|
|
@@ -7,7 +7,8 @@
|
|
|
7
7
|
(jenks, buckets, quantile without `bucketAxis`) get no mark: the value's
|
|
8
8
|
swatch stays lit and the rest dim instead (see `hoveredSwatch`).
|
|
9
9
|
*/ import { colorContrast } from "@d3plus/color";
|
|
10
|
-
import {
|
|
10
|
+
import { textWidth } from "@d3plus/dom";
|
|
11
|
+
import { inkText } from "../../utils/themeInk.js";
|
|
11
12
|
/** `hoverMarkConfig`'s defaults. */ export function hoverMarkDefaults() {
|
|
12
13
|
return {
|
|
13
14
|
tickConfig: {},
|
|
@@ -312,8 +313,7 @@ import { backgroundColor, textWidth } from "@d3plus/dom";
|
|
|
312
313
|
const value = cs._hoverValue;
|
|
313
314
|
const geometry = cs._barGeometry;
|
|
314
315
|
if (cs.schema.hoverMark === false || typeof value !== "number" || !Number.isFinite(value) || !cs._colorScale || !geometry) return;
|
|
315
|
-
const
|
|
316
|
-
const ink = colorContrast(node ? backgroundColor(node) : "rgb(255, 255, 255)", cs.schema.colorDefaults);
|
|
316
|
+
const ink = inkText(cs);
|
|
317
317
|
const mark = {
|
|
318
318
|
cs,
|
|
319
319
|
key: `${group.key}-hover`,
|
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
import { scaleLinear } from "d3-scale";
|
|
2
2
|
import { assign, elem, textWidth } from "@d3plus/dom";
|
|
3
3
|
import { gradientToken } from "@d3plus/render";
|
|
4
|
+
import { resetKeys } from "../../fluent.js";
|
|
5
|
+
/** The config a Legend merges each render's into, rather than replaces. */ const LEGEND_BAGS = [
|
|
6
|
+
"shapeConfig",
|
|
7
|
+
"titleConfig"
|
|
8
|
+
];
|
|
9
|
+
/** The config keys each ColorScale's Legend was last given. */ const legendKeys = new WeakMap();
|
|
4
10
|
/** Builds the axis/label configs and trims the gradient for end labels. */ function prepareGradientAxis(cs, compute, offsets) {
|
|
5
11
|
const { horizontal, height, width, domain, labels, ticks } = compute;
|
|
6
12
|
const axisDomain = domain.slice();
|
|
@@ -68,6 +74,9 @@ import { gradientToken } from "@d3plus/render";
|
|
|
68
74
|
}
|
|
69
75
|
/** Renders the measurement + visible axes, returning bounds and the position scale. */ function renderGradientAxes(cs, compute, groups, axisConfig, offsets) {
|
|
70
76
|
const { horizontal, height, width, x, y } = compute;
|
|
77
|
+
// A bucketed bar labels every bucket, and hides some to give the rest
|
|
78
|
+
// as many lines as a gradient's labels take.
|
|
79
|
+
cs._axisTest._thinForLines = cs._axisClass._thinForLines = !!cs.schema.bucketAxis;
|
|
71
80
|
cs._axisTest.renderMode("compute").select(elem("g.d3plus-ColorScale-axisTest", {
|
|
72
81
|
enter: {
|
|
73
82
|
opacity: 0
|
|
@@ -219,22 +228,32 @@ import { gradientToken } from "@d3plus/render";
|
|
|
219
228
|
});
|
|
220
229
|
renderGradientLabels(cs, compute, groups, labelConfig, rectConfig, labelData);
|
|
221
230
|
}
|
|
231
|
+
/** Whether the Legend's last render left out or cut short its swatches' labels, or drew nothing. */ function labelsLeftOut(legend) {
|
|
232
|
+
if (!legend.data().length) return false;
|
|
233
|
+
return !legend.outerBounds().width || legend._lineData.some((d)=>d.sentence && (!d.width || d.cut));
|
|
234
|
+
}
|
|
222
235
|
/** Renders the discrete legend ColorScale variant (jenks/buckets/quantile). */ export function renderLegendVariant(cs, compute, groups) {
|
|
223
236
|
const { horizontal, allValues, ticks, colors } = compute;
|
|
224
237
|
cs._barGeometry = undefined;
|
|
225
238
|
elem("g.d3plus-ColorScale-axis", Object.assign({
|
|
226
239
|
condition: groups.gradient
|
|
227
240
|
}, groups.groupParams));
|
|
241
|
+
cs._swatchBuckets = new Map();
|
|
228
242
|
let legendData = ticks.reduce((arr, tick, i)=>{
|
|
229
243
|
const label = cs.schema.bucketFormat.bind(cs)(tick, i, ticks, allValues);
|
|
230
244
|
// `_isColorScaleBucket` marks these as range buckets (not groupBy rows)
|
|
231
245
|
// so a parent Viz's `_drawLabel` titles their tooltip with the bucket
|
|
232
246
|
// label (`id`) instead of resolving to "undefined" via groupBy.
|
|
233
|
-
|
|
247
|
+
const row = {
|
|
234
248
|
color: colors[i + 1],
|
|
235
249
|
id: label,
|
|
236
250
|
_isColorScaleBucket: true
|
|
251
|
+
};
|
|
252
|
+
cs._swatchBuckets.set(row, {
|
|
253
|
+
value: tick,
|
|
254
|
+
index: i
|
|
237
255
|
});
|
|
256
|
+
arr.push(row);
|
|
238
257
|
return arr;
|
|
239
258
|
}, []);
|
|
240
259
|
if (!horizontal) legendData = legendData.reverse();
|
|
@@ -260,6 +279,17 @@ import { gradientToken } from "@d3plus/render";
|
|
|
260
279
|
end: "bottom"
|
|
261
280
|
})[cs.schema.align] : "middle"
|
|
262
281
|
}, cs.schema.legendConfig);
|
|
263
|
-
|
|
282
|
+
// Each render starts from the Legend's defaults, so config an earlier
|
|
283
|
+
// render gave it and this one doesn't is dropped.
|
|
284
|
+
const legend = cs._legendClass;
|
|
285
|
+
legend.config(resetKeys(legend, [
|
|
286
|
+
...LEGEND_BAGS,
|
|
287
|
+
...legendKeys.get(legend) ?? []
|
|
288
|
+
]));
|
|
289
|
+
legendKeys.set(legend, Object.keys(legendConfig));
|
|
290
|
+
legend.renderMode("compute").data(legendData).select(groups.legendGroup.node()).config(legendConfig).render();
|
|
291
|
+
// Like the axis of a gradient, the swatches leave out their title before
|
|
292
|
+
// they cut short or leave out their labels.
|
|
293
|
+
if (legend.title() && labelsLeftOut(legend)) legend.title(undefined).render();
|
|
264
294
|
cs._outerBounds = cs._legendClass.outerBounds();
|
|
265
295
|
}
|