@fundar/data-chart-telling 1.18.0 → 1.19.0

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

@@ -1,16 +1,23 @@
+import type { CoveringShape } from '../labels/point';
 import type { FontStyle, StrokeStyle, PerRow } 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 { LabelAnchor, TextAnchor } from '../../plots/constants';
+import type { LabelAnchor, LineAnchor, TextAnchor } from '../../plots/constants';
 import type { NumberDisplay } from '../../layout/numbers';
 /**
- * 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.
- * Unset geometry falls back to the configuration's `text.declutter`.
+ * How labels that would overlap are laid out. `'lanes'` spreads them apart
+ * vertically, all reaching out to one shared column, each routed back to its
+ * own point by an elbow connector; `'around'` puts each one on a free spot
+ * around its point (its own side first, then on clockwise),
+ * clear of the other labels and points, and leaves out one with no room.
  */
+export type TextDeclutterMode = 'lanes' | 'around';
+/** {@link TextDeclutterMode}'s options. Unset geometry falls back to the configuration's `text.declutter`. */
 export type TextDeclutterConfig = {
+    /** Defaults to `'lanes'`. */
+    mode?: TextDeclutterMode;
     /** 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. */
@@ -68,8 +75,10 @@ export type TextMarkerConfig = CommonMarkerConfigWithRowOffset<{
     styles?: PerRow<TextRowStyle> & Omit<FontStyle, TextRowStyleKey>;
     /** 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);
-    /** Spreads overlapping labels apart - see {@link TextDeclutterConfig}. `true` takes every default. */
-    declutter?: boolean | TextDeclutterConfig;
+    /** Which side of its point the text sits on vertically: a value, or a function of the row. Wins over `styles.lineAnchor`. */
+    lineAnchor?: LineAnchor | ((d: any) => LineAnchor);
+    /** Lays out overlapping labels - see {@link TextDeclutterConfig}. `true` is `'lanes'` with every default. */
+    declutter?: boolean | TextDeclutterMode | TextDeclutterConfig;
     /** Writes each label to fit its box - see {@link TextFitConfig}. `true` takes every default. */
     fit?: boolean | TextFitConfig;
     /**
@@ -80,6 +89,16 @@ export type TextMarkerConfig = CommonMarkerConfigWithRowOffset<{
     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;
+    /**
+     * The shape each row's point sits in: a label is left out where the shape of a row drawn after its own covers it,
+     * as a dot drawn over another hides that one's label.
+     */
+    covers?: (d: any, scales: any) => CoveringShape | undefined;
+    /** How far each row's point sits off its `x`/`y`, in pixels: labels, connectors and lanes start there. */
+    origin?: (d: any, scales: any) => {
+        dx: number;
+        dy: number;
+    } | undefined;
     /** 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?: LabelAnchor;
     /** Grows the plot's margins, on every side the author left open, so the labels fit. */
@@ -87,21 +106,6 @@ export type TextMarkerConfig = CommonMarkerConfigWithRowOffset<{
     /** Reports how far the rendered labels reach past the plot's content box, in pixels, on each side. */
     onoverflow?: (overflow: Margins) => void;
 } & NumberDisplay & CommonMarkerConfig>;
-/** A `text` marker as a shape's `label`: all of it but what the shape sets - its `type`, its rows and the label's position. */
-export type TextLabelConfig = Omit<TextMarkerConfig, 'type' | 'data' | 'x' | 'y' | 'frameAnchor'> & {
-    /**
-     * Where in its shape the label sits: its `'middle'` (the default), against one of its edges (`'top'`, `'bottom'`,
-     * `'left'`, `'right'`) or in one of its corners (`'top-left'`...). The label's `dx` and `dy` move it from there.
-     */
-    anchor?: LabelAnchor;
-    /**
-     * Puts a label anchored to an edge beyond that edge, outside the shape, instead of inside it. A label out there is not
-     * fitted to the shape, and with `fitMargins` the plot's margins grow to hold it.
-     */
-    outside?: boolean;
-    /** Pixels between the label and the edge it is anchored to. Defaults to the configuration's `text.label.gap`, `4`. */
-    gap?: number;
-};
 export type { LabelAnchor };
 /** Where one decluttered label goes - see `Declutter.buildLanes`. */
 export type LabelLane = {

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

@@ -1,10 +1,6 @@
-import type { TextLabelConfig } from '../basic/text';
-/** The markers that draw a shape per row, which can write a label in each one. */
-export type CommonMarkerConfigWithLabel = {
-    /**
-     * A label for each shape, written by a `text` marker: every option of one but `type`, `data`, `x` and `y`,
-     * which the shape sets. The label is centred on its shape, and fitted to it unless `fit` is `false` - see
-     * {@link TextFitConfig}. It never takes the pointer from the shape under it.
-     */
-    label?: TextLabelConfig;
+import type { MarkerLabelConfig, MarkerLabels } from '../labels/common';
+/** `TLabel` names the layouts the marker kind supports. */
+export type CommonMarkerConfigWithLabel<TLabel extends MarkerLabelConfig> = {
+    /** One label per shape, or a list of them. `layout` defaults to the marker kind's. */
+    label?: MarkerLabels<TLabel>;
 };

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

@@ -0,0 +1,5 @@
+/** A marker drawn by svelteplot's `*X` or `*Y` pair. */
+export type CommonMarkerConfigWithOrientation = {
+    /** Defaults to the plot's way, else to its own channels' when the plot has none. */
+    isHorizontal?: boolean;
+};

package/dist/types/markers/channels/commonMarkerConfigWithOrientation.js

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

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

@@ -0,0 +1,57 @@
+import type { LabelBaseConfig } from './common';
+import type { TextMarkerConfig } from '../basic/text';
+import type { LabelAnchor } from '../../plots/constants';
+/** A label written in the box of each shape, fitted to it unless `fit` is `false`. */
+export type BoxLabelConfig = LabelBaseConfig & {
+    layout?: 'box';
+    anchor?: LabelAnchor;
+    /** Defaults to the configuration's `text.label.gap`. */
+    gap?: number;
+};
+export type BoxShape = 'edges' | 'cell' | 'band';
+/** A field, a symbol, a function of the row or a literal. */
+export type BoxEdge = unknown;
+export type BoxChannels = {
+    x1: BoxEdge;
+    x2: BoxEdge;
+    y1: BoxEdge;
+    y2: BoxEdge;
+};
+export type BoxScales = Record<string, {
+    type?: string;
+    fn: any;
+} | undefined>;
+export type BoxSizer = (row: unknown, scales: BoxScales) => {
+    width: number;
+    height: number;
+} | undefined;
+export type BoxGeometryOf = {
+    x: unknown;
+    y: unknown;
+    box: BoxChannels | BoxSizer;
+    size?: BoxSizer;
+    /** For a shape that runs along a value: the axis it runs on, and where each row starts (its base) and ends (its tip). */
+    ends?: {
+        axis: 'x' | 'y';
+        from: (row: unknown) => unknown;
+        to: (row: unknown) => unknown;
+    };
+};
+export type BoxLabelMarker = {
+    marker: TextMarkerConfig;
+    box: BoxChannels | BoxSizer;
+};
+export type BoxedMarker = {
+    type?: string;
+    data?: unknown[];
+    x?: BoxEdge;
+    y?: BoxEdge;
+    x1?: BoxEdge;
+    x2?: BoxEdge;
+    y1?: BoxEdge;
+    y2?: BoxEdge;
+    isHorizontal?: boolean;
+    role?: string;
+    thickness?: number;
+    styles?: object;
+};

package/dist/types/markers/labels/box.js

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

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

@@ -0,0 +1,15 @@
+import type { TextMarkerConfig } from '../basic/text';
+import type { BoxLabelConfig, BoxShape } from './box';
+import type { PointLabelConfig, PointShape } from './point';
+import type { PathLabelConfig, PathShape } from './path';
+export type LabelLayout = 'box' | 'path' | 'point';
+export type LabelBaseConfig = Omit<TextMarkerConfig, 'type' | 'data' | 'x' | 'y' | 'frameAnchor' | 'origin'>;
+export type MarkerLabelConfig = BoxLabelConfig | PathLabelConfig<string, string> | PointLabelConfig;
+export type MarkerLabels<TLabel extends MarkerLabelConfig = MarkerLabelConfig> = TLabel | TLabel[];
+/** The layout a label takes by default, and the geometry the kind gives each layout it supports. */
+export type MarkerLabelTraits = {
+    default: LabelLayout;
+    box?: BoxShape;
+    path?: PathShape;
+    point?: PointShape;
+};

package/dist/types/markers/labels/common.js

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

package/dist/types/markers/labels/path.d.ts

@@ -0,0 +1,52 @@
+import type { LabelAnchor } from '../../plots/constants';
+import type { LabelBaseConfig } from './common';
+/** An edge of a shape as it is drawn on the page. */
+export type PageEdge = 'top' | 'bottom' | 'left' | 'right';
+/** An edge of a shape that runs along a value: the end away from zero, `'tip'`, or the one at zero, `'base'`. */
+export type ValueEdge = 'tip' | 'base';
+/** Where a label sits off a closed shape's edge: beyond it, against it within the shape, or centred on it. */
+export type ShapeSide = 'outside' | 'inside' | 'on';
+/** Where a label sits off an open stroke, as its text reads: above it, below it, or centred on it. */
+export type StrokeSide = 'above' | 'below' | 'on';
+/** A label written along an edge of its shape, read per row: a `'tip'` follows the sign of the row's value. */
+export type PathLabelConfig<TEdge extends string = PageEdge | ValueEdge, TSide extends string = ShapeSide> = LabelBaseConfig & {
+    layout: 'path';
+    /** `'tip'` on a shape that runs along a value, else `'top'`. */
+    edge?: TEdge;
+    /** Defaults to `'outside'` on a shape, `'above'` on a stroke. */
+    side?: TSide;
+    /**
+     * Where along the edge, from its left or top end. On a line or an area, `'max'` and `'min'` are the point of each
+     * one with its highest or lowest value - its peak, its trough. Defaults to `'middle'`.
+     */
+    offset?: 'start' | 'middle' | 'end' | 'max' | 'min' | `${number}%`;
+    /** Defaults to the configuration's `text.label.gap`. */
+    gap?: number;
+};
+/** A label written along each line a marker draws, curving with it. */
+export type StrokeLabelConfig = Omit<PathLabelConfig<never, StrokeSide>, 'edge'>;
+/** A label written along the top (`y2`) or bottom (`y1`) edge of each area, curving with it. */
+export type AreaEdgeLabelConfig = PathLabelConfig<'top' | 'bottom', StrokeSide>;
+/** A label written along the rim of each dot, from its left over its top. */
+export type RimLabelConfig = Omit<PathLabelConfig<never, ShapeSide>, 'edge'>;
+/**
+ * Where a kind writes `'path'` labels: `'box'` along the edges of each row's box, `'stroke'` along each line it
+ * draws, `'area'` along the top or bottom edge of each area, `'rim'` around each dot.
+ */
+export type PathShape = 'box' | 'stroke' | 'area' | 'rim';
+/** Where a plot's value label goes on its shape: in its box at an `anchor`, or along one of its edges. */
+export type ShapePlacement = {
+    anchor: LabelAnchor;
+} | Required<Pick<PathLabelConfig, 'layout' | 'edge' | 'side'>>;
+/** One label along a curve, in pixels: the path its text follows and where on it the text sits. */
+export type CurvedLabel = {
+    d: string;
+    text: string;
+    /** A row it labels: the row of a dot, the first of a line. */
+    row: unknown;
+    startOffset: string;
+    textAnchor: 'start' | 'middle' | 'end';
+    dy: number;
+    baseline: 'auto' | 'hanging' | 'central';
+    fill?: string;
+};

package/dist/types/markers/labels/path.js

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

package/dist/types/markers/labels/point.d.ts

@@ -0,0 +1,40 @@
+import type { LabelBaseConfig } from './common';
+import type { ValueSelect } from '../../layout/styles';
+import type { LabelAnchor } from '../../plots/constants';
+import type { BoxScales, BoxSizer } from './box';
+/** A label written beside a point of its shape, spread apart from the others with `declutter`. */
+export type PointLabelConfig = LabelBaseConfig & {
+    layout?: 'point';
+    /** The rows labelled, of each `grouping` of the marker. Every row by default. */
+    select?: ValueSelect | ValueSelect[] | ((row: any) => boolean);
+    /** On a shape with a box (a bar, a cell): the point of its box the label starts at, `'middle'` by default. */
+    anchor?: LabelAnchor;
+    /** Which side of its point the text is written on, as it reads: after it (to its right), before it, above, below or on it. */
+    side?: PointSide;
+    /** The gap from its point. Defaults to the configuration's `text.label.gap` on a box, else 6px across and 8px up or down. */
+    gap?: number;
+};
+export type PointSide = 'after' | 'before' | 'above' | 'below' | 'on';
+/**
+ * `'row'` labels each row at its `x`/`y`; `'top'` at its `x`/`y2` (a stacked area); `'box'` at a point of its box;
+ * `'dot'` at its center, in a round shape of its radius.
+ */
+export type PointShape = 'row' | 'top' | 'box' | 'dot';
+/** Where a marker's rows are labelled; `size` is the shape around each point, when it has one, `round` a circle in it. */
+export type PointGeometryOf = {
+    x: unknown;
+    y: unknown;
+    size?: BoxSizer;
+    round?: boolean;
+    /** How far each row's point sits off its `x`/`y`, in pixels: a series' own slot of its category's band. */
+    shift?: (row: unknown, scales: BoxScales) => {
+        dx: number;
+        dy: number;
+    } | undefined;
+};
+/** The shape a row's point sits in, in pixels around it: a box, or the circle in it. */
+export type CoveringShape = {
+    width: number;
+    height: number;
+    round?: boolean;
+};

package/dist/types/markers/labels/point.js

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

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

@@ -1,4 +1,8 @@
+import type { ChannelName } from '../layout/mapping';
 import type { LegendMark } from '../layout/legend';
+import type { MarkerLabelTraits } from './labels/common';
+/** A plot channel a marker can take from its plot; `x`/`y` are each taken only by a marker setting no position on that axis. */
+export type InheritedChannel = Exclude<ChannelName, 'value'>;
 /** What the rest of the system needs to know about a marker kind, declared once per kind in `MarkerKinds`. */
 export type MarkerTraits = {
     /**
@@ -19,4 +23,10 @@ export type MarkerTraits = {
      * dot, an area, a bar... A marker without one shows as a plain swatch.
      */
     legendSymbol?: LegendMark;
+    /** The plot's channels the marker takes in place of those it leaves unset, with the plot's scales for those that have one. */
+    inherits?: InheritedChannel[];
+    /** Whether it runs one way or the other (svelteplot's `*X`/`*Y` pair): the plot's way, else its own channels'. */
+    oriented?: boolean;
+    /** The labels the marker can write over its shapes; none without it. */
+    labels?: MarkerLabelTraits;
 };

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

@@ -1,13 +1,6 @@
-import type { ValueLabels } from '../../../layout/styles/ValueLabels';
-import type { AxisBasedMarkersConfig, TextMarkerConfig } from '../../markers/common';
+import type { AxisBasedMarkersConfig } from '../../markers/common';
 /** What a plot kind adds to the shared "markers" stage. */
 export type MarkersStageOptions<TState, TEnv> = {
     /** The plot's own marks - its bars, lines, dots... - drawn under every other marker. */
     marks: (state: TState, env: TEnv) => AxisBasedMarkersConfig[];
-    /**
-     * Its value labels, once they show: `text` markers drawn over everything.
-     * The stage adds what every label shares - see {@link ValueLabels.hooks}.
-     * Without it, the plot draws none.
-     */
-    valueLabels?: (labels: ValueLabels, state: TState, env: TEnv) => TextMarkerConfig[];
 };

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

@@ -1,6 +1,6 @@
 import type { ScopedMarkerGroup } from '../../layout/geometry';
 import type { Accessor, Series } from '../../plots/data/common';
-import type { AxisValue } from '../../layout/mapping';
+import type { AxisChannelName, AxisValue } from '../../layout/mapping';
 import type { StatisticConfig } from '../../layout/statistics';
 import type { AxisBasedMarkersConfig } from '../../markers/common';
 import type { ProcessedData, TransformsStageState } from '../transforms/phase';
@@ -16,10 +16,17 @@ export type StatisticsStageState = Pick<FacetStageState, 'panels'> & {
     /** The key the "data" phase split the rows into series by, which an author marker inherits. */
     seriesGrouping?: Accessor<any, unknown>;
     color?: Accessor<any, unknown>;
+    opacity?: Accessor<any, unknown>;
+    symbol?: Accessor<any, unknown>;
+    r?: number | Accessor<any, number>;
+    length?: number | Accessor<any, number>;
     statistics?: StatisticConfig[];
     authorMarkers?: AxisBasedMarkersConfig[];
     resolvedSeries?: Series<any>[];
     axes?: PlotAxes;
+    scales?: Partial<Record<AxisChannelName, {
+        type?: string;
+    }>>;
     flat?: any[];
     colorForSeries?: (name: string) => string;
     /** Each series' segments, which a `scope: 'segment'` author marker splits by. */
@@ -39,6 +46,4 @@ export type StatisticsStageOptions<TState extends StatisticsStageState> = {
      * default; off for a plot whose `color` is a value channel, not a group.
      */
     inheritGrouping?: boolean;
-    /** Whether a line/area/dot author marker with no `x`/`y` takes the plot's own. */
-    inheritPositions?: boolean;
 };

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

@@ -1,15 +1,27 @@
 import type { PlotRowContext } from '../../layout/context';
 import type { EdgeBox } from '../../layout/box';
 import type { ValueLabels } from '../../../layout/styles/ValueLabels';
-import type { ValueAnchor } from '../../plots/constants';
+import type { LabelLayout } from '../../markers/labels/common';
 /** A plot kind's own defaults for its value labels, under the author's `styles.values`. */
 export type ValueLabelsOptions<TState> = {
     /** Whether the labels draw when `styles.values.show` is unset. Defaults to `false`. */
     show?: boolean;
-    /** Where a label sits when `styles.values.anchor` is unset. Defaults to `'outside'`. */
-    anchor?: ValueAnchor;
+    /** The layout the labels take when `styles.values.layout` is unset. Defaults to `'point'`. */
+    layout?: LabelLayout | ((state: TState) => LabelLayout);
+    /** The kind's own options for each layout it takes, under the author's: a bar's `path` at its `tip`, say. */
+    /**
+     * On a kind whose rows have several values, the parts it can label: each one's own placement, over the layout's,
+     * and those it labels when `styles.values.parts` is unset.
+     */
+    parts?: {
+        placements: Record<string, Record<string, unknown>> | ((state: TState) => Record<string, Record<string, unknown>>);
+        default: string[];
+    };
+    layouts?: Partial<Record<LabelLayout, Record<string, unknown>>> | ((state: TState) => Partial<Record<LabelLayout, Record<string, unknown>>>);
     /** A label's text when `styles.values.format` is unset. Defaults to the bare value. `number` writes a value as the plot's `styles.values` display fields (`decimals`, `prefix`, `suffix`, `signDisplay`) ask, and `context` is what the plot knows of the labelled row. */
     format?: (value: number, number: (value: number) => string, context: PlotRowContext) => string;
+    /** `format`, chosen off the plot's state: a curve named when there are several, its peak's position when alone. */
+    formatFor?: (state: TState) => (value: number, number: (value: number) => string, context: PlotRowContext) => string;
     /**
      * Where the labels are expected to sit, from the whole data: boxes around
      * the points they label, on the plot edges those points can reach (see

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

@@ -77,6 +77,8 @@ export type TransformsStageOptions<TState extends TransformsStageState, TEnv> =
         show?: boolean;
         /** The rows picked when `styles.values.select` is unset. Defaults to every row. */
         select?: ValueSelect | ValueSelect[];
+        /** What `'min'` and `'max'` compare: the plot's value axis by default, or this (a heatmap's `color`). */
+        measure?: (state: TransformsStageState) => ((row: ProcessedRow) => unknown) | undefined;
         /** 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. */

package/dist/types/plots/constants.d.ts

@@ -3,18 +3,6 @@
  * the page, or in one of its corners. The anchors of a text marker's `frameAnchor`, and of a shape's `label`.
  */
 export type LabelAnchor = 'middle' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-/**
- * Where a value label sits on its mark. Two vocabularies share the type, one per family of plots:
- *
- * - The plots that label a point or the end of a line (`LinePlot`, `AreaPlot`, `SlopePlot`, `ScatterPlot`...) read
- *   the side of the point its text is written on: `'start'` after it (right of a line's last point), `'end'` before
- *   it, `'middle'` on it and `'outside'` beyond it.
- * - The plots that label a shape (`BarPlot`, `BulletPlot`, `PyramidPlot`, `HistogramPlot`) read where in it the
- *   label is. Inside the shape: a {@link LabelAnchor} - its `'middle'`, an edge as it is drawn on the page
- *   (`'top'`, `'left'`...) or a corner (`'top-left'`...) - or, whichever side of zero the value is, the end of the bar
- *   away from zero, `'tip'`, or the one at zero, `'base'`. Beyond the tip, outside the shape: `'outside'`.
- */
-export type ValueAnchor = LabelAnchor | 'outside' | 'start' | 'end' | 'tip' | 'base';
 /**
  * Shared by two unrelated renderers: a `dot` mark's own point shape
  * (delegated to svelteplot/d3-shape) and a discrete legend item's own icon

package/dist/types/plots/correlation/heatmap/props.d.ts

@@ -1,3 +1,4 @@
+import type { WithValues, CellValueLabel } from '../../../layout/styles';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
@@ -5,6 +6,6 @@ import type { SeriesProps, DualAxisDataProps } 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> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, CellSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type HeatmapPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, CellValueLabel>, CellSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `HeatmapPlot`'s core draws from. */
-export type HeatmapPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, CellSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type HeatmapPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, CellValueLabel>, CellSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/correlation/scatter/props.d.ts

@@ -1,3 +1,4 @@
+import type { WithValues, DotValueLabel } from '../../../layout/styles';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
@@ -5,6 +6,6 @@ import type { SeriesProps, DualAxisDataProps } 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> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, ScatterSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type ScatterPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, DotValueLabel>, ScatterSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `ScatterPlot`'s core draws from. */
-export type ScatterPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, ScatterSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type ScatterPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, DotValueLabel>, ScatterSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

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

@@ -1,3 +1,5 @@
+import type { WithValues } from '../../../layout/styles';
+import type { PointLabelConfig } from '../../../markers/labels/point';
 import type { KindRowContext } from '../../../layout/context';
 import type { AxisValue } from '../../../layout/mapping';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
@@ -26,7 +28,9 @@ export type BoxSummary = {
  * hovered box's is its median.
  */
 export type BoxRowContext = KindRowContext<BoxSummary>;
+/** The values of a box its value labels can write: its quartiles, its whiskers' ends and the values past them. */
+export type BoxValuePart = Exclude<keyof BoxSummary, 'category' | 'count'>;
 /** `BoxPlot`'s public props. */
-export type BoxPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>, undefined, BoxRowContext>;
+export type BoxPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, PointLabelConfig, BoxValuePart>, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>, undefined, BoxRowContext>;
 /** What `BoxPlot`'s core draws from. */
-export type BoxPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type BoxPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, PointLabelConfig, BoxValuePart>, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

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

@@ -1,3 +1,4 @@
+import type { AreaValueLabel, LineValueLabel, WithValues } from '../../../layout/styles';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
@@ -5,7 +6,7 @@ import type { SeriesProps, SingleAxisDataProps } from '../../data/common';
 import type { CurveAwarePlotStylesConfig } from '../../../layout/styles';
 import type { AreaStyle } from '../../styling';
 /** `styles` of `DensityPlot`: the curve of the estimate, and the mark that draws it. */
-export type DensityPlotStylesConfig = CurveAwarePlotStylesConfig & {
+export type DensityPlotStylesConfig = WithValues<CurveAwarePlotStylesConfig, AreaValueLabel | LineValueLabel> & {
     /** The mark drawing each estimate: a filled `'area'` or a `'line'`. Defaults to `'area'`. */
     mark?: 'area' | 'line';
 };

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

@@ -1,3 +1,4 @@
+import type { WithValues, CellValueLabel } from '../../../layout/styles';
 import type { KindRowContext } from '../../../layout/context';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
@@ -18,6 +19,6 @@ export type HistogramRowContext = KindRowContext<{
     to: number;
 }>;
 /** `HistogramPlot`'s public props. */
-export type HistogramPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | SingleAxisDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>, undefined, HistogramRowContext>;
+export type HistogramPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | SingleAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, CellValueLabel>, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>, undefined, HistogramRowContext>;
 /** What `HistogramPlot`'s core draws from. */
-export type HistogramPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | SingleAxisDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type HistogramPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | SingleAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, CellValueLabel>, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

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

@@ -1,3 +1,4 @@
+import type { WithValues, BarValueLabel } from '../../../layout/styles';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
@@ -5,6 +6,6 @@ import type { SeriesProps, DualAxisDataProps } from '../../data/common';
 import type { GapsAwarePlotStylesConfig } from '../../../layout/styles';
 import type { BarSegmentStyle } from '../../segments/common';
 /** `PyramidPlot`'s public props. */
-export type PyramidPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, GapsAwarePlotStylesConfig<BarSegmentStyle>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type PyramidPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<GapsAwarePlotStylesConfig<BarSegmentStyle>, BarValueLabel>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `PyramidPlot`'s core draws from. */
-export type PyramidPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, GapsAwarePlotStylesConfig<BarSegmentStyle>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type PyramidPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<GapsAwarePlotStylesConfig<BarSegmentStyle>, BarValueLabel>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

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

@@ -1,3 +1,6 @@
+import type { WithValues } from '../../../layout/styles';
+import type { PointLabelConfig } from '../../../markers/labels/point';
+import type { BoxValuePart } from '../box/props';
 import type { BoxRowContext } from '../box/props';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
@@ -7,7 +10,7 @@ import type { AxisBasedStylesConfig } from '../../../layout/styles';
 import type { AreaStyle } from '../../styling';
 import type { DensityKernel } from '../../../transforms/density';
 /** `styles` of `ViolinPlot`: how each category's density is estimated and drawn. */
-export type ViolinPlotStylesConfig = AxisBasedStylesConfig & {
+export type ViolinPlotStylesConfig = WithValues<AxisBasedStylesConfig, PointLabelConfig, BoxValuePart> & {
     kernel?: DensityKernel;
     /** Kernel bandwidth in data units; Silverman's rule picks one per violin when unset. */
     bandwidth?: number;

package/dist/types/plots/evolution/area/props.d.ts

@@ -1,3 +1,4 @@
+import type { WithValues, AreaValueLabel } from '../../../layout/styles';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
@@ -5,6 +6,6 @@ import type { SeriesProps, DualAxisDataProps } from '../../data/common';
 import type { AxisBasedStylesConfig } from '../../../layout/styles';
 import type { AreaStyle } from '../../styling';
 /** `AreaPlot`'s public props. */
-export type AreaPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type AreaPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, AreaValueLabel>, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `AreaPlot`'s core draws from. */
-export type AreaPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type AreaPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<AxisBasedStylesConfig, AreaValueLabel>, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/evolution/line/props.d.ts

@@ -1,3 +1,4 @@
+import type { WithValues, LineValueLabel } from '../../../layout/styles';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
@@ -5,6 +6,6 @@ import type { SeriesProps, DualAxisDataProps } from '../../data/common';
 import type { CurveAwarePlotStylesConfig, GapsAwarePlotStylesConfig } from '../../../layout/styles';
 import type { LineSegmentStyle } from '../../segments/common';
 /** `LinePlot`'s public props. */
-export type LinePlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, GapsAwarePlotStylesConfig<LineSegmentStyle> & CurveAwarePlotStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type LinePlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<GapsAwarePlotStylesConfig<LineSegmentStyle> & CurveAwarePlotStylesConfig, LineValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `LinePlot`'s core draws from. */
-export type LinePlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, GapsAwarePlotStylesConfig<LineSegmentStyle> & CurveAwarePlotStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type LinePlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<GapsAwarePlotStylesConfig<LineSegmentStyle> & CurveAwarePlotStylesConfig, LineValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/generic/props.d.ts

@@ -0,0 +1,16 @@
+import type { BasePlotProps, PlotCoreProps } from '../props';
+import type { AxisBasedScalesConfig } from '../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../markers/common';
+import type { ChannelAccessors } from '../../layout/mapping';
+import type { Series } from '../data/common';
+import type { AxisBasedStylesConfig } from '../../layout/styles';
+import type { AreaStyle } from '../styling';
+/** Rows, series or neither, and every channel optional: what markers without their own take. */
+export type GenericDataProps<TData extends Record<string, unknown>> = {
+    data?: TData[];
+    series?: Series<TData>[];
+} & ChannelAccessors<TData>;
+/** `Plot`'s public props. */
+export type GenericPlotProps<TData extends Record<string, unknown>> = BasePlotProps<GenericDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `Plot`'s core draws from. */
+export type GenericPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<GenericDataProps<TData>, TData, AxisBasedStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/generic/props.js

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

package/dist/types/plots/generic/state.d.ts

@@ -0,0 +1,4 @@
+import type { AreaStyle } from '../styling';
+import type { AxisPlotState, AxisPlotEnv } from '../../phases';
+export type GenericPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, AreaStyle>;
+export type GenericPlotEnv = AxisPlotEnv;

package/dist/types/plots/generic/state.js

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