@fundar/data-chart-telling 1.17.0 → 1.19.0

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

@@ -1,14 +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;
-    /** 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. */
-    format?: (value: number, seriesName: string, number: (value: number) => string) => string;
+    /** 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

@@ -51,9 +51,9 @@ export type TransformsStageState = {
     processedGroups?: VisualGroup<Series<ProcessedRow>, any>[];
 };
 /** What differs between plots in the shared "transforms" stage. */
-export type TransformsStageOptions<TState extends TransformsStageState, TCtx> = {
+export type TransformsStageOptions<TState extends TransformsStageState, TEnv> = {
     /** The transforms to run. Defaults to the plot's own `transforms`. */
-    transforms?: (state: TState, ctx: TCtx) => MarkerTransform[];
+    transforms?: (state: TState, env: TEnv) => MarkerTransform[];
     /**
      * Whether a series the legend omits keeps its part of the whole (a treemap's tile): the transforms run over
      * its rows too, so every other part keeps its share and its place, and its own rows are dropped after.
@@ -77,6 +77,8 @@ export type TransformsStageOptions<TState extends TransformsStageState, TCtx> =
         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
@@ -32,11 +20,9 @@ export type FontWeight = 'normal' | 'bold' | number;
 /** `font-style` keyword accepted by any text styling. */
 export type FontStyleKeyword = 'normal' | 'italic';
 /**
- * Horizontal text anchor. `'outside'` is only meaningful where the consuming
- * mark resolves it per-point from a signed x value (currently `HoverMarker`
- * only) - it anchors the label away from zero: `'start'` (extending right)
- * for a positive x, `'end'` (extending left) for negative. Elsewhere it's
- * treated the same as `'start'`.
+ * Horizontal text anchor. `'outside'` leaves the side to the mark that writes
+ * the label, where it picks one per point (a Cleveland plot's labels take
+ * their own); elsewhere it's treated the same as `'start'`.
  */
 export type TextAnchor = 'start' | 'middle' | 'end' | 'outside';
 /** Vertical text anchor. */

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/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 { AxisPlotState, AxisPlotEnv } 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.
@@ -23,6 +23,6 @@ export type HeatmapPlotState<TData extends Record<string, unknown>> = AxisPlotSt
     resolveOpacity?: (row: TData) => number;
 };
 /** The environment every HeatmapPlot phase reads from, alongside the growing state. */
-export type HeatmapPlotCtx = AxisPlotCtx & {
+export type HeatmapPlotEnv = AxisPlotEnv & {
     range: HeatmapRangeFilter | null | undefined;
 };

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/correlation/scatter/state.d.ts

@@ -1,6 +1,6 @@
 import type { ScatterSegmentStyle } from '../../segments/common';
-import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+import type { AxisPlotState, AxisPlotEnv } 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. */
-export type ScatterPlotCtx = AxisPlotCtx;
+export type ScatterPlotEnv = AxisPlotEnv;

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

@@ -1,10 +1,36 @@
+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';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
 import type { SeriesProps, DualAxisDataProps } from '../../data/common';
 import type { AxisBasedStylesConfig } from '../../../layout/styles';
 import type { AreaStyle } from '../../styling';
+/**
+ * One box's summary: its category, its quartiles, the whisker ends (the farthest values within 1.5 IQR of the box),
+ * how many values it has and the ones past the whiskers.
+ */
+export type BoxSummary = {
+    category: AxisValue;
+    min: number;
+    p25: number;
+    median: number;
+    p75: number;
+    max: number;
+    count: number;
+    outliers: number[];
+};
+/**
+ * What a `BoxPlot` or a `ViolinPlot` knows of a row, which its tooltip's and value labels' `format`, its hover and
+ * `usePlot().contextOf` read: the summary of the box (or violin) it is in. A value's own `value` stays its own; a
+ * 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>>;
+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/box/state.d.ts

@@ -1,23 +1,12 @@
 import type { AreaStyle } from '../../styling';
-import type { AxisPlotState, AxisPlotCtx, ProcessedRow } from '../../../phases';
-import type { AxisValue } from '../../../layout/mapping';
+import type { AxisPlotState, AxisPlotEnv, ProcessedRow } from '../../../phases';
+import type { BoxSummary } from './props';
 /** 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;
+export type BoxPlotEnv = AxisPlotEnv;
 /**
- * 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.
+ * One box's summary as a row - what a hovered box reads as. 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[];
-};
+export type BoxSummaryRow = ProcessedRow & BoxSummary;

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/density/state.d.ts

@@ -1,6 +1,6 @@
 import type { AreaStyle } from '../../styling';
-import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+import type { AxisPlotState, AxisPlotEnv } 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;
+export type DensityPlotEnv = AxisPlotEnv;

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

@@ -1,10 +1,24 @@
+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';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
 import type { SeriesProps, SingleAxisDataProps } from '../../data/common';
 import type { AxisBasedStylesConfig } from '../../../layout/styles';
 import type { AreaStyle } from '../../styling';
+/**
+ * What a `HistogramPlot` knows of a bin, which its tooltip's and value labels' `format`, its hover and
+ * `usePlot().contextOf` read: its `count` (also its `value`) and the edges it spans.
+ */
+export type HistogramRowContext = KindRowContext<{
+    /** How many values fall in the bin. */
+    count: number;
+    /** The bin's lower edge. */
+    from: number;
+    /** The bin's upper edge. */
+    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>>;
+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/histogram/state.d.ts

@@ -1,6 +1,6 @@
 import type { AreaStyle } from '../../styling';
-import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+import type { AxisPlotState, AxisPlotEnv } 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. */
-export type HistogramPlotCtx = AxisPlotCtx;
+export type HistogramPlotEnv = AxisPlotEnv;

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/pyramid/state.d.ts

@@ -1,6 +1,6 @@
 import type { Series } from '../../data/common';
 import type { BarSegmentStyle } from '../../segments/common';
-import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+import type { AxisPlotState, AxisPlotEnv } from '../../../phases';
 export type PyramidSide = 'left' | 'right';
 /** A resolved series tagged with which side of the shared zero baseline it renders on. */
 export type PyramidSeries<TData extends Record<string, unknown>> = Series<TData> & {
@@ -13,4 +13,4 @@ export type PyramidSeries<TData extends Record<string, unknown>> = Series<TData>
  */
 export type PyramidPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, BarSegmentStyle, PyramidSeries<TData>>;
 /** The environment every PyramidPlot phase reads from, alongside the growing state. */
-export type PyramidPlotCtx = AxisPlotCtx;
+export type PyramidPlotEnv = AxisPlotEnv;

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

@@ -1,3 +1,7 @@
+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';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
@@ -6,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;
@@ -18,6 +22,6 @@ export type ViolinPlotStylesConfig = AxisBasedStylesConfig & {
     box?: boolean | number;
 };
 /** `ViolinPlot`'s public props. */
-export type ViolinPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ViolinPlotStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type ViolinPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ViolinPlotStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>, undefined, BoxRowContext>;
 /** What `ViolinPlot`'s core draws from. */
 export type ViolinPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ViolinPlotStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

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

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

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/area/state.d.ts

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

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/evolution/line/state.d.ts

@@ -1,9 +1,9 @@
 import type { GapsConfig } from '../../gaps';
 import type { LineSegmentStyle } from '../../segments/common';
-import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+import type { AxisPlotState, AxisPlotEnv } from '../../../phases';
 /** LinePlot's pipeline state: the shared axis-based state plus its gaps. */
 export type LinePlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, LineSegmentStyle> & {
     gaps?: GapsConfig<LineSegmentStyle>;
 };
 /** The environment every LinePlot phase reads from, alongside the growing state. */
-export type LinePlotCtx = AxisPlotCtx;
+export type LinePlotEnv = AxisPlotEnv;

package/dist/types/plots/evolution/slope/state.d.ts

@@ -1,5 +1,5 @@
-import type { LinePlotState, LinePlotCtx } from '../line/state';
+import type { LinePlotState, LinePlotEnv } from '../line/state';
 /** SlopePlot's pipeline state: a LinePlot's. */
 export type SlopePlotState<TData extends Record<string, unknown>> = LinePlotState<TData>;
 /** The environment every SlopePlot phase reads from, alongside the growing state. */
-export type SlopePlotCtx = LinePlotCtx;
+export type SlopePlotEnv = LinePlotEnv;

package/dist/types/plots/evolution/sparkline/state.d.ts

@@ -1,5 +1,5 @@
-import type { LinePlotState, LinePlotCtx } from '../line/state';
+import type { LinePlotState, LinePlotEnv } from '../line/state';
 /** SparklinePlot's pipeline state: a LinePlot's. */
 export type SparklinePlotState<TData extends Record<string, unknown>> = LinePlotState<TData>;
 /** The environment every SparklinePlot phase reads from, alongside the growing state. */
-export type SparklinePlotCtx = LinePlotCtx;
+export type SparklinePlotEnv = LinePlotEnv;

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 {};

package/dist/types/plots/map/geo/state.d.ts

@@ -78,7 +78,7 @@ export type GeoPlotState<TProps extends Record<string, unknown>> = {
     hoverRows?: TaggedGeoFeature<TProps>[];
 };
 /** The environment every GeoPlot phase reads from, alongside the growing state. */
-export type GeoPlotCtx<TProps extends Record<string, unknown>> = {
+export type GeoPlotEnv<TProps extends Record<string, unknown>> = {
     cfg: PlotStylesConfig;
     range: GeoRangeFilter | null | undefined;
     fill?: string;

package/dist/types/plots/part-of-a-whole/treemap/props.d.ts

@@ -1,19 +1,31 @@
+import type { WithValues } from '../../../layout/styles';
+import type { BoxLabelConfig } from '../../../markers/labels/box';
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { AxisBasedScalesConfig } from '../../../layout/scales';
 import type { AxisBasedMarkersConfig } from '../../../markers/common';
 import type { NonAxisDataProps } from '../../data/common';
 import type { AxisBasedStylesConfig } from '../../../layout/styles';
-import type { TooltipContext } from '../../../layout/tooltip';
+import type { KindRowContext } from '../../../layout/context';
 import type { BarSegmentStyle } from '../../segments/common';
-/** What a `TreemapPlot` knows of a hovered tile beyond its row, the third argument of `tooltip.format`. */
-export type TreemapTooltipContext = TooltipContext & {
+/**
+ * What a `TreemapPlot` knows of a tile, which its tooltip's and value labels' `format`, its hover and
+ * `usePlot().contextOf` read: its series (the outermost level), and what the plot works out for it. Its `value`
+ * is the tile's summed value, and it has no `x` or `y`.
+ */
+export type TreemapRowContext = KindRowContext<{
+    /** The tile's name: the value at its innermost level. */
+    name: string;
+    /** The value at every level of the tile, outermost first. */
+    path: string[];
     /** The tile's part of the whole, from `0` to `100`, worked out from the values in whatever unit they are. */
     share: number;
-};
+}>;
+/** What a `TreemapPlot`'s `tooltip.format` gets in its third argument - see {@link TreemapRowContext}. */
+export type TreemapTooltipContext = TreemapRowContext;
 /**
  * `TreemapPlot`'s public props: flat rows, a tile each, on no axes. `value` is a tile's area, and `grouping` what
  * the tiles nest by (`'sector.branch'`, outermost first), whose outermost level colors them.
  */
-export type TreemapPlotProps<TData extends Record<string, unknown>> = BasePlotProps<NonAxisDataProps<TData, 'value'>, TData, AxisBasedStylesConfig, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>, undefined, TreemapTooltipContext>;
+export type TreemapPlotProps<TData extends Record<string, unknown>> = BasePlotProps<NonAxisDataProps<TData, 'value'>, TData, WithValues<AxisBasedStylesConfig, BoxLabelConfig>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>, undefined, TreemapTooltipContext>;
 /** What `TreemapPlot`'s core draws from. */
-export type TreemapPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<NonAxisDataProps<TData, 'value'>, TData, AxisBasedStylesConfig, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type TreemapPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<NonAxisDataProps<TData, 'value'>, TData, WithValues<AxisBasedStylesConfig, BoxLabelConfig>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/part-of-a-whole/treemap/state.d.ts

@@ -1,6 +1,6 @@
 import type { BarSegmentStyle } from '../../segments/common';
-import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+import type { AxisPlotState, AxisPlotEnv } from '../../../phases';
 /** TreemapPlot's pipeline state: the shared axis-based state, over a unit square its tiles are laid out in. */
 export type TreemapPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, BarSegmentStyle>;
 /** The environment every TreemapPlot phase reads from, alongside the growing state. */
-export type TreemapPlotCtx = AxisPlotCtx;
+export type TreemapPlotEnv = AxisPlotEnv;

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

@@ -1,3 +1,4 @@
+import type { HoverLook } from '../markers/common';
 import type { Pipeline } from '../../phases/Pipeline';
 import type { Snippet } from 'svelte';
 import type { TooltipContext, TooltipOptions, TooltipProp } from '../layout/tooltip';
@@ -62,6 +63,8 @@ export type HoverConfig<TRow extends Record<string, unknown>> = {
     pointMatching?: PointMatchingStrategy;
     /** Forces the crosshair rule(s) a `hover` marker draws off entirely, overriding whatever `strategy` implies. */
     crosshair?: boolean;
+    /** The plot kind's own hover under the strategy in force, which an author's `hover` marker is laid over as it is drawn. */
+    look?: (strategy: HoverStrategy) => HoverLook;
 };
 /** The `scales` prop of any plot kind. */
 export type ScalesConfig<TData = Record<string, unknown>> = AxisBasedScalesConfig<TData> | GeoScalesConfig;

package/dist/types/plots/ranking/bar/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';
 /** `BarPlot`'s public props. */
-export type BarPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, GapsAwarePlotStylesConfig<BarSegmentStyle>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type BarPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<GapsAwarePlotStylesConfig<BarSegmentStyle>, BarValueLabel>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `BarPlot`'s core draws from. */
-export type BarPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, GapsAwarePlotStylesConfig<BarSegmentStyle>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type BarPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<GapsAwarePlotStylesConfig<BarSegmentStyle>, BarValueLabel>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/ranking/bar/state.d.ts

@@ -1,6 +1,6 @@
-import type { AxisPlotState, AxisPlotCtx } from '../../../phases';
+import type { AxisPlotState, AxisPlotEnv } from '../../../phases';
 import type { BarSegmentStyle } from '../../segments/common';
 /** BarPlot's pipeline state: the shared axis-based state. */
 export type BarPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, BarSegmentStyle>;
 /** The environment every BarPlot phase reads from, alongside the growing state. */
-export type BarPlotCtx = AxisPlotCtx;
+export type BarPlotEnv = AxisPlotEnv;

package/dist/types/plots/ranking/bullet/state.d.ts

@@ -1,5 +1,5 @@
-import type { BarPlotState, BarPlotCtx } from '../bar/state';
+import type { BarPlotState, BarPlotEnv } from '../bar/state';
 /** BulletPlot's pipeline state: a bar plot's, which already carries the `target` and `ranges` it measures against. */
 export type BulletPlotState<TData extends Record<string, unknown>> = BarPlotState<TData>;
 /** The environment every BulletPlot phase reads from. */
-export type BulletPlotCtx = BarPlotCtx;
+export type BulletPlotEnv = BarPlotEnv;

package/dist/types/plots/ranking/cleveland/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 { ConnectorBasedStylesConfig } from '../../../layout/styles';
 import type { LineSegmentStyle } from '../../segments/common';
 /** `ClevelandPlot`'s public props. */
-export type ClevelandPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type ClevelandPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `ClevelandPlot`'s core draws from. */
-export type ClevelandPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type ClevelandPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;