@fundar/data-chart-telling 1.18.0 → 1.20.0

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/data/geo.d.ts

@@ -1,4 +1,4 @@
-import type { Accessor } from './common';
+import type { TimeValue } from '../../layout/timeline';
 /**
  * One GeoJSON feature, generically typed over its `properties`. Intersected
  * with `Record<string, unknown>` so it satisfies the same generic bound
@@ -7,6 +7,20 @@ import type { Accessor } from './common';
  * index signature on its own.
  */
 export type GeoFeature<TProps extends Record<string, unknown> = Record<string, unknown>> = GeoJSON.Feature<GeoJSON.Geometry, TProps> & Record<string, unknown>;
+/**
+ * Which slice of a `timeline` and `facet` a feature is being read for: the callbacks of a sliced map get it as
+ * their last argument. Empty on a map without either.
+ */
+export type GeoSliceContext = {
+    /** The facet panel: its label (a grid's `row · col`), and the `rows` and `cols` values it sits at. */
+    facet?: {
+        value: string;
+        row?: string;
+        col?: string;
+    };
+    /** The timeline step. */
+    time?: TimeValue;
+};
 export type GeoJsonInput<TProps extends Record<string, unknown>> = GeoJSON.FeatureCollection<GeoJSON.Geometry, TProps> | GeoFeature<TProps>[];
 /**
  * Minimal structural shape of a TopoJSON `Topology` object. Deliberately not
@@ -46,14 +60,14 @@ export type GeoDataProps<TProps extends Record<string, unknown> = Record<string,
      * (e.g. `segments.argentina`) and for hover/click identification. Defaults
      * to `feature.id ?? feature.properties?.id ?? feature.properties?.name`.
      */
-    featureId?: Accessor<GeoFeature<TProps>, string>;
+    featureId?: keyof GeoFeature<TProps> | ((feature: GeoFeature<TProps>, slice: GeoSliceContext) => string);
     /**
      * Optional continuous color-value accessor for choropleth coloring - the
      * channel driving the ramp (mirrors heatmap's `color`), configured via
      * `scales.color`. A feature with no `color` (or when omitted entirely)
      * falls back to `styles.fill`/`segments`.
      */
-    color?: (feature: GeoFeature<TProps>) => number | undefined;
+    color?: (feature: GeoFeature<TProps>, slice: GeoSliceContext) => number | undefined;
     /**
      * Optional structural grouping key - splits features into named buckets
      * for `segments` to address by name (e.g. `segments.global_south`),
@@ -64,9 +78,9 @@ export type GeoDataProps<TProps extends Record<string, unknown> = Record<string,
      * ungrouped. A feature whose `grouping` value has no matching `segments`
      * key simply falls through to `segments.default`/the plot-level ramp.
      */
-    grouping?: (feature: GeoFeature<TProps>) => string | undefined;
+    grouping?: (feature: GeoFeature<TProps>, slice: GeoSliceContext) => string | undefined;
     /** Continuous or categorical opacity-value accessor - configure the ramp via `scales.opacity`. */
-    opacity?: (feature: GeoFeature<TProps>) => number | undefined;
+    opacity?: (feature: GeoFeature<TProps>, slice: GeoSliceContext) => number | undefined;
     /**
      * Excludes matching parts of a feature's geometry from the map's own
      * rendering and hover/click matching - e.g. so a separate `inset` marker

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

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

@@ -1,6 +1,7 @@
 import type { BasePlotProps, PlotCoreProps } from '../../props';
 import type { GeoScalesConfig, CoordinatesConfig } from '../../../layout/coordinates';
-import type { GeoFeature, GeoDataProps } from '../../data/geo';
+import type { GeoFeature, GeoDataProps, GeoSliceContext } from '../../data/geo';
+import type { PlotRowContext } from '../../../layout/context';
 import type { GeoStylesConfig } from '../../../layout/styles';
 import type { GeoSegmentStyle } from '../../segments/common';
 import type { GeoMarkersConfig } from '../../../markers/geo';
@@ -14,10 +15,15 @@ type OmitEach<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never
  * marker's own `data` rows; a feature or row without the field is context,
  * drawn in every slice.
  */
-export type GeoPlotProps<TProps extends Record<string, unknown>> = OmitEach<BasePlotProps<GeoDataProps<TProps>, GeoFeature<TProps>, GeoStylesConfig<TProps>, GeoSegmentStyle, GeoMarkersConfig, GeoScalesConfig, CoordinatesConfig>, 'timeline' | 'facet'> & {
+export type GeoPlotProps<TProps extends Record<string, unknown>> = OmitEach<BasePlotProps<GeoDataProps<TProps>, GeoFeature<TProps>, GeoStylesConfig<TProps>, GeoSegmentStyle, GeoMarkersConfig, GeoScalesConfig, CoordinatesConfig, GeoTooltipContext>, 'timeline' | 'facet'> & {
     timeline?: TimelineConfig<Record<string, unknown>>;
     facet?: FacetConfig<Record<string, unknown>>;
 };
+/** What a tooltip's `format` knows of a hovered feature: the shared row context, and the slice it was drawn in. */
+export type GeoTooltipContext = PlotRowContext & GeoSliceContext;
 /** What `GeoPlot`'s core draws from. */
-export type GeoPlotCoreProps<TProps extends Record<string, unknown>> = PlotCoreProps<GeoDataProps<TProps>, GeoFeature<TProps>, GeoStylesConfig<TProps>, GeoSegmentStyle, GeoMarkersConfig, GeoScalesConfig, CoordinatesConfig>;
+export type GeoPlotCoreProps<TProps extends Record<string, unknown>> = PlotCoreProps<GeoDataProps<TProps>, GeoFeature<TProps>, GeoStylesConfig<TProps>, GeoSegmentStyle, GeoMarkersConfig, GeoScalesConfig, CoordinatesConfig> & {
+    /** The slice of the `timeline` and `facet` this core draws - what its callbacks read its features in. */
+    sliceContext?: GeoSliceContext;
+};
 export {};

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

@@ -1,5 +1,5 @@
 import type { Accessor } from '../../data/common';
-import type { GeoFeature } from '../../data/geo';
+import type { GeoFeature, GeoSliceContext } from '../../data/geo';
 import type { ColorScaleConfig } from '../../../layout/scales';
 import type { GeoScalesConfig } from '../../../layout/coordinates';
 import type { SegmentsConfig, MarginConfig, HoverConfig } from '../../props';
@@ -46,6 +46,8 @@ export type GeoPlotState<TProps extends Record<string, unknown>> = {
     }, feature: TaggedGeoFeature<TProps>) => boolean;
     segments: SegmentsConfig<GeoSegmentStyle>;
     scales: GeoScalesConfig;
+    /** The slice of the `timeline` and `facet` this core draws, kept on each of its features for a tooltip's `format` to read. */
+    slice?: GeoSliceContext;
     /** The plot's `tooltip`, which the "hover" phase reads. */
     tooltip?: TooltipProp<TaggedGeoFeature<TProps>>;
     /** The raw `markers` prop - GeoPlot interleaves it with the base map by draw order, not a plain append. */

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

@@ -1,3 +1,5 @@
+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';
@@ -24,6 +26,6 @@ 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/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/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>>;

package/dist/types/plots/ranking/dumbbell/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';
 /** `DumbbellPlot`'s public props. */
-export type DumbbellPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type DumbbellPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `DumbbellPlot`'s core draws from. */
-export type DumbbellPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type DumbbellPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/ranking/forest/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';
@@ -17,7 +18,9 @@ export type ForestIntervalProps<TData extends Record<string, unknown>> = {
     /** The half-width of each row's interval: it reaches `error` below and above its value. `lower` and `upper` win where they are set. */
     error?: Accessor<TData, number>;
 };
+/** The values of a forest's row its value labels can write: its estimate, and its interval's ends. */
+export type ForestValuePart = 'value' | 'lower' | 'upper';
 /** `ForestPlot`'s public props. */
-export type ForestPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>> & ForestIntervalProps<TData>;
+export type ForestPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel, ForestValuePart>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>> & ForestIntervalProps<TData>;
 /** What `ForestPlot`'s core draws from. */
-export type ForestPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>> & ForestIntervalProps<TData>;
+export type ForestPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel, ForestValuePart>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>> & ForestIntervalProps<TData>;

package/dist/types/plots/ranking/lollipop/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';
 /** `LollipopPlot`'s public props. */
-export type LollipopPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type LollipopPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `LollipopPlot`'s core draws from. */
-export type LollipopPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+export type LollipopPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DualAxisDataProps<TData>, TData, WithValues<ConnectorBasedStylesConfig, DotValueLabel>, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/utils/ConfigEquality.d.ts

@@ -0,0 +1,11 @@
+/** Whether two configuration values hold the same, for a plot to tell a new configuration from one built again. */
+export declare class ConfigEquality {
+    #private;
+    /** How many levels of objects and arrays it looks into; a value nested deeper only matches as the same object. */
+    static readonly MAX_DEPTH = 6;
+    /**
+     * Whether `a` and `b` are the same value, or plain objects and arrays alike all the way down, dates of one
+     * time; anything else - a function, a class instance - only if it is the same object.
+     */
+    static same(a: unknown, b: unknown, depth?: number): boolean;
+}