@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,207 @@
|
|
|
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
|
+
*/ import { arrowNode } from "../features/edgeArrows.js";
|
|
6
|
+
import { referenceLineNodes } from "../features/referenceAnnotations.js";
|
|
7
|
+
import { backgroundInk } from "../viz/backgroundInk.js";
|
|
8
|
+
import { LABEL_INDENT, LABEL_PADDING } from "./applyLayout.js";
|
|
9
|
+
import { bracketPath, elbowRoute } from "./ganttGeometry.js";
|
|
10
|
+
const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
|
|
11
|
+
/** Reads `dependencyConfig`, with the chart's ink as the default color. */ export function dependencyStyle(viz) {
|
|
12
|
+
const cfg = viz.schema.dependencyConfig ?? {};
|
|
13
|
+
return {
|
|
14
|
+
stroke: cfg.stroke || backgroundInk(viz),
|
|
15
|
+
strokeWidth: num(cfg.strokeWidth, 1),
|
|
16
|
+
strokeOpacity: num(cfg.strokeOpacity, 0.55),
|
|
17
|
+
arrowSize: Math.max(2, num(cfg.arrowSize, 6))
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
/** The label column's text: one node per row with a fitted label. */ export function labelNodes(layout, marks) {
|
|
21
|
+
const { font } = layout;
|
|
22
|
+
const byRow = new Map(marks.map((m)=>[
|
|
23
|
+
m.row,
|
|
24
|
+
m
|
|
25
|
+
]));
|
|
26
|
+
const out = [];
|
|
27
|
+
layout.rows.forEach((row, k)=>{
|
|
28
|
+
const fitted = layout.labels[k];
|
|
29
|
+
if (!fitted || !fitted.lines.length) return;
|
|
30
|
+
const group = row.kind === "group";
|
|
31
|
+
const indent = !group && row.indent ? LABEL_INDENT : 0;
|
|
32
|
+
const top = layout.cy[k] - fitted.lines.length * font.lineHeight / 2;
|
|
33
|
+
const mark = byRow.get(k);
|
|
34
|
+
out.push({
|
|
35
|
+
type: "text",
|
|
36
|
+
key: `gantt-label-${row.key}`,
|
|
37
|
+
interactive: false,
|
|
38
|
+
...mark ? {
|
|
39
|
+
datum: mark.data,
|
|
40
|
+
index: mark.i
|
|
41
|
+
} : {},
|
|
42
|
+
x: 0,
|
|
43
|
+
y: 0,
|
|
44
|
+
transform: {
|
|
45
|
+
x: LABEL_PADDING + indent,
|
|
46
|
+
y: top
|
|
47
|
+
},
|
|
48
|
+
lines: fitted.lines.map((text, i)=>({
|
|
49
|
+
text,
|
|
50
|
+
x: 0,
|
|
51
|
+
y: font.lineHeight * (i + 0.5),
|
|
52
|
+
width: fitted.widths[i]
|
|
53
|
+
})),
|
|
54
|
+
font: {
|
|
55
|
+
family: font.family,
|
|
56
|
+
size: font.size,
|
|
57
|
+
weight: group ? 600 : 400,
|
|
58
|
+
anchor: "start",
|
|
59
|
+
baseline: "middle"
|
|
60
|
+
},
|
|
61
|
+
paint: {
|
|
62
|
+
fill: font.color
|
|
63
|
+
}
|
|
64
|
+
});
|
|
65
|
+
});
|
|
66
|
+
return out;
|
|
67
|
+
}
|
|
68
|
+
/** Each group header's summary bracket, from its first start to its last end. */ export function groupNodes(viz, layout) {
|
|
69
|
+
const fill = backgroundInk(viz);
|
|
70
|
+
const out = [];
|
|
71
|
+
layout.rows.forEach((row, k)=>{
|
|
72
|
+
if (row.kind !== "group") return;
|
|
73
|
+
const x0 = layout.x(row.start), x1 = Math.max(layout.x(row.end), x0 + 1);
|
|
74
|
+
out.push({
|
|
75
|
+
type: "path",
|
|
76
|
+
key: `gantt-${row.key}`,
|
|
77
|
+
interactive: false,
|
|
78
|
+
d: bracketPath(x0, x1, layout.cy[k], Math.max(2, layout.band * 0.4)),
|
|
79
|
+
paint: {
|
|
80
|
+
fill,
|
|
81
|
+
fillOpacity: 0.6
|
|
82
|
+
}
|
|
83
|
+
});
|
|
84
|
+
});
|
|
85
|
+
return out;
|
|
86
|
+
}
|
|
87
|
+
/** Where a dependency leaves a task: its bar's right edge or its diamond's right tip. */ export function taskEnd(mark, r) {
|
|
88
|
+
return [
|
|
89
|
+
mark.milestone ? mark.x1 + r : mark.x1,
|
|
90
|
+
mark.cy
|
|
91
|
+
];
|
|
92
|
+
}
|
|
93
|
+
/** Where a dependency enters a task: its bar's left edge or its diamond's left tip. */ export function taskStart(mark, r) {
|
|
94
|
+
return [
|
|
95
|
+
mark.milestone ? mark.x1 - r : mark.x0,
|
|
96
|
+
mark.cy
|
|
97
|
+
];
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
One elbow line and arrowhead per dependency whose predecessor is drawn,
|
|
101
|
+
from the predecessor's end to the dependent's start. Each carries both
|
|
102
|
+
tasks as interaction points, so hovering either keeps it lit while the
|
|
103
|
+
rest dim.
|
|
104
|
+
*/ export function dependencyNodes(viz, layout, marks, r) {
|
|
105
|
+
const style = dependencyStyle(viz);
|
|
106
|
+
const byId = new Map(marks.map((m)=>[
|
|
107
|
+
m.id,
|
|
108
|
+
m
|
|
109
|
+
]));
|
|
110
|
+
const stub = Math.max(8, style.arrowSize + 4);
|
|
111
|
+
const out = [];
|
|
112
|
+
for (const mark of marks){
|
|
113
|
+
for (const id of mark.dependencies){
|
|
114
|
+
const pred = byId.get(id);
|
|
115
|
+
if (!pred || pred === mark) continue;
|
|
116
|
+
const from = taskEnd(pred, r), to = taskStart(mark, r);
|
|
117
|
+
const route = elbowRoute(from, to, stub, layout.step);
|
|
118
|
+
const points = route.slice();
|
|
119
|
+
const last = points.length - 1;
|
|
120
|
+
points[last] = [
|
|
121
|
+
to[0] - style.arrowSize * 0.8,
|
|
122
|
+
to[1]
|
|
123
|
+
];
|
|
124
|
+
const key = `gantt-dependency-${pred.id}-${mark.id}`;
|
|
125
|
+
const interactionPoints = [
|
|
126
|
+
{
|
|
127
|
+
x: from[0],
|
|
128
|
+
y: from[1],
|
|
129
|
+
datum: pred.data,
|
|
130
|
+
index: pred.i
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
x: to[0],
|
|
134
|
+
y: to[1],
|
|
135
|
+
datum: mark.data,
|
|
136
|
+
index: mark.i
|
|
137
|
+
}
|
|
138
|
+
];
|
|
139
|
+
out.push({
|
|
140
|
+
type: "line",
|
|
141
|
+
key,
|
|
142
|
+
interactive: false,
|
|
143
|
+
points,
|
|
144
|
+
curve: "linear",
|
|
145
|
+
interactionPoints,
|
|
146
|
+
paint: {
|
|
147
|
+
fill: "none",
|
|
148
|
+
stroke: style.stroke,
|
|
149
|
+
strokeWidth: style.strokeWidth,
|
|
150
|
+
strokeOpacity: style.strokeOpacity
|
|
151
|
+
}
|
|
152
|
+
});
|
|
153
|
+
const arrow = arrowNode({
|
|
154
|
+
key: `${key}-arrow`,
|
|
155
|
+
datum: mark.data,
|
|
156
|
+
x: to[0],
|
|
157
|
+
y: to[1],
|
|
158
|
+
angle: 0,
|
|
159
|
+
size: style.arrowSize,
|
|
160
|
+
fill: style.stroke
|
|
161
|
+
});
|
|
162
|
+
out.push({
|
|
163
|
+
...arrow,
|
|
164
|
+
datum: undefined,
|
|
165
|
+
interactionPoints,
|
|
166
|
+
paint: {
|
|
167
|
+
...arrow.paint,
|
|
168
|
+
fillOpacity: style.strokeOpacity
|
|
169
|
+
}
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
return out;
|
|
174
|
+
}
|
|
175
|
+
/** The time `today` marks: now for `true`, the value given otherwise, or null when off. */ export function todayValue(today, now = ()=>new Date()) {
|
|
176
|
+
if (today === true) return now();
|
|
177
|
+
if (today === false || today === undefined || today === null || today === "") return null;
|
|
178
|
+
return today;
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
The "today" line across the rows at `today`, styled by `todayConfig` and
|
|
182
|
+
labeled with the translated "Today" unless `todayConfig.label` says
|
|
183
|
+
otherwise. Nothing when `today` is off or falls outside the time axis.
|
|
184
|
+
*/ export function todayNodes(viz, layout) {
|
|
185
|
+
const value = todayValue(viz.schema.today);
|
|
186
|
+
if (value === null) return [];
|
|
187
|
+
const cfg = viz.schema.todayConfig ?? {};
|
|
188
|
+
const annotation = {
|
|
189
|
+
label: viz.schema.translate("Today"),
|
|
190
|
+
fontSize: 11,
|
|
191
|
+
labelPosition: "end",
|
|
192
|
+
strokeOpacity: 0.85,
|
|
193
|
+
strokeWidth: 1.5,
|
|
194
|
+
...cfg,
|
|
195
|
+
shape: "ReferenceLine",
|
|
196
|
+
x: value
|
|
197
|
+
};
|
|
198
|
+
return referenceLineNodes(viz, annotation, {
|
|
199
|
+
plot: layout.plot,
|
|
200
|
+
axes: {
|
|
201
|
+
x: {
|
|
202
|
+
scale: (v)=>layout.x(v),
|
|
203
|
+
time: layout.time
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
}, "gantt-today");
|
|
207
|
+
}
|
|
@@ -0,0 +1,107 @@
|
|
|
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
|
+
*/ /** A point, `[x, y]`. */ const round = (n)=>Math.round(n * 100) / 100;
|
|
6
|
+
/**
|
|
7
|
+
The SVG path of a diamond centered on `(cx, cy)`, `r` from its center to
|
|
8
|
+
each tip.
|
|
9
|
+
*/ export function diamondPath(cx, cy, r) {
|
|
10
|
+
return `M${round(cx)},${round(cy - r)}L${round(cx + r)},${round(cy)}L${round(cx)},${round(cy + r)}L${round(cx - r)},${round(cy)}Z`;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
Splits a bar into its done part (from its start) and the rest, by the
|
|
14
|
+
share of it `progress` covers (clamped to 0–1).
|
|
15
|
+
@param x The bar's left edge.
|
|
16
|
+
@param width The bar's width.
|
|
17
|
+
@param progress The share done.
|
|
18
|
+
*/ export function progressSplit(x, width, progress) {
|
|
19
|
+
const p = Math.max(0, Math.min(1, progress));
|
|
20
|
+
const done = width * p;
|
|
21
|
+
return {
|
|
22
|
+
done: {
|
|
23
|
+
x,
|
|
24
|
+
width: done
|
|
25
|
+
},
|
|
26
|
+
rest: {
|
|
27
|
+
x: x + done,
|
|
28
|
+
width: width - done
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
The SVG path of a group's summary bracket: a bar from `x0` to `x1`
|
|
34
|
+
centered on `cy`, `h` tall, with a pointed foot hanging below each end.
|
|
35
|
+
*/ export function bracketPath(x0, x1, cy, h) {
|
|
36
|
+
const top = cy - h / 2, bottom = cy + h / 2;
|
|
37
|
+
const foot = Math.min(h, Math.max(0, (x1 - x0) / 2));
|
|
38
|
+
return `M${round(x0)},${round(top)}H${round(x1)}V${round(bottom + foot)}L${round(x1 - foot)},${round(bottom)}H${round(x0 + foot)}L${round(x0)},${round(bottom + foot)}Z`;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
The route of a dependency arrow from a predecessor's end (`from`) to a
|
|
42
|
+
dependent's start (`to`): right `stub` pixels, then down (or up) to the
|
|
43
|
+
dependent's row, then right into its start. When the dependent starts
|
|
44
|
+
too close to (or before) the predecessor's end for that, the route turns
|
|
45
|
+
down (or up) to the edge of the predecessor's row (`step / 2` away),
|
|
46
|
+
runs back left to `stub` before the dependent's start, and drops to its
|
|
47
|
+
row from there. Points on one row join straight.
|
|
48
|
+
@param from The predecessor's end.
|
|
49
|
+
@param to The dependent's start.
|
|
50
|
+
@param stub The length of the first and last legs.
|
|
51
|
+
@param step The distance between neighboring row centers.
|
|
52
|
+
*/ export function elbowRoute(from, to, stub, step) {
|
|
53
|
+
const [x0, y0] = from, [x1, y1] = to;
|
|
54
|
+
if (y0 === y1 && x1 >= x0) return [
|
|
55
|
+
from,
|
|
56
|
+
to
|
|
57
|
+
];
|
|
58
|
+
const turn = x0 + stub;
|
|
59
|
+
if (x1 - x0 >= 2 * stub) return [
|
|
60
|
+
from,
|
|
61
|
+
[
|
|
62
|
+
turn,
|
|
63
|
+
y0
|
|
64
|
+
],
|
|
65
|
+
[
|
|
66
|
+
turn,
|
|
67
|
+
y1
|
|
68
|
+
],
|
|
69
|
+
to
|
|
70
|
+
];
|
|
71
|
+
const dir = y1 > y0 ? 1 : -1;
|
|
72
|
+
const mid = y0 + dir * step / 2;
|
|
73
|
+
const back = x1 - stub;
|
|
74
|
+
return [
|
|
75
|
+
from,
|
|
76
|
+
[
|
|
77
|
+
turn,
|
|
78
|
+
y0
|
|
79
|
+
],
|
|
80
|
+
[
|
|
81
|
+
turn,
|
|
82
|
+
mid
|
|
83
|
+
],
|
|
84
|
+
[
|
|
85
|
+
back,
|
|
86
|
+
mid
|
|
87
|
+
],
|
|
88
|
+
[
|
|
89
|
+
back,
|
|
90
|
+
y1
|
|
91
|
+
],
|
|
92
|
+
to
|
|
93
|
+
];
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
The label column's width: the widest label plus padding on both sides,
|
|
97
|
+
at most `limit` (a share of the chart's `width` when below 1, else
|
|
98
|
+
pixels). Zero when there are no labels or no room.
|
|
99
|
+
@param widest The widest label's width (with its indent).
|
|
100
|
+
@param width The chart's width.
|
|
101
|
+
@param limit The `labelWidth` setting.
|
|
102
|
+
@param padding The space on each side of the labels.
|
|
103
|
+
*/ export function labelColumnWidth(widest, width, limit, padding) {
|
|
104
|
+
if (!(widest > 0) || !(limit > 0)) return 0;
|
|
105
|
+
const most = limit <= 1 ? width * limit : limit;
|
|
106
|
+
return Math.max(0, Math.min(Math.ceil(widest + padding * 2), most));
|
|
107
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
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
|
+
*/ import { textWidth } from "@d3plus/dom";
|
|
6
|
+
import { fontFamilyStringify, textWrap } from "@d3plus/text";
|
|
7
|
+
import { resolveAccessor } from "../features/emitHelpers.js";
|
|
8
|
+
import { backgroundInk } from "../viz/backgroundInk.js";
|
|
9
|
+
/** The label font size, in pixels, unless `taskLabelConfig` sets one. */ export const LABEL_FONT_SIZE = 12;
|
|
10
|
+
/** Reads `taskLabelConfig`, with the chart's font and ink as defaults. */ export function ganttLabelFont(viz) {
|
|
11
|
+
const cfg = viz.schema.taskLabelConfig ?? {};
|
|
12
|
+
const size = resolveAccessor(cfg.fontSize, {}, 0);
|
|
13
|
+
const family = resolveAccessor(cfg.fontFamily, {}, 0) ?? viz.schema.fontFamily;
|
|
14
|
+
const fontSize = typeof size === "number" && size > 0 ? size : LABEL_FONT_SIZE;
|
|
15
|
+
return {
|
|
16
|
+
family: fontFamilyStringify(family),
|
|
17
|
+
size: fontSize,
|
|
18
|
+
color: resolveAccessor(cfg.fontColor, {}, 0) ?? backgroundInk(viz),
|
|
19
|
+
lineHeight: Math.round(fontSize * 1.2)
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
/** The width of `text` in the label font. */ export function labelWidth(text, font, weight = 400) {
|
|
23
|
+
return text ? textWidth(text, {
|
|
24
|
+
"font-family": font.family,
|
|
25
|
+
"font-size": font.size,
|
|
26
|
+
"font-weight": weight
|
|
27
|
+
}) : 0;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
Ends `text` in an ellipsis, dropping characters until it fits `width`.
|
|
31
|
+
@param text The line.
|
|
32
|
+
@param width The room it has.
|
|
33
|
+
@param measure Measures a line.
|
|
34
|
+
*/ export function ellipsize(text, width, measure) {
|
|
35
|
+
let t = text.trimEnd();
|
|
36
|
+
while(t.length){
|
|
37
|
+
const candidate = `${t}…`;
|
|
38
|
+
if (measure(candidate) <= width) return candidate;
|
|
39
|
+
t = t.slice(0, -1).trimEnd();
|
|
40
|
+
}
|
|
41
|
+
return "";
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
Wraps a label to `width`, over at most `maxLines` lines, ending the last
|
|
45
|
+
in an ellipsis when the label doesn't fit.
|
|
46
|
+
@param text The label.
|
|
47
|
+
@param width The room each line has.
|
|
48
|
+
@param maxLines The most lines it may take.
|
|
49
|
+
@param font The label font.
|
|
50
|
+
@param weight The font weight.
|
|
51
|
+
*/ export function fitLabel(text, width, maxLines, font, weight = 400) {
|
|
52
|
+
const measure = (t)=>labelWidth(t, font, weight);
|
|
53
|
+
if (!text || width <= 0 || maxLines < 1) return {
|
|
54
|
+
lines: [],
|
|
55
|
+
widths: []
|
|
56
|
+
};
|
|
57
|
+
const wrap = textWrap().fontFamily(font.family).fontSize(font.size).fontWeight(weight).lineHeight(font.lineHeight).width(width).height(font.lineHeight * maxLines).maxLines(maxLines)(text);
|
|
58
|
+
const lines = wrap.lines.filter((l)=>l !== "");
|
|
59
|
+
const shown = lines.join(" ").replace(/\s+/g, " ").trim();
|
|
60
|
+
const whole = text.replace(/\s+/g, " ").trim();
|
|
61
|
+
if (!lines.length) {
|
|
62
|
+
const only = ellipsize(whole, width, measure);
|
|
63
|
+
return only ? {
|
|
64
|
+
lines: [
|
|
65
|
+
only
|
|
66
|
+
],
|
|
67
|
+
widths: [
|
|
68
|
+
measure(only)
|
|
69
|
+
]
|
|
70
|
+
} : {
|
|
71
|
+
lines: [],
|
|
72
|
+
widths: []
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
if (wrap.truncated || shown.length < whole.length || measure(lines[lines.length - 1]) > width) {
|
|
76
|
+
const last = lines.length - 1;
|
|
77
|
+
const rest = whole.slice(lines.slice(0, last).join(" ").length + (last ? 1 : 0));
|
|
78
|
+
lines[last] = ellipsize(rest, width, measure);
|
|
79
|
+
if (!lines[last]) lines.pop();
|
|
80
|
+
}
|
|
81
|
+
return {
|
|
82
|
+
lines,
|
|
83
|
+
widths: lines.map(measure)
|
|
84
|
+
};
|
|
85
|
+
}
|
|
@@ -0,0 +1,111 @@
|
|
|
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
|
+
Whether a task draws as a milestone: when its `milestone` value is
|
|
7
|
+
truthy, or, without one, when it starts and ends at the same time.
|
|
8
|
+
@param start The task's start.
|
|
9
|
+
@param end The task's end.
|
|
10
|
+
@param flag The task's `milestone` value.
|
|
11
|
+
*/ export function isMilestone(start, end, flag) {
|
|
12
|
+
if (flag !== undefined && flag !== null && flag !== "") return !!flag;
|
|
13
|
+
return +start === +end;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
A `progress` value as a share from 0 to 1: a number is read as a
|
|
17
|
+
fraction (`0.6`), a string ending in `%` as a percent (`"60%"`), clamped
|
|
18
|
+
to 0–1. Anything else is undefined.
|
|
19
|
+
@param value The raw value.
|
|
20
|
+
*/ export function normalizeProgress(value) {
|
|
21
|
+
let n;
|
|
22
|
+
if (typeof value === "number") n = value;
|
|
23
|
+
else if (typeof value === "string" && value.trim().endsWith("%")) n = parseFloat(value) / 100;
|
|
24
|
+
else if (typeof value === "string" && value.trim() !== "") n = Number(value);
|
|
25
|
+
else return undefined;
|
|
26
|
+
if (!Number.isFinite(n)) return undefined;
|
|
27
|
+
return Math.max(0, Math.min(1, n));
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
A `dependencies` value as a list of task ids: an array, or a string of
|
|
31
|
+
comma-separated ids. Anything else is no dependencies.
|
|
32
|
+
@param value The raw value.
|
|
33
|
+
*/ export function dependencyIds(value) {
|
|
34
|
+
const list = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : typeof value === "number" ? [
|
|
35
|
+
value
|
|
36
|
+
] : [];
|
|
37
|
+
const ids = list.filter((v)=>v !== undefined && v !== null).map((v)=>`${v}`.trim()).filter((v)=>v !== "");
|
|
38
|
+
return Array.from(new Set(ids));
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
Orders tasks by `taskSort`: `"data"` keeps their order, `"start"` sorts
|
|
42
|
+
by start (then end), and a function compares their data rows. Ties keep
|
|
43
|
+
data order.
|
|
44
|
+
@param tasks The tasks.
|
|
45
|
+
@param sort The `taskSort` setting.
|
|
46
|
+
*/ export function sortTasks(tasks, sort) {
|
|
47
|
+
const byIndex = (a, b)=>a.i - b.i;
|
|
48
|
+
if (typeof sort === "function") return [
|
|
49
|
+
...tasks
|
|
50
|
+
].sort((a, b)=>sort(a.data, b.data) || byIndex(a, b));
|
|
51
|
+
if (sort === "start") return [
|
|
52
|
+
...tasks
|
|
53
|
+
].sort((a, b)=>+a.start - +b.start || +a.end - +b.end || byIndex(a, b));
|
|
54
|
+
return [
|
|
55
|
+
...tasks
|
|
56
|
+
].sort(byIndex);
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
The chart's rows, top to bottom. Tasks are ordered by `sort`; when any
|
|
60
|
+
task has a group, each group gets a header row (spanning its tasks'
|
|
61
|
+
earliest start to latest end) followed by its tasks, the groups in the
|
|
62
|
+
order their first task appears. Tasks without a group stay in place
|
|
63
|
+
among the groups, without a header.
|
|
64
|
+
@param tasks The tasks.
|
|
65
|
+
@param sort The `taskSort` setting.
|
|
66
|
+
*/ export function ganttRows(tasks, sort) {
|
|
67
|
+
const sorted = sortTasks(tasks, sort);
|
|
68
|
+
const taskRow = (task, indent)=>({
|
|
69
|
+
kind: "task",
|
|
70
|
+
key: `task-${task.id}`,
|
|
71
|
+
task,
|
|
72
|
+
indent
|
|
73
|
+
});
|
|
74
|
+
if (!sorted.some((t)=>t.group !== undefined)) return sorted.map((t)=>taskRow(t, false));
|
|
75
|
+
const groups = new Map();
|
|
76
|
+
const order = [];
|
|
77
|
+
for (const task of sorted){
|
|
78
|
+
if (task.group === undefined) {
|
|
79
|
+
order.push(task);
|
|
80
|
+
continue;
|
|
81
|
+
}
|
|
82
|
+
const list = groups.get(task.group);
|
|
83
|
+
if (list) list.push(task);
|
|
84
|
+
else {
|
|
85
|
+
groups.set(task.group, [
|
|
86
|
+
task
|
|
87
|
+
]);
|
|
88
|
+
order.push(task.group);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
const rows = [];
|
|
92
|
+
for (const entry of order){
|
|
93
|
+
if (typeof entry !== "string") {
|
|
94
|
+
rows.push(taskRow(entry, false));
|
|
95
|
+
continue;
|
|
96
|
+
}
|
|
97
|
+
const members = groups.get(entry);
|
|
98
|
+
rows.push({
|
|
99
|
+
kind: "group",
|
|
100
|
+
key: `group-${entry}`,
|
|
101
|
+
label: entry,
|
|
102
|
+
start: earliest(members.map((t)=>t.start)),
|
|
103
|
+
end: latest(members.map((t)=>t.end)),
|
|
104
|
+
tasks: members
|
|
105
|
+
});
|
|
106
|
+
members.forEach((t)=>rows.push(taskRow(t, true)));
|
|
107
|
+
}
|
|
108
|
+
return rows;
|
|
109
|
+
}
|
|
110
|
+
const earliest = (values)=>values.reduce((a, b)=>+b < +a ? b : a);
|
|
111
|
+
const latest = (values)=>values.reduce((a, b)=>+b > +a ? b : a);
|
|
@@ -0,0 +1,136 @@
|
|
|
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
|
+
*/ import { timeFormatLocale } from "d3-time-format";
|
|
6
|
+
import { dateFullFormatter, formatAbbreviate } from "@d3plus/format";
|
|
7
|
+
import { normalizeRangeBreaks, visibleBetween } from "../../components/Axis/rangeBreaks.js";
|
|
8
|
+
import { calendarTimeLocale } from "../Calendar/calendarFormat.js";
|
|
9
|
+
import { isTimeAxis, parseTime, rowTime } from "../Priestley/timeAxis.js";
|
|
10
|
+
import { isMilestone, normalizeProgress } from "./ganttRows.js";
|
|
11
|
+
/** A day, in milliseconds. */ const DAY = 864e5;
|
|
12
|
+
/**
|
|
13
|
+
Formats starts and ends: dates in the chart's locale, at the precision
|
|
14
|
+
the given dates step by (see `formatDateFull`), or numbers abbreviated.
|
|
15
|
+
@param viz The chart.
|
|
16
|
+
@param values The dates the chart draws, which set the precision.
|
|
17
|
+
*/ export function timeFormatter(viz, values) {
|
|
18
|
+
if (!isTimeAxis(viz)) return (v)=>formatAbbreviate(Number(v), viz.schema.locale);
|
|
19
|
+
const dates = Array.from(new Set(values.map(Number))).sort((a, b)=>a - b).map((t)=>new Date(t));
|
|
20
|
+
const locale = timeFormatLocale(calendarTimeLocale(viz.schema.locale));
|
|
21
|
+
const format = dateFullFormatter(dates, locale.format);
|
|
22
|
+
return (v)=>format(v instanceof Date ? v : new Date(v));
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
The time axis's `rangeBreaks` rules (from `axisConfig`) when they hide
|
|
26
|
+
whole days (weekends, weekdays, dates, or explicit ranges), else none: a
|
|
27
|
+
rule hiding hours of every day leaves no whole days to count.
|
|
28
|
+
@param viz The chart.
|
|
29
|
+
*/ export function ganttDayBreaks(viz) {
|
|
30
|
+
const config = viz.schema.axisConfig;
|
|
31
|
+
const rules = normalizeRangeBreaks(config?.rangeBreaks);
|
|
32
|
+
return rules.some((r)=>typeof r === "object" && "hours" in r) ? [] : rules;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
A task's duration: whole (or tenths of) days on a time axis, translated
|
|
36
|
+
("12 days"), else the difference of its end and start. When the axis's
|
|
37
|
+
`rangeBreaks` hide whole days (see `ganttDayBreaks`), only the days left
|
|
38
|
+
showing count ("8 working days").
|
|
39
|
+
*/ export function ganttDuration(viz, start, end) {
|
|
40
|
+
const span = +end - +start;
|
|
41
|
+
if (!isTimeAxis(viz)) return formatAbbreviate(span, viz.schema.locale);
|
|
42
|
+
const rules = ganttDayBreaks(viz);
|
|
43
|
+
const shown = rules.length ? visibleBetween(rules, +start, +end) : span;
|
|
44
|
+
const days = Math.round(shown / DAY * 10) / 10;
|
|
45
|
+
const unit = viz.schema.translate(`${rules.length ? "working " : ""}${days === 1 ? "day" : "days"}`);
|
|
46
|
+
return `${dayCount(days, viz.schema.locale)} ${unit}`;
|
|
47
|
+
}
|
|
48
|
+
/** A day count in a locale, with at most one decimal. */ export function dayCount(days, locale) {
|
|
49
|
+
try {
|
|
50
|
+
return new Intl.NumberFormat(typeof locale === "string" ? locale : "en-US", {
|
|
51
|
+
maximumFractionDigits: 1
|
|
52
|
+
}).format(days);
|
|
53
|
+
} catch {
|
|
54
|
+
return `${days}`;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
/** A share from 0 to 1 as a whole percent. */ export const percent = (share)=>`${Math.round(share * 100)}%`;
|
|
58
|
+
/**
|
|
59
|
+
Reads a row's start, end, milestone flag, and progress. A missing start
|
|
60
|
+
or end takes the other's value, and reversed times are swapped; null
|
|
61
|
+
when both are missing.
|
|
62
|
+
*/ export function taskTimes(viz, d, i) {
|
|
63
|
+
const time = isTimeAxis(viz);
|
|
64
|
+
let start = parseTime(rowTime(viz, "start", d, i), time);
|
|
65
|
+
let end = parseTime(rowTime(viz, "end", d, i), time);
|
|
66
|
+
if (start === null && end === null) return null;
|
|
67
|
+
start ??= end;
|
|
68
|
+
end ??= start;
|
|
69
|
+
if (+end < +start) [start, end] = [
|
|
70
|
+
end,
|
|
71
|
+
start
|
|
72
|
+
];
|
|
73
|
+
const milestoneFn = viz.schema.milestone;
|
|
74
|
+
const progressFn = viz.schema.progress;
|
|
75
|
+
return {
|
|
76
|
+
start: start,
|
|
77
|
+
end: end,
|
|
78
|
+
milestone: isMilestone(start, end, typeof milestoneFn === "function" ? milestoneFn(d, i) : undefined),
|
|
79
|
+
progress: normalizeProgress(typeof progressFn === "function" ? progressFn(d, i) : undefined)
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
/** The layout's start/end formatter, or one built from this row alone. */ function formatFor(viz, values) {
|
|
83
|
+
const layout = viz.ctx.gantt;
|
|
84
|
+
return layout?.format ?? timeFormatter(viz, values);
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
The tooltip rows for a task: Start, End, Duration, and Progress, or a
|
|
88
|
+
milestone's date and Progress, each label translated.
|
|
89
|
+
*/ export function ganttTooltipRows(viz, d, i) {
|
|
90
|
+
const task = taskTimes(viz, d, i);
|
|
91
|
+
if (!task) return [];
|
|
92
|
+
const t = (s)=>viz.schema.translate(s);
|
|
93
|
+
const format = formatFor(viz, [
|
|
94
|
+
task.start,
|
|
95
|
+
task.end
|
|
96
|
+
]);
|
|
97
|
+
const rows = task.milestone ? [
|
|
98
|
+
[
|
|
99
|
+
t("Milestone"),
|
|
100
|
+
format(task.end)
|
|
101
|
+
]
|
|
102
|
+
] : [
|
|
103
|
+
[
|
|
104
|
+
t("Start"),
|
|
105
|
+
format(task.start)
|
|
106
|
+
],
|
|
107
|
+
[
|
|
108
|
+
t("End"),
|
|
109
|
+
format(task.end)
|
|
110
|
+
],
|
|
111
|
+
[
|
|
112
|
+
t("Duration"),
|
|
113
|
+
ganttDuration(viz, task.start, task.end)
|
|
114
|
+
]
|
|
115
|
+
];
|
|
116
|
+
if (task.progress !== undefined) rows.push([
|
|
117
|
+
t("Progress"),
|
|
118
|
+
percent(task.progress)
|
|
119
|
+
]);
|
|
120
|
+
return rows;
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
A task's aria label: its name and span (or a milestone's date), and its
|
|
124
|
+
progress, such as `"Design, Jan 8, 2024 - Jan 19, 2024, Progress 60%."`.
|
|
125
|
+
*/ export function ganttAriaLabel(viz, d, i) {
|
|
126
|
+
const name = `${viz._drawLabel(d, i) ?? ""}`;
|
|
127
|
+
const task = taskTimes(viz, d, i);
|
|
128
|
+
if (!task) return `${name}.`;
|
|
129
|
+
const format = formatFor(viz, [
|
|
130
|
+
task.start,
|
|
131
|
+
task.end
|
|
132
|
+
]);
|
|
133
|
+
const when = task.milestone ? `${viz.schema.translate("Milestone")} ${format(task.end)}` : `${format(task.start)} - ${format(task.end)}`;
|
|
134
|
+
const progress = task.progress === undefined ? "" : `, ${viz.schema.translate("Progress")} ${percent(task.progress)}`;
|
|
135
|
+
return `${name}, ${when}${progress}.`;
|
|
136
|
+
}
|