@d3plus/core 4.10.0 → 4.12.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 +178 -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 +176 -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 +101 -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 +192 -0
- package/es/src/charts/ArcDiagram/events.js +148 -0
- package/es/src/charts/ArcDiagram/index.js +217 -0
- package/es/src/charts/BarChart/index.js +12 -7
- 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 +5 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +6 -11
- 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 +160 -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 +137 -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 +206 -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 +6 -4
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/applyLayout.js +20 -9
- package/es/src/charts/Matrix/index.js +19 -1
- package/es/src/charts/Network/applyLayout.js +171 -96
- package/es/src/charts/Network/bundle.js +82 -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 +257 -75
- package/es/src/charts/Network/graph.js +146 -0
- package/es/src/charts/Network/graphFluent.js +81 -0
- package/es/src/charts/Network/index.js +91 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/applyLayout.js +16 -5
- package/es/src/charts/Pack/emit.js +15 -8
- package/es/src/charts/Pack/groupRows.js +61 -0
- package/es/src/charts/Pack/index.js +8 -1
- package/es/src/charts/Pack/neutralPaint.js +20 -0
- package/es/src/charts/Pack/nodeNames.js +35 -0
- package/es/src/charts/ParallelCoordinates/axes.js +22 -22
- package/es/src/charts/ParallelCoordinates/chrome.js +18 -0
- package/es/src/charts/ParallelCoordinates/index.js +3 -1
- package/es/src/charts/ParallelCoordinates/titles.js +17 -9
- 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 +51 -96
- package/es/src/charts/Pie/index.js +74 -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/areaEnter.js +68 -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 +34 -14
- 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 +19 -17
- 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/lineMarkerKeys.js +19 -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 +40 -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/shapeLabelLegend.js +67 -0
- package/es/src/charts/Plot/sharedHover.js +2 -1
- package/es/src/charts/Plot/sharedTooltip.js +13 -3
- 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 +4 -3
- package/es/src/charts/Priestley/applyLayout.js +21 -23
- package/es/src/charts/Priestley/index.js +4 -37
- package/es/src/charts/Priestley/timeAxis.js +103 -0
- package/es/src/charts/Pyramid/gutter.js +52 -16
- package/es/src/charts/Pyramid/index.js +55 -7
- package/es/src/charts/Pyramid/scene.js +4 -4
- package/es/src/charts/Radar/applyLayout.js +31 -33
- package/es/src/charts/Radar/axisDecorations.js +62 -13
- package/es/src/charts/Radar/curvedLabels.js +228 -0
- package/es/src/charts/Radar/emit.js +30 -15
- package/es/src/charts/Radar/index.js +43 -5
- package/es/src/charts/Radar/points.js +85 -0
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +9 -1
- package/es/src/charts/RadialBar/index.js +26 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/applyLayout.js +115 -31
- package/es/src/charts/RadialMatrix/index.js +18 -9
- package/es/src/charts/Rings/applyLayout.js +39 -161
- package/es/src/charts/Rings/emit.js +219 -63
- package/es/src/charts/Rings/index.js +88 -32
- package/es/src/charts/Rings/ringsCurves.js +156 -0
- 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 +183 -0
- package/es/src/charts/Rings/ringsPlacement.js +152 -0
- package/es/src/charts/Rings/ringsSizing.js +61 -38
- package/es/src/charts/Sankey/applyLayout.js +130 -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 +78 -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 +83 -64
- package/es/src/charts/Sunburst/index.js +16 -4
- package/es/src/charts/Tree/applyLayout.js +44 -14
- package/es/src/charts/Tree/emit.js +5 -5
- package/es/src/charts/Tree/index.js +12 -18
- package/es/src/charts/Tree/keys.js +33 -0
- package/es/src/charts/Tree/nodeLabel.js +15 -0
- package/es/src/charts/Treemap/emitGroupHeaders.js +3 -5
- 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 +14 -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 +10 -25
- 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/zoomActions.js +36 -0
- package/es/src/charts/drawSteps/zoomControls.js +52 -23
- package/es/src/charts/drawSteps/zoomControlsMarkup.js +23 -4
- package/es/src/charts/drawSteps/zoomDrag.js +188 -0
- package/es/src/charts/drawSteps/zoomFit.js +69 -0
- package/es/src/charts/events/click.legend.js +11 -4
- package/es/src/charts/events/click.shape.js +13 -4
- package/es/src/charts/events/mouseenter.js +6 -16
- package/es/src/charts/events/mouseleave.js +9 -2
- package/es/src/charts/events/mousemove.legend.js +28 -32
- package/es/src/charts/events/mousemove.shape.js +45 -42
- 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 +17 -5
- package/es/src/charts/features/axesFinal.js +10 -3
- package/es/src/charts/features/axesMeasure.js +33 -12
- package/es/src/charts/features/axisTooltip.js +138 -0
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/centerLabel.js +177 -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/colorScaleBivariate.js +83 -0
- package/es/src/charts/features/colorScaleBucket.js +20 -1
- package/es/src/charts/features/colorScaleHover.js +33 -7
- package/es/src/charts/features/colorScaleLimit.js +73 -0
- package/es/src/charts/features/colorScaleTooltip.js +77 -0
- package/es/src/charts/features/colorScaleTop.js +61 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +191 -0
- package/es/src/charts/features/depthKey.js +26 -0
- package/es/src/charts/features/edgeArrows.js +220 -5
- 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 +75 -20
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/hoverTicks.js +41 -0
- package/es/src/charts/features/idleQueue.js +72 -0
- 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 +364 -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/networkMeasures.js +241 -0
- package/es/src/charts/features/nodeStats.js +309 -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/plotEndLabels.js +28 -7
- package/es/src/charts/features/plotPaint.js +46 -12
- 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 +54 -32
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +30 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +14 -5
- package/es/src/charts/partition/interaction.js +19 -10
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +22 -9
- 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/chrome.js +81 -9
- package/es/src/charts/polar/config.js +6 -3
- package/es/src/charts/polar/wedgeLayout.js +2 -1
- package/es/src/charts/viz/Viz.js +61 -49
- package/es/src/charts/viz/VizBase.js +57 -14
- package/es/src/charts/viz/backgroundInk.js +23 -7
- package/es/src/charts/viz/emphasis.js +14 -0
- package/es/src/charts/viz/fillStroke.js +10 -0
- 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/interactionOpacity.js +115 -32
- 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/reportDrawError.js +15 -0
- package/es/src/charts/viz/setCursor.js +29 -0
- package/es/src/charts/viz/tooltipEnabled.js +38 -0
- package/es/src/charts/viz/userClick.js +34 -0
- package/es/src/charts/viz/vizDataPolling.js +8 -4
- package/es/src/charts/viz/vizDefaults.js +28 -57
- package/es/src/charts/viz/vizFields.js +41 -1
- package/es/src/charts/viz/vizRender.js +76 -31
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +26 -2
- package/es/src/components/Axis/Axis.js +35 -2
- 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 +33 -8
- package/es/src/components/Axis/axisDefaults.js +16 -9
- package/es/src/components/Axis/axisLabelKinds.js +36 -0
- package/es/src/components/Axis/axisLabelLineHeight.js +19 -0
- package/es/src/components/Axis/axisLabelRoom.js +37 -0
- package/es/src/components/Axis/axisLabelSize.js +171 -0
- package/es/src/components/Axis/axisLabelThinning.js +98 -4
- package/es/src/components/Axis/axisLayout.js +71 -46
- package/es/src/components/Axis/axisLayoutLabels.js +82 -140
- package/es/src/components/Axis/axisLayoutScale.js +16 -11
- package/es/src/components/Axis/axisLimit.js +27 -0
- package/es/src/components/Axis/axisMaxSize.js +39 -0
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +20 -8
- package/es/src/components/Axis/axisRounding.js +16 -1
- package/es/src/components/Axis/axisScene.js +11 -2
- package/es/src/components/Axis/axisTitle.js +53 -0
- package/es/src/components/Axis/axisTooltipTargets.js +128 -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 +77 -27
- package/es/src/components/ColorScale/bivariateRender.js +353 -0
- package/es/src/components/ColorScale/bivariateScale.js +150 -0
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleRender.js +32 -2
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/ColorScale/colorScaleSwatchTooltips.js +77 -0
- package/es/src/components/Legend/Legend.js +13 -2
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/Legend/legendCut.js +108 -0
- package/es/src/components/Legend/legendRender.js +38 -13
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +34 -67
- 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 +9 -4
- 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 +226 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/components/textEllipsis.js +7 -0
- package/es/src/components/tooltipDom.js +8 -5
- package/es/src/fluent.js +48 -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 +30 -12
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configValue.js +9 -0
- 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 +268 -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 +46 -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 +24 -0
- package/types/src/charts/ArcDiagram/events.d.ts +29 -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 +36 -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/Matrix/applyLayout.d.ts +4 -2
- package/types/src/charts/Network/applyLayout.d.ts +11 -0
- package/types/src/charts/Network/bundle.d.ts +69 -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 +73 -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/Pack/applyLayout.d.ts +2 -0
- package/types/src/charts/Pack/groupRows.d.ts +46 -0
- package/types/src/charts/Pack/index.d.ts +3 -0
- package/types/src/charts/Pack/neutralPaint.d.ts +14 -0
- package/types/src/charts/Pack/nodeNames.d.ts +23 -0
- package/types/src/charts/ParallelCoordinates/chrome.d.ts +12 -0
- package/types/src/charts/ParallelCoordinates/index.d.ts +1 -0
- package/types/src/charts/ParallelCoordinates/titles.d.ts +7 -2
- package/types/src/charts/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/areaEnter.d.ts +34 -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 +16 -15
- 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/lineMarkerKeys.d.ts +11 -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/shapeLabelLegend.d.ts +19 -0
- package/types/src/charts/Plot/sharedTooltip.d.ts +7 -1
- 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 +79 -0
- package/types/src/charts/Pyramid/gutter.d.ts +28 -6
- package/types/src/charts/Pyramid/scene.d.ts +1 -1
- package/types/src/charts/Radar/applyLayout.d.ts +2 -3
- package/types/src/charts/Radar/axisDecorations.d.ts +12 -4
- package/types/src/charts/Radar/curvedLabels.d.ts +129 -0
- package/types/src/charts/Radar/emit.d.ts +5 -2
- package/types/src/charts/Radar/index.d.ts +7 -2
- package/types/src/charts/Radar/points.d.ts +50 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/RadialMatrix/applyLayout.d.ts +6 -4
- package/types/src/charts/Rings/emit.d.ts +72 -0
- package/types/src/charts/Rings/index.d.ts +4 -2
- package/types/src/charts/Rings/ringsCurves.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +39 -7
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +45 -0
- package/types/src/charts/Rings/ringsPlacement.d.ts +47 -0
- package/types/src/charts/Rings/ringsSizing.d.ts +36 -9
- 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/Tree/applyLayout.d.ts +20 -0
- package/types/src/charts/Tree/keys.d.ts +25 -0
- package/types/src/charts/Tree/nodeLabel.d.ts +11 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +26 -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/zoomActions.d.ts +30 -0
- package/types/src/charts/drawSteps/zoomControls.d.ts +15 -0
- package/types/src/charts/drawSteps/zoomControlsMarkup.d.ts +16 -1
- package/types/src/charts/drawSteps/zoomDrag.d.ts +71 -0
- package/types/src/charts/drawSteps/zoomFit.d.ts +30 -0
- 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/axisTooltip.d.ts +49 -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/centerLabel.d.ts +75 -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/colorScaleBivariate.d.ts +50 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +10 -0
- package/types/src/charts/features/colorScaleHover.d.ts +13 -3
- package/types/src/charts/features/colorScaleLimit.d.ts +60 -0
- package/types/src/charts/features/colorScaleTooltip.d.ts +43 -0
- package/types/src/charts/features/colorScaleTop.d.ts +30 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +119 -0
- package/types/src/charts/features/depthKey.d.ts +19 -0
- package/types/src/charts/features/edgeArrows.d.ts +103 -4
- 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/hoverTicks.d.ts +30 -0
- package/types/src/charts/features/idleQueue.d.ts +46 -0
- 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 +192 -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/networkMeasures.d.ts +53 -0
- package/types/src/charts/features/nodeStats.d.ts +93 -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/plotEndLabels.d.ts +14 -1
- 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 +15 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/chartFields.d.ts +6 -1
- 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/insetPlacement.d.ts +6 -0
- 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/polar/chrome.d.ts +19 -6
- package/types/src/charts/viz/Viz.d.ts +25 -4
- package/types/src/charts/viz/VizBase.d.ts +37 -8
- package/types/src/charts/viz/backgroundInk.d.ts +19 -4
- package/types/src/charts/viz/emphasis.d.ts +17 -0
- package/types/src/charts/viz/fillStroke.d.ts +7 -0
- package/types/src/charts/viz/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/reportDrawError.d.ts +12 -0
- package/types/src/charts/viz/setCursor.d.ts +26 -0
- package/types/src/charts/viz/tooltipEnabled.d.ts +31 -0
- package/types/src/charts/viz/userClick.d.ts +35 -0
- package/types/src/charts/viz/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +37 -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 +100 -7
- package/types/src/charts/viz/vizVisibility.d.ts +13 -0
- package/types/src/components/Axis/Axis.d.ts +34 -3
- 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 +21 -3
- package/types/src/components/Axis/axisDefaults.d.ts +12 -0
- package/types/src/components/Axis/axisLabelKinds.d.ts +22 -0
- package/types/src/components/Axis/axisLabelLineHeight.d.ts +27 -0
- package/types/src/components/Axis/axisLabelRoom.d.ts +17 -0
- package/types/src/components/Axis/axisLabelSize.d.ts +82 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +38 -2
- package/types/src/components/Axis/axisLayout.d.ts +9 -2
- package/types/src/components/Axis/axisLayoutLabels.d.ts +28 -33
- package/types/src/components/Axis/axisLayoutScale.d.ts +3 -1
- package/types/src/components/Axis/axisLimit.d.ts +18 -0
- package/types/src/components/Axis/axisMaxSize.d.ts +48 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +8 -0
- package/types/src/components/Axis/axisTitle.d.ts +30 -0
- package/types/src/components/Axis/axisTooltipTargets.d.ts +82 -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 +22 -11
- package/types/src/components/ColorScale/bivariateRender.d.ts +53 -0
- package/types/src/components/ColorScale/bivariateScale.d.ts +92 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/ColorScale/colorScaleSwatchTooltips.d.ts +48 -0
- package/types/src/components/Legend/Legend.d.ts +6 -0
- package/types/src/components/Legend/legendCut.d.ts +31 -0
- package/types/src/components/Legend/legendRender.d.ts +6 -1
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +5 -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/components/textEllipsis.d.ts +6 -0
- package/types/src/fluent.d.ts +18 -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/shapes/emitLabels.d.ts +1 -1
- package/types/src/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +1093 -266
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configValue.d.ts +8 -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/types/umd-entry.d.ts +4 -0
- package/umd/d3plus-core.full.js +72239 -41465
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +46249 -19519
- 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,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Arrowheads on curved edge ends. On a curve, the tangent at the tip and
|
|
3
|
+
the curve a few pixels back point different ways, so a head aimed along
|
|
4
|
+
the tangent leaves the stroke's end off its axis. Here a head is aimed
|
|
5
|
+
along the chord from where its base sits on the path to its tip, and the
|
|
6
|
+
stroke follows the path up to the base, then runs straight along that
|
|
7
|
+
chord to end inside the head (see `arrowTrim`). The join at the base is
|
|
8
|
+
under the head, so the stroke reads smooth.
|
|
9
|
+
|
|
10
|
+
The path is a polyline (a sampled curve, or projected points such as a
|
|
11
|
+
map's) or a cubic Bézier curve.
|
|
12
|
+
*/
|
|
13
|
+
import type { DataPoint } from "@d3plus/data";
|
|
14
|
+
import type { SceneNode } from "@d3plus/render";
|
|
15
|
+
import type { EdgeArrowTrims } from "./edgeArrows.js";
|
|
16
|
+
import type { Point } from "./polyline.js";
|
|
17
|
+
type Cubic = [Point, Point, Point, Point];
|
|
18
|
+
/** One arrowed end of an edge: its head's tip and direction, its base on the path, and where the stroke ends. */
|
|
19
|
+
export interface ArrowedEnd {
|
|
20
|
+
tip: Point;
|
|
21
|
+
/** The head's direction, from its base to its tip, in radians. */
|
|
22
|
+
angle: number;
|
|
23
|
+
/** Where the head's base sits on the path. */
|
|
24
|
+
base: Point;
|
|
25
|
+
/** Where the stroke ends: on the head's axis, `trim` back from its tip. */
|
|
26
|
+
cut: Point;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
The point `distance` pixels back along a polyline from its last point
|
|
30
|
+
(its first point when the polyline is shorter than that). Pass the
|
|
31
|
+
points reversed for a distance from the first point.
|
|
32
|
+
*/
|
|
33
|
+
export declare function pathPointBack(points: readonly Point[], distance: number): Point;
|
|
34
|
+
/** A cubic Bézier curve as a polyline of `steps` chords. */
|
|
35
|
+
export declare function cubicPolyline(curve: Cubic, steps?: number): Point[];
|
|
36
|
+
/** The direction (radians) of the chord from `base` to `tip`. */
|
|
37
|
+
export declare function chordAngle(base: Point, tip: Point): number;
|
|
38
|
+
/**
|
|
39
|
+
A head at `tip` aimed along the chord from `base` (where its base sits
|
|
40
|
+
on the path), and the stroke's end `trim` back from the tip on that
|
|
41
|
+
chord.
|
|
42
|
+
*/
|
|
43
|
+
export declare function arrowAlongChord(tip: Point, base: Point, trim: number): ArrowedEnd;
|
|
44
|
+
/**
|
|
45
|
+
A cubic edge's visible stroke and its arrowed ends: each head's tip sits
|
|
46
|
+
`tipBack` pixels back along the curve from its end, its base `size`
|
|
47
|
+
further back, and the stroke runs along the curve between the bases,
|
|
48
|
+
then straight along each head's axis to its `cut`.
|
|
49
|
+
@param curve The edge, from its source end to its target end.
|
|
50
|
+
@param trims The edge's arrow ends, size, and stroke trims (see `edgeArrowTrims`).
|
|
51
|
+
@param tipBack How far back along the curve each end's tip sits.
|
|
52
|
+
*/
|
|
53
|
+
export declare function cubicArrowEdge(curve: Cubic, trims: EdgeArrowTrims, tipBack?: {
|
|
54
|
+
source: number;
|
|
55
|
+
target: number;
|
|
56
|
+
}): {
|
|
57
|
+
d: string;
|
|
58
|
+
source?: ArrowedEnd;
|
|
59
|
+
target?: ArrowedEnd;
|
|
60
|
+
};
|
|
61
|
+
/** Joined cubic Bézier curves as one path's `d`. */
|
|
62
|
+
export declare function cubicsPathD(curves: readonly Cubic[]): string;
|
|
63
|
+
/**
|
|
64
|
+
`cubicArrowEdge` for a path of joined cubics, from the first's start to
|
|
65
|
+
the last's end: each arrowed end is taken on its end's cubic.
|
|
66
|
+
*/
|
|
67
|
+
export declare function cubicsArrowEdge(curves: readonly Cubic[], trims: EdgeArrowTrims, tipBack?: {
|
|
68
|
+
source: number;
|
|
69
|
+
target: number;
|
|
70
|
+
}): {
|
|
71
|
+
d: string;
|
|
72
|
+
source?: ArrowedEnd;
|
|
73
|
+
target?: ArrowedEnd;
|
|
74
|
+
};
|
|
75
|
+
/**
|
|
76
|
+
A polyline edge's visible stroke and its arrowed ends: each head's tip
|
|
77
|
+
sits `tipBack` pixels back along the polyline from its end, its base
|
|
78
|
+
`size` further back, and the stroke follows the polyline between the
|
|
79
|
+
bases, then runs straight along each head's axis to its `cut`.
|
|
80
|
+
@param points The edge, from its source end to its target end: one
|
|
81
|
+
polyline, or the runs of a path cut into pieces (a map projection's),
|
|
82
|
+
whose first run starts at the source and last run ends at the target.
|
|
83
|
+
@param trims The edge's arrow ends, size, and stroke trims (see `edgeArrowTrims`).
|
|
84
|
+
@param tipBack How far back along the polyline each end's tip sits.
|
|
85
|
+
*/
|
|
86
|
+
export declare function polylineArrowEdge(points: Point[] | Point[][], trims: EdgeArrowTrims, tipBack?: {
|
|
87
|
+
source: number;
|
|
88
|
+
target: number;
|
|
89
|
+
}): {
|
|
90
|
+
d: string;
|
|
91
|
+
source?: ArrowedEnd;
|
|
92
|
+
target?: ArrowedEnd;
|
|
93
|
+
};
|
|
94
|
+
/**
|
|
95
|
+
A path `body` (starting with its own `M`) extended straight along each
|
|
96
|
+
arrowed end's axis: from the source head's `cut` to the body's start,
|
|
97
|
+
and from the body's end to the target head's `cut`.
|
|
98
|
+
*/
|
|
99
|
+
export declare function chordEndsPathD(body: string, source?: ArrowedEnd, target?: ArrowedEnd): string;
|
|
100
|
+
/**
|
|
101
|
+
The head nodes for an edge's arrowed ends, keyed `${keyPrefix}-t` and
|
|
102
|
+
`${keyPrefix}-s`, or by `keys`.
|
|
103
|
+
*/
|
|
104
|
+
export declare function chordArrowNodes(opts: {
|
|
105
|
+
ends: {
|
|
106
|
+
source?: ArrowedEnd;
|
|
107
|
+
target?: ArrowedEnd;
|
|
108
|
+
};
|
|
109
|
+
size: number;
|
|
110
|
+
datum: DataPoint;
|
|
111
|
+
keyPrefix: string;
|
|
112
|
+
keys?: {
|
|
113
|
+
source: string;
|
|
114
|
+
target: string;
|
|
115
|
+
};
|
|
116
|
+
fill?: string;
|
|
117
|
+
opacity?: number;
|
|
118
|
+
}): SceneNode[];
|
|
119
|
+
export {};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The hierarchy depth Tree records on a node's row (1 for a top-level
|
|
3
|
+
node), so code handed the row alone, like a tooltip's title, knows the
|
|
4
|
+
node's level. It lives under its own key so a data field named `depth` is
|
|
5
|
+
never overwritten; the plain `depth` key mirrors it only on rows without
|
|
6
|
+
their own `depth` field.
|
|
7
|
+
*/
|
|
8
|
+
/** The row key d3plus writes a node's hierarchy depth under. */
|
|
9
|
+
export declare const DEPTH_KEY = "__d3plusDepth";
|
|
10
|
+
/**
|
|
11
|
+
Writes `depth` onto `row` under `DEPTH_KEY`, and as `depth` too unless the
|
|
12
|
+
row already has a `depth` of its own.
|
|
13
|
+
*/
|
|
14
|
+
export declare function stampDepth(row: Record<string, unknown>, depth: number): void;
|
|
15
|
+
/**
|
|
16
|
+
The hierarchy depth d3plus wrote on a row, or on the row under a shape or
|
|
17
|
+
legend wrapper. Undefined when it carries none.
|
|
18
|
+
*/
|
|
19
|
+
export declare function depthOf(d: Record<string, unknown> | undefined | null): number | undefined;
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
Shared arrowhead geometry for edge charts (Network, Rings,
|
|
2
|
+
Shared arrowhead geometry for edge charts (Network, Rings, ArcDiagram,
|
|
3
|
+
Geomap, Gantt).
|
|
3
4
|
|
|
4
5
|
Arrowheads are drawn as filled-triangle `path` scene nodes rather than SVG
|
|
5
6
|
`marker-end`, because d3plus renders to both SVG and Canvas and Canvas has no
|
|
@@ -14,7 +15,7 @@
|
|
|
14
15
|
@module
|
|
15
16
|
*/
|
|
16
17
|
import type { DataPoint } from "@d3plus/data";
|
|
17
|
-
import type { SceneNode } from "@d3plus/render";
|
|
18
|
+
import type { PathNode, SceneNode } from "@d3plus/render";
|
|
18
19
|
/** Which end(s) of an edge carry an arrowhead. `true` is equivalent to `"target"`. */
|
|
19
20
|
export type ArrowEndValue = boolean | "target" | "source" | "both";
|
|
20
21
|
/** The `arrows` config: a fixed value or a per-edge accessor. */
|
|
@@ -42,11 +43,107 @@ export declare function straightArrowTip(fromX: number, fromY: number, toX: numb
|
|
|
42
43
|
y: number;
|
|
43
44
|
angle: number;
|
|
44
45
|
};
|
|
46
|
+
/**
|
|
47
|
+
The arrowhead size for an edge drawn `strokeWidth` pixels wide when
|
|
48
|
+
`arrowSize` isn't set: three times the stroke for thin edges, growing no
|
|
49
|
+
larger than 12 pixels from a 4px stroke on, but never under 1.5 times the
|
|
50
|
+
stroke (so the head stays wider than its line), and at least 6 pixels.
|
|
51
|
+
*/
|
|
52
|
+
export declare function defaultArrowSize(strokeWidth: number): number;
|
|
45
53
|
/**
|
|
46
54
|
Resolve the arrowhead size from the `arrowSize` config (a number or per-edge
|
|
47
|
-
accessor), falling back to
|
|
55
|
+
accessor), falling back to `defaultArrowSize` for the edge's stroke width.
|
|
48
56
|
*/
|
|
49
57
|
export declare function arrowSizeFor(arrowSize: unknown, d: DataPoint, i: number, strokeWidth: number): number;
|
|
58
|
+
/**
|
|
59
|
+
How far back from an arrowhead's tip its edge's stroke ends, so the
|
|
60
|
+
stroke's square (butt) end sits inside the head: the head is `1.2 × d`
|
|
61
|
+
wide at `d` pixels from its tip, so this is where it is as wide as the
|
|
62
|
+
stroke, at least halfway along the head and at most its base.
|
|
63
|
+
*/
|
|
64
|
+
export declare function arrowTrim(size: number, strokeWidth: number): number;
|
|
65
|
+
/**
|
|
66
|
+
An `arrowSize` config for an edge drawn `scale` times wider, as hover
|
|
67
|
+
and active emphasis draw it: a size you set grows with the stroke, and
|
|
68
|
+
the default follows the wider stroke on its own (see `defaultArrowSize`).
|
|
69
|
+
*/
|
|
70
|
+
export declare function scaledArrowSize(arrowSize: unknown, scale: number): unknown;
|
|
71
|
+
/**
|
|
72
|
+
An edge's stroke width `scale` times wider, as hover and active emphasis
|
|
73
|
+
draw it (a 0 or unset width counting as 1, the way they do).
|
|
74
|
+
*/
|
|
75
|
+
export declare function scaledStrokeWidth(strokeWidth: number | undefined, scale: number): number | undefined;
|
|
76
|
+
/** An edge's visible stroke, its arrowheads, and what emphasis changes on the stroke. */
|
|
77
|
+
export interface ArrowEdge {
|
|
78
|
+
d: string;
|
|
79
|
+
arrows: SceneNode[];
|
|
80
|
+
emphasis?: PathNode["emphasis"];
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
An edge's visible stroke and arrowheads as `draw` draws them at their
|
|
84
|
+
own stroke width, carrying the geometry hover and active emphasis widen
|
|
85
|
+
them to: each arrowhead grows with the wider stroke and darkens with it,
|
|
86
|
+
and the stroke ends back inside it, so neither pokes past the other.
|
|
87
|
+
@param draw Draws the edge at `scale` times its stroke width (see
|
|
88
|
+
`scaledStrokeWidth` and `scaledArrowSize`).
|
|
89
|
+
*/
|
|
90
|
+
export declare function emphasizedArrowEdge(draw: (scale: number) => ArrowEdge): ArrowEdge;
|
|
91
|
+
/** An edge's arrowheads: which ends carry one, their size, and the stroke trim at each. */
|
|
92
|
+
export interface EdgeArrowTrims {
|
|
93
|
+
ends: ArrowEnds;
|
|
94
|
+
size: number;
|
|
95
|
+
/** How far the stroke ends back from each end's arrow tip (0 without an arrow). */
|
|
96
|
+
source: number;
|
|
97
|
+
target: number;
|
|
98
|
+
}
|
|
99
|
+
/** Resolves an edge's `arrows`/`arrowSize` into its arrowhead ends, size, and stroke trims. */
|
|
100
|
+
export declare function edgeArrowTrims(opts: {
|
|
101
|
+
arrows: ArrowValue;
|
|
102
|
+
arrowSize: unknown;
|
|
103
|
+
strokeWidth?: number;
|
|
104
|
+
datum: DataPoint;
|
|
105
|
+
i: number;
|
|
106
|
+
}): EdgeArrowTrims;
|
|
107
|
+
type Point = [number, number];
|
|
108
|
+
/**
|
|
109
|
+
A straight segment from `a` to `b`, shortened by `start` pixels at `a`
|
|
110
|
+
and `end` pixels at `b`. When the two overlap, it collapses to the point
|
|
111
|
+
between them.
|
|
112
|
+
*/
|
|
113
|
+
export declare function trimSegment(a: Point, b: Point, start: number, end: number): [Point, Point];
|
|
114
|
+
/**
|
|
115
|
+
A cubic Bézier curve shortened along its own length by `start` pixels at
|
|
116
|
+
its first end and `end` pixels at its last: the same curve, cut short,
|
|
117
|
+
so the ends keep their direction. When the two cuts meet, it collapses
|
|
118
|
+
to the point where they do.
|
|
119
|
+
@param steps The number of chords the curve's length is measured in.
|
|
120
|
+
*/
|
|
121
|
+
export declare function trimCubic(curve: [Point, Point, Point, Point], start: number, end: number, steps?: number): [Point, Point, Point, Point];
|
|
122
|
+
/** A cubic Bézier curve's SVG path. */
|
|
123
|
+
export declare function cubicPathD([p0, p1, p2, p3]: [
|
|
124
|
+
Point,
|
|
125
|
+
Point,
|
|
126
|
+
Point,
|
|
127
|
+
Point
|
|
128
|
+
]): string;
|
|
129
|
+
/**
|
|
130
|
+
The visible stroke of a straight, center-to-center edge between nodes
|
|
131
|
+
of radius `source.r` and `target.r`: cut short inside each arrowhead
|
|
132
|
+
(whose tip sits a pixel off the node's edge, see `straightArrowTip`).
|
|
133
|
+
The full center-to-center path stays the edge's hit area.
|
|
134
|
+
*/
|
|
135
|
+
export declare function straightEdgeD(source: {
|
|
136
|
+
x: number;
|
|
137
|
+
y: number;
|
|
138
|
+
r?: number;
|
|
139
|
+
}, target: {
|
|
140
|
+
x: number;
|
|
141
|
+
y: number;
|
|
142
|
+
r?: number;
|
|
143
|
+
}, trims: {
|
|
144
|
+
source: number;
|
|
145
|
+
target: number;
|
|
146
|
+
}): string;
|
|
50
147
|
/**
|
|
51
148
|
Emit arrowhead nodes for a straight, center-to-center edge between two nodes
|
|
52
149
|
(radii `source.r`/`target.r`), insetting each tip to the node boundary.
|
|
@@ -87,6 +184,8 @@ export interface ArrowNodeOpts {
|
|
|
87
184
|
/**
|
|
88
185
|
Build one arrowhead scene node. `interactive: false` so the edge path owns
|
|
89
186
|
hit-testing, and the same `datum` as its edge so the hover-dim pass keeps the
|
|
90
|
-
arrow paired with its edge.
|
|
187
|
+
arrow paired with its edge. Emphasis darkens its fill with its edge's
|
|
188
|
+
stroke rather than outlining it.
|
|
91
189
|
*/
|
|
92
190
|
export declare function arrowNode(opts: ArrowNodeOpts): SceneNode;
|
|
191
|
+
export {};
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Force-directed edge bundling (Holten & van Wijk, 2009). Each straight
|
|
3
|
+
edge is split into points, and each point is pulled toward the matching
|
|
4
|
+
points of the edges compatible with it (edges running the same way, at
|
|
5
|
+
a similar length, near it, and in view of it), while a spring along the
|
|
6
|
+
edge keeps it smooth. Over a few cycles the points double and the step
|
|
7
|
+
halves, so edges gather into bundles that fan out at their ends.
|
|
8
|
+
|
|
9
|
+
Pure geometry in screen space. The simulation runs on the edges scaled
|
|
10
|
+
to a fixed size, so its settings behave the same at any chart size, and
|
|
11
|
+
a cache keyed by the edges' positions and the settings lets a redraw
|
|
12
|
+
reuse it.
|
|
13
|
+
*/
|
|
14
|
+
import type { Point } from "./polyline.js";
|
|
15
|
+
/** An edge as its two ends, source then target. */
|
|
16
|
+
export type Segment = readonly [Point, Point];
|
|
17
|
+
/** The `linkBundleConfig` settings (see `EDGE_BUNDLE_DEFAULTS`). */
|
|
18
|
+
export interface EdgeBundleOptions {
|
|
19
|
+
/** How closely a path keeps to its bundle: 0 draws it straight, 1 fully bundled. */
|
|
20
|
+
strength: number;
|
|
21
|
+
/** How many times the points along each edge double. */
|
|
22
|
+
cycles: number;
|
|
23
|
+
/** Simulation steps in the first cycle; each later cycle takes two thirds as many. */
|
|
24
|
+
iterations: number;
|
|
25
|
+
/** The compatibility (0–1) two edges need to pull on each other. */
|
|
26
|
+
compatibility: number;
|
|
27
|
+
/** Whether the bundled points are joined by a smooth curve (else by straight lines). */
|
|
28
|
+
smoothing: boolean;
|
|
29
|
+
}
|
|
30
|
+
export declare const EDGE_BUNDLE_DEFAULTS: EdgeBundleOptions;
|
|
31
|
+
/** |cos| of the angle between two edges: 1 parallel, 0 perpendicular. */
|
|
32
|
+
export declare function angleCompatibility(p: Segment, q: Segment): number;
|
|
33
|
+
/** How alike two edges' lengths are: 1 for equal lengths, toward 0 as they differ. */
|
|
34
|
+
export declare function scaleCompatibility(p: Segment, q: Segment): number;
|
|
35
|
+
/** How near two edges' midpoints are, relative to their average length. */
|
|
36
|
+
export declare function positionCompatibility(p: Segment, q: Segment): number;
|
|
37
|
+
/** The smaller of each edge's visibility from the other (see Holten & van Wijk). */
|
|
38
|
+
export declare function visibilityCompatibility(p: Segment, q: Segment): number;
|
|
39
|
+
/** Two edges' compatibility, 0–1: the product of the four measures. */
|
|
40
|
+
export declare function edgeCompatibility(p: Segment, q: Segment): number;
|
|
41
|
+
/**
|
|
42
|
+
The largest ratio between two edges' lengths whose scale compatibility
|
|
43
|
+
still reaches `threshold` (Infinity for a threshold of 0 or less).
|
|
44
|
+
*/
|
|
45
|
+
export declare function maxLengthRatio(threshold: number): number;
|
|
46
|
+
/**
|
|
47
|
+
Each edge's compatible edges, as compressed rows: edge `e`'s neighbors
|
|
48
|
+
are `neighbors[offsets[e]]` up to `neighbors[offsets[e + 1]]`, and each
|
|
49
|
+
one's `weights` entry is its compatibility, negative when the two edges
|
|
50
|
+
run opposite ways. Only pairs reaching `threshold` are kept; a grid over
|
|
51
|
+
the edges' midpoints skips pairs too far apart to reach it.
|
|
52
|
+
*/
|
|
53
|
+
export interface CompatibilityGraph {
|
|
54
|
+
offsets: Int32Array;
|
|
55
|
+
neighbors: Int32Array;
|
|
56
|
+
weights: Float32Array;
|
|
57
|
+
}
|
|
58
|
+
/** The compatible pairs among `edges` (see `CompatibilityGraph`). */
|
|
59
|
+
export declare function compatibilityGraph(edges: readonly Segment[], threshold: number): CompatibilityGraph;
|
|
60
|
+
/**
|
|
61
|
+
`segments + 1` points spaced evenly along a polyline's length, from its
|
|
62
|
+
first point to its last.
|
|
63
|
+
*/
|
|
64
|
+
export declare function subdividePolyline(points: Point[], segments: number): Point[];
|
|
65
|
+
/** Cached simulations, by `edgeBundleKey`, and how many have run. */
|
|
66
|
+
export interface EdgeBundleCache {
|
|
67
|
+
entries: Map<string, Point[][]>;
|
|
68
|
+
runs: number;
|
|
69
|
+
}
|
|
70
|
+
/** A new, empty cache for `bundleEdges`. */
|
|
71
|
+
export declare function edgeBundleCache(): EdgeBundleCache;
|
|
72
|
+
/** The settings with every missing or invalid entry at its default. */
|
|
73
|
+
export declare function edgeBundleOptions(options?: Partial<EdgeBundleOptions>): EdgeBundleOptions;
|
|
74
|
+
/**
|
|
75
|
+
The cache key for bundling `edges` with `options`: the edges' ends to a
|
|
76
|
+
tenth of a pixel, and the settings the simulation reads.
|
|
77
|
+
*/
|
|
78
|
+
export declare function edgeBundleKey(edges: readonly Segment[], options: EdgeBundleOptions): string;
|
|
79
|
+
/**
|
|
80
|
+
Bundles `edges` (see the module notes) and returns each one's path as a
|
|
81
|
+
polyline from its source to its target: the simulated points pulled
|
|
82
|
+
toward the straight edge by `1 - strength`, and joined by a smooth
|
|
83
|
+
curve when `smoothing` is on. An edge of no length stays as its two
|
|
84
|
+
ends.
|
|
85
|
+
*/
|
|
86
|
+
export declare function bundleEdges(edges: readonly Segment[], options?: Partial<EdgeBundleOptions>, cache?: EdgeBundleCache): Point[][];
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Turns a bundled edge's control points into the polyline it draws as:
|
|
3
|
+
straightened by the bundle's strength (as d3's `curveBundle.beta`
|
|
4
|
+
does), then optionally rounded into a B-spline and thinned to the
|
|
5
|
+
points that shape it.
|
|
6
|
+
*/
|
|
7
|
+
import type { Point } from "./polyline.js";
|
|
8
|
+
/**
|
|
9
|
+
Each point pulled toward the straight line between the polyline's ends,
|
|
10
|
+
to `strength` of the way from that line (0) to where it was (1).
|
|
11
|
+
*/
|
|
12
|
+
export declare function straightenPolyline(points: Point[], strength: number): Point[];
|
|
13
|
+
/**
|
|
14
|
+
The uniform cubic B-spline through a polyline's control points, ends
|
|
15
|
+
clamped so it starts and ends on them, sampled about every `spacing`
|
|
16
|
+
pixels (between 1 and 8 samples a span).
|
|
17
|
+
*/
|
|
18
|
+
export declare function bsplinePolyline(points: Point[], spacing?: number): Point[];
|
|
19
|
+
/**
|
|
20
|
+
The points of a polyline that keep its shape to within `tolerance`
|
|
21
|
+
pixels (Ramer–Douglas–Peucker), its ends always kept.
|
|
22
|
+
*/
|
|
23
|
+
export declare function simplifyPolyline(points: Point[], tolerance: number): Point[];
|
|
24
|
+
/**
|
|
25
|
+
A bundled edge's drawn polyline: its control points straightened by
|
|
26
|
+
`strength`, rounded into a B-spline when `smoothing` is on, and thinned
|
|
27
|
+
to within a quarter pixel.
|
|
28
|
+
*/
|
|
29
|
+
export declare function smoothBundle(points: Point[], strength: number, smoothing: boolean): Point[];
|
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
|
|
14
14
|
Idempotent: calling it again returns the existing nodes. Mutates the
|
|
15
15
|
viz instance with `_container` / `_zoomGroup` (and the Network
|
|
16
|
-
variant also wires the hitArea click handler
|
|
16
|
+
variant also wires the hitArea click handler, and `_backgroundClick` for
|
|
17
|
+
the Canvas renderer).
|
|
17
18
|
|
|
18
19
|
The helper stays as long as d3-zoom owns event binding and Geomap's
|
|
19
20
|
tile-loading mounts `<g>` elements directly. An eventual fully
|
|
@@ -39,5 +40,22 @@ interface SetupOpts {
|
|
|
39
40
|
/** Geomap-only: ocean fill color (also used as the svg background). */
|
|
40
41
|
ocean?: string;
|
|
41
42
|
}
|
|
43
|
+
/**
|
|
44
|
+
Clears a Network or ArcDiagram's click focus: its active nodes and its
|
|
45
|
+
zoom. Returns whether there was a focus to clear.
|
|
46
|
+
@param viz The chart.
|
|
47
|
+
*/
|
|
48
|
+
export declare function clearGraphFocus(viz: Viz): boolean;
|
|
49
|
+
/**
|
|
50
|
+
Whether a point lies within an area, edges included.
|
|
51
|
+
@param point The point.
|
|
52
|
+
@param area The area.
|
|
53
|
+
*/
|
|
54
|
+
export declare function withinArea([x, y]: [number, number], area: {
|
|
55
|
+
x: number;
|
|
56
|
+
y: number;
|
|
57
|
+
width: number;
|
|
58
|
+
height: number;
|
|
59
|
+
}): boolean;
|
|
42
60
|
export declare function ensureZoomDom(viz: Viz, opts: SetupOpts): void;
|
|
43
61
|
export {};
|
|
@@ -3,7 +3,8 @@ import type { FeatureModule } from "./features.js";
|
|
|
3
3
|
import type Legend from "../../components/Legend/Legend.js";
|
|
4
4
|
import type { VizInstance } from "../viz/vizTypes.js";
|
|
5
5
|
import type { InsetOrient } from "./insetState.js";
|
|
6
|
-
|
|
6
|
+
/** The legend's rolled-up entries, with the key and paint accessors its render reuses. */
|
|
7
|
+
export interface LegendData {
|
|
7
8
|
legendData: DataPoint[];
|
|
8
9
|
legendKey: (d: DataPoint, i: number) => string;
|
|
9
10
|
getAttr: (d: DataPoint, i: number, attr: string) => string;
|
|
@@ -13,7 +14,8 @@ interface LegendData {
|
|
|
13
14
|
`viz._legendDepth` (the lowest groupBy level whose values are unique) and
|
|
14
15
|
`viz._legendCategories` (see `legendCategory.ts`), then sorts it.
|
|
15
16
|
Returns the `legendData` array plus the `fill`/`getAttr` accessors the
|
|
16
|
-
render step reuses.
|
|
17
|
+
render step reuses. A legend set to a constant false (`legend(false)`)
|
|
18
|
+
gets no entries, and its depth and categories stay as they were.
|
|
17
19
|
*/
|
|
18
20
|
export declare function buildLegendData(viz: VizInstance): LegendData;
|
|
19
21
|
/**
|
|
@@ -47,4 +49,3 @@ export declare function paintLegendInset(viz: VizInstance, orient: InsetOrient,
|
|
|
47
49
|
scene composition for Legend happens via Viz.toScene's `components` array.
|
|
48
50
|
*/
|
|
49
51
|
export declare const legendFeature: FeatureModule;
|
|
50
|
-
export {};
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Discrete axis ticks that follow the hover: each tick label is stamped
|
|
3
|
+
with the value it stands for (see `hoverMatch`), so while marks are
|
|
4
|
+
hovered the labels of their buckets stay at full opacity and the rest dim
|
|
5
|
+
with the other marks. Continuous axes show a hover badge instead (see
|
|
6
|
+
`Plot/axisHover.ts`).
|
|
7
|
+
*/
|
|
8
|
+
import type { DataPoint } from "@d3plus/data";
|
|
9
|
+
import type { SceneNode } from "@d3plus/render";
|
|
10
|
+
/** An axis's scale setting, the way the Axis component stores it. */
|
|
11
|
+
interface AxisLike {
|
|
12
|
+
schema?: {
|
|
13
|
+
scale?: unknown;
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
/** Whether an Axis draws discrete buckets (a band, ordinal, or point scale). */
|
|
17
|
+
export declare const discreteAxis: (axis: AxisLike | undefined) => boolean;
|
|
18
|
+
/**
|
|
19
|
+
Stamps every tick label in an axis scene with `hoverMatch`: the tick's
|
|
20
|
+
value, matched against `field` on the hovered marks' data.
|
|
21
|
+
@param node The axis scene (or any subtree of it).
|
|
22
|
+
@param field The datum key a mark keeps the axis value under.
|
|
23
|
+
*/
|
|
24
|
+
export declare function tagHoverTicks(node: SceneNode, field: string): void;
|
|
25
|
+
/**
|
|
26
|
+
The values under `field` in a datum or any datum it wraps (the first one
|
|
27
|
+
that has it), as strings; an array value gives each of its items.
|
|
28
|
+
*/
|
|
29
|
+
export declare function datumValues(datum: DataPoint | undefined, field: string): string[];
|
|
30
|
+
export {};
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Work spread over the browser's idle time: jobs run in short turns from
|
|
3
|
+
`requestIdleCallback` (or `setTimeout` where it is missing), so no turn
|
|
4
|
+
keeps the main thread busy for long.
|
|
5
|
+
*/
|
|
6
|
+
/** What `requestIdleCallback` hands its callback. */
|
|
7
|
+
interface IdleDeadline {
|
|
8
|
+
timeRemaining(): number;
|
|
9
|
+
}
|
|
10
|
+
/** The longest a turn runs, in milliseconds, however long the browser stays idle. */
|
|
11
|
+
export declare const IDLE_BUDGET = 12;
|
|
12
|
+
/** Calls `fn` at the next idle moment, or soon after when the browser has no idle callbacks. */
|
|
13
|
+
export declare function requestIdle(fn: (deadline?: IdleDeadline) => void): void;
|
|
14
|
+
/** A job: each `step` works for about `budget` milliseconds (at least one unit), and returns whether it is done. */
|
|
15
|
+
export interface IdleJob {
|
|
16
|
+
step(budget: number): boolean;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
Jobs keyed by name, run one after another in idle turns. Callbacks
|
|
20
|
+
passed to `beforeNext` run at the start of the next turn, before any job.
|
|
21
|
+
*/
|
|
22
|
+
export declare class IdleQueue {
|
|
23
|
+
private jobs;
|
|
24
|
+
private before;
|
|
25
|
+
private waiting;
|
|
26
|
+
/** How many jobs are waiting or running. */
|
|
27
|
+
get size(): number;
|
|
28
|
+
/** Whether a job named `key` is waiting or running. */
|
|
29
|
+
has(key: string): boolean;
|
|
30
|
+
/** Queues `job` under `key`, unless a job of that name is already queued. */
|
|
31
|
+
add(key: string, job: IdleJob): void;
|
|
32
|
+
/** Cancels every job whose name isn't in `keys`. */
|
|
33
|
+
keep(keys: Set<string>): void;
|
|
34
|
+
/** Cancels every job and every `beforeNext` callback. */
|
|
35
|
+
clear(): void;
|
|
36
|
+
/** Runs `fn` at the start of the next idle turn. */
|
|
37
|
+
beforeNext(fn: () => void): void;
|
|
38
|
+
private wake;
|
|
39
|
+
/** One idle turn: the `beforeNext` callbacks, then jobs until the turn's time is up. */
|
|
40
|
+
private turn;
|
|
41
|
+
}
|
|
42
|
+
/** The idle queue of `owner` (a chart), made on first use. */
|
|
43
|
+
export declare function idleQueue(owner: object): IdleQueue;
|
|
44
|
+
/** Cancels the idle work of `owner` (a chart), if it has any. */
|
|
45
|
+
export declare function cancelIdleWork(owner: object): void;
|
|
46
|
+
export {};
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
How the legend groups rows into entries: by the color each row encodes,
|
|
3
|
+
its opacity and its texture.
|
|
4
|
+
*/
|
|
5
|
+
import type { DataPoint } from "@d3plus/data";
|
|
6
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
7
|
+
/** The functions that read a row's legend paint and key. */
|
|
8
|
+
export interface LegendKeys {
|
|
9
|
+
/** A paint attribute (`fill`, `opacity`, …) from the row's shapeConfig; a Line's fill is its stroke. */
|
|
10
|
+
getAttr: (d: DataPoint, i: number, attr: string) => string;
|
|
11
|
+
/** The row's color encoding input, or undefined without a color accessor. */
|
|
12
|
+
colorOf: (d: DataPoint, i: number) => unknown;
|
|
13
|
+
/** The row's entry key, given its color encoding. */
|
|
14
|
+
keyOf: (d: DataPoint, i: number, c: unknown) => string;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
The legend's key functions for a chart.
|
|
18
|
+
@param viz The chart.
|
|
19
|
+
*/
|
|
20
|
+
export declare function legendKeys(viz: VizInstance): LegendKeys;
|
|
21
|
+
/**
|
|
22
|
+
The rows the legend rolls up: `_legendData`, less the rows a colorScale
|
|
23
|
+
colors.
|
|
24
|
+
@param viz The chart.
|
|
25
|
+
*/
|
|
26
|
+
export declare function legendRows(viz: VizInstance): DataPoint[];
|
|
27
|
+
/**
|
|
28
|
+
How many entries the legend has (the number `buildLegendData` rolls its
|
|
29
|
+
rows into), counting no further than `limit + 1`: enough to tell whether
|
|
30
|
+
there are more than `limit`. A legend set to a constant false has none.
|
|
31
|
+
@param viz The chart.
|
|
32
|
+
@param limit The count past which to stop.
|
|
33
|
+
*/
|
|
34
|
+
export declare function legendEntryCount(viz: VizInstance, limit?: number): number;
|
|
@@ -2,16 +2,19 @@
|
|
|
2
2
|
Line-label collision resolution + connector emit for the Plot paint phase.
|
|
3
3
|
|
|
4
4
|
Plot's `lineLabels` feature draws a label at the end of each series line.
|
|
5
|
-
When several series end at nearby y positions the labels overlap,
|
|
6
|
-
are
|
|
7
|
-
links each
|
|
5
|
+
When several series end at nearby y positions the labels would overlap,
|
|
6
|
+
so they are spread apart until none do; a thin connector line then
|
|
7
|
+
links each moved label back to its true series position.
|
|
8
|
+
|
|
9
|
+
Labels at a line's left end (`lineLabels: "start"` or `"both"`) are
|
|
10
|
+
placed the same way, apart from the right-end labels.
|
|
8
11
|
|
|
9
12
|
The measure half (which series get labels + their widths) lives upstream
|
|
10
13
|
as the `measurePlotLineLabels` pipeline stage. This module owns the two
|
|
11
14
|
remaining pieces:
|
|
12
15
|
|
|
13
|
-
- `bumpLineLabels` — resolve overlaps, returning the id→
|
|
14
|
-
- `emitLineLabelConnectors` — draw the connector lines for
|
|
16
|
+
- `bumpLineLabels` — resolve overlaps, returning the id→moved-y map.
|
|
17
|
+
- `emitLineLabelConnectors` — draw the connector lines for moved labels.
|
|
15
18
|
|
|
16
19
|
This is Plot-family-specific (it depends on Line series + the rendered
|
|
17
20
|
y-axis position function), not a generic cross-viz feature.
|
|
@@ -22,18 +25,18 @@ import type { SceneNode } from "@d3plus/render";
|
|
|
22
25
|
import type { LabelWidth } from "./plotPaint.js";
|
|
23
26
|
import type { VizInstance as Viz } from "../viz/vizTypes.js";
|
|
24
27
|
/**
|
|
25
|
-
Resolve label overlaps within each x-group
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
connector emit read. Must run AFTER the production y-axis has rendered
|
|
30
|
-
|
|
28
|
+
Resolve label overlaps within each x-group, each end of the lines on its
|
|
29
|
+
own: labels are spread apart until none overlap (see `spreadGroup`).
|
|
30
|
+
Mutates each `LabelWidth`'s `newY`/`defaultY` in place and returns the
|
|
31
|
+
moved-y map, keyed by `lineLabelKey`, that the Line emitter and
|
|
32
|
+
connector emit read. Must run AFTER the production y-axis has rendered:
|
|
33
|
+
it reads `viz._yAxis._getPosition`.
|
|
31
34
|
*/
|
|
32
35
|
export declare function bumpLineLabels(viz: Viz, labelWidths: LabelWidth[], yRange: number[]): Record<string, number>;
|
|
33
36
|
/**
|
|
34
37
|
Emit the connector lines for labels that were bumped (`newY` set). Each
|
|
35
38
|
connector runs from the label's true series position to its bumped
|
|
36
|
-
position. Returns the compute-mode scene nodes (empty when nothing was
|
|
39
|
+
position, rightward for a right-end label and leftward for a left-end one. Returns the compute-mode scene nodes (empty when nothing was
|
|
37
40
|
bumped). Coords are relative to `_chartTransform`, which the chart-cells
|
|
38
41
|
group applies.
|
|
39
42
|
*/
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
`linkBundle` for a chart's links: bundles their straight runs (see
|
|
3
|
+
`bundleEdges`) with the chart's `linkBundleConfig`, through a cache kept
|
|
4
|
+
on the chart, so a redraw with the links where they were reuses the
|
|
5
|
+
last bundling.
|
|
6
|
+
*/
|
|
7
|
+
import type { EdgeBundleCache, Segment } from "./edgeBundling.js";
|
|
8
|
+
import type { Point } from "./polyline.js";
|
|
9
|
+
import type { VizInstance } from "../viz/vizTypes.js";
|
|
10
|
+
/** The chart's bundling cache, created on first use. */
|
|
11
|
+
export declare function linkBundleCache(viz: VizInstance): EdgeBundleCache;
|
|
12
|
+
/**
|
|
13
|
+
Each edge's bundled path, from its source to its target, with the
|
|
14
|
+
chart's `linkBundleConfig`.
|
|
15
|
+
*/
|
|
16
|
+
export declare function bundleLinkPaths(viz: VizInstance, edges: readonly Segment[]): Point[][];
|