@fundar/data-chart-telling 1.1.0 → 1.3.0

package/dist/plots/utils/segments.js

@@ -1,15 +1,28 @@
-import { resolveAccessor } from './accessors';
+import { resolveAccessor } from '../../utils/accessors';
 import { merge } from '../../utils/merge';
+import { seriesIdOf } from '../../utils/grouping';
+import { FacetPanels } from '../../phases/facet/FacetPanels';
 const DEFAULT_KEY = 'default';
 /**
  * Returns the flat {@link Segment} list for one series.
  * Series-specific segments are added before `'default'` segments so that
  * series-specific catch-alls win over default catch-alls on tie-breaks.
+ * A series split by facet panel also reads the segments its panel was given
+ * for it - under its id - and for every series of the panel - under the
+ * panel's own `'default'` - ahead of the plot's own, as the more specific.
  */
-export function resolveSegmentsForSeries(segments, seriesName) {
-    const specific = segments[seriesName] ?? [];
-    const defaults = segments[DEFAULT_KEY] ?? [];
-    return [...specific, ...defaults];
+export function resolveSegmentsForSeries(segments, series) {
+    const noPanel = series.panel === undefined;
+    const own = noPanel ? [] : (segments[seriesIdOf(series)] ?? []);
+    const panelDefaults = noPanel
+        ? []
+        : (segments[FacetPanels.buildSeriesId(series.panel, DEFAULT_KEY)] ?? []);
+    return [
+        ...own,
+        ...(segments[series.name] ?? []),
+        ...panelDefaults,
+        ...(segments[DEFAULT_KEY] ?? [])
+    ];
 }
 /** Returns true when `xVal` falls inside any of a segment's x ranges. */
 export function matchesSegmentX(xVal, seg) {
@@ -176,7 +189,7 @@ function readChannel(accessor) {
 export function buildGroupedSeries(seriesList, segments = {}, connect = true) {
     return seriesList.map((s) => ({
         series: s,
-        visualSegments: resolveSeriesSegments(s, resolveSegmentsForSeries(segments, s.name), connect)
+        visualSegments: resolveSeriesSegments(s, resolveSegmentsForSeries(segments, s), connect)
     }));
 }
 /**
@@ -193,7 +206,7 @@ export function buildScopedMarkerGroups(args) {
     return groupedSeries.map((group, seriesIndex) => {
         const defaultColor = colorFor(group.series, seriesIndex);
         const xFor = readChannel(group.series.x);
-        const segs = resolveSegmentsForSeries(segments, group.series.name);
+        const segs = resolveSegmentsForSeries(segments, group.series);
         return {
             name: group.series.name,
             ...(group.series.id !== undefined ? { id: group.series.id } : {}),

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

@@ -1,7 +1,9 @@
 import type { StrokeStyle, DotStyle, FontStyle, AreaStyle } from '../plots/styling';
 import type { LineAnchor, SymbolType, TextAnchor } from '../plots/constants';
 import type { PlotChromeEntry } from '../plots/props';
+import type { LegendMark } from '../layout/legend';
 import type { EdgeTicksOptions } from '../layout/scales';
+import type { CurveName } from '../layout/styles/curve';
 export type TextStyle = {
     /** font-family */
     font: string;
@@ -16,12 +18,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 +66,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;
@@ -58,6 +134,13 @@ export type PlotStylesConfig = {
         gap: string;
         /** swatch square size */
         swatchSize: string;
+        /** The icon a discrete legend item draws for its series. */
+        icon: {
+            /** Draws the icons with rounded corners. */
+            rounded: boolean;
+            /** The shape a series icon takes by how the series draws, unless the series sets its own `symbol`. */
+            marks: Record<LegendMark, SymbolType>;
+        };
         /** Fallback opacity for a legend-disabled series/value when a section doesn't set its own style. */
         disabledOpacity: number;
         /**
@@ -95,6 +178,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 +223,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 +232,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 +331,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 +367,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/facet.d.ts

@@ -40,6 +40,24 @@ export type FacetCellContext<TRow extends Record<string, unknown>> = {
 export type FacetCellSnippet<TRow extends Record<string, unknown>> = Snippet<[
     FacetCellContext<TRow>
 ]>;
+/** A facet value as the panel's label reads it: a number or a boolean matches by the text it prints as. */
+export type FacetValue = string | number | boolean;
+/**
+ * The facet panels a segment or a marker applies to. A value, or a list of them, names panels by their
+ * label - the `by` value; in a `rows`/`cols` grid, `{ row, col }` name the panels by the grid's own
+ * values, and a side left out matches every value of it.
+ */
+export type FacetTarget = FacetValue | FacetValue[] | {
+    row?: FacetValue | FacetValue[];
+    col?: FacetValue | FacetValue[];
+};
+/**
+ * A segment or a marker that can be limited to some facet panels. Without `facet` it applies to every
+ * panel, as before; with it, only to the panels it names - and to none of a plot that has no facet.
+ */
+export type FacetScoped = {
+    facet?: FacetTarget;
+};
 export type FacetIndicatorContext = {
     current: number;
     total: number;