@d3plus/core 4.9.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 +170 -9
- 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 +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- 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 +17 -12
- 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/Funnel/index.js +2 -1
- 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/Gauge/index.js +2 -1
- 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 +60 -19
- 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 +37 -16
- 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/Matrix/index.js +3 -2
- 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 +93 -108
- 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 +7 -2
- 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 +66 -32
- 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/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- 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 +14 -4
- 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 +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- 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/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- 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 +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -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 +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- 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 +5 -5
- 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 +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- 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 +65 -30
- 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 +75 -77
- 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/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- 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/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- 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 +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- 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 +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- 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 +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- 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 +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- 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 +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- 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 +42 -15
- 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 +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- 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 +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- 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 +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- 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 +123 -0
- 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/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -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 +34 -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 +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -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 +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- 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 +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- 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 +67 -79
- 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/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -9
- 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/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -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/Candlestick/aggregate.d.ts +6 -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/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -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 +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- 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 +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -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/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- 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/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -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/facet/facetData.d.ts +1 -1
- 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 +13 -1
- 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/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -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/features.d.ts +8 -0
- 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 +19 -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 +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- 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 +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -0
- 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/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- 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/missingFields.d.ts +57 -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/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -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 +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- 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/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -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 +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- 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/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -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 +2 -8
- 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/shapes/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -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 +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- 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,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
|
+
}
|
|
@@ -0,0 +1,219 @@
|
|
|
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
|
+
*/ import { mean } from "d3-array";
|
|
15
|
+
import { Axis } from "../../components/index.js";
|
|
16
|
+
import accessor from "../../utils/accessor.js";
|
|
17
|
+
import { fieldAccessor } from "../../utils/fieldAccessor.js";
|
|
18
|
+
import { makeChart } from "../definition/makeChart.js";
|
|
19
|
+
import { seedTimeAggs, timeFields } from "../Priestley/timeAxis.js";
|
|
20
|
+
import { applyGanttLayout } from "./applyLayout.js";
|
|
21
|
+
import { ganttEmit } from "./emit.js";
|
|
22
|
+
import { normalizeProgress } from "./ganttRows.js";
|
|
23
|
+
import { ganttTooltipRows } from "./ganttTooltip.js";
|
|
24
|
+
/**
|
|
25
|
+
Coerces a per-row option: a function is kept, a string becomes a data-key
|
|
26
|
+
accessor, and anything else turns it off.
|
|
27
|
+
*/ export function taskAccessor(v) {
|
|
28
|
+
if (typeof v === "function") return v;
|
|
29
|
+
if (typeof v === "string" && v) return fieldAccessor(v);
|
|
30
|
+
return false;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
Averages grouped rows' progress (as `aggs` call it, with the rows and an
|
|
34
|
+
accessor), reading percent strings as fractions.
|
|
35
|
+
*/ export function progressAgg(rows, value) {
|
|
36
|
+
return mean(rows.map((d)=>normalizeProgress(value(d))).filter((v)=>v !== undefined));
|
|
37
|
+
}
|
|
38
|
+
/** The `progress` field's `onSet`: a data key averages grouped rows' progress. */ const seedProgressAgg = (viz, v)=>{
|
|
39
|
+
const key = typeof v === "string" ? v : null;
|
|
40
|
+
if (key && !viz.schema.aggs[key]) viz.schema.aggs[key] = progressAgg;
|
|
41
|
+
};
|
|
42
|
+
export const ganttDef = {
|
|
43
|
+
name: "Gantt",
|
|
44
|
+
layoutStage: applyGanttLayout,
|
|
45
|
+
emit: ganttEmit,
|
|
46
|
+
setup: (viz)=>{
|
|
47
|
+
seedTimeAggs(viz);
|
|
48
|
+
if (!viz.schema.aggs.progress) viz.schema.aggs.progress = progressAgg;
|
|
49
|
+
},
|
|
50
|
+
ctx: {
|
|
51
|
+
axis: new Axis().align("start").orient("top"),
|
|
52
|
+
axisTest: new Axis().align("start").gridSize(0).orient("top")
|
|
53
|
+
},
|
|
54
|
+
fields: [
|
|
55
|
+
/**
|
|
56
|
+
The time axis along the top of the rows (`orient: "bottom"` moves it
|
|
57
|
+
under them). It reads dates by default (`scale: "time"`); a
|
|
58
|
+
`rangeBreaks` setting such as `"weekends"` hides those times, and a
|
|
59
|
+
task's Duration then counts only the working days left showing.
|
|
60
|
+
*/ {
|
|
61
|
+
key: "axisConfig",
|
|
62
|
+
merge: true,
|
|
63
|
+
default: {
|
|
64
|
+
scale: "time"
|
|
65
|
+
}
|
|
66
|
+
},
|
|
67
|
+
/**
|
|
68
|
+
Accessor function or string key for each task's predecessors: the ids
|
|
69
|
+
(by `groupBy`) of the tasks it waits on, as an array or a
|
|
70
|
+
comma-separated string. Each draws an arrow from the predecessor's end
|
|
71
|
+
to this task's start.
|
|
72
|
+
@type {string | function | false}
|
|
73
|
+
*/ {
|
|
74
|
+
key: "dependencies",
|
|
75
|
+
default: accessor("dependencies"),
|
|
76
|
+
coerce: taskAccessor
|
|
77
|
+
},
|
|
78
|
+
/**
|
|
79
|
+
Styles the dependency arrows: `stroke` (the chart's text color by
|
|
80
|
+
default), `strokeWidth` (1), `strokeOpacity` (0.55), and `arrowSize`
|
|
81
|
+
(6, in pixels).
|
|
82
|
+
@type {{stroke, strokeWidth, strokeOpacity, arrowSize}}
|
|
83
|
+
*/ {
|
|
84
|
+
key: "dependencyConfig",
|
|
85
|
+
merge: true,
|
|
86
|
+
default: {}
|
|
87
|
+
},
|
|
88
|
+
...timeFields(),
|
|
89
|
+
/**
|
|
90
|
+
Accessor function or string key for each task's group (such as its
|
|
91
|
+
project phase). Grouped tasks sit under a header row that names the
|
|
92
|
+
group, with a bracket spanning its tasks.
|
|
93
|
+
@type {string | function | false}
|
|
94
|
+
*/ {
|
|
95
|
+
key: "group",
|
|
96
|
+
default: false,
|
|
97
|
+
coerce: taskAccessor
|
|
98
|
+
},
|
|
99
|
+
/**
|
|
100
|
+
The most the task label column on the left may take: a share of the
|
|
101
|
+
chart's width when 1 or below (`0.3` by default), else pixels. The
|
|
102
|
+
column fits the widest label up to it, wrapping or truncating longer
|
|
103
|
+
ones; `0` hides it.
|
|
104
|
+
*/ {
|
|
105
|
+
key: "labelWidth",
|
|
106
|
+
default: 0.3
|
|
107
|
+
},
|
|
108
|
+
/**
|
|
109
|
+
Shows a legend only when its entries group the tasks (for example, a
|
|
110
|
+
`color` by phase), since every task is labeled in its row.
|
|
111
|
+
*/ {
|
|
112
|
+
key: "legend",
|
|
113
|
+
coerce: "const",
|
|
114
|
+
factory: (viz)=>{
|
|
115
|
+
const base = viz.schema.legend;
|
|
116
|
+
return (config, arr)=>{
|
|
117
|
+
const rows = viz._filteredData ?? [];
|
|
118
|
+
if (arr.length >= rows.length) return false;
|
|
119
|
+
return base.call(viz, config, arr);
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
/**
|
|
124
|
+
Accessor function or string key for whether a task is a milestone,
|
|
125
|
+
drawn as a diamond at its `end`. Without one, a task that starts and
|
|
126
|
+
ends at the same time is a milestone.
|
|
127
|
+
@type {string | function | false}
|
|
128
|
+
*/ {
|
|
129
|
+
key: "milestone",
|
|
130
|
+
default: accessor("milestone"),
|
|
131
|
+
coerce: taskAccessor
|
|
132
|
+
},
|
|
133
|
+
/**
|
|
134
|
+
The space between neighboring task bars, as a share of each row
|
|
135
|
+
(see d3's
|
|
136
|
+
[paddingInner](https://github.com/d3/d3-scale#band_paddingInner)).
|
|
137
|
+
*/ {
|
|
138
|
+
key: "paddingInner",
|
|
139
|
+
default: 0.35
|
|
140
|
+
},
|
|
141
|
+
/**
|
|
142
|
+
The space above the first row and below the last, as a share of a row
|
|
143
|
+
(see d3's
|
|
144
|
+
[paddingOuter](https://github.com/d3/d3-scale#band_paddingOuter)).
|
|
145
|
+
*/ {
|
|
146
|
+
key: "paddingOuter",
|
|
147
|
+
default: 0.2
|
|
148
|
+
},
|
|
149
|
+
/**
|
|
150
|
+
Accessor function or string key for each task's progress: a fraction
|
|
151
|
+
from 0 to 1 (`0.6`), or a percent string (`"60%"`). The done part of
|
|
152
|
+
the bar fills in the task's color and the rest in a paler shade; the
|
|
153
|
+
tooltip lists it. A milestone below 100% draws pale and outlined. A
|
|
154
|
+
key also averages grouped rows' progress.
|
|
155
|
+
@type {string | function | false}
|
|
156
|
+
*/ {
|
|
157
|
+
key: "progress",
|
|
158
|
+
default: accessor("progress"),
|
|
159
|
+
coerce: taskAccessor,
|
|
160
|
+
onSet: seedProgressAgg
|
|
161
|
+
},
|
|
162
|
+
/**
|
|
163
|
+
The order of the tasks: `"data"` (default) keeps the data's order,
|
|
164
|
+
`"start"` sorts them by start, and a function compares two data rows.
|
|
165
|
+
Groups follow their first task.
|
|
166
|
+
@type {"data" | "start" | function}
|
|
167
|
+
*/ {
|
|
168
|
+
key: "taskSort",
|
|
169
|
+
default: "data"
|
|
170
|
+
},
|
|
171
|
+
/**
|
|
172
|
+
Styles the task label column: `fontColor` (the chart's text color by
|
|
173
|
+
default), `fontFamily`, and `fontSize` (12).
|
|
174
|
+
@type {{fontColor, fontFamily, fontSize}}
|
|
175
|
+
*/ {
|
|
176
|
+
key: "taskLabelConfig",
|
|
177
|
+
merge: true,
|
|
178
|
+
default: {}
|
|
179
|
+
},
|
|
180
|
+
/**
|
|
181
|
+
Draws a "today" line across the rows: `true` at the current time, or a
|
|
182
|
+
date (or anything the axis parses) to mark that time. Off (`false`) by
|
|
183
|
+
default. It only draws inside the time axis.
|
|
184
|
+
@type {boolean | Date | string | number}
|
|
185
|
+
*/ {
|
|
186
|
+
key: "today",
|
|
187
|
+
default: false
|
|
188
|
+
},
|
|
189
|
+
/**
|
|
190
|
+
Styles the "today" line like a `referenceLines` entry: `stroke`,
|
|
191
|
+
`strokeWidth` (1.5), `strokeOpacity` (0.85), `dash`, and its `label`
|
|
192
|
+
(the translated "Today"; `false` for none), with the label's font
|
|
193
|
+
settings and `labelPosition`.
|
|
194
|
+
@type {ReferenceLineConfig}
|
|
195
|
+
*/ {
|
|
196
|
+
key: "todayConfig",
|
|
197
|
+
merge: true,
|
|
198
|
+
default: {}
|
|
199
|
+
},
|
|
200
|
+
/** Lists each task's Start, End, Duration, and Progress in the tooltip body. */ {
|
|
201
|
+
key: "tooltipConfig",
|
|
202
|
+
merge: true,
|
|
203
|
+
factory: (viz)=>({
|
|
204
|
+
tbody: (d, i)=>ganttTooltipRows(viz, d, i)
|
|
205
|
+
})
|
|
206
|
+
},
|
|
207
|
+
/** Zooming doesn't help read a schedule's rows, so it's off by default. */ {
|
|
208
|
+
key: "zoom",
|
|
209
|
+
default: false
|
|
210
|
+
}
|
|
211
|
+
]
|
|
212
|
+
};
|
|
213
|
+
/**
|
|
214
|
+
Creates a Gantt chart from an array of tasks: one labeled row per task,
|
|
215
|
+
its bar running from `start` to `end` over a time axis. Tasks can be
|
|
216
|
+
grouped into phases (`group`), drawn as milestones (`milestone`), linked
|
|
217
|
+
by dependency arrows (`dependencies`), and filled by their `progress`,
|
|
218
|
+
with an optional `today` line.
|
|
219
|
+
*/ export default makeChart(ganttDef);
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
- `emit.ts` — the dial plus one indicator per row.
|
|
11
11
|
*/ import { formatAbbreviate } from "@d3plus/format";
|
|
12
12
|
import accessor from "../../utils/accessor.js";
|
|
13
|
+
import { fieldAccessor } from "../../utils/fieldAccessor.js";
|
|
13
14
|
import constant from "../../utils/constant.js";
|
|
14
15
|
import { makeChart } from "../definition/makeChart.js";
|
|
15
16
|
import { chartBackground } from "../viz/backgroundInk.js";
|
|
@@ -124,7 +125,7 @@ export const gaugeDef = {
|
|
|
124
125
|
*/ {
|
|
125
126
|
key: "value",
|
|
126
127
|
default: accessor("value"),
|
|
127
|
-
coerce: (v)=>typeof v === "function" ? v : typeof v === "string" ?
|
|
128
|
+
coerce: (v)=>typeof v === "function" ? v : typeof v === "string" ? fieldAccessor(v) : constant(v)
|
|
128
129
|
},
|
|
129
130
|
/**
|
|
130
131
|
Formats the value shown under the hub and in each tooltip, as
|