@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
|
@@ -15,3 +15,11 @@ export declare const roundingScales: string[];
|
|
|
15
15
|
scale's domain rounds as a linear one does.
|
|
16
16
|
*/
|
|
17
17
|
export declare function roundedDomain(initialDomain: number[], rounding: string, scale: string): number[] | undefined;
|
|
18
|
+
/**
|
|
19
|
+
The open end of an axis rounded "inside" that the value `d` labels, if
|
|
20
|
+
any: "min" when `d` is the lowest of the `values` the axis labels and
|
|
21
|
+
the `domain` reaches down to it, "max" when it is the highest and the
|
|
22
|
+
domain reaches up to it. A value beyond the domain has nothing past it,
|
|
23
|
+
so it is not open-ended.
|
|
24
|
+
*/
|
|
25
|
+
export declare function openEnd(d: unknown, values: unknown[], domain: unknown[]): "min" | "max" | undefined;
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The axis title, configured once for both the measure and the paint, so
|
|
3
|
+
the title claims exactly the room it draws.
|
|
4
|
+
*/
|
|
5
|
+
import type { DataPoint } from "@d3plus/data";
|
|
6
|
+
import TextBox from "../TextBox.js";
|
|
7
|
+
import type Axis from "./Axis.js";
|
|
8
|
+
/**
|
|
9
|
+
Whether the first word of `box`'s text is wider than its line on its
|
|
10
|
+
own, as the wrap measures it. The wrap can't place such a word on any
|
|
11
|
+
line, so the box would draw nothing.
|
|
12
|
+
*/
|
|
13
|
+
export declare function firstWordOverflows(box: TextBox, d: DataPoint, i: number): boolean;
|
|
14
|
+
/**
|
|
15
|
+
Configures `box` as the axis title wrapped across `range`, in a box
|
|
16
|
+
`height` tall: its text, width, rotation, and `titleConfig`. A first
|
|
17
|
+
word too wide for the axis is cut mid-word with the ellipsis
|
|
18
|
+
(`truncateWord`), so the title still draws; any other title cut short
|
|
19
|
+
ends at a word break. A `truncateWord` in `titleConfig` overrides both.
|
|
20
|
+
A title left out (see `measureAxis` in `axisLimit.ts`) has no data, so
|
|
21
|
+
draws nothing.
|
|
22
|
+
*/
|
|
23
|
+
export declare function configureTitle(box: TextBox, axis: Axis, range: number[], height: number): TextBox;
|
|
24
|
+
/**
|
|
25
|
+
The room the axis title claims on the axis's side: its lines as the
|
|
26
|
+
title TextBox wraps them across `range`, within `height`, to the whole
|
|
27
|
+
pixel, plus the axis's padding. A title that draws nothing claims no
|
|
28
|
+
room.
|
|
29
|
+
*/
|
|
30
|
+
export declare function titleRoom(axis: Axis, range: number[], height: number): number;
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
What an axis's title and tick labels carry for a chart's axis tooltips
|
|
3
|
+
(see `charts/features/axisTooltip.ts`): each label's scene nodes are
|
|
4
|
+
stamped with the label's value, its whole text, whether it is drawn cut
|
|
5
|
+
short, and the axis's `titleTooltip` or `tickTooltip`. A label no tooltip
|
|
6
|
+
could show for is left unstamped.
|
|
7
|
+
*/
|
|
8
|
+
import type { SceneNode } from "@d3plus/render";
|
|
9
|
+
/** The label a pointer can show an axis tooltip for. */
|
|
10
|
+
export interface AxisTooltipTarget {
|
|
11
|
+
/** Which part of the axis the label is. */
|
|
12
|
+
part: "title" | "tick";
|
|
13
|
+
/** The tick's value, or the title. */
|
|
14
|
+
value: unknown;
|
|
15
|
+
/** The tick's index among the axis's labels, from the start of its domain (0 for a title). */
|
|
16
|
+
index: number;
|
|
17
|
+
/** The label's whole text. */
|
|
18
|
+
text: string;
|
|
19
|
+
/** Whether the label is drawn cut short. */
|
|
20
|
+
truncated: boolean;
|
|
21
|
+
/** The axis's `titleTooltip` or `tickTooltip`. */
|
|
22
|
+
option: unknown;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
The axis label a scene node was stamped as, if any.
|
|
26
|
+
@param node A picked scene node.
|
|
27
|
+
*/
|
|
28
|
+
export declare function axisTooltipTarget(node: SceneNode | null | undefined): AxisTooltipTarget | undefined;
|
|
29
|
+
/**
|
|
30
|
+
Whether a text node draws less than `text`: its layout cut it short (see
|
|
31
|
+
`TextNode.truncated`) and its lines don't spell the whole text.
|
|
32
|
+
@param node A label's scene node.
|
|
33
|
+
@param text The label's whole text.
|
|
34
|
+
*/
|
|
35
|
+
export declare function labelCut(node: SceneNode, text: string): boolean;
|
|
36
|
+
/**
|
|
37
|
+
Whether a label with `option` for its tooltip option could show one.
|
|
38
|
+
@param option An axis's `titleTooltip` or `tickTooltip`.
|
|
39
|
+
@param truncated Whether the label is drawn cut short.
|
|
40
|
+
*/
|
|
41
|
+
export declare const canShow: (option: unknown, truncated: boolean) => boolean;
|
|
42
|
+
/** What `tickRank` reads of an axis. */
|
|
43
|
+
export interface RankedAxis {
|
|
44
|
+
schema: {
|
|
45
|
+
scale?: unknown;
|
|
46
|
+
};
|
|
47
|
+
_domainEndFirst?: boolean;
|
|
48
|
+
_givenDomain(): unknown[];
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
Where a tick's value falls along an axis's domain, counted from the
|
|
52
|
+
domain's start: the lowest value of a value or time axis, the first
|
|
53
|
+
category of a categorical one (its last when the axis holds its domain
|
|
54
|
+
end first). Neither `reverse` nor a descending domain moves a value's
|
|
55
|
+
place.
|
|
56
|
+
@param axis A laid-out axis.
|
|
57
|
+
*/
|
|
58
|
+
export declare function tickRank(axis: RankedAxis): (value: unknown) => number;
|
|
59
|
+
/**
|
|
60
|
+
Stamps an axis's tick label nodes (each label's text, and its hitbox when
|
|
61
|
+
it has one) with their tooltip target.
|
|
62
|
+
@param nodes The tick labels' scene nodes.
|
|
63
|
+
@param option The axis's `tickTooltip`.
|
|
64
|
+
@param rank Each tick value's place along the axis (see `tickRank`):
|
|
65
|
+
labels are indexed in that order, or in the order of `nodes` without it.
|
|
66
|
+
*/
|
|
67
|
+
export declare function stampTickTooltips(nodes: SceneNode[], option: unknown, rank?: (value: unknown) => number): void;
|
|
68
|
+
/**
|
|
69
|
+
Stamps an axis's title nodes with their tooltip target.
|
|
70
|
+
@param nodes The title's scene nodes.
|
|
71
|
+
@param title The axis's title.
|
|
72
|
+
@param option The axis's `titleTooltip`.
|
|
73
|
+
*/
|
|
74
|
+
export declare function stampTitleTooltip(nodes: SceneNode[], title: unknown, option: unknown): void;
|
|
75
|
+
/**
|
|
76
|
+
An axis's scene as chrome under a chart's marks: every node takes the
|
|
77
|
+
"axis" interaction group, and each one that draws leaves hit-testing
|
|
78
|
+
unless it is stamped with a tooltip target, so the pointer reaches the
|
|
79
|
+
axis only on a label with a tooltip to show.
|
|
80
|
+
@param node An axis's scene, or a node in it.
|
|
81
|
+
*/
|
|
82
|
+
export declare function inertAxis(node: SceneNode): SceneNode;
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { D3Scale } from "../../utils/index.js";
|
|
2
|
+
import { type RangeBreakRule, type TimeGap } from "./rangeBreaks.js";
|
|
3
|
+
/** Options for `brokenTimeScale`. */
|
|
4
|
+
export interface BrokenTimeScaleOptions {
|
|
5
|
+
/** Read the rules' calendar in UTC instead of local time. */
|
|
6
|
+
utc?: boolean;
|
|
7
|
+
/** Pixels each marked gap inside the domain occupies (default 0). */
|
|
8
|
+
space?: number;
|
|
9
|
+
}
|
|
10
|
+
/** A hidden stretch inside the scale's domain, with the pixels it occupies. */
|
|
11
|
+
export interface ScaleTimeGap extends TimeGap {
|
|
12
|
+
/** Pixels the gap occupies: `space` for a marked gap, else 0. */
|
|
13
|
+
space: number;
|
|
14
|
+
}
|
|
15
|
+
/** A continuous time scale whose mapping skips hidden time. */
|
|
16
|
+
export interface BrokenTimeScale extends D3Scale {
|
|
17
|
+
/** The rules the scale hides time by. */
|
|
18
|
+
rangeBreaks: RangeBreakRule[];
|
|
19
|
+
/** The hidden stretches inside the domain, clipped to it, ascending. */
|
|
20
|
+
gaps(): ScaleTimeGap[];
|
|
21
|
+
/** Whether a time is hidden. */
|
|
22
|
+
isHidden(t: number | Date): boolean;
|
|
23
|
+
/** The visible time (ms) between two times, signed like `b - a`. */
|
|
24
|
+
visible(a: number | Date, b: number | Date): number;
|
|
25
|
+
/** The time `ms` of visible time after (or, when negative, before) `t`. */
|
|
26
|
+
offset(t: number | Date, ms: number): Date;
|
|
27
|
+
/** A d3 time tick format for the scale's domain. */
|
|
28
|
+
tickFormat(count?: number, specifier?: string): (d: Date) => string;
|
|
29
|
+
}
|
|
30
|
+
/** Whether `scale` is a broken time scale. */
|
|
31
|
+
export declare const isBrokenTimeScale: (scale: unknown) => scale is BrokenTimeScale;
|
|
32
|
+
/**
|
|
33
|
+
The time between `a` and `b` on `scale` (`b - a`, in ms): on a broken
|
|
34
|
+
time scale, only the time it shows.
|
|
35
|
+
*/
|
|
36
|
+
export declare const scaleTimeStep: (scale: unknown, a: number | Date, b: number | Date) => number;
|
|
37
|
+
/**
|
|
38
|
+
The time `ms` after `t` (before it, when negative) on `scale`: on a
|
|
39
|
+
broken time scale, stepping over the time it hides.
|
|
40
|
+
*/
|
|
41
|
+
export declare const scaleTimeShift: (scale: unknown, t: number | Date, ms: number) => Date;
|
|
42
|
+
/**
|
|
43
|
+
Builds a time scale that hides the time `rules` describe. It reads like
|
|
44
|
+
d3's `scaleTime` — `domain`, `range`, `ticks`, `tickFormat`, `invert`,
|
|
45
|
+
and `copy` — but visible time shares one pixel rate and hidden time
|
|
46
|
+
takes none (or a marked gap's `space`). A hidden time maps to where its
|
|
47
|
+
gap sits; a pixel at a closed gap inverts to the time after it. Times
|
|
48
|
+
past the domain extrapolate through the rules' gaps, so a scale can be
|
|
49
|
+
padded or zoomed out.
|
|
50
|
+
*/
|
|
51
|
+
export declare function brokenTimeScale(rules: RangeBreakRule[], options?: BrokenTimeScaleOptions): BrokenTimeScale;
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/** A time value a rule reads: a Date, a timestamp, or a date string. */
|
|
2
|
+
export type RangeBreakTime = Date | number | string;
|
|
3
|
+
/**
|
|
4
|
+
One stretch of time a time axis hides:
|
|
5
|
+
|
|
6
|
+
- `"weekends"`: every Saturday and Sunday.
|
|
7
|
+
- `{days: [6, 0]}`: every day of the week listed (0 is Sunday, 6 is Saturday).
|
|
8
|
+
- `{hours: [17, 9]}`: the same hours of every day, from the first hour to
|
|
9
|
+
the second (fractions are minutes, so `9.5` is 9:30); a start after the
|
|
10
|
+
end wraps past midnight, so `[17, 9]` hides 5pm to 9am.
|
|
11
|
+
- `{values: [date, …]}`: each listed date's whole day, such as holidays.
|
|
12
|
+
- `{bounds: [start, end]}`: one explicit range, from `start` up to `end`.
|
|
13
|
+
|
|
14
|
+
An object rule's `marker` draws the axis's break marker where its time
|
|
15
|
+
was removed, leaving a short gap there. It defaults to `true` for
|
|
16
|
+
`bounds` and `false` for the others, which recur too often to mark.
|
|
17
|
+
*/
|
|
18
|
+
export type RangeBreakRule = "weekends" | {
|
|
19
|
+
days: number[];
|
|
20
|
+
marker?: boolean;
|
|
21
|
+
} | {
|
|
22
|
+
hours: [number, number];
|
|
23
|
+
marker?: boolean;
|
|
24
|
+
} | {
|
|
25
|
+
values: RangeBreakTime[];
|
|
26
|
+
marker?: boolean;
|
|
27
|
+
} | {
|
|
28
|
+
bounds: [RangeBreakTime, RangeBreakTime];
|
|
29
|
+
marker?: boolean;
|
|
30
|
+
};
|
|
31
|
+
/** A hidden stretch of time, from `start` (hidden) up to `end` (shown), in ms. */
|
|
32
|
+
export interface TimeGap {
|
|
33
|
+
start: number;
|
|
34
|
+
end: number;
|
|
35
|
+
/** Whether the gap draws a break marker. */
|
|
36
|
+
marker: boolean;
|
|
37
|
+
}
|
|
38
|
+
/** A rule value read as a timestamp, or `NaN` when it doesn't parse. */
|
|
39
|
+
export declare function rangeBreakTime(value: unknown): number;
|
|
40
|
+
/** Whether `rule` is a rule a time axis can read. */
|
|
41
|
+
export declare function isRangeBreakRule(rule: unknown): rule is RangeBreakRule;
|
|
42
|
+
/**
|
|
43
|
+
Reads a `rangeBreaks` setting — one rule, a list of them, or a falsy
|
|
44
|
+
value — into the list of rules a time axis can use, dropping any it
|
|
45
|
+
can't read.
|
|
46
|
+
*/
|
|
47
|
+
export declare function normalizeRangeBreaks(input: unknown): RangeBreakRule[];
|
|
48
|
+
/** Whether a rule draws a break marker (see `RangeBreakRule`). */
|
|
49
|
+
export declare const ruleMarker: (rule: RangeBreakRule) => boolean;
|
|
50
|
+
/**
|
|
51
|
+
The stretches of time `rules` hide that overlap `[lo, hi]`: sorted,
|
|
52
|
+
with overlapping and touching gaps merged (a merged gap draws a marker
|
|
53
|
+
when any of its rules does). Gaps are not clipped to `[lo, hi]`.
|
|
54
|
+
@param utc Read the calendar in UTC instead of local time.
|
|
55
|
+
*/
|
|
56
|
+
export declare function rangeBreakGaps(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): TimeGap[];
|
|
57
|
+
/** The last gap starting at or before `t` (gaps sorted by start), or -1. */
|
|
58
|
+
export declare function gapIndex(gaps: TimeGap[], t: number): number;
|
|
59
|
+
/**
|
|
60
|
+
A test for whether a time between `lo` and `hi` is hidden by `rules`:
|
|
61
|
+
the gaps are found once, so the test is cheap to run over many values.
|
|
62
|
+
A time outside `[lo, hi]` is tested on its own.
|
|
63
|
+
*/
|
|
64
|
+
export declare function rangeBreakTest(rules: RangeBreakRule[], lo: number, hi: number, utc?: boolean): (t: number | Date) => boolean;
|
|
65
|
+
/** Whether `rules` hide the time `t`. */
|
|
66
|
+
export declare function isHiddenTime(rules: RangeBreakRule[], t: number | Date, utc?: boolean): boolean;
|
|
67
|
+
/**
|
|
68
|
+
The visible time between `a` and `b` (in ms, `a <= b`): their distance
|
|
69
|
+
less every hidden stretch between them.
|
|
70
|
+
*/
|
|
71
|
+
export declare function visibleBetween(rules: RangeBreakRule[], a: number, b: number, utc?: boolean): number;
|
|
72
|
+
/**
|
|
73
|
+
Whether `rules` hide all of time: a week (plus a day for DST) with no
|
|
74
|
+
visible moment, which repeating rules then repeat forever.
|
|
75
|
+
*/
|
|
76
|
+
export declare function hidesAllTime(rules: RangeBreakRule[], utc?: boolean): boolean;
|
|
77
|
+
/**
|
|
78
|
+
The time `ms` of visible time after `t` (or before it, when `ms` is
|
|
79
|
+
negative), stepping over every hidden stretch on the way. Rules that
|
|
80
|
+
hide all of time leave `t` where it is.
|
|
81
|
+
*/
|
|
82
|
+
export declare function offsetVisible(rules: RangeBreakRule[], t: number, ms: number, utc?: boolean): number;
|
|
@@ -33,7 +33,7 @@ export declare function axisTimeDomain(axis: Axis): Date[];
|
|
|
33
33
|
*/
|
|
34
34
|
export declare function axisTimeLocale(axis: Axis): TimeLocaleDefinition;
|
|
35
35
|
/**
|
|
36
|
-
The ordered Dates a time axis picks its label interval from: its parsed `data`, else its domain.
|
|
36
|
+
The ordered Dates a time axis picks its label interval from: its parsed `data`, else the labels its scale offers (when two or more), else its domain.
|
|
37
37
|
@private
|
|
38
38
|
*/
|
|
39
39
|
export declare function axisTimeReference(axis: Axis): Date[];
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { D3Selection } from "@d3plus/dom";
|
|
2
2
|
import type { DataPoint } from "@d3plus/data";
|
|
3
|
-
import type { GroupNode } from "@d3plus/render";
|
|
3
|
+
import type { GroupNode, SceneNode } from "@d3plus/render";
|
|
4
4
|
import type { SvgRenderer } from "@d3plus/render";
|
|
5
5
|
import { Axis, TextBox } from "../index.js";
|
|
6
6
|
import { Rect } from "../../shapes/index.js";
|
|
@@ -8,11 +8,13 @@ import { BaseClass } from "../../utils/index.js";
|
|
|
8
8
|
import type { D3Scale } from "../../utils/index.js";
|
|
9
9
|
import Legend from "../Legend/Legend.js";
|
|
10
10
|
import type { ColorScaleType } from "./colorScaleType.js";
|
|
11
|
+
import type { SwatchBucket } from "./colorScaleSwatchTooltips.js";
|
|
11
12
|
import type { ColorScaleBarGeometry } from "./colorScaleHoverMark.js";
|
|
12
13
|
/**
|
|
13
14
|
Creates an SVG color scale based on an array of data.
|
|
14
15
|
*/
|
|
15
16
|
export default class ColorScale extends BaseClass {
|
|
17
|
+
static readonly _displayName: string;
|
|
16
18
|
[key: string]: any;
|
|
17
19
|
_select: D3Selection;
|
|
18
20
|
_axisClass: Axis;
|
|
@@ -30,8 +32,14 @@ export default class ColorScale extends BaseClass {
|
|
|
30
32
|
_scaleType: ColorScaleType;
|
|
31
33
|
/** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */
|
|
32
34
|
_barGeometry?: ColorScaleBarGeometry;
|
|
33
|
-
/** The value marked on the scale, set with `hover()
|
|
34
|
-
_hoverValue?: number | false;
|
|
35
|
+
/** The value marked on the scale, set with `hover()`: a pair of values on a bivariate scale. */
|
|
36
|
+
_hoverValue?: number | [number, number] | false;
|
|
37
|
+
/** The names a chart gives a bivariate scale's two variables (its field names), under `bivariateLabels`. */
|
|
38
|
+
_bivariateFields?: string[];
|
|
39
|
+
/** The bivariate key's nodes, laid out by the last render. */
|
|
40
|
+
_bivariateNodes?: SceneNode[];
|
|
41
|
+
/** Each swatch's legend row, with its bucket, set when the swatch variant renders. */
|
|
42
|
+
_swatchBuckets: Map<unknown, SwatchBucket>;
|
|
35
43
|
/** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */
|
|
36
44
|
_gradientFill?: string;
|
|
37
45
|
_sceneRenderer?: SvgRenderer;
|
|
@@ -48,10 +56,13 @@ export default class ColorScale extends BaseClass {
|
|
|
48
56
|
/**
|
|
49
57
|
Produces a backend-agnostic scene graph for this ColorScale with no DOM
|
|
50
58
|
dependency. The discrete variant (jenks/buckets/quantile) delegates to the
|
|
51
|
-
internal Legend's toScene()
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
59
|
+
internal Legend's toScene(), its title and swatch labels taking the axis
|
|
60
|
+
tooltips (see `swatchTooltips`); the gradient variant composes the Rect,
|
|
61
|
+
Axis, and label TextBox scenes, all as chrome (see `inertAxis`): only an
|
|
62
|
+
axis label with a tooltip takes the pointer. The scaleGroup's
|
|
63
|
+
translate (set by the chart's colorScale feature on
|
|
64
|
+
`g.d3plus-viz-colorScale`) is read off `_select` so the content lands at
|
|
65
|
+
its on-screen position.
|
|
55
66
|
|
|
56
67
|
A smooth (non-bucketed) gradient paints its Rect with a `gradient:<json>`
|
|
57
68
|
fill token (see renderGradientStops); the backend materializes it into a
|
|
@@ -60,7 +71,7 @@ export default class ColorScale extends BaseClass {
|
|
|
60
71
|
*/
|
|
61
72
|
toScene(): GroupNode;
|
|
62
73
|
/**
|
|
63
|
-
The ColorScale is constructed by combining an Axis for the ticks/labels and a Rect for the actual color box (or multiple boxes, as in a jenks scale). Because of this, there are separate configs for the Axis class used to display the text (axisConfig) and the Rect class used to draw the color breaks (rectConfig). This method acts as a pass-through to the config method of the Axis.
|
|
74
|
+
The ColorScale is constructed by combining an Axis for the ticks/labels and a Rect for the actual color box (or multiple boxes, as in a jenks scale). Because of this, there are separate configs for the Axis class used to display the text (axisConfig) and the Rect class used to draw the color breaks (rectConfig). This method acts as a pass-through to the config method of the Axis. A scale drawn as swatches has no Axis: its `title` and `titleTooltip` apply to the swatches' title, and its `tickTooltip` to each swatch's label, given the value and index of the label at that bucket's start on a `bucketAxis` bar.
|
|
64
75
|
*/
|
|
65
76
|
axisConfig(): Record<string, unknown>;
|
|
66
77
|
axisConfig(_: Record<string, unknown>): this;
|
|
@@ -70,10 +81,10 @@ export default class ColorScale extends BaseClass {
|
|
|
70
81
|
data(): DataPoint[];
|
|
71
82
|
data(_: DataPoint[]): this;
|
|
72
83
|
/**
|
|
73
|
-
Marks a value on the scale: an extra axis tick where the value falls on the color bar and a badge reading it where that tick's label would sit, plus an outline around its bucket on a bucketed bar (`bucketAxis`). A scale drawn as discrete swatches draws no mark. A chart sets this while one of its shapes is hovered. Pass `false` to clear it. Turned off with `hoverMark(false)`.
|
|
84
|
+
Marks a value on the scale: an extra axis tick where the value falls on the color bar and a badge reading it where that tick's label would sit, plus an outline around its bucket on a bucketed bar (`bucketAxis`). A scale drawn as discrete swatches draws no mark, and a bivariate scale takes a pair of values. A chart sets this while one of its shapes is hovered. Pass `false` to clear it. Turned off with `hoverMark(false)`.
|
|
74
85
|
*/
|
|
75
|
-
hover(): number | false | undefined;
|
|
76
|
-
hover(_: number | false): this;
|
|
86
|
+
hover(): number | [number, number] | false | undefined;
|
|
87
|
+
hover(_: number | [number, number] | false): this;
|
|
77
88
|
/**
|
|
78
89
|
A pass-through for the TextBox class used to style the labelMin and labelMax text.
|
|
79
90
|
*/
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { SceneNode } from "@d3plus/render";
|
|
2
|
+
import type { DataPoint } from "@d3plus/data";
|
|
3
|
+
import type ColorScale from "./ColorScale.js";
|
|
4
|
+
import type { BivariateScale } from "./bivariateScale.js";
|
|
5
|
+
/** A bivariate key cell's datum: a colorScale bucket that is one cell of the grid. */
|
|
6
|
+
export interface BivariateCell extends DataPoint {
|
|
7
|
+
color: string;
|
|
8
|
+
id: string;
|
|
9
|
+
_isColorScaleBucket: true;
|
|
10
|
+
/** The cell's column: the first variable's bin. */
|
|
11
|
+
_bivariateX: number;
|
|
12
|
+
/** The cell's row: the second variable's bin. */
|
|
13
|
+
_bivariateY: number;
|
|
14
|
+
}
|
|
15
|
+
/** Where a laid-out bivariate key draws, in its own space. */
|
|
16
|
+
export interface BivariateLayout {
|
|
17
|
+
nodes: SceneNode[];
|
|
18
|
+
bounds: {
|
|
19
|
+
x: number;
|
|
20
|
+
y: number;
|
|
21
|
+
width: number;
|
|
22
|
+
height: number;
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
The names the key gives its two variables: `bivariateLabels`, else the
|
|
27
|
+
names the chart passes (its field names).
|
|
28
|
+
@param cs The ColorScale.
|
|
29
|
+
*/
|
|
30
|
+
export declare function bivariateAxisLabels(cs: ColorScale): [string, string];
|
|
31
|
+
/**
|
|
32
|
+
How a ColorScale's values read in a bivariate key's ranges and in a
|
|
33
|
+
chart's tooltip: `axisConfig.tickFormat`, else a variable whose values
|
|
34
|
+
all read as years as years, else abbreviated (`formatAbbreviate`).
|
|
35
|
+
@param cs The ColorScale.
|
|
36
|
+
@param values The variable's values.
|
|
37
|
+
*/
|
|
38
|
+
export declare function colorScaleValueFormat(cs: ColorScale, values: number[]): (v: number) => string;
|
|
39
|
+
/**
|
|
40
|
+
Lays the key out within the ColorScale's `width` × `height`: its grid
|
|
41
|
+
shrinks from its full size to fit, and it sits along the side its labels
|
|
42
|
+
face (`orient`) at its `align`ment, as the swatch legend does.
|
|
43
|
+
@param cs The ColorScale.
|
|
44
|
+
@param scale Its bivariate scale.
|
|
45
|
+
*/
|
|
46
|
+
export declare function layoutBivariate(cs: ColorScale, scale: BivariateScale): BivariateLayout;
|
|
47
|
+
/**
|
|
48
|
+
Builds a bivariate ColorScale's scale from its data (each row's `value`
|
|
49
|
+
a pair of numbers), assigns it as the ColorScale's `_colorScale`, and
|
|
50
|
+
lays out its diamond key.
|
|
51
|
+
@param cs The ColorScale.
|
|
52
|
+
*/
|
|
53
|
+
export declare function renderBivariate(cs: ColorScale): BivariateLayout;
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Joshua Stevens' blue–red 3×3 scheme, from "Bivariate Choropleth Maps: A
|
|
3
|
+
How-to Guide" (joshuastevens.net/cartography/make-a-bivariate-choropleth-map/),
|
|
4
|
+
with the hex values as published in the R `pals` package
|
|
5
|
+
(`stevens.bluered`). Row-major from the low/low corner: each row is one
|
|
6
|
+
bin of the second variable (low to high), each column one bin of the
|
|
7
|
+
first (low to high). The first variable rises toward red (#c85a5a), the
|
|
8
|
+
second toward blue (#64acbe), and both together toward #574249. Each
|
|
9
|
+
inner color is the two ramps multiplied over the shared #e8e8e8 base.
|
|
10
|
+
*/
|
|
11
|
+
export declare const BIVARIATE_COLORS: readonly string[];
|
|
12
|
+
/** The fewest and most bins a bivariate ColorScale splits each variable into. */
|
|
13
|
+
export declare const BIVARIATE_MIN_BUCKETS = 2;
|
|
14
|
+
export declare const BIVARIATE_MAX_BUCKETS = 4;
|
|
15
|
+
/** The bins per variable when none is set. */
|
|
16
|
+
export declare const BIVARIATE_BUCKETS = 3;
|
|
17
|
+
/**
|
|
18
|
+
The number of bins per variable: `value` rounded and held within 2–4, or
|
|
19
|
+
3 when it isn't a number.
|
|
20
|
+
@param value The configured bin count.
|
|
21
|
+
*/
|
|
22
|
+
export declare function bivariateBucketCount(value: unknown): number;
|
|
23
|
+
/**
|
|
24
|
+
Resamples a square grid of colors (row-major, `k×k`) to `n×n`: a grid
|
|
25
|
+
already `n×n` is returned as given, and any other is blended
|
|
26
|
+
bilinearly between its nearest colors, so its corners stay put. A 3×3
|
|
27
|
+
scheme resampled to 4×4 keeps its corners and blends its middle colors
|
|
28
|
+
across the new cells; one resampled to 2×2 keeps only its corners.
|
|
29
|
+
@param grid The colors, row-major.
|
|
30
|
+
@param n The side of the grid to return.
|
|
31
|
+
*/
|
|
32
|
+
export declare function resampleGrid(grid: readonly string[], n: number): string[];
|
|
33
|
+
/**
|
|
34
|
+
The `n×n` colors a bivariate ColorScale paints with (row-major, as
|
|
35
|
+
`BIVARIATE_COLORS`): `colors` when it is a square grid of at least 2×2
|
|
36
|
+
color strings, resampled to `n×n` (see `resampleGrid`), else Stevens'
|
|
37
|
+
3×3 scheme resampled the same way.
|
|
38
|
+
@param colors The configured grid.
|
|
39
|
+
@param n The bins per variable.
|
|
40
|
+
*/
|
|
41
|
+
export declare function bivariatePalette(colors: unknown, n: number): string[];
|
|
42
|
+
/** One variable's bins, as `bivariateBins` returns them. */
|
|
43
|
+
export interface BivariateBins {
|
|
44
|
+
/** The bin (0 to `n - 1`) a value falls in. */
|
|
45
|
+
bin: (value: number) => number;
|
|
46
|
+
/** Each bin's lowest and highest value in the data, or null for a bin holding none. */
|
|
47
|
+
ranges: ([number, number] | null)[];
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
Splits one variable's values into `n` quantile bins by rank: a value's
|
|
51
|
+
bin is its share of the values ranked below it (ties counted at their
|
|
52
|
+
middle rank), so each bin holds about as many values as the next, and
|
|
53
|
+
equal values always share a bin. A value outside the data ranks by
|
|
54
|
+
where it would sort.
|
|
55
|
+
@param values The variable's values (non-finite ones are ignored).
|
|
56
|
+
@param n The number of bins.
|
|
57
|
+
*/
|
|
58
|
+
export declare function bivariateBins(values: number[], n: number): BivariateBins;
|
|
59
|
+
/** A value pair a bivariate ColorScale can place: two finite numbers. */
|
|
60
|
+
export type BivariatePair = [number, number];
|
|
61
|
+
/** Whether `value` is a pair of finite numbers. */
|
|
62
|
+
export declare function isBivariatePair(value: unknown): value is BivariatePair;
|
|
63
|
+
/**
|
|
64
|
+
A bivariate color scale: called with a value pair, it returns the color
|
|
65
|
+
of the cell the pair's bins pick (undefined for anything else).
|
|
66
|
+
*/
|
|
67
|
+
export interface BivariateScale {
|
|
68
|
+
(value: unknown): string | undefined;
|
|
69
|
+
/** The cell `[column, row]` a pair falls in: its first variable's bin, then its second's. */
|
|
70
|
+
cell(value: unknown): [number, number] | null;
|
|
71
|
+
/** The bins per variable. */
|
|
72
|
+
size: number;
|
|
73
|
+
/** The first variable's bins. */
|
|
74
|
+
x: BivariateBins;
|
|
75
|
+
/** The second variable's bins. */
|
|
76
|
+
y: BivariateBins;
|
|
77
|
+
/** The `n×n` colors, row-major (see `BIVARIATE_COLORS`). */
|
|
78
|
+
colors: string[];
|
|
79
|
+
/** Every value pair the scale was built from. */
|
|
80
|
+
domain(): BivariatePair[];
|
|
81
|
+
/** The colors, as a d3 scale's `range`. */
|
|
82
|
+
range(): string[];
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
Builds a bivariate color scale from the value pairs in the data: each
|
|
86
|
+
variable binned into `n` quantiles (see `bivariateBins`), colored from
|
|
87
|
+
`colors`, an `n×n` grid (see `bivariatePalette`).
|
|
88
|
+
@param pairs The data's value pairs.
|
|
89
|
+
@param n The bins per variable.
|
|
90
|
+
@param colors The `n×n` colors, row-major.
|
|
91
|
+
*/
|
|
92
|
+
export declare function bivariateScale(pairs: BivariatePair[], n: number, colors: string[]): BivariateScale;
|
|
@@ -3,10 +3,24 @@
|
|
|
3
3
|
significant digits so float noise (`0.1 + 0.2`) doesn't count.
|
|
4
4
|
*/
|
|
5
5
|
export declare function decimalPlaces(value: number): number;
|
|
6
|
+
/** The number of significant digits `value` is written with, at 15 digits. */
|
|
7
|
+
export declare function significantDigits(value: number): number;
|
|
8
|
+
/**
|
|
9
|
+
The decimal places bucket labels step at: the most any value is written
|
|
10
|
+
with. A computed value (a mean such as `1 / 3`) carries float precision
|
|
11
|
+
no label should step at, so its own places count only to the data's
|
|
12
|
+
display precision: three significant digits of the values' span. A value
|
|
13
|
+
within float noise of zero (`-1.4e-14`) counts as zero.
|
|
14
|
+
*/
|
|
15
|
+
export declare function labelPlaces(allValues: number[]): number;
|
|
16
|
+
/** `value` rounded to the places bucket labels step at (see `labelPlaces`). */
|
|
17
|
+
export declare function labelValue(value: number, allValues: number[]): number;
|
|
6
18
|
/**
|
|
7
19
|
The `[lower, upper]` values a ColorScale label shows for the bucket
|
|
8
20
|
`[ticks[i], ticks[i + 1])`: the first and last values the data's own
|
|
9
|
-
precision can write inside it, so integer data reads
|
|
21
|
+
precision (see `labelPlaces`) can write inside it, so integer data reads
|
|
22
|
+
"1 - 2", "3 - 4", and computed values such as means don't step at float
|
|
23
|
+
precision (a bucket ending at 0 reads "-9.5 - -0.1", not "-9.5 - -1f").
|
|
10
24
|
When `format` prints the upper bound the same as the next bucket's lower
|
|
11
25
|
one (an abbreviation like "1.5k"), the upper bound drops a decimal place
|
|
12
26
|
at a time until it reads differently ("1.49k").
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
The axis tooltips of a color scale drawn as swatches: the legend's title
|
|
3
|
+
takes the scale's `axisConfig.titleTooltip`, and each swatch label its
|
|
4
|
+
`axisConfig.tickTooltip`, given the same value and index as the label at
|
|
5
|
+
that bucket's start on a `bucketAxis` bar. A label drawn cut short shows
|
|
6
|
+
its whole text. The swatches keep their bucket's tooltip and highlight,
|
|
7
|
+
and a label showing its tooltip lights its bucket too (see
|
|
8
|
+
`handleSwatchLabelHover`).
|
|
9
|
+
*/
|
|
10
|
+
import type { SceneNode } from "@d3plus/render";
|
|
11
|
+
/** The bucket a swatch stands for. */
|
|
12
|
+
export interface SwatchBucket {
|
|
13
|
+
/** The tick the bucket starts at. */
|
|
14
|
+
value: number;
|
|
15
|
+
/** The bucket's place from the lowest. */
|
|
16
|
+
index: number;
|
|
17
|
+
}
|
|
18
|
+
/** What a swatch-drawn scale's labels take their tooltips from. */
|
|
19
|
+
export interface SwatchTooltipOptions {
|
|
20
|
+
/** The legend's title. */
|
|
21
|
+
title: unknown;
|
|
22
|
+
/** The datum the legend's title nodes carry. */
|
|
23
|
+
titleDatum: unknown;
|
|
24
|
+
/** The scale's `axisConfig.titleTooltip`. */
|
|
25
|
+
titleTooltip: unknown;
|
|
26
|
+
/** The scale's `axisConfig.tickTooltip`. */
|
|
27
|
+
tickTooltip: unknown;
|
|
28
|
+
/** Each swatch's legend row, with its bucket. */
|
|
29
|
+
buckets: Map<unknown, SwatchBucket>;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
Stamps swatch label nodes with their tooltip target: the bucket's tick for
|
|
33
|
+
the value, its place from the lowest for the index, and the label's whole
|
|
34
|
+
text. A label no tooltip could show for is left unstamped.
|
|
35
|
+
@param nodes The swatch labels' text nodes.
|
|
36
|
+
@param option The scale's `axisConfig.tickTooltip`.
|
|
37
|
+
@param buckets Each swatch's legend row, with its bucket.
|
|
38
|
+
*/
|
|
39
|
+
export declare function stampSwatchLabels(nodes: SceneNode[], option: unknown, buckets: Map<unknown, SwatchBucket>): void;
|
|
40
|
+
/**
|
|
41
|
+
A swatch-drawn scale's legend scene with its axis tooltips: the title is
|
|
42
|
+
chrome (see `inertAxis`) that takes the pointer only to show its tooltip,
|
|
43
|
+
a swatch label with a tooltip to show takes the pointer as axis chrome,
|
|
44
|
+
and every other node is left as the legend drew it.
|
|
45
|
+
@param scene The legend's scene.
|
|
46
|
+
@param options What the labels take their tooltips from.
|
|
47
|
+
*/
|
|
48
|
+
export declare function swatchTooltips(scene: SceneNode, options: SwatchTooltipOptions): SceneNode;
|
|
@@ -8,6 +8,7 @@ import { BaseClass } from "../../utils/index.js";
|
|
|
8
8
|
Creates an SVG legend based on an array of data.
|
|
9
9
|
*/
|
|
10
10
|
export default class Legend extends BaseClass {
|
|
11
|
+
static readonly _displayName: string;
|
|
11
12
|
[key: string]: any;
|
|
12
13
|
_titleClass: TextBox;
|
|
13
14
|
_data: DataPoint[];
|
|
@@ -22,6 +23,11 @@ export default class Legend extends BaseClass {
|
|
|
22
23
|
_titleHeight: number;
|
|
23
24
|
_titleWidth: number;
|
|
24
25
|
_wrapLines: (() => void) | undefined;
|
|
26
|
+
/**
|
|
27
|
+
Whether labels that don't fit whole are cut short with "..." rather
|
|
28
|
+
than left out, as a ColorScale's swatches are (see `legendCut.ts`).
|
|
29
|
+
*/
|
|
30
|
+
_cutLabels: boolean;
|
|
25
31
|
_wrapRows: (() => void) | undefined;
|
|
26
32
|
_sceneRenderer?: SvgRenderer;
|
|
27
33
|
/**
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type Legend from "./Legend.js";
|
|
2
|
+
/** The room each label has in one layout of the swatches. */
|
|
3
|
+
interface Room {
|
|
4
|
+
width: number;
|
|
5
|
+
height: number;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
The room each label of `legend` has with its swatches in `rows` rows of
|
|
9
|
+
as many each as fit (`rows` 1 to the count of swatches), or in one
|
|
10
|
+
column.
|
|
11
|
+
*/
|
|
12
|
+
export declare function labelRoom(legend: Legend, availableWidth: number, availableHeight: number, rows?: number): Room;
|
|
13
|
+
/**
|
|
14
|
+
The lines the TextBox of the label `d` paints in the room it was given:
|
|
15
|
+
wrapped with the line height and ellipsis of the legend's labels (a
|
|
16
|
+
TextBox's own by default), as `renderLegendShapes` draws it.
|
|
17
|
+
*/
|
|
18
|
+
export declare function paintedLines(legend: Legend, d: Record<string, unknown>): string[];
|
|
19
|
+
/**
|
|
20
|
+
Gives each label of `legend` the room it has in the layout of its
|
|
21
|
+
swatches that shows the most of its labels, its whole text when that
|
|
22
|
+
fits there and else as many lines as fit, marking it `cut`, with the
|
|
23
|
+
lines it paints there. In a row, the swatches try each count of rows
|
|
24
|
+
within the height, keeping the layout that cuts the fewest labels short,
|
|
25
|
+
then shows the most of their text, then is the shortest. In a column,
|
|
26
|
+
they keep to one column, which reads in order from top to bottom.
|
|
27
|
+
Returns false, changing nothing, when no layout can hold a line of a
|
|
28
|
+
few letters.
|
|
29
|
+
*/
|
|
30
|
+
export declare function cutLegendLabels(legend: Legend, availableWidth: number, availableHeight: number): boolean;
|
|
31
|
+
export {};
|
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
import type Legend from "./Legend.js";
|
|
2
|
-
/**
|
|
2
|
+
/**
|
|
3
|
+
Wraps + measures the title, setting `_titleHeight` / `_titleWidth`: it
|
|
4
|
+
wraps within the width the title is drawn in, the legend's less its
|
|
5
|
+
padding on both sides, and is left out (both zero) when it doesn't fit
|
|
6
|
+
there whole.
|
|
7
|
+
*/
|
|
3
8
|
export declare function measureLegendTitle(legend: Legend): void;
|
|
4
9
|
/** Measures each datum's swatch + wrapped label into the `_lineData` array. */
|
|
5
10
|
export declare function computeLegendLineData(legend: Legend, availableHeight: number): Record<string, unknown>[];
|
|
@@ -41,6 +41,7 @@ new SizeLegend()
|
|
|
41
41
|
.render();
|
|
42
42
|
*/
|
|
43
43
|
export default class SizeLegend extends BaseClass {
|
|
44
|
+
static readonly _displayName: string;
|
|
44
45
|
[key: string]: any;
|
|
45
46
|
_layout: SizeLegendLayout;
|
|
46
47
|
/** Drops values whose circles would outgrow this radius; set by a zoomed chart. */
|