@weng-lab/visualization 2.6.0-beta.1 → 2.7.0-beta.0

package/dist/src/components/Legend/Colorbar/ColorbarEnd.d.ts

@@ -0,0 +1,26 @@
+import { TooltipProps } from '@mui/material';
+import { ReactElement } from 'react';
+import { ColorRange, RampRange } from '../colorbarAxis';
+export type ColorbarEndProps = {
+    end: "low" | "high";
+    /** Whether values lie past this end, so the label reads "≤" or "≥". */
+    clamped: boolean;
+    /** The label, as an element a tooltip can anchor to: a `<text>` in an `<svg>`, a Typography beside one. */
+    children: ReactElement;
+    /** The colorbar's range, values, noun and value format - see ColorbarGraphic. */
+    range: ColorRange;
+    values: ArrayLike<number>;
+    noun: string;
+    formatValue: (value: number) => string;
+    onSweep: (sweep: RampRange | null) => void;
+    placement: TooltipProps["placement"];
+    /** Where the tooltip portals to when the body won't do - see HeatmapLegendFrame. */
+    overlayContainer?: HTMLElement;
+};
+/**
+ * One of a colorbar's end labels, which sweeps its end when hovered: a "≤" or "≥" label the values
+ * past the clamp, a plain one the last stretch of the bar.
+ */
+declare const ColorbarEnd: ({ end, clamped, children, range, values, noun, formatValue, onSweep, placement, overlayContainer, }: ColorbarEndProps) => import("react/jsx-runtime").JSX.Element;
+export default ColorbarEnd;
+//# sourceMappingURL=ColorbarEnd.d.ts.map

package/dist/src/components/Legend/Colorbar/ColorbarEnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorbarEnd.d.ts","sourceRoot":"","sources":["../../../../../src/components/Legend/Colorbar/ColorbarEnd.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAmC,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGnG,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,2GAA2G;IAC3G,QAAQ,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IACrC,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,WAAW,GAAI,qGAWlB,gBAAgB,4CA0BlB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/src/components/Legend/Colorbar/ColorbarGraphic.d.ts

@@ -0,0 +1,34 @@
+import { ColorRange, RampRange, RampStop } from '../colorbarAxis';
+import { ColorbarOrientation } from '../colorbarGeometry';
+export type ColorbarGraphicProps = {
+    orientation: ColorbarOrientation;
+    /** The bar's length in pixels. */
+    length: number;
+    stops: readonly RampStop[];
+    /** Where the colors stop. The bar spans it, and its end columns count the values beyond. */
+    range: ColorRange;
+    /** Every value on the plot, sorted ascending and unclamped: what the columns count. */
+    values: ArrayLike<number>;
+    /** How the sweep's tooltip writes values. */
+    formatValue: (value: number) => string;
+    /** What one value is, for the sweep's count: "sample", "cell". */
+    noun: string;
+    /**
+     * The stretch of the bar under the cursor, drawn on it as a window - or an end's clamp (see
+     * clampAt), drawn as a ring round that end's tip.
+     */
+    sweep: RampRange | null;
+    /** Fired as the cursor moves along the bar and when it leaves, so the plot can highlight the window's values. */
+    onSweep: (sweep: RampRange | null) => void;
+    /** A value to mark on the bar - the hovered point's. */
+    marker?: number | null;
+    /** Where the sweep's tooltip portals to when the body won't do - see HeatmapLegendFrame. */
+    overlayContainer?: HTMLElement;
+};
+/**
+ * A colorbar with a histogram of the plot's values along it, as a `<g>` for the caller's `<svg>`, so
+ * a heatmap can use it as its legend and downloads keep it.
+ */
+declare const ColorbarGraphic: ({ orientation, length, stops, range, values, formatValue, noun, sweep, onSweep, marker, overlayContainer, }: ColorbarGraphicProps) => import("react/jsx-runtime").JSX.Element;
+export default ColorbarGraphic;
+//# sourceMappingURL=ColorbarGraphic.d.ts.map

package/dist/src/components/Legend/Colorbar/ColorbarGraphic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorbarGraphic.d.ts","sourceRoot":"","sources":["../../../../../src/components/Legend/Colorbar/ColorbarGraphic.tsx"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAQL,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,mBAAmB,CAAC;IACjC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,4FAA4F;IAC5F,KAAK,EAAE,UAAU,CAAC;IAClB,uFAAuF;IACvF,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,6CAA6C;IAC7C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,iHAAiH;IACjH,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,eAAe,GAAI,6GAYtB,oBAAoB,4CA8HtB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/src/components/Legend/Colorbar/ColorbarLegend.d.ts

@@ -0,0 +1,35 @@
+import { ColorbarScaleProps } from './Colorbar';
+import { ColorRangeControl } from '../ColorRange/ColorRangeButton';
+import { ColorRange, RampKind } from '../colorbarAxis';
+import { ColorbarLabelStyle } from './colorbarLabels';
+export type ColorbarLegendProps = Omit<ColorbarScaleProps, "range" | "labelStyle" | "holdLabels" | "overlayContainer"> & {
+    /** What the colors stand for, for screen readers. */
+    label: string;
+    /** Where the colors stop. Null while no value on the plot has one, leaving only the missing count. */
+    range: ColorRange | null;
+    kind?: RampKind;
+    /** Where the colors stop can be moved, from a button beside the bar. Omitted, it can't. */
+    control?: ColorRangeControl;
+    /** What the range panel says about the scale - see ColorRangeButton. */
+    notes?: readonly string[];
+    /**
+     * How many values on screen are drawn in a neutral rather than on the ramp, the neutral, and what it
+     * stands for: "No value" by default, or a cutoff the ramp starts at, say.
+     */
+    missing?: {
+        count: number;
+        color: string;
+        label?: string;
+    };
+    /** The bar's length: by default a chip row's worth of room, lying down. */
+    length?: number;
+    /** How the end labels are written. The theme's caption by default - see themeLabelStyle. */
+    labelStyle?: ColorbarLabelStyle;
+};
+/**
+ * A colorbar in place of a field's chips, held to their height so switching doesn't shift the plot,
+ * with the button that moves its range and a count of the values with none.
+ */
+declare const ColorbarLegend: ({ label, range, kind, control, notes, missing, length, labelStyle, ...scale }: ColorbarLegendProps) => import("react/jsx-runtime").JSX.Element;
+export default ColorbarLegend;
+//# sourceMappingURL=ColorbarLegend.d.ts.map

package/dist/src/components/Legend/Colorbar/ColorbarLegend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorbarLegend.d.ts","sourceRoot":"","sources":["../../../../../src/components/Legend/Colorbar/ColorbarLegend.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAyB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,kBAAkB,EAClB,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,kBAAkB,CAC3D,GAAG;IACF,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,sGAAsG;IACtG,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,cAAc,GAAI,+EAUrB,mBAAmB,4CAwDrB,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/src/components/Legend/Colorbar/colorbarLabels.d.ts

@@ -0,0 +1,37 @@
+import { Theme } from '@mui/material/styles';
+import { ColorRange } from '../colorbarAxis';
+/**
+ * How a colorbar writes its end labels. Name the font family outright, not through a CSS variable
+ * (next/font's, say), which neither the canvas that measures the labels nor a downloaded SVG can resolve.
+ */
+export type ColorbarLabelStyle = {
+    fontFamily: string;
+    fontSize: number;
+    fontWeight?: number;
+    /** In pixels. */
+    letterSpacing?: number;
+    fill: string;
+};
+/** The library's axis text, so by default a colorbar matches the plot beside it. */
+export declare const DEFAULT_LABEL_STYLE: ColorbarLabelStyle;
+/**
+ * A theme's caption as a colorbar's label style, so the labels read as the text around them and
+ * follow the theme into dark mode. Pass `fontFamily` where the theme's is a CSS variable.
+ */
+export declare const themeLabelStyle: ({ typography, palette }: Theme, fontFamily?: string) => ColorbarLabelStyle;
+/** One end's label: its text, whether shown values lie past that end, and its width in pixels. */
+export type EndLabel = {
+    text: string;
+    clamped: boolean;
+    width: number;
+};
+/**
+ * The end labels of a colorbar spanning `range`: its ends as `format` writes them, with "≤" or "≥"
+ * where values on screen lie past one, and how wide each is in `style`. While `hold` (the range
+ * editor is open), the widths hold their widest, so the bar doesn't shift as the range is dragged.
+ */
+export declare const useEndLabels: (range: ColorRange, values: ArrayLike<number>, format: (value: number) => string, style: ColorbarLabelStyle, hold: boolean) => {
+    low: EndLabel;
+    high: EndLabel;
+};
+//# sourceMappingURL=colorbarLabels.d.ts.map

package/dist/src/components/Legend/Colorbar/colorbarLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorbarLabels.d.ts","sourceRoot":"","sources":["../../../../../src/components/Legend/Colorbar/colorbarLabels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,EAAE,kBAAgF,CAAC;AAWnH;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,yBAAyB,KAAK,EAAE,aAAa,MAAM,KAAG,kBAUrF,CAAC;AAEF,kGAAkG;AAClG,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA0CzE;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,UAAU,EACjB,QAAQ,SAAS,CAAC,MAAM,CAAC,EACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACjC,OAAO,kBAAkB,EACzB,MAAM,OAAO,KACZ;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAYjC,CAAC"}

package/dist/src/components/Legend/Colorbar/useSweep.d.ts

@@ -0,0 +1,7 @@
+import { RampRange } from '../colorbarAxis';
+/**
+ * `onSweep`, remembering whether this element started the sweep showing, so that unmounting
+ * mid-sweep (Escape closing the expanded minimap, with no mouseleave) ends it too.
+ */
+export declare const useSweep: (onSweep: (sweep: RampRange | null) => void) => (sweep: RampRange | null) => void;
+//# sourceMappingURL=useSweep.d.ts.map

package/dist/src/components/Legend/Colorbar/useSweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSweep.d.ts","sourceRoot":"","sources":["../../../../../src/components/Legend/Colorbar/useSweep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,MAYzD,OAAO,SAAS,GAAG,IAAI,SAIhC,CAAC"}

package/dist/src/components/Legend/Swatch.d.ts

@@ -0,0 +1,7 @@
+/** A legend's color dot, hollow for a group switched off. */
+declare const Swatch: ({ color, hollow }: {
+    color: string;
+    hollow?: boolean;
+}) => import("react/jsx-runtime").JSX.Element;
+export default Swatch;
+//# sourceMappingURL=Swatch.d.ts.map

package/dist/src/components/Legend/Swatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Swatch.d.ts","sourceRoot":"","sources":["../../../../src/components/Legend/Swatch.tsx"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,QAAA,MAAM,MAAM,GAAI,mBAA2B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,4CAW7E,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/components/Legend/colorbarAxis.d.ts

@@ -0,0 +1,105 @@
+/**
+ * The arithmetic behind a colorbar: where a value sits along the bar, how many values fall in each
+ * stretch, and the ranges its colors can span. Values come sorted ascending and are bisected, so a
+ * heatmap's hundreds of thousands of cells cost no more than a plot's points.
+ */
+/** Where the colors stop, in the units the ramp is drawn in. Values beyond take the end colors. */
+export type ColorRange = [low: number, high: number];
+/** A color stop, `at` from 0 at the low end of the ramp to 1 at its high end. Any CSS color. */
+export type RampStop = {
+    at: number;
+    color: string;
+};
+/** Sequential runs low to high. Diverging runs out both ways from 0, so its range stays symmetric (±limit). */
+export type RampKind = "sequential" | "diverging";
+/** A stretch of the bar, from 0 at its low end to 1 at its high end. */
+export type RampRange = {
+    from: number;
+    to: number;
+};
+/** A range the editor offers in one click. */
+export type RangePreset = {
+    label: string;
+    range: ColorRange;
+};
+type Sorted = ArrayLike<number>;
+/** Linear interpolation between closest ranks, as numpy's default. */
+export declare const percentile: (sorted: Sorted, p: number) => number;
+/** The middle of the values, with `clip` percent trimmed off each end, so a few extreme values don't wash out the rest. */
+export declare const percentileRange: (sorted: Sorted, clip: number) => ColorRange;
+/** Colors spaced evenly along the ramp, as Heatmap spaces its `colors`. */
+export declare const evenStops: (colors: readonly string[]) => RampStop[];
+/** Where values sit along a bar, and which value sits at each place. */
+export type BarAxis = {
+    /** A value's place along the bar, from 0 at its low end to 1 at its high end. */
+    toT: (value: number) => number;
+    /** The value at a place along the bar. */
+    fromT: (t: number) => number;
+    /** Places where the scale changes pace, which the bar marks with a gap. */
+    breaks: number[];
+};
+/** The compact legend's axis: the colors' range, with values beyond held at the ends, as their colors are. */
+export declare const rangeAxis: ([low, high]: ColorRange) => BarAxis;
+/**
+ * The range editor's axis, spanning every value: linear across `core`, where nearly every value
+ * lies, and logarithmic in the tails, squeezed into the last 16% at either end. Independent of the
+ * range, so a dragged handle stays under the cursor.
+ */
+export declare const squeezedAxis: (core: ColorRange, extent: ColorRange, kind: RampKind) => BarAxis;
+/** How many values fall in each of `bins` equal stretches of the bar, found at each stretch's edge. */
+export declare const histogram: (sorted: Sorted, axis: BarAxis, bins: number) => number[];
+/**
+ * The values a sweep of a colorbar spanning `range` takes in, as [low, high] inclusive: what a plot
+ * highlights for it. Open-ended at the bar's ends, to take in the values clamped there.
+ */
+export declare const sweptValues: (range: ColorRange, { from, to }: RampRange) => ColorRange;
+/** Whether values lie past each end of a range and so take its end color: what "≤" and "≥" say. */
+export declare const clampedEnds: (sorted: Sorted, [low, high]: ColorRange) => {
+    low: boolean;
+    high: boolean;
+};
+/** How many values lie in a range, and the lowest and highest of them - the true ones, past any clamp. */
+export declare const summarize: (sorted: Sorted, [low, high]: ColorRange) => {
+    count: number;
+    lowest: number | null;
+    highest: number | null;
+};
+/** How many values lie beyond a range, and so take its end colors. */
+export declare const countBeyond: (sorted: Sorted, [low, high]: ColorRange) => number;
+/** A range as the legends write it: "±3.0" for a diverging scale, "0.5 – 120" otherwise. */
+export declare const formatRange: (kind: RampKind, [low, high]: ColorRange, format: (value: number) => string) => string;
+/**
+ * The values past the clamp at one end - the ones drawn in that end's color - as a stretch of no
+ * width at that end of the bar, which sweptValues opens out past it: [high, ∞) or (−∞, low].
+ */
+export declare const clampAt: (end: "low" | "high") => RampRange;
+/** Which end's clamp a stretch of the bar is, if it's one - see clampAt. */
+export declare const clampOf: ({ from, to }: RampRange) => "low" | "high" | null;
+/** The window centered on a place along the bar, slid inward at the ends rather than cut short. */
+export declare const rangeAt: (t: number) => RampRange;
+/** The middle 90%, 96% and 98% of the values, and all of them. */
+export declare const percentilePresets: (sorted: Sorted) => RangePreset[];
+/** A symmetric limit, rounded up to a tenth, so "All" really takes in every value. */
+export declare const reachOf: (sorted: Sorted) => number;
+/** ±2, ±3, ±5 and ±10 where the values reach past them, and all of them. */
+export declare const symmetricPresets: (reach: number) => RangePreset[];
+/** Rounds a dragged diverging limit: tenths below 5, halves below 10, whole numbers beyond, as the tails move fast. */
+export declare const snapLimit: (limit: number) => number;
+/** Whether two ranges match within half a percent of their span, so a range that's been rounded still matches. */
+export declare const sameRange: (a: ColorRange, b: ColorRange) => boolean;
+/** A ramp's color at any place along it, from 0 at its low end to 1 at its high end. */
+export declare const rampAt: (stops: readonly RampStop[]) => (s: number) => string;
+/**
+ * The color a value takes on a ramp whose colors span `range`, with values beyond held at the end
+ * colors: what to paint a point so it matches a colorbar of the same stops and range.
+ */
+export declare const rampColor: (stops: readonly RampStop[], range: ColorRange) => (value: number) => string;
+/** A count as a share of a total, never rounded to zero ("<0.1%"). Tenths below 10%, whole percents above. */
+export declare const formatShare: (count: number, total: number) => string;
+/**
+ * A sweep's tooltip: "12 samples (3.4%) · 0.2 – 1.5", the true lowest and highest values inside. A
+ * clamp's reads "up to 113M" instead, leaving its near end to the end label.
+ */
+export declare const describeSweep: (values: ArrayLike<number>, range: ColorRange, sweep: RampRange, noun: string, formatValue: (value: number) => string) => string;
+export {};
+//# sourceMappingURL=colorbarAxis.d.ts.map

package/dist/src/components/Legend/colorbarAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorbarAxis.d.ts","sourceRoot":"","sources":["../../../../src/components/Legend/colorbarAxis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,mGAAmG;AACnG,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAErD,gGAAgG;AAChG,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,+GAA+G;AAC/G,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;AAElD,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE/D,KAAK,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AA0BhC,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,GAAG,MAAM,WAKnD,CAAC;AAEF,2HAA2H;AAC3H,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,UAG9D,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,SAAS,GAAI,QAAQ,SAAS,MAAM,EAAE,KAAG,QAAQ,EACM,CAAC;AAErE,wEAAwE;AACxE,MAAM,MAAM,OAAO,GAAG;IACpB,iFAAiF;IACjF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAIF,8GAA8G;AAC9G,eAAO,MAAM,SAAS,GAAI,aAAa,UAAU,KAAG,OAOnD,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,QAAQ,KAAG,OA4BnF,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,EAAE,MAAM,OAAO,EAAE,MAAM,MAAM,KAAG,MAAM,EAS7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,EAAE,cAAc,SAAS,KAAG,UAGxE,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,EAAE,aAAa,UAAU;;;CAGjE,CAAC;AAEH,0GAA0G;AAC1G,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,EAAE,aAAa,UAAU;;;;CAKhE,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,EAAE,aAAa,UAAU,WACG,CAAC;AAEvE,4FAA4F;AAC5F,eAAO,MAAM,WAAW,GAAI,MAAM,QAAQ,EAAE,aAAa,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,WACtB,CAAC;AAKjF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,KAAK,GAAG,MAAM,KAAG,SAAsE,CAAC;AAErH,4EAA4E;AAC5E,eAAO,MAAM,OAAO,GAAI,cAAc,SAAS,KAAG,KAAK,GAAG,MAAM,GAAG,IACG,CAAC;AAEvE,mGAAmG;AACnG,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,SAGnC,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,WAAW,EAK7D,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,WAAyE,CAAC;AAEhH,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,WAAW,EAK3D,CAAC;AAEF,uHAAuH;AACvH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,WAC+D,CAAC;AAEvG,kHAAkH;AAClH,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,EAAE,GAAG,UAAU,YAGrD,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,MAAM,GAAI,OAAO,SAAS,QAAQ,EAAE,MAEvC,GAAG,MAAM,KAAG,MAUrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,SAAS,QAAQ,EAAE,EAAE,OAAO,UAAU,MAG7D,OAAO,MAAM,WACtB,CAAC;AAEF,8GAA8G;AAC9G,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,WAGvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS,CAAC,MAAM,CAAC,EACzB,OAAO,UAAU,EACjB,OAAO,SAAS,EAChB,MAAM,MAAM,EACZ,aAAa,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,WAkBvC,CAAC"}

package/dist/src/components/Legend/colorbarGeometry.d.ts

@@ -0,0 +1,43 @@
+import { Theme } from '@mui/material/styles';
+/** Which way a colorbar's bar runs. */
+export type ColorbarOrientation = "horizontal" | "vertical";
+export declare const BAR = 10;
+export declare const GAP = 2;
+/** The histogram's depth: held to a chip row's 24px lying down, roomier standing up beside a heatmap. */
+export declare const HISTOGRAM: {
+    readonly horizontal: 12;
+    readonly vertical: 16;
+};
+/** How much room the graphic takes across the bar: histogram, gap and bar. */
+export declare const colorbarDepth: (orientation: ColorbarOrientation) => number;
+/**
+ * Each histogram column's height, out of `depth`. The end columns also count the values beyond the
+ * range and can dwarf the rest, so heights are scaled to the tallest middle column, and a taller end
+ * column is `capped`, to be drawn with a break (see breakPoints).
+ */
+export declare const histogramColumns: (counts: readonly number[], depth: number) => {
+    count: number;
+    size: number;
+    capped: boolean;
+}[];
+/**
+ * The slanted cut through a capped column, as polygon points: `from` to `to` across the column,
+ * centered `at` along it, climbing `rise` with thickness `gap`. `place` maps those onto the screen.
+ */
+export declare const breakPoints: (place: (across: number, up: number) => [number, number], { from, to, at, rise, gap }: {
+    from: number;
+    to: number;
+    at: number;
+    rise: number;
+    gap: number;
+}) => string;
+/** Room between a bar and the end label beside it. */
+export declare const LABEL_GAP = 8;
+/** Room above and below a standing bar for its end labels, in a font this size. */
+export declare const labelSpace: (fontSize: number) => number;
+/**
+ * The histogram's columns: neutral, so they read as counts rather than as part of the ramp, and a
+ * slate that shows on the theme's paper, light or dark.
+ */
+export declare const columnColor: (theme: Theme) => "#90a4ae" | "#455a64";
+//# sourceMappingURL=colorbarGeometry.d.ts.map

package/dist/src/components/Legend/colorbarGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorbarGeometry.d.ts","sourceRoot":"","sources":["../../../../src/components/Legend/colorbarGeometry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE5D,eAAO,MAAM,GAAG,KAAK,CAAC;AACtB,eAAO,MAAM,GAAG,IAAI,CAAC;AACrB,yGAAyG;AACzG,eAAO,MAAM,SAAS;;;CAA4C,CAAC;AAEnE,8EAA8E;AAC9E,eAAO,MAAM,aAAa,GAAI,aAAa,mBAAmB,WAAuC,CAAC;AAEtG;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,MAAM,EAAE,EAAE,OAAO,MAAM;;;;GAOxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,EACvD,6BAA6B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,WASpF,CAAC;AAEf,sDAAsD;AACtD,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,mFAAmF;AACnF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,WAAiB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,0BAAoE,CAAC"}

package/dist/src/components/Legend/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Legends a plot can sit beside: chips for groups, and a colorbar for a continuous value, with the
+ * button that moves where its colors stop. A page wires a legend's hover and toggles to its plot.
+ */
+export { default as ChipLegend } from './ChipLegend/ChipLegend';
+export type { ChipLegendProps, LegendGroup } from './ChipLegend/ChipLegend';
+export { Colorbar } from './Colorbar/Colorbar';
+export type { ColorbarProps, ColorbarScaleProps } from './Colorbar/Colorbar';
+export { default as ColorbarLegend } from './Colorbar/ColorbarLegend';
+export type { ColorbarLegendProps } from './Colorbar/ColorbarLegend';
+export { themeLabelStyle } from './Colorbar/colorbarLabels';
+export type { ColorbarLabelStyle } from './Colorbar/colorbarLabels';
+export { default as ColorRangeButton } from './ColorRange/ColorRangeButton';
+export type { ColorRangeButtonProps, ColorRangeControl } from './ColorRange/ColorRangeButton';
+export { evenStops, percentilePresets, percentileRange, rampColor, reachOf, sameRange, sweptValues, symmetricPresets, } from './colorbarAxis';
+export type { ColorRange, RampKind, RampRange, RampStop, RangePreset } from './colorbarAxis';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/Legend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Legend/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC9F,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/components/ScatterPlot/AnimatedPoints.d.ts

@@ -1,8 +1,9 @@
 import { ScaleLinear } from '@visx/vendor/d3-scale';
 import { AnimationType } from '../../utility';
-import { Point } from './types';
+import { DimStyle, Point } from './types';
 type AnimatedPointsProps<T extends object> = {
     pointData: Point<T>[];
+    dimStyle: DimStyle;
     animation: AnimationType;
     animationGroupSize?: number;
     animationBuffer?: number;
@@ -11,6 +12,6 @@ type AnimatedPointsProps<T extends object> = {
     boundedWidth: number;
     boundedHeight: number;
 };
-declare const AnimatedPoints: <T extends object>({ pointData, animation, animationGroupSize, animationBuffer, xScaleTransformed, yScaleTransformed, boundedWidth, boundedHeight, }: AnimatedPointsProps<T>) => import("react/jsx-runtime").JSX.Element;
+declare const AnimatedPoints: <T extends object>({ pointData, dimStyle, animation, animationGroupSize, animationBuffer, xScaleTransformed, yScaleTransformed, boundedWidth, boundedHeight, }: AnimatedPointsProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default AnimatedPoints;
 //# sourceMappingURL=AnimatedPoints.d.ts.map

package/dist/src/components/ScatterPlot/AnimatedPoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimatedPoints.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/AnimatedPoints.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,KAAK,mBAAmB,CAAC,CAAC,SAAS,MAAM,IAAI;IACzC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,SAAS,EAAE,aAAa,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,mIASvC,mBAAmB,CAAC,CAAC,CAAC,4CAoCxB,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"AnimatedPoints.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/AnimatedPoints.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAG1C,KAAK,mBAAmB,CAAC,CAAC,SAAS,MAAM,IAAI;IACzC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,aAAa,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,6IAUvC,mBAAmB,CAAC,CAAC,CAAC,4CAiCxB,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/src/components/ScatterPlot/ScatterPlotViewport.d.ts

@@ -1,6 +1,6 @@
 import { default as React } from 'react';
 import { ScaleLinear } from '@visx/vendor/d3-scale';
-import { BackgroundGradient, ChartProps, CrosshairPosition, Point, SelectionMode, ZoomType } from './types';
+import { BackgroundGradient, ChartProps, CrosshairPosition, DimStyle, Point, SelectionMode, ZoomType } from './types';
 type ScatterPlotViewportProps<T extends object> = {
     width: number;
     height: number;
@@ -21,9 +21,12 @@ type ScatterPlotViewportProps<T extends object> = {
     selectMode: SelectionMode;
     selectable: boolean;
     disableZoom?: boolean;
-    groupPointsAnchor?: keyof Point<T> | keyof T;
     hoveredPoint: Point<T> | null;
-    hoveredPoints?: Point<T>[];
+    /** Every point drawn as hovered, by pointKey - see useHoveredPointKeys. */
+    hoveredPointKeys: Set<string>;
+    /** Whether every point outside hoveredPointKeys is dimmed - see ChartProps' spotlight. */
+    spotlit: boolean;
+    dimStyle: DimStyle;
     hoverGrowth?: number;
     hoverStroke?: string;
     handleMouseMove: (event: React.MouseEvent<SVGElement>, zoom: ZoomType) => void;
@@ -40,6 +43,6 @@ type ScatterPlotViewportProps<T extends object> = {
     crosshair?: CrosshairPosition | null;
     divRef: React.RefObject<HTMLDivElement | null>;
 };
-declare const ScatterPlotViewport: <T extends object>({ width, height, margin, boundedWidth, boundedHeight, loading, pointData, animation, animationGroupSize, animationBuffer, xScale, yScale, zoom, selectMode, selectable, disableZoom, groupPointsAnchor, hoveredPoint, hoveredPoints, hoverGrowth, hoverStroke, handleMouseMove, handleMouseLeave, onDisplayedPointsChange, onSelectionChange, onPointClicked, leftAxisLabel, bottomAxisLabel, border, originLine, backgroundGradient, crosshair, divRef, }: ScatterPlotViewportProps<T>) => import("react/jsx-runtime").JSX.Element;
+declare const ScatterPlotViewport: <T extends object>({ width, height, margin, boundedWidth, boundedHeight, loading, pointData, animation, animationGroupSize, animationBuffer, xScale, yScale, zoom, selectMode, selectable, disableZoom, hoveredPoint, hoveredPointKeys, spotlit, dimStyle, hoverGrowth, hoverStroke, handleMouseMove, handleMouseLeave, onDisplayedPointsChange, onSelectionChange, onPointClicked, leftAxisLabel, bottomAxisLabel, border, originLine, backgroundGradient, crosshair, divRef, }: ScatterPlotViewportProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default ScatterPlotViewport;
 //# sourceMappingURL=ScatterPlotViewport.d.ts.map

package/dist/src/components/ScatterPlot/ScatterPlotViewport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScatterPlotViewport.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/ScatterPlotViewport.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AASjF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAS5G,KAAK,wBAAwB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7C,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC/E,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;IACzD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,wEAAwE;IACxE,SAAS,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAClD,CAAC;AAeF,QAAA,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,EAAE,4bAkC5C,wBAAwB,CAAC,CAAC,CAAC,4CA4f7B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"ScatterPlotViewport.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/ScatterPlotViewport.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AASjF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAStH,KAAK,wBAAwB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9B,2EAA2E;IAC3E,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,0FAA0F;IAC1F,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC/E,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;IACzD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,wEAAwE;IACxE,SAAS,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAClD,CAAC;AAeF,QAAA,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,EAAE,+bAmC5C,wBAAwB,CAAC,CAAC,CAAC,4CAsd7B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/src/components/ScatterPlot/helpers.d.ts

@@ -1,5 +1,5 @@
 import { ScaleLinear } from '@visx/vendor/d3-scale';
-import { Line, Point, PointShape, TransformMatrix } from './types';
+import { DimStyle, Line, Point, PointShape, TransformMatrix } from './types';
 export declare const rescaleX: (scale: ScaleLinear<number, number, never>, translateX: number, scaleX: number) => ScaleLinear<number, number, never>;
 export declare const rescaleY: (scale: ScaleLinear<number, number, never>, translateY: number, scaleY: number) => ScaleLinear<number, number, never>;
 export declare const invertRescaled: (scale: ScaleLinear<number, number, never>, translate: number, scaleFactor: number, pixel: number) => number;
@@ -64,7 +64,11 @@ export type HoverStyle = {
     stroke: string;
 };
 export declare const DEFAULT_HOVER_STYLE: HoverStyle;
+/** Pale enough to read as background, and translucent so dense patches still show their shape. */
+export declare const DEFAULT_DIM_STYLE: DimStyle;
 export declare const drawCanvasPoint: <T extends object>(context: CanvasRenderingContext2D, point: Point<T>, x: number, y: number, 
 /** How far into its hover growth this point is: 0 at rest, 1 fully hovered. */
-hoverAmount: number, hoverStyle?: HoverStyle) => void;
+hoverAmount: number, hoverStyle?: HoverStyle, 
+/** Draws the point dimmed, in this color and opacity rather than its own. */
+dim?: DimStyle) => void;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/src/components/ScatterPlot/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/helpers.ts"],"names":[],"mappings":"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"}

package/dist/src/components/ScatterPlot/hooks/useHoverTooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHoverTooltip.d.ts","sourceRoot":"","sources":["../../../../../src/components/ScatterPlot/hooks/useHoverTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,KAAK,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC1C,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD;;;;;;;OAOG;IACH,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAWF,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,EAAE,0EAO/C,oBAAoB,CAAC,CAAC,CAAC;;6BA+BsB,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,QAAQ;;CAkE3F,CAAC"}
+{"version":3,"file":"useHoverTooltip.d.ts","sourceRoot":"","sources":["../../../../../src/components/ScatterPlot/hooks/useHoverTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,KAAK,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC1C,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD;;;;;;;OAOG;IACH,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAWF,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,EAAE,0EAO/C,oBAAoB,CAAC,CAAC,CAAC;;6BA+BsB,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,QAAQ;;CAsE3F,CAAC"}

package/dist/src/components/ScatterPlot/hooks/useHoveredPointKeys.d.ts

@@ -0,0 +1,17 @@
+import { Point } from '../types';
+type UseHoveredPointKeysProps<T extends object> = {
+    pointData: Point<T>[];
+    /** The point under the cursor, which wins over hoveredPoints. */
+    hoveredPoint: Point<T> | null;
+    hoveredPoints?: Point<T>[];
+    groupPointsAnchor?: keyof Point<T> | keyof T;
+};
+/**
+ * The keys (see pointKey) of every point drawn as hovered: the point under the cursor if there is
+ * one, otherwise whatever the consumer has asked to highlight, widened to whole groups by
+ * groupPointsAnchor. The cursor takes precedence so the plot's own hover is never overridden
+ * mid-gesture.
+ */
+export declare const useHoveredPointKeys: <T extends object>({ pointData, hoveredPoint, hoveredPoints, groupPointsAnchor, }: UseHoveredPointKeysProps<T>) => Set<string>;
+export {};
+//# sourceMappingURL=useHoveredPointKeys.d.ts.map

package/dist/src/components/ScatterPlot/hooks/useHoveredPointKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHoveredPointKeys.d.ts","sourceRoot":"","sources":["../../../../../src/components/ScatterPlot/hooks/useHoveredPointKeys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjC,KAAK,wBAAwB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC9C,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,iEAAiE;IACjE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,EAAE,gEAKnD,wBAAwB,CAAC,CAAC,CAAC,gBA4C7B,CAAC"}

package/dist/src/components/ScatterPlot/index.d.ts

@@ -3,6 +3,6 @@ import { default as ScatterPlotSync } from './ScatterPlotSync';
 export { ScatterPlot, ScatterPlotSync };
 export { getSharedDomains, getShapePoints } from './helpers';
 export { POINT_SHAPES } from './types';
-export type { MiniMapProps, ChartProps, Point, PointShape, CrosshairPosition, ZoomType } from './types';
+export type { MiniMapProps, ChartProps, Point, PointShape, CrosshairPosition, ZoomType, DimStyle } from './types';
 export type { ScatterPlotSyncProps, SyncedPlotProps } from './ScatterPlotSync';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/components/ScatterPlot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,eAAe,CAAA;AACvC,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvG,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,eAAe,CAAA;AACvC,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACjH,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/src/components/ScatterPlot/minimap.d.ts

@@ -1,4 +1,4 @@
 import { MapProps } from './types';
-declare const MiniMap: <T>({ miniMap, width, height, pointData, xScale, yScale, zoom, crosshair }: MapProps<T>) => import("react/jsx-runtime").JSX.Element;
+declare const MiniMap: <T>({ miniMap, width, height, pointData, xScale, yScale, zoom, crosshair, dimStyle, spotlitKeys, }: MapProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default MiniMap;
 //# sourceMappingURL=minimap.d.ts.map

package/dist/src/components/ScatterPlot/minimap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/minimap.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAUnC,QAAA,MAAM,OAAO,GAAI,CAAC,EAAG,wEASlB,QAAQ,CAAC,CAAC,CAAC,4CA+Lb,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/minimap.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAS,MAAM,SAAS,CAAC;AAW1C,QAAA,MAAM,OAAO,GAAI,CAAC,EAAG,gGAWlB,QAAQ,CAAC,CAAC,CAAC,4CAqMb,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/src/components/ScatterPlot/scatterplot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scatterplot.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/scatterplot.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAoBtD,QAAA,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACvH,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,4CAwO7B,CAAA;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"scatterplot.d.ts","sourceRoot":"","sources":["../../../../src/components/ScatterPlot/scatterplot.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAqBtD,QAAA,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACvH,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,4CAwP7B,CAAA;AAED,eAAe,WAAW,CAAC"}

package/dist/src/components/ScatterPlot/types.d.ts

@@ -68,6 +68,14 @@ export type Point<T> = {
      * 1 (opaque)
      */
     opacity?: number;
+    /**
+     * Fades the point and draws it beneath the rest - one a filter leaves out, say, kept on the plot
+     * because its place means something beside the others. Drawn in the plot's dimStyle in place of
+     * its own color and opacity, and passed over by the hover where a point that isn't dimmed is as near.
+     * @default
+     * false
+     */
+    dimmed?: boolean;
     /**
      * Any and all metadata the user wishes to include with the point.
      * this will be used to display the tooltip on the hover of the point
@@ -219,6 +227,23 @@ export type ChartProps<T, S extends boolean | undefined, Z extends boolean | und
      * highlights the group, and passing the group itself gives the same result.
      */
     hoveredPoints?: Point<T>[];
+    /**
+     * While hoveredPoints is set, dims every other point, so a legend entry's points stand out from
+     * the rest. An empty hoveredPoints dims them all - a colorbar window with nothing in it, say.
+     *
+     * Done in the draw, so moving the highlight doesn't rebuild pointData or restart the hover growth.
+     *
+     * @default
+     * false
+     */
+    spotlight?: boolean;
+    /**
+     * How dimmed points are drawn: those marked `dimmed`, and the rest while spotlit.
+     *
+     * @default
+     * { color: "#BDBDBD", opacity: 0.4 }
+     */
+    dimStyle?: DimStyle;
     /**
      * Radius added to a hovered point, in pixels, eased in over the hover animation.
      *
@@ -357,6 +382,11 @@ export type ChartProps<T, S extends boolean | undefined, Z extends boolean | und
      */
     square?: boolean;
 };
+/** How a dimmed point is drawn, in place of its own color and opacity. */
+export type DimStyle = {
+    color: string;
+    opacity: number;
+};
 export type BackgroundGradient = {
     /** Three-stop color scale [low, mid, high]. Defaults to ["red", "white", "blue"]. */
     colorScale?: [string, string, string];
@@ -383,6 +413,9 @@ export type MapProps<T> = {
     yScale: ScaleLinear<number, number, never>;
     zoom: ZoomType;
     crosshair?: CrosshairPosition | null;
+    dimStyle: DimStyle;
+    /** While spotlit, the keys of the points left undimmed - see ChartProps' spotlight. */
+    spotlitKeys: Set<string> | null;
 };
 export type TooltipProps<T> = {
     tooltipBody?: (point: Point<T>) => ReactElement;