@fundar/data-chart-telling 1.1.0 → 1.2.0

package/dist/types/configuration/styling.d.ts

@@ -2,6 +2,7 @@ import type { StrokeStyle, DotStyle, FontStyle, AreaStyle } from '../plots/styli
 import type { LineAnchor, SymbolType, TextAnchor } from '../plots/constants';
 import type { PlotChromeEntry } from '../plots/props';
 import type { EdgeTicksOptions } from '../layout/scales';
+import type { CurveName } from '../layout/styles/curve';
 export type TextStyle = {
     /** font-family */
     font: string;
@@ -16,12 +17,32 @@ export type TextStyle = {
     /** letter-spacing */
     spacing: string;
 };
+/** What the plots that join dots along a category (lollipop, dumbbell, Cleveland) read from their own configuration block. */
+export type DotRangeStyling = {
+    /** Radius of every dot that sets none of its own, in px. */
+    dotRadius: number;
+    /** Whether every connector draws a cap - a short tick across it - at each end, unless `styles.connector.caps` says otherwise. */
+    caps?: boolean;
+    /** Width of every connector that sets none of its own, in px; `'dots'` makes it as thick as the dots are wide, a band. */
+    stemWidth: number | 'dots';
+    /** Color of the connector of a category with several dots; a lone dot's stem takes its series' color. Unset, the axis color. */
+    connectorColor?: string;
+    /** Gap, in px, between a dot and its value label, unless the labels' own `dx`/`dy` set one. */
+    labelGap: number;
+    /** Fallback gap (0-1) between neighbouring categories, when a plot doesn't set its own `scales.x/y.paddingInner`. */
+    paddingInner: number;
+    /** Fallback gap (0-1) before the first and after the last category, when a plot doesn't set its own `scales.x/y.paddingOuter`. */
+    paddingOuter: number;
+};
 /** How a chrome divider's line is drawn, as a CSS border style. */
 export type DividerLineStyle = 'solid' | 'dashed' | 'dotted' | 'double';
 export type PlotStylesConfig = {
     font: string;
     color: string;
     background: string;
+    title: TextStyle;
+    subtitle: TextStyle;
+    caption: TextStyle;
     spacing: {
         headerPadding: string;
         legendPadding: string;
@@ -44,9 +65,63 @@ export type PlotStylesConfig = {
         /** The space between the blocks of a row of the chrome, as a CSS length. */
         rowGap: string;
     };
-    title: TextStyle;
-    subtitle: TextStyle;
-    caption: TextStyle;
+    /** Discrete categorical palette (grouped series). */
+    palette: string[];
+    /** Default shape cycle for the `symbol` channel, in order. */
+    symbols: SymbolType[];
+    /** The default continuous ramp, the on-cell label colour and the default opacity-channel range. */
+    continuous: {
+        /** The ramp's first color, when it is not a named `scheme`. */
+        min: string;
+        /** The ramp's last color, when it is not a named `scheme`. */
+        max: string;
+        /** A named d3-scale-chromatic ramp (`'viridis'`, `'blues'`...), over `min` and `max`. */
+        scheme?: string;
+        /** The part of `scheme` to use, as `[from, to]` fractions of it: `[0.2, 1]` skips the near-white start of `'blues'`. */
+        schemeRange?: [number, number];
+        labelColor: string;
+        opacityRange: [number, number];
+    };
+    /**
+     * Per-side plot margin. `'auto'` (the default) lets svelteplot size that
+     * side to fit whatever it actually renders there - tick labels, an axis
+     * title, rotated ticks - instead of clipping content or leaving unused
+     * space. A number pins that side exactly, opting out of auto-sizing.
+     */
+    margins: {
+        top: number | 'auto';
+        right: number | 'auto';
+        bottom: number | 'auto';
+        left: number | 'auto';
+    };
+    /** Marker clipping to the plot's inner frame (see `FrameClip`). */
+    frameClip: {
+        /**
+         * How far (px) a clipped mark may reach past the frame before it's cut,
+         * so strokes and labels on the edge aren't shaved off. A number sets all
+         * four sides; a string takes CSS shorthand px values for 1-4 sides, e.g.
+         * `'4px'`, `'4px 8px'`, `'0 8px 4px'`, `'0 8px 4px 2px'`.
+         */
+        tolerance: number | string;
+    };
+    axis: {
+        color: string;
+        fontSize: number;
+        labelFontSize: number;
+        titleFontSize: number;
+        xTickSize: number;
+        yTickSize: number;
+        xTickPadding: number;
+        yTickPadding: number;
+        grid: boolean;
+        locale: string;
+        compactDisplay: 'short' | 'long';
+        edgeTicks: {
+            x: EdgeTicksOptions;
+            y: EdgeTicksOptions;
+        };
+        autoRotate: boolean;
+    };
     legend: {
         font: string;
         size: string;
@@ -95,6 +170,17 @@ export type PlotStylesConfig = {
             barHeight: number;
             /** Corner radius (px) of the gradient bar and excluded-range overlays. */
             barRadius: number;
+            /** The bar of an opacity section: one color fading over a checkerboard, so it reads as transparency and not as a color ramp. */
+            opacity: {
+                /** The color that fades, unless the marker it describes draws in one of its own. */
+                color: string;
+                /** The checkerboard behind the bar: its squares' size (px) and two colors. */
+                checker: {
+                    size: number;
+                    light: string;
+                    dark: string;
+                };
+            };
             /** The draggable lo/hi handle. */
             handle: {
                 width: string;
@@ -129,23 +215,6 @@ export type PlotStylesConfig = {
             };
         };
     };
-    axis: {
-        color: string;
-        fontSize: number;
-        labelFontSize: number;
-        titleFontSize: number;
-        xTickSize: number;
-        yTickSize: number;
-        xTickPadding: number;
-        yTickPadding: number;
-        grid: boolean;
-        locale: string;
-        compactDisplay: 'short' | 'long';
-        edgeTicks: {
-            x: EdgeTicksOptions;
-            y: EdgeTicksOptions;
-        };
-    };
     tooltip: {
         background: string;
         color: string;
@@ -155,107 +224,35 @@ export type PlotStylesConfig = {
         border: string;
     };
     /**
-     * Per-side plot margin. `'auto'` (the default) lets svelteplot size that
-     * side to fit whatever it actually renders there - tick labels, an axis
-     * title, rotated ticks - instead of clipping content or leaving unused
-     * space. A number pins that side exactly, opting out of auto-sizing.
+     * In-SVG hover highlight: crosshair rule, dot + value label, and the area
+     * highlight - a restyled feature on `GeoPlot`, or an `areaX`/`areaY` band
+     * on an axis-based plot's band scale.
      */
-    margins: {
-        top: number | 'auto';
-        right: number | 'auto';
-        bottom: number | 'auto';
-        left: number | 'auto';
-    };
-    /** Marker clipping to the plot's inner frame (see `FrameClip`). */
-    frameClip: {
-        /**
-         * How far (px) a clipped mark may reach past the frame before it's cut,
-         * so strokes and labels on the edge aren't shaved off. A number sets all
-         * four sides; a string takes CSS shorthand px values for 1-4 sides, e.g.
-         * `'4px'`, `'4px 8px'`, `'0 8px 4px'`, `'0 8px 4px 2px'`.
-         */
-        tolerance: number | string;
-    };
-    /** Discrete categorical palette (grouped series). */
-    palette: string[];
-    /** Default shape cycle for the `symbol` channel, in order. */
-    symbols: SymbolType[];
-    /** Continuous gradient endpoints + on-cell label colour, plus the default opacity-channel range. */
-    continuous: {
-        min: string;
-        max: string;
-        labelColor: string;
-        opacityRange: [number, number];
+    hover: {
+        rule: StrokeStyle;
+        dot: DotStyle;
+        font: FontStyle;
+        area: AreaStyle;
     };
-    /** Default line geometry. */
-    line: {
-        strokeWidth: number;
-        dotRadius: number;
-        /**
-         * Default gap-fill bridge styling (`LinePlot`'s `styles.gaps`) - the
-         * fallback merged under whatever a gap zone's own `style` sets, the
-         * same way `hover.rule`/`hover.dot` back every hover marker's style.
-         */
-        gap: {
-            stroke: StrokeStyle;
-            dots: DotStyle;
+    facet: {
+        /** Position badge shown in `carousel`/`paginated` facet modes. */
+        indicator: {
+            background: string;
+            color: string;
+            fontSize: string;
+            padding: string;
+            radius: string;
         };
-    };
-    /** Default text-marker behavior. */
-    text: {
-        /** Geometry and connector of a decluttered text marker (`declutter`) - e.g. LinePlot's end-of-line value labels. */
-        declutter: {
-            /** Shortest lane's distance (px) from the point before a connector bends. */
-            elbowGap: number;
-            /** Extra distance (px) each further lane sits out from the last. */
-            laneStep: number;
-            /** Clearance (px) between the outermost lane and the label text. */
-            labelGap: number;
-            /** Default connector stroke. */
-            connector: StrokeStyle;
+        /** Prev/next buttons shown in `paginated` facet mode. */
+        navButton: {
+            background: string;
+            color: string;
+            /** Button diameter (width and height). */
+            size: string;
+            fontSize: string;
+            disabledOpacity: number;
         };
     };
-    /** Default bar-mark styling. */
-    bar: {
-        /** Default gap-fill styling (`BarPlot`'s `styles.gaps`) - the fallback merged under whatever a gap zone's own `style` sets. */
-        gap: AreaStyle;
-        /** Gap (0-1) between the bars of side-by-side series within one category, as a fraction of each bar's slice. */
-        seriesPadding: number;
-        /** Fallback gap (0-1) *between* category groups on BarPlot's own category axis, when a plot doesn't set its own `scales.x/y.paddingInner`. */
-        paddingInner: number;
-        /** Fallback gap (0-1) before the first and after the last category group on BarPlot's own category axis, when a plot doesn't set its own `scales.x/y.paddingOuter`. */
-        paddingOuter: number;
-    };
-    /** Default pyramid-bar styling. */
-    pyramid: {
-        /** Default gap-fill styling (`PyramidPlot`'s `styles.gaps`) - the fallback merged under whatever a gap zone's own `style` sets. */
-        gap: AreaStyle;
-    };
-    /** Default area-plot styling. */
-    area: {
-        /** Fill opacity of every area marker that sets none of its own. */
-        fillOpacity: number;
-    };
-    /** Default histogram styling. */
-    histogram: {
-        /** Pixels taken off each side of every bar, so neighbouring bars leave a gap of twice this. */
-        inset: number;
-        /** Fill opacity of every bar, so a grouped histogram's bars behind another group's still show. */
-        fillOpacity: number;
-    };
-    /** Default box-plot styling. */
-    box: {
-        /** Fill opacity of every box that sets none of its own. */
-        fillOpacity: number;
-        /** Fallback gap (0-1) between the boxes of neighbouring categories, when a plot doesn't set its own `scales.x/y.paddingInner`. */
-        paddingInner: number;
-        /** Fallback gap (0-1) before the first and after the last box, when a plot doesn't set its own `scales.x/y.paddingOuter`. */
-        paddingOuter: number;
-    };
-    /** Default scatter point geometry. */
-    scatter: {
-        dotRadius: number;
-    };
     /** Timeline gutter styling. */
     timeline: {
         axisColor: string;
@@ -326,16 +323,32 @@ export type PlotStylesConfig = {
             };
         };
     };
-    /**
-     * In-SVG hover highlight: crosshair rule, dot + value label, and the area
-     * highlight - a restyled feature on `GeoPlot`, or an `areaX`/`areaY` band
-     * on an axis-based plot's band scale.
-     */
-    hover: {
-        rule: StrokeStyle;
-        dot: DotStyle;
-        font: FontStyle;
-        area: AreaStyle;
+    /** What `styles.connector` falls back to on the plots that join dots (lollipop, dumbbell, Cleveland). */
+    connector: {
+        /** The colors of a connector colored `{ by: 'sign' }`: where the value rose, fell, or did not move. */
+        sign: {
+            positive: string;
+            negative: string;
+            zero: string;
+        };
+        /** The ramp of a connector colored `{ by: 'length' }`: from the shortest to the longest. */
+        lengthScheme: string[];
+        /** The ramp of a connector colored `{ by: 'difference' }`: falling, still, rising, meeting at 0. */
+        differenceScheme: string[];
+        /** Opacity (0-1) of the part of a connector outside the stretch between its `from` and `to` dots. */
+        outsideOpacity: number;
+        /** A connector drawn as an arrow (`styles.connector.arrow`): its thickness, and the length (px) and angle (degrees) of its head. */
+        arrow: {
+            width: number;
+            headLength: number;
+            headAngle: number;
+        };
+        /** The length (px) of the caps a connector draws at its ends (`styles.connector.caps`). */
+        capLength: number;
+        /** Font size of a connector's label, in px. */
+        labelFontSize: number;
+        /** Gap, in px, between a connector and its label when it is written beside it. */
+        labelGap: number;
     };
     /** The `delta` marker's label offset and anchor, per axis the delta is taken on. A marker's own `text` wins. */
     delta: {
@@ -346,28 +359,148 @@ export type PlotStylesConfig = {
             textAnchor: TextAnchor;
         }>;
     };
-    facet: {
-        /** Position badge shown in `carousel`/`paginated` facet modes. */
-        indicator: {
-            background: string;
-            color: string;
-            fontSize: string;
-            padding: string;
-            radius: string;
+    /** Default text-marker behavior. */
+    text: {
+        /** Geometry and connector of a decluttered text marker (`declutter`) - e.g. LinePlot's end-of-line value labels. */
+        declutter: {
+            /** Shortest lane's distance (px) from the point before a connector bends. */
+            elbowGap: number;
+            /** Extra distance (px) each further lane sits out from the last. */
+            laneStep: number;
+            /** Clearance (px) between the outermost lane and the label text. */
+            labelGap: number;
+            /** Default connector stroke. */
+            connector: StrokeStyle;
         };
-        /** Prev/next buttons shown in `paginated` facet mode. */
-        navButton: {
-            background: string;
-            color: string;
-            /** Button diameter (width and height). */
-            size: string;
-            fontSize: string;
-            disabledOpacity: number;
+    };
+    /** Default area-plot styling. */
+    area: {
+        /** Fill opacity of every area marker that sets none of its own. */
+        fillOpacity: number;
+    };
+    /** Default bar-mark styling. */
+    bar: {
+        /** Default gap-fill styling (`BarPlot`'s `styles.gaps`) - the fallback merged under whatever a gap zone's own `style` sets. */
+        gap: AreaStyle;
+        /** Gap (0-1) between the bars of side-by-side series within one category, as a fraction of each bar's slice. */
+        seriesPadding: number;
+        /** Fallback gap (0-1) *between* category groups on BarPlot's own category axis, when a plot doesn't set its own `scales.x/y.paddingInner`. */
+        paddingInner: number;
+        /** Fallback gap (0-1) before the first and after the last category group on BarPlot's own category axis, when a plot doesn't set its own `scales.x/y.paddingOuter`. */
+        paddingOuter: number;
+    };
+    /** Default box-plot styling. */
+    box: {
+        /** Fill opacity of every box that sets none of its own. */
+        fillOpacity: number;
+        /** Fallback gap (0-1) between the boxes of neighbouring categories, when a plot doesn't set its own `scales.x/y.paddingInner`. */
+        paddingInner: number;
+        /** Fallback gap (0-1) before the first and after the last box, when a plot doesn't set its own `scales.x/y.paddingOuter`. */
+        paddingOuter: number;
+    };
+    /** Default bullet-plot styling: a bar over graded ranges, with a tick at its target. */
+    bullet: {
+        /** The bar's thickness (px) across its category band. */
+        barThickness: number;
+        /** The thickness (px) of the bands that grade the value. */
+        rangeWidth: number;
+        /** The colors of those bands, from the smallest to the largest; the last one repeats if there are more bands. */
+        rangeColors: string[];
+        /** The length (px) and thickness of the target tick. */
+        targetLength: number;
+        targetWidth: number;
+        /** The target tick's color; the axis color when unset. */
+        targetColor?: string;
+        /** Padding between category bands, as fractions (0-1) of a band. */
+        paddingInner: number;
+        paddingOuter: number;
+    };
+    /** Default Cleveland-plot styling. */
+    cleveland: DotRangeStyling;
+    /** Default density-plot styling. */
+    density: {
+        /** Fill opacity of every area, so a grouped density's curves behind another group's still show. */
+        fillOpacity: number;
+        /** Stroke width of every curve drawn as a line. */
+        strokeWidth: number;
+    };
+    /** Default dumbbell-plot styling. */
+    dumbbell: DotRangeStyling;
+    /** Default forest-plot styling: the dot is the estimate, the stem its interval. */
+    forest: DotRangeStyling;
+    /** Default histogram styling. */
+    histogram: {
+        /** Pixels taken off each side of every bar, so neighbouring bars leave a gap of twice this. */
+        inset: number;
+        /** Fill opacity of every bar, so a grouped histogram's bars behind another group's still show. */
+        fillOpacity: number;
+    };
+    /** Default line geometry. */
+    line: {
+        /** Curve of every line that sets none (`styles.curve`, a segment's `curve`): `'auto'` joins the points with straight segments, or along the great circle on a projected map. */
+        curve: CurveName | 'auto';
+        strokeWidth: number;
+        dotRadius: number;
+        /**
+         * Default gap-fill bridge styling (`LinePlot`'s `styles.gaps`) - the
+         * fallback merged under whatever a gap zone's own `style` sets, the
+         * same way `hover.rule`/`hover.dot` back every hover marker's style.
+         */
+        gap: {
+            stroke: StrokeStyle;
+            dots: DotStyle;
         };
     };
+    /** Default lollipop-plot styling. */
+    lollipop: DotRangeStyling;
+    /** Default pyramid-bar styling. */
+    pyramid: {
+        /** Default gap-fill styling (`PyramidPlot`'s `styles.gaps`) - the fallback merged under whatever a gap zone's own `style` sets. */
+        gap: AreaStyle;
+    };
+    /** Default scatter point geometry. */
+    scatter: {
+        dotRadius: number;
+    };
+    /** Default slope-plot styling: a line and a dot per series between the positions of its category axis. */
+    slope: {
+        strokeWidth: number;
+        dotRadius: number;
+        /** Space (0-1, as a fraction of the step between positions) left outside the first and last position; the labels' margins grow beyond it. */
+        padding: number;
+    };
+    /** Default sparkline styling: a thin line, and the dot on its last point. */
+    sparkline: {
+        strokeWidth: number;
+        dotRadius: number;
+    };
+    /** Default violin-plot styling. */
+    violin: {
+        /** Fill opacity of every violin that sets none of its own. */
+        fillOpacity: number;
+        /** Fallback gap (0-1) between the violins of neighbouring categories, when a plot doesn't set its own `scales.x/y.paddingInner`. */
+        paddingInner: number;
+        /** Fallback gap (0-1) before the first and after the last violin, when a plot doesn't set its own `scales.x/y.paddingOuter`. */
+        paddingOuter: number;
+        /** Width (px) of the box inside each violin. */
+        boxWidth: number;
+    };
+};
+/**
+ * A categorical palette as `setConfiguration` takes it: a list of colors, or the name of a
+ * d3-scale-chromatic scheme - a color list (`'dark2'`, `'tableau10'`...) or a ramp (`'viridis'`,
+ * `'blues'`...) - or one with its own `count` of colors (8 for a ramp) and `schemeRange`, the part of
+ * the ramp to spread them over (`[0.3, 1]` skips the near-white start of `'blues'`).
+ */
+export type PaletteInput = string[] | string | {
+    scheme: string;
+    count?: number;
+    schemeRange?: [number, number];
 };
 /** Deep-partial input accepted by `setConfiguration`. */
-export type PlotStylesConfigInput = DeepPartial<PlotStylesConfig>;
+export type PlotStylesConfigInput = Omit<DeepPartial<PlotStylesConfig>, 'palette'> & {
+    palette?: PaletteInput;
+};
 type DeepPartial<T> = {
     [K in keyof T]?: T[K] extends (infer U)[] ? U[] : T[K] extends object ? DeepPartial<T[K]> : T[K];
 };

package/dist/types/layout/coordinates.d.ts

@@ -1,6 +1,6 @@
 import type { GeoProjection } from 'd3-geo';
 import type { GeoCameraConfig } from '../plots/camera';
-import type { ChannelScalesConfig, LengthScaleConfig } from './scales';
+import type { ChannelScalesConfig, LengthScaleConfig, RScaleConfig } from './scales';
 /**
  * The projection names svelteplot's `<Plot projection>` accepts as a string
  * (svelteplot itself doesn't export this as a type - defined here so authors
@@ -47,11 +47,12 @@ export type GeoProjectionConfig = GeoProjectionName | {
 /**
  * `scales` prop for GeoPlot - the geo analog of `AxisBasedScalesConfig`. A
  * map has no x/y axis pair (the coordinate system is `coordinates.projection`),
- * so this carries the channels in {@link ChannelScalesConfig} plus `length` -
- * GeoPlot's own plot-wide-only channel (a `vector` marker's magnitude),
- * the geo analog of `AxisBasedScalesConfig.r`.
+ * so this carries the channels in {@link ChannelScalesConfig} plus the two
+ * plot-wide-only ones: `r` (a `dot` marker's size) and `length` (a `vector`
+ * marker's magnitude).
  */
 export type GeoScalesConfig = ChannelScalesConfig & {
+    r?: RScaleConfig;
     length?: LengthScaleConfig;
 };
 /** Wheel/pinch scale gesture only - see `CoordinatesConfig.pan` for drag-to-translate, and `.rotate` for drag-to-spin-the-globe. */

package/dist/types/layout/legend.d.ts

@@ -111,6 +111,8 @@ export type ContinuousInteractiveConfig = {
 export type ContinuousLegendSection = {
     type: 'continuous';
     title?: string;
+    /** The channel the section reads, which tells apart automatic sections that share a title. */
+    channel?: Exclude<LegendChannel, 'series'>;
     columns?: number;
     min: number;
     max: number;
@@ -120,7 +122,7 @@ export type ContinuousLegendSection = {
     scheme?: string | string[];
     /** Splits an array `scheme` into two halves meeting at this value (diverging). */
     pivot?: number;
-    /** Draws the bar in one color (`colorMin`, the text color by default) fading across this opacity range, instead of a color ramp. */
+    /** Draws the bar in one color (`colorMin`, `legend.continuous.opacity.color` by default) fading across this opacity range over a checkerboard, instead of a color ramp. */
     opacity?: [number, number];
     ticks?: number[];
     width?: number;
@@ -135,6 +137,8 @@ export type ContinuousLegendSection = {
 export type SizeLegendSection = {
     type: 'size';
     title?: string;
+    /** The channel the section reads, which tells apart automatic sections that share a title. */
+    channel?: Exclude<LegendChannel, 'series'>;
     columns?: number;
     domain: [number, number];
     range: [number, number];
@@ -157,6 +161,8 @@ export type SizeLegendSection = {
 export type SymbolLegendSection = {
     type: 'symbol';
     title?: string;
+    /** The channel the section reads, which tells apart automatic sections that share a title. */
+    channel?: Exclude<LegendChannel, 'series'>;
     columns?: number;
     /** Item flow direction, as in a discrete section. */
     layout?: LegendItemsLayout;
@@ -247,8 +253,8 @@ export type LegendEntry = {
 export type MarkLegend = string | (Omit<LegendItem, 'name' | 'disabled'> & {
     label: string;
 });
-/** What a legend reads each automatic section from: the series, or the channel a scale encodes. */
-export type LegendChannel = 'series' | 'color' | 'opacity' | 'size' | 'symbol';
+/** What a legend reads each automatic section from: the series, or the channel a scale encodes - named as the plot's own prop (`r` for sizes). */
+export type LegendChannel = 'series' | 'color' | 'opacity' | 'r' | 'symbol';
 /**
  * How to adjust one automatic section: its own configuration, minus what the
  * plots compute for it. An entry with a `match` (one, or several in a list) adjusts
@@ -289,7 +295,7 @@ export type LegendExtension = {
     series?: Omit<DiscreteLegendSection, 'type' | 'items'>;
     color?: ColorOverride | ColorOverride[];
     opacity?: LegendOverride<ContinuousLegendSection, 'min' | 'max' | 'colorMin' | 'colorMax' | 'scheme' | 'pivot' | 'opacity' | 'interactive'>;
-    size?: LegendOverride<SizeLegendSection, 'domain' | 'range' | 'color' | 'filled' | 'symbol'>;
+    r?: LegendOverride<SizeLegendSection, 'domain' | 'range' | 'color' | 'filled' | 'symbol'>;
     symbol?: LegendOverride<SymbolLegendSection, 'items' | 'color' | 'filled'>;
 };
 /** A segment or marker as the legend reads it: whether it names itself, the channels it draws with and the colors it draws in. */
@@ -306,7 +312,7 @@ export type LegendSource = {
         opacity?: OpacityScaleConfig;
         symbol?: SymbolScaleConfig;
     };
-    legend?: MarkLegend;
+    legend?: MarkLegend | false;
     fill?: unknown;
     stroke?: unknown;
     styles?: {
@@ -322,12 +328,22 @@ export type LegendSource = {
 export type LegendPlot = {
     resolvedSeries?: {
         name: string;
+        data?: unknown[];
     }[];
     colorForSeries?: (name: string) => string;
     markers?: LegendSource[];
     segments?: Record<string, LegendSource[] | undefined>;
     /** The `[min, max]` a plot-level color ramp spans, when the plot has no `color` channel to read it from. */
     colorDomain?: [number, number];
+    /** The ramps of the segments that set their own color scale, each over its own features' values. */
+    colorRamps?: {
+        name: string;
+        domain: [number, number];
+        scale: {
+            scheme?: unknown;
+            pivot?: number;
+        };
+    }[];
     /** The `[min, max]` of a plot-level numeric `opacity` channel. */
     opacityDomain?: [number, number];
     channels?: {

package/dist/types/layout/plot.d.ts

@@ -1,7 +1,12 @@
 import type { Snippet } from 'svelte';
 import type { TimeValue } from './timeline';
 import type { GridPlacement } from './grid';
-import type { MarginConfig, TooltipConfig } from '../plots/props';
+import type { MarginConfig, TooltipConfig, HoverConfig as PlotHoverConfig } from '../plots/props';
+import type { Margins as MarginsType } from '../../layout/margins/Margins';
+import type { EdgeBox } from './box';
+import type { StylesLayoutConfig } from './styles';
+import type { HoverPosition } from '../phases';
+import type { PlotAxes } from '../../phases/data/PlotAxes';
 /** Where one cell sits among the slices: the timeline step and the facet it shows. */
 export type SlicePlace = {
     time?: TimeValue;
@@ -39,3 +44,41 @@ export type PlotCoreBase = GridPlacement & {
     scales?: object;
     margins?: MarginConfig;
 };
+/**
+ * What `BasePlotLayout` draws from: the end of a plot's pipeline. An axis
+ * kind's state is one as is; GeoPlot builds its own.
+ */
+export type PlotLayoutState = {
+    /** What the pointer can match, and how the hover reads. */
+    hover?: PlotHoverConfig<any>;
+    /** Where each row sits, for hover matching and the plot's scales. */
+    hoverPosition?: HoverPosition;
+    /** The rows the plot draws and hovers over. */
+    hoverRows?: unknown[];
+    /** The plot's x/y/r/length scales, and the scales a marker without its own inherits. */
+    scales?: object;
+    /** The axes whose domain the plot kind fit itself rather than the author pinned. */
+    fittedAxes?: string[];
+    /** What the plot's position channels are and which way it runs, for what draws inside it. */
+    axes?: PlotAxes;
+    /** The plot's channels as given, whose field titles an axis with no rows. */
+    channels?: Record<string, {
+        source?: unknown;
+    } | undefined>;
+    /** Every marker the pipeline resolved. */
+    markers?: object[];
+    /** All resolved series - axis kinds only. */
+    resolvedSeries?: object[];
+    /** Each series' color, by name - axis kinds only. */
+    colorForSeries?: (name: string) => string;
+    /** Per-series marker groups - axis kinds only. */
+    scopedGroups?: object[];
+    /** The plot's `styles`: its frame and, on a map, its tile layer. */
+    styles?: StylesLayoutConfig;
+    /** What an `'auto'` margin side reads as. Defaults to {@link Margins.AXIS_ESTIMATE}. */
+    marginEstimate?: MarginsType;
+    /** The plot's value labels, whose `reach` is the room the margins start from. */
+    valueLabels?: {
+        reach: EdgeBox[];
+    };
+};