@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,196 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A time scale whose domain skips hidden stretches of time (see
|
|
3
|
+
`RangeBreakRule`): weekends, nights, holidays, or explicit ranges close
|
|
4
|
+
up so the times on either side sit next to each other. A gap whose rule
|
|
5
|
+
asks for a marker keeps a short fixed stretch of pixels, where an axis
|
|
6
|
+
draws its break marker.
|
|
7
|
+
*/ import { bisectRight, quantile } from "d3-array";
|
|
8
|
+
import { scaleTime, scaleUtc } from "d3-scale";
|
|
9
|
+
import { gapIndex, offsetVisible, rangeBreakGaps, visibleBetween } from "./rangeBreaks.js";
|
|
10
|
+
/** Whether `scale` is a broken time scale. */ export const isBrokenTimeScale = (scale)=>typeof scale === "function" && "rangeBreaks" in scale;
|
|
11
|
+
/**
|
|
12
|
+
The time between `a` and `b` on `scale` (`b - a`, in ms): on a broken
|
|
13
|
+
time scale, only the time it shows.
|
|
14
|
+
*/ export const scaleTimeStep = (scale, a, b)=>isBrokenTimeScale(scale) ? scale.visible(a, b) : +b - +a;
|
|
15
|
+
/**
|
|
16
|
+
The time `ms` after `t` (before it, when negative) on `scale`: on a
|
|
17
|
+
broken time scale, stepping over the time it hides.
|
|
18
|
+
*/ export const scaleTimeShift = (scale, t, ms)=>isBrokenTimeScale(scale) ? scale.offset(t, ms) : new Date(+t + ms);
|
|
19
|
+
function layout(rules, domain, range, utc, space) {
|
|
20
|
+
const [d0, d1] = domain;
|
|
21
|
+
const lo = Math.min(d0, d1);
|
|
22
|
+
const hi = Math.max(d0, d1);
|
|
23
|
+
const [r0, r1] = range;
|
|
24
|
+
const start = d0 <= d1 ? r0 : r1;
|
|
25
|
+
const end = d0 <= d1 ? r1 : r0;
|
|
26
|
+
const dir = Math.sign(end - start) || 1;
|
|
27
|
+
const length = Math.abs(end - start);
|
|
28
|
+
const all = rangeBreakGaps(rules, lo, hi, utc);
|
|
29
|
+
const clipped = all.map((g)=>({
|
|
30
|
+
...g,
|
|
31
|
+
start: Math.max(g.start, lo),
|
|
32
|
+
end: Math.min(g.end, hi)
|
|
33
|
+
})).filter((g)=>g.end > g.start);
|
|
34
|
+
const marked = clipped.filter((g)=>g.marker && g.start > lo && g.end < hi);
|
|
35
|
+
// Marked gaps keep their space while it leaves the data twice that room.
|
|
36
|
+
const room = length - marked.length * space >= space * 2 ? space : 0;
|
|
37
|
+
const gaps = clipped.map((g)=>({
|
|
38
|
+
...g,
|
|
39
|
+
space: g.marker && g.start > lo && g.end < hi ? room : 0
|
|
40
|
+
}));
|
|
41
|
+
const hidden = gaps.reduce((s, g)=>s + g.end - g.start, 0);
|
|
42
|
+
const visibleMs = hi - lo - hidden;
|
|
43
|
+
const spaced = gaps.reduce((s, g)=>s + g.space, 0);
|
|
44
|
+
const empty = !(visibleMs > 0);
|
|
45
|
+
const rate = empty ? 0 : (length - spaced) / visibleMs;
|
|
46
|
+
const at = [];
|
|
47
|
+
let seen = lo, px = 0;
|
|
48
|
+
gaps.forEach((g)=>{
|
|
49
|
+
px += (g.start - seen) * rate;
|
|
50
|
+
at.push(px);
|
|
51
|
+
px += g.space;
|
|
52
|
+
seen = g.end;
|
|
53
|
+
});
|
|
54
|
+
return {
|
|
55
|
+
lo,
|
|
56
|
+
hi,
|
|
57
|
+
start,
|
|
58
|
+
dir,
|
|
59
|
+
length,
|
|
60
|
+
rate,
|
|
61
|
+
all,
|
|
62
|
+
gaps,
|
|
63
|
+
at,
|
|
64
|
+
empty
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
/** Pixel offset of a time from the domain's low end. */ function offsetOf(lay, rules, utc, t) {
|
|
68
|
+
const { lo, hi, length, rate, gaps, at } = lay;
|
|
69
|
+
if (t < lo) return -visibleBetween(rules, t, lo, utc) * rate;
|
|
70
|
+
if (t > hi) return length + visibleBetween(rules, hi, t, utc) * rate;
|
|
71
|
+
const i = gapIndex(gaps, t);
|
|
72
|
+
if (i < 0) return (t - lo) * rate;
|
|
73
|
+
const g = gaps[i];
|
|
74
|
+
if (t < g.end) return at[i] + g.space * (t - g.start) / (g.end - g.start);
|
|
75
|
+
return at[i] + g.space + (t - g.end) * rate;
|
|
76
|
+
}
|
|
77
|
+
/** The time at a pixel; a closed gap's pixel reads as the time after it. */ function invertAt(lay, rules, utc, px) {
|
|
78
|
+
const { lo, hi, start, dir, rate, gaps, at, empty } = lay;
|
|
79
|
+
if (empty || !rate) return new Date(lo);
|
|
80
|
+
const o = (px - start) * dir;
|
|
81
|
+
if (o < 0) return new Date(offsetVisible(rules, lo, o / rate, utc));
|
|
82
|
+
const i = bisectRight(at, o) - 1;
|
|
83
|
+
let t;
|
|
84
|
+
if (i < 0) t = lo + o / rate;
|
|
85
|
+
else {
|
|
86
|
+
const g = gaps[i];
|
|
87
|
+
const into = o - at[i];
|
|
88
|
+
t = into < g.space ? g.start + into / g.space * (g.end - g.start) : g.end + (into - g.space) / rate;
|
|
89
|
+
}
|
|
90
|
+
// Past the last gap, time beyond `hi` steps over the rules' gaps.
|
|
91
|
+
return new Date(t > hi ? offsetVisible(rules, hi, t - hi, utc) : t);
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
About `count` tick times (ms, ascending) for a laid-out domain, none of
|
|
95
|
+
them hidden: d3's time ticks, asked for more as more time is hidden,
|
|
96
|
+
with each tick inside a gap moved to the gap's end.
|
|
97
|
+
*/ function layoutTicks(lay, count, time, scale) {
|
|
98
|
+
const { lo, hi, all, gaps, empty } = lay;
|
|
99
|
+
// A single shown time ticks itself, as d3's time scale does.
|
|
100
|
+
if (empty) return lo === hi && !scale.isHidden(lo) ? [
|
|
101
|
+
lo
|
|
102
|
+
] : [];
|
|
103
|
+
const visibleMs = hi - lo - gaps.reduce((s, g)=>s + g.end - g.start, 0);
|
|
104
|
+
const asked = Math.max(1, Math.round(count * (hi - lo) / visibleMs));
|
|
105
|
+
const base = time.ticks(asked).map(Number);
|
|
106
|
+
const ticks = new Map();
|
|
107
|
+
for (const tick of base){
|
|
108
|
+
const i = gapIndex(all, tick);
|
|
109
|
+
const moved = i >= 0 && tick < all[i].end;
|
|
110
|
+
const t = moved ? all[i].end : tick;
|
|
111
|
+
if (t <= hi) ticks.set(t, moved || ticks.get(t) === true);
|
|
112
|
+
}
|
|
113
|
+
// A moved tick opens a stretch of shown time (a day after a night, a
|
|
114
|
+
// week after a weekend), so a plain tick within half a step of it gives
|
|
115
|
+
// way.
|
|
116
|
+
const steps = base.slice(1).map((t, k)=>t - base[k]);
|
|
117
|
+
const half = steps.length ? quantile(steps, 0.5) / 2 : 0;
|
|
118
|
+
const moved = [
|
|
119
|
+
...ticks
|
|
120
|
+
].filter(([, m])=>m).map(([t])=>t);
|
|
121
|
+
return [
|
|
122
|
+
...ticks
|
|
123
|
+
].filter(([t, m])=>m || !moved.some((o)=>Math.abs(scale.visible(o, t)) <= half)).map(([t])=>t).sort((a, b)=>a - b);
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
Builds a time scale that hides the time `rules` describe. It reads like
|
|
127
|
+
d3's `scaleTime` — `domain`, `range`, `ticks`, `tickFormat`, `invert`,
|
|
128
|
+
and `copy` — but visible time shares one pixel rate and hidden time
|
|
129
|
+
takes none (or a marked gap's `space`). A hidden time maps to where its
|
|
130
|
+
gap sits; a pixel at a closed gap inverts to the time after it. Times
|
|
131
|
+
past the domain extrapolate through the rules' gaps, so a scale can be
|
|
132
|
+
padded or zoomed out.
|
|
133
|
+
*/ export function brokenTimeScale(rules, options = {}) {
|
|
134
|
+
const utc = Boolean(options.utc);
|
|
135
|
+
const space = Math.max(0, options.space ?? 0);
|
|
136
|
+
let domain = [
|
|
137
|
+
+new Date(2000, 0, 1),
|
|
138
|
+
+new Date(2000, 0, 2)
|
|
139
|
+
];
|
|
140
|
+
let range = [
|
|
141
|
+
0,
|
|
142
|
+
1
|
|
143
|
+
];
|
|
144
|
+
let lay = layout(rules, domain, range, utc, space);
|
|
145
|
+
const rebuild = ()=>{
|
|
146
|
+
lay = layout(rules, domain, range, utc, space);
|
|
147
|
+
};
|
|
148
|
+
const scale = (value)=>{
|
|
149
|
+
const t = +value;
|
|
150
|
+
if (!Number.isFinite(t)) return NaN;
|
|
151
|
+
const { start, dir, empty } = lay;
|
|
152
|
+
if (empty) return (range[0] + range[1]) / 2;
|
|
153
|
+
return start + dir * offsetOf(lay, rules, utc, t);
|
|
154
|
+
};
|
|
155
|
+
scale.rangeBreaks = rules;
|
|
156
|
+
scale.domain = (d)=>{
|
|
157
|
+
if (d === undefined) return domain.map((t)=>new Date(t));
|
|
158
|
+
domain = Array.from(d, (v)=>+v).slice(0, 2);
|
|
159
|
+
rebuild();
|
|
160
|
+
return scale;
|
|
161
|
+
};
|
|
162
|
+
scale.range = (r)=>{
|
|
163
|
+
if (r === undefined) return range.slice();
|
|
164
|
+
range = Array.from(r, Number).slice(0, 2);
|
|
165
|
+
rebuild();
|
|
166
|
+
return scale;
|
|
167
|
+
};
|
|
168
|
+
scale.copy = ()=>brokenTimeScale(rules, options).domain(domain).range(range);
|
|
169
|
+
scale.invert = (px)=>invertAt(lay, rules, utc, px);
|
|
170
|
+
scale.gaps = ()=>lay.gaps.map((g)=>({
|
|
171
|
+
...g
|
|
172
|
+
}));
|
|
173
|
+
scale.isHidden = (value)=>{
|
|
174
|
+
const t = +value;
|
|
175
|
+
const { lo, hi, all } = lay;
|
|
176
|
+
if (t < lo || t > hi) return rangeBreakGaps(rules, t, t, utc).some((g)=>g.start <= t && t < g.end);
|
|
177
|
+
const i = gapIndex(all, t);
|
|
178
|
+
return i >= 0 && t < all[i].end;
|
|
179
|
+
};
|
|
180
|
+
scale.visible = (a, b)=>{
|
|
181
|
+
const x = +a, y = +b;
|
|
182
|
+
return x <= y ? visibleBetween(rules, x, y, utc) : -visibleBetween(rules, y, x, utc);
|
|
183
|
+
};
|
|
184
|
+
scale.offset = (t, ms)=>new Date(offsetVisible(rules, +t, ms, utc));
|
|
185
|
+
const timeScale = ()=>(utc ? scaleUtc : scaleTime)().domain([
|
|
186
|
+
lay.lo,
|
|
187
|
+
lay.hi
|
|
188
|
+
]);
|
|
189
|
+
scale.ticks = (count = 10)=>{
|
|
190
|
+
const out = layoutTicks(lay, count, timeScale(), scale).map((t)=>new Date(t));
|
|
191
|
+
if (domain[0] > domain[1]) out.reverse();
|
|
192
|
+
return out;
|
|
193
|
+
};
|
|
194
|
+
scale.tickFormat = (count, specifier)=>timeScale().tickFormat(count, specifier);
|
|
195
|
+
return scale;
|
|
196
|
+
}
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Range break rules for time axes: the calendar stretches (weekends,
|
|
3
|
+
daily hours, whole days, explicit ranges) a time axis hides so its data
|
|
4
|
+
closes up around them. Rules read calendar time in the local time zone,
|
|
5
|
+
as d3's `scaleTime` and d3plus's date labels do, or in UTC when asked.
|
|
6
|
+
*/ import { timeDay, utcDay } from "d3-time";
|
|
7
|
+
import { date } from "@d3plus/dom";
|
|
8
|
+
const DAY = 864e5;
|
|
9
|
+
/** A rule value read as a timestamp, or `NaN` when it doesn't parse. */ export function rangeBreakTime(value) {
|
|
10
|
+
if (value instanceof Date) return +value;
|
|
11
|
+
if (typeof value !== "number" && typeof value !== "string") return NaN;
|
|
12
|
+
const parsed = date(value);
|
|
13
|
+
return parsed instanceof Date ? +parsed : NaN;
|
|
14
|
+
}
|
|
15
|
+
const isRecord = (v)=>typeof v === "object" && v !== null && !Array.isArray(v);
|
|
16
|
+
const validHours = (h)=>Array.isArray(h) && h.length === 2 && h.every((n)=>typeof n === "number" && n >= 0 && n <= 24);
|
|
17
|
+
/** Whether `rule` is a rule a time axis can read. */ export function isRangeBreakRule(rule) {
|
|
18
|
+
if (rule === "weekends") return true;
|
|
19
|
+
if (!isRecord(rule)) return false;
|
|
20
|
+
if ("days" in rule) return Array.isArray(rule.days) && rule.days.every((d)=>Number.isInteger(d) && d >= 0 && d <= 6);
|
|
21
|
+
if ("hours" in rule) return validHours(rule.hours);
|
|
22
|
+
if ("values" in rule) return Array.isArray(rule.values);
|
|
23
|
+
if ("bounds" in rule) return Array.isArray(rule.bounds) && rule.bounds.length === 2 && rule.bounds.every((b)=>Number.isFinite(rangeBreakTime(b)));
|
|
24
|
+
return false;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
Reads a `rangeBreaks` setting — one rule, a list of them, or a falsy
|
|
28
|
+
value — into the list of rules a time axis can use, dropping any it
|
|
29
|
+
can't read.
|
|
30
|
+
*/ export function normalizeRangeBreaks(input) {
|
|
31
|
+
if (!input) return [];
|
|
32
|
+
const list = Array.isArray(input) ? input : [
|
|
33
|
+
input
|
|
34
|
+
];
|
|
35
|
+
return list.filter(isRangeBreakRule);
|
|
36
|
+
}
|
|
37
|
+
/** Whether a rule draws a break marker (see `RangeBreakRule`). */ export const ruleMarker = (rule)=>typeof rule === "object" && typeof rule.marker === "boolean" ? rule.marker : typeof rule === "object" && "bounds" in rule;
|
|
38
|
+
/** The calendar days that touch `[lo, hi]`, each as its start and end. */ function eachDay(lo, hi, utc, fn) {
|
|
39
|
+
const interval = utc ? utcDay : timeDay;
|
|
40
|
+
let day = interval.floor(new Date(lo));
|
|
41
|
+
while(+day <= hi){
|
|
42
|
+
const next = interval.offset(day, 1);
|
|
43
|
+
fn(day, next);
|
|
44
|
+
day = next;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
/** A time `hours` into `day`, read on the wall clock (so DST shifts it). */ function atHour(day, hours, utc) {
|
|
48
|
+
const out = new Date(+day);
|
|
49
|
+
const h = Math.floor(hours);
|
|
50
|
+
const m = Math.round((hours - h) * 60);
|
|
51
|
+
if (utc) out.setUTCHours(h, m, 0, 0);
|
|
52
|
+
else out.setHours(h, m, 0, 0);
|
|
53
|
+
return +out;
|
|
54
|
+
}
|
|
55
|
+
/** The gaps one rule hides that overlap `[lo, hi]`, unsorted and unmerged. */ function ruleGaps(rule, lo, hi, utc) {
|
|
56
|
+
const out = [];
|
|
57
|
+
if (rule === "weekends" || "days" in rule) {
|
|
58
|
+
const days = new Set(rule === "weekends" ? [
|
|
59
|
+
0,
|
|
60
|
+
6
|
|
61
|
+
] : rule.days);
|
|
62
|
+
eachDay(lo, hi, utc, (start, end)=>{
|
|
63
|
+
if (days.has(utc ? start.getUTCDay() : start.getDay())) out.push([
|
|
64
|
+
+start,
|
|
65
|
+
+end
|
|
66
|
+
]);
|
|
67
|
+
});
|
|
68
|
+
} else if ("hours" in rule) {
|
|
69
|
+
const [from, to] = rule.hours;
|
|
70
|
+
if (from === to) return out;
|
|
71
|
+
// A wrapping window reaches into the day before `lo`.
|
|
72
|
+
eachDay(lo - DAY, hi, utc, (start, end)=>{
|
|
73
|
+
const a = atHour(start, from, utc);
|
|
74
|
+
const b = from < to ? atHour(start, to, utc) : atHour(end, to, utc);
|
|
75
|
+
if (b > a) out.push([
|
|
76
|
+
a,
|
|
77
|
+
b
|
|
78
|
+
]);
|
|
79
|
+
});
|
|
80
|
+
} else if ("values" in rule) {
|
|
81
|
+
const interval = utc ? utcDay : timeDay;
|
|
82
|
+
rule.values.forEach((v)=>{
|
|
83
|
+
const t = rangeBreakTime(v);
|
|
84
|
+
if (!Number.isFinite(t)) return;
|
|
85
|
+
const day = interval.floor(new Date(t));
|
|
86
|
+
out.push([
|
|
87
|
+
+day,
|
|
88
|
+
+interval.offset(day, 1)
|
|
89
|
+
]);
|
|
90
|
+
});
|
|
91
|
+
} else {
|
|
92
|
+
const [a, b] = rule.bounds.map(rangeBreakTime);
|
|
93
|
+
if (a !== b) out.push(a < b ? [
|
|
94
|
+
a,
|
|
95
|
+
b
|
|
96
|
+
] : [
|
|
97
|
+
b,
|
|
98
|
+
a
|
|
99
|
+
]);
|
|
100
|
+
}
|
|
101
|
+
return out;
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
The stretches of time `rules` hide that overlap `[lo, hi]`: sorted,
|
|
105
|
+
with overlapping and touching gaps merged (a merged gap draws a marker
|
|
106
|
+
when any of its rules does). Gaps are not clipped to `[lo, hi]`.
|
|
107
|
+
@param utc Read the calendar in UTC instead of local time.
|
|
108
|
+
*/ export function rangeBreakGaps(rules, lo, hi, utc = false) {
|
|
109
|
+
if (!(lo <= hi)) return [];
|
|
110
|
+
const all = rules.flatMap((rule)=>ruleGaps(rule, lo, hi, utc).map(([start, end])=>({
|
|
111
|
+
start,
|
|
112
|
+
end,
|
|
113
|
+
marker: ruleMarker(rule)
|
|
114
|
+
}))).filter((g)=>g.end > lo && g.start <= hi).sort((a, b)=>a.start - b.start);
|
|
115
|
+
const merged = [];
|
|
116
|
+
for (const g of all){
|
|
117
|
+
const last = merged[merged.length - 1];
|
|
118
|
+
if (last && g.start <= last.end) {
|
|
119
|
+
last.end = Math.max(last.end, g.end);
|
|
120
|
+
last.marker = last.marker || g.marker;
|
|
121
|
+
} else merged.push({
|
|
122
|
+
...g
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
return merged;
|
|
126
|
+
}
|
|
127
|
+
/** The last gap starting at or before `t` (gaps sorted by start), or -1. */ export function gapIndex(gaps, t) {
|
|
128
|
+
let lo = 0, hi = gaps.length - 1, found = -1;
|
|
129
|
+
while(lo <= hi){
|
|
130
|
+
const mid = lo + hi >> 1;
|
|
131
|
+
if (gaps[mid].start <= t) {
|
|
132
|
+
found = mid;
|
|
133
|
+
lo = mid + 1;
|
|
134
|
+
} else hi = mid - 1;
|
|
135
|
+
}
|
|
136
|
+
return found;
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
A test for whether a time between `lo` and `hi` is hidden by `rules`:
|
|
140
|
+
the gaps are found once, so the test is cheap to run over many values.
|
|
141
|
+
A time outside `[lo, hi]` is tested on its own.
|
|
142
|
+
*/ export function rangeBreakTest(rules, lo, hi, utc = false) {
|
|
143
|
+
const gaps = rangeBreakGaps(rules, lo, hi, utc);
|
|
144
|
+
return (value)=>{
|
|
145
|
+
const t = +value;
|
|
146
|
+
if (!Number.isFinite(t)) return false;
|
|
147
|
+
if (t < lo || t > hi) return isHiddenTime(rules, t, utc);
|
|
148
|
+
const i = gapIndex(gaps, t);
|
|
149
|
+
return i >= 0 && t < gaps[i].end;
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
/** Whether `rules` hide the time `t`. */ export function isHiddenTime(rules, t, utc = false) {
|
|
153
|
+
const n = +t;
|
|
154
|
+
return rangeBreakGaps(rules, n, n, utc).some((g)=>g.start <= n && n < g.end);
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
The visible time between `a` and `b` (in ms, `a <= b`): their distance
|
|
158
|
+
less every hidden stretch between them.
|
|
159
|
+
*/ export function visibleBetween(rules, a, b, utc = false) {
|
|
160
|
+
if (!(a < b)) return 0;
|
|
161
|
+
const hidden = rangeBreakGaps(rules, a, b, utc).reduce((s, g)=>s + Math.max(0, Math.min(b, g.end) - Math.max(a, g.start)), 0);
|
|
162
|
+
return b - a - hidden;
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
Whether `rules` hide all of time: a week (plus a day for DST) with no
|
|
166
|
+
visible moment, which repeating rules then repeat forever.
|
|
167
|
+
*/ export function hidesAllTime(rules, utc = false) {
|
|
168
|
+
const t = Date.UTC(2001, 0, 1);
|
|
169
|
+
return visibleBetween(rules, t, t + 8 * DAY, utc) <= 0;
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
The time `ms` of visible time after `t` (or before it, when `ms` is
|
|
173
|
+
negative), stepping over every hidden stretch on the way. Rules that
|
|
174
|
+
hide all of time leave `t` where it is.
|
|
175
|
+
*/ export function offsetVisible(rules, t, ms, utc = false) {
|
|
176
|
+
if (!ms || !Number.isFinite(ms) || hidesAllTime(rules, utc)) return t;
|
|
177
|
+
const forward = ms > 0;
|
|
178
|
+
let remaining = Math.abs(ms);
|
|
179
|
+
let cur = t;
|
|
180
|
+
let window = Math.max(remaining * 2, 7 * DAY);
|
|
181
|
+
for(let pass = 0; pass < 32; pass++){
|
|
182
|
+
const lo = forward ? cur : cur - window;
|
|
183
|
+
const hi = forward ? cur + window : cur;
|
|
184
|
+
const gaps = rangeBreakGaps(rules, lo, hi, utc);
|
|
185
|
+
for (const g of forward ? gaps : gaps.reverse()){
|
|
186
|
+
const free = forward ? g.start - cur : cur - g.end;
|
|
187
|
+
// A step that ends where a gap starts lands on the gap's far side.
|
|
188
|
+
if (free > 0 && (forward ? remaining < free : remaining <= free)) return forward ? cur + remaining : cur - remaining;
|
|
189
|
+
if (free > 0) remaining -= free;
|
|
190
|
+
if (forward ? g.end > cur : g.start < cur) cur = forward ? g.end : g.start;
|
|
191
|
+
}
|
|
192
|
+
const free = forward ? hi - cur : cur - lo;
|
|
193
|
+
if (free > 0 && remaining <= free) return forward ? cur + remaining : cur - remaining;
|
|
194
|
+
if (free > 0) {
|
|
195
|
+
remaining -= free;
|
|
196
|
+
cur = forward ? hi : lo;
|
|
197
|
+
}
|
|
198
|
+
window *= 2;
|
|
199
|
+
}
|
|
200
|
+
return cur;
|
|
201
|
+
}
|
|
@@ -3,6 +3,7 @@ import { timeFormatLocale } from "d3-time-format";
|
|
|
3
3
|
import { date } from "@d3plus/dom";
|
|
4
4
|
import { dateFullFormatter, formatDateFull } from "@d3plus/format";
|
|
5
5
|
import { locale } from "@d3plus/locales";
|
|
6
|
+
import { normalizeRangeBreaks, rangeBreakTest } from "./rangeBreaks.js";
|
|
6
7
|
/**
|
|
7
8
|
Parses a value (Date, timestamp, or date string) into a valid Date, or `undefined` when it does not parse.
|
|
8
9
|
@private
|
|
@@ -22,12 +23,19 @@ import { locale } from "@d3plus/locales";
|
|
|
22
23
|
@private
|
|
23
24
|
*/ export function axisScaleData(axis) {
|
|
24
25
|
if (axis.schema.scale !== "time") return axis._data ?? [];
|
|
25
|
-
const data = parseTimeValues(axis._data ?? []);
|
|
26
|
+
const data = visibleDates(axis, parseTimeValues(axis._data ?? []));
|
|
26
27
|
const domain = (axis.schema.domain ?? []).map(parseTime);
|
|
27
28
|
if (domain.length < 2 || domain.some((d)=>d === undefined)) return data;
|
|
28
29
|
const [lo, hi] = extent(domain);
|
|
29
30
|
return data.filter((d)=>d >= lo && d <= hi);
|
|
30
31
|
}
|
|
32
|
+
/** Dates a time axis's `rangeBreaks` leave shown. */ function visibleDates(axis, dates) {
|
|
33
|
+
const rules = normalizeRangeBreaks(axis.schema.rangeBreaks);
|
|
34
|
+
if (!rules.length || !dates.length) return dates;
|
|
35
|
+
const [lo, hi] = extent(dates, Number);
|
|
36
|
+
const hidden = rangeBreakTest(rules, lo, hi);
|
|
37
|
+
return dates.filter((d)=>!hidden(d));
|
|
38
|
+
}
|
|
31
39
|
/**
|
|
32
40
|
The dates of a time axis's `data` inside its scale's domain: what the axis ticks, so a domain narrower than the data (a zoomed view) ticks the window it shows.
|
|
33
41
|
@private
|
|
@@ -51,14 +59,21 @@ import { locale } from "@d3plus/locales";
|
|
|
51
59
|
return axis.schema.timeLocale || locale[axis.schema.locale] || locale["en-US"];
|
|
52
60
|
}
|
|
53
61
|
/**
|
|
54
|
-
The ordered Dates a time axis picks its label interval from: its parsed `data`, else its domain.
|
|
62
|
+
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.
|
|
55
63
|
@private
|
|
56
64
|
*/ export function axisTimeReference(axis) {
|
|
57
65
|
const { _scaleData: data, schema: { domain } } = axis;
|
|
66
|
+
const scale = axis._d3Scale;
|
|
67
|
+
const range = scale?.range ? scale.range() : [];
|
|
58
68
|
return axisMemo(axis, "timeReference", [
|
|
59
69
|
data,
|
|
60
|
-
domain
|
|
61
|
-
|
|
70
|
+
domain,
|
|
71
|
+
scale,
|
|
72
|
+
...range
|
|
73
|
+
], ()=>{
|
|
74
|
+
const offered = !data.length && scale ? axis._getLabels() : [];
|
|
75
|
+
return parseTimeValues(data.length ? data : offered.length > 1 ? offered : domain).sort((a, b)=>+a - +b);
|
|
76
|
+
});
|
|
62
77
|
}
|
|
63
78
|
/**
|
|
64
79
|
A date labeled to be read on its own (e.g. in a tooltip): the label interval the axis uses for its ticks (see `axisDateReference`), always with the year, in the axis's time locale.
|
|
@@ -1,26 +1,50 @@
|
|
|
1
1
|
import { max } from "d3-array";
|
|
2
2
|
import { select } from "d3-selection";
|
|
3
3
|
import { transition } from "d3-transition";
|
|
4
|
-
import {
|
|
5
|
-
import { backgroundColor, elem } from "@d3plus/dom";
|
|
4
|
+
import { elem } from "@d3plus/dom";
|
|
6
5
|
import { formatAbbreviate } from "@d3plus/format";
|
|
7
6
|
import { Axis, TextBox } from "../index.js";
|
|
8
7
|
import { Rect } from "../../shapes/index.js";
|
|
9
8
|
import { accessor, BaseClass, paintComponentScene } from "../../utils/index.js";
|
|
10
9
|
import { installFluent, mergeConfigBag, resolvesReset } from "../../fluent.js";
|
|
10
|
+
import { inkText } from "../../utils/themeInk.js";
|
|
11
11
|
import Legend from "../Legend/Legend.js";
|
|
12
|
+
import { inertAxis } from "../Axis/axisTooltipTargets.js";
|
|
12
13
|
import { formatYear, isYearLike } from "../Axis/yearValues.js";
|
|
13
|
-
import { bucketBounds } from "./bucketBounds.js";
|
|
14
|
+
import { bucketBounds, labelValue } from "./bucketBounds.js";
|
|
14
15
|
import { computeColorScale } from "./colorScaleScale.js";
|
|
15
16
|
import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
16
17
|
import { isBucketScale } from "./colorScaleType.js";
|
|
17
18
|
import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
19
|
+
import { swatchTooltips } from "./colorScaleSwatchTooltips.js";
|
|
20
|
+
import { renderBivariate } from "./bivariateRender.js";
|
|
18
21
|
/** ColorScale's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const colorScaleSchema = [
|
|
19
22
|
{
|
|
20
23
|
key: "align",
|
|
21
24
|
coerce: "identity",
|
|
22
25
|
default: "middle"
|
|
23
26
|
},
|
|
27
|
+
// A bivariate scale reads a pair of values from each row and draws its
|
|
28
|
+
// grid of colors as a diamond key (see bivariateRender.ts).
|
|
29
|
+
{
|
|
30
|
+
key: "bivariate",
|
|
31
|
+
coerce: "identity",
|
|
32
|
+
default: false
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
key: "bivariateBuckets",
|
|
36
|
+
coerce: "identity",
|
|
37
|
+
default: 3
|
|
38
|
+
},
|
|
39
|
+
// No default grid: an unset one paints Stevens' blue–red scheme.
|
|
40
|
+
{
|
|
41
|
+
key: "bivariateColors",
|
|
42
|
+
coerce: "identity"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
key: "bivariateLabels",
|
|
46
|
+
coerce: "identity"
|
|
47
|
+
},
|
|
24
48
|
{
|
|
25
49
|
key: "buckets",
|
|
26
50
|
coerce: "identity",
|
|
@@ -54,7 +78,8 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
54
78
|
},
|
|
55
79
|
// Unset poles fall back to `colorDefaults` at draw time: `sequential` (blue)
|
|
56
80
|
// high, `light` midpoint, `off` (red) low — warm/cool poles that stay
|
|
57
|
-
// distinct under color-vision deficiency.
|
|
81
|
+
// distinct under color-vision deficiency. A dark or custom theme supplies
|
|
82
|
+
// its `colorScale` tokens instead.
|
|
58
83
|
{
|
|
59
84
|
key: "colorMax",
|
|
60
85
|
coerce: "identity"
|
|
@@ -96,6 +121,13 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
96
121
|
coerce: "identity",
|
|
97
122
|
default: 0
|
|
98
123
|
},
|
|
124
|
+
// Holds a single-hue light-theme ramp's palest step darker (colorRamp's
|
|
125
|
+
// `ordinal` option), so the lowest values still read as thin lines.
|
|
126
|
+
{
|
|
127
|
+
key: "ordinalRamp",
|
|
128
|
+
coerce: "identity",
|
|
129
|
+
default: false
|
|
130
|
+
},
|
|
99
131
|
{
|
|
100
132
|
key: "orient",
|
|
101
133
|
coerce: "identity",
|
|
@@ -135,6 +167,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
135
167
|
/**
|
|
136
168
|
Creates an SVG color scale based on an array of data.
|
|
137
169
|
*/ export default class ColorScale extends BaseClass {
|
|
170
|
+
static _displayName = "ColorScale";
|
|
138
171
|
_select;
|
|
139
172
|
_axisClass;
|
|
140
173
|
_axisTest;
|
|
@@ -149,7 +182,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
149
182
|
_rectClass;
|
|
150
183
|
/** The scale the last render built, with a `scale` function resolved. */ _scaleType = "linear";
|
|
151
184
|
/** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */ _barGeometry;
|
|
152
|
-
/** The value marked on the scale, set with `hover()
|
|
185
|
+
/** The value marked on the scale, set with `hover()`: a pair of values on a bivariate scale. */ _hoverValue;
|
|
186
|
+
/** The names a chart gives a bivariate scale's two variables (its field names), under `bivariateLabels`. */ _bivariateFields;
|
|
187
|
+
/** The bivariate key's nodes, laid out by the last render. */ _bivariateNodes;
|
|
188
|
+
/** Each swatch's legend row, with its bucket, set when the swatch variant renders. */ _swatchBuckets = new Map();
|
|
153
189
|
/** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */ _gradientFill;
|
|
154
190
|
// Standalone scene renderer (used when rendered on its own, not inside a
|
|
155
191
|
// Viz). Reused across re-renders by paintComponentScene().
|
|
@@ -170,7 +206,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
170
206
|
const last = i === ticks.length - 1;
|
|
171
207
|
if (tick === ticks[i + 1] || last) {
|
|
172
208
|
const suffix = last && tick < max(allValues) ? "+" : "";
|
|
173
|
-
return `${format(tick)}${suffix}`;
|
|
209
|
+
return `${format(labelValue(tick, allValues))}${suffix}`;
|
|
174
210
|
}
|
|
175
211
|
const [lower, upper] = bucketBounds(tick, i, ticks, allValues, format);
|
|
176
212
|
return this.schema.bucketJoiner(format(lower), format(upper));
|
|
@@ -178,13 +214,12 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
178
214
|
this._data = [];
|
|
179
215
|
this._labelClass = new TextBox();
|
|
180
216
|
this.schema.labelConfig = {
|
|
181
|
-
fontColor: ()=>
|
|
182
|
-
const bg = this._select ? backgroundColor(this._select.node()) : "rgb(255, 255, 255)";
|
|
183
|
-
return colorContrast(bg, this.schema.colorDefaults);
|
|
184
|
-
},
|
|
217
|
+
fontColor: ()=>inkText(this),
|
|
185
218
|
fontSize: 12
|
|
186
219
|
};
|
|
187
220
|
this._legendClass = new Legend();
|
|
221
|
+
// Swatch labels that don't fit whole are cut short, not left out.
|
|
222
|
+
this._legendClass._cutLabels = true;
|
|
188
223
|
this.schema.legendConfig = {
|
|
189
224
|
shapeConfig: {
|
|
190
225
|
stroke: ()=>this.schema.colorDefaults.dark,
|
|
@@ -216,8 +251,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
216
251
|
this._group = elem("g.d3plus-ColorScale", {
|
|
217
252
|
parent: this._select
|
|
218
253
|
});
|
|
219
|
-
const
|
|
220
|
-
|
|
254
|
+
const bivariate = Boolean(this.schema.bivariate);
|
|
255
|
+
this._bivariateNodes = bivariate ? renderBivariate(this).nodes : undefined;
|
|
256
|
+
const compute = bivariate ? undefined : computeColorScale(this);
|
|
257
|
+
const gradient = !bivariate && (this.schema.bucketAxis || !isBucketScale(compute.scale));
|
|
221
258
|
const t = transition().duration(this.schema.duration);
|
|
222
259
|
const groupParams = {
|
|
223
260
|
enter: {
|
|
@@ -239,7 +276,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
239
276
|
condition: gradient
|
|
240
277
|
}, groupParams));
|
|
241
278
|
const legendGroup = elem("g.d3plus-ColorScale-legend", Object.assign({
|
|
242
|
-
condition: !gradient
|
|
279
|
+
condition: !gradient && !bivariate
|
|
243
280
|
}, groupParams));
|
|
244
281
|
const groups = {
|
|
245
282
|
labelGroup,
|
|
@@ -248,8 +285,10 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
248
285
|
groupParams,
|
|
249
286
|
gradient
|
|
250
287
|
};
|
|
251
|
-
if (
|
|
252
|
-
|
|
288
|
+
if (compute) {
|
|
289
|
+
if (gradient) renderGradient(this, compute, groups);
|
|
290
|
+
else renderLegendVariant(this, compute, groups);
|
|
291
|
+
}
|
|
253
292
|
// Standalone render: paint the scene into the user's `_select`. Inside a
|
|
254
293
|
// Viz the color scale runs in compute mode and the Viz composes its
|
|
255
294
|
// toScene().
|
|
@@ -260,10 +299,13 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
260
299
|
/**
|
|
261
300
|
Produces a backend-agnostic scene graph for this ColorScale with no DOM
|
|
262
301
|
dependency. The discrete variant (jenks/buckets/quantile) delegates to the
|
|
263
|
-
internal Legend's toScene()
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
302
|
+
internal Legend's toScene(), its title and swatch labels taking the axis
|
|
303
|
+
tooltips (see `swatchTooltips`); the gradient variant composes the Rect,
|
|
304
|
+
Axis, and label TextBox scenes, all as chrome (see `inertAxis`): only an
|
|
305
|
+
axis label with a tooltip takes the pointer. The scaleGroup's
|
|
306
|
+
translate (set by the chart's colorScale feature on
|
|
307
|
+
`g.d3plus-viz-colorScale`) is read off `_select` so the content lands at
|
|
308
|
+
its on-screen position.
|
|
267
309
|
|
|
268
310
|
A smooth (non-bucketed) gradient paints its Rect with a `gradient:<json>`
|
|
269
311
|
fill token (see renderGradientStops); the backend materializes it into a
|
|
@@ -272,18 +314,26 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
272
314
|
*/ toScene() {
|
|
273
315
|
const children = [];
|
|
274
316
|
const gradient = this.schema.bucketAxis || !isBucketScale(this._scaleType);
|
|
275
|
-
const pushScene = (cls)=>{
|
|
317
|
+
const pushScene = (cls, finish = (scene)=>scene)=>{
|
|
276
318
|
if (cls && typeof cls.toScene === "function") {
|
|
277
319
|
const s = cls.toScene();
|
|
278
|
-
if (s) children.push(s);
|
|
320
|
+
if (s) children.push(finish(s));
|
|
279
321
|
}
|
|
280
322
|
};
|
|
281
|
-
if (
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
pushScene(this.
|
|
323
|
+
if (this._bivariateNodes) {
|
|
324
|
+
children.push(...this._bivariateNodes);
|
|
325
|
+
} else if (gradient) {
|
|
326
|
+
pushScene(this._rectClass, inertAxis);
|
|
327
|
+
pushScene(this._axisClass, inertAxis);
|
|
328
|
+
pushScene(this._labelClass, inertAxis);
|
|
285
329
|
} else {
|
|
286
|
-
pushScene(this._legendClass)
|
|
330
|
+
pushScene(this._legendClass, (scene)=>swatchTooltips(scene, {
|
|
331
|
+
title: this._legendClass.schema.title,
|
|
332
|
+
titleDatum: this._legendClass._titleClass.data()[0],
|
|
333
|
+
titleTooltip: this.schema.axisConfig.titleTooltip,
|
|
334
|
+
tickTooltip: this.schema.axisConfig.tickTooltip,
|
|
335
|
+
buckets: this._swatchBuckets
|
|
336
|
+
}));
|
|
287
337
|
}
|
|
288
338
|
// Preserve the placement of the scaleGroup the chart's colorScale feature
|
|
289
339
|
// positioned (translate on `g.d3plus-viz-colorScale`).
|
|
@@ -307,7 +357,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
307
357
|
} : {},
|
|
308
358
|
children
|
|
309
359
|
};
|
|
310
|
-
addHoverMark(this, group);
|
|
360
|
+
if (!this._bivariateNodes) addHoverMark(this, group);
|
|
311
361
|
return group;
|
|
312
362
|
}
|
|
313
363
|
axisConfig(_) {
|