@fundar/data-chart-telling 1.0.0 → 1.2.0

package/dist/types/markers/axis/image.d.ts

@@ -1,6 +1,7 @@
+import type { CommonMarkerConfigWithRowOffset } from '../channels/commonMarkerConfigWithRowOffset';
 import type { CommonMarkerConfigWithRadius } from '../channels/commonMarkerConfigWithRadius';
 /** An image per row, centered on `x`/`y` (svelteplot's `Image`). */
-export type ImageMarkerConfig = {
+export type ImageMarkerConfig = CommonMarkerConfigWithRowOffset<{
     type: 'image';
     src: string | ((d: any) => string);
     width?: number | ((d: any) => number);
@@ -9,4 +10,4 @@ export type ImageMarkerConfig = {
     preserveAspectRatio?: string;
     /** A constant opacity; the shared `opacity` channel is a color ramp, not this. */
     opacity?: number;
-} & Omit<CommonMarkerConfigWithRadius, 'opacity'>;
+} & Omit<CommonMarkerConfigWithRadius, 'opacity'>>;

package/dist/types/markers/axis/line.d.ts

@@ -1,7 +1,9 @@
 import type { StrokeStyle } from '../../plots/styling';
+import type { CurveName } from '../../layout/styles/curve';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
 /** A single line-segment stroke; `color` strokes each `grouping`'s line in its own color. */
 export type LineMarkerConfig = {
     type: 'line';
+    curve?: CurveName;
     styles?: StrokeStyle;
 } & CommonMarkerConfigWithColor;

package/dist/types/markers/axis/rule.d.ts

@@ -11,5 +11,14 @@ export type RuleMarkerConfig = {
     insetBottom?: number;
     insetLeft?: number;
     insetRight?: number;
+    /**
+     * A stroke color for each row - a field key or a function of the row - drawn
+     * as it is, not mapped through a color scale. Wins over `styles.stroke`.
+     */
+    stroke?: string | ((d: any) => string | undefined);
+    /** A stroke width for each row - a field key or a function of the row. Wins over `styles.strokeWidth`. */
+    strokeWidth?: string | ((d: any) => number);
+    /** A stroke opacity for each row - a field key or a function of the row - drawn as it is. Wins over `styles.strokeOpacity`. */
+    strokeOpacity?: string | ((d: any) => number);
     styles?: StrokeStyle;
 } & CommonMarkerConfigWithInterval;

package/dist/types/markers/axis/trail.d.ts

@@ -1,14 +1,13 @@
 import type { AreaStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
 import type { CommonMarkerConfigWithRadius } from '../channels/commonMarkerConfigWithRadius';
-import type { MarkerCurveName } from './curveName';
+import type { CurveName } from '../../layout/styles/curve';
 /** A variable-width ribbon following a path (svelteplot's `Trail`), its width set by `r`. */
 export type TrailMarkerConfig = {
     type: 'trail';
-    curve?: MarkerCurveName;
+    curve?: CurveName;
     tension?: number;
     cap?: 'butt' | 'round';
     resolution?: number | 'auto';
-    /** A trail is filled only; svelteplot's `Trail` has no stroke. */
     styles?: Pick<AreaStyle, 'fill' | 'fillOpacity'>;
 } & CommonMarkerConfigWithRadius & CommonMarkerConfigWithColor;

package/dist/types/markers/axis/violin.d.ts

@@ -0,0 +1,25 @@
+import type { AreaStyle } from '../../plots/styling';
+import type { DensityKernel } from '../../transforms/density';
+import type { CommonMarkerConfig } from '../channels/commonMarkerConfig';
+/**
+ * A violin per category of its rows: their density estimate mirrored around the
+ * middle of the category's band; a `box` marker over the same rows draws the box inside. `x` and `y` are the
+ * category and the value, in either order.
+ */
+export type ViolinMarkerConfig = {
+    type: 'violin';
+    /** Kernel shape of the estimate. */
+    kernel?: DensityKernel;
+    /** Kernel bandwidth in data units; Silverman's rule picks one per violin when unset. */
+    bandwidth?: number;
+    /** Cuts each violin at its values' own extent. Defaults to `true`. */
+    trim?: boolean;
+    /** The density that reaches a violin's full width; each violin's own peak when unset. */
+    peak?: number;
+    /** The share of each band the violin takes, when several series sit side by side: its index among `count`. */
+    slot?: {
+        index: number;
+        count: number;
+    };
+    styles?: AreaStyle;
+} & CommonMarkerConfig;

package/dist/types/markers/basic/dot.d.ts

@@ -1,9 +1,10 @@
 import type { DotStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
 import type { CommonMarkerConfigWithRadius } from '../channels/commonMarkerConfigWithRadius';
+import type { CommonMarkerConfigWithRowOffset } from '../channels/commonMarkerConfigWithRowOffset';
 import type { CommonMarkerConfigWithSymbol } from '../channels/commonMarkerConfigWithSymbol';
 /** A point mark (svelteplot's `Dot`), usable on any plot kind. */
-export type DotMarkerConfig = {
+export type DotMarkerConfig = CommonMarkerConfigWithRowOffset<{
     type: 'dot';
     styles?: DotStyle;
-} & CommonMarkerConfigWithRadius & CommonMarkerConfigWithColor & CommonMarkerConfigWithSymbol;
+} & CommonMarkerConfigWithRadius & CommonMarkerConfigWithColor & CommonMarkerConfigWithSymbol>;

package/dist/types/markers/basic/text.d.ts

@@ -1,7 +1,9 @@
 import type { FontStyle, StrokeStyle } from '../../plots/styling';
 import type { CommonMarkerConfig } from '../channels/commonMarkerConfig';
+import type { CommonMarkerConfigWithRowOffset } from '../channels/commonMarkerConfigWithRowOffset';
 import type { Margins } from '../../../layout/margins/Margins';
 import type { BandSlice } from '../../layout/hover';
+import type { TextAnchor } from '../../plots/constants';
 /**
  * Spreads labels that would overlap apart vertically, all reaching out to one
  * shared column, each routed back to its own point by an elbow connector.
@@ -14,14 +16,20 @@ export type TextDeclutterConfig = {
     laneStep?: number;
     /** Clearance (px) between the outermost lane and the label text. */
     labelGap?: number;
+    /** Routes every label out to the shared column through a connector, even when none of them overlaps. */
+    aligned?: boolean;
+    /** Whether a leftward fan with no room before the content box flips to the right. Defaults to `true`; labels meant for the margin there turn it off. */
+    flip?: boolean;
     /** The connectors' stroke. Unset opacity follows each label's own `fillOpacity`. */
     connector?: StrokeStyle;
 };
 /** A text label per row (svelteplot's `Text`), usable on any plot kind. */
-export type TextMarkerConfig = {
+export type TextMarkerConfig = CommonMarkerConfigWithRowOffset<{
     type: 'text';
     text: string | ((d: any) => string);
     styles?: FontStyle;
+    /** Which side of its point the text sits on: a value, or a function of the row. Wins over `styles.textAnchor`. */
+    textAnchor?: TextAnchor | ((d: any) => TextAnchor);
     /** Per-row fill, over `styles.fill`. */
     fill?: string | ((d: any) => string | undefined);
     /** Per-row fill opacity. */
@@ -31,11 +39,13 @@ export type TextMarkerConfig = {
     /**
      * Flips each label to the other side of its point (or nudges a centred one
      * back in) where its text would cross the plot's edge. `styles.textAnchor`/
-     * `lineAnchor` are the preferred sides, `styles.dx`/`dy` the gap from the point.
+     * `lineAnchor` are the preferred sides, `dx`/`dy` (else `styles.dx`/`dy`) the gap from the point.
      */
     edgeAware?: boolean;
     /** The slice of its category band each label sits in (a grouped bar's series); it is drawn off the band's middle, whatever the band's width. */
     bandSlice?: BandSlice;
+    /** Where, in the plot's frame, a label sits on an axis it sets no position for: `{ type: 'text', x: 5, frameAnchor: 'top' }` is at the frame's top edge. */
+    frameAnchor?: 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'middle';
     /** Grows the plot's margins, on every side the author left open, so the labels fit. */
     fitMargins?: boolean;
     /** Reports how far the rendered labels reach past the plot's content box, in pixels, on each side. */
@@ -44,7 +54,7 @@ export type TextMarkerConfig = {
     onPointerEnter?: (d: any) => void;
     /** Fired when the pointer leaves a row's label. */
     onPointerLeave?: (d: any) => void;
-} & CommonMarkerConfig;
+} & CommonMarkerConfig>;
 /** Where one decluttered label goes - see `Declutter.buildLanes`. */
 export type LabelLane = {
     /** Vertical shift (px) clearing its neighbours and the content box's edges. */

package/dist/types/markers/channels/commonMarkerConfig.d.ts

@@ -3,7 +3,7 @@ import type { AxisValue } from '../../layout/mapping';
 import type { StatisticConfig } from '../../layout/statistics';
 import type { MarkerTransform } from '../../transforms';
 import type { MarkLegend } from '../../layout/legend';
-/** Props every marker kind shares: rows, grouping, series scope, position, statistics, transforms. */
+/** Props every marker kind shares: rows, grouping, series scope, position, offset, statistics, transforms. */
 export type CommonMarkerConfig = {
     data?: Record<string, unknown>[];
     grouping?: string | ((d: any) => unknown);
@@ -19,8 +19,12 @@ export type CommonMarkerConfig = {
     scales?: ChannelScalesConfig;
     statistics?: StatisticConfig[];
     transforms?: MarkerTransform[];
+    /** Moves the marker this many pixels right, after it is placed. Also applies on a map, where svelteplot itself ignores it. */
+    dx?: number;
+    /** Moves the marker this many pixels down, after it is placed. */
+    dy?: number;
     /** Clips the marker to the plot's frame. Unset, its kind's default applies. */
     clip?: boolean;
-    /** Names the marker on its plot's automatic legend - see {@link MarkLegend}. */
-    legend?: MarkLegend;
+    /** Names the marker on its plot's automatic legend - see {@link MarkLegend}. `false` keeps a decorative marker out of it, and out of how the plot's series look there. */
+    legend?: MarkLegend | false;
 };

package/dist/types/markers/channels/commonMarkerConfigWithRowOffset.d.ts

@@ -0,0 +1,13 @@
+/** A pixel offset: one for the whole marker, or one per row. */
+export type RowOffset = number | ((d: any) => number);
+/**
+ * `TConfig` with `dx` and `dy` that may also be a function of the row, for a
+ * marker that draws one element per row (a dot, a label, an image). Every other
+ * marker takes the plain numbers of `CommonMarkerConfig`.
+ */
+export type CommonMarkerConfigWithRowOffset<TConfig> = Omit<TConfig, 'dx' | 'dy'> & {
+    /** Moves each row this many pixels right: a number, or a function of the row. */
+    dx?: RowOffset;
+    /** Moves each row this many pixels down: a number, or a function of the row. */
+    dy?: RowOffset;
+};

package/dist/types/markers/common.d.ts

@@ -1,4 +1,3 @@
-export type { MarkerCurveName } from './axis/curveName';
 export * from './axis/line';
 export * from './axis/bar';
 export * from './axis/cell';
@@ -21,6 +20,7 @@ export * from './axis/raster';
 export * from './axis/tick';
 export * from './axis/trail';
 export * from './axis/waffle';
+export * from './axis/violin';
 export * from './axis/rule';
 export * from './axis/hover';
 export * from './axis/component';

package/dist/types/markers/common.js

@@ -20,6 +20,7 @@ export * from './axis/raster';
 export * from './axis/tick';
 export * from './axis/trail';
 export * from './axis/waffle';
+export * from './axis/violin';
 export * from './axis/rule';
 export * from './axis/hover';
 export * from './axis/component';

package/dist/types/markers/geo/link.d.ts

@@ -1,6 +1,6 @@
 import type { Accessor } from '../../plots/data/common';
 import type { StrokeStyle } from '../../plots/styling';
-/** Lines between point pairs (svelteplot's `Link`); `curve: 'auto'` traces great-circle arcs. */
+/** Lines between point pairs: `curve: 'auto'` traces great-circle arcs, `'linear'` joins their projected positions with a straight line. */
 export type GeoLinkMarkerConfig<TRow extends Record<string, unknown> = Record<string, unknown>> = {
     type: 'link';
     data: TRow[];
@@ -9,5 +9,9 @@ export type GeoLinkMarkerConfig<TRow extends Record<string, unknown> = Record<st
     x2: Accessor<TRow, number>;
     y2: Accessor<TRow, number>;
     curve?: 'auto' | 'linear';
+    /** Lifts each arc off the map: a fraction of the radius on a globe, of the route's length on a flat map. A lifted arc keeps near its parallels instead of following the great circle. */
+    altitude?: number;
+    /** On a globe with `altitude`: `'ground'` cuts an arc where its ground track passes the horizon, `'globe'` only where the globe covers it. */
+    occlusion?: 'ground' | 'globe';
     styles?: StrokeStyle;
 };

package/dist/types/phases/hover/phase.d.ts

@@ -17,6 +17,12 @@ export type HoverStageOptions<TState, TCtx = unknown> = {
      * that isn't measured, or `'punctual'` with both axes holding categories.
      */
     strategy?: HoverStrategy;
+    /** The rows the pointer hovers over, when they aren't the ones drawn (a box plot's one summary per box). Defaults to the processed rows. */
+    rows?: (state: TState) => Record<string | symbol, unknown>[];
+    /** How a hovered row reads in the tooltip unless the author sets `format`. Defaults to the shared tooltip text. */
+    format?: (state: TState) => (row: never) => string;
+    /** The order a tooltip's rows read in. Defaults to the shared order: highest value first. */
+    sort?: (state: TState) => (a: never, b: never) => number;
     /** Where a row sits. Defaults to its processed position: a stacked row's top, a bin's centre. */
     position?: (state: TState) => HoverPosition;
     /** The short label drawn next to a hovered row. Defaults to its value. */

package/dist/types/phases/index.d.ts

@@ -7,7 +7,7 @@ export type { MappingStageOptions } from './mapping/phase';
 export type { ProcessedRow, ProcessedChannel, ProcessedChannelName, ProcessedData, TransformsStageState, TransformsStageOptions } from './transforms/phase';
 export type { StatisticsStageState, StatisticsStageOptions } from './statistics/phase';
 export type { SharedAxisValues } from './sharedScales/phase';
-export type { ScalesStageOptions } from './scales/phase';
+export type { AxisFit, ScalesStageOptions } from './scales/phase';
 export type { StylesStageOptions, ValueLabelsOptions } from './styles/phase';
 export type { MarkersStageOptions } from './markers/phase';
 export type { FacetPanel, FacetStageState } from './facet/phase';

package/dist/types/phases/scales/phase.d.ts

@@ -3,6 +3,10 @@ import type { AxisRef } from '../data/axes';
 import type { AxisScale } from '../../layout/scales';
 /** One axis' scale options, whatever the row type. */
 type AnyAxisScale = AxisScale<any>;
+/** What a kind fits to an axis: scale options, and whether its `domain` is one it computed (so the author did not pin it). */
+export type AxisFit = Partial<AnyAxisScale> & {
+    fitted?: true;
+};
 /**
  * What differs between plots in the shared "scales" stage. The stage lays out
  * every category axis the kind asks for as a band and grows an unpinned
@@ -19,7 +23,7 @@ export type ScalesStageOptions<TState, TCtx> = {
     /** The kind's own options for an axis, by name or by role, under the author's `scales`: padding, label anchor, tick format. */
     defaults?: (state: TState, ctx: TCtx) => Partial<Record<AxisRef, AnyAxisScale>>;
     /** The options the kind fits to its own marks on an axis the author left unpinned - a niced value axis, a domain padded for its dots. */
-    fit?: (state: TState, ctx: TCtx) => Partial<Record<AxisChannelName, Partial<AnyAxisScale>>>;
+    fit?: (state: TState, ctx: TCtx) => Partial<Record<AxisChannelName, AxisFit>>;
     /** The kind's own extra "scales" output, once every scale is in place. */
     extend?: (state: TState, ctx: TCtx) => TState;
 };

package/dist/types/phases/state.d.ts

@@ -1,17 +1,17 @@
-import type { Series } from '../plots/data/common';
+import type { Accessor, Series } from '../plots/data/common';
 import type { AxisBasedScalesConfig } from '../layout/scales';
 import type { SegmentsConfig, MarginConfig, HoverConfig, TooltipConfig } from '../plots/props';
 import type { HoverPosition } from './hover/phase';
 import type { VisualGroup } from '../plots/segments/config';
 import type { ScopedMarkerGroup } from '../layout/geometry';
-import type { ChannelAccessors, ResolvedChannels } from '../layout/mapping';
+import type { AxisChannelName, ChannelAccessors, ResolvedChannels } from '../layout/mapping';
 import type { PlotStylesConfig } from '../configuration/styling';
 import type { AxisBasedMarkersConfig } from '../markers/common';
 import type { StatisticConfig } from '../layout/statistics';
 import type { MarkerTransform } from '../transforms';
-import type { ProcessedData } from './transforms/phase';
+import type { ProcessedData, ProcessedRow } from './transforms/phase';
 import type { FacetStageState } from './facet/phase';
-import type { AxisBasedStylesConfig, ValuesStyle } from '../layout/styles';
+import type { AxisBasedStylesConfig, ValuesStyle, ValueSelect } from '../layout/styles';
 import type { ValueLabels } from '../../layout/styles/ValueLabels';
 import type { PlotInteraction } from '../../layout/interaction/PlotInteraction.svelte';
 import type { PlotAxes } from '../../phases/data/PlotAxes';
@@ -27,12 +27,21 @@ export type AxisPlotState<TData extends Record<string, unknown>, TStyle extends
     data?: TData[];
     segments?: SegmentsConfig<TStyle>;
     scales: AxisBasedScalesConfig<TData>;
+    /** The axes whose domain the "scales" phase left to the kind's own fit, not the author's `domain`. */
+    fittedAxes?: AxisChannelName[];
     statistics?: StatisticConfig[];
     transforms?: MarkerTransform[];
     authorMarkers?: AxisBasedMarkersConfig[];
     width: number;
     height: number;
     margins?: MarginConfig;
+    /** The interval a point stands for, on the plots that draw one (`ForestPlot`): its lower and upper end, or the half-width around it, each a field key or a function of the row. */
+    lower?: Accessor<TData, unknown>;
+    upper?: Accessor<TData, unknown>;
+    error?: Accessor<TData, unknown>;
+    /** What a bar is measured against, on the plots that draw it (`BulletPlot`): a target, and the upper bounds of the bands grading it. Each is a number, a field key or a function of the row. */
+    target?: unknown;
+    ranges?: unknown[];
     /** The plot's `styles`, which `BasePlotLayout` draws its frame from. */
     styles?: AxisBasedStylesConfig;
     /** The plot's `styles.values`, which its "markers" phase turns into a value-label `text` marker. */
@@ -48,6 +57,7 @@ export type AxisPlotState<TData extends Record<string, unknown>, TStyle extends
     /** What each position channel is, which one holds the categories, and which way the plot runs. */
     axes?: PlotAxes;
     resolvedSeries?: TSeries[];
+    seriesGrouping?: Accessor<any, unknown>;
     /** Every series name, before legend-omitted ones are dropped, so colors stay put. */
     allSeriesNames?: string[];
     groupedSeries?: VisualGroup<TSeries, TStyle>[];
@@ -58,9 +68,15 @@ export type AxisPlotState<TData extends Record<string, unknown>, TStyle extends
     gapFillMaps?: Map<string, Map<TData, DiscreteGapFill<TStyle>>>;
     channels?: ResolvedChannels<TData>;
     processedData?: ProcessedData;
+    processedGroups?: VisualGroup<Series<ProcessedRow>, TStyle>[];
+    /** The processed rows `styles.values` writes labels for, when the labels are on and the plot picks them. */
+    labelled?: ProcessedRow[];
+    /** What `styles.values.select` came to - the author's, else the plot's default. */
+    labelSelects?: ValueSelect[];
     valueLabels?: ValueLabels;
     markers?: AxisBasedMarkersConfig[];
     tooltipFormat?: (row: Record<string, unknown>) => string;
+    tooltipSort?: (a: Record<string, unknown>, b: Record<string, unknown>) => number;
     hover?: HoverConfig<any>;
     hoverPosition?: HoverPosition;
     hoverRows?: unknown[];

package/dist/types/phases/statistics/phase.d.ts

@@ -3,7 +3,7 @@ import type { Accessor, Series } from '../../plots/data/common';
 import type { AxisValue } from '../../layout/mapping';
 import type { StatisticConfig } from '../../layout/statistics';
 import type { AxisBasedMarkersConfig } from '../../markers/common';
-import type { ProcessedData } from '../transforms/phase';
+import type { ProcessedData, TransformsStageState } from '../transforms/phase';
 import type { FacetStageState } from '../facet/phase';
 import type { PlotAxes } from '../../../phases/data/PlotAxes';
 /**
@@ -25,6 +25,8 @@ export type StatisticsStageState = Pick<FacetStageState, 'panels'> & {
     scopedGroups?: ScopedMarkerGroup<any>[];
     /** The plot's rows after its own transforms, which an author marker without rows of its own draws. */
     processedData?: ProcessedData;
+    /** Those rows split back into the plot's visual groups, which a series without a value of its own (a histogram's) is measured by. */
+    processedGroups?: TransformsStageState['processedGroups'];
     markers?: AxisBasedMarkersConfig[];
 };
 /** What differs between plots in the shared "statistics" stage. */

package/dist/types/phases/statistics/source.d.ts

@@ -1,4 +1,4 @@
-import type { AxisValue } from '../../layout/mapping';
+import type { AxisChannelName, AxisValue } from '../../layout/mapping';
 /**
  * Resolved `{data, x, y}` input a statistic computes over - a marker's own
  * data, or one plot series/the pooled combination of every series. `x`/`y`
@@ -8,6 +8,8 @@ export type StatisticSource<T extends Record<string, unknown> = Record<string, u
     data: T[];
     x: string | ((d: any) => AxisValue);
     y: string | ((d: any) => AxisValue);
+    /** The axis the plot measures along, which a statistic of the values (`deviation`) reads. Defaults to `y`. */
+    axis?: AxisChannelName;
     /** Fallback stroke for the derived marker, used when its own `styles.stroke` is unset - typically the source series' own color. */
     color?: string;
 };

package/dist/types/phases/transforms/phase.d.ts

@@ -1,6 +1,8 @@
 import type { Series } from '../../plots/data/common';
 import type { MarkerTransform } from '../../transforms';
 import type { PlotAxes } from '../../../phases/data/PlotAxes';
+import type { VisualGroup } from '../../plots/segments/config';
+import type { ValuesStyle, ValueSelect } from '../../layout/styles';
 /** A row the plot-level transforms produced: the source row's fields, plus whatever channels they add (often symbol-keyed). */
 export type ProcessedRow = Record<string | symbol, unknown>;
 /** A channel as svelteplot reads it off a processed row: a field key, a symbol key, or a function. */
@@ -32,9 +34,39 @@ export type TransformsStageState = {
     }>>;
     transforms?: MarkerTransform[];
     processedData?: ProcessedData;
+    /** The plot's `styles.values`, which picks the rows its labels are written for. */
+    values?: ValuesStyle;
+    /** The processed rows `styles.values` labels, once the labels are on and the plot picks them (see {@link TransformsStageOptions.labels}). */
+    labelled?: ProcessedRow[];
+    /** What `styles.values.select` came to - the author's, else the plot's default - which says where the labelled rows can sit. */
+    labelSelects?: ValueSelect[];
+    /** The processed rows split back into the visual groups the plot's own marks draw. */
+    processedGroups?: VisualGroup<Series<ProcessedRow>, any>[];
 };
 /** What differs between plots in the shared "transforms" stage. */
 export type TransformsStageOptions<TState extends TransformsStageState, TCtx> = {
     /** The transforms to run. Defaults to the plot's own `transforms`. */
     transforms?: (state: TState, ctx: TCtx) => MarkerTransform[];
+    /**
+     * How the processed rows split into `processedGroups`: one group per series
+     * (the default), or `'runs'` of consecutive rows from the same series, in
+     * the rows' own order, so a reordering transform (`sort`, `reverse`,
+     * `shuffle`) decides which rows paint on top.
+     */
+    groups?: 'series' | 'runs';
+    /**
+     * The plot picks the rows its value labels are written for, when the labels
+     * are on: `styles.values.select` and `series` run as transforms over the
+     * processed rows, into `labelled`.
+     */
+    labels?: {
+        /** Picks the rows even when `styles.values.show` is unset: for a plot that shows its values by default. */
+        show?: boolean;
+        /** The rows picked when `styles.values.select` is unset. Defaults to every row. */
+        select?: ValueSelect | ValueSelect[];
+        /** What a selector picks among: each series (the default), or each category. */
+        group?: 'series' | 'category';
+        /** A test for the rows that cannot be labelled (a gap), read off the state once. */
+        skip?: (state: TransformsStageState) => (row: ProcessedRow) => boolean;
+    };
 };

package/dist/types/plots/{heatmap → correlation/heatmap}/props.d.ts

@@ -1,9 +1,9 @@
-import type { BasePlotProps, PlotCoreProps } from '../props';
-import type { AxisBasedScalesConfig } from '../../layout/scales';
-import type { AxisBasedMarkersConfig } from '../../markers/common';
-import type { SeriesProps, DataProps } from '../data/common';
-import type { AxisBasedStylesConfig } from '../../layout/styles';
-import type { CellSegmentStyle } from '../segments/common';
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { AxisBasedStylesConfig } from '../../../layout/styles';
+import type { CellSegmentStyle } from '../../segments/common';
 /** `HeatmapPlot`'s public props. */
 export type HeatmapPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DataProps<TData>, TData, AxisBasedStylesConfig, CellSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `HeatmapPlot`'s core draws from. */

package/dist/types/plots/{heatmap → correlation/heatmap}/state.d.ts

@@ -1,7 +1,7 @@
-import type { CellSegmentStyle } from '../segments/common';
-import type { ResolvedChannel, ResolvedChannels } from '../../layout/mapping';
-import type { LegendRange } from '../../layout/legend';
-import type { AxisPlotState, AxisPlotCtx } from '../../phases';
+import type { CellSegmentStyle } from '../../segments/common';
+import type { ResolvedChannel, ResolvedChannels } from '../../../layout/mapping';
+import type { LegendRange } from '../../../layout/legend';
+import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
 /**
  * The active continuous-legend range filter, if any - narrows which cells
  * render at full opacity, and in `'rescale'` mode, the color domain itself.

package/dist/types/plots/{scatter → correlation/scatter}/props.d.ts

@@ -1,9 +1,9 @@
-import type { BasePlotProps, PlotCoreProps } from '../props';
-import type { AxisBasedScalesConfig } from '../../layout/scales';
-import type { AxisBasedMarkersConfig } from '../../markers/common';
-import type { SeriesProps, DataProps } from '../data/common';
-import type { AxisBasedStylesConfig } from '../../layout/styles';
-import type { ScatterSegmentStyle } from '../segments/common';
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { AxisBasedStylesConfig } from '../../../layout/styles';
+import type { ScatterSegmentStyle } from '../../segments/common';
 /** `ScatterPlot`'s public props. */
 export type ScatterPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DataProps<TData>, TData, AxisBasedStylesConfig, ScatterSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `ScatterPlot`'s core draws from. */

package/dist/types/plots/{scatter → correlation/scatter}/state.d.ts

@@ -1,5 +1,5 @@
-import type { ScatterSegmentStyle } from '../segments/common';
-import type { AxisPlotState, AxisPlotCtx } from '../../phases';
+import type { ScatterSegmentStyle } from '../../segments/common';
+import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
 /** ScatterPlot's pipeline state: the shared axis-based state, with no extras of its own. */
 export type ScatterPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, ScatterSegmentStyle>;
 /** The environment every ScatterPlot phase reads from, alongside the growing state. */

package/dist/types/plots/distribution/box/props.d.ts

@@ -0,0 +1,10 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { AxisBasedStylesConfig } from '../../../layout/styles';
+import type { AreaStyle } from '../../styling';
+/** `BoxPlot`'s public props. */
+export type BoxPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `BoxPlot`'s core draws from. */
+export type BoxPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/distribution/box/state.d.ts

@@ -0,0 +1,23 @@
+import type { AreaStyle } from '../../styling';
+import type { AxisPlotState, AxisPlotCtx, ProcessedRow } from '../../../phases';
+import type { AxisValue } from '../../../layout/mapping';
+/** BoxPlot's pipeline state: the shared axis-based state, with no extras of its own. */
+export type BoxPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, AreaStyle>;
+/** The environment every BoxPlot phase reads from, alongside the growing state. */
+export type BoxPlotCtx = AxisPlotCtx;
+/**
+ * One box's summary - what a hovered box reads as: its category, its
+ * quartiles, the whisker ends (the farthest values within 1.5 IQR of the
+ * box) and the values past them. It also keeps the series tags and, when the
+ * category channel is a field key, the category under that field.
+ */
+export type BoxSummaryRow = ProcessedRow & {
+    category: AxisValue;
+    min: number;
+    p25: number;
+    median: number;
+    p75: number;
+    max: number;
+    count: number;
+    outliers: number[];
+};

package/dist/types/plots/distribution/density/props.d.ts

@@ -0,0 +1,23 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { CurveAwarePlotStylesConfig } from '../../../layout/styles';
+import type { AreaStyle } from '../../styling';
+import type { AxisChannelName, ChannelAccessors } from '../../../layout/mapping';
+/** Flat rows estimated along one axis: `x` for a vertical curve, or `y` alone for a horizontal one. */
+type DensityDataProps<TRow extends Record<string, unknown>> = Omit<DataProps<TRow>, AxisChannelName> & ((Required<Pick<ChannelAccessors<TRow>, 'x'>> & {
+    y?: never;
+}) | (Required<Pick<ChannelAccessors<TRow>, 'y'>> & {
+    x?: never;
+}));
+/** `styles` of `DensityPlot`: the curve of the estimate, and the mark that draws it. */
+export type DensityPlotStylesConfig = CurveAwarePlotStylesConfig & {
+    /** The mark drawing each estimate: a filled `'area'` or a `'line'`. Defaults to `'area'`. */
+    mark?: 'area' | 'line';
+};
+/** `DensityPlot`'s public props. */
+export type DensityPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DensityDataProps<TData>, TData, DensityPlotStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `DensityPlot`'s core draws from. */
+export type DensityPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DensityDataProps<TData>, TData, DensityPlotStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export {};

package/dist/types/plots/distribution/density/state.d.ts

@@ -0,0 +1,6 @@
+import type { AreaStyle } from '../../styling';
+import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+/** DensityPlot's pipeline state: the shared axis-based state, with no extras of its own. */
+export type DensityPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, AreaStyle>;
+/** The environment every DensityPlot phase reads from, alongside the growing state. */
+export type DensityPlotCtx = AxisPlotCtx;

package/dist/types/plots/distribution/density/state.js

@@ -0,0 +1 @@
+export {};

package/dist/types/plots/{histogram → distribution/histogram}/props.d.ts

@@ -1,10 +1,10 @@
-import type { BasePlotProps, PlotCoreProps } from '../props';
-import type { AxisBasedScalesConfig } from '../../layout/scales';
-import type { AxisBasedMarkersConfig } from '../../markers/common';
-import type { SeriesProps, DataProps } from '../data/common';
-import type { AxisBasedStylesConfig } from '../../layout/styles';
-import type { AreaStyle } from '../styling';
-import type { AxisChannelName, ChannelAccessors } from '../../layout/mapping';
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { AxisBasedStylesConfig } from '../../../layout/styles';
+import type { AreaStyle } from '../../styling';
+import type { AxisChannelName, ChannelAccessors } from '../../../layout/mapping';
 /** Flat rows binned on one axis: `x` for vertical bars, or `y` alone for horizontal ones. A bin's count is its length. */
 type HistogramDataProps<TRow extends Record<string, unknown>> = Omit<DataProps<TRow>, AxisChannelName> & ((Required<Pick<ChannelAccessors<TRow>, 'x'>> & {
     y?: never;

package/dist/types/plots/distribution/histogram/props.js

@@ -0,0 +1 @@
+export {};

package/dist/types/plots/{histogram → distribution/histogram}/state.d.ts

@@ -1,5 +1,5 @@
-import type { AreaStyle } from '../styling';
-import type { AxisPlotState, AxisPlotCtx } from '../../phases';
+import type { AreaStyle } from '../../styling';
+import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
 /** HistogramPlot's pipeline state: the shared axis-based state, with no extras of its own. */
 export type HistogramPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, AreaStyle>;
 /** The environment every HistogramPlot phase reads from, alongside the growing state. */

package/dist/types/plots/distribution/histogram/state.js

@@ -0,0 +1 @@
+export {};