@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
|
@@ -8,6 +8,7 @@ import { axisName } from "../Plot/sharedTooltip.js";
|
|
|
8
8
|
import { ohlcAccessors } from "./aggregate.js";
|
|
9
9
|
import { candleChange, readOhlc } from "./ohlc.js";
|
|
10
10
|
import { formatPeriod, periodDate } from "./periods.js";
|
|
11
|
+
import { configUtc } from "../../components/Axis/timeValues.js";
|
|
11
12
|
import { formatVolume, readVolume } from "./volume.js";
|
|
12
13
|
/**
|
|
13
14
|
A price as the tooltip shows it: two decimals for values of 1 or more
|
|
@@ -16,11 +17,7 @@ import { formatVolume, readVolume } from "./volume.js";
|
|
|
16
17
|
@param value The price.
|
|
17
18
|
@param locale The chart's locale.
|
|
18
19
|
*/ export function formatPrice(value, locale) {
|
|
19
|
-
|
|
20
|
-
// formatAbbreviate drops trailing zeros; put the cents back.
|
|
21
|
-
const decimal = formatAbbreviate(1.5, locale, ".1f").charAt(1);
|
|
22
|
-
const [whole, cents = ""] = formatAbbreviate(value, locale, ",.2f").split(decimal);
|
|
23
|
-
return `${whole}${decimal}${cents.padEnd(2, "0")}`;
|
|
20
|
+
return formatAbbreviate(value, locale, Math.abs(value) < 1 ? ".3~g" : ",.2f");
|
|
24
21
|
}
|
|
25
22
|
/**
|
|
26
23
|
A fractional change as a signed percentage, e.g. `0.0123` as `"+1.23%"`.
|
|
@@ -37,9 +34,10 @@ import { formatVolume, readVolume } from "./volume.js";
|
|
|
37
34
|
/** A row's period: through the x axis's `tickFormat` when set, else as a full date. */ function periodText(viz, d, i) {
|
|
38
35
|
const raw = viz._x ? viz._x(d, i) : undefined;
|
|
39
36
|
const tickFormat = viz._xConfig?.tickFormat;
|
|
40
|
-
const
|
|
37
|
+
const utc = configUtc(viz._xConfig);
|
|
38
|
+
const value = periodDate(raw, utc);
|
|
41
39
|
if (typeof tickFormat === "function") return String(tickFormat(value));
|
|
42
|
-
return value instanceof Date ? formatPeriod(value) : String(raw ?? "");
|
|
40
|
+
return value instanceof Date ? formatPeriod(value, utc) : String(raw ?? "");
|
|
43
41
|
}
|
|
44
42
|
/**
|
|
45
43
|
The tooltip rows for one period: its date, then Open, High, Low, Close,
|
|
@@ -13,6 +13,7 @@ import { clearRingLabels, ringLabelFont, ringLabelNodes } from "../features/ring
|
|
|
13
13
|
import { ringLabelPosition } from "../features/ringLabels.js";
|
|
14
14
|
import { backgroundInk } from "../viz/backgroundInk.js";
|
|
15
15
|
import { chordLabelFontSize } from "./labels.js";
|
|
16
|
+
import { pairLabels } from "../features/labelLayering.js";
|
|
16
17
|
/**
|
|
17
18
|
The group labels the layout stage placed: curved ones along the ring,
|
|
18
19
|
and the rest along their spokes, in the chart's ink. A spoke label that
|
|
@@ -125,7 +126,7 @@ import { chordLabelFontSize } from "./labels.js";
|
|
|
125
126
|
...ribbonImages
|
|
126
127
|
];
|
|
127
128
|
}
|
|
128
|
-
export const chordEmit = ({ viz })=>{
|
|
129
|
+
export const chordEmit = pairLabels(({ viz })=>{
|
|
129
130
|
const c = viz.ctx.chordCtx;
|
|
130
131
|
if (!c) return [];
|
|
131
132
|
const out = [];
|
|
@@ -157,4 +158,4 @@ export const chordEmit = ({ viz })=>{
|
|
|
157
158
|
// Group labels: curved along the ring, or along their spokes.
|
|
158
159
|
if (arcData.length) out.push(...chordLabels(viz, arcData));
|
|
159
160
|
return out;
|
|
160
|
-
};
|
|
161
|
+
});
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
ConnectedScatter — Scatter joining each series' points in order, with
|
|
3
|
+
arrowheads along the path and its first and last points labeled.
|
|
4
|
+
*/ import { makeChart } from "../definition/makeChart.js";
|
|
5
|
+
import { coerceOrder, DATA_ORDER } from "../Plot/orderPath.js";
|
|
6
|
+
import { orderTooltipRows } from "../Plot/orderPathScene.js";
|
|
7
|
+
import Scatter from "../Scatter/index.js";
|
|
8
|
+
export const connectedScatterDef = {
|
|
9
|
+
name: "ConnectedScatter",
|
|
10
|
+
paintDriven: true,
|
|
11
|
+
ctx: {},
|
|
12
|
+
fields: [
|
|
13
|
+
/**
|
|
14
|
+
Accessor function or string key for the field that orders each
|
|
15
|
+
series' path, such as a year. Defaults to the order of the data.
|
|
16
|
+
@type {string | function}
|
|
17
|
+
*/ {
|
|
18
|
+
key: "order",
|
|
19
|
+
default: DATA_ORDER,
|
|
20
|
+
coerce: coerceOrder
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
key: "tooltipConfig",
|
|
24
|
+
merge: true,
|
|
25
|
+
factory: (viz)=>({
|
|
26
|
+
tbody: (d, i)=>orderTooltipRows(viz, d, i)
|
|
27
|
+
})
|
|
28
|
+
}
|
|
29
|
+
]
|
|
30
|
+
};
|
|
31
|
+
/**
|
|
32
|
+
Creates a connected scatterplot from an array of data: each row draws as
|
|
33
|
+
a point at its `x` and `y` values, and a line joins each series' points
|
|
34
|
+
in `order` (a field such as a year; the data's order by default), so the
|
|
35
|
+
line traces the path two measures took together. Arrowheads along the
|
|
36
|
+
line show its direction (`pathArrows`), and its first and last points are
|
|
37
|
+
labeled with their order values (`pathLabels`). Hover a point for its
|
|
38
|
+
row.
|
|
39
|
+
*/ export default makeChart(connectedScatterDef, Scatter);
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
/**
|
|
2
|
+
CyclePlot's panels: Plot's small-multiple hooks, with room inside each
|
|
3
|
+
panel's ends (enough, when it can be, for the first and last cycles'
|
|
4
|
+
labels), each panel's x axis labeling only its first and last cycle,
|
|
5
|
+
and the inner panels' y axes reduced to the line between neighboring
|
|
6
|
+
panels, so the panels touch.
|
|
7
|
+
|
|
8
|
+
@module
|
|
9
|
+
*/ import { textWidth } from "@d3plus/dom";
|
|
10
|
+
import { fontFamilyStringify } from "@d3plus/text";
|
|
11
|
+
import { plotFacetPanel, sharePlotScales } from "../Plot/plotFacet.js";
|
|
12
|
+
/** The room inside each end of a panel, as a fraction of the span of cycles it plots. */ export const CYCLE_INSET = 0.1;
|
|
13
|
+
/** The most room inside each end of a panel CyclePlot makes for the end labels. */ export const CYCLE_INSET_MAX = 0.5;
|
|
14
|
+
/** The space kept clear around each end label, in pixels. */ export const END_LABEL_GAP = 6;
|
|
15
|
+
/** An axis's default tick label size (see `Axis`). */ const AXIS_FONT_SIZE = 12;
|
|
16
|
+
/** An axis's default tick length and label padding (see `Axis`). */ const AXIS_TICK_SIZE = 8;
|
|
17
|
+
const AXIS_PADDING = 5;
|
|
18
|
+
/**
|
|
19
|
+
`domain` widened at each end by `fraction` of its span, keeping Dates as
|
|
20
|
+
Dates. A domain without a span (a single cycle) is returned as is.
|
|
21
|
+
*/ export function insetDomain(domain, fraction) {
|
|
22
|
+
if (!domain || domain.length !== 2) return domain;
|
|
23
|
+
const [lo, hi] = domain.map(Number);
|
|
24
|
+
const pad = (hi - lo) * fraction;
|
|
25
|
+
if (!Number.isFinite(pad) || pad <= 0) return domain;
|
|
26
|
+
const out = [
|
|
27
|
+
lo - pad,
|
|
28
|
+
hi + pad
|
|
29
|
+
];
|
|
30
|
+
return domain[0] instanceof Date ? out.map((v)=>new Date(v)) : out;
|
|
31
|
+
}
|
|
32
|
+
/** Where a cycle at the end of a domain widened by `inset` sits, as a fraction of the panel from its nearer end. */ const endPlace = (inset)=>inset / (1 + 2 * inset);
|
|
33
|
+
/**
|
|
34
|
+
The room inside each end of a panel (as `insetDomain`'s fraction) that
|
|
35
|
+
keeps the first and last cycles' labels, centered on their cycles,
|
|
36
|
+
inside a panel `width` pixels wide and apart from each other: at least
|
|
37
|
+
`CYCLE_INSET`, at most `CYCLE_INSET_MAX`. `fits` is false when no room
|
|
38
|
+
in that range does, and the panel draws no end labels.
|
|
39
|
+
@param width The panel's plot width, in pixels.
|
|
40
|
+
@param labels The two labels' widths, in pixels.
|
|
41
|
+
*/ export function endLabelInset(width, labels) {
|
|
42
|
+
const [a, b] = labels;
|
|
43
|
+
if (!(width > 0)) return {
|
|
44
|
+
inset: CYCLE_INSET,
|
|
45
|
+
fits: false
|
|
46
|
+
};
|
|
47
|
+
const need = (Math.max(a, b) / 2 + END_LABEL_GAP) / width;
|
|
48
|
+
const most = Math.min(endPlace(CYCLE_INSET_MAX), (1 - ((a + b) / 2 + END_LABEL_GAP) / width) / 2);
|
|
49
|
+
const least = endPlace(CYCLE_INSET);
|
|
50
|
+
if (Math.max(least, need) > most) return {
|
|
51
|
+
inset: CYCLE_INSET,
|
|
52
|
+
fits: false
|
|
53
|
+
};
|
|
54
|
+
if (need <= least) return {
|
|
55
|
+
inset: CYCLE_INSET,
|
|
56
|
+
fits: true
|
|
57
|
+
};
|
|
58
|
+
return {
|
|
59
|
+
inset: need / (1 - 2 * need),
|
|
60
|
+
fits: true
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
/** The chart's cycle state, as its panels read it. */ const axisState = (viz)=>viz.ctx.cycle ?? {};
|
|
64
|
+
/** How wide `text` draws at the x axis's label style, in pixels. */ function labelWidth(viz, text) {
|
|
65
|
+
const label = viz._xConfig?.shapeConfig?.labelConfig;
|
|
66
|
+
const size = typeof label?.fontSize === "number" ? label.fontSize : AXIS_FONT_SIZE;
|
|
67
|
+
const own = label?.fontFamily;
|
|
68
|
+
const family = typeof own === "string" || Array.isArray(own) ? own : viz.schema.fontFamily;
|
|
69
|
+
return Number(textWidth(text, {
|
|
70
|
+
"font-family": fontFamilyStringify(family),
|
|
71
|
+
"font-size": size
|
|
72
|
+
}));
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
The scales every panel shares (see `sharePlotScales`), with room inside
|
|
76
|
+
each panel's ends: enough for the first and last cycles' labels when it
|
|
77
|
+
can be (see `endLabelInset`), measured at the panels' size. Notes the
|
|
78
|
+
end cycles and, when they fit, their labels.
|
|
79
|
+
*/ export function shareCycleScales(viz, panels) {
|
|
80
|
+
const scales = sharePlotScales(viz, panels);
|
|
81
|
+
const state = axisState(viz);
|
|
82
|
+
const ends = (scales.domains.x ?? []).filter((d)=>d instanceof Date);
|
|
83
|
+
let inset = CYCLE_INSET;
|
|
84
|
+
state.ends = ends.length === 2 && +ends[0] !== +ends[1] ? ends : undefined;
|
|
85
|
+
state.endLabels = undefined;
|
|
86
|
+
if (state.ends && state.endLabel) {
|
|
87
|
+
const texts = state.ends.map(state.endLabel);
|
|
88
|
+
const width = viz.schema.width - viz._margin.left - viz._margin.right;
|
|
89
|
+
const fit = endLabelInset(width, [
|
|
90
|
+
labelWidth(viz, texts[0]),
|
|
91
|
+
labelWidth(viz, texts[1])
|
|
92
|
+
]);
|
|
93
|
+
inset = fit.inset;
|
|
94
|
+
if (fit.fits) state.endLabels = texts;
|
|
95
|
+
}
|
|
96
|
+
const domains = {
|
|
97
|
+
...scales.domains
|
|
98
|
+
};
|
|
99
|
+
const padded = {
|
|
100
|
+
...scales.padded
|
|
101
|
+
};
|
|
102
|
+
const x = insetDomain(domains.x, inset);
|
|
103
|
+
if (x) domains.x = x;
|
|
104
|
+
const px = insetDomain(padded.x, inset);
|
|
105
|
+
if (px) padded.x = px;
|
|
106
|
+
return {
|
|
107
|
+
...scales,
|
|
108
|
+
domains,
|
|
109
|
+
padded
|
|
110
|
+
};
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
The x axis config a panel draws with: ticks at the first and last
|
|
114
|
+
cycles, labeled when the panel labels its x axis and the labels fit,
|
|
115
|
+
unless the user's `xConfig` sets its own `ticks` or `labels`. Every key
|
|
116
|
+
is always set: the axis keeps config between draws.
|
|
117
|
+
*/ export function cycleXConfig(config, user, state, labeled) {
|
|
118
|
+
const c = config || {};
|
|
119
|
+
if (user && (user.ticks !== undefined || user.labels !== undefined)) return c;
|
|
120
|
+
const ends = state.ends ?? [];
|
|
121
|
+
const format = state.endLabel;
|
|
122
|
+
return {
|
|
123
|
+
...c,
|
|
124
|
+
labels: labeled && state.endLabels ? ends : [],
|
|
125
|
+
ticks: ends,
|
|
126
|
+
...format && user?.tickFormat === undefined ? {
|
|
127
|
+
tickFormat: (d)=>d instanceof Date || typeof d === "number" ? format(new Date(+d)) : `${d}`
|
|
128
|
+
} : {}
|
|
129
|
+
};
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
The y axis config a panel draws with: an unlabeled panel's axis has no
|
|
133
|
+
ticks and no padding, so its line is the edge it shares with the panel
|
|
134
|
+
before it. Both keys are always set: the axis keeps config between
|
|
135
|
+
draws.
|
|
136
|
+
*/ export function cycleYConfig(config, labeled) {
|
|
137
|
+
const c = config || {};
|
|
138
|
+
return {
|
|
139
|
+
...c,
|
|
140
|
+
padding: labeled ? c.padding ?? AXIS_PADDING : 0,
|
|
141
|
+
tickSize: labeled ? c.tickSize ?? AXIS_TICK_SIZE : 0
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
/** Applies a panel's shared scales and axis labels (see `plotFacetPanel`), and its x and y axis configs; returns the undo. */ export function cycleFacetPanel(viz, ctx) {
|
|
145
|
+
const saved = viz._yConfig;
|
|
146
|
+
const savedX = viz._xConfig;
|
|
147
|
+
const undo = plotFacetPanel(viz, ctx);
|
|
148
|
+
viz._yConfig = cycleYConfig(viz._yConfig, ctx.labels.y);
|
|
149
|
+
viz._xConfig = cycleXConfig(viz._xConfig, savedX, axisState(viz), ctx.labels.x);
|
|
150
|
+
return ()=>{
|
|
151
|
+
undo();
|
|
152
|
+
const restored = cycleYConfig(saved, true);
|
|
153
|
+
viz._yAxis?.config({
|
|
154
|
+
padding: restored.padding,
|
|
155
|
+
tickSize: restored.tickSize
|
|
156
|
+
});
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
/** CyclePlot's small-multiple hooks, layered over Plot's. */ export const cycleFacetHooks = {
|
|
160
|
+
share: shareCycleScales,
|
|
161
|
+
panel: cycleFacetPanel
|
|
162
|
+
};
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
CyclePlot's mean lines: each series' mean across the cycles of one
|
|
3
|
+
panel, drawn as a reference line across the panel.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/ /**
|
|
7
|
+
The mean of each series' finite values, in the order the series first
|
|
8
|
+
appear. Series without a finite value are left out.
|
|
9
|
+
@param rows The panel's rows.
|
|
10
|
+
@param id Each row's series.
|
|
11
|
+
@param value Each row's value.
|
|
12
|
+
*/ export function cycleMeans(rows, id, value) {
|
|
13
|
+
const sums = new Map();
|
|
14
|
+
rows.forEach((d, i)=>{
|
|
15
|
+
const v = Number(value(d, i));
|
|
16
|
+
if (!Number.isFinite(v)) return;
|
|
17
|
+
const key = `${id(d, i)}`;
|
|
18
|
+
const entry = sums.get(key);
|
|
19
|
+
if (entry) {
|
|
20
|
+
entry.sum += v;
|
|
21
|
+
entry.count += 1;
|
|
22
|
+
} else sums.set(key, {
|
|
23
|
+
sum: v,
|
|
24
|
+
count: 1,
|
|
25
|
+
row: d,
|
|
26
|
+
index: i
|
|
27
|
+
});
|
|
28
|
+
});
|
|
29
|
+
return Array.from(sums, ([key, e])=>({
|
|
30
|
+
id: key,
|
|
31
|
+
mean: e.sum / e.count,
|
|
32
|
+
row: e.row,
|
|
33
|
+
index: e.index
|
|
34
|
+
}));
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
The reference lines a panel draws at each series' mean (none when `mean`
|
|
38
|
+
is off): in the chart's text color for a single series, else in each
|
|
39
|
+
series' color, styled by `meanConfig`.
|
|
40
|
+
*/ export function cycleMeanLines(viz) {
|
|
41
|
+
if (viz.schema.mean === false || !viz._y) return [];
|
|
42
|
+
const means = cycleMeans(viz._filteredData || [], viz._id, viz._y);
|
|
43
|
+
const config = viz.schema.meanConfig ?? {};
|
|
44
|
+
const fill = viz.schema.shapeConfig.fill;
|
|
45
|
+
const colored = means.length > 1;
|
|
46
|
+
return means.map((m)=>({
|
|
47
|
+
strokeOpacity: 1,
|
|
48
|
+
...colored ? {
|
|
49
|
+
stroke: typeof fill === "function" ? `${fill(m.row, m.index)}` : fill
|
|
50
|
+
} : {},
|
|
51
|
+
...config,
|
|
52
|
+
y: m.mean
|
|
53
|
+
}));
|
|
54
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
CyclePlot's periods: which season a date falls in (its panel), the
|
|
3
|
+
cycle it belongs to (its place along the panel's x axis), and the
|
|
4
|
+
panels' titles and order. Pure date math, in local time or UTC.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/ import { timeDay, timeFriday, timeMonday, timeSaturday, timeSunday, timeThursday, timeTuesday, timeWednesday, timeYear, utcDay, utcFriday, utcMonday, utcSaturday, utcSunday, utcThursday, utcTuesday, utcWednesday, utcYear } from "d3-time";
|
|
8
|
+
import { timeFormatLocale } from "d3-time-format";
|
|
9
|
+
/** Every period CyclePlot draws, in the order the docs list them. */ export const CYCLE_PERIODS = [
|
|
10
|
+
"month",
|
|
11
|
+
"quarter",
|
|
12
|
+
"weekday",
|
|
13
|
+
"hour"
|
|
14
|
+
];
|
|
15
|
+
/** A `period` setting as a CyclePlot period, defaulting to `"month"`. */ export function resolveCyclePeriod(value) {
|
|
16
|
+
return CYCLE_PERIODS.includes(value) ? value : "month";
|
|
17
|
+
}
|
|
18
|
+
/** How many seasons a period's cycle holds. */ export function cyclePeriodCount(period) {
|
|
19
|
+
return ({
|
|
20
|
+
month: 12,
|
|
21
|
+
quarter: 4,
|
|
22
|
+
weekday: 7,
|
|
23
|
+
hour: 24
|
|
24
|
+
})[period];
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
The season `date` falls in: its month (0–11), quarter (0–3), weekday
|
|
28
|
+
(0 = Sunday … 6), or hour (0–23), read in UTC with `utc`.
|
|
29
|
+
*/ export function cyclePeriodOf(date, period, utc = false) {
|
|
30
|
+
switch(period){
|
|
31
|
+
case "quarter":
|
|
32
|
+
return Math.floor((utc ? date.getUTCMonth() : date.getMonth()) / 3);
|
|
33
|
+
case "weekday":
|
|
34
|
+
return utc ? date.getUTCDay() : date.getDay();
|
|
35
|
+
case "hour":
|
|
36
|
+
return utc ? date.getUTCHours() : date.getHours();
|
|
37
|
+
default:
|
|
38
|
+
return utc ? date.getUTCMonth() : date.getMonth();
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
const LOCAL_WEEKS = [
|
|
42
|
+
timeSunday,
|
|
43
|
+
timeMonday,
|
|
44
|
+
timeTuesday,
|
|
45
|
+
timeWednesday,
|
|
46
|
+
timeThursday,
|
|
47
|
+
timeFriday,
|
|
48
|
+
timeSaturday
|
|
49
|
+
];
|
|
50
|
+
const UTC_WEEKS = [
|
|
51
|
+
utcSunday,
|
|
52
|
+
utcMonday,
|
|
53
|
+
utcTuesday,
|
|
54
|
+
utcWednesday,
|
|
55
|
+
utcThursday,
|
|
56
|
+
utcFriday,
|
|
57
|
+
utcSaturday
|
|
58
|
+
];
|
|
59
|
+
/**
|
|
60
|
+
The start of the cycle `date` belongs to, which places it along its
|
|
61
|
+
panel's x axis: its year (for months and quarters), its week starting on
|
|
62
|
+
`weekStart` (0 = Sunday … 6, for weekdays), or its day (for hours).
|
|
63
|
+
*/ export function cycleStartOf(date, period, utc = false, weekStart = 1) {
|
|
64
|
+
if (period === "weekday") return (utc ? UTC_WEEKS : LOCAL_WEEKS)[(weekStart % 7 + 7) % 7].floor(date);
|
|
65
|
+
if (period === "hour") return (utc ? utcDay : timeDay).floor(date);
|
|
66
|
+
return (utc ? utcYear : timeYear).floor(date);
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
The seasons in panel order: months, quarters, and hours from the first,
|
|
70
|
+
weekdays from `weekStart` (0 = Sunday … 6).
|
|
71
|
+
*/ export function cyclePeriodOrder(period, weekStart = 1) {
|
|
72
|
+
const count = cyclePeriodCount(period);
|
|
73
|
+
const start = period === "weekday" ? (weekStart % 7 + 7) % 7 : 0;
|
|
74
|
+
return Array.from({
|
|
75
|
+
length: count
|
|
76
|
+
}, (_, i)=>(start + i) % count);
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
A season's short name, for a panel title, in a d3-time-format locale:
|
|
80
|
+
`"Jan"`, `"Q1"`, `"Mon"`, or an hour (`"1 PM"` where the locale writes
|
|
81
|
+
times with AM/PM, else `"13:00"`).
|
|
82
|
+
*/ export function cyclePeriodLabel(index, period, locale) {
|
|
83
|
+
if (period === "quarter") return `${locale.quarter}${index + 1}`;
|
|
84
|
+
if (period === "weekday") return locale.shortDays[index] ?? `${index}`;
|
|
85
|
+
if (period === "hour") {
|
|
86
|
+
const format = timeFormatLocale(locale).utcFormat(locale.time.includes("%p") ? "%-I %p" : "%-H:00");
|
|
87
|
+
return format(new Date(Date.UTC(2000, 0, 1, index)));
|
|
88
|
+
}
|
|
89
|
+
return locale.shortMonths[index] ?? `${index}`;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
A cycle's label at the end of a panel's x axis, in a d3-time-format
|
|
93
|
+
locale: its year for months and quarters (`"1949"`), else its first
|
|
94
|
+
day (`"Jan 2"`), for weeks and days.
|
|
95
|
+
*/ export function cycleEndLabel(cycle, period, locale, utc = false) {
|
|
96
|
+
const formats = timeFormatLocale(locale);
|
|
97
|
+
const spec = period === "month" || period === "quarter" ? "%Y" : "%b %-d";
|
|
98
|
+
return (utc ? formats.utcFormat(spec) : formats.format(spec))(cycle);
|
|
99
|
+
}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
CyclePlot's tooltips: a point's date in its season and cycle (rather
|
|
3
|
+
than the cycle its panel's x axis places it at), and the mean of its
|
|
4
|
+
series in its panel.
|
|
5
|
+
|
|
6
|
+
@module
|
|
7
|
+
*/ import { timeFormatLocale } from "d3-time-format";
|
|
8
|
+
import { unwrapRow } from "../features/shareKey.js";
|
|
9
|
+
import { axisValue } from "../Plot/sharedTooltip.js";
|
|
10
|
+
import { cycleMeans } from "./cycleMeans.js";
|
|
11
|
+
import { cyclePeriodLabel, cyclePeriodOf } from "./cyclePeriods.js";
|
|
12
|
+
/**
|
|
13
|
+
A date as its season in its cycle, in a d3-time-format locale: a month
|
|
14
|
+
or quarter with its year (`"Jul 1955"`, `"Q3 1955"`), or a weekday or
|
|
15
|
+
hour with its date (`"Mon 1/2/2023"`, `"1/2/2023 1 PM"`).
|
|
16
|
+
*/ export function cycleDateLabel(date, period, locale, utc = false) {
|
|
17
|
+
const formats = timeFormatLocale(locale);
|
|
18
|
+
const format = (spec)=>(utc ? formats.utcFormat(spec) : formats.format(spec))(date);
|
|
19
|
+
const season = cyclePeriodLabel(cyclePeriodOf(date, period, utc), period, locale);
|
|
20
|
+
if (period === "weekday") return `${season} ${format(locale.date)}`;
|
|
21
|
+
if (period === "hour") return `${format(locale.date)} ${season}`;
|
|
22
|
+
return `${season} ${format("%Y")}`;
|
|
23
|
+
}
|
|
24
|
+
/** Whether a row belongs to no series (data without `groupBy`). */ export function noSeries(viz, d, i) {
|
|
25
|
+
const id = viz._id(d, i);
|
|
26
|
+
return id === undefined || id === null || `${id}` === "undefined";
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
The mean of `d`'s series over the rows of its panel (its season), or
|
|
30
|
+
undefined without one.
|
|
31
|
+
*/ export function cycleRowMean(viz, ctx, d, i) {
|
|
32
|
+
const season = ctx.season(d, i);
|
|
33
|
+
if (season === undefined || !viz._y) return undefined;
|
|
34
|
+
const id = `${viz._id(d, i)}`;
|
|
35
|
+
const rows = (viz._filteredData || []).filter((r, k)=>ctx.season(r, k) === season && `${viz._id(r, k)}` === id);
|
|
36
|
+
return cycleMeans(rows, viz._id, viz._y)[0]?.mean;
|
|
37
|
+
}
|
|
38
|
+
/** The tooltip's title: the series' name, or the point's date when the data has no series. */ export function cycleTooltipTitle(viz, ctx, datum, i) {
|
|
39
|
+
const d = unwrapRow(datum);
|
|
40
|
+
if (!noSeries(viz, d, i)) return viz._drawLabel(d, i);
|
|
41
|
+
const date = ctx.date(d, i);
|
|
42
|
+
return date ? cycleDateLabel(date, ctx.period, ctx.locale, ctx.utc) : "";
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
The x value a tooltip shows for a row: its date in its season and cycle
|
|
46
|
+
(see `cycleDateLabel`), or null for a row of no series, whose title is
|
|
47
|
+
its date. Undefined for other axes, or a row without a date.
|
|
48
|
+
*/ export function cycleAxisLabel(viz, ctx, axis, datum, i) {
|
|
49
|
+
if (axis !== "x") return undefined;
|
|
50
|
+
const d = unwrapRow(datum);
|
|
51
|
+
const date = ctx.date(d, i);
|
|
52
|
+
if (!date) return undefined;
|
|
53
|
+
return noSeries(viz, d, i) ? null : cycleDateLabel(date, ctx.period, ctx.locale, ctx.utc);
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
The rows a tooltip adds after the point's x and y values: its series'
|
|
57
|
+
mean in its panel (none with `mean` off).
|
|
58
|
+
*/ export function cycleTooltipRows(viz, ctx, datum, i) {
|
|
59
|
+
if (viz.schema.mean === false) return [];
|
|
60
|
+
const mean = cycleRowMean(viz, ctx, unwrapRow(datum), i);
|
|
61
|
+
return mean === undefined ? [] : [
|
|
62
|
+
[
|
|
63
|
+
viz.schema.translate("Mean"),
|
|
64
|
+
axisValue(viz, "y", mean)
|
|
65
|
+
]
|
|
66
|
+
];
|
|
67
|
+
}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
/**
|
|
2
|
+
CyclePlot — a LinePlot split into one touching panel per season (a
|
|
3
|
+
month, quarter, weekday, or hour), each plotting that season across the
|
|
4
|
+
cycles in the data, with a line at its mean.
|
|
5
|
+
*/ import { assign, date } from "@d3plus/dom";
|
|
6
|
+
import { mean } from "d3-array";
|
|
7
|
+
import { findWeekStart, locale as timeLocales } from "@d3plus/locales";
|
|
8
|
+
import { makeChart } from "../definition/makeChart.js";
|
|
9
|
+
import LinePlot from "../LinePlot/index.js";
|
|
10
|
+
import { chartUtc } from "../Plot/plotRangeBreaks.js";
|
|
11
|
+
import { cycleFacetHooks } from "./cycleFacet.js";
|
|
12
|
+
import { cycleMeanLines } from "./cycleMeans.js";
|
|
13
|
+
import { cycleAxisLabel, cycleTooltipRows, cycleTooltipTitle } from "./cycleTooltip.js";
|
|
14
|
+
import { cycleEndLabel, cyclePeriodLabel, cyclePeriodOf, cyclePeriodOrder, cycleStartOf, resolveCyclePeriod } from "./cyclePeriods.js";
|
|
15
|
+
/** The mean of the values `value` reads from `rows`: how rows in the same season and cycle merge by default. */ export function meanAgg(rows, value) {
|
|
16
|
+
return mean(rows, (d)=>{
|
|
17
|
+
const v = value(d);
|
|
18
|
+
return typeof v === "number" ? v : undefined;
|
|
19
|
+
});
|
|
20
|
+
}
|
|
21
|
+
/** The chart's cycle state. */ const cycleState = (viz)=>viz.ctx.cycle;
|
|
22
|
+
/**
|
|
23
|
+
A row's date: its `x` value (the first one, for rows merged across the
|
|
24
|
+
same cycle), parsed in UTC with `utc`.
|
|
25
|
+
*/ export function cycleDate(value, utc) {
|
|
26
|
+
const v = Array.isArray(value) ? value[0] : value;
|
|
27
|
+
if (v === undefined || v === null || v === "") return undefined;
|
|
28
|
+
const parsed = date(v, {
|
|
29
|
+
utc
|
|
30
|
+
});
|
|
31
|
+
return parsed instanceof Date && !isNaN(+parsed) ? parsed : undefined;
|
|
32
|
+
}
|
|
33
|
+
/** The time locale a chart names its seasons in. */ const timeLocaleOf = (viz)=>timeLocales[viz.schema.locale] ?? timeLocales["en-US"];
|
|
34
|
+
/** A panel's title: its season's short name in the chart's locale. */ export function cycleTitle(viz, value) {
|
|
35
|
+
return cyclePeriodLabel(Number(value), cycleState(viz).period, timeLocaleOf(viz));
|
|
36
|
+
}
|
|
37
|
+
/** Orders two panels by their seasons' place in the cycle (weekdays from the locale's first). */ export function cycleCompare(viz, a, b) {
|
|
38
|
+
const { period, weekStart } = cycleState(viz);
|
|
39
|
+
const order = cyclePeriodOrder(period, weekStart);
|
|
40
|
+
return order.indexOf(Number(a)) - order.indexOf(Number(b));
|
|
41
|
+
}
|
|
42
|
+
/** What CyclePlot's tooltips read from the chart (see `cycleTooltip.ts`). */ export function cycleTooltipContext(viz) {
|
|
43
|
+
const state = cycleState(viz);
|
|
44
|
+
return {
|
|
45
|
+
date: (d, i)=>cycleDate(state.source(d, i), state.utc),
|
|
46
|
+
season: state.facet,
|
|
47
|
+
period: state.period,
|
|
48
|
+
locale: timeLocaleOf(viz),
|
|
49
|
+
utc: state.utc
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
Reads this draw's period, time zone, and week start, points `x` and
|
|
54
|
+
`facet` at each row's cycle and season, and averages the rows that
|
|
55
|
+
share both (see `meanAgg`) unless `aggs` sets the `y` key's merge.
|
|
56
|
+
*/ export function prepareCycle(viz) {
|
|
57
|
+
const state = cycleState(viz);
|
|
58
|
+
if (viz._x !== state.cycleX && viz._x) state.source = viz._x;
|
|
59
|
+
state.period = resolveCyclePeriod(viz.schema.period);
|
|
60
|
+
state.utc = chartUtc(viz);
|
|
61
|
+
state.weekStart = findWeekStart(`${viz.schema.locale ?? ""}`);
|
|
62
|
+
const locale = timeLocaleOf(viz);
|
|
63
|
+
const { period, utc } = state;
|
|
64
|
+
state.endLabel = (cycle)=>cycleEndLabel(cycle, period, locale, utc);
|
|
65
|
+
state.ends = state.endLabels = undefined;
|
|
66
|
+
viz._x = state.cycleX;
|
|
67
|
+
viz.schema.facet = state.facet;
|
|
68
|
+
// Rows in the same season and cycle average, unless `aggs` says otherwise.
|
|
69
|
+
const key = viz._yKey;
|
|
70
|
+
const aggs = viz.schema.aggs;
|
|
71
|
+
if (typeof key === "string" && (!(key in aggs) || aggs[key] === meanAgg)) aggs[key] = meanAgg;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
The chart's `color`, with a row of no series (data without `groupBy`)
|
|
75
|
+
taking the first color of the chart's categorical palette.
|
|
76
|
+
*/ export function cycleColor(viz, base) {
|
|
77
|
+
return (d, i)=>{
|
|
78
|
+
const c = base(d, i);
|
|
79
|
+
if (c !== undefined && c !== null) return c;
|
|
80
|
+
return viz.schema.colorDefaults.scale.range()[0];
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
export const cyclePlotDef = {
|
|
84
|
+
name: "CyclePlot",
|
|
85
|
+
paintDriven: true,
|
|
86
|
+
facet: cycleFacetHooks,
|
|
87
|
+
setup: (viz)=>{
|
|
88
|
+
const state = {
|
|
89
|
+
source: viz._x,
|
|
90
|
+
period: "month",
|
|
91
|
+
utc: false,
|
|
92
|
+
weekStart: 1,
|
|
93
|
+
cycleX: (d, i)=>{
|
|
94
|
+
const t = cycleDate(state.source(d, i), state.utc);
|
|
95
|
+
return t ? cycleStartOf(t, state.period, state.utc, state.weekStart) : NaN;
|
|
96
|
+
},
|
|
97
|
+
facet: (d, i)=>{
|
|
98
|
+
const t = cycleDate(state.source(d, i), state.utc);
|
|
99
|
+
return t ? cyclePeriodOf(t, state.period, state.utc) : undefined;
|
|
100
|
+
}
|
|
101
|
+
};
|
|
102
|
+
viz.ctx.cycle = state;
|
|
103
|
+
// The x axis places each cycle along its panel, labeling only the first
|
|
104
|
+
// and last (see `cycleFacet.ts`); the panel titles name the seasons.
|
|
105
|
+
viz._xConfig = assign({}, viz._xConfig ?? {}, {
|
|
106
|
+
padding: 0,
|
|
107
|
+
scale: "time"
|
|
108
|
+
});
|
|
109
|
+
// The y axis keeps its title beside its labels in a narrow first panel.
|
|
110
|
+
viz._yConfig = assign({}, viz._yConfig ?? {}, {
|
|
111
|
+
maxSize: Infinity
|
|
112
|
+
});
|
|
113
|
+
viz.schema.color = cycleColor(viz, viz.schema.color);
|
|
114
|
+
// The x axis plots every period of `time`, through its cycles.
|
|
115
|
+
viz._timeOnDiscrete = true;
|
|
116
|
+
viz._plotReferenceLines = ()=>cycleMeanLines(viz);
|
|
117
|
+
// Tooltips show each point's date, not the cycle it sits at.
|
|
118
|
+
viz._tooltipAxisLabel = (axis, d, i)=>cycleAxisLabel(viz, cycleTooltipContext(viz), axis, d, i);
|
|
119
|
+
viz.schema.facetConfig = {
|
|
120
|
+
padding: 0,
|
|
121
|
+
rows: 1,
|
|
122
|
+
sort: (a, b)=>cycleCompare(viz, a, b),
|
|
123
|
+
title: (value)=>cycleTitle(viz, value)
|
|
124
|
+
};
|
|
125
|
+
const preDraw = viz._preDraw.bind(viz);
|
|
126
|
+
viz._preDraw = ()=>{
|
|
127
|
+
prepareCycle(viz);
|
|
128
|
+
preDraw();
|
|
129
|
+
};
|
|
130
|
+
},
|
|
131
|
+
ctx: {},
|
|
132
|
+
fields: [
|
|
133
|
+
/** CyclePlot badges only the y axis on hover: the panel titles name the seasons. */ {
|
|
134
|
+
key: "axisHover",
|
|
135
|
+
default: "y"
|
|
136
|
+
},
|
|
137
|
+
/** CyclePlot names its series in the legend: lines in narrow panels leave no room to label them. */ {
|
|
138
|
+
key: "lineLabels",
|
|
139
|
+
default: false
|
|
140
|
+
},
|
|
141
|
+
/**
|
|
142
|
+
Draws a line across each panel at each series' mean over the
|
|
143
|
+
panel's cycles. On by default.
|
|
144
|
+
*/ {
|
|
145
|
+
key: "mean",
|
|
146
|
+
default: true
|
|
147
|
+
},
|
|
148
|
+
/**
|
|
149
|
+
Styles the `mean` lines like a `referenceLines` entry:
|
|
150
|
+
`stroke` (the chart's text color for one series, else each
|
|
151
|
+
series' color), `strokeOpacity` (`1`), `strokeWidth`, `dash`,
|
|
152
|
+
`label`, and `layer`.
|
|
153
|
+
@type {ReferenceLineConfig}
|
|
154
|
+
*/ {
|
|
155
|
+
key: "meanConfig",
|
|
156
|
+
merge: true,
|
|
157
|
+
default: {}
|
|
158
|
+
},
|
|
159
|
+
/**
|
|
160
|
+
The season each panel shows, read from each row's `x` date:
|
|
161
|
+
`"month"` (the default; one panel per month, plotted across the
|
|
162
|
+
years), `"quarter"` (across the years), `"weekday"` (across the
|
|
163
|
+
weeks, from the first day of the locale's week), or `"hour"`
|
|
164
|
+
(across the days).
|
|
165
|
+
@type {"month" | "quarter" | "weekday" | "hour"}
|
|
166
|
+
*/ {
|
|
167
|
+
key: "period",
|
|
168
|
+
default: "month"
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
key: "tooltipConfig",
|
|
172
|
+
merge: true,
|
|
173
|
+
factory: (viz)=>({
|
|
174
|
+
title: (d, i)=>cycleTooltipTitle(viz, cycleTooltipContext(viz), d, i),
|
|
175
|
+
tbody: (d, i)=>cycleTooltipRows(viz, cycleTooltipContext(viz), d, i)
|
|
176
|
+
})
|
|
177
|
+
}
|
|
178
|
+
]
|
|
179
|
+
};
|
|
180
|
+
/**
|
|
181
|
+
Creates a cycle plot (a seasonal subseries plot) from an array of data:
|
|
182
|
+
a LinePlot split into one panel per season, set side by side with no
|
|
183
|
+
gap between them. Each panel plots one season across the cycles in the
|
|
184
|
+
data, such as every January across the years, so a reader can compare
|
|
185
|
+
the seasons and see how each one changed. Each row's `x` value is its
|
|
186
|
+
date, and `period` picks the season: `"month"` (the default),
|
|
187
|
+
`"quarter"`, `"weekday"` (from the first day of the locale's week), or
|
|
188
|
+
`"hour"`. Rows in the same season and cycle merge into their mean (set
|
|
189
|
+
`aggs` for the `y` key to merge them otherwise). The panels share one y
|
|
190
|
+
axis, labeled on the left, each x axis labels its first and last cycle
|
|
191
|
+
(when both fit without overlapping), and each
|
|
192
|
+
draws a line at its mean (see `mean` and `meanConfig`). The panel titles
|
|
193
|
+
name the seasons in the chart's locale; read the dates in UTC with
|
|
194
|
+
`xConfig: {utc: true}`. The panels are small multiples whose `facet` is
|
|
195
|
+
the season, so `facetConfig` adjusts them (its `padding`, `title`, and
|
|
196
|
+
`titleConfig`).
|
|
197
|
+
*/ export default makeChart(cyclePlotDef, LinePlot);
|