@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
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
BubbleChart's Circle emitter: Plot's own, with the bubbles repainted
|
|
3
|
+
largest first, so smaller bubbles paint (and hit-test) over the larger
|
|
4
|
+
ones they overlap.
|
|
5
|
+
*/
|
|
6
|
+
import type { SceneNode } from "@d3plus/render";
|
|
7
|
+
import { type ShapeEmitter } from "../features/shapeEmit.js";
|
|
8
|
+
/**
|
|
9
|
+
The nodes with each circle, and the nodes keyed to it (its hit area),
|
|
10
|
+
reordered largest radius first. Circles of equal radius keep their
|
|
11
|
+
order, and every other node (labels, …) keeps its place.
|
|
12
|
+
@param nodes A Circle shape's scene nodes, in data order.
|
|
13
|
+
*/
|
|
14
|
+
export declare function largestFirst(nodes: SceneNode[]): SceneNode[];
|
|
15
|
+
/**
|
|
16
|
+
Plot's Circle emitter, drawing the bubbles largest first. The rows are
|
|
17
|
+
emitted in data order, so each series takes the color it would in a
|
|
18
|
+
Scatter; only the painted nodes are reordered.
|
|
19
|
+
*/
|
|
20
|
+
export declare const bubbleEmit: ShapeEmitter;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
BubbleChart — a Scatter whose points are sized by `size`, by area.
|
|
3
|
+
*/
|
|
4
|
+
import type { ChartDefinition } from "../definition/ChartDefinition.js";
|
|
5
|
+
export declare const bubbleChartDef: ChartDefinition;
|
|
6
|
+
/**
|
|
7
|
+
Creates a bubble chart from an array of data: each row draws as a circle
|
|
8
|
+
at its `x` and `y` values, sized by its `size` value. Bubbles are sized by
|
|
9
|
+
area (`sizeZero` with a `"sqrt"` `sizeScale`): a value twice as large
|
|
10
|
+
draws a bubble with twice the area, and the largest draws at `sizeMax`
|
|
11
|
+
pixels in radius. A size legend keys the sizes, larger bubbles are drawn
|
|
12
|
+
first so smaller ones stay on top, and each bubble is outlined in the
|
|
13
|
+
chart's background color so overlapping bubbles stay distinct.
|
|
14
|
+
*/
|
|
15
|
+
declare const _default: new () => any;
|
|
16
|
+
export default _default;
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
*/
|
|
11
11
|
import type { Chord, ChordGroup, Chords } from "d3-chord";
|
|
12
12
|
import type { DataPoint } from "@d3plus/data";
|
|
13
|
+
import type { RingLabelFit } from "../features/ringLabels.js";
|
|
13
14
|
import type { TransformStage } from "../pipeline/stages.js";
|
|
14
15
|
/** A single laid-out Chord node (group), accreted across the layout passes. */
|
|
15
16
|
export interface ChordNode {
|
|
@@ -32,6 +33,8 @@ export interface ChordNode {
|
|
|
32
33
|
width: number;
|
|
33
34
|
height: number;
|
|
34
35
|
};
|
|
36
|
+
/** The curve the label follows, when it curves (see `labelPosition`). */
|
|
37
|
+
labelCurve?: RingLabelFit;
|
|
35
38
|
}
|
|
36
39
|
/** Everything `chordEmit` needs, stashed on `viz.ctx.chordCtx`. */
|
|
37
40
|
export interface ChordCtx {
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Chord group labels (see `labelPosition`): each group's name curves just
|
|
3
|
+
outside its arc, following the ring, or turns along its spoke, reading
|
|
4
|
+
outward. Curved names need only a line of room around the ring, so when
|
|
5
|
+
every name fits along its arc the ring grows into the band the spoke
|
|
6
|
+
labels would need.
|
|
7
|
+
*/
|
|
8
|
+
import type { ChordGroup } from "d3-chord";
|
|
9
|
+
import type { DataPoint } from "@d3plus/data";
|
|
10
|
+
import type { RingLabelFit } from "../features/ringLabels.js";
|
|
11
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
12
|
+
/** The gap between the ring and its labels, in pixels. */
|
|
13
|
+
export declare const CHORD_LABEL_PADDING = 4;
|
|
14
|
+
/** The label font size, curved or along a spoke, when the Path labelConfig sets none. */
|
|
15
|
+
export declare const CHORD_LABEL_FONT_SIZE = 11;
|
|
16
|
+
/** What placing a group's label needs: its id, row, index, and arc. */
|
|
17
|
+
export interface ChordLabelNode {
|
|
18
|
+
data: DataPoint;
|
|
19
|
+
i: number;
|
|
20
|
+
group?: ChordGroup;
|
|
21
|
+
labelX?: number;
|
|
22
|
+
labelY?: number;
|
|
23
|
+
labelRotate?: number;
|
|
24
|
+
labelAnchor?: "start" | "end";
|
|
25
|
+
labelBounds?: {
|
|
26
|
+
x: number;
|
|
27
|
+
y: number;
|
|
28
|
+
width: number;
|
|
29
|
+
height: number;
|
|
30
|
+
};
|
|
31
|
+
/** The curve the label follows, when it curves. */
|
|
32
|
+
labelCurve?: RingLabelFit;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
The labels' font size: the Path labelConfig's `fontSize`, else
|
|
36
|
+
`CHORD_LABEL_FONT_SIZE`.
|
|
37
|
+
@param viz The chart.
|
|
38
|
+
*/
|
|
39
|
+
export declare function chordLabelFontSize(viz: VizInstance): number;
|
|
40
|
+
/**
|
|
41
|
+
Each group's label along its arc at `outer` (the ring's outer radius),
|
|
42
|
+
or null where it doesn't fit there or its `labelPosition` keeps it on
|
|
43
|
+
its spoke. A label cut short with an ellipsis is allowed only when its
|
|
44
|
+
`labelPosition` is `"along"`.
|
|
45
|
+
@param viz The chart.
|
|
46
|
+
@param nodes The laid-out groups.
|
|
47
|
+
@param outer The ring's outer radius.
|
|
48
|
+
*/
|
|
49
|
+
export declare function chordCurves(viz: VizInstance, nodes: ChordLabelNode[], outer: number): (RingLabelFit | null)[];
|
|
50
|
+
/**
|
|
51
|
+
Whether every group with an arc takes a curved label: each one fits
|
|
52
|
+
along its arc (or is cut short, for `"along"`) or has no text.
|
|
53
|
+
@param viz The chart.
|
|
54
|
+
@param nodes The laid-out groups.
|
|
55
|
+
@param curves Each group's curve (see `chordCurves`).
|
|
56
|
+
*/
|
|
57
|
+
export declare function chordAllCurved(viz: VizInstance, nodes: ChordLabelNode[], curves: (RingLabelFit | null)[]): boolean;
|
|
58
|
+
/**
|
|
59
|
+
Each group's label along its spoke: just outside the outer arc, rotated
|
|
60
|
+
to read outward, flipped upright on the left half. Mutates each node.
|
|
61
|
+
@param nodes The laid-out groups.
|
|
62
|
+
@param outer The ring's outer radius.
|
|
63
|
+
@param labelWidth The room outside the ring for a label.
|
|
64
|
+
@param fontSize The labels' font size: each label's box is 1.5 lines of it tall.
|
|
65
|
+
*/
|
|
66
|
+
export declare function applyChordLabelGeometry(nodes: ChordLabelNode[], outer: number, labelWidth: number, fontSize?: number): void;
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
Donut — Pie with a centered inner radius.
|
|
3
3
|
|
|
4
4
|
Extends Pie; inherits its layout stage + emit. Only the inner-radius
|
|
5
|
-
closure and the default arc gap
|
|
5
|
+
closure (half the ring's hole-less radius) and the default arc gap
|
|
6
|
+
(`padPixel`) differ.
|
|
6
7
|
*/
|
|
7
8
|
import type { ChartDefinition } from "../definition/ChartDefinition.js";
|
|
8
9
|
export declare const donutDef: ChartDefinition;
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`applyGanttLayout` — Gantt's chart-specific layout stage. Reads one task
|
|
3
|
+
per row of `viz._filteredData`, orders and groups them into rows, sizes
|
|
4
|
+
the label column, measures and renders the time axis beside it, and
|
|
5
|
+
places every row. Stores the layout on `viz.ctx.gantt` and returns one
|
|
6
|
+
`GanttMark` per task.
|
|
7
|
+
*/
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { TransformStage } from "../pipeline/stages.js";
|
|
10
|
+
import type { TimeValue } from "../Priestley/timeAxis.js";
|
|
11
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
12
|
+
import type { FittedLabel, GanttLabelFont } from "./ganttLabels.js";
|
|
13
|
+
import type { GanttRow, GanttTask } from "./ganttRows.js";
|
|
14
|
+
/** A task, placed: its row, its row's center, and its left and right edges. */
|
|
15
|
+
export interface GanttMark extends GanttTask {
|
|
16
|
+
row: number;
|
|
17
|
+
cy: number;
|
|
18
|
+
x0: number;
|
|
19
|
+
x1: number;
|
|
20
|
+
}
|
|
21
|
+
/** The Gantt's layout, shared by its emit, stored on `viz.ctx.gantt`. */
|
|
22
|
+
export interface GanttLayout {
|
|
23
|
+
rows: GanttRow[];
|
|
24
|
+
/** Each row's fitted label, by row. */
|
|
25
|
+
labels: FittedLabel[];
|
|
26
|
+
font: GanttLabelFont;
|
|
27
|
+
/** The label column's width; the time axis starts at its right edge. */
|
|
28
|
+
column: number;
|
|
29
|
+
/** Maps a start or end to its x position. */
|
|
30
|
+
x: (v: TimeValue) => number;
|
|
31
|
+
/** Each row's center, by row. */
|
|
32
|
+
cy: number[];
|
|
33
|
+
/** The distance between neighboring row centers. */
|
|
34
|
+
step: number;
|
|
35
|
+
/** A task bar's thickness. */
|
|
36
|
+
band: number;
|
|
37
|
+
/** The rows' area, the plot the "today" line spans. */
|
|
38
|
+
plot: {
|
|
39
|
+
x0: number;
|
|
40
|
+
x1: number;
|
|
41
|
+
y0: number;
|
|
42
|
+
y1: number;
|
|
43
|
+
};
|
|
44
|
+
time: boolean;
|
|
45
|
+
/** Formats a start or end for the tooltip and aria labels. */
|
|
46
|
+
format: (v: TimeValue) => string;
|
|
47
|
+
}
|
|
48
|
+
/** The most a row may take, in pixels, so a short list doesn't draw giant bars. */
|
|
49
|
+
export declare const MAX_ROW_STEP = 40;
|
|
50
|
+
/** The space on each side of the labels in the label column. */
|
|
51
|
+
export declare const LABEL_PADDING = 8;
|
|
52
|
+
/** How far a grouped task's label is indented under its group's. */
|
|
53
|
+
export declare const LABEL_INDENT = 12;
|
|
54
|
+
/**
|
|
55
|
+
Reads one task per data row (see `taskTimes`); rows without a start or
|
|
56
|
+
an end are skipped.
|
|
57
|
+
*/
|
|
58
|
+
export declare function ganttTasks(viz: VizInstance, data: DataPoint[]): GanttTask[];
|
|
59
|
+
/**
|
|
60
|
+
The time domain the tasks span, widened by a day (or by 1 on a numeric
|
|
61
|
+
axis) on each side when every task falls on one time.
|
|
62
|
+
*/
|
|
63
|
+
export declare function ganttDomain(tasks: GanttTask[], time: boolean): number[];
|
|
64
|
+
export declare const applyGanttLayout: TransformStage;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`ganttEmit` — the Gantt's scene: the group brackets and dependency
|
|
3
|
+
arrows behind the tasks, each task's bar (split by its progress) or
|
|
4
|
+
milestone diamond, the label column, and the "today" line.
|
|
5
|
+
*/
|
|
6
|
+
import type { ChartEmit } from "../definition/ChartDefinition.js";
|
|
7
|
+
/** How far the remaining part of a bar mixes toward the background. */
|
|
8
|
+
export declare const REMAINING_MIX = 0.6;
|
|
9
|
+
/**
|
|
10
|
+
The paler shade a bar's remaining (not yet done) part takes: its color
|
|
11
|
+
mixed toward the chart's background, so it reads lighter on a light page
|
|
12
|
+
and dimmer on a dark one.
|
|
13
|
+
*/
|
|
14
|
+
export declare function remainingShade(fill: string, background: string): string;
|
|
15
|
+
/** A milestone diamond's half-height for a bar thickness. */
|
|
16
|
+
export declare const milestoneRadius: (band: number) => number;
|
|
17
|
+
export declare const ganttEmit: ChartEmit;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The Gantt's inert scene nodes: the label column's text, each group's
|
|
3
|
+
summary bracket, the dependency arrows, and the "today" line. None of
|
|
4
|
+
them take the pointer or keyboard focus.
|
|
5
|
+
*/
|
|
6
|
+
import type { PathNode, SceneNode, TextNode } from "@d3plus/render";
|
|
7
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
8
|
+
import type { GanttLayout, GanttMark } from "./applyLayout.js";
|
|
9
|
+
import type { Point } from "./ganttGeometry.js";
|
|
10
|
+
/** The `dependencyConfig` settings, resolved. */
|
|
11
|
+
export interface DependencyStyle {
|
|
12
|
+
stroke: string;
|
|
13
|
+
strokeWidth: number;
|
|
14
|
+
strokeOpacity: number;
|
|
15
|
+
arrowSize: number;
|
|
16
|
+
}
|
|
17
|
+
/** Reads `dependencyConfig`, with the chart's ink as the default color. */
|
|
18
|
+
export declare function dependencyStyle(viz: VizInstance): DependencyStyle;
|
|
19
|
+
/** The label column's text: one node per row with a fitted label. */
|
|
20
|
+
export declare function labelNodes(layout: GanttLayout, marks: GanttMark[]): TextNode[];
|
|
21
|
+
/** Each group header's summary bracket, from its first start to its last end. */
|
|
22
|
+
export declare function groupNodes(viz: VizInstance, layout: GanttLayout): PathNode[];
|
|
23
|
+
/** Where a dependency leaves a task: its bar's right edge or its diamond's right tip. */
|
|
24
|
+
export declare function taskEnd(mark: GanttMark, r: number): Point;
|
|
25
|
+
/** Where a dependency enters a task: its bar's left edge or its diamond's left tip. */
|
|
26
|
+
export declare function taskStart(mark: GanttMark, r: number): Point;
|
|
27
|
+
/**
|
|
28
|
+
One elbow line and arrowhead per dependency whose predecessor is drawn,
|
|
29
|
+
from the predecessor's end to the dependent's start. Each carries both
|
|
30
|
+
tasks as interaction points, so hovering either keeps it lit while the
|
|
31
|
+
rest dim.
|
|
32
|
+
*/
|
|
33
|
+
export declare function dependencyNodes(viz: VizInstance, layout: GanttLayout, marks: GanttMark[], r: number): SceneNode[];
|
|
34
|
+
/** The time `today` marks: now for `true`, the value given otherwise, or null when off. */
|
|
35
|
+
export declare function todayValue(today: unknown, now?: () => Date): unknown;
|
|
36
|
+
/**
|
|
37
|
+
The "today" line across the rows at `today`, styled by `todayConfig` and
|
|
38
|
+
labeled with the translated "Today" unless `todayConfig.label` says
|
|
39
|
+
otherwise. Nothing when `today` is off or falls outside the time axis.
|
|
40
|
+
*/
|
|
41
|
+
export declare function todayNodes(viz: VizInstance, layout: GanttLayout): SceneNode[];
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure Gantt geometry: the milestone diamond, a bar's progress split, a
|
|
3
|
+
group's summary bracket, the elbow route of a dependency arrow, and the
|
|
4
|
+
label column's width.
|
|
5
|
+
*/
|
|
6
|
+
/** A point, `[x, y]`. */
|
|
7
|
+
export type Point = [number, number];
|
|
8
|
+
/** A horizontal span, `x` to `x + width`. */
|
|
9
|
+
export interface Span {
|
|
10
|
+
x: number;
|
|
11
|
+
width: number;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
The SVG path of a diamond centered on `(cx, cy)`, `r` from its center to
|
|
15
|
+
each tip.
|
|
16
|
+
*/
|
|
17
|
+
export declare function diamondPath(cx: number, cy: number, r: number): string;
|
|
18
|
+
/**
|
|
19
|
+
Splits a bar into its done part (from its start) and the rest, by the
|
|
20
|
+
share of it `progress` covers (clamped to 0–1).
|
|
21
|
+
@param x The bar's left edge.
|
|
22
|
+
@param width The bar's width.
|
|
23
|
+
@param progress The share done.
|
|
24
|
+
*/
|
|
25
|
+
export declare function progressSplit(x: number, width: number, progress: number): {
|
|
26
|
+
done: Span;
|
|
27
|
+
rest: Span;
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
The SVG path of a group's summary bracket: a bar from `x0` to `x1`
|
|
31
|
+
centered on `cy`, `h` tall, with a pointed foot hanging below each end.
|
|
32
|
+
*/
|
|
33
|
+
export declare function bracketPath(x0: number, x1: number, cy: number, h: number): string;
|
|
34
|
+
/**
|
|
35
|
+
The route of a dependency arrow from a predecessor's end (`from`) to a
|
|
36
|
+
dependent's start (`to`): right `stub` pixels, then down (or up) to the
|
|
37
|
+
dependent's row, then right into its start. When the dependent starts
|
|
38
|
+
too close to (or before) the predecessor's end for that, the route turns
|
|
39
|
+
down (or up) to the edge of the predecessor's row (`step / 2` away),
|
|
40
|
+
runs back left to `stub` before the dependent's start, and drops to its
|
|
41
|
+
row from there. Points on one row join straight.
|
|
42
|
+
@param from The predecessor's end.
|
|
43
|
+
@param to The dependent's start.
|
|
44
|
+
@param stub The length of the first and last legs.
|
|
45
|
+
@param step The distance between neighboring row centers.
|
|
46
|
+
*/
|
|
47
|
+
export declare function elbowRoute(from: Point, to: Point, stub: number, step: number): Point[];
|
|
48
|
+
/**
|
|
49
|
+
The label column's width: the widest label plus padding on both sides,
|
|
50
|
+
at most `limit` (a share of the chart's `width` when below 1, else
|
|
51
|
+
pixels). Zero when there are no labels or no room.
|
|
52
|
+
@param widest The widest label's width (with its indent).
|
|
53
|
+
@param width The chart's width.
|
|
54
|
+
@param limit The `labelWidth` setting.
|
|
55
|
+
@param padding The space on each side of the labels.
|
|
56
|
+
*/
|
|
57
|
+
export declare function labelColumnWidth(widest: number, width: number, limit: number, padding: number): number;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The Gantt's label column text: the label font, and each label wrapped to
|
|
3
|
+
the column's width over as many lines as its row holds, the last line
|
|
4
|
+
ending in an ellipsis when the label doesn't fit.
|
|
5
|
+
*/
|
|
6
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
7
|
+
/** The label column's font. */
|
|
8
|
+
export interface GanttLabelFont {
|
|
9
|
+
family: string;
|
|
10
|
+
size: number;
|
|
11
|
+
color: string;
|
|
12
|
+
lineHeight: number;
|
|
13
|
+
}
|
|
14
|
+
/** A label fitted to the column. */
|
|
15
|
+
export interface FittedLabel {
|
|
16
|
+
lines: string[];
|
|
17
|
+
widths: number[];
|
|
18
|
+
}
|
|
19
|
+
/** The label font size, in pixels, unless `taskLabelConfig` sets one. */
|
|
20
|
+
export declare const LABEL_FONT_SIZE = 12;
|
|
21
|
+
/** Reads `taskLabelConfig`, with the chart's font and ink as defaults. */
|
|
22
|
+
export declare function ganttLabelFont(viz: VizInstance): GanttLabelFont;
|
|
23
|
+
/** The width of `text` in the label font. */
|
|
24
|
+
export declare function labelWidth(text: string, font: GanttLabelFont, weight?: number | string): number;
|
|
25
|
+
/**
|
|
26
|
+
Ends `text` in an ellipsis, dropping characters until it fits `width`.
|
|
27
|
+
@param text The line.
|
|
28
|
+
@param width The room it has.
|
|
29
|
+
@param measure Measures a line.
|
|
30
|
+
*/
|
|
31
|
+
export declare function ellipsize(text: string, width: number, measure: (t: string) => number): string;
|
|
32
|
+
/**
|
|
33
|
+
Wraps a label to `width`, over at most `maxLines` lines, ending the last
|
|
34
|
+
in an ellipsis when the label doesn't fit.
|
|
35
|
+
@param text The label.
|
|
36
|
+
@param width The room each line has.
|
|
37
|
+
@param maxLines The most lines it may take.
|
|
38
|
+
@param font The label font.
|
|
39
|
+
@param weight The font weight.
|
|
40
|
+
*/
|
|
41
|
+
export declare function fitLabel(text: string, width: number, maxLines: number, font: GanttLabelFont, weight?: number | string): FittedLabel;
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Pure helpers that turn a Gantt's data rows into its row list: reading
|
|
3
|
+
each task's milestone flag, progress, and dependencies, ordering tasks
|
|
4
|
+
by `taskSort`, and grouping them under `group` header rows.
|
|
5
|
+
*/
|
|
6
|
+
import type { DataPoint } from "@d3plus/data";
|
|
7
|
+
import type { TimeValue } from "../Priestley/timeAxis.js";
|
|
8
|
+
/** One task, read from a data row. */
|
|
9
|
+
export interface GanttTask {
|
|
10
|
+
__d3plus__: true;
|
|
11
|
+
data: DataPoint;
|
|
12
|
+
i: number;
|
|
13
|
+
/** The task's id (its `groupBy` id), which `dependencies` refer to. */
|
|
14
|
+
id: string;
|
|
15
|
+
label: string;
|
|
16
|
+
start: TimeValue;
|
|
17
|
+
end: TimeValue;
|
|
18
|
+
milestone: boolean;
|
|
19
|
+
/** The share of the task done, 0 to 1, or undefined when it has none. */
|
|
20
|
+
progress: number | undefined;
|
|
21
|
+
/** The ids of the tasks this one waits on. */
|
|
22
|
+
dependencies: string[];
|
|
23
|
+
/** The task's group, or undefined when it has none. */
|
|
24
|
+
group: string | undefined;
|
|
25
|
+
}
|
|
26
|
+
/** A group's header row: its label and the span of its tasks. */
|
|
27
|
+
export interface GanttGroupRow {
|
|
28
|
+
kind: "group";
|
|
29
|
+
key: string;
|
|
30
|
+
label: string;
|
|
31
|
+
start: TimeValue;
|
|
32
|
+
end: TimeValue;
|
|
33
|
+
tasks: GanttTask[];
|
|
34
|
+
}
|
|
35
|
+
/** A task's row, indented under its group header when it has one. */
|
|
36
|
+
export interface GanttTaskRow {
|
|
37
|
+
kind: "task";
|
|
38
|
+
key: string;
|
|
39
|
+
task: GanttTask;
|
|
40
|
+
indent: boolean;
|
|
41
|
+
}
|
|
42
|
+
/** A Gantt row, top to bottom. */
|
|
43
|
+
export type GanttRow = GanttGroupRow | GanttTaskRow;
|
|
44
|
+
/** How tasks are ordered: as given, by start, or by a comparator of their data rows. */
|
|
45
|
+
export type TaskSort = "data" | "start" | ((a: DataPoint, b: DataPoint) => number);
|
|
46
|
+
/**
|
|
47
|
+
Whether a task draws as a milestone: when its `milestone` value is
|
|
48
|
+
truthy, or, without one, when it starts and ends at the same time.
|
|
49
|
+
@param start The task's start.
|
|
50
|
+
@param end The task's end.
|
|
51
|
+
@param flag The task's `milestone` value.
|
|
52
|
+
*/
|
|
53
|
+
export declare function isMilestone(start: TimeValue, end: TimeValue, flag?: unknown): boolean;
|
|
54
|
+
/**
|
|
55
|
+
A `progress` value as a share from 0 to 1: a number is read as a
|
|
56
|
+
fraction (`0.6`), a string ending in `%` as a percent (`"60%"`), clamped
|
|
57
|
+
to 0–1. Anything else is undefined.
|
|
58
|
+
@param value The raw value.
|
|
59
|
+
*/
|
|
60
|
+
export declare function normalizeProgress(value: unknown): number | undefined;
|
|
61
|
+
/**
|
|
62
|
+
A `dependencies` value as a list of task ids: an array, or a string of
|
|
63
|
+
comma-separated ids. Anything else is no dependencies.
|
|
64
|
+
@param value The raw value.
|
|
65
|
+
*/
|
|
66
|
+
export declare function dependencyIds(value: unknown): string[];
|
|
67
|
+
/**
|
|
68
|
+
Orders tasks by `taskSort`: `"data"` keeps their order, `"start"` sorts
|
|
69
|
+
by start (then end), and a function compares their data rows. Ties keep
|
|
70
|
+
data order.
|
|
71
|
+
@param tasks The tasks.
|
|
72
|
+
@param sort The `taskSort` setting.
|
|
73
|
+
*/
|
|
74
|
+
export declare function sortTasks(tasks: GanttTask[], sort: TaskSort): GanttTask[];
|
|
75
|
+
/**
|
|
76
|
+
The chart's rows, top to bottom. Tasks are ordered by `sort`; when any
|
|
77
|
+
task has a group, each group gets a header row (spanning its tasks'
|
|
78
|
+
earliest start to latest end) followed by its tasks, the groups in the
|
|
79
|
+
order their first task appears. Tasks without a group stay in place
|
|
80
|
+
among the groups, without a header.
|
|
81
|
+
@param tasks The tasks.
|
|
82
|
+
@param sort The `taskSort` setting.
|
|
83
|
+
*/
|
|
84
|
+
export declare function ganttRows(tasks: GanttTask[], sort: TaskSort): GanttRow[];
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
What a Gantt task reads as in its tooltip and aria label: its start,
|
|
3
|
+
end, duration, and progress (or a milestone's date), in the chart's
|
|
4
|
+
locale and translated.
|
|
5
|
+
*/
|
|
6
|
+
import type { DataPoint } from "@d3plus/data";
|
|
7
|
+
import type { RangeBreakRule } from "../../components/Axis/rangeBreaks.js";
|
|
8
|
+
import type { TimeValue } from "../Priestley/timeAxis.js";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
/**
|
|
11
|
+
Formats starts and ends: dates in the chart's locale, at the precision
|
|
12
|
+
the given dates step by (see `formatDateFull`), or numbers abbreviated.
|
|
13
|
+
@param viz The chart.
|
|
14
|
+
@param values The dates the chart draws, which set the precision.
|
|
15
|
+
*/
|
|
16
|
+
export declare function timeFormatter(viz: VizInstance, values: TimeValue[]): (v: TimeValue) => string;
|
|
17
|
+
/**
|
|
18
|
+
The time axis's `rangeBreaks` rules (from `axisConfig`) when they hide
|
|
19
|
+
whole days (weekends, weekdays, dates, or explicit ranges), else none: a
|
|
20
|
+
rule hiding hours of every day leaves no whole days to count.
|
|
21
|
+
@param viz The chart.
|
|
22
|
+
*/
|
|
23
|
+
export declare function ganttDayBreaks(viz: VizInstance): RangeBreakRule[];
|
|
24
|
+
/**
|
|
25
|
+
A task's duration: whole (or tenths of) days on a time axis, translated
|
|
26
|
+
("12 days"), else the difference of its end and start. When the axis's
|
|
27
|
+
`rangeBreaks` hide whole days (see `ganttDayBreaks`), only the days left
|
|
28
|
+
showing count ("8 working days").
|
|
29
|
+
*/
|
|
30
|
+
export declare function ganttDuration(viz: VizInstance, start: TimeValue, end: TimeValue): string;
|
|
31
|
+
/** A day count in a locale, with at most one decimal. */
|
|
32
|
+
export declare function dayCount(days: number, locale: unknown): string;
|
|
33
|
+
/** A share from 0 to 1 as a whole percent. */
|
|
34
|
+
export declare const percent: (share: number) => string;
|
|
35
|
+
/** A task's times, milestone flag, and progress. */
|
|
36
|
+
export interface TaskTimes {
|
|
37
|
+
start: TimeValue;
|
|
38
|
+
end: TimeValue;
|
|
39
|
+
milestone: boolean;
|
|
40
|
+
progress: number | undefined;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
Reads a row's start, end, milestone flag, and progress. A missing start
|
|
44
|
+
or end takes the other's value, and reversed times are swapped; null
|
|
45
|
+
when both are missing.
|
|
46
|
+
*/
|
|
47
|
+
export declare function taskTimes(viz: VizInstance, d: DataPoint, i: number): TaskTimes | null;
|
|
48
|
+
/**
|
|
49
|
+
The tooltip rows for a task: Start, End, Duration, and Progress, or a
|
|
50
|
+
milestone's date and Progress, each label translated.
|
|
51
|
+
*/
|
|
52
|
+
export declare function ganttTooltipRows(viz: VizInstance, d: DataPoint, i: number): [string, string][];
|
|
53
|
+
/**
|
|
54
|
+
A task's aria label: its name and span (or a milestone's date), and its
|
|
55
|
+
progress, such as `"Design, Jan 8, 2024 - Jan 19, 2024, Progress 60%."`.
|
|
56
|
+
*/
|
|
57
|
+
export declare function ganttAriaLabel(viz: VizInstance, d: DataPoint, i: number): string;
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Gantt — a project schedule: one labeled row per task, its bar running
|
|
3
|
+
from its start to its end over a time axis, with milestones, phases,
|
|
4
|
+
dependency arrows, progress, and a "today" line.
|
|
5
|
+
|
|
6
|
+
Implementation files in this folder:
|
|
7
|
+
- `ganttRows.ts` — pure: task fields, ordering, and group rows.
|
|
8
|
+
- `ganttGeometry.ts` — pure: diamonds, progress, brackets, elbows.
|
|
9
|
+
- `ganttLabels.ts` — the label column's font and fitted labels.
|
|
10
|
+
- `ganttTooltip.ts` — task times, tooltip rows, and aria labels.
|
|
11
|
+
- `applyLayout.ts` — chart-specific `TransformStage`.
|
|
12
|
+
- `ganttDecor.ts` — labels, brackets, dependencies, "today".
|
|
13
|
+
- `emit.ts` — the scene nodes of each task.
|
|
14
|
+
*/
|
|
15
|
+
import type { DataPoint } from "@d3plus/data";
|
|
16
|
+
import type { DataDrivenChartDefinition } from "../definition/ChartDefinition.js";
|
|
17
|
+
/**
|
|
18
|
+
Coerces a per-row option: a function is kept, a string becomes a data-key
|
|
19
|
+
accessor, and anything else turns it off.
|
|
20
|
+
*/
|
|
21
|
+
export declare function taskAccessor(v: unknown): unknown;
|
|
22
|
+
/**
|
|
23
|
+
Averages grouped rows' progress (as `aggs` call it, with the rows and an
|
|
24
|
+
accessor), reading percent strings as fractions.
|
|
25
|
+
*/
|
|
26
|
+
export declare function progressAgg(rows: DataPoint[], value: (d: DataPoint) => unknown): number | undefined;
|
|
27
|
+
export declare const ganttDef: DataDrivenChartDefinition;
|
|
28
|
+
/**
|
|
29
|
+
Creates a Gantt chart from an array of tasks: one labeled row per task,
|
|
30
|
+
its bar running from `start` to `end` over a time axis. Tasks can be
|
|
31
|
+
grouped into phases (`group`), drawn as milestones (`milestone`), linked
|
|
32
|
+
by dependency arrows (`dependencies`), and filled by their `progress`,
|
|
33
|
+
with an optional `today` line.
|
|
34
|
+
*/
|
|
35
|
+
declare const _default: new () => any;
|
|
36
|
+
export default _default;
|
|
@@ -6,10 +6,18 @@
|
|
|
6
6
|
import type { DataPoint } from "@d3plus/data";
|
|
7
7
|
import type { TransformStage, VizContext } from "../pipeline/stages.js";
|
|
8
8
|
import type { SizeLegendScale } from "../../components/SizeLegend/sizeLegendLayout.js";
|
|
9
|
+
import type { GeoPathFn } from "./flowGeometry.js";
|
|
9
10
|
type GeomapViz = VizContext["viz"];
|
|
10
11
|
/** The rows drawn as points: those whose `point` accessor returns coordinates. */
|
|
11
12
|
export declare function geomapPointData(v: GeomapViz): DataPoint[];
|
|
12
13
|
/** The point radius scale: `pointSizeScale` over the points' `pointSize` extent, onto `[pointSizeMin, pointSizeMax]`. */
|
|
13
14
|
export declare function geomapPointSizeScale(v: GeomapViz, pointData: DataPoint[]): SizeLegendScale;
|
|
15
|
+
/**
|
|
16
|
+
The coordinate points the fitted projection draws: those its clipping
|
|
17
|
+
keeps, read through d3-geo's path of each point (a projection alone
|
|
18
|
+
places points on the far side of a globe, or outside geoAlbersUsa's
|
|
19
|
+
insets, as if they were visible).
|
|
20
|
+
*/
|
|
21
|
+
export declare function visiblePointData(v: GeomapViz, pointData: DataPoint[], path: GeoPathFn): DataPoint[];
|
|
14
22
|
export declare const applyGeomapLayout: TransformStage;
|
|
15
23
|
export {};
|
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
2
|
Light/dark basemaps. `tileUrl` and `ocean` accept either one value or a
|
|
3
|
-
`{light, dark}` pair; a pair resolves against the chart's
|
|
4
|
-
draw, and
|
|
3
|
+
`{light, dark}` pair; a pair resolves against the chart's theme each
|
|
4
|
+
draw (see `theme`), and an `"auto"` chart redraws when its page flips.
|
|
5
5
|
|
|
6
6
|
@module
|
|
7
7
|
*/
|
|
8
|
-
import type { VizInstance } from "../viz/vizTypes.js";
|
|
9
8
|
/** A value, or one per page theme. */
|
|
10
9
|
export type Themed<T> = T | {
|
|
11
10
|
light: T;
|
|
@@ -17,19 +16,3 @@ export declare const DEFAULT_TILE_URL: Themed<string>;
|
|
|
17
16
|
export declare const DEFAULT_OCEAN: Themed<string>;
|
|
18
17
|
/** Picks a themed value's light or dark side. */
|
|
19
18
|
export declare function resolveThemed<T>(value: Themed<T>, dark: boolean): T;
|
|
20
|
-
/** Whether a Geomap has any themed value that depends on the backdrop. */
|
|
21
|
-
export declare function isThemed(viz: VizInstance): boolean;
|
|
22
|
-
/**
|
|
23
|
-
Whether the chart sits on a dark backdrop: the first non-transparent
|
|
24
|
-
background among its ancestors, or — when none sets one — the browser's
|
|
25
|
-
own page canvas, which is dark only when the page opts into a dark
|
|
26
|
-
`color-scheme` and the system prefers dark. Server renders are light.
|
|
27
|
-
*/
|
|
28
|
-
export declare function pageIsDark(viz: VizInstance): boolean;
|
|
29
|
-
/**
|
|
30
|
-
Redraws the chart when its backdrop changes theme: on a system theme
|
|
31
|
-
change, or when the page flips a theme class/attribute/style on <html>
|
|
32
|
-
or <body> (how most theme toggles work). Installed once per chart, and
|
|
33
|
-
only while it uses a `{light, dark}` pair.
|
|
34
|
-
*/
|
|
35
|
-
export declare function watchPageTheme(viz: VizInstance): void;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
`geomapEmit` — country Paths
|
|
3
|
-
stashed on `viz.ctx`. Emits flat SceneNodes directly (no transient
|
|
2
|
+
`geomapEmit` — country Paths, links, and point Circles using
|
|
3
|
+
`geomapCtx` stashed on `viz.ctx`. Emits flat SceneNodes directly (no transient
|
|
4
4
|
Shape compute pass).
|
|
5
5
|
*/
|
|
6
6
|
import type { ChartEmit } from "../definition/ChartDefinition.js";
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Geomap's links as scene nodes: each link's path (ending inside its
|
|
3
|
+
arrowheads), a wider transparent hit path over the whole path so thin
|
|
4
|
+
links are easy to point at, its arrowheads, and its label. The links sit above the topojson shapes and below the coordinate
|
|
5
|
+
points, so a link runs into the point at its end and the points stay on
|
|
6
|
+
top to hover.
|
|
7
|
+
*/
|
|
8
|
+
import type { SceneNode } from "@d3plus/render";
|
|
9
|
+
import type { LabelCircle } from "../features/circleLabelPlacement.js";
|
|
10
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
11
|
+
import type { FlowLink } from "./flowLinks.js";
|
|
12
|
+
/** A link's scene key. */
|
|
13
|
+
export declare const flowLinkKey: (link: FlowLink) => string;
|
|
14
|
+
/**
|
|
15
|
+
The color of links `linkColor` doesn't color: halfway between the
|
|
16
|
+
chart's background and its text color, a gray that reads over both the
|
|
17
|
+
land and the water of a light or dark map.
|
|
18
|
+
*/
|
|
19
|
+
export declare function flowLinkGray(viz: VizInstance): string;
|
|
20
|
+
/**
|
|
21
|
+
A link's visible stroke and its arrowheads. Each head's tip sits on the
|
|
22
|
+
path, clear of the point at its end, and is aimed along the chord from
|
|
23
|
+
its base (`size` further back along the path) to its tip; the stroke
|
|
24
|
+
follows the path to each base, then runs straight along that chord to
|
|
25
|
+
end inside the head (see `polylineArrowEdge`). A head goes only on an
|
|
26
|
+
end the projection draws.
|
|
27
|
+
*/
|
|
28
|
+
export declare function flowArrowEdge(viz: VizInstance, link: FlowLink, fill: string | undefined): {
|
|
29
|
+
d: string;
|
|
30
|
+
arrows: SceneNode[];
|
|
31
|
+
};
|
|
32
|
+
/** The links, their hit paths, and their arrowheads, in that order. */
|
|
33
|
+
export declare function emitFlowLinks(viz: VizInstance, links: FlowLink[]): SceneNode[];
|
|
34
|
+
/** The link labels, at the middle of each link, clear of the points. */
|
|
35
|
+
export declare function emitFlowLabels(viz: VizInstance, links: FlowLink[], circles: LabelCircle[]): SceneNode[];
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Geomap's link interaction. Hovering a link emphasizes it and the marks
|
|
3
|
+
at its ends; hovering a point or shape that ends a link emphasizes its
|
|
4
|
+
links. Clicking a link focuses it (the rest of the map dims) and zooms
|
|
5
|
+
to it; clicking it again, any other mark, or the open ocean clears the
|
|
6
|
+
focus. Also installs `links`, which loads its rows like `topojson`.
|
|
7
|
+
*/
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { FocusBox } from "../features/linkFocus.js";
|
|
10
|
+
import type { LinkDatum } from "../features/linkInteraction.js";
|
|
11
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
12
|
+
/** The box around a drawn link, or null when it isn't drawn. */
|
|
13
|
+
export declare function flowLinkBox(viz: VizInstance, d: LinkDatum): FocusBox | null;
|
|
14
|
+
/**
|
|
15
|
+
What hovering `d` emphasizes: a link and its two ends, or a mark that
|
|
16
|
+
ends links and those links. Null for anything else.
|
|
17
|
+
*/
|
|
18
|
+
export declare function flowHoverPredicate(viz: VizInstance, d: DataPoint): ((h: DataPoint, i: number) => boolean) | null;
|
|
19
|
+
/** Installs `links` and the link hover, click, and focus handlers. */
|
|
20
|
+
export declare function setupGeomapLinks(viz: VizInstance): void;
|