@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,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Resolves a chart's `theme` once per draw and hands it to the chart's
|
|
3
|
+
components, and paints a forced theme's background into the scene.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/ import { resolveTheme, themed, themeStyle } from "../../utils/theme.js";
|
|
7
|
+
import { cascadeTheme } from "../../utils/themeInk.js";
|
|
8
|
+
import { pageTheme, unwatchPageTheme, watchPageTheme } from "./pageTheme.js";
|
|
9
|
+
export { unwatchPageTheme };
|
|
10
|
+
/**
|
|
11
|
+
Resolves the chart's theme for this draw onto `viz._theme` and its
|
|
12
|
+
components, and keeps an `"auto"` chart watching its page for a flip
|
|
13
|
+
between light and dark (a forced theme stops watching).
|
|
14
|
+
*/ export function applyVizTheme(viz) {
|
|
15
|
+
const setting = viz.schema.theme;
|
|
16
|
+
const theme = resolveTheme(setting, pageTheme(viz), viz.schema.colorDefaults);
|
|
17
|
+
viz._theme = theme;
|
|
18
|
+
cascadeTheme(viz, theme);
|
|
19
|
+
if (theme.painted) unwatchPageTheme(viz);
|
|
20
|
+
else watchPageTheme(viz);
|
|
21
|
+
return theme;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
The chart area a Geomap's ocean and tiles cover in the page, beneath the
|
|
25
|
+
painted scene (a server render paints them in the scene instead).
|
|
26
|
+
*/ function underlay(viz) {
|
|
27
|
+
if (viz._ssr || !viz._tileGroup || !viz._margin) return undefined;
|
|
28
|
+
const { top, right, bottom, left } = viz._margin;
|
|
29
|
+
const { width, height } = viz.schema;
|
|
30
|
+
return {
|
|
31
|
+
x: left,
|
|
32
|
+
y: top,
|
|
33
|
+
width: width - left - right,
|
|
34
|
+
height: height - top - bottom
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
The scene node a forced theme paints behind the chart, if it has one: a
|
|
39
|
+
rect over the whole chart, framing (not covering) a Geomap's basemap.
|
|
40
|
+
*/ export function themeBackgroundNode(viz) {
|
|
41
|
+
const theme = viz._theme;
|
|
42
|
+
if (!theme?.painted) return undefined;
|
|
43
|
+
const { width, height } = viz.schema;
|
|
44
|
+
const base = {
|
|
45
|
+
key: "viz-background",
|
|
46
|
+
interactive: false,
|
|
47
|
+
paint: {
|
|
48
|
+
fill: theme.background
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
const hole = underlay(viz);
|
|
52
|
+
if (!hole) return {
|
|
53
|
+
...base,
|
|
54
|
+
type: "rect",
|
|
55
|
+
x: 0,
|
|
56
|
+
y: 0,
|
|
57
|
+
width,
|
|
58
|
+
height
|
|
59
|
+
};
|
|
60
|
+
// The hole winds the other way, so the nonzero fill leaves it empty.
|
|
61
|
+
const { x, y } = hole;
|
|
62
|
+
return {
|
|
63
|
+
...base,
|
|
64
|
+
type: "path",
|
|
65
|
+
d: `M0,0H${width}V${height}H0Z` + `M${x},${y}V${y + hole.height}H${x + hole.width}V${y}Z`
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
/** The forced theme's background rect, as the scene's first children. */ export function themeBackground(viz) {
|
|
69
|
+
const node = themeBackgroundNode(viz);
|
|
70
|
+
return node ? [
|
|
71
|
+
node
|
|
72
|
+
] : [];
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
The `color-scheme` the chart's overlays use, so their native controls
|
|
76
|
+
(buttons, the search input, the download menu) match the theme: the
|
|
77
|
+
theme's own when forced or dark, and the page's otherwise.
|
|
78
|
+
*/ export function themeColorScheme(theme) {
|
|
79
|
+
if (!theme || !(theme.painted || theme.dark)) return "";
|
|
80
|
+
return theme.dark ? "dark" : "light";
|
|
81
|
+
}
|
|
82
|
+
/** Sets the chart's overlay host's `color-scheme` (see `themeColorScheme`). */ export function applyOverlayColorScheme(viz) {
|
|
83
|
+
const scheme = themeColorScheme(viz._theme);
|
|
84
|
+
const elements = viz._sceneRenderer?.elements?.() ?? [];
|
|
85
|
+
for (const el of elements)if (el.localName === "div" && "style" in el) el.style.colorScheme = scheme;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
An overlay style with each entry still at its built-in default swapped for
|
|
89
|
+
the theme's overlay color: `keys` maps a CSS property to the overlay token
|
|
90
|
+
it takes, and `format` wraps a token (`1px solid …`). Light charts keep
|
|
91
|
+
the built-in style (see `themed`).
|
|
92
|
+
*/ export function themeOverlayStyle(viz, style, defaults, keys) {
|
|
93
|
+
const overrides = {};
|
|
94
|
+
for (const [key, pick] of Object.entries(keys))overrides[key] = themed(viz._theme, (t)=>pick(t.overlay), undefined);
|
|
95
|
+
return themeStyle(style, defaults, overrides);
|
|
96
|
+
}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { select } from "d3-selection";
|
|
2
|
+
import { cancelIdleWork } from "../features/idleQueue.js";
|
|
2
3
|
/** Vertical buffer around the scroll root, so charts start rendering just before they scroll into view. */ const ROOT_MARGIN = "25% 0px";
|
|
3
4
|
const WINDOW_ROOT = {};
|
|
4
5
|
const entries = new WeakMap();
|
|
@@ -90,15 +91,24 @@ const entries = new WeakMap();
|
|
|
90
91
|
const parent = viz._select.node()?.parentNode;
|
|
91
92
|
if (parent) viz._resizeObserver?.unobserve(parent);
|
|
92
93
|
viz._tooltipClass.data([]).render();
|
|
94
|
+
releaseScene(viz);
|
|
95
|
+
viz._select.selectAll("g.data-table").remove();
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
Stops what a chart's drawn scene keeps running: its idle work (network
|
|
99
|
+
measures, queued again when it redraws), a pending repaint, and the
|
|
100
|
+
scene renderer with its DOM, listeners, and timers.
|
|
101
|
+
@private
|
|
102
|
+
*/ export function releaseScene(viz) {
|
|
103
|
+
cancelIdleWork(viz);
|
|
93
104
|
if (viz._sceneRepaintRAF != null) {
|
|
94
|
-
cancelAnimationFrame(viz._sceneRepaintRAF);
|
|
105
|
+
if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(viz._sceneRepaintRAF);
|
|
95
106
|
viz._sceneRepaintRAF = undefined;
|
|
96
107
|
}
|
|
97
108
|
if (viz._sceneRenderer && typeof viz._sceneRenderer.destroy === "function") {
|
|
98
109
|
viz._sceneRenderer.destroy();
|
|
99
110
|
viz._sceneRenderer = undefined;
|
|
100
111
|
}
|
|
101
|
-
viz._select.selectAll("g.data-table").remove();
|
|
102
112
|
}
|
|
103
113
|
/**
|
|
104
114
|
Redraws an unloaded chart without an entrance animation.
|
|
@@ -124,3 +134,17 @@ const entries = new WeakMap();
|
|
|
124
134
|
if (viz._unloadUnobserve) return;
|
|
125
135
|
viz._unloadUnobserve = observeVisibility(viz._select.node(), viz.schema.scrollContainer, ()=>vizReload(viz), 0, ()=>vizUnload(viz));
|
|
126
136
|
}
|
|
137
|
+
/**
|
|
138
|
+
Stops a chart's visibility, resize, and scroll polling and its visibility
|
|
139
|
+
observers, so a destroyed chart leaves no timer or listener holding it.
|
|
140
|
+
@private
|
|
141
|
+
*/ export function stopVisibilityWatch(viz) {
|
|
142
|
+
if (viz._visiblePoll) viz._visiblePoll = clearInterval(viz._visiblePoll);
|
|
143
|
+
if (viz._resizePoll) viz._resizePoll = clearTimeout(viz._resizePoll);
|
|
144
|
+
if (viz._scrollPoll) viz._scrollPoll = clearTimeout(viz._scrollPoll);
|
|
145
|
+
viz._visibleUnobserve?.();
|
|
146
|
+
viz._visibleUnobserve = undefined;
|
|
147
|
+
viz._unloadUnobserve?.();
|
|
148
|
+
viz._unloadUnobserve = undefined;
|
|
149
|
+
if (viz.schema.scrollContainer) select(viz.schema.scrollContainer).on(`scroll.${viz._uuid}`, null);
|
|
150
|
+
}
|
|
@@ -2,7 +2,7 @@ import { extent, min } from "d3-array";
|
|
|
2
2
|
import { select } from "d3-selection";
|
|
3
3
|
import { elem } from "@d3plus/dom";
|
|
4
4
|
import { TextBox } from "../index.js";
|
|
5
|
-
import { measureAxis } from "./
|
|
5
|
+
import { measureAxis } from "./axisLimit.js";
|
|
6
6
|
import { axisBarConfig, axisBreakConfig, axisGridConfig, axisShapeConfig, axisTitleConfig } from "./axisDefaults.js";
|
|
7
7
|
import { timeDataInDomain } from "./timeValues.js";
|
|
8
8
|
import { axisToScene } from "./axisScene.js";
|
|
@@ -112,6 +112,11 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
|
112
112
|
key: "range",
|
|
113
113
|
coerce: "identity"
|
|
114
114
|
},
|
|
115
|
+
{
|
|
116
|
+
key: "rangeBreaks",
|
|
117
|
+
coerce: "identity",
|
|
118
|
+
default: false
|
|
119
|
+
},
|
|
115
120
|
{
|
|
116
121
|
key: "renderMode",
|
|
117
122
|
coerce: "identity",
|
|
@@ -189,6 +194,10 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
|
189
194
|
coerce: "identity",
|
|
190
195
|
default: "normal"
|
|
191
196
|
},
|
|
197
|
+
{
|
|
198
|
+
key: "tickTooltip",
|
|
199
|
+
coerce: "identity"
|
|
200
|
+
},
|
|
192
201
|
{
|
|
193
202
|
key: "timeLocale",
|
|
194
203
|
coerce: "identity",
|
|
@@ -198,6 +207,10 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
|
198
207
|
key: "title",
|
|
199
208
|
coerce: "identity"
|
|
200
209
|
},
|
|
210
|
+
{
|
|
211
|
+
key: "titleTooltip",
|
|
212
|
+
coerce: "identity"
|
|
213
|
+
},
|
|
201
214
|
{
|
|
202
215
|
key: "width",
|
|
203
216
|
coerce: "identity",
|
|
@@ -207,6 +220,7 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
|
207
220
|
/**
|
|
208
221
|
Creates an SVG scale based on an array of data.
|
|
209
222
|
*/ export default class Axis extends BaseClass {
|
|
223
|
+
static _displayName = "Axis";
|
|
210
224
|
_select;
|
|
211
225
|
_data;
|
|
212
226
|
/** The `data` values the scale reads, set by the layout pass (see `axisScaleData`). */ _scaleData = [];
|
|
@@ -225,6 +239,20 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
|
225
239
|
0,
|
|
226
240
|
0
|
|
227
241
|
];
|
|
242
|
+
/**
|
|
243
|
+
Whether the `maxSize` is the chart's own default limit (see
|
|
244
|
+
`defaultMaxSize`), which lets one line of labels and the title take
|
|
245
|
+
more than it.
|
|
246
|
+
*/ _softMaxSize = false;
|
|
247
|
+
/**
|
|
248
|
+
Whether a vertical axis hides labels to give the ones it shows more
|
|
249
|
+
lines (see `thinForLines`): a bucketed ColorScale's.
|
|
250
|
+
*/ _thinForLines = false;
|
|
251
|
+
/** Whether the last layout pass left the title out to fit `maxSize` (see `measureAxis`). */ _dropTitle = false;
|
|
252
|
+
/**
|
|
253
|
+
How the last layout pass fit `maxSize`: how many shown labels it left
|
|
254
|
+
out, and the room the labels had (see `limitLabels`).
|
|
255
|
+
*/ _limited;
|
|
228
256
|
_position;
|
|
229
257
|
_tickUnit;
|
|
230
258
|
_titleClass;
|
|
@@ -235,6 +263,11 @@ import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
|
235
263
|
_gridLineData;
|
|
236
264
|
_d3Scale = null;
|
|
237
265
|
_d3ScaleNegative = null;
|
|
266
|
+
/**
|
|
267
|
+
Whether the domain is handed over last value first, as a Plot hands its
|
|
268
|
+
y axes theirs (they run bottom to top). Tick tooltips count a
|
|
269
|
+
categorical axis's labels from the domain's start (see `tickRank`).
|
|
270
|
+
*/ _domainEndFirst = false;
|
|
238
271
|
/** The active baseline break, set by the layout pass (see `baselineBreak`). */ _baselineBreak = null;
|
|
239
272
|
/** Every active break (baseline and explicit), set by the layout pass. */ _breaks = [];
|
|
240
273
|
_group;
|
|
@@ -560,4 +593,4 @@ export function computeAxisLayout(axis) {
|
|
|
560
593
|
resolvesReset(Axis.prototype, "barConfig", "breakConfig", "baselineBreakConfig", "gridConfig", "shapeConfig", "titleConfig");
|
|
561
594
|
// Re-export the standalone `measureAxis` and its result type so consumers
|
|
562
595
|
// can import them from the same module as the Axis class.
|
|
563
|
-
export { measureAxis } from "./
|
|
596
|
+
export { measureAxis } from "./axisLimit.js";
|
|
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
|
|
|
2
2
|
/**
|
|
3
3
|
Axis preset whose ticks are drawn below the horizontal domain path. Accepts everything the base Axis class does.
|
|
4
4
|
*/ export default class AxisBottom extends Axis {
|
|
5
|
+
static _displayName = "AxisBottom";
|
|
5
6
|
/**
|
|
6
7
|
Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
|
|
7
8
|
@private
|
|
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
|
|
|
2
2
|
/**
|
|
3
3
|
Axis preset whose ticks are drawn to the left of the vertical domain path. Accepts everything the base Axis class does.
|
|
4
4
|
*/ export default class AxisLeft extends Axis {
|
|
5
|
+
static _displayName = "AxisLeft";
|
|
5
6
|
/**
|
|
6
7
|
Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
|
|
7
8
|
@private
|
|
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
|
|
|
2
2
|
/**
|
|
3
3
|
Axis preset whose ticks are drawn to the right of the vertical domain path. Accepts everything the base Axis class does.
|
|
4
4
|
*/ export default class AxisRight extends Axis {
|
|
5
|
+
static _displayName = "AxisRight";
|
|
5
6
|
/**
|
|
6
7
|
Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
|
|
7
8
|
@private
|
|
@@ -2,6 +2,7 @@ import { default as Axis } from "./Axis.js";
|
|
|
2
2
|
/**
|
|
3
3
|
Axis preset whose ticks are drawn above the horizontal domain path. Accepts everything the base Axis class does.
|
|
4
4
|
*/ export default class AxisTop extends Axis {
|
|
5
|
+
static _displayName = "AxisTop";
|
|
5
6
|
/**
|
|
6
7
|
Invoked when creating a new class instance, and overrides any default parameters inherited from Axis.
|
|
7
8
|
@private
|
|
@@ -9,7 +9,10 @@
|
|
|
9
9
|
export { brokenScaleTicks, isBrokenScale } from "./brokenScale.js";
|
|
10
10
|
const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fallback;
|
|
11
11
|
/** Reads the glyph settings from one of an axis's break configs. */ export function breakStyle(axis, key = "breakConfig") {
|
|
12
|
-
|
|
12
|
+
return breakStyleOf(axis.schema[key]);
|
|
13
|
+
}
|
|
14
|
+
/** Reads break glyph settings from a break config object (see `breakStyle`). */ export function breakStyleOf(config) {
|
|
15
|
+
const cfg = config || {};
|
|
13
16
|
return {
|
|
14
17
|
angle: num(cfg.angle, 30),
|
|
15
18
|
gap: Math.max(0, num(cfg.gap, 5)),
|
|
@@ -49,11 +52,23 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
|
|
|
49
52
|
edgePosition
|
|
50
53
|
};
|
|
51
54
|
}
|
|
55
|
+
/**
|
|
56
|
+
The pixels each of `count` explicit breaks takes on an axis `length`
|
|
57
|
+
pixels long: `space`, or less when the axis can't hold that and still
|
|
58
|
+
leave twice a break's room for the data, down to `spaceMin`. `null` when
|
|
59
|
+
even `spaceMin` doesn't fit, and the breaks are dropped.
|
|
60
|
+
*/ export function fitBreakSpace(length, count, space, spaceMin = space) {
|
|
61
|
+
if (!count) return space;
|
|
62
|
+
const room = length / (count + 2);
|
|
63
|
+
if (room >= space) return space;
|
|
64
|
+
return room >= Math.min(spaceMin, space) ? room : null;
|
|
65
|
+
}
|
|
52
66
|
/**
|
|
53
67
|
Replaces a linear axis's scale with a broken one when it has a baseline
|
|
54
68
|
break or any `break` ranges inside its domain, and records the resolved
|
|
55
|
-
breaks on `axis._breaks`. Explicit breaks
|
|
56
|
-
|
|
69
|
+
breaks on `axis._breaks`. Explicit breaks shrink when the range can't
|
|
70
|
+
hold them and still leave twice a break's space for the data (down to
|
|
71
|
+
`breakConfig.spaceMin`), and are dropped below that.
|
|
57
72
|
*/ export function applyAxisBreaks(axis, range) {
|
|
58
73
|
axis._baselineBreak = resolveBaselineBreak(axis, range);
|
|
59
74
|
axis._breaks = [];
|
|
@@ -61,9 +76,12 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
|
|
|
61
76
|
const edge = axis._baselineBreak;
|
|
62
77
|
const domain = axis._d3Scale.domain().map(Number);
|
|
63
78
|
const inner = range.slice(0, 2).map((r)=>edge && r === edge.position ? edge.edgePosition : r);
|
|
64
|
-
const
|
|
79
|
+
const style = breakStyle(axis);
|
|
65
80
|
let breaks = normalizeBreaks(axis.schema.break, Math.min(...domain), Math.max(...domain));
|
|
66
|
-
|
|
81
|
+
const config = axis.schema.breakConfig || {};
|
|
82
|
+
const fitted = fitBreakSpace(Math.abs(inner[1] - inner[0]), breaks.length, style.space, Math.max(0, num(config.spaceMin, style.space)));
|
|
83
|
+
if (fitted === null) breaks = [];
|
|
84
|
+
const space = fitted ?? style.space;
|
|
67
85
|
if (!edge && !breaks.length) return;
|
|
68
86
|
const scale = brokenScale({
|
|
69
87
|
domain,
|
|
@@ -96,7 +114,10 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
|
|
|
96
114
|
startPosition: scale(start),
|
|
97
115
|
endPosition: scale(end),
|
|
98
116
|
baseline: false,
|
|
99
|
-
mask
|
|
117
|
+
mask: style.mask,
|
|
118
|
+
...space < style.space ? {
|
|
119
|
+
fit: space / style.space
|
|
120
|
+
} : {}
|
|
100
121
|
});
|
|
101
122
|
});
|
|
102
123
|
}
|
|
@@ -116,8 +137,12 @@ const num = (v, fallback)=>typeof v === "number" && Number.isFinite(v) ? v : fal
|
|
|
116
137
|
}
|
|
117
138
|
return kept;
|
|
118
139
|
}
|
|
119
|
-
/**
|
|
120
|
-
|
|
140
|
+
/**
|
|
141
|
+
The pixel gap (`[from, to]`, ascending) a break leaves in the axis line,
|
|
142
|
+
shrunk with a break shrunk to fit the axis.
|
|
143
|
+
*/ export function breakGap(axis, brk) {
|
|
144
|
+
const { gap: full } = breakStyle(axis, brk.baseline ? "baselineBreakConfig" : "breakConfig");
|
|
145
|
+
const gap = full * (brk.fit ?? 1);
|
|
121
146
|
const center = (brk.startPosition + brk.endPosition) / 2;
|
|
122
147
|
return [
|
|
123
148
|
center - gap / 2,
|
|
@@ -1,13 +1,10 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { backgroundColor, rtl as detectRTL } from "@d3plus/dom";
|
|
1
|
+
import { rtl as detectRTL } from "@d3plus/dom";
|
|
3
2
|
import { constant } from "../../utils/index.js";
|
|
4
|
-
import {
|
|
3
|
+
import { inkAxis, inkGrid } from "../../utils/themeInk.js";
|
|
5
4
|
import { rotatedTextAnchor } from "./axisLabelAngle.js";
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
return colorContrast(bg, axis.schema.colorDefaults);
|
|
10
|
-
};
|
|
5
|
+
import { textEllipsis } from "../textEllipsis.js";
|
|
6
|
+
/** The axis color of the axis's chart theme, or one that contrasts with the background behind it. */ function contrastInk(axis) {
|
|
7
|
+
return ()=>inkAxis(axis);
|
|
11
8
|
}
|
|
12
9
|
/** The default `barConfig` (the domain line). */ export function axisBarConfig(axis) {
|
|
13
10
|
return {
|
|
@@ -30,10 +27,20 @@ import { rotatedTextAnchor } from "./axisLabelAngle.js";
|
|
|
30
27
|
}
|
|
31
28
|
/** The default `gridConfig`. */ export function axisGridConfig(axis) {
|
|
32
29
|
return {
|
|
33
|
-
stroke: ()=>
|
|
30
|
+
stroke: ()=>inkGrid(axis),
|
|
34
31
|
"stroke-width": 1
|
|
35
32
|
};
|
|
36
33
|
}
|
|
34
|
+
/** How a cut tick label ends: as a TextBox line does, or nothing when no text fits. */ export const axisLabelEllipsis = (d)=>d && d.length ? textEllipsis(`${d}`) : "";
|
|
35
|
+
/**
|
|
36
|
+
The ellipsis a cut tick label is measured and painted with: the label
|
|
37
|
+
config's `ellipsis` (a string standing in for the cut line, as TextBox
|
|
38
|
+
reads one), else `axisLabelEllipsis`.
|
|
39
|
+
*/ export function labelEllipsis(shapeConfig) {
|
|
40
|
+
const ellipsis = shapeConfig?.labelConfig?.ellipsis;
|
|
41
|
+
if (typeof ellipsis === "function") return ellipsis;
|
|
42
|
+
return typeof ellipsis === "string" ? ()=>ellipsis : axisLabelEllipsis;
|
|
43
|
+
}
|
|
37
44
|
/** The default `shapeConfig` (tick marks and their labels). */ export function axisShapeConfig(axis) {
|
|
38
45
|
return {
|
|
39
46
|
fill: contrastInk(axis),
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Which kind of labels an axis draws: one per category or value read in
|
|
3
|
+
sequence, and how much room each label of an uneven axis has.
|
|
4
|
+
*/ /**
|
|
5
|
+
Each label's own share of an axis whose labels sit unevenly, such as one
|
|
6
|
+
label per variable-width bar (see `Plot/barWidth.ts`): reaching halfway to
|
|
7
|
+
the nearer of its neighbors on either side, so labels wrapped within their
|
|
8
|
+
shares never meet, while one between far-off neighbors keeps the room
|
|
9
|
+
they leave it. A lone label spans the whole range.
|
|
10
|
+
*/ export function ownLabelSpaces(positions, rangeOuter) {
|
|
11
|
+
if (positions.length < 2) return positions.map(()=>Math.abs(rangeOuter[rangeOuter.length - 1] - rangeOuter[0]));
|
|
12
|
+
return positions.map((position, i)=>{
|
|
13
|
+
const gaps = [
|
|
14
|
+
positions[i - 1],
|
|
15
|
+
positions[i + 1]
|
|
16
|
+
].filter((n)=>n !== undefined).map((n)=>Math.abs(position - n));
|
|
17
|
+
return Math.min(...gaps);
|
|
18
|
+
});
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
Whether a horizontal axis's labels are values read in sequence (dates, or
|
|
22
|
+
numbers on a category axis) that are drawn whole on one line: thinned
|
|
23
|
+
rather than wrapped or cut short, since any one of them reads alone.
|
|
24
|
+
Labels naming categories wrap or rotate instead (see `rotatesLabels`).
|
|
25
|
+
*/ export function wholeLineLabels(axis, labels) {
|
|
26
|
+
const { scale } = axis.schema;
|
|
27
|
+
if (scale === "time") return true;
|
|
28
|
+
return isDiscreteScale(scale) && labels.length > 0 && labels.every((d)=>d instanceof Date || !isNaN(d));
|
|
29
|
+
}
|
|
30
|
+
/** Whether a scale places one tick per category (every value labeled in turn). */ export function isDiscreteScale(scale) {
|
|
31
|
+
return [
|
|
32
|
+
"band",
|
|
33
|
+
"ordinal",
|
|
34
|
+
"point"
|
|
35
|
+
].includes(scale);
|
|
36
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The line height axis labels are measured and painted with, so a label
|
|
3
|
+
measured as N lines paints as N lines in the room measured for it.
|
|
4
|
+
*/ import configValue from "../../utils/configValue.js";
|
|
5
|
+
/** How many times its font size a label's line height is by default (TextBox's default). */ export const LABEL_LINE_HEIGHT = 1.2;
|
|
6
|
+
/**
|
|
7
|
+
The line height of the axis label for tick `d`: the label config's
|
|
8
|
+
`lineHeight` when set, else the shape config's, else 1.2 times the
|
|
9
|
+
label's `fontSize`, as the label's TextBox draws it by default.
|
|
10
|
+
@param shapeConfig The axis's `shapeConfig`.
|
|
11
|
+
@param d The tick value.
|
|
12
|
+
@param i The tick's index.
|
|
13
|
+
@param fontSize The label's font size, read from the label config when
|
|
14
|
+
not given.
|
|
15
|
+
*/ export function labelLineHeight(shapeConfig, d, i, fontSize = configValue(shapeConfig?.labelConfig?.fontSize ?? 12, d, i)) {
|
|
16
|
+
const value = shapeConfig?.labelConfig?.lineHeight ?? shapeConfig?.lineHeight;
|
|
17
|
+
const lineHeight = value === undefined ? undefined : configValue(value, d, i);
|
|
18
|
+
return typeof lineHeight === "number" && lineHeight > 0 ? lineHeight : fontSize * LABEL_LINE_HEIGHT;
|
|
19
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The box a vertical axis's flat labels wrap in, so each label is cut
|
|
3
|
+
where it is painted.
|
|
4
|
+
*/ import { max } from "d3-array";
|
|
5
|
+
/**
|
|
6
|
+
A vertical axis paints its flat labels in a box as wide as the widest
|
|
7
|
+
one (see `buildTickData`), narrower than the room they were measured
|
|
8
|
+
in. Where a cut label's line breaks decides where it is cut, so each
|
|
9
|
+
label that doesn't fit is wrapped again in that box (by `measure`, which
|
|
10
|
+
wraps a label within its `room`) until the widest label holds; a label
|
|
11
|
+
that fits wraps the same in any box as wide as it, and a label whose
|
|
12
|
+
first word no longer fits is cut short in it (see `cutLabel`). Records
|
|
13
|
+
the box on each label as its `room`.
|
|
14
|
+
@param textData The axis's measured labels.
|
|
15
|
+
@param measure Wraps a label within its `room`.
|
|
16
|
+
*/ export function fitLabelRoom(textData, measure) {
|
|
17
|
+
const widest = ()=>max(textData, (t)=>t.width) || 0;
|
|
18
|
+
let room = widest();
|
|
19
|
+
// A label wrapped in the box is no wider than it, so the box only
|
|
20
|
+
// narrows, and settles.
|
|
21
|
+
for(;;){
|
|
22
|
+
textData.forEach((t)=>t.room = room);
|
|
23
|
+
textData.filter((t)=>!t.fits).forEach((t)=>{
|
|
24
|
+
const { lines, widths, width, height, cut } = measure(t);
|
|
25
|
+
Object.assign(t, {
|
|
26
|
+
lines,
|
|
27
|
+
widths,
|
|
28
|
+
width,
|
|
29
|
+
height,
|
|
30
|
+
cut
|
|
31
|
+
});
|
|
32
|
+
});
|
|
33
|
+
const next = widest();
|
|
34
|
+
if (next >= room) return;
|
|
35
|
+
room = next;
|
|
36
|
+
}
|
|
37
|
+
}
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Measures a single axis label for `createTextData` (see
|
|
3
|
+
`axisLayoutLabels.ts`): wrapped with `textWrap` within the room its axis
|
|
4
|
+
gives it. Pure compute, no DOM.
|
|
5
|
+
*/ import { max, min } from "d3-array";
|
|
6
|
+
import { textWrap } from "@d3plus/text";
|
|
7
|
+
import { wholeWordFit, wholeWordSplit } from "../../utils/wholeWords.js";
|
|
8
|
+
import { axisLabelEllipsis, labelEllipsis } from "./axisDefaults.js";
|
|
9
|
+
import { axisCrossing, slantedWrapSize } from "./axisLabelAngle.js";
|
|
10
|
+
import { axisMaxSize } from "./axisMaxSize.js";
|
|
11
|
+
/**
|
|
12
|
+
Cuts a label short to fit `width`: for a label whose first word is wider
|
|
13
|
+
than its room, which wraps to nothing. The word is cut to as many
|
|
14
|
+
characters as fit with the ellipsis after them (the wrap's own, else
|
|
15
|
+
`axisLabelEllipsis`), on one line; with no room for even one, the label
|
|
16
|
+
has no lines.
|
|
17
|
+
*/ export function cutLabel(wrap, text, width) {
|
|
18
|
+
return wrap.width(width).truncateWord(true).ellipsis(wrap.ellipsis() ?? axisLabelEllipsis)(text);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
Measures a flat label whose first word is wider than its room (`space`),
|
|
22
|
+
which wraps to nothing there. On a horizontal axis, where `space` is the
|
|
23
|
+
label's share of the axis: across the whole axis (`across` wide) instead,
|
|
24
|
+
so the overlap pass thins the labels out, or when it is too wide for that
|
|
25
|
+
as well, cut short within its share (see `cutLabel`). Labels in their own
|
|
26
|
+
shares are cut only when none fits whole (`keepShare`, see
|
|
27
|
+
`fitOwnSpaces`). On a vertical axis, where `space` is how far labels
|
|
28
|
+
reach out from the axis, the label is cut short within it (`keepShare`).
|
|
29
|
+
*/ export function longWordLabel(wrap, text, space, across, ctx) {
|
|
30
|
+
if (!ctx.keepShare) {
|
|
31
|
+
const wide = wrap.width(across)(text);
|
|
32
|
+
if (ctx.ownSpace || wide.lines.some((l)=>l !== "")) return {
|
|
33
|
+
res: wide,
|
|
34
|
+
cut: false
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
const res = cutLabel(wrap, text, space);
|
|
38
|
+
return {
|
|
39
|
+
res,
|
|
40
|
+
cut: res.lines.length > 0
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
Wraps a slanted label onto fewer lines, each as long as the lines left
|
|
45
|
+
leave room for, until it reaches no further out from the axis than
|
|
46
|
+
`depth`. A label's every line adds its height to how far it reaches,
|
|
47
|
+
across the slant, so giving one up lets the others run further out. A
|
|
48
|
+
wrap that leaves no lines (a word too long for the line) doesn't count:
|
|
49
|
+
the next, longer line is tried, and a label cut short is measured with
|
|
50
|
+
the ellipsis its TextBox ends it with (the wrap's own, else
|
|
51
|
+
`axisLabelEllipsis`). `width` caps how long a line may be; `res` is the
|
|
52
|
+
label as first wrapped.
|
|
53
|
+
*/ export function slantWithin(wrap, text, res, slant) {
|
|
54
|
+
const phi = axisCrossing(slant.angle, slant.horizontal);
|
|
55
|
+
const sin = Math.sin(phi), cos = Math.cos(phi);
|
|
56
|
+
const lineHeight = wrap.lineHeight();
|
|
57
|
+
const count = (r)=>r.lines.filter((l)=>l !== "").length;
|
|
58
|
+
const fits = (r)=>{
|
|
59
|
+
const lines = count(r);
|
|
60
|
+
const width = Math.ceil(Math.max(0, ...r.widths.slice(0, lines)));
|
|
61
|
+
return width * sin + Math.ceil(lines * lineHeight) * cos <= slant.depth;
|
|
62
|
+
};
|
|
63
|
+
if (!count(res) || fits(res)) return res;
|
|
64
|
+
// Measured as drawn: a label cut short ends in an ellipsis.
|
|
65
|
+
wrap.ellipsis(wrap.ellipsis() ?? axisLabelEllipsis);
|
|
66
|
+
for(let n = count(res) - 1; n >= 1; n--){
|
|
67
|
+
const room = (slant.depth - Math.ceil(n * lineHeight) * cos) / sin;
|
|
68
|
+
wrap.height(n * lineHeight).width(Math.max(0, Math.min(slant.width, room)));
|
|
69
|
+
res = wrap(text);
|
|
70
|
+
if (count(res) && fits(res)) return res;
|
|
71
|
+
}
|
|
72
|
+
return res;
|
|
73
|
+
}
|
|
74
|
+
/** How far labels may reach out from the axis, past its ticks and margins. */ export function labelRoom(axis, horizontal, hBuff, p) {
|
|
75
|
+
const maxSize = axisMaxSize(axis.schema, horizontal);
|
|
76
|
+
return horizontal ? min([
|
|
77
|
+
maxSize,
|
|
78
|
+
axis.schema.height
|
|
79
|
+
]) - hBuff - p - axis._margin.top - axis._margin.bottom : min([
|
|
80
|
+
maxSize,
|
|
81
|
+
axis.schema.width
|
|
82
|
+
]) - hBuff - p - axis._margin.left - axis._margin.right;
|
|
83
|
+
}
|
|
84
|
+
/** What a label's measurement depends on, to tell two labels measure alike. */ function labelSizeKey(text, datum, ctx) {
|
|
85
|
+
const { fF, fP, fS, lineHeight, rotate, space, angle, slant, room } = datum;
|
|
86
|
+
return JSON.stringify([
|
|
87
|
+
text,
|
|
88
|
+
fF,
|
|
89
|
+
fP,
|
|
90
|
+
fS,
|
|
91
|
+
lineHeight,
|
|
92
|
+
rotate,
|
|
93
|
+
slant && angle,
|
|
94
|
+
slant && ctx.slantWidth,
|
|
95
|
+
space,
|
|
96
|
+
room,
|
|
97
|
+
ctx.keepShare
|
|
98
|
+
]);
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
Wraps + measures a single label, returning its sized text result. Given a
|
|
102
|
+
`cache`, a label whose text, font, and space match one measured before
|
|
103
|
+
reuses that measurement.
|
|
104
|
+
*/ export function calculateLabelSize(axis, datum, ctx, cache) {
|
|
105
|
+
const { horizontal, hBuff, p, tickFormat } = ctx;
|
|
106
|
+
const { d, fF, fP, fS, lineHeight, rotate, space, angle, slant } = datum;
|
|
107
|
+
const h = rotate ? "width" : "height", w = rotate ? "height" : "width";
|
|
108
|
+
const text = tickFormat(d);
|
|
109
|
+
const wSize = min([
|
|
110
|
+
axisMaxSize(axis.schema, horizontal),
|
|
111
|
+
axis.schema.width
|
|
112
|
+
]);
|
|
113
|
+
const depth = datum.room ?? labelRoom(axis, horizontal, hBuff, p);
|
|
114
|
+
const slanted = slant ? slantedWrapSize(angle, horizontal, depth, space, lineHeight) : undefined;
|
|
115
|
+
const key = cache && labelSizeKey(text, datum, ctx);
|
|
116
|
+
const cached = key ? cache.get(key) : undefined;
|
|
117
|
+
if (cached) return {
|
|
118
|
+
...cached,
|
|
119
|
+
lines: cached.lines.slice(),
|
|
120
|
+
widths: cached.widths.slice()
|
|
121
|
+
};
|
|
122
|
+
// A cut label ends with the ellipsis it is painted with.
|
|
123
|
+
const wrap = textWrap().fontFamily(fF).fontSize(fS).lineHeight(lineHeight).ellipsis(labelEllipsis(axis.schema.shapeConfig));
|
|
124
|
+
if (slanted) {
|
|
125
|
+
// Slanted labels wrap between words, never mid-word.
|
|
126
|
+
wrap.split(wholeWordSplit).width(Math.min(slanted.width, ctx.slantWidth ?? Infinity)).height(slanted.height);
|
|
127
|
+
} else {
|
|
128
|
+
wrap[w](horizontal ? space : depth);
|
|
129
|
+
// A flat label's lines share its room with its padding (see `res.height`).
|
|
130
|
+
wrap[h](horizontal ? depth - (rotate ? 0 : fP) : space);
|
|
131
|
+
}
|
|
132
|
+
let res, fits;
|
|
133
|
+
let cut = false;
|
|
134
|
+
if (ctx.wholeLine) {
|
|
135
|
+
// Measured across the whole axis (`maxSize` caps its depth, not its
|
|
136
|
+
// length), a label that still breaks onto a second line can't be drawn
|
|
137
|
+
// whole on one.
|
|
138
|
+
wrap.width(axis.schema.width - p * 2);
|
|
139
|
+
res = wrap(text);
|
|
140
|
+
fits = !res.truncated && res.lines.filter((l)=>l !== "").length <= 1;
|
|
141
|
+
} else {
|
|
142
|
+
res = wrap(text);
|
|
143
|
+
// Within a strict `maxSize`, a slanted label reaches out no further
|
|
144
|
+
// than the room it has, its padding with it.
|
|
145
|
+
if (slanted && ctx.strict) res = slantWithin(wrap, text, res, {
|
|
146
|
+
angle: angle,
|
|
147
|
+
horizontal,
|
|
148
|
+
depth: Math.floor(depth - (horizontal ? fP : 0)),
|
|
149
|
+
width: Math.min(slanted.width, ctx.slantWidth ?? Infinity)
|
|
150
|
+
});
|
|
151
|
+
// A label that only fits by breaking a word mid-word doesn't fit.
|
|
152
|
+
fits = wholeWordFit(res, ()=>wrap.split(wholeWordSplit)(text)).fits;
|
|
153
|
+
if (!rotate && `${text}`.trim() && !res.lines.some((l)=>l !== "")) ({ res, cut } = horizontal ? longWordLabel(wrap, text, space, wSize - p * 2, ctx) : longWordLabel(wrap, text, depth, depth, {
|
|
154
|
+
keepShare: true
|
|
155
|
+
}));
|
|
156
|
+
}
|
|
157
|
+
res.fits = fits;
|
|
158
|
+
res.cut = cut;
|
|
159
|
+
res.lines = res.lines.filter((d)=>d !== "");
|
|
160
|
+
res.width = res.lines.length ? Math.ceil(max(res.widths)) : 0;
|
|
161
|
+
res.height = res.lines.length ? Math.ceil(res.lines.length * wrap.lineHeight()) + fP : 0;
|
|
162
|
+
if (key) cache.set(key, {
|
|
163
|
+
lines: res.lines.slice(),
|
|
164
|
+
widths: res.widths.slice(),
|
|
165
|
+
width: res.width,
|
|
166
|
+
height: res.height,
|
|
167
|
+
fits,
|
|
168
|
+
cut
|
|
169
|
+
});
|
|
170
|
+
return res;
|
|
171
|
+
}
|