@d3plus/core 4.12.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 +155 -21
- package/es/src/charts/Alluvial/emit.js +3 -2
- 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 +56 -27
- package/es/src/charts/ArcDiagram/events.js +10 -6
- package/es/src/charts/ArcDiagram/index.js +1 -1
- package/es/src/charts/BarChart/index.js +11 -0
- 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 +14 -1
- package/es/src/charts/Candlestick/index.js +2 -1
- 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 +31 -9
- 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 +27 -11
- 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 +2 -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/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 +10 -4
- 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 +45 -4
- package/es/src/charts/Network/applyLayout.js +173 -82
- package/es/src/charts/Network/bundle.js +26 -6
- 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 +78 -18
- package/es/src/charts/Network/forceLayout.js +111 -0
- package/es/src/charts/Network/graph.js +45 -6
- package/es/src/charts/Network/index.js +111 -2
- 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/emit.js +3 -2
- package/es/src/charts/Pack/index.js +0 -14
- package/es/src/charts/ParallelCoordinates/emit.js +3 -2
- 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 +3 -2
- package/es/src/charts/Plot/areaEnter.js +5 -3
- 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 +15 -2
- 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 +49 -18
- 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/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 +59 -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/sharedHover.js +40 -12
- package/es/src/charts/Plot/sharedHoverScene.js +49 -13
- package/es/src/charts/Plot/sharedTooltip.js +55 -22
- 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/Priestley/applyLayout.js +9 -5
- package/es/src/charts/Priestley/emit.js +3 -2
- package/es/src/charts/Priestley/timeAxis.js +13 -5
- package/es/src/charts/Radar/emit.js +3 -2
- package/es/src/charts/RadialArea/index.js +51 -0
- package/es/src/charts/RadialBar/emit.js +3 -2
- 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/emit.js +3 -2
- package/es/src/charts/RadialTree/index.js +33 -0
- package/es/src/charts/Rings/applyLayout.js +22 -6
- package/es/src/charts/Rings/emit.js +43 -23
- package/es/src/charts/Rings/index.js +1 -1
- package/es/src/charts/Rings/ringsCurves.js +10 -8
- package/es/src/charts/Rings/ringsLoops.js +4 -2
- package/es/src/charts/Rings/ringsSizing.js +21 -13
- package/es/src/charts/Sankey/applyLayout.js +4 -0
- 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 +43 -0
- 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 +3 -2
- package/es/src/charts/TileGridMap/index.js +29 -0
- package/es/src/charts/Tree/applyLayout.js +91 -18
- package/es/src/charts/Tree/emit.js +56 -3
- package/es/src/charts/Tree/index.js +24 -3
- package/es/src/charts/Tree/nodeHeight.js +58 -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/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 +10 -2
- 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 +1 -1
- 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/zoomControls.js +59 -19
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +212 -39
- package/es/src/charts/drawSteps/zoomControlsMenu.js +140 -0
- package/es/src/charts/drawSteps/zoomDrag.js +3 -1
- package/es/src/charts/events/mouseleave.js +6 -3
- package/es/src/charts/events/mousemove.legend.js +10 -5
- package/es/src/charts/events/mousemove.shape.js +15 -6
- 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 +4 -2
- package/es/src/charts/features/axesFinal.js +92 -8
- package/es/src/charts/features/axesMeasure.js +7 -4
- 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 +36 -17
- package/es/src/charts/features/circleLabelPlacement.js +288 -83
- package/es/src/charts/features/circleLabels.js +66 -14
- package/es/src/charts/features/colorScaleHover.js +7 -2
- package/es/src/charts/features/colorScaleTooltip.js +6 -21
- package/es/src/charts/features/colorScaleTop.js +12 -2
- package/es/src/charts/features/colorScaleValue.js +10 -1
- package/es/src/charts/features/curvedArrows.js +46 -28
- package/es/src/charts/features/edgeArrows.js +48 -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 +7 -4
- package/es/src/charts/features/featuresLegend.js +20 -0
- package/es/src/charts/features/hoverTicks.js +12 -7
- 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 +4 -1
- package/es/src/charts/features/linkLabelPath.js +2 -39
- 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/pathLabelBends.js +191 -0
- package/es/src/charts/features/plotAnnotations.js +8 -5
- package/es/src/charts/features/plotPaint.js +45 -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 +104 -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/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/interaction.js +2 -2
- package/es/src/charts/pipeline/insetPlacement.js +13 -6
- 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/viz/Viz.js +32 -18
- package/es/src/charts/viz/VizBase.js +39 -38
- package/es/src/charts/viz/appendRows.js +90 -0
- package/es/src/charts/viz/dataChanged.js +19 -0
- package/es/src/charts/viz/discrete.js +9 -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 +134 -29
- 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/setCursor.js +12 -0
- package/es/src/charts/viz/simpleHover.js +3 -4
- package/es/src/charts/viz/userClick.js +11 -0
- package/es/src/charts/viz/vizDefaults.js +10 -0
- package/es/src/charts/viz/vizFields.js +7 -0
- package/es/src/charts/viz/vizTypes.js +1 -1
- package/es/src/components/Axis/Axis.js +85 -12
- 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/axisDefaults.js +7 -0
- package/es/src/components/Axis/axisEndLabels.js +4 -1
- package/es/src/components/Axis/axisLabelSize.js +40 -16
- package/es/src/components/Axis/axisLabelThinning.js +69 -6
- package/es/src/components/Axis/axisLayout.js +5 -0
- package/es/src/components/Axis/axisLayoutLabels.js +11 -5
- package/es/src/components/Axis/axisLayoutScale.js +71 -25
- package/es/src/components/Axis/axisLevels.js +271 -0
- package/es/src/components/Axis/axisLimit.js +6 -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 +71 -29
- package/es/src/components/Axis/axisRounding.js +24 -2
- package/es/src/components/Axis/axisScaleType.js +55 -0
- package/es/src/components/Axis/axisScene.js +90 -5
- package/es/src/components/Axis/axisTickLookups.js +30 -0
- package/es/src/components/Axis/axisTooltipTargets.js +23 -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 +1 -0
- package/es/src/components/ColorScale/colorScaleScale.js +139 -41
- package/es/src/components/Legend/Legend.js +1 -0
- package/es/src/components/SizeLegend/SizeLegend.js +20 -1
- package/es/src/components/TextBox.js +1 -0
- package/es/src/components/Timeline/Timeline.js +11 -3
- package/es/src/components/Timeline/timelineRender.js +23 -13
- package/es/src/components/Tooltip.js +8 -1
- package/es/src/components/tooltipDom.js +73 -14
- package/es/src/fluent.js +77 -10
- 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 -57
- 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 +253 -27
- 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 +5 -4
- 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 +5 -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 +2 -1
- 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 +24 -0
- package/types/src/charts/Network/bundle.d.ts +23 -16
- 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 +18 -2
- 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/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/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 +17 -8
- 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/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/sharedHover.d.ts +5 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +24 -6
- 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 +6 -3
- 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/RadialTree/index.d.ts +16 -0
- package/types/src/charts/Rings/emit.d.ts +6 -5
- package/types/src/charts/Rings/ringsCurves.d.ts +10 -14
- package/types/src/charts/Rings/ringsGraph.d.ts +3 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +5 -2
- 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/index.d.ts +2 -2
- package/types/src/charts/Tree/nodeHeight.d.ts +41 -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 +13 -0
- package/types/src/charts/definition/declaresField.d.ts +9 -0
- package/types/src/charts/definition/makeChart.d.ts +2 -2
- 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/zoomControls.d.ts +17 -7
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +94 -21
- package/types/src/charts/drawSteps/zoomControlsMenu.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomDrag.d.ts +2 -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/bareRegion.d.ts +18 -0
- package/types/src/charts/features/boxGrid.d.ts +28 -0
- package/types/src/charts/features/centerLabel.d.ts +16 -2
- 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/colorScaleHover.d.ts +3 -2
- package/types/src/charts/features/colorScaleTooltip.d.ts +4 -9
- package/types/src/charts/features/colorScaleValue.d.ts +6 -0
- package/types/src/charts/features/curvedArrows.d.ts +28 -12
- package/types/src/charts/features/edgeArrows.d.ts +40 -30
- 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 +5 -2
- 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/linkLabelPath.d.ts +0 -7
- 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/pathLabelBends.d.ts +78 -0
- package/types/src/charts/features/plotAnnotations.d.ts +2 -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/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/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/viz/VizBase.d.ts +32 -1
- package/types/src/charts/viz/appendRows.d.ts +49 -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/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/setCursor.d.ts +12 -0
- package/types/src/charts/viz/simpleHover.d.ts +3 -3
- package/types/src/charts/viz/userClick.d.ts +8 -0
- package/types/src/charts/viz/vizFields.d.ts +7 -0
- package/types/src/charts/viz/vizTypes.d.ts +116 -2
- package/types/src/components/Axis/Axis.d.ts +35 -0
- package/types/src/components/Axis/axisDefaults.d.ts +2 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +3 -3
- package/types/src/components/Axis/axisLabelThinning.d.ts +19 -1
- package/types/src/components/Axis/axisLayoutScale.d.ts +14 -2
- package/types/src/components/Axis/axisLevels.d.ts +137 -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 +15 -1
- 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/axisTooltipTargets.d.ts +16 -4
- 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/colorScaleScale.d.ts +45 -0
- package/types/src/components/Tooltip.d.ts +11 -2
- package/types/src/components/tooltipDom.d.ts +24 -0
- package/types/src/fluent.d.ts +30 -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/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 +991 -85
- 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/umd/d3plus-core.full.js +98950 -68731
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +77484 -48545
- package/umd/d3plus-core.min.js +2 -2
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
to its node record.
|
|
6
6
|
*/ import { min } from "d3-array";
|
|
7
7
|
import { zoomTransform } from "d3-zoom";
|
|
8
|
+
import { computeTimeFilter, timelessPass } from "../pipeline/preDrawData.js";
|
|
8
9
|
import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
|
|
9
10
|
/** A node record as a link end. */ export const graphLinkEnd = (n)=>({
|
|
10
11
|
data: n.data,
|
|
@@ -17,20 +18,54 @@ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
|
|
|
17
18
|
viz.schema.nodeGroupBy.length - 1
|
|
18
19
|
])](d, i)}`;
|
|
19
20
|
}
|
|
21
|
+
/**
|
|
22
|
+
Whether a `nodes` or `links` row is in the period the timeline selects
|
|
23
|
+
(the chart's `timeFilter`, or the one it starts on): a row with no
|
|
24
|
+
`time` value is in every period. Undefined without `time`.
|
|
25
|
+
*/ export function graphPeriod(v) {
|
|
26
|
+
if (!v.schema.time) return undefined;
|
|
27
|
+
const filter = v.schema.timeFilter || computeTimeFilter(v);
|
|
28
|
+
return filter ? timelessPass(v, filter) : undefined;
|
|
29
|
+
}
|
|
30
|
+
/** The `links` in the selected period (see `graphPeriod`), each with its index in `links`. */ function periodLinks(v) {
|
|
31
|
+
const links = v.schema.links.map((link, i)=>({
|
|
32
|
+
link,
|
|
33
|
+
i
|
|
34
|
+
}));
|
|
35
|
+
const period = graphPeriod(v);
|
|
36
|
+
return period ? links.filter(({ link, i })=>period(link, i)) : links;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
The ids of a small-multiple panel's own rows (see `facet`), or
|
|
40
|
+
undefined outside a panel: a panel draws only the nodes its rows stand
|
|
41
|
+
for, so `nodes` and `links` shared by every panel don't pull in the
|
|
42
|
+
other panels' nodes.
|
|
43
|
+
*/ export function panelNodeIds(v) {
|
|
44
|
+
if (v._facetStep !== "panel") return undefined;
|
|
45
|
+
const data = v._filteredData ?? [];
|
|
46
|
+
return new Set(data.map((d, i)=>graphNodeId(v, d, i)));
|
|
47
|
+
}
|
|
20
48
|
/**
|
|
21
49
|
The chart's node rows: `nodes` when set, else one row per data row and
|
|
22
50
|
one per link end no data row stands for (the link's own object, or
|
|
23
51
|
`{id}` for an id), so a chart given only `data` and `links` still draws
|
|
24
|
-
its nodes, linked or not.
|
|
52
|
+
its nodes, linked or not. A small-multiple panel keeps only the rows
|
|
53
|
+
its own data rows stand for (see `panelNodeIds`).
|
|
25
54
|
*/ export function graphNodeRows(v) {
|
|
26
55
|
const nodes = v.schema.nodes;
|
|
27
|
-
|
|
56
|
+
const period = graphPeriod(v);
|
|
57
|
+
const panel = panelNodeIds(v);
|
|
58
|
+
if (nodes.length) {
|
|
59
|
+
const rows = period ? nodes.filter(period) : nodes;
|
|
60
|
+
return panel ? rows.filter((d, i)=>panel.has(graphNodeId(v, d, i))) : rows;
|
|
61
|
+
}
|
|
28
62
|
const data = v._filteredData;
|
|
29
63
|
const rows = [
|
|
30
64
|
...data
|
|
31
65
|
];
|
|
66
|
+
if (panel) return rows;
|
|
32
67
|
const ids = new Set(data.map((d, i)=>graphNodeId(v, d, i)));
|
|
33
|
-
for (const l of v
|
|
68
|
+
for (const { link: l } of periodLinks(v))for (const end of [
|
|
34
69
|
l.source,
|
|
35
70
|
l.target
|
|
36
71
|
]){
|
|
@@ -87,7 +122,9 @@ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
|
|
|
87
122
|
that matches no node is undefined. A link whose ends both resolve gets its
|
|
88
123
|
datum, which `linkSize` receives (with the link's index). Stashes the id → node lookup on
|
|
89
124
|
`v.ctx.nodeLookup` and the id → neighbor nodes lookup on
|
|
90
|
-
`v.ctx.linkLookup` (a link from a node to itself adds no neighbor).
|
|
125
|
+
`v.ctx.linkLookup` (a link from a node to itself adds no neighbor). A
|
|
126
|
+
link outside the timeline's selected period (see `graphPeriod`) resolves
|
|
127
|
+
neither end.
|
|
91
128
|
*/ export function resolveGraphLinks(v, nodes) {
|
|
92
129
|
const nodeLookup = nodes.reduce((obj, d)=>{
|
|
93
130
|
obj[d.id] = d;
|
|
@@ -97,10 +134,12 @@ import { makeLinkDatum, setLinkValue } from "../features/linkInteraction.js";
|
|
|
97
134
|
const nodeByOriginal = new Map();
|
|
98
135
|
for (const n of nodes)nodeByOriginal.set(n.node, n);
|
|
99
136
|
const endpoint = (ref, referenceType)=>referenceType === "number" ? nodeByOriginal.get(v.schema.nodes[ref]) : referenceType === "string" ? nodeLookup[ref] : nodeLookup[ref.id];
|
|
137
|
+
const shown = new Set(periodLinks(v).map(({ i })=>i));
|
|
100
138
|
const links = v.schema.links.map((l, i)=>{
|
|
101
139
|
const referenceType = typeof l.source;
|
|
102
|
-
|
|
103
|
-
const
|
|
140
|
+
// A link outside the selected period resolves no ends.
|
|
141
|
+
const source = shown.has(i) ? endpoint(l.source, referenceType) : undefined;
|
|
142
|
+
const target = shown.has(i) ? endpoint(l.target, referenceType) : undefined;
|
|
104
143
|
if (!source || !target) return {
|
|
105
144
|
size: v.schema.linkSize(l, i),
|
|
106
145
|
source,
|
|
@@ -28,6 +28,12 @@ import { polylineBox } from "../features/polyline.js";
|
|
|
28
28
|
import { isSelfLoopMark, unionBox } from "../features/selfLoops.js";
|
|
29
29
|
import { loaderFormatFields } from "../viz/loaderFormat.js";
|
|
30
30
|
import { clusterFields, installClusters } from "./clusters.js";
|
|
31
|
+
import { runChartDraw } from "../pipeline/runChartDraw.js";
|
|
32
|
+
import { bindNodeDrag, unbindNodeDrag } from "../features/nodeDrag.js";
|
|
33
|
+
import { FORCE_LIVE_DEFAULT, networkLive, stopLive } from "./liveForce.js";
|
|
34
|
+
import { deferPinnedClicks, networkNodeDrag, nudgeNetworkNode, unpinNetworkNode } from "./networkDrag.js";
|
|
35
|
+
import { installNodeKeys } from "../features/nodeKeys.js";
|
|
36
|
+
/** The node keys' instructions, read after keyboard navigation's own. */ const NETWORK_KEY_INSTRUCTIONS = "Hold Shift and use the arrow keys to move the focused node, and Shift+Backspace to unpin it.";
|
|
31
37
|
const getNodeId = graphNodeId;
|
|
32
38
|
/** The laid-out links, from the last layout. */ const networkLinks = (viz)=>viz.ctx.networkCtx?.links ?? [];
|
|
33
39
|
/**
|
|
@@ -50,6 +56,19 @@ const getNodeId = graphNodeId;
|
|
|
50
56
|
yDomain[1] = Math.max(yDomain[1], y1);
|
|
51
57
|
}
|
|
52
58
|
}
|
|
59
|
+
/** The data, `nodes`, and `links` rows that have a `time` value. */ function networkTimeRows(viz) {
|
|
60
|
+
const time = viz.schema.time;
|
|
61
|
+
if (!time) return viz._data;
|
|
62
|
+
const rows = [
|
|
63
|
+
viz._data,
|
|
64
|
+
viz.schema.nodes,
|
|
65
|
+
viz.schema.links
|
|
66
|
+
].flatMap((r)=>Array.isArray(r) ? r : []);
|
|
67
|
+
return rows.filter((d, i)=>{
|
|
68
|
+
const t = time(d, i);
|
|
69
|
+
return t !== undefined && t !== null && t !== "";
|
|
70
|
+
});
|
|
71
|
+
}
|
|
53
72
|
/** Installs the `click.shape` handler that focuses/zooms a node + its links. */ function setupNetworkClickShape(viz, v) {
|
|
54
73
|
viz.schema.on["click.shape"] = (d, i, x, event)=>{
|
|
55
74
|
viz._tooltipClass.data([]).render();
|
|
@@ -244,6 +263,8 @@ export const networkDef = {
|
|
|
244
263
|
sizeLegendScale: (viz, { width, height })=>networkSizeLegendScale(viz, width, height),
|
|
245
264
|
emit: networkEmit,
|
|
246
265
|
insetRegion: sceneInsetRegion,
|
|
266
|
+
// `nodes` and `links` rows with a `time` value join the data's periods.
|
|
267
|
+
timeRows: networkTimeRows,
|
|
247
268
|
// Network mounts its own zoom surface (with a background hitArea whose
|
|
248
269
|
// click handler closes over class state); `chartTransform` (default
|
|
249
270
|
// margin-origin) is fine for the scene.
|
|
@@ -258,6 +279,25 @@ export const networkDef = {
|
|
|
258
279
|
// Default x/y accessors for nodes (Network reads node coords directly).
|
|
259
280
|
viz._x = accessor("x");
|
|
260
281
|
viz._y = accessor("y");
|
|
282
|
+
// A frame of the live simulation, or a dragged node, re-lays the chart
|
|
283
|
+
// out at the nodes' new positions.
|
|
284
|
+
networkLive(viz).relayout = ()=>runChartDraw(viz, networkDef, applyNetworkLayout);
|
|
285
|
+
const drag = networkNodeDrag(viz);
|
|
286
|
+
deferPinnedClicks(viz);
|
|
287
|
+
const draggable = ()=>viz.schema.nodeDrag !== false && viz.schema.layout !== "circle" && !viz._facetPanels?.length;
|
|
288
|
+
installNodeKeys(viz, {
|
|
289
|
+
nodeAt: (key)=>drag.nodeAt({
|
|
290
|
+
key
|
|
291
|
+
}),
|
|
292
|
+
nudge: (id, by)=>nudgeNetworkNode(viz, id, by),
|
|
293
|
+
reset: (id)=>unpinNetworkNode(viz, id),
|
|
294
|
+
enabled: draggable,
|
|
295
|
+
messages: {
|
|
296
|
+
nudge: "{0} moved and pinned",
|
|
297
|
+
reset: "{0} unpinned"
|
|
298
|
+
},
|
|
299
|
+
instructions: NETWORK_KEY_INSTRUCTIONS
|
|
300
|
+
});
|
|
261
301
|
// Wrap _draw to also call ensureZoomDom (Network needs a DOM zoom group).
|
|
262
302
|
const supDraw = v._draw.bind(viz);
|
|
263
303
|
v._draw = function(callback) {
|
|
@@ -269,8 +309,15 @@ export const networkDef = {
|
|
|
269
309
|
height,
|
|
270
310
|
duration: effectiveDuration(viz)
|
|
271
311
|
});
|
|
312
|
+
bindNodeDrag(viz, drag, draggable);
|
|
272
313
|
return result;
|
|
273
314
|
};
|
|
315
|
+
const supDestroy = v.destroy.bind(viz);
|
|
316
|
+
v.destroy = function() {
|
|
317
|
+
stopLive(viz);
|
|
318
|
+
unbindNodeDrag(viz);
|
|
319
|
+
return supDestroy();
|
|
320
|
+
};
|
|
274
321
|
},
|
|
275
322
|
// Small-multiple panels as close to square as the grid allows.
|
|
276
323
|
facet: {
|
|
@@ -279,6 +326,7 @@ export const networkDef = {
|
|
|
279
326
|
// Nodes (and loops, which sit within reach of their node) are points for
|
|
280
327
|
// `hoverDistance`; links keep exact hit-testing.
|
|
281
328
|
pointMark: (_viz, node)=>isPointShape(node) || isSelfLoopMark(node),
|
|
329
|
+
selectMark: (_viz, node)=>isPointShape(node),
|
|
282
330
|
ctx: {},
|
|
283
331
|
fields: [
|
|
284
332
|
/**
|
|
@@ -295,15 +343,55 @@ export const networkDef = {
|
|
|
295
343
|
The arrowhead size in pixels, or an accessor function returning one
|
|
296
344
|
per link. Defaults to three times the link's stroke width, at least 6
|
|
297
345
|
and at most 12 pixels, but never under 1.5 times the stroke width so
|
|
298
|
-
the head stays wider than its line. The line stops
|
|
346
|
+
the head stays wider than its line. The line stops at the head's base.
|
|
299
347
|
@type {number | function}
|
|
300
348
|
*/ {
|
|
301
349
|
key: "arrowSize"
|
|
302
350
|
},
|
|
303
351
|
...clusterFields(),
|
|
352
|
+
/**
|
|
353
|
+
Keeps the force simulation running after the chart draws, so the
|
|
354
|
+
layout settles in view and the other nodes react while one is
|
|
355
|
+
dragged, when the network has at most this many nodes. `true` runs
|
|
356
|
+
it live at any size, `false` never. Larger networks are laid out
|
|
357
|
+
before they draw. Nodes with an `x` and `y` in the data stay where
|
|
358
|
+
the data puts them, and a viewer who asks for reduced motion (see
|
|
359
|
+
`reducedMotion`) gets the laid-out network without the motion.
|
|
360
|
+
@type {number | boolean}
|
|
361
|
+
*/ {
|
|
362
|
+
key: "forceLive",
|
|
363
|
+
default: FORCE_LIVE_DEFAULT
|
|
364
|
+
},
|
|
304
365
|
...linkStyleFields(),
|
|
305
366
|
...linkBundleFields(),
|
|
306
367
|
...loaderFormatFields("links", "nodes"),
|
|
368
|
+
/**
|
|
369
|
+
How the nodes are placed. `"force"` (the default) places them at
|
|
370
|
+
their `x` and `y`, or by a force simulation when any node has none.
|
|
371
|
+
`"circle"` spaces them evenly around a circle, ordered by cluster
|
|
372
|
+
(or top-level group) and then most connected first (see
|
|
373
|
+
`nodeSort`), with links bowing in toward the center and each label
|
|
374
|
+
turned outward along its node's spoke past the circle. A node's
|
|
375
|
+
loops point outward. With `linkBundle`, the bundled paths replace
|
|
376
|
+
the bowed ones.
|
|
377
|
+
@type {"force" | "circle"}
|
|
378
|
+
*/ {
|
|
379
|
+
key: "layout",
|
|
380
|
+
default: "force"
|
|
381
|
+
},
|
|
382
|
+
/**
|
|
383
|
+
How far links bow in toward the center when `layout` is
|
|
384
|
+
`"circle"`, from `0` (straight lines) to `1` (each link curves
|
|
385
|
+
through the center's pull, as a chord diagram's do). It sets the
|
|
386
|
+
share of the way from the middle of a link's chord to the center
|
|
387
|
+
that its curve's control point sits. Defaults to `0.5`, which keeps
|
|
388
|
+
links between neighbors near the rim and lets long ones cross the
|
|
389
|
+
middle. Bundled links (`linkBundle`) ignore it.
|
|
390
|
+
@type {number}
|
|
391
|
+
*/ {
|
|
392
|
+
key: "linkBow",
|
|
393
|
+
default: 0.5
|
|
394
|
+
},
|
|
307
395
|
{
|
|
308
396
|
key: "links",
|
|
309
397
|
default: []
|
|
@@ -339,6 +427,15 @@ export const networkDef = {
|
|
|
339
427
|
key: "noDataMessage",
|
|
340
428
|
default: false
|
|
341
429
|
},
|
|
430
|
+
/**
|
|
431
|
+
Lets the viewer drag the nodes (with the `"force"` layout). A dropped
|
|
432
|
+
node stays where it is dropped, and a double-click lets it go. While
|
|
433
|
+
the simulation runs live (see `forceLive`) the other nodes react to
|
|
434
|
+
the dragged one.
|
|
435
|
+
*/ {
|
|
436
|
+
key: "nodeDrag",
|
|
437
|
+
default: true
|
|
438
|
+
},
|
|
342
439
|
{
|
|
343
440
|
key: "nodeGroupBy",
|
|
344
441
|
default: [
|
|
@@ -346,6 +443,17 @@ export const networkDef = {
|
|
|
346
443
|
]
|
|
347
444
|
},
|
|
348
445
|
/**
|
|
446
|
+
The order of the nodes around the circle when `layout` is
|
|
447
|
+
`"circle"`: `"data"` (their order in `nodes`), `"label"`
|
|
448
|
+
(alphabetical), `"group"` (by cluster or top-level group, then by
|
|
449
|
+
label), `"degree"` (most connected first), or a comparator function
|
|
450
|
+
receiving two node rows. Defaults to each cluster (or top-level
|
|
451
|
+
group) together, largest first, its most connected nodes first.
|
|
452
|
+
@type {"data" | "label" | "group" | "degree" | function}
|
|
453
|
+
*/ {
|
|
454
|
+
key: "nodeSort"
|
|
455
|
+
},
|
|
456
|
+
/**
|
|
349
457
|
How many links a node's tooltip lists under its number of
|
|
350
458
|
connections, strongest first: a number, or `false` for none. Defaults
|
|
351
459
|
to 3 when the links differ in `linkSize`, and none otherwise.
|
|
@@ -365,7 +473,8 @@ export const networkDef = {
|
|
|
365
473
|
},
|
|
366
474
|
/**
|
|
367
475
|
The maximum pixel radius used when sizing nodes. Defaults to half the
|
|
368
|
-
distance between the two closest nodes
|
|
476
|
+
distance between the two closest nodes, and, when Network lays the
|
|
477
|
+
nodes out itself, no more than a twelfth of the chart's smaller side.
|
|
369
478
|
@type {number}
|
|
370
479
|
*/ {
|
|
371
480
|
key: "sizeMax"
|
|
@@ -0,0 +1,312 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Network's remembered layout and live force simulation.
|
|
3
|
+
|
|
4
|
+
A Network remembers where it drew each node. When the nodes or links
|
|
5
|
+
change (a new timeline period, say), the nodes it drew before keep their
|
|
6
|
+
places, new ones enter beside a linked neighbor (see `seedPositions`), and
|
|
7
|
+
a force simulation settles the change. Nodes dropped by a drag stay
|
|
8
|
+
pinned where they were dropped.
|
|
9
|
+
|
|
10
|
+
At or under `forceLive` nodes the simulation keeps running after the
|
|
11
|
+
chart paints, one tick per animation frame, re-laying out and repainting
|
|
12
|
+
the chart until it cools, so the layout visibly settles and reacts to a
|
|
13
|
+
dragged node. Larger networks (or reduced motion) settle a change at
|
|
14
|
+
once, before they paint.
|
|
15
|
+
|
|
16
|
+
@module
|
|
17
|
+
*/ import { forceCollide, forceLink, forceManyBody, forceSimulation, forceX, forceY } from "d3-force";
|
|
18
|
+
import { motionReduced } from "../viz/reducedMotion.js";
|
|
19
|
+
import { fitDataPositions, graphKey, linkSpacing, rescalePositions, seedPositions } from "./livePositions.js";
|
|
20
|
+
/** The node count `forceLive` defaults to. */ export const FORCE_LIVE_DEFAULT = 200;
|
|
21
|
+
/** How fast a live simulation cools: about 150 ticks from its start to rest. */ const ALPHA_DECAY = 0.04;
|
|
22
|
+
/** The heat a live simulation starts with on its first draw. */ const START_ALPHA = 0.5;
|
|
23
|
+
/** The heat a change (new nodes or links) restarts the simulation with. */ const CHANGE_ALPHA = 0.3;
|
|
24
|
+
/** The heat a dragged node keeps the simulation at. */ const DRAG_ALPHA = 0.3;
|
|
25
|
+
/** How many ticks a large network settles a change in, before it paints. */ const QUICK_TICKS = 120;
|
|
26
|
+
/**
|
|
27
|
+
The share of the chart area kept clear around the nodes the data places
|
|
28
|
+
when only some have an `x`/`y`, so the simulated ones fit around them.
|
|
29
|
+
*/ const DATA_INSET = 0.1;
|
|
30
|
+
/** The room kept between a node and the chart's edge, for its hover outline. */ const EDGE_PAD = 3;
|
|
31
|
+
/** The chart's remembered layout, created on first use. */ export function networkLive(viz) {
|
|
32
|
+
let state = viz.ctx.networkLive;
|
|
33
|
+
if (!state) viz.ctx.networkLive = state = {
|
|
34
|
+
positions: new Map(),
|
|
35
|
+
pinned: new Map()
|
|
36
|
+
};
|
|
37
|
+
return state;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
Whether a network of `count` nodes runs its simulation live: at most
|
|
41
|
+
`forceLive` nodes (`true` for any number, `false` for never), in a
|
|
42
|
+
browser, with motion allowed.
|
|
43
|
+
@param viz The chart.
|
|
44
|
+
@param count The number of nodes.
|
|
45
|
+
*/ export function liveForceOn(viz, count) {
|
|
46
|
+
const setting = viz.schema.forceLive;
|
|
47
|
+
if (setting === false || !count) return false;
|
|
48
|
+
const cap = setting === true ? Infinity : typeof setting === "number" ? setting : FORCE_LIVE_DEFAULT;
|
|
49
|
+
return count <= cap && !viz._ssr && typeof requestAnimationFrame === "function" && typeof document !== "undefined" && !motionReduced(viz);
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
A force simulation over `nodes` in the chart's pixel space, stopped (it
|
|
53
|
+
is ticked by hand): links pull to `spacing` apart (or just clear of both
|
|
54
|
+
nodes), nodes push each other off and don't overlap, and a weak pull
|
|
55
|
+
toward the middle keeps unlinked groups in view.
|
|
56
|
+
@param nodes The nodes, at their starting positions.
|
|
57
|
+
@param links The links, by node ids.
|
|
58
|
+
@param bounds The chart area.
|
|
59
|
+
@param spacing The distance linked nodes settle at.
|
|
60
|
+
*/ export function networkSimulation(nodes, links, bounds, spacing) {
|
|
61
|
+
const reach = (n)=>Math.max(n.rx, n.ry);
|
|
62
|
+
return forceSimulation(nodes).stop().alphaDecay(ALPHA_DECAY).force("link", forceLink(links).id((d)=>d.id).distance((l)=>Math.max(spacing, reach(l.source) + reach(l.target) + 4))).force("charge", forceManyBody().strength(-spacing).distanceMax(spacing * 6)).force("collide", forceCollide((n)=>reach(n) + 2)).force("x", forceX(bounds.width / 2).strength(0.03)).force("y", forceY(bounds.height / 2).strength(0.03));
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
Keeps every free node inside the chart area, `pad` pixels clear of its
|
|
66
|
+
edges (a node too big to fit sits in the middle). Fixed nodes stay put.
|
|
67
|
+
@param nodes The simulated nodes.
|
|
68
|
+
@param bounds The chart area.
|
|
69
|
+
@param pad The room kept at each edge.
|
|
70
|
+
*/ export function containLive(nodes, bounds, pad = EDGE_PAD) {
|
|
71
|
+
const clamp = (v, half, size)=>{
|
|
72
|
+
const lo = half + pad;
|
|
73
|
+
const hi = size - half - pad;
|
|
74
|
+
return lo > hi ? size / 2 : Math.max(lo, Math.min(hi, v));
|
|
75
|
+
};
|
|
76
|
+
for (const n of nodes){
|
|
77
|
+
if (n.fx !== undefined && n.fx !== null) continue;
|
|
78
|
+
n.x = clamp(n.x ?? 0, n.rx, bounds.width);
|
|
79
|
+
n.y = clamp(n.y ?? 0, n.ry, bounds.height);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
/** Builds the simulation for this draw's nodes, starting at `positions`. */ function buildSimulation(nodes, links, positions, fixed, bounds) {
|
|
83
|
+
const simNodes = nodes.map((n)=>{
|
|
84
|
+
const at = fixed.get(n.id) ?? positions.get(n.id);
|
|
85
|
+
const half = (size)=>(size ?? n.r * 2) / 2;
|
|
86
|
+
return {
|
|
87
|
+
id: n.id,
|
|
88
|
+
x: at.x,
|
|
89
|
+
y: at.y,
|
|
90
|
+
rx: half(n.width),
|
|
91
|
+
ry: half(n.height),
|
|
92
|
+
...fixed.has(n.id) ? {
|
|
93
|
+
fx: at.x,
|
|
94
|
+
fy: at.y
|
|
95
|
+
} : {}
|
|
96
|
+
};
|
|
97
|
+
});
|
|
98
|
+
const ids = new Set(nodes.map((n)=>n.id));
|
|
99
|
+
const simLinks = links.flatMap((l)=>l.source && l.target && l.source !== l.target && ids.has(l.source.id) && ids.has(l.target.id) ? [
|
|
100
|
+
{
|
|
101
|
+
source: l.source.id,
|
|
102
|
+
target: l.target.id
|
|
103
|
+
}
|
|
104
|
+
] : []);
|
|
105
|
+
// Spaced as the precomputed layout spaces linked nodes.
|
|
106
|
+
const spacing = linkSpacing(nodes, links);
|
|
107
|
+
const sim = networkSimulation(simNodes, simLinks, bounds, spacing);
|
|
108
|
+
containLive(simNodes, bounds);
|
|
109
|
+
return sim;
|
|
110
|
+
}
|
|
111
|
+
/** The pinned nodes still in the graph. */ function fixedPositions(state, nodes) {
|
|
112
|
+
const ids = new Set(nodes.map((n)=>n.id));
|
|
113
|
+
const fixed = new Map();
|
|
114
|
+
for (const [id, p] of state.pinned)if (ids.has(id)) fixed.set(id, p);
|
|
115
|
+
return fixed;
|
|
116
|
+
}
|
|
117
|
+
/** Moves the remembered positions (and the simulation) into a resized chart area. */ function resize(state, bounds) {
|
|
118
|
+
if (!state.bounds) return;
|
|
119
|
+
const from = state.bounds;
|
|
120
|
+
if (from.width === bounds.width && from.height === bounds.height) return;
|
|
121
|
+
state.positions = rescalePositions(state.positions, from, bounds);
|
|
122
|
+
state.pinned = rescalePositions(state.pinned, from, bounds);
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
Places this draw's nodes (see the module notes), writing each node's
|
|
126
|
+
`x`/`y` (and `fx`/`fy`). The nodes arrive at their precomputed layout's
|
|
127
|
+
positions, fitted to the chart area. Returns whether any node ended up
|
|
128
|
+
elsewhere, so the caller leaves the positions as they are rather than
|
|
129
|
+
refitting them. Small multiples lay each panel out afresh instead.
|
|
130
|
+
@param viz The chart.
|
|
131
|
+
@param nodes The nodes, at their precomputed positions.
|
|
132
|
+
@param links The links.
|
|
133
|
+
@param bounds The chart area.
|
|
134
|
+
@param dataCoords The `x`/`y` the data gives each node that has one.
|
|
135
|
+
*/ export function placeNetworkNodes(viz, nodes, links, bounds, dataCoords) {
|
|
136
|
+
if (viz._facetStep) return false;
|
|
137
|
+
const state = networkLive(viz);
|
|
138
|
+
resize(state, bounds);
|
|
139
|
+
state.bounds = bounds;
|
|
140
|
+
if (state.frameDraw && state.sim) {
|
|
141
|
+
applyPositions(nodes, state.positions);
|
|
142
|
+
return true;
|
|
143
|
+
}
|
|
144
|
+
const hot = state.sim && state.sim.alpha() >= state.sim.alphaMin();
|
|
145
|
+
const heat = state.sim?.alpha() ?? 0;
|
|
146
|
+
stopLiveLoop(viz);
|
|
147
|
+
state.sim = undefined;
|
|
148
|
+
const key = graphKey(nodes, links);
|
|
149
|
+
const first = state.key === undefined;
|
|
150
|
+
const changed = !first && key !== state.key;
|
|
151
|
+
state.key = key;
|
|
152
|
+
// A new graph's precomputed places (see `rememberPositions`).
|
|
153
|
+
if (first || changed) state.laid = new Map(nodes.map((n)=>[
|
|
154
|
+
n.id,
|
|
155
|
+
{
|
|
156
|
+
x: n.x ?? 0,
|
|
157
|
+
y: n.y ?? 0
|
|
158
|
+
}
|
|
159
|
+
]));
|
|
160
|
+
// With every node placed by the data there is nothing to simulate.
|
|
161
|
+
const allData = dataCoords.size > 0 && dataCoords.size === nodes.length;
|
|
162
|
+
const live = liveForceOn(viz, nodes.length) && !allData;
|
|
163
|
+
const fixed = fixedPositions(state, nodes);
|
|
164
|
+
if (live && dataCoords.size) {
|
|
165
|
+
const pad = Math.max(Math.max(0, ...nodes.map((n)=>n.r)) + EDGE_PAD, Math.min(bounds.width, bounds.height) * DATA_INSET);
|
|
166
|
+
for (const [id, p] of fitDataPositions(dataCoords, bounds, pad))if (!fixed.has(id)) fixed.set(id, p);
|
|
167
|
+
}
|
|
168
|
+
// Once the layout differs from the precomputed one (a live simulation, a
|
|
169
|
+
// dropped node, or a change it settled), the nodes start where they were.
|
|
170
|
+
const custom = live || fixed.size > 0 || changed || !!state.custom && !first;
|
|
171
|
+
const seeded = seedPositions(nodes, links, custom && !first ? state.positions : new Map()).positions;
|
|
172
|
+
for (const [id, p] of fixed)seeded.set(id, p);
|
|
173
|
+
if (live) {
|
|
174
|
+
const sim = buildSimulation(nodes, links, seeded, fixed, bounds);
|
|
175
|
+
const alpha = first ? START_ALPHA : changed ? CHANGE_ALPHA : hot ? heat : 0;
|
|
176
|
+
sim.alpha(alpha);
|
|
177
|
+
state.sim = sim;
|
|
178
|
+
for (const n of sim.nodes())seeded.set(n.id, {
|
|
179
|
+
x: n.x,
|
|
180
|
+
y: n.y
|
|
181
|
+
});
|
|
182
|
+
if (alpha >= sim.alphaMin()) scheduleFrame(viz);
|
|
183
|
+
} else if (changed && nodes.some((n)=>state.positions.has(n.id))) {
|
|
184
|
+
// A large network settles the change before it paints.
|
|
185
|
+
const sim = buildSimulation(nodes, links, seeded, fixed, bounds);
|
|
186
|
+
sim.alpha(CHANGE_ALPHA);
|
|
187
|
+
for(let i = 0; i < QUICK_TICKS; i++)sim.tick();
|
|
188
|
+
containLive(sim.nodes(), bounds);
|
|
189
|
+
for (const n of sim.nodes())seeded.set(n.id, {
|
|
190
|
+
x: n.x,
|
|
191
|
+
y: n.y
|
|
192
|
+
});
|
|
193
|
+
}
|
|
194
|
+
state.custom = custom;
|
|
195
|
+
if (!custom) return false;
|
|
196
|
+
applyPositions(nodes, seeded);
|
|
197
|
+
return true;
|
|
198
|
+
}
|
|
199
|
+
/** Writes each node's position. */ function applyPositions(nodes, positions) {
|
|
200
|
+
for (const n of nodes){
|
|
201
|
+
const p = positions.get(n.id);
|
|
202
|
+
if (!p) continue;
|
|
203
|
+
n.x = n.fx = p.x;
|
|
204
|
+
n.y = n.fy = p.y;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
Remembers where each node was drawn, and — while the layout is the
|
|
209
|
+
precomputed one — where each node's laid-out place is.
|
|
210
|
+
*/ export function rememberPositions(viz, nodes) {
|
|
211
|
+
if (viz._facetStep) return;
|
|
212
|
+
const state = networkLive(viz);
|
|
213
|
+
state.positions = new Map(nodes.map((n)=>[
|
|
214
|
+
n.id,
|
|
215
|
+
{
|
|
216
|
+
x: n.x ?? 0,
|
|
217
|
+
y: n.y ?? 0
|
|
218
|
+
}
|
|
219
|
+
]));
|
|
220
|
+
// Drawn as laid out (kept inside the chart): where an unpinned node returns.
|
|
221
|
+
if (!state.custom) state.laid = new Map(state.positions);
|
|
222
|
+
}
|
|
223
|
+
/** Asks for the next frame of the live loop. */ export function scheduleFrame(viz) {
|
|
224
|
+
const state = networkLive(viz);
|
|
225
|
+
if (state.frame !== undefined || typeof requestAnimationFrame !== "function") return;
|
|
226
|
+
state.frame = requestAnimationFrame(()=>liveFrame(viz));
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
Asks for the chart to be re-laid out at the remembered positions on the
|
|
230
|
+
next frame: the next tick of the live loop, or a plain repaint.
|
|
231
|
+
*/ export function scheduleRedraw(viz) {
|
|
232
|
+
const state = networkLive(viz);
|
|
233
|
+
if (state.sim) {
|
|
234
|
+
scheduleFrame(viz);
|
|
235
|
+
return;
|
|
236
|
+
}
|
|
237
|
+
if (state.frame !== undefined) return;
|
|
238
|
+
if (typeof requestAnimationFrame !== "function") {
|
|
239
|
+
redrawPositions(viz);
|
|
240
|
+
return;
|
|
241
|
+
}
|
|
242
|
+
state.frame = requestAnimationFrame(()=>{
|
|
243
|
+
state.frame = undefined;
|
|
244
|
+
redrawPositions(viz);
|
|
245
|
+
});
|
|
246
|
+
}
|
|
247
|
+
/** Cancels the live loop's pending frame. */ export function stopLiveLoop(viz) {
|
|
248
|
+
const state = viz.ctx.networkLive;
|
|
249
|
+
if (state?.frame === undefined) return;
|
|
250
|
+
if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(state.frame);
|
|
251
|
+
state.frame = undefined;
|
|
252
|
+
}
|
|
253
|
+
/** Stops the live simulation and its loop (chart teardown). */ export function stopLive(viz) {
|
|
254
|
+
stopLiveLoop(viz);
|
|
255
|
+
const state = viz.ctx.networkLive;
|
|
256
|
+
if (!state) return;
|
|
257
|
+
state.sim = undefined;
|
|
258
|
+
clearTimeout(state.clickTimer);
|
|
259
|
+
}
|
|
260
|
+
/** Re-lays the chart out at the remembered positions and repaints it at once. */ export function redrawPositions(viz) {
|
|
261
|
+
const state = networkLive(viz);
|
|
262
|
+
if (!state.relayout || !viz._sceneRenderer) return;
|
|
263
|
+
state.frameDraw = true;
|
|
264
|
+
try {
|
|
265
|
+
state.relayout();
|
|
266
|
+
} finally{
|
|
267
|
+
state.frameDraw = false;
|
|
268
|
+
}
|
|
269
|
+
viz._drawSceneToTarget(0);
|
|
270
|
+
}
|
|
271
|
+
/**
|
|
272
|
+
One frame of the live loop: a tick of the simulation, then the chart
|
|
273
|
+
re-laid out and repainted at the new positions. It waits out an animated
|
|
274
|
+
transition (so it doesn't cut one short) and stops once the simulation
|
|
275
|
+
cools, unless a node is being dragged, or when the chart has no scene.
|
|
276
|
+
*/ function liveFrame(viz) {
|
|
277
|
+
const state = networkLive(viz);
|
|
278
|
+
state.frame = undefined;
|
|
279
|
+
const sim = state.sim;
|
|
280
|
+
if (!sim || !viz._sceneRenderer || !state.bounds) return;
|
|
281
|
+
if (viz._transitionEndsAt && Date.now() < viz._transitionEndsAt) {
|
|
282
|
+
scheduleFrame(viz);
|
|
283
|
+
return;
|
|
284
|
+
}
|
|
285
|
+
sim.tick();
|
|
286
|
+
containLive(sim.nodes(), state.bounds);
|
|
287
|
+
for (const n of sim.nodes())state.positions.set(n.id, {
|
|
288
|
+
x: n.x ?? 0,
|
|
289
|
+
y: n.y ?? 0
|
|
290
|
+
});
|
|
291
|
+
redrawPositions(viz);
|
|
292
|
+
if (state.dragging !== undefined || sim.alpha() >= sim.alphaMin()) scheduleFrame(viz);
|
|
293
|
+
}
|
|
294
|
+
/** Heats the live simulation for a drag, or cools it again after. */ export function dragHeat(viz, dragging) {
|
|
295
|
+
const sim = networkLive(viz).sim;
|
|
296
|
+
if (!sim) return;
|
|
297
|
+
sim.alphaTarget(dragging ? DRAG_ALPHA : 0);
|
|
298
|
+
if (dragging) sim.alpha(Math.max(sim.alpha(), DRAG_ALPHA));
|
|
299
|
+
scheduleFrame(viz);
|
|
300
|
+
}
|
|
301
|
+
/**
|
|
302
|
+
Re-heats the live simulation (after a node is let go), or — without
|
|
303
|
+
one — repaints the chart at the remembered positions.
|
|
304
|
+
*/ export function reheat(viz) {
|
|
305
|
+
const sim = networkLive(viz).sim;
|
|
306
|
+
if (!sim) {
|
|
307
|
+
redrawPositions(viz);
|
|
308
|
+
return;
|
|
309
|
+
}
|
|
310
|
+
sim.alpha(Math.max(sim.alpha(), CHANGE_ALPHA));
|
|
311
|
+
scheduleFrame(viz);
|
|
312
|
+
}
|