@d3plus/core 4.10.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +167 -8
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +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 +3 -2
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +2 -1
- 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 +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +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 +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +32 -15
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +86 -106
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +5 -1
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +64 -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/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 +8 -2
- 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 +18 -10
- 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/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 +34 -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/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 +2 -2
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -35
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +2 -3
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +16 -9
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +3 -7
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +61 -28
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +72 -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 +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/index.js +2 -5
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/definition/makeChart.js +10 -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 +6 -5
- 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/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +8 -1
- package/es/src/charts/events/mousemove.shape.js +5 -2
- 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 +2 -1
- package/es/src/charts/features/axesFinal.js +3 -1
- package/es/src/charts/features/axesMeasure.js +7 -4
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +2 -1
- package/es/src/charts/features/colorScaleHover.js +3 -2
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +32 -14
- package/es/src/charts/features/featuresColorScale.js +20 -6
- package/es/src/charts/features/featuresLegend.js +15 -24
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +38 -11
- 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 +47 -31
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +2 -2
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +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/config.js +2 -3
- package/es/src/charts/viz/Viz.js +39 -36
- package/es/src/charts/viz/VizBase.js +18 -10
- package/es/src/charts/viz/backgroundInk.js +13 -7
- 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/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/vizDataPolling.js +8 -3
- package/es/src/charts/viz/vizDefaults.js +15 -23
- package/es/src/charts/viz/vizFields.js +35 -0
- package/es/src/charts/viz/vizRender.js +43 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +6 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +5 -9
- package/es/src/components/Axis/axisLayoutScale.js +7 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -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 +15 -9
- package/es/src/components/ColorScale/bucketBounds.js +32 -3
- package/es/src/components/ColorScale/colorScaleHoverMark.js +3 -3
- package/es/src/components/ColorScale/colorScaleScale.js +28 -15
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +29 -65
- 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 +7 -3
- 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 +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +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 +25 -12
- package/es/src/utils/configPrep.js +2 -1
- 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 +250 -8
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/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 +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/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 +15 -8
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +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/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 +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/definition/ChartDefinition.d.ts +13 -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/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/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +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 +14 -0
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +7 -0
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +16 -2
- package/types/src/charts/viz/VizBase.d.ts +6 -6
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- 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/vizDefaults.d.ts +0 -9
- package/types/src/charts/viz/vizFields.d.ts +32 -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 +84 -7
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +1 -0
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -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 +1 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +15 -1
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/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/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/utils/BaseClass.d.ts +9 -0
- package/types/src/utils/D3plusConfig.d.ts +981 -30
- package/types/src/utils/configPrep.d.ts +2 -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/umd/d3plus-core.full.js +86811 -61031
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +28392 -6498
- 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,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
A time axis's `rangeBreaks`: the axis swaps its time scale for a broken
|
|
3
|
+
one that hides the rules' time, keeps hidden times out of its ticks and
|
|
4
|
+
labels, and records each marked gap as an axis break so it draws the
|
|
5
|
+
break marker (and, in a Plot, the break lines) like `break` does.
|
|
6
|
+
*/ import { timeDay } from "d3-time";
|
|
7
|
+
import { timeFormat } from "d3-time-format";
|
|
8
|
+
import { dateFormatter } from "@d3plus/format";
|
|
9
|
+
import { breakStyle } from "./axisBreak.js";
|
|
10
|
+
import { brokenTimeScale, isBrokenTimeScale } from "./brokenTimeScale.js";
|
|
11
|
+
import { normalizeRangeBreaks } from "./rangeBreaks.js";
|
|
12
|
+
import { axisShownDates, axisTimeReference } from "./timeValues.js";
|
|
13
|
+
/**
|
|
14
|
+
Replaces a time axis's scale with a broken time scale when it has
|
|
15
|
+
`rangeBreaks`, and adds each marked gap inside the domain to
|
|
16
|
+
`axis._breaks`. Marked gaps take `breakConfig.space` pixels each.
|
|
17
|
+
*/ export function applyAxisRangeBreaks(axis) {
|
|
18
|
+
const current = axis._d3Scale;
|
|
19
|
+
if (axis.schema.scale !== "time" || !current) return;
|
|
20
|
+
const rules = normalizeRangeBreaks(axis.schema.rangeBreaks);
|
|
21
|
+
if (!rules.length) return;
|
|
22
|
+
const { space, mask } = breakStyle(axis);
|
|
23
|
+
const scale = brokenTimeScale(rules, {
|
|
24
|
+
space
|
|
25
|
+
});
|
|
26
|
+
scale.domain(current.domain());
|
|
27
|
+
scale.range(current.range());
|
|
28
|
+
axis._d3Scale = scale;
|
|
29
|
+
scale.gaps().filter((g)=>g.space > 0).forEach((g)=>axis._breaks.push({
|
|
30
|
+
start: g.start,
|
|
31
|
+
end: g.end,
|
|
32
|
+
startPosition: scale(g.start),
|
|
33
|
+
endPosition: scale(g.end),
|
|
34
|
+
baseline: false,
|
|
35
|
+
mask
|
|
36
|
+
}));
|
|
37
|
+
}
|
|
38
|
+
/** Drops the values a broken time axis hides (from its ticks or labels). */ export function visibleTimeValues(axis, values) {
|
|
39
|
+
const scale = axis._d3Scale;
|
|
40
|
+
return isBrokenTimeScale(scale) ? values.filter((v)=>!scale.isHidden(Number(v))) : values;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
The day a broken time axis's tick opens: when the tick is the first
|
|
44
|
+
shown time of its day (everything from midnight up to it hidden, such
|
|
45
|
+
as by an `hours` rule), that day's midnight, so the tick can be labeled
|
|
46
|
+
as the day it starts. Otherwise `undefined`.
|
|
47
|
+
*/ export function rangeBreakOpenedDay(axis, value) {
|
|
48
|
+
const scale = axis._d3Scale;
|
|
49
|
+
const t = Number(value instanceof Date ? +value : value);
|
|
50
|
+
if (!isBrokenTimeScale(scale) || !Number.isFinite(t)) return undefined;
|
|
51
|
+
const start = timeDay.floor(new Date(t));
|
|
52
|
+
if (+start === t) return undefined;
|
|
53
|
+
return scale.visible(start, t) === 0 ? start : undefined;
|
|
54
|
+
}
|
|
55
|
+
/** The distinct days (as midnights, ascending) of a list of dates. */ export function datesDays(dates) {
|
|
56
|
+
const seen = new Set();
|
|
57
|
+
return dates.map((d)=>timeDay.floor(d)).filter((d)=>!seen.has(+d) && !!seen.add(+d)).sort((a, b)=>+a - +b);
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
The day label for a broken time axis's ticks: given a tick that opens
|
|
61
|
+
its day (see `rangeBreakOpenedDay`), the day, labeled among the axis's
|
|
62
|
+
days in the current default time locale; given any other tick,
|
|
63
|
+
`undefined`. The day formatter is built once per set of axis dates.
|
|
64
|
+
*/ export function rangeBreakDayLabel(axis) {
|
|
65
|
+
let memo;
|
|
66
|
+
return (value)=>{
|
|
67
|
+
const day = rangeBreakOpenedDay(axis, value);
|
|
68
|
+
if (!day) return undefined;
|
|
69
|
+
const dates = axisTimeReference(axis);
|
|
70
|
+
if (!memo || memo.dates !== dates || memo.format !== timeFormat) memo = {
|
|
71
|
+
dates,
|
|
72
|
+
format: timeFormat,
|
|
73
|
+
label: dateFormatter(datesDays(dates), timeFormat)
|
|
74
|
+
};
|
|
75
|
+
return memo.label(day, axisShownDates(axis));
|
|
76
|
+
};
|
|
77
|
+
}
|
|
@@ -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,16 +1,16 @@
|
|
|
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
12
|
import { formatYear, isYearLike } from "../Axis/yearValues.js";
|
|
13
|
-
import { bucketBounds } from "./bucketBounds.js";
|
|
13
|
+
import { bucketBounds, labelValue } from "./bucketBounds.js";
|
|
14
14
|
import { computeColorScale } from "./colorScaleScale.js";
|
|
15
15
|
import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
16
16
|
import { isBucketScale } from "./colorScaleType.js";
|
|
@@ -54,7 +54,8 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
54
54
|
},
|
|
55
55
|
// Unset poles fall back to `colorDefaults` at draw time: `sequential` (blue)
|
|
56
56
|
// high, `light` midpoint, `off` (red) low — warm/cool poles that stay
|
|
57
|
-
// distinct under color-vision deficiency.
|
|
57
|
+
// distinct under color-vision deficiency. A dark or custom theme supplies
|
|
58
|
+
// its `colorScale` tokens instead.
|
|
58
59
|
{
|
|
59
60
|
key: "colorMax",
|
|
60
61
|
coerce: "identity"
|
|
@@ -96,6 +97,13 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
96
97
|
coerce: "identity",
|
|
97
98
|
default: 0
|
|
98
99
|
},
|
|
100
|
+
// Holds a single-hue light-theme ramp's palest step darker (colorRamp's
|
|
101
|
+
// `ordinal` option), so the lowest values still read as thin lines.
|
|
102
|
+
{
|
|
103
|
+
key: "ordinalRamp",
|
|
104
|
+
coerce: "identity",
|
|
105
|
+
default: false
|
|
106
|
+
},
|
|
99
107
|
{
|
|
100
108
|
key: "orient",
|
|
101
109
|
coerce: "identity",
|
|
@@ -135,6 +143,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
135
143
|
/**
|
|
136
144
|
Creates an SVG color scale based on an array of data.
|
|
137
145
|
*/ export default class ColorScale extends BaseClass {
|
|
146
|
+
static _displayName = "ColorScale";
|
|
138
147
|
_select;
|
|
139
148
|
_axisClass;
|
|
140
149
|
_axisTest;
|
|
@@ -170,7 +179,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
170
179
|
const last = i === ticks.length - 1;
|
|
171
180
|
if (tick === ticks[i + 1] || last) {
|
|
172
181
|
const suffix = last && tick < max(allValues) ? "+" : "";
|
|
173
|
-
return `${format(tick)}${suffix}`;
|
|
182
|
+
return `${format(labelValue(tick, allValues))}${suffix}`;
|
|
174
183
|
}
|
|
175
184
|
const [lower, upper] = bucketBounds(tick, i, ticks, allValues, format);
|
|
176
185
|
return this.schema.bucketJoiner(format(lower), format(upper));
|
|
@@ -178,10 +187,7 @@ import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
|
178
187
|
this._data = [];
|
|
179
188
|
this._labelClass = new TextBox();
|
|
180
189
|
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
|
-
},
|
|
190
|
+
fontColor: ()=>inkText(this),
|
|
185
191
|
fontSize: 12
|
|
186
192
|
};
|
|
187
193
|
this._legendClass = new Legend();
|
|
@@ -8,17 +8,46 @@ import { max } from "d3-array";
|
|
|
8
8
|
return Math.max(0, decimals.length - Number(exponent));
|
|
9
9
|
}
|
|
10
10
|
/** `value` counted in steps of `10^-places`, with float noise rounded off. */ const toSteps = (value, places)=>+(value * 10 ** places).toPrecision(15);
|
|
11
|
-
/** The value of `steps` steps of `10^-places
|
|
11
|
+
/** The value of `steps` steps of `10^-places` (never `-0`). */ const fromSteps = (steps, places)=>+(steps / 10 ** places).toPrecision(15) || 0;
|
|
12
|
+
/** Significant digits from which a value reads as computed rather than written. */ const COMPUTED_DIGITS = 12;
|
|
13
|
+
/** The number of significant digits `value` is written with, at 15 digits. */ export function significantDigits(value) {
|
|
14
|
+
const mantissa = value.toExponential(14).split("e")[0];
|
|
15
|
+
return mantissa.replace(/[-.]/g, "").replace(/0+$/, "").length || 1;
|
|
16
|
+
}
|
|
17
|
+
/** How small, as a share of the values' span, a value is float noise around zero. */ const NOISE = 1e-9;
|
|
18
|
+
/**
|
|
19
|
+
The decimal places bucket labels step at: the most any value is written
|
|
20
|
+
with. A computed value (a mean such as `1 / 3`) carries float precision
|
|
21
|
+
no label should step at, so its own places count only to the data's
|
|
22
|
+
display precision: three significant digits of the values' span. A value
|
|
23
|
+
within float noise of zero (`-1.4e-14`) counts as zero.
|
|
24
|
+
*/ export function labelPlaces(allValues) {
|
|
25
|
+
const finite = allValues.filter(Number.isFinite);
|
|
26
|
+
if (!finite.length) return 0;
|
|
27
|
+
const span = max(finite) - Math.min(...finite) || Math.abs(finite[0]);
|
|
28
|
+
const values = finite.map((v)=>Math.abs(v) < span * NOISE ? 0 : v);
|
|
29
|
+
const written = values.filter((v)=>significantDigits(v) < COMPUTED_DIGITS);
|
|
30
|
+
const places = max(written.map(decimalPlaces)) ?? 0;
|
|
31
|
+
if (written.length === values.length) return places;
|
|
32
|
+
const display = span ? Math.max(0, 2 - Math.floor(Math.log10(span))) : 0;
|
|
33
|
+
return Math.max(places, display);
|
|
34
|
+
}
|
|
35
|
+
/** `value` rounded to the places bucket labels step at (see `labelPlaces`). */ export function labelValue(value, allValues) {
|
|
36
|
+
const places = labelPlaces(allValues);
|
|
37
|
+
return fromSteps(Math.round(toSteps(value, places)), places);
|
|
38
|
+
}
|
|
12
39
|
/**
|
|
13
40
|
The `[lower, upper]` values a ColorScale label shows for the bucket
|
|
14
41
|
`[ticks[i], ticks[i + 1])`: the first and last values the data's own
|
|
15
|
-
precision can write inside it, so integer data reads
|
|
42
|
+
precision (see `labelPlaces`) can write inside it, so integer data reads
|
|
43
|
+
"1 - 2", "3 - 4", and computed values such as means don't step at float
|
|
44
|
+
precision (a bucket ending at 0 reads "-9.5 - -0.1", not "-9.5 - -1f").
|
|
16
45
|
When `format` prints the upper bound the same as the next bucket's lower
|
|
17
46
|
one (an abbreviation like "1.5k"), the upper bound drops a decimal place
|
|
18
47
|
at a time until it reads differently ("1.49k").
|
|
19
48
|
*/ export function bucketBounds(tick, i, ticks, allValues, format) {
|
|
20
49
|
const next = ticks[i + 1];
|
|
21
|
-
const places =
|
|
50
|
+
const places = labelPlaces(allValues);
|
|
22
51
|
const tickSteps = toSteps(tick, places);
|
|
23
52
|
// A repeated first tick labels its own value, so the bucket after it
|
|
24
53
|
// starts one step above.
|
|
@@ -7,7 +7,8 @@
|
|
|
7
7
|
(jenks, buckets, quantile without `bucketAxis`) get no mark: the value's
|
|
8
8
|
swatch stays lit and the rest dim instead (see `hoveredSwatch`).
|
|
9
9
|
*/ import { colorContrast } from "@d3plus/color";
|
|
10
|
-
import {
|
|
10
|
+
import { textWidth } from "@d3plus/dom";
|
|
11
|
+
import { inkText } from "../../utils/themeInk.js";
|
|
11
12
|
/** `hoverMarkConfig`'s defaults. */ export function hoverMarkDefaults() {
|
|
12
13
|
return {
|
|
13
14
|
tickConfig: {},
|
|
@@ -312,8 +313,7 @@ import { backgroundColor, textWidth } from "@d3plus/dom";
|
|
|
312
313
|
const value = cs._hoverValue;
|
|
313
314
|
const geometry = cs._barGeometry;
|
|
314
315
|
if (cs.schema.hoverMark === false || typeof value !== "number" || !Number.isFinite(value) || !cs._colorScale || !geometry) return;
|
|
315
|
-
const
|
|
316
|
-
const ink = colorContrast(node ? backgroundColor(node) : "rgb(255, 255, 255)", cs.schema.colorDefaults);
|
|
316
|
+
const ink = inkText(cs);
|
|
317
317
|
const mark = {
|
|
318
318
|
cs,
|
|
319
319
|
key: `${group.key}-hover`,
|