@fundar/data-chart-telling 1.1.0 → 1.3.0

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

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

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

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

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

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

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

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

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

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

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

@@ -1,9 +1,9 @@
-import type { BasePlotProps, PlotCoreProps } from '../props';
-import type { AxisBasedScalesConfig } from '../../layout/scales';
-import type { AxisBasedMarkersConfig } from '../../markers/common';
-import type { SeriesProps, DataProps } from '../data/common';
-import type { GapsAwarePlotStylesConfig } from '../../layout/styles';
-import type { BarSegmentStyle } from '../segments/common';
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { 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> | DataProps<TData>, TData, GapsAwarePlotStylesConfig<BarSegmentStyle>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `PyramidPlot`'s core draws from. */

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

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

package/dist/types/plots/{pyramid → 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 { Series } from '../../data/common';
+import type { BarSegmentStyle } from '../../segments/common';
+import type { AxisPlotState, AxisPlotCtx } 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> & {

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

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

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

@@ -0,0 +1,23 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { 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 & {
+    kernel?: DensityKernel;
+    /** Kernel bandwidth in data units; Silverman's rule picks one per violin when unset. */
+    bandwidth?: number;
+    /** Cuts each violin at its values' own extent. Defaults to `true`; `false` lets the tails fade out past it, which the value axis does not reach. */
+    trim?: boolean;
+    /** `'width'` gives every violin the same full width; `'shared'` draws all of them on one density scale, so their areas compare. Defaults to `'width'`. */
+    scale?: 'width' | 'shared';
+    /** The box inside each violin: `false` leaves it out, a number sets its width in pixels. */
+    box?: boolean | number;
+};
+/** `ViolinPlot`'s public props. */
+export type ViolinPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DataProps<TData>, TData, ViolinPlotStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `ViolinPlot`'s core draws from. */
+export type ViolinPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DataProps<TData>, TData, ViolinPlotStylesConfig, AreaStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

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

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

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

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

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

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

package/dist/types/plots/{area → evolution/area}/props.d.ts

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

package/dist/types/plots/evolution/area/props.js

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

package/dist/types/plots/{area → evolution/area}/state.d.ts

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

package/dist/types/plots/evolution/area/state.js

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

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

@@ -0,0 +1,10 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { 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> | DataProps<TData>, TData, GapsAwarePlotStylesConfig<LineSegmentStyle> & CurveAwarePlotStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `LinePlot`'s core draws from. */
+export type LinePlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DataProps<TData>, TData, GapsAwarePlotStylesConfig<LineSegmentStyle> & CurveAwarePlotStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/evolution/line/props.js

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

package/dist/types/plots/{line → evolution/line}/state.d.ts

@@ -1,6 +1,6 @@
-import type { GapsConfig } from '../gaps';
-import type { LineSegmentStyle } from '../segments/common';
-import type { AxisPlotState, AxisPlotCtx } from '../../phases';
+import type { GapsConfig } from '../../gaps';
+import type { LineSegmentStyle } from '../../segments/common';
+import type { AxisPlotState, AxisPlotCtx } 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>;

package/dist/types/plots/evolution/line/state.js

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

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

@@ -0,0 +1,5 @@
+import type { LinePlotProps, LinePlotCoreProps } from '../line/props';
+/** `SlopePlot`'s public props: a line plot's, over a category axis of two positions. */
+export type SlopePlotProps<TData extends Record<string, unknown>> = LinePlotProps<TData>;
+/** What `SlopePlot`'s core draws from. */
+export type SlopePlotCoreProps<TData extends Record<string, unknown>> = LinePlotCoreProps<TData>;

package/dist/types/plots/evolution/slope/props.js

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

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

@@ -0,0 +1,5 @@
+import type { LinePlotState, LinePlotCtx } 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;

package/dist/types/plots/evolution/slope/state.js

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

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

@@ -0,0 +1,5 @@
+import type { LinePlotProps, LinePlotCoreProps } from '../line/props';
+/** `SparklinePlot`'s public props: a line plot's. */
+export type SparklinePlotProps<TData extends Record<string, unknown>> = LinePlotProps<TData>;
+/** What `SparklinePlot`'s core draws from. */
+export type SparklinePlotCoreProps<TData extends Record<string, unknown>> = LinePlotCoreProps<TData>;

package/dist/types/plots/evolution/sparkline/props.js

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

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

@@ -0,0 +1,5 @@
+import type { LinePlotState, LinePlotCtx } 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;

package/dist/types/plots/evolution/sparkline/state.js

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

package/dist/types/plots/{geo → map/geo}/props.d.ts

@@ -1,11 +1,11 @@
-import type { BasePlotProps, PlotCoreProps } from '../props';
-import type { GeoScalesConfig, CoordinatesConfig } from '../../layout/coordinates';
-import type { GeoFeature, GeoDataProps } from '../data/geo';
-import type { GeoStylesConfig } from '../../layout/styles';
-import type { GeoSegmentStyle } from '../segments/common';
-import type { GeoMarkersConfig } from '../../markers/geo';
-import type { TimelineConfig } from '../../layout/timeline';
-import type { FacetConfig } from '../../layout/facet';
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { GeoScalesConfig, CoordinatesConfig } from '../../../layout/coordinates';
+import type { GeoFeature, GeoDataProps } from '../../data/geo';
+import type { GeoStylesConfig } from '../../../layout/styles';
+import type { GeoSegmentStyle } from '../../segments/common';
+import type { GeoMarkersConfig } from '../../../markers/geo';
+import type { TimelineConfig } from '../../../layout/timeline';
+import type { FacetConfig } from '../../../layout/facet';
 /** `Omit` on each member of a union, so the union (and what tells its members apart) survives. */
 type OmitEach<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
 /**

package/dist/types/plots/map/geo/props.js

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

package/dist/types/plots/{geo → map/geo}/state.d.ts

@@ -1,14 +1,15 @@
-import type { Accessor } from '../data/common';
-import type { GeoFeature } from '../data/geo';
-import type { GeoScalesConfig } from '../../layout/coordinates';
-import type { SegmentsConfig, MarginConfig, HoverConfig } from '../props';
-import type { HoverPosition } from '../../phases';
-import type { TooltipProp } from '../../layout/tooltip';
-import type { GeoSegmentStyle } from '../segments/common';
-import type { GeoMarkersConfig } from '../../markers/geo';
-import type { MarkerConfig } from '../../markers/all';
-import type { PlotStylesConfig } from '../../configuration/styling';
-import type { LegendDisabledStyle } from '../../layout/legend';
+import type { Accessor } from '../../data/common';
+import type { GeoFeature } from '../../data/geo';
+import type { ColorScaleConfig } from '../../../layout/scales';
+import type { GeoScalesConfig } from '../../../layout/coordinates';
+import type { SegmentsConfig, MarginConfig, HoverConfig } from '../../props';
+import type { HoverPosition } from '../../../phases';
+import type { TooltipProp } from '../../../layout/tooltip';
+import type { GeoSegmentStyle } from '../../segments/common';
+import type { GeoMarkersConfig } from '../../../markers/geo';
+import type { MarkerConfig } from '../../../markers/all';
+import type { PlotStylesConfig } from '../../../configuration/styling';
+import type { LegendDisabledStyle } from '../../../layout/legend';
 /** One feature tagged with its resolved id/centroid as plain fields. */
 export type TaggedGeoFeature<TProps extends Record<string, unknown>> = GeoFeature<TProps> & {
     __id: string;
@@ -56,6 +57,12 @@ export type GeoPlotState<TProps extends Record<string, unknown>> = {
     features?: TaggedGeoFeature<TProps>[];
     /** "scales" phase output: the `[min, max]` the color ramp spans, before any legend range narrows it - `undefined` without a `color`. */
     colorDomain?: [number, number];
+    /** "scales" phase output: the ramp of each segment that sets its own `scales.color`, over just its own features. */
+    colorRamps?: {
+        name: string;
+        domain: [number, number];
+        scale: ColorScaleConfig;
+    }[];
     /** "scales" phase output: the `[min, max]` of the `opacity` values - `undefined` without an `opacity`. */
     opacityDomain?: [number, number];
     /** "scales" phase output: each feature's own resolved color, composed from `color` and the color ramp - `undefined` where `color` itself is unset/returns nothing. */

package/dist/types/plots/map/geo/state.js

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

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

@@ -3,7 +3,7 @@ import type { Snippet } from 'svelte';
 import type { TooltipOptions, TooltipProp } from '../layout/tooltip';
 import type { HoverPoint, HoverStrategy } from '../layout/hover';
 import type { LegendExtension, LegendSection } from '../layout/legend';
-import type { FacetConfig } from '../layout/facet';
+import type { FacetConfig, FacetScoped } from '../layout/facet';
 import type { GridPlacement } from '../layout/grid';
 import type { TimelineConfig } from '../layout/timeline';
 import type { Segment } from './segments/config';
@@ -14,8 +14,11 @@ import type { MarkerTransform } from '../transforms';
 /** The `styles` prop accepted by every plot kind - its own
  * styles shape ({@link AxisBasedStylesConfig}, `GeoStylesConfig`, …). */
 export type StylesConfig<TStyles extends object> = TStyles;
-/** The `markers` prop accepted by every plot kind - a list of that kind's own marker union. */
-export type MarkersConfig<TMarker> = TMarker[];
+/**
+ * The `markers` prop accepted by every plot kind - a list of that kind's own marker union, each of
+ * which can be limited to some facet panels with `facet`.
+ */
+export type MarkersConfig<TMarker> = (TMarker & FacetScoped)[];
 /**
  * The `segments` prop - series name (or `'default'`) to its {@link Segment}s.
  * Area-specific segments win over catch-all ones.
@@ -95,7 +98,7 @@ export type PlotChromeConfig = {
      * The figure's legend: unset or `true`, the one its plots read as - their
      * series, scales, and the segments and markers that name themselves; `false`,
      * none; a list of sections, exactly those; `{ items, sections }`, the
-     * automatic one with those added, and `{ series, color, opacity, size,
+     * automatic one with those added, and `{ series, color, opacity, r,
      * symbol }`, with the section of each channel adjusted (see {@link LegendExtension}).
      */
     legend?: LegendSection[] | LegendExtension | boolean;

package/dist/types/plots/{bar → ranking/bar}/props.d.ts

@@ -1,9 +1,9 @@
-import type { BasePlotProps, PlotCoreProps } from '../props';
-import type { AxisBasedScalesConfig } from '../../layout/scales';
-import type { AxisBasedMarkersConfig } from '../../markers/common';
-import type { SeriesProps, DataProps } from '../data/common';
-import type { GapsAwarePlotStylesConfig } from '../../layout/styles';
-import type { BarSegmentStyle } from '../segments/common';
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { 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> | DataProps<TData>, TData, GapsAwarePlotStylesConfig<BarSegmentStyle>, BarSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
 /** What `BarPlot`'s core draws from. */

package/dist/types/plots/ranking/bar/props.js

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

package/dist/types/plots/{bar → ranking/bar}/state.d.ts

@@ -1,5 +1,5 @@
-import type { AxisPlotState, AxisPlotCtx } from '../../phases';
-import type { BarSegmentStyle } from '../segments/common';
+import type { AxisPlotState, AxisPlotCtx } 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. */

package/dist/types/plots/ranking/bar/state.js

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

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

@@ -0,0 +1,22 @@
+import type { BulletStylesConfig } from '../../../layout/styles';
+import type { BarPlotProps, BarPlotCoreProps } from '../bar/props';
+import type { Accessor } from '../../data/common';
+/**
+ * What a bullet plot measures each category against: a `target`, and the
+ * `ranges` that grade the value. Each is a field of the row, a function of
+ * it, or a number the same for every category.
+ */
+export type BulletReferenceProps<TData extends Record<string, unknown>> = {
+    /** Where the value should get to: a tick across the category's band at this value. */
+    target?: Accessor<TData, number> | number;
+    /** The upper bounds of the bands that grade the value, in any order: each runs from the baseline to its bound, the smallest band darkest. */
+    ranges?: (Accessor<TData, number> | number)[];
+};
+/** `BulletPlot`'s public props: a bar plot with a target and ranges. */
+export type BulletPlotProps<TData extends Record<string, unknown>> = Omit<BarPlotProps<TData>, 'styles'> & BulletReferenceProps<TData> & {
+    styles?: BulletStylesConfig;
+};
+/** What `BulletPlot`'s core draws from. */
+export type BulletPlotCoreProps<TData extends Record<string, unknown>> = Omit<BarPlotCoreProps<TData>, 'styles'> & BulletReferenceProps<TData> & {
+    styles?: BulletStylesConfig;
+};

package/dist/types/plots/ranking/bullet/props.js

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

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

@@ -0,0 +1,5 @@
+import type { BarPlotState, BarPlotCtx } 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;

package/dist/types/plots/ranking/bullet/state.js

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

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

@@ -0,0 +1,10 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { 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> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `ClevelandPlot`'s core draws from. */
+export type ClevelandPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/ranking/cleveland/props.js

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

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

@@ -0,0 +1,49 @@
+import type { AxisPlotState, AxisPlotCtx, ProcessedRow } from '../../../phases';
+import type { LineSegmentStyle } from '../../segments/common';
+/** ClevelandPlot's pipeline state (shared by its wrappers): the shared axis-based state, with no extras of its own. */
+export type ClevelandPlotState<TData extends Record<string, unknown>> = AxisPlotState<TData, LineSegmentStyle>;
+/** The environment every ClevelandPlot phase reads from, alongside the growing state. */
+export type ClevelandPlotCtx = AxisPlotCtx;
+/** The configuration blocks the Cleveland-style plots draw their defaults from: one per plot. */
+export type ClevelandConfigKey = 'lollipop' | 'dumbbell' | 'cleveland' | 'forest';
+/** One category's dots along the value axis: the row each one draws, and the range they span. */
+export type ClevelandEntry = {
+    category: unknown;
+    dots: {
+        row: ProcessedRow;
+        value: number;
+        series: string;
+    }[];
+    /** The smallest value of the category - or the baseline, when that is lower and counts as an end. */
+    from: number;
+    /** The largest value of the category - or the baseline, when that is higher and counts as an end. */
+    to: number;
+    /** The `to` series' value minus the `from` series' (the value minus the baseline, for a stem) - `undefined` when either has none. */
+    difference: number | undefined;
+    /** The stretch between the `from` series' dot and the `to` series' - lowest value first - `undefined` when either has none. With a baseline, the whole range. */
+    span: [number, number] | undefined;
+    /** Where the difference goes, from the `from` end to the `to` end - not sorted: an arrow's way. `undefined` when either end has no value. */
+    change: [number, number] | undefined;
+};
+/** Where a dot sits in its category's range: at the top end, at the bottom end, or between them. */
+export type ClevelandRole = 'max' | 'min' | 'between';
+/** What a wrapper plot checks about the layout of its series before drawing. */
+export type ClevelandLayout = {
+    /** How many series the plot draws. */
+    seriesCount: number;
+    /** The most series any one category has a value in. */
+    maxSeriesPerCategory: number;
+};
+/** How a plot of the Cleveland family is set apart from its siblings. */
+export type ClevelandOptions = {
+    /** Name the plot's warnings go under, such as `'DumbbellPlot'`. */
+    name: string;
+    /** The configuration block the plot reads its dot radius, stem width, padding and label gap from. */
+    config: ClevelandConfigKey;
+    /** Whether the baseline counts as one end of every range, so a lone value is a stem rising from it (`true`), or the range is only what the values span. */
+    fromBaseline?: boolean;
+    /** Whether each dot stands for an interval - its row's `lower` and `upper`, or `error` around it - which its connector spans, instead of the dots of its category. */
+    interval?: boolean;
+    /** What is wrong with the series layout, if anything: the plot warns once and draws anyway. */
+    validate?: (layout: ClevelandLayout) => string | undefined;
+};

package/dist/types/plots/ranking/cleveland/state.js

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

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

@@ -0,0 +1,10 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { 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> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `DumbbellPlot`'s core draws from. */
+export type DumbbellPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/ranking/dumbbell/props.js

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

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

@@ -0,0 +1,5 @@
+import type { ClevelandPlotState, ClevelandPlotCtx } from '../cleveland/state';
+/** DumbbellPlot's pipeline state: a ClevelandPlot's. */
+export type DumbbellPlotState<TData extends Record<string, unknown>> = ClevelandPlotState<TData>;
+/** The environment every DumbbellPlot phase reads from, alongside the growing state. */
+export type DumbbellPlotCtx = ClevelandPlotCtx;

package/dist/types/plots/ranking/dumbbell/state.js

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

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

@@ -0,0 +1,23 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps, Accessor } from '../../data/common';
+import type { ConnectorBasedStylesConfig } from '../../../layout/styles';
+import type { LineSegmentStyle } from '../../segments/common';
+/**
+ * The interval each point stands for, as fields of its row (or functions of
+ * it): its `lower` and `upper` ends, or an `error` that reaches that far either
+ * side of it. A point with none of them draws as a dot alone.
+ */
+export type ForestIntervalProps<TData extends Record<string, unknown>> = {
+    /** The lower end of each row's interval. */
+    lower?: Accessor<TData, number>;
+    /** The upper end of each row's interval. */
+    upper?: Accessor<TData, number>;
+    /** 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>;
+};
+/** `ForestPlot`'s public props. */
+export type ForestPlotProps<TData extends Record<string, unknown>> = BasePlotProps<SeriesProps<TData> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>> & ForestIntervalProps<TData>;
+/** What `ForestPlot`'s core draws from. */
+export type ForestPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>> & ForestIntervalProps<TData>;

package/dist/types/plots/ranking/forest/props.js

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

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

@@ -0,0 +1,5 @@
+import type { ClevelandPlotState, ClevelandPlotCtx } from '../cleveland/state';
+/** ForestPlot's pipeline state: a ClevelandPlot's. */
+export type ForestPlotState<TData extends Record<string, unknown>> = ClevelandPlotState<TData>;
+/** The environment every ForestPlot phase reads from, alongside the growing state. */
+export type ForestPlotCtx = ClevelandPlotCtx;

package/dist/types/plots/ranking/forest/state.js

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

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

@@ -0,0 +1,10 @@
+import type { BasePlotProps, PlotCoreProps } from '../../props';
+import type { AxisBasedScalesConfig } from '../../../layout/scales';
+import type { AxisBasedMarkersConfig } from '../../../markers/common';
+import type { SeriesProps, DataProps } from '../../data/common';
+import type { 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> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;
+/** What `LollipopPlot`'s core draws from. */
+export type LollipopPlotCoreProps<TData extends Record<string, unknown>> = PlotCoreProps<SeriesProps<TData> | DataProps<TData>, TData, ConnectorBasedStylesConfig, LineSegmentStyle, AxisBasedMarkersConfig, AxisBasedScalesConfig<TData>>;

package/dist/types/plots/ranking/lollipop/props.js

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

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

@@ -0,0 +1,5 @@
+import type { ClevelandPlotState, ClevelandPlotCtx } from '../cleveland/state';
+/** LollipopPlot's pipeline state: a ClevelandPlot's. */
+export type LollipopPlotState<TData extends Record<string, unknown>> = ClevelandPlotState<TData>;
+/** The environment every LollipopPlot phase reads from, alongside the growing state. */
+export type LollipopPlotCtx = ClevelandPlotCtx;

package/dist/types/plots/ranking/lollipop/state.js

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

package/dist/types/plots/segments/common.d.ts

@@ -1,6 +1,9 @@
 import type { StrokeStyle, DotStyle, AreaStyle } from '../styling';
-/** Per-segment styling for a line: its stroke and/or its endpoint dots. */
+import type { CurveName } from '../../layout/styles/curve';
+/** Per-segment styling for a line: its curve, its stroke and/or its endpoint dots. */
 export type LineSegmentStyle = {
+    /** How the segment joins its points; `'step'` and its kin draw stairs. Falls back to `styles.curve`, then `'linear'`. */
+    curve?: CurveName;
     stroke?: StrokeStyle;
     dots?: DotStyle;
 };