@d3plus/core 4.9.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 +170 -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 +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 +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- 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 +17 -12
- 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/Funnel/index.js +2 -1
- 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/Gauge/index.js +2 -1
- 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 +60 -19
- 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 +37 -16
- 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/Matrix/index.js +3 -2
- 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 +93 -108
- 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 +7 -2
- 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 +66 -32
- 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/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- 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 +14 -4
- 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 +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- 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/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- 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 +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -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 +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- 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 +5 -5
- 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 +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- 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 +65 -30
- 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 +75 -77
- 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/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- 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/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- 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 +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- 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 +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- 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 +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- 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 +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- 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 +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- 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 +42 -15
- 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 +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- 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 +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- 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 +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- 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 +123 -0
- 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/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -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 +34 -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 +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -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 +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- 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 +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- 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 +67 -79
- 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/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -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 +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/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -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/Candlestick/aggregate.d.ts +6 -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/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -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 +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- 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 +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -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/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- 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/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -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/facet/facetData.d.ts +1 -1
- 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 +13 -1
- 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/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -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/features.d.ts +8 -0
- 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 +19 -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 +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- 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 +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -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/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- 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/missingFields.d.ts +57 -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/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -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 +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- 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/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -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 +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- 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/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -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 +2 -8
- 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/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -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 +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- 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,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,17 +1,20 @@
|
|
|
1
|
-
import { max
|
|
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, labelValue } from "./bucketBounds.js";
|
|
13
14
|
import { computeColorScale } from "./colorScaleScale.js";
|
|
14
15
|
import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
16
|
+
import { isBucketScale } from "./colorScaleType.js";
|
|
17
|
+
import { addHoverMark, hoverMarkDefaults } from "./colorScaleHoverMark.js";
|
|
15
18
|
/** ColorScale's fluent accessor schema. Config storage lives on `this.schema.<key>`. */ const colorScaleSchema = [
|
|
16
19
|
{
|
|
17
20
|
key: "align",
|
|
@@ -51,7 +54,8 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
51
54
|
},
|
|
52
55
|
// Unset poles fall back to `colorDefaults` at draw time: `sequential` (blue)
|
|
53
56
|
// high, `light` midpoint, `off` (red) low — warm/cool poles that stay
|
|
54
|
-
// distinct under color-vision deficiency.
|
|
57
|
+
// distinct under color-vision deficiency. A dark or custom theme supplies
|
|
58
|
+
// its `colorScale` tokens instead.
|
|
55
59
|
{
|
|
56
60
|
key: "colorMax",
|
|
57
61
|
coerce: "identity"
|
|
@@ -78,11 +82,28 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
78
82
|
coerce: "identity",
|
|
79
83
|
default: 200
|
|
80
84
|
},
|
|
85
|
+
{
|
|
86
|
+
key: "hoverMark",
|
|
87
|
+
coerce: "identity",
|
|
88
|
+
default: true
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
key: "hoverMarkConfig",
|
|
92
|
+
merge: true,
|
|
93
|
+
factory: hoverMarkDefaults
|
|
94
|
+
},
|
|
81
95
|
{
|
|
82
96
|
key: "midpoint",
|
|
83
97
|
coerce: "identity",
|
|
84
98
|
default: 0
|
|
85
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
|
+
},
|
|
86
107
|
{
|
|
87
108
|
key: "orient",
|
|
88
109
|
coerce: "identity",
|
|
@@ -122,6 +143,7 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
122
143
|
/**
|
|
123
144
|
Creates an SVG color scale based on an array of data.
|
|
124
145
|
*/ export default class ColorScale extends BaseClass {
|
|
146
|
+
static _displayName = "ColorScale";
|
|
125
147
|
_select;
|
|
126
148
|
_axisClass;
|
|
127
149
|
_axisTest;
|
|
@@ -134,6 +156,9 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
134
156
|
_legendClass;
|
|
135
157
|
_outerBounds;
|
|
136
158
|
_rectClass;
|
|
159
|
+
/** The scale the last render built, with a `scale` function resolved. */ _scaleType = "linear";
|
|
160
|
+
/** Where the color bar sits, set when the bar variant renders (see colorScaleHoverMark). */ _barGeometry;
|
|
161
|
+
/** The value marked on the scale, set with `hover()`. */ _hoverValue;
|
|
137
162
|
/** Smooth-gradient fill token (`gradient:<json>`), set by renderGradientStops. */ _gradientFill;
|
|
138
163
|
// Standalone scene renderer (used when rendered on its own, not inside a
|
|
139
164
|
// Viz). Reused across re-renders by paintComponentScene().
|
|
@@ -151,34 +176,18 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
151
176
|
this._axisTest = new Axis();
|
|
152
177
|
this.schema.bucketFormat = (tick, i, ticks, allValues)=>{
|
|
153
178
|
const format = this.schema.axisConfig.tickFormat ? this.schema.axisConfig.tickFormat : isYearLike(allValues) ? (v)=>formatYear(v, this.schema.locale) : formatAbbreviate;
|
|
154
|
-
const next = ticks[i + 1];
|
|
155
|
-
const prev = i ? ticks[i - 1] : false;
|
|
156
179
|
const last = i === ticks.length - 1;
|
|
157
|
-
if (tick ===
|
|
180
|
+
if (tick === ticks[i + 1] || last) {
|
|
158
181
|
const suffix = last && tick < max(allValues) ? "+" : "";
|
|
159
|
-
return `${format(tick)}${suffix}`;
|
|
160
|
-
} else {
|
|
161
|
-
const mod = next ? next / 100 : tick / 100;
|
|
162
|
-
const pow = mod >= 1 || mod <= -1 ? Math.round(mod).toString().length - 1 : mod.toString().split(".")[1].replace(/([1-9])[1-9].*$/, "$1").length * -1;
|
|
163
|
-
const ten = Math.pow(10, pow);
|
|
164
|
-
const prevValue = prev === tick && i === 1 ? format(min([
|
|
165
|
-
tick + ten,
|
|
166
|
-
allValues.find((d)=>d > tick && d < next)
|
|
167
|
-
])) : format(tick);
|
|
168
|
-
const nextValue = tick && i === 1 ? format(next) : format(max([
|
|
169
|
-
next - ten,
|
|
170
|
-
allValues.reverse().find((d)=>d > tick && d < next)
|
|
171
|
-
]));
|
|
172
|
-
return this.schema.bucketJoiner(prevValue, nextValue);
|
|
182
|
+
return `${format(labelValue(tick, allValues))}${suffix}`;
|
|
173
183
|
}
|
|
184
|
+
const [lower, upper] = bucketBounds(tick, i, ticks, allValues, format);
|
|
185
|
+
return this.schema.bucketJoiner(format(lower), format(upper));
|
|
174
186
|
};
|
|
175
187
|
this._data = [];
|
|
176
188
|
this._labelClass = new TextBox();
|
|
177
189
|
this.schema.labelConfig = {
|
|
178
|
-
fontColor: ()=>
|
|
179
|
-
const bg = this._select ? backgroundColor(this._select.node()) : "rgb(255, 255, 255)";
|
|
180
|
-
return colorContrast(bg, this.schema.colorDefaults);
|
|
181
|
-
},
|
|
190
|
+
fontColor: ()=>inkText(this),
|
|
182
191
|
fontSize: 12
|
|
183
192
|
};
|
|
184
193
|
this._legendClass = new Legend();
|
|
@@ -214,11 +223,7 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
214
223
|
parent: this._select
|
|
215
224
|
});
|
|
216
225
|
const compute = computeColorScale(this);
|
|
217
|
-
const gradient = this.schema.bucketAxis || !
|
|
218
|
-
"buckets",
|
|
219
|
-
"jenks",
|
|
220
|
-
"quantile"
|
|
221
|
-
].includes(this.schema.scale);
|
|
226
|
+
const gradient = this.schema.bucketAxis || !isBucketScale(compute.scale);
|
|
222
227
|
const t = transition().duration(this.schema.duration);
|
|
223
228
|
const groupParams = {
|
|
224
229
|
enter: {
|
|
@@ -272,11 +277,7 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
272
277
|
and the discrete variant use concrete per-bucket fills.
|
|
273
278
|
*/ toScene() {
|
|
274
279
|
const children = [];
|
|
275
|
-
const gradient = this.schema.bucketAxis || !
|
|
276
|
-
"buckets",
|
|
277
|
-
"jenks",
|
|
278
|
-
"quantile"
|
|
279
|
-
].includes(this.schema.scale);
|
|
280
|
+
const gradient = this.schema.bucketAxis || !isBucketScale(this._scaleType);
|
|
280
281
|
const pushScene = (cls)=>{
|
|
281
282
|
if (cls && typeof cls.toScene === "function") {
|
|
282
283
|
const s = cls.toScene();
|
|
@@ -304,7 +305,7 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
304
305
|
};
|
|
305
306
|
}
|
|
306
307
|
}
|
|
307
|
-
|
|
308
|
+
const group = {
|
|
308
309
|
type: "group",
|
|
309
310
|
key: `ColorScale-${this._uuid.slice(0, 8)}`,
|
|
310
311
|
...transform ? {
|
|
@@ -312,6 +313,8 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
312
313
|
} : {},
|
|
313
314
|
children
|
|
314
315
|
};
|
|
316
|
+
addHoverMark(this, group);
|
|
317
|
+
return group;
|
|
315
318
|
}
|
|
316
319
|
axisConfig(_) {
|
|
317
320
|
return arguments.length ? (this.schema.axisConfig = mergeConfigBag(this, "axisConfig", _), this) : this.schema.axisConfig;
|
|
@@ -319,6 +322,9 @@ import { renderGradient, renderLegendVariant } from "./colorScaleRender.js";
|
|
|
319
322
|
data(_) {
|
|
320
323
|
return arguments.length ? (this._data = _, this) : this._data;
|
|
321
324
|
}
|
|
325
|
+
hover(_) {
|
|
326
|
+
return arguments.length ? (this._hoverValue = _, this) : this._hoverValue;
|
|
327
|
+
}
|
|
322
328
|
labelConfig(_) {
|
|
323
329
|
return arguments.length ? (this.schema.labelConfig = mergeConfigBag(this, "labelConfig", _), this) : this.schema.labelConfig;
|
|
324
330
|
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { max } from "d3-array";
|
|
2
|
+
/**
|
|
3
|
+
The number of decimal places `value` is written with, read at 15
|
|
4
|
+
significant digits so float noise (`0.1 + 0.2`) doesn't count.
|
|
5
|
+
*/ export function decimalPlaces(value) {
|
|
6
|
+
const [mantissa, exponent] = value.toExponential(14).split("e");
|
|
7
|
+
const decimals = mantissa.split(".")[1].replace(/0+$/, "");
|
|
8
|
+
return Math.max(0, decimals.length - Number(exponent));
|
|
9
|
+
}
|
|
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` (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
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
The `[lower, upper]` values a ColorScale label shows for the bucket
|
|
41
|
+
`[ticks[i], ticks[i + 1])`: the first and last values the data's own
|
|
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").
|
|
45
|
+
When `format` prints the upper bound the same as the next bucket's lower
|
|
46
|
+
one (an abbreviation like "1.5k"), the upper bound drops a decimal place
|
|
47
|
+
at a time until it reads differently ("1.49k").
|
|
48
|
+
*/ export function bucketBounds(tick, i, ticks, allValues, format) {
|
|
49
|
+
const next = ticks[i + 1];
|
|
50
|
+
const places = labelPlaces(allValues);
|
|
51
|
+
const tickSteps = toSteps(tick, places);
|
|
52
|
+
// A repeated first tick labels its own value, so the bucket after it
|
|
53
|
+
// starts one step above.
|
|
54
|
+
const lower = fromSteps(i === 1 && ticks[0] === tick ? Math.floor(tickSteps) + 1 : Math.ceil(tickSteps), places);
|
|
55
|
+
const below = (p)=>fromSteps(Math.ceil(toSteps(next, p)) - 1, p);
|
|
56
|
+
const nextLabel = format(fromSteps(Math.ceil(toSteps(next, places)), places));
|
|
57
|
+
let p = places;
|
|
58
|
+
let upper = below(p);
|
|
59
|
+
while(format(upper) === nextLabel && below(p - 1) >= lower)upper = below(--p);
|
|
60
|
+
return [
|
|
61
|
+
lower,
|
|
62
|
+
upper
|
|
63
|
+
];
|
|
64
|
+
}
|