@d3plus/core 4.11.0 → 4.13.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 +2 -2
- package/es/internal.js +167 -23
- package/es/src/charts/Alluvial/emit.js +5 -4
- package/es/src/charts/Alluvial/index.js +7 -1
- package/es/src/charts/Alluvial/titles.js +24 -4
- package/es/src/charts/ArcDiagram/applyLayout.js +17 -10
- package/es/src/charts/ArcDiagram/arcGeometry.js +21 -8
- package/es/src/charts/ArcDiagram/arcLoops.js +5 -2
- package/es/src/charts/ArcDiagram/arcNodeBox.js +89 -0
- package/es/src/charts/ArcDiagram/emit.js +81 -38
- package/es/src/charts/ArcDiagram/events.js +16 -8
- package/es/src/charts/ArcDiagram/index.js +3 -1
- package/es/src/charts/BarChart/index.js +14 -10
- package/es/src/charts/BoxWhisker/extras.js +95 -0
- package/es/src/charts/BoxWhisker/index.js +77 -6
- package/es/src/charts/BoxWhisker/outliers.js +3 -2
- package/es/src/charts/BoxWhisker/summary.js +14 -3
- package/es/src/charts/BoxWhisker/tooltip.js +114 -29
- package/es/src/charts/BubbleChart/emit.js +9 -5
- package/es/src/charts/BubbleMatrix/colorDefaults.js +58 -0
- package/es/src/charts/BubbleMatrix/index.js +52 -0
- package/es/src/charts/Bullet/emit.js +3 -2
- package/es/src/charts/BumpChart/areaBump.js +175 -0
- package/es/src/charts/BumpChart/index.js +84 -18
- package/es/src/charts/Calendar/applyLayout.js +1 -1
- package/es/src/charts/Calendar/calendarDates.js +21 -7
- package/es/src/charts/Calendar/emit.js +3 -2
- package/es/src/charts/Calendar/index.js +16 -1
- package/es/src/charts/Candlestick/index.js +6 -11
- package/es/src/charts/Candlestick/periods.js +52 -29
- package/es/src/charts/Candlestick/tooltip.js +5 -7
- package/es/src/charts/Chord/emit.js +3 -2
- package/es/src/charts/ConnectedScatter/index.js +39 -0
- package/es/src/charts/CyclePlot/cycleFacet.js +162 -0
- package/es/src/charts/CyclePlot/cycleMeans.js +54 -0
- package/es/src/charts/CyclePlot/cyclePeriods.js +99 -0
- package/es/src/charts/CyclePlot/cycleTooltip.js +67 -0
- package/es/src/charts/CyclePlot/index.js +197 -0
- package/es/src/charts/DensityPlot/densityCurves.js +139 -0
- package/es/src/charts/DensityPlot/densityPoint.js +10 -0
- package/es/src/charts/DensityPlot/index.js +235 -0
- package/es/src/charts/DensityPlot/rug.js +144 -0
- package/es/src/charts/DotPlot/dotLayout.js +165 -0
- package/es/src/charts/DotPlot/facetSize.js +40 -0
- package/es/src/charts/DotPlot/index.js +173 -0
- package/es/src/charts/DotPlot/placements.js +121 -0
- package/es/src/charts/DotPlot/tooltip.js +68 -0
- package/es/src/charts/Dumbbell/arrowGrays.js +46 -0
- package/es/src/charts/Dumbbell/categoryChange.js +124 -0
- package/es/src/charts/Dumbbell/changeEmit.js +291 -0
- package/es/src/charts/Dumbbell/changes.js +87 -0
- package/es/src/charts/Dumbbell/connectors.js +46 -0
- package/es/src/charts/Dumbbell/emit.js +51 -50
- package/es/src/charts/Dumbbell/gapSort.js +2 -1
- package/es/src/charts/Dumbbell/index.js +121 -5
- package/es/src/charts/Funnel/emit.js +3 -2
- package/es/src/charts/Gantt/applyLayout.js +33 -13
- package/es/src/charts/Gantt/criticalPath.js +202 -0
- package/es/src/charts/Gantt/emit.js +49 -15
- package/es/src/charts/Gantt/ganttCalendar.js +54 -0
- package/es/src/charts/Gantt/ganttCritical.js +106 -0
- package/es/src/charts/Gantt/ganttDecor.js +183 -60
- package/es/src/charts/Gantt/ganttSlack.js +14 -0
- package/es/src/charts/Gantt/ganttTooltip.js +91 -36
- package/es/src/charts/Gantt/index.js +59 -10
- package/es/src/charts/Gauge/emit.js +3 -2
- package/es/src/charts/Geomap/applyLayout.js +177 -19
- package/es/src/charts/Geomap/cartogram.js +50 -0
- package/es/src/charts/Geomap/cartogramContiguous.js +196 -0
- package/es/src/charts/Geomap/cartogramFields.js +63 -0
- package/es/src/charts/Geomap/cartogramLabels.js +109 -0
- package/es/src/charts/Geomap/cartogramLayout.js +186 -0
- package/es/src/charts/Geomap/cartogramLegend.js +73 -0
- package/es/src/charts/Geomap/cartogramRelax.js +251 -0
- package/es/src/charts/Geomap/densityEmit.js +93 -0
- package/es/src/charts/Geomap/densityFields.js +69 -0
- package/es/src/charts/Geomap/densityLayout.js +90 -0
- package/es/src/charts/Geomap/densityTooltip.js +98 -0
- package/es/src/charts/Geomap/dotDensity.js +157 -0
- package/es/src/charts/Geomap/dotDensityLayout.js +116 -0
- package/es/src/charts/Geomap/dotRenderer.js +49 -0
- package/es/src/charts/Geomap/drillDown.js +216 -0
- package/es/src/charts/Geomap/drillEmit.js +64 -0
- package/es/src/charts/Geomap/drillEvents.js +108 -0
- package/es/src/charts/Geomap/emit.js +64 -42
- package/es/src/charts/Geomap/flowEmit.js +36 -15
- package/es/src/charts/Geomap/flowEvents.js +3 -1
- package/es/src/charts/Geomap/flowFields.js +2 -2
- package/es/src/charts/Geomap/flowLinks.js +18 -10
- package/es/src/charts/Geomap/geoHexbin.js +144 -0
- package/es/src/charts/Geomap/geoHexbinZoom.js +110 -0
- package/es/src/charts/Geomap/index.js +71 -116
- package/es/src/charts/Geomap/pointCluster.js +246 -0
- package/es/src/charts/Geomap/pointClusterEmit.js +385 -0
- package/es/src/charts/Geomap/pointClusterLayout.js +170 -0
- package/es/src/charts/Geomap/pointClusterLinks.js +95 -0
- package/es/src/charts/Geomap/pointClusterZoom.js +253 -0
- package/es/src/charts/Geomap/pointLabels.js +12 -4
- package/es/src/charts/Geomap/pointRows.js +25 -0
- package/es/src/charts/Geomap/tileGrid.js +468 -0
- package/es/src/charts/Geomap/tileState.js +41 -0
- package/es/src/charts/Geomap/topojsonFluent.js +96 -0
- package/es/src/charts/Geomap/topojsonLevels.js +16 -0
- package/es/src/charts/Hexbin/contourLabels.js +25 -17
- package/es/src/charts/Hexbin/index.js +4 -1
- package/es/src/charts/Histogram/binData.js +5 -1
- package/es/src/charts/Histogram/index.js +4 -26
- package/es/src/charts/HorizonChart/emit.js +147 -0
- package/es/src/charts/HorizonChart/horizonBands.js +117 -0
- package/es/src/charts/HorizonChart/horizonColors.js +30 -0
- package/es/src/charts/HorizonChart/hover.js +147 -0
- package/es/src/charts/HorizonChart/index.js +220 -0
- package/es/src/charts/HorizonChart/measure.js +91 -0
- package/es/src/charts/HorizonChart/rowFilter.js +250 -0
- package/es/src/charts/HorizonChart/state.js +64 -0
- package/es/src/charts/Icicle/emit.js +3 -2
- package/es/src/charts/Icicle/index.js +3 -1
- package/es/src/charts/KPI/applyLayout.js +119 -0
- package/es/src/charts/KPI/delta.js +74 -0
- package/es/src/charts/KPI/emit.js +303 -0
- package/es/src/charts/KPI/index.js +192 -0
- package/es/src/charts/KPI/series.js +67 -0
- package/es/src/charts/KPI/tileLayout.js +134 -0
- package/es/src/charts/Lollipop/emit.js +2 -1
- package/es/src/charts/Marimekko/index.js +2 -1
- package/es/src/charts/Matrix/applyLayout.js +29 -12
- package/es/src/charts/Matrix/bubbles.js +133 -0
- package/es/src/charts/Matrix/emit.js +68 -25
- package/es/src/charts/Matrix/index.js +64 -5
- package/es/src/charts/Network/applyLayout.js +206 -84
- package/es/src/charts/Network/bundle.js +29 -8
- package/es/src/charts/Network/circleLayout.js +281 -0
- package/es/src/charts/Network/containNodes.js +72 -0
- package/es/src/charts/Network/emit.js +109 -50
- package/es/src/charts/Network/forceLayout.js +111 -0
- package/es/src/charts/Network/graph.js +76 -8
- package/es/src/charts/Network/graphFluent.js +5 -3
- package/es/src/charts/Network/index.js +117 -3
- package/es/src/charts/Network/liveForce.js +312 -0
- package/es/src/charts/Network/livePositions.js +180 -0
- package/es/src/charts/Network/networkDrag.js +156 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +18 -10
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +3 -14
- 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/emit.js +3 -2
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- package/es/src/charts/Pareto/color.js +46 -0
- package/es/src/charts/Pareto/hover.js +54 -0
- package/es/src/charts/Pareto/index.js +170 -0
- package/es/src/charts/Pareto/labels.js +91 -0
- package/es/src/charts/Pareto/order.js +61 -0
- package/es/src/charts/Pareto/paretoSteps.js +84 -0
- package/es/src/charts/Pareto/state.js +158 -0
- package/es/src/charts/Parliament/index.js +68 -0
- package/es/src/charts/Pie/emit.js +12 -3
- package/es/src/charts/Pie/index.js +10 -0
- package/es/src/charts/Plot/areaEnter.js +70 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +10 -2
- package/es/src/charts/Plot/aspectRatio.js +92 -0
- package/es/src/charts/Plot/axisHover.js +4 -2
- package/es/src/charts/Plot/axisHoverAnchors.js +2 -1
- package/es/src/charts/Plot/axisHoverScene.js +138 -5
- package/es/src/charts/Plot/barConfidence.js +7 -6
- package/es/src/charts/Plot/barHitArea.js +121 -7
- package/es/src/charts/Plot/barLabelConfidence.js +50 -0
- package/es/src/charts/Plot/barLabelFit.js +2 -1
- package/es/src/charts/Plot/barWidth.js +10 -5
- package/es/src/charts/Plot/baselineBreak.js +15 -6
- package/es/src/charts/Plot/baselineDomain.js +13 -4
- package/es/src/charts/Plot/circleLabels.js +26 -16
- package/es/src/charts/Plot/confidenceAxes.js +100 -0
- package/es/src/charts/Plot/confidenceConfig.js +7 -2
- package/es/src/charts/Plot/confidenceTooltip.js +47 -4
- package/es/src/charts/Plot/connectGapsScene.js +2 -1
- package/es/src/charts/Plot/discreteDomain.js +27 -5
- package/es/src/charts/Plot/discreteSpan.js +10 -1
- package/es/src/charts/Plot/domainClip.js +74 -44
- package/es/src/charts/Plot/downsample.js +26 -0
- package/es/src/charts/Plot/draw.js +41 -14
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecast.js +8 -4
- package/es/src/charts/Plot/forecastScene.js +6 -5
- package/es/src/charts/Plot/index.js +52 -27
- package/es/src/charts/Plot/inferDiscrete.js +72 -0
- package/es/src/charts/Plot/jitter.js +50 -0
- package/es/src/charts/Plot/labelPlacement.js +4 -3
- package/es/src/charts/Plot/lineBands.js +6 -1
- package/es/src/charts/Plot/lineLabelEmit.js +4 -3
- package/es/src/charts/Plot/lineLabelSides.js +8 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +45 -31
- package/es/src/charts/Plot/lineMarkerKeys.js +19 -0
- package/es/src/charts/Plot/marginalHover.js +141 -0
- package/es/src/charts/Plot/marginalLayout.js +102 -0
- package/es/src/charts/Plot/marginalPaint.js +105 -0
- package/es/src/charts/Plot/marginalScene.js +272 -0
- package/es/src/charts/Plot/marginalSeries.js +73 -0
- package/es/src/charts/Plot/marginalStats.js +219 -0
- package/es/src/charts/Plot/openDomainEnds.js +60 -0
- package/es/src/charts/Plot/orderPath.js +137 -0
- package/es/src/charts/Plot/orderPathScene.js +253 -0
- package/es/src/charts/Plot/outlierDetect.js +179 -0
- package/es/src/charts/Plot/outlierLabels.js +327 -0
- package/es/src/charts/Plot/outlierLines.js +93 -0
- package/es/src/charts/Plot/outlierScene.js +308 -0
- package/es/src/charts/Plot/outlierTooltip.js +69 -0
- package/es/src/charts/Plot/periodLabels.js +27 -0
- package/es/src/charts/Plot/pipeline.js +62 -24
- package/es/src/charts/Plot/pipelineAxisLayout.js +9 -7
- package/es/src/charts/Plot/pipelineDomains.js +64 -27
- package/es/src/charts/Plot/pipelineScales.js +37 -28
- package/es/src/charts/Plot/plotBreaks.js +38 -18
- package/es/src/charts/Plot/plotFacet.js +3 -1
- package/es/src/charts/Plot/plotInit.js +65 -3
- package/es/src/charts/Plot/plotLevels.js +183 -0
- package/es/src/charts/Plot/plotRangeBreaks.js +46 -9
- package/es/src/charts/Plot/plotShapes.js +60 -0
- package/es/src/charts/Plot/pointConfidence.js +186 -0
- package/es/src/charts/Plot/pointKey.js +10 -0
- package/es/src/charts/Plot/referenceDomains.js +11 -6
- package/es/src/charts/Plot/shapeAccessors.js +52 -0
- package/es/src/charts/Plot/shapeDefaults.js +32 -17
- package/es/src/charts/Plot/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +42 -13
- package/es/src/charts/Plot/sharedHoverScene.js +49 -13
- package/es/src/charts/Plot/sharedTooltip.js +68 -25
- package/es/src/charts/Plot/stackEnter.js +7 -3
- package/es/src/charts/Plot/stackLegendOrder.js +5 -2
- package/es/src/charts/Plot/stackNeutral.js +154 -0
- package/es/src/charts/Plot/stackShareTooltip.js +2 -1
- package/es/src/charts/Plot/stackThreshold.js +2 -1
- package/es/src/charts/Plot/swarm.js +8 -5
- package/es/src/charts/Plot/timeNestKeys.js +37 -0
- package/es/src/charts/Plot/trendLabels.js +45 -18
- package/es/src/charts/Plot/trendLines.js +78 -34
- package/es/src/charts/Plot/trendMovingAverage.js +135 -0
- package/es/src/charts/Plot/trendProjection.js +18 -6
- package/es/src/charts/Plot/trendScene.js +4 -1
- package/es/src/charts/Plot/trendTooltip.js +75 -20
- package/es/src/charts/PolarArea/emit.js +3 -2
- package/es/src/charts/PolarArea/index.js +2 -1
- package/es/src/charts/Priestley/applyLayout.js +20 -12
- package/es/src/charts/Priestley/emit.js +3 -2
- package/es/src/charts/Priestley/index.js +0 -2
- package/es/src/charts/Priestley/timeAxis.js +24 -13
- 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 +29 -17
- package/es/src/charts/Radar/curvedLabels.js +43 -2
- package/es/src/charts/Radar/emit.js +33 -17
- package/es/src/charts/Radar/index.js +41 -2
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialArea/index.js +51 -0
- package/es/src/charts/RadialBar/emit.js +9 -3
- package/es/src/charts/RadialBar/index.js +10 -0
- package/es/src/charts/RadialLine/angles.js +117 -0
- package/es/src/charts/RadialLine/applyLayout.js +204 -0
- package/es/src/charts/RadialLine/emit.js +66 -0
- package/es/src/charts/RadialLine/index.js +228 -0
- package/es/src/charts/RadialLine/paths.js +55 -0
- package/es/src/charts/RadialLine/points.js +80 -0
- package/es/src/charts/RadialLine/series.js +84 -0
- package/es/src/charts/RadialLine/seriesLabelNodes.js +116 -0
- package/es/src/charts/RadialLine/seriesLabels.js +91 -0
- package/es/src/charts/RadialLine/spokes.js +32 -0
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/emit.js +3 -2
- package/es/src/charts/RadialMatrix/index.js +15 -2
- package/es/src/charts/RadialTree/index.js +33 -0
- package/es/src/charts/Rings/applyLayout.js +28 -151
- package/es/src/charts/Rings/emit.js +120 -60
- package/es/src/charts/Rings/index.js +28 -5
- package/es/src/charts/Rings/ringsCurves.js +158 -0
- package/es/src/charts/Rings/ringsLoops.js +4 -2
- package/es/src/charts/Rings/ringsParallel.js +20 -3
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +82 -51
- package/es/src/charts/Sankey/applyLayout.js +22 -4
- package/es/src/charts/Sankey/circularLayout.js +14 -6
- package/es/src/charts/Sankey/emit.js +3 -2
- package/es/src/charts/Sankey/index.js +50 -1
- package/es/src/charts/Sankey/sankeyDrag.js +225 -0
- package/es/src/charts/Sankey/sankeyLayout.js +12 -0
- package/es/src/charts/Scatter/index.js +3 -2
- package/es/src/charts/ScatterMatrix/binEmit.js +59 -0
- package/es/src/charts/ScatterMatrix/index.js +253 -0
- package/es/src/charts/ScatterMatrix/matrixData.js +161 -0
- package/es/src/charts/ScatterMatrix/matrixFacet.js +76 -0
- package/es/src/charts/ScatterMatrix/matrixHover.js +36 -0
- package/es/src/charts/ScatterMatrix/matrixTooltip.js +45 -0
- package/es/src/charts/StripPlot/index.js +53 -0
- package/es/src/charts/Sunburst/emit.js +12 -3
- package/es/src/charts/Sunburst/index.js +13 -1
- package/es/src/charts/TileGridMap/index.js +29 -0
- package/es/src/charts/Tree/applyLayout.js +135 -32
- package/es/src/charts/Tree/emit.js +61 -8
- package/es/src/charts/Tree/index.js +34 -15
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeHeight.js +58 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Tree/radialLabels.js +61 -0
- package/es/src/charts/Tree/radialLayout.js +210 -0
- package/es/src/charts/Treemap/emit.js +3 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- package/es/src/charts/Venn/applyLayout.js +176 -0
- package/es/src/charts/Venn/circles.js +192 -0
- package/es/src/charts/Venn/ellipseFrame.js +57 -0
- package/es/src/charts/Venn/emit.js +142 -0
- package/es/src/charts/Venn/index.js +178 -0
- package/es/src/charts/Venn/nelderMead.js +59 -0
- package/es/src/charts/Venn/tooltip.js +22 -0
- package/es/src/charts/Venn/vennData.js +99 -0
- package/es/src/charts/Venn/vennEllipses.js +291 -0
- package/es/src/charts/Venn/vennFit.js +169 -0
- package/es/src/charts/Venn/vennLayout.js +252 -0
- package/es/src/charts/Venn/vennRegions.js +133 -0
- package/es/src/charts/Violin/emit.js +2 -1
- package/es/src/charts/Violin/index.js +2 -1
- package/es/src/charts/Waffle/applyLayout.js +45 -22
- package/es/src/charts/Waffle/arcEmit.js +153 -0
- package/es/src/charts/Waffle/arcLayout.js +122 -0
- package/es/src/charts/Waffle/arcStage.js +79 -0
- package/es/src/charts/Waffle/emit.js +9 -4
- package/es/src/charts/Waffle/index.js +88 -4
- package/es/src/charts/Waffle/tooltip.js +7 -2
- package/es/src/charts/Waterfall/connectors.js +5 -3
- package/es/src/charts/Waterfall/state.js +2 -1
- package/es/src/charts/WordCloud/applyLayout.js +157 -0
- package/es/src/charts/WordCloud/cloudLayout.js +128 -0
- package/es/src/charts/WordCloud/emit.js +96 -0
- package/es/src/charts/WordCloud/fontScale.js +34 -0
- package/es/src/charts/WordCloud/glyphMask.js +298 -0
- package/es/src/charts/WordCloud/index.js +174 -0
- package/es/src/charts/WordCloud/occupancy.js +99 -0
- package/es/src/charts/WordCloud/rotation.js +44 -0
- package/es/src/charts/WordCloud/size.js +15 -0
- package/es/src/charts/WordCloud/spiral.js +72 -0
- package/es/src/charts/definition/applyDefinition.js +6 -1
- package/es/src/charts/definition/declaresField.js +14 -0
- package/es/src/charts/definition/makeChart.js +15 -3
- package/es/src/charts/drawSteps/bottomRightControls.js +1 -1
- package/es/src/charts/drawSteps/bottomRightControlsMarkup.js +1 -1
- package/es/src/charts/drawSteps/gestureHover.js +10 -6
- package/es/src/charts/drawSteps/leavesSurface.js +12 -0
- package/es/src/charts/drawSteps/minimap.js +5 -21
- package/es/src/charts/drawSteps/selectActions.js +105 -0
- package/es/src/charts/drawSteps/selectGesture.js +318 -0
- package/es/src/charts/drawSteps/selectRegion.js +222 -0
- package/es/src/charts/drawSteps/selectState.js +118 -0
- package/es/src/charts/drawSteps/topLeftControls.js +4 -1
- package/es/src/charts/drawSteps/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +90 -37
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +228 -36
- package/es/src/charts/drawSteps/zoomControlsMenu.js +140 -0
- package/es/src/charts/drawSteps/zoomDrag.js +190 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +4 -2
- package/es/src/charts/events/click.shape.js +5 -3
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +15 -5
- package/es/src/charts/events/mousemove.legend.js +35 -34
- package/es/src/charts/events/mousemove.shape.js +53 -44
- package/es/src/charts/facet/drawFacets.js +61 -22
- package/es/src/charts/facet/facetConfig.js +3 -1
- package/es/src/charts/facet/facetData.js +10 -2
- package/es/src/charts/facet/facetGrid.js +5 -1
- package/es/src/charts/facet/facetGutter.js +36 -7
- package/es/src/charts/facet/facetLayout.js +136 -0
- package/es/src/charts/facet/facetLayouts.js +574 -0
- package/es/src/charts/facet/facetScene.js +10 -3
- package/es/src/charts/features/annotationFrame.js +8 -3
- package/es/src/charts/features/axes.js +19 -6
- package/es/src/charts/features/axesFinal.js +99 -10
- package/es/src/charts/features/axesMeasure.js +31 -10
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/bareRegion.js +24 -0
- package/es/src/charts/features/boxGrid.js +39 -0
- package/es/src/charts/features/centerLabel.js +196 -0
- package/es/src/charts/features/circleLabelPlacement.js +288 -83
- package/es/src/charts/features/circleLabels.js +66 -14
- package/es/src/charts/features/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +18 -0
- package/es/src/charts/features/colorScaleHover.js +35 -5
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +62 -0
- package/es/src/charts/features/colorScaleTop.js +71 -0
- package/es/src/charts/features/colorScaleValue.js +10 -1
- package/es/src/charts/features/curvedArrows.js +74 -23
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +107 -18
- package/es/src/charts/features/emitHelpers.js +7 -2
- package/es/src/charts/features/features.js +25 -5
- package/es/src/charts/features/featuresColorScale.js +64 -20
- package/es/src/charts/features/featuresLegend.js +20 -0
- package/es/src/charts/features/hoverTicks.js +46 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- package/es/src/charts/features/keyHold.js +115 -0
- package/es/src/charts/features/keyTooltip.js +91 -0
- package/es/src/charts/features/labelLayering.js +149 -0
- package/es/src/charts/features/labelSlots.js +112 -0
- package/es/src/charts/features/linkInteraction.js +62 -7
- package/es/src/charts/features/linkLabelPath.js +2 -39
- package/es/src/charts/features/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeDrag.js +175 -0
- package/es/src/charts/features/nodeKeys.js +117 -0
- package/es/src/charts/features/nodeOutline.js +41 -0
- package/es/src/charts/features/nodeStats.js +309 -0
- package/es/src/charts/features/pathLabelBends.js +191 -0
- package/es/src/charts/features/plotAnnotations.js +8 -5
- package/es/src/charts/features/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +52 -13
- package/es/src/charts/features/rectNodeSize.js +41 -0
- package/es/src/charts/features/ringLabels.js +3 -1
- package/es/src/charts/features/selfLoops.js +33 -23
- package/es/src/charts/features/shapeEmit.js +110 -32
- package/es/src/charts/features/sharedFields.js +10 -5
- package/es/src/charts/features/spokeLabels.js +178 -0
- package/es/src/charts/features/swatchPaint.js +68 -0
- package/es/src/charts/features/textHalo.js +3 -2
- package/es/src/charts/features/thresholdMembers.js +8 -12
- package/es/src/charts/features/tooltipRows.js +76 -0
- package/es/src/charts/features/tooltipSwatch.js +81 -24
- package/es/src/charts/features/xAxisConfig.js +2 -1
- package/es/src/charts/helpers/densityChart.js +2 -7
- package/es/src/charts/helpers/valueTitle.js +13 -1
- package/es/src/charts/index.js +17 -0
- package/es/src/charts/partition/chartFields.js +12 -3
- package/es/src/charts/partition/interaction.js +10 -5
- package/es/src/charts/pipeline/insetPlacement.js +19 -7
- package/es/src/charts/pipeline/preDrawData.js +80 -11
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/stages.js +3 -2
- package/es/src/charts/pipeline/vizPreDraw.js +4 -0
- package/es/src/charts/plotBuffers/Circle.js +3 -2
- package/es/src/charts/plotBuffers/Line.js +6 -5
- package/es/src/charts/plotBuffers/Rect.js +3 -2
- package/es/src/charts/plotBuffers/Tick.js +12 -0
- package/es/src/charts/plotBuffers/defaultBuffers.js +3 -1
- package/es/src/charts/plotBuffers/rectLikeBuffer.js +4 -3
- package/es/src/charts/polar/chrome.js +81 -9
- package/es/src/charts/polar/config.js +4 -0
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +56 -33
- package/es/src/charts/viz/VizBase.js +78 -42
- package/es/src/charts/viz/appendRows.js +90 -0
- package/es/src/charts/viz/backgroundInk.js +10 -0
- package/es/src/charts/viz/dataChanged.js +19 -0
- package/es/src/charts/viz/discrete.js +9 -0
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- package/es/src/charts/viz/focusTargets.js +25 -5
- package/es/src/charts/viz/groupByLevels.js +48 -0
- package/es/src/charts/viz/groupRow.js +27 -0
- package/es/src/charts/viz/hoverBand.js +40 -0
- package/es/src/charts/viz/interactionOpacity.js +240 -52
- package/es/src/charts/viz/keyboardNav.js +39 -9
- package/es/src/charts/viz/liftRaised.js +84 -0
- package/es/src/charts/viz/nearestHover.js +9 -2
- package/es/src/charts/viz/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +41 -0
- package/es/src/charts/viz/simpleHover.js +3 -4
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +45 -0
- package/es/src/charts/viz/vizDataPolling.js +0 -1
- package/es/src/charts/viz/vizDefaults.js +23 -34
- package/es/src/charts/viz/vizFields.js +13 -1
- package/es/src/charts/viz/vizRender.js +35 -5
- package/es/src/charts/viz/vizTypes.js +1 -1
- package/es/src/charts/viz/vizVisibility.js +12 -2
- package/es/src/components/Axis/Axis.js +114 -14
- 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 +29 -7
- package/es/src/components/Axis/axisDefaults.js +18 -0
- package/es/src/components/Axis/axisEndLabels.js +4 -1
- 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 +195 -0
- package/es/src/components/Axis/axisLabelThinning.js +167 -10
- package/es/src/components/Axis/axisLayout.js +76 -46
- package/es/src/components/Axis/axisLayoutLabels.js +93 -145
- package/es/src/components/Axis/axisLayoutScale.js +79 -34
- package/es/src/components/Axis/axisLevels.js +271 -0
- package/es/src/components/Axis/axisLimit.js +33 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisMinorTicks.js +280 -0
- package/es/src/components/Axis/axisPeriods.js +144 -0
- package/es/src/components/Axis/axisRangeBreaks.js +19 -10
- package/es/src/components/Axis/axisRender.js +90 -36
- package/es/src/components/Axis/axisRounding.js +38 -1
- package/es/src/components/Axis/axisScaleType.js +55 -0
- package/es/src/components/Axis/axisScene.js +100 -6
- package/es/src/components/Axis/axisTickLookups.js +30 -0
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +151 -0
- package/es/src/components/Axis/labelSizeSession.js +23 -0
- package/es/src/components/Axis/rangeBreaks.js +10 -4
- package/es/src/components/Axis/timeValues.js +116 -19
- package/es/src/components/ColorScale/ColorScale.js +63 -18
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +139 -41
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +11 -2
- 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 +20 -1
- package/es/src/components/TextBox.js +6 -2
- package/es/src/components/Timeline/Timeline.js +11 -3
- package/es/src/components/Timeline/timelineRender.js +25 -14
- package/es/src/components/Tooltip.js +8 -1
- package/es/src/components/textBoxScene.js +3 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +80 -18
- package/es/src/fluent.js +124 -9
- package/es/src/shapes/Area.js +32 -1
- package/es/src/shapes/Bar.js +22 -1
- package/es/src/shapes/Box.js +72 -13
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Image.js +8 -1
- package/es/src/shapes/Line.js +45 -1
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +29 -8
- package/es/src/shapes/Tick.js +54 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/shapes/boxExtraShapes.js +72 -0
- package/es/src/shapes/boxExtras.js +212 -0
- package/es/src/shapes/boxStyle.js +38 -5
- package/es/src/shapes/buildLabelData.js +2 -0
- package/es/src/shapes/downsample.js +150 -0
- package/es/src/shapes/hitAreaNode.js +6 -2
- package/es/src/shapes/index.js +1 -0
- package/es/src/shapes/pathSeries.js +51 -0
- package/es/src/utils/BaseClass.js +59 -52
- package/es/src/utils/configValue.js +9 -0
- package/es/src/utils/jitter.js +33 -0
- package/es/src/utils/resetSetters.js +66 -0
- package/package.json +10 -10
- package/types/index.d.ts +5 -4
- package/types/internal.d.ts +272 -29
- package/types/src/charts/Alluvial/titles.d.ts +16 -3
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +7 -3
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +3 -1
- package/types/src/charts/ArcDiagram/arcNodeBox.d.ts +60 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +6 -4
- package/types/src/charts/ArcDiagram/events.d.ts +2 -1
- package/types/src/charts/BoxWhisker/extras.d.ts +41 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +1 -1
- package/types/src/charts/BoxWhisker/tooltip.d.ts +33 -4
- package/types/src/charts/BubbleChart/emit.d.ts +3 -3
- package/types/src/charts/BubbleMatrix/colorDefaults.d.ts +19 -0
- package/types/src/charts/BubbleMatrix/index.d.ts +18 -0
- package/types/src/charts/BumpChart/areaBump.d.ts +86 -0
- package/types/src/charts/BumpChart/index.d.ts +19 -1
- package/types/src/charts/Calendar/calendarDates.d.ts +8 -1
- package/types/src/charts/Candlestick/periods.d.ts +19 -8
- package/types/src/charts/ConnectedScatter/index.d.ts +17 -0
- package/types/src/charts/CyclePlot/cycleFacet.d.ts +61 -0
- package/types/src/charts/CyclePlot/cycleMeans.d.ts +32 -0
- package/types/src/charts/CyclePlot/cyclePeriods.d.ts +37 -0
- package/types/src/charts/CyclePlot/cycleTooltip.d.ts +47 -0
- package/types/src/charts/CyclePlot/index.d.ts +75 -0
- package/types/src/charts/DensityPlot/densityCurves.d.ts +84 -0
- package/types/src/charts/DensityPlot/densityPoint.d.ts +16 -0
- package/types/src/charts/DensityPlot/index.d.ts +33 -0
- package/types/src/charts/DensityPlot/rug.d.ts +57 -0
- package/types/src/charts/DotPlot/dotLayout.d.ts +95 -0
- package/types/src/charts/DotPlot/facetSize.d.ts +33 -0
- package/types/src/charts/DotPlot/index.d.ts +22 -0
- package/types/src/charts/DotPlot/placements.d.ts +28 -0
- package/types/src/charts/DotPlot/tooltip.d.ts +27 -0
- package/types/src/charts/Dumbbell/arrowGrays.d.ts +33 -0
- package/types/src/charts/Dumbbell/categoryChange.d.ts +66 -0
- package/types/src/charts/Dumbbell/changeEmit.d.ts +71 -0
- package/types/src/charts/Dumbbell/changes.d.ts +64 -0
- package/types/src/charts/Dumbbell/connectors.d.ts +43 -0
- package/types/src/charts/Dumbbell/emit.d.ts +17 -19
- package/types/src/charts/Dumbbell/index.d.ts +6 -2
- package/types/src/charts/Gantt/applyLayout.d.ts +14 -1
- package/types/src/charts/Gantt/criticalPath.d.ts +100 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -1
- package/types/src/charts/Gantt/ganttCalendar.d.ts +37 -0
- package/types/src/charts/Gantt/ganttCritical.d.ts +53 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +32 -2
- package/types/src/charts/Gantt/ganttRows.d.ts +2 -0
- package/types/src/charts/Gantt/ganttSlack.d.ts +21 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +35 -15
- package/types/src/charts/Gantt/index.d.ts +12 -6
- package/types/src/charts/Geomap/applyLayout.d.ts +19 -0
- package/types/src/charts/Geomap/cartogram.d.ts +58 -0
- package/types/src/charts/Geomap/cartogramContiguous.d.ts +59 -0
- package/types/src/charts/Geomap/cartogramFields.d.ts +16 -0
- package/types/src/charts/Geomap/cartogramLabels.d.ts +48 -0
- package/types/src/charts/Geomap/cartogramLayout.d.ts +71 -0
- package/types/src/charts/Geomap/cartogramLegend.d.ts +36 -0
- package/types/src/charts/Geomap/cartogramRelax.d.ts +29 -0
- package/types/src/charts/Geomap/densityEmit.d.ts +29 -0
- package/types/src/charts/Geomap/densityFields.d.ts +27 -0
- package/types/src/charts/Geomap/densityLayout.d.ts +49 -0
- package/types/src/charts/Geomap/densityTooltip.d.ts +48 -0
- package/types/src/charts/Geomap/dotDensity.d.ts +80 -0
- package/types/src/charts/Geomap/dotDensityLayout.d.ts +97 -0
- package/types/src/charts/Geomap/dotRenderer.d.ts +27 -0
- package/types/src/charts/Geomap/drillDown.d.ts +128 -0
- package/types/src/charts/Geomap/drillEmit.d.ts +37 -0
- package/types/src/charts/Geomap/drillEvents.d.ts +33 -0
- package/types/src/charts/Geomap/emit.d.ts +7 -0
- package/types/src/charts/Geomap/flowEmit.d.ts +6 -4
- package/types/src/charts/Geomap/flowLinks.d.ts +12 -1
- package/types/src/charts/Geomap/geoHexbin.d.ts +91 -0
- package/types/src/charts/Geomap/geoHexbinZoom.d.ts +76 -0
- package/types/src/charts/Geomap/index.d.ts +7 -0
- package/types/src/charts/Geomap/pointCluster.d.ts +108 -0
- package/types/src/charts/Geomap/pointClusterEmit.d.ts +106 -0
- package/types/src/charts/Geomap/pointClusterLayout.d.ts +123 -0
- package/types/src/charts/Geomap/pointClusterLinks.d.ts +21 -0
- package/types/src/charts/Geomap/pointClusterZoom.d.ts +89 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +21 -3
- package/types/src/charts/Geomap/pointRows.d.ts +24 -0
- package/types/src/charts/Geomap/tileGrid.d.ts +98 -0
- package/types/src/charts/Geomap/tileState.d.ts +18 -0
- package/types/src/charts/Geomap/topojsonFluent.d.ts +9 -0
- package/types/src/charts/Geomap/topojsonLevels.d.ts +14 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +6 -5
- package/types/src/charts/Hexbin/settings.d.ts +7 -1
- package/types/src/charts/Histogram/binData.d.ts +6 -0
- package/types/src/charts/HorizonChart/emit.d.ts +20 -0
- package/types/src/charts/HorizonChart/horizonBands.d.ts +42 -0
- package/types/src/charts/HorizonChart/horizonColors.d.ts +25 -0
- package/types/src/charts/HorizonChart/hover.d.ts +52 -0
- package/types/src/charts/HorizonChart/index.d.ts +32 -0
- package/types/src/charts/HorizonChart/measure.d.ts +24 -0
- package/types/src/charts/HorizonChart/rowFilter.d.ts +88 -0
- package/types/src/charts/HorizonChart/state.d.ts +71 -0
- package/types/src/charts/KPI/applyLayout.d.ts +64 -0
- package/types/src/charts/KPI/delta.d.ts +62 -0
- package/types/src/charts/KPI/emit.d.ts +55 -0
- package/types/src/charts/KPI/index.d.ts +34 -0
- package/types/src/charts/KPI/series.d.ts +45 -0
- package/types/src/charts/KPI/tileLayout.d.ts +90 -0
- package/types/src/charts/Matrix/applyLayout.d.ts +5 -2
- package/types/src/charts/Matrix/bubbles.d.ts +87 -0
- package/types/src/charts/Matrix/emit.d.ts +3 -2
- package/types/src/charts/Matrix/index.d.ts +2 -1
- package/types/src/charts/Network/applyLayout.d.ts +35 -0
- package/types/src/charts/Network/bundle.d.ts +24 -15
- package/types/src/charts/Network/circleLayout.d.ts +149 -0
- package/types/src/charts/Network/containNodes.d.ts +35 -0
- package/types/src/charts/Network/emit.d.ts +20 -0
- package/types/src/charts/Network/forceLayout.d.ts +49 -0
- package/types/src/charts/Network/graph.d.ts +29 -5
- package/types/src/charts/Network/liveForce.d.ts +133 -0
- package/types/src/charts/Network/livePositions.d.ts +90 -0
- package/types/src/charts/Network/networkDrag.d.ts +55 -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/Pareto/color.d.ts +21 -0
- package/types/src/charts/Pareto/hover.d.ts +38 -0
- package/types/src/charts/Pareto/index.d.ts +22 -0
- package/types/src/charts/Pareto/labels.d.ts +40 -0
- package/types/src/charts/Pareto/order.d.ts +30 -0
- package/types/src/charts/Pareto/paretoSteps.d.ts +65 -0
- package/types/src/charts/Pareto/state.d.ts +93 -0
- package/types/src/charts/Parliament/index.d.ts +18 -0
- package/types/src/charts/Plot/areaEnter.d.ts +34 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +7 -0
- package/types/src/charts/Plot/aspectRatio.d.ts +68 -0
- package/types/src/charts/Plot/axisHover.d.ts +2 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +44 -1
- package/types/src/charts/Plot/barConfidence.d.ts +14 -1
- package/types/src/charts/Plot/barHitArea.d.ts +34 -7
- package/types/src/charts/Plot/barLabelConfidence.d.ts +25 -0
- package/types/src/charts/Plot/baselineBreak.d.ts +2 -1
- package/types/src/charts/Plot/baselineDomain.d.ts +5 -0
- package/types/src/charts/Plot/circleLabels.d.ts +8 -7
- package/types/src/charts/Plot/confidenceAxes.d.ts +63 -0
- package/types/src/charts/Plot/confidenceTooltip.d.ts +22 -0
- package/types/src/charts/Plot/discreteDomain.d.ts +13 -2
- package/types/src/charts/Plot/discreteSpan.d.ts +5 -0
- package/types/src/charts/Plot/domainClip.d.ts +15 -5
- package/types/src/charts/Plot/downsample.d.ts +16 -0
- package/types/src/charts/Plot/index.d.ts +20 -17
- package/types/src/charts/Plot/inferDiscrete.d.ts +31 -0
- package/types/src/charts/Plot/jitter.d.ts +45 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +19 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +19 -6
- package/types/src/charts/Plot/lineMarkerKeys.d.ts +11 -0
- package/types/src/charts/Plot/marginalHover.d.ts +26 -0
- package/types/src/charts/Plot/marginalLayout.d.ts +95 -0
- package/types/src/charts/Plot/marginalPaint.d.ts +54 -0
- package/types/src/charts/Plot/marginalScene.d.ts +67 -0
- package/types/src/charts/Plot/marginalSeries.d.ts +38 -0
- package/types/src/charts/Plot/marginalStats.d.ts +115 -0
- package/types/src/charts/Plot/openDomainEnds.d.ts +25 -0
- package/types/src/charts/Plot/orderPath.d.ts +100 -0
- package/types/src/charts/Plot/orderPathScene.d.ts +49 -0
- package/types/src/charts/Plot/outlierDetect.d.ts +87 -0
- package/types/src/charts/Plot/outlierLabels.d.ts +103 -0
- package/types/src/charts/Plot/outlierLines.d.ts +30 -0
- package/types/src/charts/Plot/outlierScene.d.ts +103 -0
- package/types/src/charts/Plot/outlierTooltip.d.ts +44 -0
- package/types/src/charts/Plot/periodLabels.d.ts +14 -0
- package/types/src/charts/Plot/pipeline.d.ts +2 -1
- package/types/src/charts/Plot/plotBreaks.d.ts +21 -6
- package/types/src/charts/Plot/plotInit.d.ts +7 -25
- package/types/src/charts/Plot/plotLevels.d.ts +120 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +28 -2
- package/types/src/charts/Plot/plotShapes.d.ts +42 -0
- package/types/src/charts/Plot/pointConfidence.d.ts +73 -0
- package/types/src/charts/Plot/pointKey.d.ts +9 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +2 -1
- package/types/src/charts/Plot/shapeAccessors.d.ts +24 -0
- package/types/src/charts/Plot/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedHover.d.ts +5 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +31 -7
- package/types/src/charts/Plot/stackEnter.d.ts +1 -1
- package/types/src/charts/Plot/stackLegendOrder.d.ts +4 -1
- package/types/src/charts/Plot/stackNeutral.d.ts +85 -0
- package/types/src/charts/Plot/swarm.d.ts +8 -4
- package/types/src/charts/Plot/timeNestKeys.d.ts +20 -0
- package/types/src/charts/Plot/trendLabels.d.ts +15 -6
- package/types/src/charts/Plot/trendLines.d.ts +40 -8
- package/types/src/charts/Plot/trendMovingAverage.d.ts +78 -0
- package/types/src/charts/Plot/trendProjection.d.ts +4 -2
- package/types/src/charts/Plot/trendTooltip.d.ts +24 -2
- package/types/src/charts/Priestley/timeAxis.d.ts +13 -7
- 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 +5 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +35 -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/RadialArea/index.d.ts +17 -0
- package/types/src/charts/RadialLine/angles.d.ts +67 -0
- package/types/src/charts/RadialLine/applyLayout.d.ts +70 -0
- package/types/src/charts/RadialLine/emit.d.ts +13 -0
- package/types/src/charts/RadialLine/index.d.ts +28 -0
- package/types/src/charts/RadialLine/paths.d.ts +37 -0
- package/types/src/charts/RadialLine/points.d.ts +43 -0
- package/types/src/charts/RadialLine/series.d.ts +63 -0
- package/types/src/charts/RadialLine/seriesLabelNodes.d.ts +26 -0
- package/types/src/charts/RadialLine/seriesLabels.d.ts +80 -0
- package/types/src/charts/RadialLine/spokes.d.ts +15 -0
- package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/RadialTree/index.d.ts +16 -0
- package/types/src/charts/Rings/emit.d.ts +28 -5
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +46 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +32 -5
- package/types/src/charts/Rings/ringsParallel.d.ts +4 -2
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +41 -11
- package/types/src/charts/Sankey/circularLayout.d.ts +3 -0
- package/types/src/charts/Sankey/sankeyDrag.d.ts +112 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +8 -0
- package/types/src/charts/Scatter/index.d.ts +3 -2
- package/types/src/charts/ScatterMatrix/binEmit.d.ts +22 -0
- package/types/src/charts/ScatterMatrix/index.d.ts +80 -0
- package/types/src/charts/ScatterMatrix/matrixData.d.ts +93 -0
- package/types/src/charts/ScatterMatrix/matrixFacet.d.ts +32 -0
- package/types/src/charts/ScatterMatrix/matrixHover.d.ts +21 -0
- package/types/src/charts/ScatterMatrix/matrixTooltip.d.ts +32 -0
- package/types/src/charts/StripPlot/index.d.ts +16 -0
- package/types/src/charts/TileGridMap/index.d.ts +14 -0
- package/types/src/charts/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/index.d.ts +2 -2
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeHeight.d.ts +41 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/Tree/radialLabels.d.ts +24 -0
- package/types/src/charts/Tree/radialLayout.d.ts +129 -0
- package/types/src/charts/Venn/applyLayout.d.ts +91 -0
- package/types/src/charts/Venn/circles.d.ts +87 -0
- package/types/src/charts/Venn/ellipseFrame.d.ts +37 -0
- package/types/src/charts/Venn/emit.d.ts +36 -0
- package/types/src/charts/Venn/index.d.ts +30 -0
- package/types/src/charts/Venn/nelderMead.d.ts +28 -0
- package/types/src/charts/Venn/tooltip.d.ts +8 -0
- package/types/src/charts/Venn/vennData.d.ts +56 -0
- package/types/src/charts/Venn/vennEllipses.d.ts +93 -0
- package/types/src/charts/Venn/vennFit.d.ts +39 -0
- package/types/src/charts/Venn/vennLayout.d.ts +52 -0
- package/types/src/charts/Venn/vennRegions.d.ts +58 -0
- package/types/src/charts/Waffle/applyLayout.d.ts +4 -1
- package/types/src/charts/Waffle/arcEmit.d.ts +45 -0
- package/types/src/charts/Waffle/arcLayout.d.ts +82 -0
- package/types/src/charts/Waffle/arcStage.d.ts +60 -0
- package/types/src/charts/Waffle/emit.d.ts +2 -1
- package/types/src/charts/Waffle/index.d.ts +8 -2
- package/types/src/charts/Waffle/tooltip.d.ts +7 -2
- package/types/src/charts/Waterfall/connectors.d.ts +3 -2
- package/types/src/charts/WordCloud/applyLayout.d.ts +51 -0
- package/types/src/charts/WordCloud/cloudLayout.d.ts +95 -0
- package/types/src/charts/WordCloud/emit.d.ts +27 -0
- package/types/src/charts/WordCloud/fontScale.d.ts +20 -0
- package/types/src/charts/WordCloud/glyphMask.d.ts +95 -0
- package/types/src/charts/WordCloud/index.d.ts +31 -0
- package/types/src/charts/WordCloud/occupancy.d.ts +59 -0
- package/types/src/charts/WordCloud/rotation.d.ts +31 -0
- package/types/src/charts/WordCloud/size.d.ts +16 -0
- package/types/src/charts/WordCloud/spiral.d.ts +47 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -0
- package/types/src/charts/definition/declaresField.d.ts +9 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -3
- package/types/src/charts/drawSteps/gestureHover.d.ts +2 -2
- package/types/src/charts/drawSteps/leavesSurface.d.ts +11 -0
- package/types/src/charts/drawSteps/selectActions.d.ts +58 -0
- package/types/src/charts/drawSteps/selectGesture.d.ts +60 -0
- package/types/src/charts/drawSteps/selectRegion.d.ts +86 -0
- package/types/src/charts/drawSteps/selectState.d.ts +51 -0
- package/types/src/charts/drawSteps/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +32 -7
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +104 -16
- package/types/src/charts/drawSteps/zoomControlsMenu.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomDrag.d.ts +73 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- package/types/src/charts/facet/drawFacets.d.ts +6 -3
- package/types/src/charts/facet/facetConfig.d.ts +35 -1
- package/types/src/charts/facet/facetData.d.ts +8 -2
- package/types/src/charts/facet/facetGrid.d.ts +12 -0
- package/types/src/charts/facet/facetGutter.d.ts +19 -5
- package/types/src/charts/facet/facetLayout.d.ts +79 -0
- package/types/src/charts/facet/facetLayouts.d.ts +21 -0
- package/types/src/charts/facet/facetScene.d.ts +4 -1
- package/types/src/charts/features/annotationFrame.d.ts +2 -0
- package/types/src/charts/features/axesFinal.d.ts +5 -2
- package/types/src/charts/features/axisTooltip.d.ts +49 -0
- package/types/src/charts/features/bareRegion.d.ts +18 -0
- package/types/src/charts/features/boxGrid.d.ts +28 -0
- package/types/src/charts/features/centerLabel.d.ts +89 -0
- package/types/src/charts/features/circleLabelPlacement.d.ts +81 -11
- package/types/src/charts/features/circleLabels.d.ts +33 -3
- 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 +14 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +38 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +6 -0
- package/types/src/charts/features/curvedArrows.d.ts +42 -12
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +68 -31
- package/types/src/charts/features/emitHelpers.d.ts +6 -1
- package/types/src/charts/features/featuresColorScale.d.ts +6 -0
- package/types/src/charts/features/hoverTicks.d.ts +33 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- package/types/src/charts/features/keyHold.d.ts +41 -0
- package/types/src/charts/features/keyTooltip.d.ts +44 -0
- package/types/src/charts/features/labelLayering.d.ts +38 -0
- package/types/src/charts/features/labelSlots.d.ts +53 -0
- package/types/src/charts/features/linkInteraction.d.ts +13 -4
- package/types/src/charts/features/linkLabelPath.d.ts +0 -7
- package/types/src/charts/features/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeDrag.d.ts +51 -0
- package/types/src/charts/features/nodeKeys.d.ts +53 -0
- package/types/src/charts/features/nodeOutline.d.ts +34 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -0
- package/types/src/charts/features/pathLabelBends.d.ts +78 -0
- package/types/src/charts/features/plotAnnotations.d.ts +2 -1
- package/types/src/charts/features/plotEndLabels.d.ts +14 -1
- package/types/src/charts/features/plotPaint.d.ts +5 -0
- package/types/src/charts/features/rectNodeSize.d.ts +42 -0
- package/types/src/charts/features/ringLabels.d.ts +3 -1
- package/types/src/charts/features/selfLoops.d.ts +10 -9
- package/types/src/charts/features/shapeEmit.d.ts +2 -0
- package/types/src/charts/features/sharedFields.d.ts +8 -4
- package/types/src/charts/features/spokeLabels.d.ts +123 -0
- package/types/src/charts/features/swatchPaint.d.ts +58 -0
- package/types/src/charts/features/textHalo.d.ts +4 -3
- package/types/src/charts/features/thresholdMembers.d.ts +6 -6
- package/types/src/charts/features/tooltipRows.d.ts +50 -0
- package/types/src/charts/features/tooltipSwatch.d.ts +25 -11
- package/types/src/charts/helpers/valueTitle.d.ts +7 -0
- package/types/src/charts/index.d.ts +17 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- package/types/src/charts/pipeline/insetPlacement.d.ts +6 -0
- package/types/src/charts/pipeline/preDrawData.d.ts +26 -0
- package/types/src/charts/plotBuffers/Circle.d.ts +2 -1
- package/types/src/charts/plotBuffers/Rect.d.ts +2 -1
- package/types/src/charts/plotBuffers/Tick.d.ts +9 -0
- package/types/src/charts/plotBuffers/defaultBuffers.d.ts +2 -0
- package/types/src/charts/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +10 -3
- package/types/src/charts/viz/VizBase.d.ts +63 -3
- package/types/src/charts/viz/appendRows.d.ts +49 -0
- package/types/src/charts/viz/backgroundInk.d.ts +8 -0
- package/types/src/charts/viz/dataChanged.d.ts +11 -0
- package/types/src/charts/viz/discrete.d.ts +19 -0
- 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/focusTargets.d.ts +15 -1
- package/types/src/charts/viz/groupByLevels.d.ts +36 -0
- package/types/src/charts/viz/groupRow.d.ts +6 -0
- package/types/src/charts/viz/hoverBand.d.ts +28 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +23 -2
- package/types/src/charts/viz/keyboardNav.d.ts +13 -0
- package/types/src/charts/viz/liftRaised.d.ts +23 -0
- package/types/src/charts/viz/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +38 -0
- package/types/src/charts/viz/simpleHover.d.ts +3 -3
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +43 -0
- package/types/src/charts/viz/vizFields.d.ts +12 -0
- package/types/src/charts/viz/vizTypes.d.ts +132 -2
- package/types/src/charts/viz/vizVisibility.d.ts +7 -0
- package/types/src/components/Axis/Axis.d.ts +68 -3
- package/types/src/components/Axis/axisBreak.d.ts +19 -3
- package/types/src/components/Axis/axisDefaults.d.ts +14 -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 +57 -3
- 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 +16 -2
- package/types/src/components/Axis/axisLevels.d.ts +137 -0
- 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/axisMinorTicks.d.ts +83 -0
- package/types/src/components/Axis/axisPeriods.d.ts +45 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +6 -2
- package/types/src/components/Axis/axisRounding.d.ts +22 -0
- package/types/src/components/Axis/axisScaleType.d.ts +32 -0
- package/types/src/components/Axis/axisScene.d.ts +15 -7
- package/types/src/components/Axis/axisTickLookups.d.ts +26 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +94 -0
- package/types/src/components/Axis/labelSizeSession.d.ts +16 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +6 -2
- package/types/src/components/Axis/timeValues.d.ts +48 -2
- package/types/src/components/ColorScale/ColorScale.d.ts +21 -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/colorScaleScale.d.ts +45 -0
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +5 -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/TextBox.d.ts +4 -0
- package/types/src/components/Tooltip.d.ts +11 -2
- package/types/src/components/textEllipsis.d.ts +6 -0
- package/types/src/components/tooltipDom.d.ts +24 -0
- package/types/src/fluent.d.ts +48 -1
- package/types/src/shapes/Bar.d.ts +7 -0
- package/types/src/shapes/Box.d.ts +15 -0
- package/types/src/shapes/Shape.d.ts +11 -0
- package/types/src/shapes/Tick.d.ts +20 -0
- package/types/src/shapes/boxExtraShapes.d.ts +40 -0
- package/types/src/shapes/boxExtras.d.ts +85 -0
- package/types/src/shapes/boxStyle.d.ts +25 -4
- package/types/src/shapes/downsample.d.ts +68 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/hitAreaNode.d.ts +2 -1
- package/types/src/shapes/index.d.ts +1 -0
- package/types/src/shapes/pathSeries.d.ts +35 -0
- package/types/src/shapes/shapeConfig.d.ts +70 -2
- package/types/src/utils/BaseClass.d.ts +18 -4
- package/types/src/utils/D3plusConfig.d.ts +1458 -676
- package/types/src/utils/configValue.d.ts +8 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/jitter.d.ts +23 -0
- package/types/src/utils/resetSetters.d.ts +23 -0
- package/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +109828 -74615
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +90460 -56685
- package/umd/d3plus-core.min.js +2 -2
|
@@ -9,18 +9,42 @@ import { accessor, BaseClass, paintComponentScene } from "../../utils/index.js";
|
|
|
9
9
|
import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
10
10
|
import { inkText } from "../../utils/themeInk.js";
|
|
11
11
|
import Legend from "../Legend/Legend.js";
|
|
12
|
+
import { inertAxis } from "../Axis/axisTooltipTargets.js";
|
|
12
13
|
import { formatYear, isYearLike } from "../Axis/yearValues.js";
|
|
13
14
|
import { bucketBounds, labelValue } from "./bucketBounds.js";
|
|
14
15
|
import { computeColorScale } from "./colorScaleScale.js";
|
|
15
16
|
import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
16
17
|
import { isBucketScale } from "./colorScaleType.js";
|
|
17
18
|
import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
19
|
+
import { swatchTooltips } from "./colorScaleSwatchTooltips.js";
|
|
20
|
+
import { renderBivariate } from "./bivariateRender.js";
|
|
18
21
|
/** ColorScale's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const colorScaleSchema = [
|
|
19
22
|
{
|
|
20
23
|
key: "align",
|
|
21
24
|
coerce: "identity",
|
|
22
25
|
default: "middle"
|
|
23
26
|
},
|
|
27
|
+
// A bivariate scale reads a pair of values from each row and draws its
|
|
28
|
+
// grid of colors as a diamond key (see bivariateRender.ts).
|
|
29
|
+
{
|
|
30
|
+
key: "bivariate",
|
|
31
|
+
coerce: "identity",
|
|
32
|
+
default: false
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
key: "bivariateBuckets",
|
|
36
|
+
coerce: "identity",
|
|
37
|
+
default: 3
|
|
38
|
+
},
|
|
39
|
+
// No default grid: an unset one paints Stevens' blue–red scheme.
|
|
40
|
+
{
|
|
41
|
+
key: "bivariateColors",
|
|
42
|
+
coerce: "identity"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
key: "bivariateLabels",
|
|
46
|
+
coerce: "identity"
|
|
47
|
+
},
|
|
24
48
|
{
|
|
25
49
|
key: "buckets",
|
|
26
50
|
coerce: "identity",
|
|
@@ -158,7 +182,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
158
182
|
_rectClass;
|
|
159
183
|
/** The scale the last render built, with a `scale` function resolved. */ _scaleType = "linear";
|
|
160
184
|
/** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */ _barGeometry;
|
|
161
|
-
/** The value marked on the scale, set with `hover()
|
|
185
|
+
/** The value marked on the scale, set with `hover()`: a pair of values on a bivariate scale. */ _hoverValue;
|
|
186
|
+
/** The names a chart gives a bivariate scale's two variables (its field names), under `bivariateLabels`. */ _bivariateFields;
|
|
187
|
+
/** The bivariate key's nodes, laid out by the last render. */ _bivariateNodes;
|
|
188
|
+
/** Each swatch's legend row, with its bucket, set when the swatch variant renders. */ _swatchBuckets = new Map();
|
|
162
189
|
/** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */ _gradientFill;
|
|
163
190
|
// Standalone scene renderer (used when rendered on its own, not inside a
|
|
164
191
|
// Viz). Reused across re-renders by paintComponentScene().
|
|
@@ -191,6 +218,8 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
191
218
|
fontSize: 12
|
|
192
219
|
};
|
|
193
220
|
this._legendClass = new Legend();
|
|
221
|
+
// Swatch labels that don't fit whole are cut short, not left out.
|
|
222
|
+
this._legendClass._cutLabels = true;
|
|
194
223
|
this.schema.legendConfig = {
|
|
195
224
|
shapeConfig: {
|
|
196
225
|
stroke: ()=>this.schema.colorDefaults.dark,
|
|
@@ -208,6 +237,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
208
237
|
stroke: "#999",
|
|
209
238
|
strokeWidth: 1
|
|
210
239
|
};
|
|
240
|
+
this._constructed(new.target, ColorScale);
|
|
211
241
|
}
|
|
212
242
|
/**
|
|
213
243
|
Renders the current ColorScale to the page.
|
|
@@ -222,8 +252,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
222
252
|
this._group = elem("g.d3plus-ColorScale", {
|
|
223
253
|
parent: this._select
|
|
224
254
|
});
|
|
225
|
-
const
|
|
226
|
-
|
|
255
|
+
const bivariate = Boolean(this.schema.bivariate);
|
|
256
|
+
this._bivariateNodes = bivariate ? renderBivariate(this).nodes : undefined;
|
|
257
|
+
const compute = bivariate ? undefined : computeColorScale(this);
|
|
258
|
+
const gradient = !bivariate && (this.schema.bucketAxis || !isBucketScale(compute.scale));
|
|
227
259
|
const t = transition().duration(this.schema.duration);
|
|
228
260
|
const groupParams = {
|
|
229
261
|
enter: {
|
|
@@ -245,7 +277,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
245
277
|
condition: gradient
|
|
246
278
|
}, groupParams));
|
|
247
279
|
const legendGroup = elem("g.d3plus-ColorScale-legend", Object.assign({
|
|
248
|
-
condition: !gradient
|
|
280
|
+
condition: !gradient && !bivariate
|
|
249
281
|
}, groupParams));
|
|
250
282
|
const groups = {
|
|
251
283
|
labelGroup,
|
|
@@ -254,8 +286,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
254
286
|
groupParams,
|
|
255
287
|
gradient
|
|
256
288
|
};
|
|
257
|
-
if (
|
|
258
|
-
|
|
289
|
+
if (compute) {
|
|
290
|
+
if (gradient) renderGradient(this, compute, groups);
|
|
291
|
+
else renderLegendVariant(this, compute, groups);
|
|
292
|
+
}
|
|
259
293
|
// Standalone render: paint the scene into the user's `_select`. Inside a
|
|
260
294
|
// Viz the color scale runs in compute mode and the Viz composes its
|
|
261
295
|
// toScene().
|
|
@@ -266,10 +300,13 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
266
300
|
/**
|
|
267
301
|
Produces a backend-agnostic scene graph for this ColorScale with no DOM
|
|
268
302
|
dependency. The discrete variant (jenks/buckets/quantile) delegates to the
|
|
269
|
-
internal Legend's toScene()
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
303
|
+
internal Legend's toScene(), its title and swatch labels taking the axis
|
|
304
|
+
tooltips (see `swatchTooltips`); the gradient variant composes the Rect,
|
|
305
|
+
Axis, and label TextBox scenes, all as chrome (see `inertAxis`): only an
|
|
306
|
+
axis label with a tooltip takes the pointer. The scaleGroup's
|
|
307
|
+
translate (set by the chart's colorScale feature on
|
|
308
|
+
`g.d3plus-viz-colorScale`) is read off `_select` so the content lands at
|
|
309
|
+
its on-screen position.
|
|
273
310
|
|
|
274
311
|
A smooth (non-bucketed) gradient paints its Rect with a `gradient:<json>`
|
|
275
312
|
fill token (see renderGradientStops); the backend materializes it into a
|
|
@@ -278,18 +315,26 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
278
315
|
*/ toScene() {
|
|
279
316
|
const children = [];
|
|
280
317
|
const gradient = this.schema.bucketAxis || !isBucketScale(this._scaleType);
|
|
281
|
-
const pushScene = (cls)=>{
|
|
318
|
+
const pushScene = (cls, finish = (scene)=>scene)=>{
|
|
282
319
|
if (cls && typeof cls.toScene === "function") {
|
|
283
320
|
const s = cls.toScene();
|
|
284
|
-
if (s) children.push(s);
|
|
321
|
+
if (s) children.push(finish(s));
|
|
285
322
|
}
|
|
286
323
|
};
|
|
287
|
-
if (
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
pushScene(this.
|
|
324
|
+
if (this._bivariateNodes) {
|
|
325
|
+
children.push(...this._bivariateNodes);
|
|
326
|
+
} else if (gradient) {
|
|
327
|
+
pushScene(this._rectClass, inertAxis);
|
|
328
|
+
pushScene(this._axisClass, inertAxis);
|
|
329
|
+
pushScene(this._labelClass, inertAxis);
|
|
291
330
|
} else {
|
|
292
|
-
pushScene(this._legendClass)
|
|
331
|
+
pushScene(this._legendClass, (scene)=>swatchTooltips(scene, {
|
|
332
|
+
title: this._legendClass.schema.title,
|
|
333
|
+
titleDatum: this._legendClass._titleClass.data()[0],
|
|
334
|
+
titleTooltip: this.schema.axisConfig.titleTooltip,
|
|
335
|
+
tickTooltip: this.schema.axisConfig.tickTooltip,
|
|
336
|
+
buckets: this._swatchBuckets
|
|
337
|
+
}));
|
|
293
338
|
}
|
|
294
339
|
// Preserve the placement of the scaleGroup the chart's colorScale feature
|
|
295
340
|
// positioned (translate on `g.d3plus-viz-colorScale`).
|
|
@@ -313,7 +358,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
313
358
|
} : {},
|
|
314
359
|
children
|
|
315
360
|
};
|
|
316
|
-
addHoverMark(this, group);
|
|
361
|
+
if (!this._bivariateNodes) addHoverMark(this, group);
|
|
317
362
|
return group;
|
|
318
363
|
}
|
|
319
364
|
axisConfig(_) {
|
|
@@ -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
|
+
}
|