@fundar/data-chart-telling 1.1.0 → 1.3.0

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

@@ -7,6 +7,10 @@ import type { HoverStrategy } from './hover';
 export type TooltipAnchorX = 'left' | 'middle' | 'right';
 /** Preferred vertical placement of the tooltip, like {@link TooltipAnchorX}. Defaults to `'bottom'`. */
 export type TooltipAnchorY = 'top' | 'middle' | 'bottom';
+/** A matched row as a tooltip's `content` gets it: the row itself, plus `seriesColor`, the one the plot draws it in (unset on plots without series). */
+export type TooltipRow<TRow> = TRow & {
+    seriesColor?: string;
+};
 /** Author-facing tooltip option on the chart kinds. `true` = enable with defaults. */
 export type TooltipOptions<TRow extends Record<string, unknown>> = {
     /** Matching strategy. Defaults to the chart kind's own default. */
@@ -17,9 +21,9 @@ export type TooltipOptions<TRow extends Record<string, unknown>> = {
     format?: (row: TRow) => string;
     /** Named subset of crossing series to include. Omitted = all matched. */
     series?: string[];
-    /** Custom tooltip body; replaces `format` when given. */
+    /** Custom tooltip body; replaces `format` when given. Its rows carry a `seriesColor` - see {@link TooltipRow}. */
     content?: Snippet<[{
-        rows: TRow[];
+        rows: TooltipRow<TRow>[];
     }]>;
     /** Preferred horizontal anchor - see {@link TooltipAnchorX}. */
     anchorX?: TooltipAnchorX;

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

@@ -2,11 +2,11 @@ import type { AreaStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithArea } from '../channels/commonMarkerConfigWithArea';
 import type { CommonMarkerConfigWithColor } from '../channels/commonMarkerConfigWithColor';
 import type { CommonMarkerConfigWithInterval } from '../channels/commonMarkerConfigWithInterval';
-import type { MarkerCurveName } from './curveName';
+import type { CurveName } from '../../layout/styles/curve';
 /** A filled area under a curve, or a band between two curves (svelteplot's `AreaX`/`AreaY`). */
 export type AreaMarkerConfig = {
     type: 'area';
-    curve?: MarkerCurveName;
+    curve?: CurveName;
     tension?: number;
     styles?: AreaStyle;
 } & CommonMarkerConfigWithArea & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval;

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

@@ -11,5 +11,8 @@ export type ArrowMarkerConfig = {
     insetStart?: number;
     insetEnd?: number;
     sweep?: 1 | 0 | -1 | '+x' | '-x' | '+y' | '-y';
+    stroke?: string | ((d: any) => string | undefined);
+    strokeWidth?: string | ((d: any) => number);
+    strokeOpacity?: string | ((d: any) => number);
     styles?: StrokeStyle;
 } & CommonMarkerConfigWithInterval;

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

@@ -21,9 +21,10 @@ import type { RasterMarkerConfig } from './raster';
 import type { TickMarkerConfig } from './tick';
 import type { TrailMarkerConfig } from './trail';
 import type { WaffleMarkerConfig } from './waffle';
+import type { ViolinMarkerConfig } from './violin';
 import type { RuleMarkerConfig } from './rule';
 import type { HoverMarkerConfig } from './hover';
 import type { CustomComponentMarkerConfig } from './component';
 import type { DeltaMarkerConfig } from './delta';
 /** Every marker kind an axis-based plot can render. */
-export type AxisBasedMarkersConfig = BasicMarkersConfig | LineMarkerConfig | BarMarkerConfig | CellMarkerConfig | RectMarkerConfig | RegressionMarkerConfig | BollingerMarkerConfig | AreaMarkerConfig | DensityMarkerConfig | BoxMarkerConfig | HullMarkerConfig | DifferenceMarkerConfig | ArrowMarkerConfig | BrushMarkerConfig | DelaunayLinkMarkerConfig | DelaunayMeshMarkerConfig | VoronoiMarkerConfig | VoronoiMeshMarkerConfig | ImageMarkerConfig | RasterMarkerConfig | TickMarkerConfig | TrailMarkerConfig | WaffleMarkerConfig | RuleMarkerConfig | HoverMarkerConfig | CustomComponentMarkerConfig | DeltaMarkerConfig;
+export type AxisBasedMarkersConfig = BasicMarkersConfig | LineMarkerConfig | BarMarkerConfig | CellMarkerConfig | RectMarkerConfig | RegressionMarkerConfig | BollingerMarkerConfig | AreaMarkerConfig | DensityMarkerConfig | BoxMarkerConfig | HullMarkerConfig | DifferenceMarkerConfig | ArrowMarkerConfig | BrushMarkerConfig | DelaunayLinkMarkerConfig | DelaunayMeshMarkerConfig | VoronoiMarkerConfig | VoronoiMeshMarkerConfig | ImageMarkerConfig | RasterMarkerConfig | TickMarkerConfig | TrailMarkerConfig | WaffleMarkerConfig | ViolinMarkerConfig | RuleMarkerConfig | HoverMarkerConfig | CustomComponentMarkerConfig | DeltaMarkerConfig;

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

@@ -11,8 +11,8 @@ export type BarMarkerConfig = {
     insetBottom?: number;
     insetLeft?: number;
     insetRight?: number;
+    thickness?: number;
     styles?: AreaStyle;
     category?: AxisValue;
-    /** A `'hitArea'` that matches `data` as the plot's hover while the pointer is over it. */
     hover?: boolean;
 } & CommonMarkerConfigWithColor & CommonMarkerConfigWithInterval;

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

@@ -11,4 +11,9 @@ export type BoxMarkerConfig = {
     dot?: Record<string, unknown>;
     tickMedian?: boolean | Record<string, unknown>;
     tickMinMax?: boolean | Record<string, unknown>;
+    thickness?: number;
+    slot?: {
+        index: number;
+        count: number;
+    };
 } & CommonMarkerConfig;

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

@@ -19,9 +19,22 @@ export type DeltaConfig = {
     text?: FontStyle;
     dot?: DotStyle;
 };
-/** A delta annotation between two points on a line chart. */
-export type DeltaMarkerConfig = {
+/** One delta annotation, at one position, between two points on a line chart. */
+export type DeltaPointConfig = {
     type: 'delta';
     xDomain?: (number | string | Date)[];
     yDomain?: (number | string | Date)[];
 } & DeltaConfig;
+/** A style as it is, or as a function of the position the delta is drawn at. */
+export type PerPosition<T> = T | ((at: AxisValue) => T);
+/**
+ * A delta annotation between two points on a line chart. `at` can be a list of positions: one delta is
+ * drawn at each, with the same ends. `line`, `text` and `dot` can be functions of the position, to style
+ * each delta on its own - a label to the left of the last one, say, so it stays inside the plot.
+ */
+export type DeltaMarkerConfig = Omit<DeltaPointConfig, 'at' | 'line' | 'text' | 'dot'> & {
+    at: AxisValue | AxisValue[];
+    line?: PerPosition<StrokeStyle>;
+    text?: PerPosition<FontStyle>;
+    dot?: PerPosition<DotStyle>;
+};

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

@@ -1,5 +1,5 @@
 import type { CommonMarkerConfigWithInterval } from '../channels/commonMarkerConfigWithInterval';
-import type { MarkerCurveName } from './curveName';
+import type { CurveName } from '../../layout/styles/curve';
 /** Shaded area between two series, colored by which is on top (svelteplot's `DifferenceY`). */
 export type DifferenceMarkerConfig = {
     type: 'difference';
@@ -7,6 +7,6 @@ export type DifferenceMarkerConfig = {
     positiveFillOpacity?: number;
     negativeFill?: string;
     negativeFillOpacity?: number;
-    curve?: MarkerCurveName;
+    curve?: CurveName;
     tension?: number;
 } & CommonMarkerConfigWithInterval;

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

@@ -1,15 +1,31 @@
 import type { AxisValue } from '../../layout/mapping';
 import type { StrokeStyle } from '../../plots/styling';
 import type { CommonMarkerConfigWithInterval } from '../channels/commonMarkerConfigWithInterval';
-/** A vertical or horizontal reference line, or one line per row when `data` is given. */
+/**
+ * A vertical or horizontal reference line, one line per row when `data` is given, or one per value
+ * when `value` is a list - all with the same style.
+ */
 export type RuleMarkerConfig = {
     type: 'rule';
     axis: 'x' | 'y';
-    value: AxisValue | string | ((d: any) => AxisValue);
+    /**
+     * Where the line goes along `axis`. A list draws a line at each value (without `data`); with `data`,
+     * a field key or a function of the row gives each row's own.
+     */
+    value: AxisValue | string | (AxisValue | string)[] | ((d: any) => AxisValue);
     inset?: number;
     insetTop?: number;
     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/facet/phase.d.ts

@@ -15,4 +15,8 @@ export type FacetStageState = {
     panels?: FacetPanel[];
     /** The panel a row belongs to: its own panel tag, or its facet values. `undefined` for a row no panel shows. */
     panelOf?: (row: Record<string | symbol, unknown>) => string | undefined;
+    /** The plot's `segments`. The phase moves those that name a facet to the panels they name, or drops them without panels. */
+    segments?: Record<string, object[]>;
+    /** The plot's own markers. The phase tags those that name a facet with the panels they name, or drops them without panels. */
+    authorMarkers?: object[];
 };

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

@@ -4,14 +4,14 @@ import type { SegmentsConfig, MarginConfig, HoverConfig, TooltipConfig } from '.
 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, 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. */
@@ -60,6 +69,10 @@ export type AxisPlotState<TData extends Record<string, unknown>, TStyle extends
     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;

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

@@ -2,6 +2,7 @@ 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. */
@@ -33,6 +34,12 @@ 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>[];
 };
@@ -47,4 +54,19 @@ export type TransformsStageOptions<TState extends TransformsStageState, TCtx> =
      * `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/{box → distribution/box}/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 { AreaStyle } from '../styling';
+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. */

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

@@ -1,6 +1,6 @@
-import type { AreaStyle } from '../styling';
-import type { AxisPlotState, AxisPlotCtx, ProcessedRow } from '../../phases';
-import type { AxisValue } from '../../layout/mapping';
+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. */