@d3plus/core 4.10.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +167 -8
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +22 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +3 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +2 -1
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +14 -10
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +51 -16
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +86 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +5 -1
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +64 -31
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHoverScene.js +2 -1
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barWidth.js +59 -11
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +8 -2
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +18 -10
- package/es/src/charts/Plot/labelPlacement.js +1 -1
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/pipeline.js +66 -19
- package/es/src/charts/Plot/pipelineAxisLayout.js +5 -1
- package/es/src/charts/Plot/pipelineDomains.js +16 -3
- package/es/src/charts/Plot/pipelineLineLabels.js +144 -52
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +34 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +10 -5
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +2 -2
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -35
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +2 -3
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +16 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +3 -7
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +61 -28
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +72 -75
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +10 -2
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +17 -10
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +8 -1
- package/es/src/charts/events/mousemove.shape.js +5 -2
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +2 -1
- package/es/src/charts/features/axesFinal.js +3 -1
- package/es/src/charts/features/axesMeasure.js +7 -4
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +2 -1
- package/es/src/charts/features/colorScaleHover.js +3 -2
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +20 -6
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +38 -11
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +47 -31
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +2 -2
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +46 -3
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizPreDraw.js +5 -3
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +39 -36
- package/es/src/charts/viz/VizBase.js +18 -10
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +2 -1
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -3
- package/es/src/charts/viz/vizDefaults.js +15 -23
- package/es/src/charts/viz/vizFields.js +35 -0
- package/es/src/charts/viz/vizRender.js +43 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +6 -0
- 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 +4 -1
- package/es/src/components/Axis/axisDefaults.js +5 -9
- package/es/src/components/Axis/axisLayoutScale.js +7 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +15 -9
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +29 -65
- package/es/src/components/Timeline/Timeline.js +12 -3
- package/es/src/components/Timeline/timelineConfig.js +20 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +7 -3
- package/es/src/components/Tooltip.js +15 -5
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +1 -0
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/utils/BaseClass.js +25 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -11
- package/types/index.d.ts +6 -2
- package/types/internal.d.ts +250 -8
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +15 -8
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +14 -0
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +13 -0
- package/types/src/charts/definition/makeChart.d.ts +3 -2
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +3 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +4 -0
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +17 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +3 -1
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +16 -2
- package/types/src/charts/viz/VizBase.d.ts +6 -6
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +32 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +84 -7
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +1 -0
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +1 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +5 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Tooltip.d.ts +4 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +1 -0
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +981 -30
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +86811 -61031
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +28392 -6498
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -10,11 +10,16 @@
|
|
|
10
10
|
`vizDraw` via `runLayout(ctx, [...features])`.
|
|
11
11
|
*/ import { extent, sum } from "d3-array";
|
|
12
12
|
import { unique } from "@d3plus/data";
|
|
13
|
-
import { date, elem } from "@d3plus/dom";
|
|
13
|
+
import { date, elem, rtl as detectRTL } from "@d3plus/dom";
|
|
14
|
+
import { textBoxLines } from "../../components/textBoxScene.js";
|
|
14
15
|
import { wholeWordFit, wholeWords } from "../../utils/wholeWords.js";
|
|
15
16
|
import { zoomControlsBox, zoomControlsReach } from "../drawSteps/zoomControlsMarkup.js";
|
|
16
17
|
import { getTopLeftContributions } from "../drawSteps/topLeftControls.js";
|
|
17
18
|
import { topLeftControlsInset as topLeftControlsInsetRaw, topLeftControlsReach } from "../drawSteps/topLeftControlsMarkup.js";
|
|
19
|
+
import { effectiveDuration } from "../viz/reducedMotion.js";
|
|
20
|
+
import { timelineRangeBreaks } from "../Plot/plotRangeBreaks.js";
|
|
21
|
+
import { startingSelection } from "../pipeline/preDrawData.js";
|
|
22
|
+
import { classTimelineMode } from "../../components/Timeline/timelineMode.js";
|
|
18
23
|
const VALID_POSITIONS = new Set([
|
|
19
24
|
false,
|
|
20
25
|
"top",
|
|
@@ -113,7 +118,7 @@ const VALID_POSITIONS = new Set([
|
|
|
113
118
|
margin: claims
|
|
114
119
|
};
|
|
115
120
|
}
|
|
116
|
-
/**
|
|
121
|
+
/* --------------------------- text-block features --------------------------- */ /** A TextBox `_textData()` row, as the text-block features read it. */ /**
|
|
117
122
|
A little breathing room added to a NON-zero corner inset, on top of the
|
|
118
123
|
exact pixel width the corner panel measured at. Without it, content
|
|
119
124
|
insets to EXACTLY the corner box's edge — any tiny discrepancy between
|
|
@@ -300,11 +305,11 @@ const VALID_POSITIONS = new Set([
|
|
|
300
305
|
// the title sat at the top of its claim regardless, reading noticeably
|
|
301
306
|
// higher than the same-row zoom/back/search buttons beside it.
|
|
302
307
|
const y = layoutMargin.top + drop + blockPadding;
|
|
303
|
-
const
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
+
const rtl = detectRTL();
|
|
309
|
+
const placed = textBoxLines(box, width, rtl);
|
|
310
|
+
const lines = placed.lines.map((ln, i)=>({
|
|
311
|
+
...ln,
|
|
312
|
+
y: (i + 1) * lineHeight - (lineHeight - box.fS)
|
|
308
313
|
}));
|
|
309
314
|
const panel = {
|
|
310
315
|
type: "text",
|
|
@@ -315,8 +320,11 @@ const VALID_POSITIONS = new Set([
|
|
|
315
320
|
font: {
|
|
316
321
|
family: box.fF,
|
|
317
322
|
size: box.fS,
|
|
318
|
-
anchor:
|
|
319
|
-
baseline: "alphabetic"
|
|
323
|
+
anchor: placed.anchor,
|
|
324
|
+
baseline: "alphabetic",
|
|
325
|
+
...rtl ? {
|
|
326
|
+
dir: "rtl"
|
|
327
|
+
} : {}
|
|
320
328
|
},
|
|
321
329
|
paint: {
|
|
322
330
|
fill: box.fC,
|
|
@@ -416,14 +424,14 @@ const VALID_POSITIONS = new Set([
|
|
|
416
424
|
condition: timelinePossible,
|
|
417
425
|
enter: transform,
|
|
418
426
|
parent: viz._select,
|
|
419
|
-
duration: viz
|
|
427
|
+
duration: effectiveDuration(viz),
|
|
420
428
|
update: transform
|
|
421
429
|
}).node();
|
|
422
430
|
if (!timelinePossible) return {
|
|
423
431
|
panel: null,
|
|
424
432
|
margin: {}
|
|
425
433
|
};
|
|
426
|
-
const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(viz
|
|
434
|
+
const timeline = viz._timelineClass.renderMode("compute").domain(extent(ticks)).duration(effectiveDuration(viz)).height(viz.schema.height - layoutMargin.bottom).locale(viz.schema.locale).select(timelineGroup).ticks(ticks.sort((a, b)=>+a - +b)).width(viz.schema.width - (layoutMargin.left + layoutMargin.right + padding.left + padding.right));
|
|
427
435
|
// Clamp bound = the full time range (every tick); it never goes stale
|
|
428
436
|
// mid-render. Clamping to `viz._filteredData`'s extent instead collapsed a
|
|
429
437
|
// freshly-committed range down to the previous selection — the release
|
|
@@ -432,10 +440,10 @@ const VALID_POSITIONS = new Set([
|
|
|
432
440
|
if (!viz._timelineSelection) {
|
|
433
441
|
// First render only: default to the *filtered* extent, which the
|
|
434
442
|
// synthesized default timeFilter pins to the latest period (see
|
|
435
|
-
// vizPreDraw)
|
|
443
|
+
// vizPreDraw). `timelineDefault` or `timelineConfig.selection` overrides it.
|
|
436
444
|
// A row merged across periods holds each of their times.
|
|
437
445
|
const filtered = extent((viz._filteredData || []).flatMap((d, i)=>viz.schema.time(d, i)).map((d)=>date(d)));
|
|
438
|
-
viz._timelineSelection = viz
|
|
446
|
+
viz._timelineSelection = startingSelection(viz) || (filtered[0] ? filtered : fullExtent);
|
|
439
447
|
} else {
|
|
440
448
|
if (viz._timelineSelection[0] < fullExtent[0]) viz._timelineSelection[0] = fullExtent[0];
|
|
441
449
|
if (viz._timelineSelection[1] > fullExtent[1]) viz._timelineSelection[1] = fullExtent[1];
|
|
@@ -444,7 +452,16 @@ const VALID_POSITIONS = new Set([
|
|
|
444
452
|
// Repaint the scene when playback toggles without moving the selection
|
|
445
453
|
// (e.g. a manual pause), so the play/pause glyph refreshes immediately.
|
|
446
454
|
timeline._onPlayToggle = ()=>viz._scheduleSceneRepaint();
|
|
447
|
-
|
|
455
|
+
// The timeline hides what its time axis hides, unless `timelineConfig`
|
|
456
|
+
// sets its own `rangeBreaks`.
|
|
457
|
+
const inherited = timelineRangeBreaks(viz);
|
|
458
|
+
timeline.rangeBreaks(inherited.length ? inherited : false);
|
|
459
|
+
// `timelineConfig.selection` is where the timeline starts (see
|
|
460
|
+
// `startingSelection`); after that the viewer's selection stands.
|
|
461
|
+
const config = {
|
|
462
|
+
...viz.schema.timelineConfig
|
|
463
|
+
};
|
|
464
|
+
delete config.selection;
|
|
448
465
|
timeline.config(config).on("brush", (s)=>{
|
|
449
466
|
// Filter on "end", not on every brush move. Re-rendering the whole Viz
|
|
450
467
|
// mid-drag re-creates the d3-brush (and starts a brush transition),
|
|
@@ -458,6 +475,7 @@ const VALID_POSITIONS = new Set([
|
|
|
458
475
|
setTimeFilter(viz, s);
|
|
459
476
|
if (config.on && config.on.end) config.on.end(s);
|
|
460
477
|
}).render();
|
|
478
|
+
classTimelineMode(timelineGroup, "d3plus-viz-timeline", timeline._buttonBehaviorCurrent);
|
|
461
479
|
return {
|
|
462
480
|
panel: null,
|
|
463
481
|
margin: {
|
|
@@ -12,12 +12,23 @@ import { sanitizePosition, sideControlsDrop } from "./features.js";
|
|
|
12
12
|
import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
|
|
13
13
|
import { facetKey } from "../facet/facetData.js";
|
|
14
14
|
import { colorScaleBucketRows } from "./colorScaleBucket.js";
|
|
15
|
+
import { colorScaleValue, linkColorScaleRows } from "./colorScaleValue.js";
|
|
15
16
|
import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
|
|
17
|
+
import { effectiveDuration } from "../viz/reducedMotion.js";
|
|
16
18
|
/**
|
|
17
19
|
The colorScale's data: the chart's data rolled up per time/id (and per
|
|
18
20
|
small-multiples panel, the values the panels color by), keeping rows with
|
|
19
|
-
a colorScale value.
|
|
21
|
+
a colorScale value, then any links colored by number.
|
|
20
22
|
*/ function colorScaleData(viz) {
|
|
23
|
+
const links = linkColorScaleRows(viz);
|
|
24
|
+
if (typeof viz.schema.colorScale !== "function") return links;
|
|
25
|
+
const own = viz._colorScaleRows ? viz._colorScaleRows() : dataRows(viz);
|
|
26
|
+
return links.length ? [
|
|
27
|
+
...own,
|
|
28
|
+
...links
|
|
29
|
+
] : own;
|
|
30
|
+
}
|
|
31
|
+
/** The chart's data rolled up per time/id/panel, keeping rows with a colorScale value. */ function dataRows(viz) {
|
|
21
32
|
const facet = viz.schema.facet;
|
|
22
33
|
const data = Array.from(rollup(viz._data, (leaves)=>merge(leaves, viz.schema.aggs), (d, i)=>`${viz.schema.time ? viz.schema.time(d, i) : "all"}-${facet ? facetKey(facet(d, i)) : "all"}-${viz._ids(d, i).join("_")}`).values());
|
|
23
34
|
return data.filter((d, i)=>{
|
|
@@ -77,10 +88,13 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
|
|
|
77
88
|
duration: 0,
|
|
78
89
|
update: transform
|
|
79
90
|
}).node();
|
|
80
|
-
|
|
81
|
-
|
|
91
|
+
const value = colorScaleValue(viz);
|
|
92
|
+
if (!value) return;
|
|
93
|
+
viz._colorScaleClass.renderMode("compute").align(frame.align).duration(effectiveDuration(viz)).data(colorScaleData(viz)).height(frame.height).locale(viz.schema.locale).orient(frame.orient).select(scaleGroup).value(value).width(frame.width).legendConfig({
|
|
82
94
|
shapeConfig: bucketSwatchConfig(viz)
|
|
83
|
-
})
|
|
95
|
+
})// Links colored by number are thin lines: keep the ramp's low end
|
|
96
|
+
// visible against a light background.
|
|
97
|
+
.ordinalRamp(linkColorScaleRows(viz).length > 0).config(viz.schema.colorScaleConfig).hover(false).render();
|
|
84
98
|
}
|
|
85
99
|
/** The colorScale's sanitized position side (false when hidden). */ function colorScalePosition(viz) {
|
|
86
100
|
return sanitizePosition(viz.schema.colorScalePosition.bind(viz)(resolveSpec(viz)), viz);
|
|
@@ -91,7 +105,7 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
|
|
|
91
105
|
horizontally (`"row"`), sized against the chart area `area`. Returns its
|
|
92
106
|
measured size, or null when it isn't showing.
|
|
93
107
|
*/ export function paintColorScaleInset(viz, orient, area) {
|
|
94
|
-
const show = Boolean(viz
|
|
108
|
+
const show = Boolean(colorScaleValue(viz)) && colorScalePosition(viz) !== false && !viz.schema.colorScaleConfig.select;
|
|
95
109
|
const frame = insetFrame(orient, area);
|
|
96
110
|
const maxSize = viz.schema.colorScaleMaxSize;
|
|
97
111
|
paintColorScale(viz, {
|
|
@@ -146,7 +160,7 @@ import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
|
|
|
146
160
|
"top",
|
|
147
161
|
"bottom"
|
|
148
162
|
].includes(position);
|
|
149
|
-
const showColorScale = viz
|
|
163
|
+
const showColorScale = colorScaleValue(viz) && position;
|
|
150
164
|
const padding = viz.schema.colorScalePadding(viz) ? viz._padding : {
|
|
151
165
|
top: 0,
|
|
152
166
|
right: 0,
|
|
@@ -6,43 +6,34 @@
|
|
|
6
6
|
*/ import { merge } from "@d3plus/data";
|
|
7
7
|
import { elem } from "@d3plus/dom";
|
|
8
8
|
import { configPrep } from "../../utils/index.js";
|
|
9
|
+
import { constantValue } from "../../utils/constant.js";
|
|
9
10
|
import { cornerPlacements, sanitizePosition, sideControlsDrop } from "./features.js";
|
|
10
11
|
import { bottomRightClearance } from "../drawSteps/bottomRightControlsMarkup.js";
|
|
11
12
|
import { resolveSpec } from "../pipeline/resolveSpec.js";
|
|
12
13
|
import { insetFrame, insetOrient, isInsetPending } from "./insetState.js";
|
|
13
14
|
import { legendCategories, legendMergesIds } from "./legendCategory.js";
|
|
15
|
+
import { legendKeys, legendRows } from "./legendKeys.js";
|
|
16
|
+
import { effectiveDuration } from "../viz/reducedMotion.js";
|
|
14
17
|
/**
|
|
15
18
|
Rolls filtered legend data up by paint attributes, computes
|
|
16
19
|
`viz._legendDepth` (the lowest groupBy level whose values are unique) and
|
|
17
20
|
`viz._legendCategories` (see `legendCategory.ts`), then sorts it.
|
|
18
21
|
Returns the `legendData` array plus the `fill`/`getAttr` accessors the
|
|
19
|
-
render step reuses.
|
|
22
|
+
render step reuses. A legend set to a constant false (`legend(false)`)
|
|
23
|
+
gets no entries, and its depth and categories stay as they were.
|
|
20
24
|
*/ export function buildLegendData(viz) {
|
|
21
25
|
// Source: `_legendData` from the rollupAndFilter pipeline stage — same
|
|
22
26
|
// arg drawLegend received via `drawLegend.bind(this)(this._legendData)`.
|
|
23
|
-
const
|
|
24
|
-
const getAttr = (d, i, attr)=>{
|
|
25
|
-
const shape = viz.schema.shape(d, i);
|
|
26
|
-
if (attr === "fill" && shape === "Line") attr = "stroke";
|
|
27
|
-
const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
|
|
28
|
-
return typeof value === "function" ? value.bind(viz)(d, i) : value;
|
|
29
|
-
};
|
|
30
|
-
// Legend grouping key: the color *encoding* input, so categories keep their
|
|
31
|
-
// own entry even when two resolve to the same hex (#788), while
|
|
32
|
-
// opacity/texture still split entries that differ on those secondary
|
|
33
|
-
// encodings. Falls back to the resolved fill when there's no color accessor
|
|
34
|
-
// to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
|
|
35
|
-
const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
|
|
36
|
-
const keyOf = (d, i, c)=>{
|
|
37
|
-
const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
|
|
38
|
-
return [
|
|
39
|
-
colorKey,
|
|
40
|
-
getAttr(d, i, "opacity"),
|
|
41
|
-
getAttr(d, i, "texture")
|
|
42
|
-
].join("_");
|
|
43
|
-
};
|
|
27
|
+
const { getAttr, colorOf, keyOf } = legendKeys(viz);
|
|
44
28
|
const legendKey = (d, i)=>keyOf(d, i, colorOf(d, i));
|
|
45
|
-
|
|
29
|
+
// A legend set to a constant false never shows, so it needs no entries.
|
|
30
|
+
const never = constantValue(viz.schema.legend);
|
|
31
|
+
if (never && !never.value) return {
|
|
32
|
+
legendData: [],
|
|
33
|
+
legendKey,
|
|
34
|
+
getAttr
|
|
35
|
+
};
|
|
36
|
+
const rollupData = legendRows(viz);
|
|
46
37
|
const groups = new Map();
|
|
47
38
|
rollupData.forEach((d, i)=>{
|
|
48
39
|
const c = colorOf(d, i);
|
|
@@ -129,7 +120,7 @@ import { legendCategories, legendMergesIds } from "./legendCategory.js";
|
|
|
129
120
|
duration: 0,
|
|
130
121
|
update: transform
|
|
131
122
|
}).node();
|
|
132
|
-
viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(viz
|
|
123
|
+
viz._legendClass.renderMode("compute").id(legendKey).align(frame.align).direction(frame.direction).duration(effectiveDuration(viz)).data(frame.visible ? legendData : []).height(frame.height).locale(viz.schema.locale).parent(viz).select(legendGroup).shape((d, i)=>{
|
|
133
124
|
const shape = viz.schema.shape(d, i);
|
|
134
125
|
return shape === "Circle" || shape === "Line" ? shape : "Rect";
|
|
135
126
|
}).verticalAlign(frame.verticalAlign).width(frame.width).shapeConfig(configPrep.bind(viz)(viz.schema.shapeConfig, "legend")).shapeConfig({
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
How the legend groups rows into entries: by the color each row encodes,
|
|
3
|
+
its opacity and its texture.
|
|
4
|
+
*/ import { constantValue } from "../../utils/constant.js";
|
|
5
|
+
/**
|
|
6
|
+
The legend's key functions for a chart.
|
|
7
|
+
@param viz The chart.
|
|
8
|
+
*/ export function legendKeys(viz) {
|
|
9
|
+
const getAttr = (d, i, attr)=>{
|
|
10
|
+
const shape = viz.schema.shape(d, i);
|
|
11
|
+
if (attr === "fill" && shape === "Line") attr = "stroke";
|
|
12
|
+
const value = viz.schema.shapeConfig[shape] && viz.schema.shapeConfig[shape][attr] ? viz.schema.shapeConfig[shape][attr] : viz.schema.shapeConfig[attr];
|
|
13
|
+
return typeof value === "function" ? value.bind(viz)(d, i) : value;
|
|
14
|
+
};
|
|
15
|
+
// Legend grouping key: the color *encoding* input, so categories keep their
|
|
16
|
+
// own entry even when two resolve to the same hex (#788), while
|
|
17
|
+
// opacity/texture still split entries that differ on those secondary
|
|
18
|
+
// encodings. Falls back to the resolved fill when there's no color accessor
|
|
19
|
+
// to key on (e.g. `.color(false)` with a custom `shapeConfig.fill`).
|
|
20
|
+
const colorOf = (d, i)=>typeof viz.schema.color === "function" ? viz.schema.color(d, i) : undefined;
|
|
21
|
+
const keyOf = (d, i, c)=>{
|
|
22
|
+
const colorKey = c === undefined || c === null ? getAttr(d, i, "fill") : typeof c === "string" ? c : JSON.stringify(c);
|
|
23
|
+
return [
|
|
24
|
+
colorKey,
|
|
25
|
+
getAttr(d, i, "opacity"),
|
|
26
|
+
getAttr(d, i, "texture")
|
|
27
|
+
].join("_");
|
|
28
|
+
};
|
|
29
|
+
return {
|
|
30
|
+
getAttr,
|
|
31
|
+
colorOf,
|
|
32
|
+
keyOf
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
The rows the legend rolls up: `_legendData`, less the rows a colorScale
|
|
37
|
+
colors.
|
|
38
|
+
@param viz The chart.
|
|
39
|
+
*/ export function legendRows(viz) {
|
|
40
|
+
const data = viz._legendData || [];
|
|
41
|
+
return viz.schema.colorScale ? data.filter((d, i)=>viz.schema.colorScale(d, i) === undefined) : data;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
How many entries the legend has (the number `buildLegendData` rolls its
|
|
45
|
+
rows into), counting no further than `limit + 1`: enough to tell whether
|
|
46
|
+
there are more than `limit`. A legend set to a constant false has none.
|
|
47
|
+
@param viz The chart.
|
|
48
|
+
@param limit The count past which to stop.
|
|
49
|
+
*/ export function legendEntryCount(viz, limit = Infinity) {
|
|
50
|
+
const never = constantValue(viz.schema.legend);
|
|
51
|
+
if (never && !never.value) return 0;
|
|
52
|
+
const { colorOf, keyOf } = legendKeys(viz);
|
|
53
|
+
const keys = new Set();
|
|
54
|
+
const data = viz._legendData || [];
|
|
55
|
+
const scaled = Boolean(viz.schema.colorScale);
|
|
56
|
+
let j = 0;
|
|
57
|
+
for(let i = 0; i < data.length && keys.size <= limit; i++){
|
|
58
|
+
const d = data[i];
|
|
59
|
+
if (scaled && viz.schema.colorScale(d, i) !== undefined) continue;
|
|
60
|
+
keys.add(keyOf(d, j, colorOf(d, j)));
|
|
61
|
+
j++;
|
|
62
|
+
}
|
|
63
|
+
return keys.size;
|
|
64
|
+
}
|
|
@@ -2,82 +2,91 @@
|
|
|
2
2
|
Line-label collision resolution + connector emit for the Plot paint phase.
|
|
3
3
|
|
|
4
4
|
Plot's `lineLabels` feature draws a label at the end of each series line.
|
|
5
|
-
When several series end at nearby y positions the labels overlap,
|
|
6
|
-
are
|
|
7
|
-
links each
|
|
5
|
+
When several series end at nearby y positions the labels would overlap,
|
|
6
|
+
so they are spread apart until none do; a thin connector line then
|
|
7
|
+
links each moved label back to its true series position.
|
|
8
|
+
|
|
9
|
+
Labels at a line's left end (`lineLabels: "start"` or `"both"`) are
|
|
10
|
+
placed the same way, apart from the right-end labels.
|
|
8
11
|
|
|
9
12
|
The measure half (which series get labels + their widths) lives upstream
|
|
10
13
|
as the `measurePlotLineLabels` pipeline stage. This module owns the two
|
|
11
14
|
remaining pieces:
|
|
12
15
|
|
|
13
|
-
- `bumpLineLabels` — resolve overlaps, returning the id→
|
|
14
|
-
- `emitLineLabelConnectors` — draw the connector lines for
|
|
16
|
+
- `bumpLineLabels` — resolve overlaps, returning the id→moved-y map.
|
|
17
|
+
- `emitLineLabelConnectors` — draw the connector lines for moved labels.
|
|
15
18
|
|
|
16
19
|
This is Plot-family-specific (it depends on Line series + the rendered
|
|
17
20
|
y-axis position function), not a generic cross-viz feature.
|
|
18
21
|
|
|
19
22
|
@module
|
|
20
|
-
*/ import { groups
|
|
23
|
+
*/ import { groups } from "d3-array";
|
|
21
24
|
import { assign } from "@d3plus/dom";
|
|
25
|
+
import { lineLabelKey } from "../Plot/lineLabelSides.js";
|
|
26
|
+
import { spreadLabelPositions } from "../Plot/lineLabelSpread.js";
|
|
22
27
|
import { collectComputed, makeShape } from "./emitHelpers.js";
|
|
28
|
+
/** A label's height, as a multiple of its font size, when spread apart. */ const LABEL_LINE_HEIGHT = 1.2;
|
|
23
29
|
/**
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
`
|
|
30
|
-
*/
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
if (y - fontSize / 2 - padding < prevY) {
|
|
45
|
-
const newY = yBuckets.find((n)=>n < prevY);
|
|
46
|
-
const change = d.defaultY - newY;
|
|
47
|
-
if (change < bumpLimit) {
|
|
48
|
-
prev.newY = newY;
|
|
49
|
-
if (i) bumpPrevious(prev, i - 1, arr);
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
}
|
|
30
|
+
Spreads one group of labels (one end, one x value) apart so none
|
|
31
|
+
overlap, each as close to its series as the others allow (see
|
|
32
|
+
`spreadLabelPositions`), and sets `newY` on each label that moved. When
|
|
33
|
+
the plot is too short for them all, the labels that fit keep their
|
|
34
|
+
places, the last of them reads "+N more" for itself and the rest
|
|
35
|
+
(`collapsed`), and the rest are hidden.
|
|
36
|
+
*/ function spreadGroup(viz, values, yRange) {
|
|
37
|
+
const sorted = values.map((d)=>{
|
|
38
|
+
if (!d.defaultY) d.defaultY = viz._yAxis._getPosition(d.value);
|
|
39
|
+
return d;
|
|
40
|
+
}).sort((a, b)=>a.defaultY - b.defaultY);
|
|
41
|
+
const positions = spreadLabelPositions(sorted.map((d)=>d.defaultY), sorted.map((d)=>d.fontSize * LABEL_LINE_HEIGHT), yRange);
|
|
42
|
+
const bottom = Math.max(...yRange) + 0.5;
|
|
43
|
+
const fit = positions.filter((y)=>y <= bottom).length;
|
|
44
|
+
sorted.forEach((d, i)=>{
|
|
45
|
+
if (fit < sorted.length && i >= fit - 1) {
|
|
46
|
+
if (i === fit - 1) d.collapsed = sorted.length - i;
|
|
47
|
+
else {
|
|
48
|
+
d.hidden = true;
|
|
49
|
+
return;
|
|
53
50
|
}
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
51
|
+
}
|
|
52
|
+
if (Math.abs(positions[i] - d.defaultY) > 0.5) d.newY = positions[i];
|
|
53
|
+
});
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
Resolve label overlaps within each x-group, each end of the lines on its
|
|
57
|
+
own: labels are spread apart until none overlap (see `spreadGroup`).
|
|
58
|
+
Mutates each `LabelWidth`'s `newY`/`defaultY` in place and returns the
|
|
59
|
+
moved-y map, keyed by `lineLabelKey`, that the Line emitter and
|
|
60
|
+
connector emit read. Must run AFTER the production y-axis has rendered:
|
|
61
|
+
it reads `viz._yAxis._getPosition`.
|
|
62
|
+
*/ export function bumpLineLabels(viz, labelWidths, yRange) {
|
|
63
|
+
if (!labelWidths) return {};
|
|
64
|
+
groups(labelWidths, (d)=>d.side ?? "end", (d)=>d.xValue).forEach(([, xGroups])=>xGroups.forEach(([, values])=>spreadGroup(viz, values, yRange)));
|
|
65
|
+
return labelWidths.reduce((obj, d)=>{
|
|
66
|
+
if (d.newY) obj[lineLabelKey(d.side, d.id)] = d.newY;
|
|
67
|
+
return obj;
|
|
68
|
+
}, {});
|
|
62
69
|
}
|
|
63
70
|
/**
|
|
64
71
|
Emit the connector lines for labels that were bumped (`newY` set). Each
|
|
65
72
|
connector runs from the label's true series position to its bumped
|
|
66
|
-
position. Returns the compute-mode scene nodes (empty when nothing was
|
|
73
|
+
position, rightward for a right-end label and leftward for a left-end one. Returns the compute-mode scene nodes (empty when nothing was
|
|
67
74
|
bumped). Coords are relative to `_chartTransform`, which the chart-cells
|
|
68
75
|
group applies.
|
|
69
76
|
*/ export function emitLineLabelConnectors(viz, labelWidths) {
|
|
70
|
-
const labelConnectors = labelWidths.filter((d)=>d.newY !== undefined);
|
|
77
|
+
const labelConnectors = labelWidths.filter((d)=>d.newY !== undefined && !d.hidden);
|
|
71
78
|
if (!labelConnectors.length) return [];
|
|
72
79
|
const data = labelConnectors.map((d)=>assign({
|
|
73
80
|
x: viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue),
|
|
74
81
|
y: d.defaultY
|
|
75
82
|
}, d)).concat(labelConnectors.map((d)=>assign({
|
|
76
|
-
x: viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) + d.padding - 1,
|
|
83
|
+
x: d.side === "start" ? viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) - d.padding + 1 : viz._xAxis._getPosition.bind(viz._xAxis)(d.xValue) + d.padding - 1,
|
|
77
84
|
y: d.newY || d.defaultY
|
|
78
85
|
}, d)));
|
|
79
86
|
const connectorLine = makeShape("Line").config({
|
|
80
87
|
data: data,
|
|
88
|
+
// Each label's connector is its own line, the two ends of a series apart.
|
|
89
|
+
id: (d)=>d.side === "start" ? lineLabelKey("start", d.id) : d.id,
|
|
81
90
|
stroke: (d)=>d.fontColor,
|
|
82
91
|
x: (d)=>d.x,
|
|
83
92
|
y: (d)=>d.y
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkBundle` for a chart's links: bundles their straight runs (see
|
|
3
|
+
`bundleEdges`) with the chart's `linkBundleConfig`, through a cache kept
|
|
4
|
+
on the chart, so a redraw with the links where they were reuses the
|
|
5
|
+
last bundling.
|
|
6
|
+
*/ import { bundleEdges, edgeBundleCache } from "./edgeBundling.js";
|
|
7
|
+
/** The chart's bundling cache, created on first use. */ export function linkBundleCache(viz) {
|
|
8
|
+
const cache = viz.ctx.linkBundleCache;
|
|
9
|
+
if (cache) return cache;
|
|
10
|
+
const created = edgeBundleCache();
|
|
11
|
+
viz.ctx.linkBundleCache = created;
|
|
12
|
+
return created;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
Each edge's bundled path, from its source to its target, with the
|
|
16
|
+
chart's `linkBundleConfig`.
|
|
17
|
+
*/ export function bundleLinkPaths(viz, edges) {
|
|
18
|
+
return bundleEdges(edges, viz.schema.linkBundleConfig ?? {}, linkBundleCache(viz));
|
|
19
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkColor` on the node-link charts (Network, Rings, Sankey, ArcDiagram):
|
|
3
|
+
each link's stroke, from one of its end nodes or from a value on the
|
|
4
|
+
link. Arrowheads take their link's stroke.
|
|
5
|
+
*/ import { colorAssign } from "@d3plus/color";
|
|
6
|
+
import { color } from "d3-color";
|
|
7
|
+
import { fieldAccessor } from "../../utils/fieldAccessor.js";
|
|
8
|
+
import { linkedColorDefaults } from "../viz/linkGroup.js";
|
|
9
|
+
import { colorScaleColor, isScaleValue, noteLinkValue } from "./colorScaleValue.js";
|
|
10
|
+
import { resolveAccessor, shapeConfigFor } from "./emitHelpers.js";
|
|
11
|
+
import { linkMeta } from "./linkInteraction.js";
|
|
12
|
+
/**
|
|
13
|
+
Stores a `linkColor` value: `"source"` and `"target"` as given, a falsy
|
|
14
|
+
value as `false`, a function as given, and any other string as a key
|
|
15
|
+
read from each link.
|
|
16
|
+
*/ export function coerceLinkColor(value) {
|
|
17
|
+
if (!value) return false;
|
|
18
|
+
if (value === "source" || value === "target" || typeof value === "function") return value;
|
|
19
|
+
return fieldAccessor(value);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
The datum a drawn link carries (see `makeLinkDatum`), or the link itself
|
|
23
|
+
when it has none, and the link's index in `links` (else `i`).
|
|
24
|
+
*/ export function linkRow(link, i) {
|
|
25
|
+
const row = link.datum ?? link;
|
|
26
|
+
return {
|
|
27
|
+
row,
|
|
28
|
+
index: linkMeta(row)?.index ?? i
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
The color a link's value gives it: a number through the chart's
|
|
33
|
+
colorScale, a string as a literal color when it parses as one or as a
|
|
34
|
+
category in the chart's categorical palette (the way `color` colors
|
|
35
|
+
nodes), and nothing for any other value.
|
|
36
|
+
*/ export function linkValueColor(viz, value) {
|
|
37
|
+
if (isScaleValue(value)) {
|
|
38
|
+
const c = colorScaleColor(viz, value);
|
|
39
|
+
return typeof c === "string" ? c : undefined;
|
|
40
|
+
}
|
|
41
|
+
if (typeof value !== "string" || value === "") return undefined;
|
|
42
|
+
if (color(value)) return value;
|
|
43
|
+
return colorAssign(value, linkedColorDefaults(viz));
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
Builds the chart's link stroke resolver for one draw: given a link's
|
|
47
|
+
datum (and its drawn ends, for their shape kinds), the stroke
|
|
48
|
+
`linkColor` gives it, or undefined to keep the link's
|
|
49
|
+
`shapeConfig.Path` stroke. Links colored by number are noted for the
|
|
50
|
+
colorScale.
|
|
51
|
+
*/ export function linkColorResolver(viz) {
|
|
52
|
+
const setting = viz.schema.linkColor;
|
|
53
|
+
if (!setting) return ()=>undefined;
|
|
54
|
+
if (setting === "source" || setting === "target") {
|
|
55
|
+
const configs = new Map();
|
|
56
|
+
return (datum, drawn)=>{
|
|
57
|
+
const end = linkMeta(datum)?.[setting];
|
|
58
|
+
if (!end) return undefined;
|
|
59
|
+
const kind = drawn?.[setting]?.shape;
|
|
60
|
+
const shape = typeof kind === "string" ? kind : "Circle";
|
|
61
|
+
if (!configs.has(shape)) configs.set(shape, shapeConfigFor(viz, shape));
|
|
62
|
+
const fill = resolveAccessor(configs.get(shape).fill, end.data, end.i);
|
|
63
|
+
return typeof fill === "string" ? fill : undefined;
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
if (typeof setting !== "function") return ()=>undefined;
|
|
67
|
+
return (datum)=>{
|
|
68
|
+
const value = setting(datum, linkMeta(datum)?.index ?? 0);
|
|
69
|
+
if (isScaleValue(value)) noteLinkValue(viz, datum, value);
|
|
70
|
+
return linkValueColor(viz, value);
|
|
71
|
+
};
|
|
72
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The link color and label config the node-link charts (Network, Rings,
|
|
3
|
+
Sankey, ArcDiagram) share, and the widest-link and link bundling fields
|
|
4
|
+
Network and Geomap share.
|
|
5
|
+
*/ import { optionalAccessor } from "../viz/vizFields.js";
|
|
6
|
+
import { EDGE_BUNDLE_DEFAULTS } from "./edgeBundling.js";
|
|
7
|
+
import { coerceLinkColor } from "./linkColor.js";
|
|
8
|
+
import { LINK_LABEL_DEFAULTS } from "./linkLabels.js";
|
|
9
|
+
/** The `linkColor`, `linkLabel`, and `linkLabelConfig` fields. */ export function linkStyleFields() {
|
|
10
|
+
return [
|
|
11
|
+
/**
|
|
12
|
+
Colors each link: `"source"` or `"target"` takes that end node's
|
|
13
|
+
color, and a key or accessor function reads a value from each link
|
|
14
|
+
(receiving the link and its index in `links`). A number is colored
|
|
15
|
+
on the chart's colorScale, which then shows the links' values; a
|
|
16
|
+
string is a color when it parses as one, or else a category in the
|
|
17
|
+
chart's palette. `false` (the default) draws every link in the
|
|
18
|
+
theme's link gray.
|
|
19
|
+
@type {false | "source" | "target" | string | function}
|
|
20
|
+
*/ {
|
|
21
|
+
key: "linkColor",
|
|
22
|
+
default: false,
|
|
23
|
+
coerce: coerceLinkColor
|
|
24
|
+
},
|
|
25
|
+
/**
|
|
26
|
+
Text drawn at the middle of each link: a key or accessor function
|
|
27
|
+
(receiving the link and its index in `links`). Numbers are
|
|
28
|
+
abbreviated in the chart's locale. Labels that would cover a node
|
|
29
|
+
or another label are hidden. Defaults to none.
|
|
30
|
+
@type {string | function}
|
|
31
|
+
*/ {
|
|
32
|
+
key: "linkLabel",
|
|
33
|
+
coerce: optionalAccessor
|
|
34
|
+
},
|
|
35
|
+
/**
|
|
36
|
+
Styles the link labels: `rotate`, `"along"` (the default) to run
|
|
37
|
+
text along its link, kept upright, or `"horizontal"`; `fontSize`
|
|
38
|
+
(10); `padding`, the pad around the text (2); `backgroundOpacity`,
|
|
39
|
+
the opacity of that pad in the chart's background color (0.85);
|
|
40
|
+
`minRadius`, the tightest bend a curved label follows, as a radius
|
|
41
|
+
in ems (2); and any other TextBox setting, such as `fontColor`,
|
|
42
|
+
`fontFamily`, or `fontWeight`.
|
|
43
|
+
*/ {
|
|
44
|
+
key: "linkLabelConfig",
|
|
45
|
+
merge: true,
|
|
46
|
+
default: {
|
|
47
|
+
...LINK_LABEL_DEFAULTS
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
];
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
The `linkSizeMax` field: the widest link, in pixels, when `linkSize`
|
|
54
|
+
values differ. `fallback` is the chart's default; without one the
|
|
55
|
+
chart works the width out (see `linkWidthRange`).
|
|
56
|
+
*/ export function linkSizeMaxField(fallback) {
|
|
57
|
+
return fallback === undefined ? {
|
|
58
|
+
key: "linkSizeMax"
|
|
59
|
+
} : {
|
|
60
|
+
key: "linkSizeMax",
|
|
61
|
+
default: fallback
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
/** The `linkBundle` and `linkBundleConfig` fields (Network and Geomap). */ export function linkBundleFields() {
|
|
65
|
+
return [
|
|
66
|
+
/**
|
|
67
|
+
Bundles the links: links running the same way near each other are
|
|
68
|
+
drawn pulled together, so the main flows read through the clutter.
|
|
69
|
+
Defaults to `false`.
|
|
70
|
+
@type {boolean}
|
|
71
|
+
*/ {
|
|
72
|
+
key: "linkBundle",
|
|
73
|
+
default: false
|
|
74
|
+
},
|
|
75
|
+
/**
|
|
76
|
+
Tunes `linkBundle`: `strength` (0.85), `cycles` (6), `iterations`
|
|
77
|
+
(50), `compatibility` (0.4), and `smoothing` (true).
|
|
78
|
+
*/ {
|
|
79
|
+
key: "linkBundleConfig",
|
|
80
|
+
merge: true,
|
|
81
|
+
default: {
|
|
82
|
+
...EDGE_BUNDLE_DEFAULTS
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
];
|
|
86
|
+
}
|