@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
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The config a Geomap cartogram adds, and how small multiples share its
|
|
3
|
+
sizes.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/ import { fieldAccessor } from "../../utils/fieldAccessor.js";
|
|
7
|
+
import { cartogramKind, cartogramValue } from "./cartogramLayout.js";
|
|
8
|
+
/** Geomap's cartogram fields. */ export function cartogramFields() {
|
|
9
|
+
return [
|
|
10
|
+
/**
|
|
11
|
+
Redraws the map as a cartogram, its regions sized by `cartogramSize`:
|
|
12
|
+
`"dorling"` draws each region as a circle and `"demers"` as a square,
|
|
13
|
+
its area in proportion to the region's value, set at the region's
|
|
14
|
+
center and nudged apart until none overlap; `"contiguous"` stretches
|
|
15
|
+
the regions themselves, keeping their shared borders. `false` draws
|
|
16
|
+
the map.
|
|
17
|
+
@type {"dorling" | "demers" | "contiguous" | false}
|
|
18
|
+
*/ {
|
|
19
|
+
key: "cartogram",
|
|
20
|
+
default: false
|
|
21
|
+
},
|
|
22
|
+
/**
|
|
23
|
+
The gap left between neighboring cartogram shapes, in pixels.
|
|
24
|
+
@type {number}
|
|
25
|
+
*/ {
|
|
26
|
+
key: "cartogramPadding",
|
|
27
|
+
default: 1
|
|
28
|
+
},
|
|
29
|
+
/**
|
|
30
|
+
The value that sizes each region in a `cartogram`: a data key or an
|
|
31
|
+
accessor function. Defaults to the `colorScale` value.
|
|
32
|
+
@type {string | function}
|
|
33
|
+
*/ {
|
|
34
|
+
key: "cartogramSize",
|
|
35
|
+
coerce: (value)=>!value || typeof value === "function" ? value : fieldAccessor(value)
|
|
36
|
+
}
|
|
37
|
+
];
|
|
38
|
+
}
|
|
39
|
+
/** The sum of the values a panel's cartogram sizes. */ function panelTotal(viz, rows) {
|
|
40
|
+
return rows.reduce((sum, d, i)=>{
|
|
41
|
+
const v = cartogramValue(viz, d, i);
|
|
42
|
+
return v > 0 ? sum + v : sum;
|
|
43
|
+
}, 0);
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
Geomap's small-multiple hooks: with shared scales (the default), every
|
|
47
|
+
panel's cartogram sizes its shapes against the panel with the largest
|
|
48
|
+
total, so the same value draws the same size in every panel.
|
|
49
|
+
*/ export const geomapFacetHooks = {
|
|
50
|
+
// A `hexbin` colorScale reads every panel's bins.
|
|
51
|
+
chrome: (viz, panels)=>{
|
|
52
|
+
viz.ctx.geomapPanels = panels;
|
|
53
|
+
},
|
|
54
|
+
share: (viz, panels)=>cartogramKind(viz) ? Math.max(0, ...panels.map((rows)=>panelTotal(viz, rows))) : undefined,
|
|
55
|
+
panel: (viz, ctx)=>{
|
|
56
|
+
const saved = viz.ctx.cartogramTotal;
|
|
57
|
+
const total = ctx.shared ? ctx.scales : undefined;
|
|
58
|
+
viz.ctx.cartogramTotal = total || undefined;
|
|
59
|
+
return ()=>{
|
|
60
|
+
viz.ctx.cartogramTotal = saved;
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
};
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Labels of a Geomap cartogram: each region's label sits inside its circle
|
|
3
|
+
or square, sized to fit, and hides when it can't fit at the smallest
|
|
4
|
+
font size.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/ import { colorContrast } from "@d3plus/color";
|
|
8
|
+
import { emitLabels } from "../../shapes/emitLabels.js";
|
|
9
|
+
import constant from "../../utils/constant.js";
|
|
10
|
+
import { resolveAccessor, userLabelConfig } from "../features/emitHelpers.js";
|
|
11
|
+
/**
|
|
12
|
+
The box a label may fill inside a cartogram shape, centered on it: the
|
|
13
|
+
rectangle inscribed in a circle (wider than tall), or the whole square.
|
|
14
|
+
@param shape The circle or square.
|
|
15
|
+
*/ export function cartogramLabelBox(shape) {
|
|
16
|
+
const { r } = shape;
|
|
17
|
+
if (shape.square) return {
|
|
18
|
+
x: -r,
|
|
19
|
+
y: -r,
|
|
20
|
+
width: 2 * r,
|
|
21
|
+
height: 2 * r
|
|
22
|
+
};
|
|
23
|
+
return {
|
|
24
|
+
x: -r * 0.8,
|
|
25
|
+
y: -r * 0.6,
|
|
26
|
+
width: r * 1.6,
|
|
27
|
+
height: r * 1.2
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
The scene nodes of a cartogram's labels: the Path shapeConfig's `label`
|
|
32
|
+
(`false` turns them off), else the chart's label for the row.
|
|
33
|
+
@param viz The Geomap.
|
|
34
|
+
@param regions The regions, in the order they're drawn.
|
|
35
|
+
@param shapes Each region's cartogram shape, by region id.
|
|
36
|
+
@param pathConfig The merged Path shapeConfig.
|
|
37
|
+
@param options `all` labels the shapes of regions without data too
|
|
38
|
+
(whose datum is the region), `text` gives a region's label in place of
|
|
39
|
+
the chart's, and `fontMax` caps the font size (24 by default).
|
|
40
|
+
*/ export function cartogramLabels(viz, regions, shapes, pathConfig, options = {}) {
|
|
41
|
+
if (pathConfig.label === false) return [];
|
|
42
|
+
const items = [];
|
|
43
|
+
regions.forEach((region, index)=>{
|
|
44
|
+
const shape = shapes.get(region.id);
|
|
45
|
+
const datum = region.data ?? (options.all ? region : undefined);
|
|
46
|
+
// A distorted region (a contiguous cartogram) keeps the map's own labels: none.
|
|
47
|
+
if (shape && datum && shape.r > 0) items.push({
|
|
48
|
+
region,
|
|
49
|
+
datum: datum,
|
|
50
|
+
index,
|
|
51
|
+
shape
|
|
52
|
+
});
|
|
53
|
+
});
|
|
54
|
+
if (!items.length) return [];
|
|
55
|
+
const rows = items.map((item)=>item.datum);
|
|
56
|
+
const byRow = new Map(items.map((item)=>[
|
|
57
|
+
item.datum,
|
|
58
|
+
item
|
|
59
|
+
]));
|
|
60
|
+
const item = (d)=>byRow.get(d);
|
|
61
|
+
const fillOf = (d)=>resolveAccessor(pathConfig.fill, d, item(d).index);
|
|
62
|
+
const text = (d)=>{
|
|
63
|
+
const { index } = item(d);
|
|
64
|
+
if (pathConfig.label !== undefined) return resolveAccessor(pathConfig.label, d, index) ?? false;
|
|
65
|
+
if (options.text) return options.text(item(d).region);
|
|
66
|
+
return viz._drawLabel(d, index);
|
|
67
|
+
};
|
|
68
|
+
const nodes = emitLabels({
|
|
69
|
+
data: rows,
|
|
70
|
+
label: text,
|
|
71
|
+
x: (d)=>item(d).shape.x,
|
|
72
|
+
y: (d)=>item(d).shape.y,
|
|
73
|
+
aes: (d)=>item(d).shape,
|
|
74
|
+
rotate: constant(0),
|
|
75
|
+
id: (d)=>`geomap-cartogram-label-${item(d).region.id}`,
|
|
76
|
+
labelBounds: (d)=>cartogramLabelBox(item(d).shape),
|
|
77
|
+
labelConfig: {
|
|
78
|
+
fontColor: (rec)=>{
|
|
79
|
+
const fill = fillOf(rec.data);
|
|
80
|
+
return colorContrast(typeof fill === "string" ? fill : "rgb(255, 255, 255)", viz.schema.colorDefaults);
|
|
81
|
+
},
|
|
82
|
+
fontMax: options.fontMax ?? 24,
|
|
83
|
+
fontResize: true,
|
|
84
|
+
padding: 2,
|
|
85
|
+
textAnchor: "middle",
|
|
86
|
+
verticalAlign: "middle",
|
|
87
|
+
...userLabelConfig(viz, "Path")
|
|
88
|
+
}
|
|
89
|
+
});
|
|
90
|
+
// A label cut short (ending in an ellipsis) doesn't fit: drop it.
|
|
91
|
+
const cut = new Set();
|
|
92
|
+
for (const node of nodes)if (node.type === "text") {
|
|
93
|
+
const row = node.datum?.data;
|
|
94
|
+
if (row && !wholeLabel(node.lines.map((l)=>l.text), text(row))) cut.add(String(node.key));
|
|
95
|
+
}
|
|
96
|
+
return nodes.filter((node)=>!cut.has(String(node.key).replace(/::hit$/, "")));
|
|
97
|
+
}
|
|
98
|
+
/** The letters and digits of a label, the only characters wrapping keeps. */ function letters(text) {
|
|
99
|
+
return text.replace(/[^\p{L}\p{N}]/gu, "");
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
Whether wrapped `lines` show all of `label`: every letter and digit, in
|
|
103
|
+
order, so a word hyphenated across lines counts and one cut short with
|
|
104
|
+
an ellipsis doesn't.
|
|
105
|
+
@param lines The text of each wrapped line.
|
|
106
|
+
@param label The label's text.
|
|
107
|
+
*/ export function wholeLabel(lines, label) {
|
|
108
|
+
return letters(lines.join("")) === letters(String(label ?? ""));
|
|
109
|
+
}
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Lays out a Geomap's `cartogram`: reads each region's value and projected
|
|
3
|
+
home, sizes and places its circle or square (see `cartogram.ts`), or
|
|
4
|
+
distorts the regions themselves (see `cartogramContiguous.ts`), and
|
|
5
|
+
keeps the result for redraws with the same inputs.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ import { polygonArea, polygonCentroid } from "d3-polygon";
|
|
9
|
+
import { pathRings } from "@d3plus/render";
|
|
10
|
+
import { cartogramRadii, circlePathD, squarePathD } from "./cartogram.js";
|
|
11
|
+
import { fitCartogram } from "./cartogramRelax.js";
|
|
12
|
+
import { contiguousCartogram } from "./cartogramContiguous.js";
|
|
13
|
+
/** The share of the regions' own area their cartogram shapes take, before fitting. */ export const CARTOGRAM_FILL = 0.6;
|
|
14
|
+
/**
|
|
15
|
+
The cartogram Geomap draws: `cartogram` when it names a kind Geomap
|
|
16
|
+
draws, else false.
|
|
17
|
+
*/ export function cartogramKind(viz) {
|
|
18
|
+
const kind = viz.schema.cartogram;
|
|
19
|
+
return kind === "dorling" || kind === "demers" || kind === "contiguous" ? kind : false;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
The value that sizes a region: `cartogramSize`, else the `colorScale`
|
|
23
|
+
value, else 1 for every region with data.
|
|
24
|
+
*/ export function cartogramValue(viz, d, i) {
|
|
25
|
+
const size = viz.schema.cartogramSize || viz.schema.colorScale;
|
|
26
|
+
if (typeof size !== "function") return 1;
|
|
27
|
+
const value = size(d, i);
|
|
28
|
+
return value === null || value === undefined || value === "" ? NaN : Number(value);
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
The center of a region's largest ring, read from its projected path
|
|
32
|
+
data: the home its shape is pulled toward, so a country's far-flung
|
|
33
|
+
islands don't drag it out to sea. Null when the path draws nothing.
|
|
34
|
+
@param d The region's projected path data.
|
|
35
|
+
*/ export function regionHome(d) {
|
|
36
|
+
const rings = d ? pathRings(d) : null;
|
|
37
|
+
if (!rings || !rings.length) return null;
|
|
38
|
+
let best = rings[0], max = -1;
|
|
39
|
+
for (const ring of rings){
|
|
40
|
+
const a = Math.abs(polygonArea(ring));
|
|
41
|
+
if (a > max) {
|
|
42
|
+
max = a;
|
|
43
|
+
best = ring;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return max > 0 ? polygonCentroid(best) : best[0];
|
|
47
|
+
}
|
|
48
|
+
/** Each viz's recent layouts, by the inputs they were placed from. */ const layouts = new WeakMap();
|
|
49
|
+
/** The layouts each viz keeps (one per small-multiples panel). */ const KEEP = 12;
|
|
50
|
+
/** A 32-bit FNV-1a hash of `text`, continuing from `hash`. */ export function hashText(text, hash = 0x811c9dc5) {
|
|
51
|
+
let h = hash;
|
|
52
|
+
for(let i = 0; i < text.length; i++){
|
|
53
|
+
h ^= text.charCodeAt(i);
|
|
54
|
+
h = Math.imul(h, 0x01000193);
|
|
55
|
+
}
|
|
56
|
+
return h >>> 0;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
Each region's outline distorted into a contiguous cartogram (see
|
|
60
|
+
`contiguousCartogram`), by region id: every region the projection
|
|
61
|
+
draws, those without data or a positive value keeping the mean density.
|
|
62
|
+
Kept for redraws of the same outlines and values.
|
|
63
|
+
*/ function contiguousShapes(viz, regions, input) {
|
|
64
|
+
const drawn = [];
|
|
65
|
+
let hash = hashText("contiguous");
|
|
66
|
+
regions.forEach((region, i)=>{
|
|
67
|
+
const d = input.pathD(region);
|
|
68
|
+
if (!d) return;
|
|
69
|
+
const value = region.data ? cartogramValue(viz, region.data, i) : NaN;
|
|
70
|
+
drawn.push({
|
|
71
|
+
region,
|
|
72
|
+
d,
|
|
73
|
+
value
|
|
74
|
+
});
|
|
75
|
+
hash = hashText(`${d}|${value};`, hash);
|
|
76
|
+
});
|
|
77
|
+
const key = `contiguous|${drawn.length}|${hash}`;
|
|
78
|
+
let kept = layouts.get(viz);
|
|
79
|
+
if (!kept) layouts.set(viz, kept = new Map());
|
|
80
|
+
let placed = kept.get(key);
|
|
81
|
+
if (!placed) {
|
|
82
|
+
const parsed = drawn.map((r)=>({
|
|
83
|
+
rings: pathRings(r.d) ?? [],
|
|
84
|
+
value: r.value
|
|
85
|
+
}));
|
|
86
|
+
placed = contiguousCartogram(parsed).map((rings)=>{
|
|
87
|
+
let d = "";
|
|
88
|
+
for (const ring of rings)d += `${ring.map(([x, y], k)=>`${k ? "L" : "M"}${x},${y}`).join("")}Z`;
|
|
89
|
+
const [x, y] = regionHome(d) ?? [
|
|
90
|
+
0,
|
|
91
|
+
0
|
|
92
|
+
];
|
|
93
|
+
return {
|
|
94
|
+
d,
|
|
95
|
+
x,
|
|
96
|
+
y,
|
|
97
|
+
r: 0,
|
|
98
|
+
square: false
|
|
99
|
+
};
|
|
100
|
+
});
|
|
101
|
+
kept.set(key, placed);
|
|
102
|
+
if (kept.size > KEEP) kept.delete(kept.keys().next().value);
|
|
103
|
+
}
|
|
104
|
+
const shapes = new Map();
|
|
105
|
+
drawn.forEach((r, i)=>shapes.set(r.region.id, placed[i]));
|
|
106
|
+
return shapes;
|
|
107
|
+
}
|
|
108
|
+
/** Each region's home, by its geometry, for the path it was read from. */ const homes = new WeakMap();
|
|
109
|
+
/** `regionHome` of a region, kept by its geometry while its path is the same. */ function cachedHome(region, d) {
|
|
110
|
+
const geometry = region.feature?.geometry;
|
|
111
|
+
if (!d || !geometry || typeof geometry !== "object") return regionHome(d);
|
|
112
|
+
const hit = homes.get(geometry);
|
|
113
|
+
if (hit && hit.d === d) return hit.home;
|
|
114
|
+
const home = regionHome(d);
|
|
115
|
+
homes.set(geometry, {
|
|
116
|
+
d,
|
|
117
|
+
home
|
|
118
|
+
});
|
|
119
|
+
return home;
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
Each region's cartogram shape, by region id: a circle (Dorling) or
|
|
123
|
+
square (Demers) as large as its value's share of `CARTOGRAM_FILL` of
|
|
124
|
+
the regions' area, placed near its home without overlapping the others.
|
|
125
|
+
Regions without data or without a positive value get none. A contiguous
|
|
126
|
+
cartogram distorts every region the projection draws instead.
|
|
127
|
+
@param viz The Geomap.
|
|
128
|
+
@param regions The regions, joined to their rows.
|
|
129
|
+
@param input How to read each region's path and area, and the box to fit.
|
|
130
|
+
*/ export function geomapCartogram(viz, regions, input) {
|
|
131
|
+
const kind = cartogramKind(viz);
|
|
132
|
+
if (!kind) return null;
|
|
133
|
+
if (kind === "contiguous") return contiguousShapes(viz, regions, input);
|
|
134
|
+
const square = kind === "demers";
|
|
135
|
+
const drawn = [];
|
|
136
|
+
regions.forEach((region, i)=>{
|
|
137
|
+
if (!region.data) return;
|
|
138
|
+
const value = cartogramValue(viz, region.data, i);
|
|
139
|
+
if (!(value > 0)) return;
|
|
140
|
+
const d = input.pathD(region);
|
|
141
|
+
const home = cachedHome(region, d);
|
|
142
|
+
if (!home) return;
|
|
143
|
+
drawn.push({
|
|
144
|
+
region,
|
|
145
|
+
home,
|
|
146
|
+
value,
|
|
147
|
+
area: input.area(region)
|
|
148
|
+
});
|
|
149
|
+
});
|
|
150
|
+
const shapes = new Map();
|
|
151
|
+
if (!drawn.length) return shapes;
|
|
152
|
+
const area = drawn.reduce((sum, r)=>sum + (r.area > 0 ? r.area : 0), 0);
|
|
153
|
+
const total = viz.ctx.cartogramTotal;
|
|
154
|
+
const radii = cartogramRadii(drawn.map((r)=>r.value), area * CARTOGRAM_FILL, square, total);
|
|
155
|
+
const nodes = drawn.map((r, i)=>({
|
|
156
|
+
x: r.home[0],
|
|
157
|
+
y: r.home[1],
|
|
158
|
+
r: radii[i]
|
|
159
|
+
}));
|
|
160
|
+
const padding = Math.max(0, Number(viz.schema.cartogramPadding) || 0);
|
|
161
|
+
const key = [
|
|
162
|
+
kind,
|
|
163
|
+
padding,
|
|
164
|
+
input.bounds.join(","),
|
|
165
|
+
nodes.map((n)=>`${n.x},${n.y},${n.r}`).join(";")
|
|
166
|
+
].join("|");
|
|
167
|
+
let kept = layouts.get(viz);
|
|
168
|
+
if (!kept) layouts.set(viz, kept = new Map());
|
|
169
|
+
let placed = kept.get(key);
|
|
170
|
+
if (!placed) {
|
|
171
|
+
placed = fitCartogram(nodes, input.bounds, {
|
|
172
|
+
square,
|
|
173
|
+
padding
|
|
174
|
+
}).map((p)=>({
|
|
175
|
+
d: square ? squarePathD(p.x, p.y, p.r) : circlePathD(p.x, p.y, p.r),
|
|
176
|
+
x: p.x,
|
|
177
|
+
y: p.y,
|
|
178
|
+
r: p.r,
|
|
179
|
+
square
|
|
180
|
+
}));
|
|
181
|
+
kept.set(key, placed);
|
|
182
|
+
if (kept.size > KEEP) kept.delete(kept.keys().next().value);
|
|
183
|
+
}
|
|
184
|
+
drawn.forEach((r, i)=>shapes.set(r.region.id, placed[i]));
|
|
185
|
+
return shapes;
|
|
186
|
+
}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The size legend of a Dorling or Demers cartogram: nested circles or
|
|
3
|
+
squares as large as the shapes drawn for a few values of
|
|
4
|
+
`cartogramSize`, in the chart's bottom-right corner.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/ import { max, min } from "d3-array";
|
|
8
|
+
import { scaleSqrt } from "d3-scale";
|
|
9
|
+
import { fieldNameOf } from "../../utils/fieldAccessor.js";
|
|
10
|
+
import { CARTOGRAM_FILL, cartogramKind, cartogramValue } from "./cartogramLayout.js";
|
|
11
|
+
/**
|
|
12
|
+
The share of the chart area a cartogram's regions are guessed to cover
|
|
13
|
+
before the map is laid out, to size the legend's room.
|
|
14
|
+
*/ const REGION_SHARE = 0.4;
|
|
15
|
+
/**
|
|
16
|
+
A scale from value to radius (or half a square's side) that draws
|
|
17
|
+
`value` at `c·√value`: the shapes' own sizing, over `[lo, hi]`.
|
|
18
|
+
*/ export function cartogramScale(c, lo, hi) {
|
|
19
|
+
return scaleSqrt().domain([
|
|
20
|
+
lo,
|
|
21
|
+
hi
|
|
22
|
+
]).range([
|
|
23
|
+
c * Math.sqrt(lo),
|
|
24
|
+
c * Math.sqrt(hi)
|
|
25
|
+
]);
|
|
26
|
+
}
|
|
27
|
+
/** The positive values a cartogram sizes, read from the rows. */ function sizedValues(viz, rows) {
|
|
28
|
+
return rows.map((d, i)=>cartogramValue(viz, d, i)).filter((v)=>Number.isFinite(v) && v > 0);
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
Points the size legend at the cartogram: its marks (squares for
|
|
32
|
+
Demers) and its title (the `cartogramSize` key, else the `colorScale`
|
|
33
|
+
key). Returns whether the chart draws a Dorling or Demers cartogram.
|
|
34
|
+
*/ export function setCartogramLegend(viz) {
|
|
35
|
+
const kind = cartogramKind(viz);
|
|
36
|
+
const sized = kind === "dorling" || kind === "demers";
|
|
37
|
+
viz._sizeLegendShape = kind === "demers" ? "square" : "circle";
|
|
38
|
+
viz._sizeKey = sized ? fieldNameOf(viz.schema.cartogramSize || viz.schema.colorScale) : undefined;
|
|
39
|
+
return sized;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
The legend's scale before the map is laid out, for the room it takes:
|
|
43
|
+
the shapes sized as if the regions covered `REGION_SHARE` of `available`.
|
|
44
|
+
Null when the shapes don't differ in size.
|
|
45
|
+
*/ export function estimateCartogramScale(viz, available) {
|
|
46
|
+
const values = sizedValues(viz, viz._filteredData ?? []);
|
|
47
|
+
const lo = min(values), hi = max(values);
|
|
48
|
+
if (lo === undefined || hi === undefined || lo === hi) return null;
|
|
49
|
+
const total = viz.ctx.cartogramTotal ?? values.reduce((a, b)=>a + b, 0);
|
|
50
|
+
const area = available.width * available.height * REGION_SHARE * CARTOGRAM_FILL;
|
|
51
|
+
const square = cartogramKind(viz) === "demers";
|
|
52
|
+
const c = Math.sqrt(area / total / (square ? 4 : Math.PI));
|
|
53
|
+
return cartogramScale(c, lo, hi);
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
The legend's scale for the shapes as drawn: each shape's size over the
|
|
57
|
+
root of its value is the same for all of them (they shrink together).
|
|
58
|
+
Null when there are no shapes, or they don't differ in size.
|
|
59
|
+
*/ export function drawnCartogramScale(viz, regions, shapes) {
|
|
60
|
+
let c = 0, lo = Infinity, hi = -Infinity;
|
|
61
|
+
regions.forEach((region, i)=>{
|
|
62
|
+
const shape = shapes.get(region.id);
|
|
63
|
+
if (!shape || !region.data || !(shape.r > 0)) return;
|
|
64
|
+
const v = cartogramValue(viz, region.data, i);
|
|
65
|
+
if (!(v > 0)) return;
|
|
66
|
+
if (v > hi) {
|
|
67
|
+
hi = v;
|
|
68
|
+
c = shape.r / Math.sqrt(v);
|
|
69
|
+
}
|
|
70
|
+
lo = Math.min(lo, v);
|
|
71
|
+
});
|
|
72
|
+
return c > 0 && hi > lo ? cartogramScale(c, lo, hi) : null;
|
|
73
|
+
}
|
|
@@ -0,0 +1,251 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Places Dorling and Demers cartogram shapes: each set at its region's
|
|
3
|
+
home and nudged apart until none overlap, with a pull back toward home.
|
|
4
|
+
The layout is deterministic: the same homes and sizes always land in
|
|
5
|
+
the same spots.
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ /** The golden angle, which spreads coincident shapes evenly around their home. */ const GOLDEN = Math.PI * (3 - Math.sqrt(5));
|
|
9
|
+
/** The overlap, in pixels, left between two shapes once they count as apart. */ const TOLERANCE = 0.05;
|
|
10
|
+
/** How much each shape shrinks when a fitted cartogram is too crowded to part. */ const SHRINK = 0.95;
|
|
11
|
+
/** The passes that pull shapes home, by default. */ const DEFAULT_ITERATIONS = 120;
|
|
12
|
+
/**
|
|
13
|
+
Shapes sorted into size levels, each level's radii at most double the
|
|
14
|
+
level below's, and binned by center into a grid whose cells are as wide
|
|
15
|
+
as the level's largest shape: a shape's overlaps at a level all sit in
|
|
16
|
+
the cells within its reach, so the search stays near-linear however
|
|
17
|
+
much the sizes differ.
|
|
18
|
+
*/ class LevelGrid {
|
|
19
|
+
levels = [];
|
|
20
|
+
/** Each shape's level. */ levelOf;
|
|
21
|
+
x0 = 0;
|
|
22
|
+
y0 = 0;
|
|
23
|
+
constructor(rs){
|
|
24
|
+
const n = rs.length;
|
|
25
|
+
this.levelOf = new Int32Array(n);
|
|
26
|
+
const sorted = Array.from(rs).sort((a, b)=>a - b);
|
|
27
|
+
const base = Math.max(sorted[n >> 1] ?? 0, 1e-3);
|
|
28
|
+
let top = 0;
|
|
29
|
+
for(let i = 0; i < n; i++){
|
|
30
|
+
const level = rs[i] > base ? Math.ceil(Math.log2(rs[i] / base) - 1e-9) : 0;
|
|
31
|
+
this.levelOf[i] = level;
|
|
32
|
+
top = Math.max(top, level);
|
|
33
|
+
}
|
|
34
|
+
const counts = new Array(top + 1).fill(0);
|
|
35
|
+
for(let i = 0; i < n; i++)counts[this.levelOf[i]]++;
|
|
36
|
+
const filled = counts.map(()=>0);
|
|
37
|
+
const members = counts.map((c)=>new Int32Array(c));
|
|
38
|
+
for(let i = 0; i < n; i++){
|
|
39
|
+
const level = this.levelOf[i];
|
|
40
|
+
members[level][filled[level]++] = i;
|
|
41
|
+
}
|
|
42
|
+
this.levels = members.map((shapes, level)=>({
|
|
43
|
+
max: base * 2 ** level,
|
|
44
|
+
shapes,
|
|
45
|
+
size: 1,
|
|
46
|
+
nx: 1,
|
|
47
|
+
ny: 1,
|
|
48
|
+
start: new Int32Array(2),
|
|
49
|
+
items: new Int32Array(shapes.length)
|
|
50
|
+
}));
|
|
51
|
+
}
|
|
52
|
+
/** Bins every level's shapes by the current centers. */ fill(xs, ys, padding) {
|
|
53
|
+
let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;
|
|
54
|
+
for(let i = 0; i < xs.length; i++){
|
|
55
|
+
if (xs[i] < x0) x0 = xs[i];
|
|
56
|
+
if (xs[i] > x1) x1 = xs[i];
|
|
57
|
+
if (ys[i] < y0) y0 = ys[i];
|
|
58
|
+
if (ys[i] > y1) y1 = ys[i];
|
|
59
|
+
}
|
|
60
|
+
this.x0 = x0;
|
|
61
|
+
this.y0 = y0;
|
|
62
|
+
for (const level of this.levels){
|
|
63
|
+
const m = level.shapes.length;
|
|
64
|
+
let size = 2 * level.max + padding;
|
|
65
|
+
// A few cells per shape at most.
|
|
66
|
+
while(((x1 - x0) / size + 1) * ((y1 - y0) / size + 1) > 4 * m + 16)size *= 2;
|
|
67
|
+
level.size = size;
|
|
68
|
+
level.nx = Math.floor((x1 - x0) / size) + 1;
|
|
69
|
+
level.ny = Math.floor((y1 - y0) / size) + 1;
|
|
70
|
+
const cells = level.nx * level.ny;
|
|
71
|
+
if (level.start.length !== cells + 1) level.start = new Int32Array(cells + 1);
|
|
72
|
+
else level.start.fill(0);
|
|
73
|
+
const cellOf = new Int32Array(m);
|
|
74
|
+
for(let k = 0; k < m; k++){
|
|
75
|
+
const i = level.shapes[k];
|
|
76
|
+
const c = Math.floor((xs[i] - x0) / size) * level.ny + Math.floor((ys[i] - y0) / size);
|
|
77
|
+
cellOf[k] = c;
|
|
78
|
+
level.start[c + 1]++;
|
|
79
|
+
}
|
|
80
|
+
for(let c = 0; c < cells; c++)level.start[c + 1] += level.start[c];
|
|
81
|
+
const next = level.start.slice(0, cells);
|
|
82
|
+
for(let k = 0; k < m; k++)level.items[next[cellOf[k]]++] = level.shapes[k];
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
Pushes shapes `i` and `j` apart along the line between their centers
|
|
88
|
+
when they overlap, the smaller one moving more; returns the overlap.
|
|
89
|
+
Circles part until their centers are as far apart as their radii (plus
|
|
90
|
+
`padding`); squares until the larger of the two offsets is as long as
|
|
91
|
+
their half sides, which spreads a crowd of squares out in every
|
|
92
|
+
direction rather than only along the axes.
|
|
93
|
+
*/ function resolve(i, j, xs, ys, rs, square, padding) {
|
|
94
|
+
const reach = rs[i] + rs[j] + padding;
|
|
95
|
+
const ox = xs[j] - xs[i], oy = ys[j] - ys[i];
|
|
96
|
+
const ax = Math.abs(ox), ay = Math.abs(oy);
|
|
97
|
+
if (ax >= reach || ay >= reach) return 0;
|
|
98
|
+
const dist = Math.hypot(ox, oy);
|
|
99
|
+
if (!square && dist >= reach) return 0;
|
|
100
|
+
let ux, uy;
|
|
101
|
+
if (dist) {
|
|
102
|
+
ux = ox / dist;
|
|
103
|
+
uy = oy / dist;
|
|
104
|
+
} else {
|
|
105
|
+
// Shapes sharing a home part along an angle set by their indices.
|
|
106
|
+
const angle = (i + j) * GOLDEN;
|
|
107
|
+
ux = Math.cos(angle);
|
|
108
|
+
uy = Math.sin(angle);
|
|
109
|
+
}
|
|
110
|
+
const overlap = square ? reach - Math.max(ax, ay) : reach - dist;
|
|
111
|
+
const move = square ? overlap / Math.max(Math.abs(ux), Math.abs(uy)) : overlap;
|
|
112
|
+
const wi = rs[i] + rs[j] ? rs[j] / (rs[i] + rs[j]) : 0.5, wj = 1 - wi;
|
|
113
|
+
xs[i] -= ux * move * wi;
|
|
114
|
+
ys[i] -= uy * move * wi;
|
|
115
|
+
xs[j] += ux * move * wj;
|
|
116
|
+
ys[j] += uy * move * wj;
|
|
117
|
+
return overlap;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
One pass pushing every overlapping pair apart, each pair met once: from
|
|
121
|
+
the shape at the higher level, or from the lower index at the same
|
|
122
|
+
level. Returns the largest overlap the pass found.
|
|
123
|
+
*/ function separate(xs, ys, rs, grid, square, padding) {
|
|
124
|
+
grid.fill(xs, ys, padding);
|
|
125
|
+
const { levels, x0, y0 } = grid;
|
|
126
|
+
let worst = 0;
|
|
127
|
+
for(let li = 0; li < levels.length; li++){
|
|
128
|
+
const shapes = levels[li].shapes;
|
|
129
|
+
for(let k = 0; k < shapes.length; k++){
|
|
130
|
+
const i = shapes[k];
|
|
131
|
+
for(let lj = 0; lj <= li; lj++){
|
|
132
|
+
const { max, size, nx, ny, start, items } = levels[lj];
|
|
133
|
+
const reach = rs[i] + max + padding;
|
|
134
|
+
const gx0 = Math.max(0, Math.floor((xs[i] - reach - x0) / size)), gx1 = Math.min(nx - 1, Math.floor((xs[i] + reach - x0) / size)), gy0 = Math.max(0, Math.floor((ys[i] - reach - y0) / size)), gy1 = Math.min(ny - 1, Math.floor((ys[i] + reach - y0) / size));
|
|
135
|
+
for(let gx = gx0; gx <= gx1; gx++)for(let gy = gy0; gy <= gy1; gy++){
|
|
136
|
+
const cell = gx * ny + gy;
|
|
137
|
+
for(let m = start[cell]; m < start[cell + 1]; m++){
|
|
138
|
+
const j = items[m];
|
|
139
|
+
if (lj === li && j <= i) continue;
|
|
140
|
+
const r = rs[i] + rs[j] + padding;
|
|
141
|
+
if (Math.abs(xs[j] - xs[i]) >= r || Math.abs(ys[j] - ys[i]) >= r) continue;
|
|
142
|
+
const overlap = resolve(i, j, xs, ys, rs, square, padding);
|
|
143
|
+
if (overlap > worst) worst = overlap;
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
return worst;
|
|
150
|
+
}
|
|
151
|
+
/** Moves every shape inside `bounds`, centering one too large to fit. */ function contain(xs, ys, rs, bounds) {
|
|
152
|
+
const [x0, y0, x1, y1] = bounds;
|
|
153
|
+
for(let i = 0; i < xs.length; i++){
|
|
154
|
+
const r = rs[i];
|
|
155
|
+
xs[i] = x1 - x0 < 2 * r ? (x0 + x1) / 2 : Math.min(x1 - r, Math.max(x0 + r, xs[i]));
|
|
156
|
+
ys[i] = y1 - y0 < 2 * r ? (y0 + y1) / 2 : Math.min(y1 - r, Math.max(y0 + r, ys[i]));
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
Runs the passes of `relaxCartogram` over shapes already at `xs`/`ys`:
|
|
161
|
+
`iterations` passes pulling every shape toward home, with a pull that
|
|
162
|
+
fades, while overlapping pairs are pushed apart (and, given `bounds`,
|
|
163
|
+
kept inside them); then up to half as many pushing alone, until no two
|
|
164
|
+
overlap. Returns the largest overlap the last pass found.
|
|
165
|
+
*/ function relaxFrom(nodes, xs, ys, rs, options, bounds) {
|
|
166
|
+
const { square, padding, iterations } = options;
|
|
167
|
+
const n = nodes.length;
|
|
168
|
+
const grid = new LevelGrid(rs);
|
|
169
|
+
for(let k = 0; k < iterations; k++){
|
|
170
|
+
const pull = 0.1 * (1 - k / iterations);
|
|
171
|
+
for(let i = 0; i < n; i++){
|
|
172
|
+
xs[i] += (nodes[i].x - xs[i]) * pull;
|
|
173
|
+
ys[i] += (nodes[i].y - ys[i]) * pull;
|
|
174
|
+
}
|
|
175
|
+
separate(xs, ys, rs, grid, square, padding);
|
|
176
|
+
if (bounds) contain(xs, ys, rs, bounds);
|
|
177
|
+
}
|
|
178
|
+
// Shapes closer than `padding` by less than half of it still don't touch.
|
|
179
|
+
const done = TOLERANCE + padding / 2;
|
|
180
|
+
let worst = 0;
|
|
181
|
+
for(let k = 0; k < Math.ceil(iterations / 2); k++){
|
|
182
|
+
worst = separate(xs, ys, rs, grid, square, padding);
|
|
183
|
+
if (bounds) contain(xs, ys, rs, bounds);
|
|
184
|
+
if (worst <= done) break;
|
|
185
|
+
}
|
|
186
|
+
return worst;
|
|
187
|
+
}
|
|
188
|
+
/** The arrays `relaxFrom` works on, from each node's home and size. */ function nodeArrays(nodes) {
|
|
189
|
+
const n = nodes.length;
|
|
190
|
+
const xs = new Float64Array(n), ys = new Float64Array(n), rs = new Float64Array(n);
|
|
191
|
+
nodes.forEach((d, i)=>{
|
|
192
|
+
xs[i] = d.x;
|
|
193
|
+
ys[i] = d.y;
|
|
194
|
+
rs[i] = Math.max(0, d.r);
|
|
195
|
+
});
|
|
196
|
+
return {
|
|
197
|
+
xs,
|
|
198
|
+
ys,
|
|
199
|
+
rs
|
|
200
|
+
};
|
|
201
|
+
}
|
|
202
|
+
/** Each shape's placement, from the arrays `relaxFrom` worked on. */ function placements(xs, ys, rs) {
|
|
203
|
+
return Array.from(xs, (x, i)=>({
|
|
204
|
+
x,
|
|
205
|
+
y: ys[i],
|
|
206
|
+
r: rs[i]
|
|
207
|
+
}));
|
|
208
|
+
}
|
|
209
|
+
/**
|
|
210
|
+
Places each shape as near its home as it can without overlapping
|
|
211
|
+
another: passes pull every shape toward home, with a pull that fades,
|
|
212
|
+
while overlapping pairs are pushed apart; then pushing alone runs until
|
|
213
|
+
no two overlap (or a pass limit is reached). The same nodes always land
|
|
214
|
+
in the same places.
|
|
215
|
+
@param nodes Each shape's home and size.
|
|
216
|
+
@param options Circles or squares, the gap between them, and the passes.
|
|
217
|
+
*/ export function relaxCartogram(nodes, options = {}) {
|
|
218
|
+
const { xs, ys, rs } = nodeArrays(nodes);
|
|
219
|
+
relaxFrom(nodes, xs, ys, rs, relaxOptions(options));
|
|
220
|
+
return placements(xs, ys, rs);
|
|
221
|
+
}
|
|
222
|
+
/** `options` with their defaults. */ function relaxOptions(options) {
|
|
223
|
+
return {
|
|
224
|
+
square: options.square ?? false,
|
|
225
|
+
padding: options.padding ?? 0,
|
|
226
|
+
iterations: options.iterations ?? DEFAULT_ITERATIONS
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
`relaxCartogram` inside `bounds`: shapes pushed against an edge stay
|
|
231
|
+
inside it. While they still overlap (a crowd too large for the space
|
|
232
|
+
around it), every shape shrinks a little and they relax again from
|
|
233
|
+
where they stand, three times at most.
|
|
234
|
+
@param nodes Each shape's home and size.
|
|
235
|
+
@param bounds The box the shapes must fit, `[x0, y0, x1, y1]`.
|
|
236
|
+
@param options As for `relaxCartogram`.
|
|
237
|
+
*/ export function fitCartogram(nodes, bounds, options = {}) {
|
|
238
|
+
const settings = relaxOptions(options);
|
|
239
|
+
const { xs, ys, rs } = nodeArrays(nodes);
|
|
240
|
+
contain(xs, ys, rs, bounds);
|
|
241
|
+
let worst = relaxFrom(nodes, xs, ys, rs, settings, bounds);
|
|
242
|
+
const again = {
|
|
243
|
+
...settings,
|
|
244
|
+
iterations: Math.ceil(settings.iterations / 3)
|
|
245
|
+
};
|
|
246
|
+
for(let round = 0; round < 3 && worst > settings.padding; round++){
|
|
247
|
+
for(let i = 0; i < rs.length; i++)rs[i] *= SHRINK;
|
|
248
|
+
worst = relaxFrom(nodes, xs, ys, rs, again, bounds);
|
|
249
|
+
}
|
|
250
|
+
return placements(xs, ys, rs);
|
|
251
|
+
}
|