@fundar/data-chart-telling 1.0.0 → 1.2.0

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

@@ -48,8 +48,10 @@ export type HoverConfig<TRow extends Record<string, unknown>> = {
     strategy?: HoverStrategy;
     /** Resolved sync flag for the *local* hover store (ignored once a shared store is in scope). */
     sync?: boolean;
+    /** The resolved tooltip: its `format`, and the order its text reads the rows in (a `content` snippet gets them as matched). */
     tooltip?: TooltipConfig<TRow> & {
         format: (row: TRow) => string;
+        sort?: (a: TRow, b: TRow) => number;
     };
     /** When it returns `true`, that pointer event is treated as a leave instead of a move - lets a nested layout opt part of the plot out of hover matching. */
     exclude?: (e: PointerEvent) => boolean;
@@ -93,7 +95,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;
 };

package/dist/utils/OpacityScale.d.ts

@@ -0,0 +1,14 @@
+import type { OpacityScaleConfig } from '../types/layout/scales';
+/** A value of the opacity channel mapped to an opacity. */
+export declare class OpacityScale {
+    /**
+     * Resolves an {@link OpacityScaleConfig} into a `value => opacity` function -
+     * mirrors {@link ColorRamp.resolve}'s shape, but the output is always a number in
+     * roughly `[0,1]` instead of a CSS color string. Callers must apply the
+     * result as a literal constant per mark instance (never a per-row function
+     * handed straight to svelteplot) - see the type's own doc comment for why.
+     */
+    static resolve(config: OpacityScaleConfig | undefined, computedDomain: [number, number] | string[] | undefined, defaultRange: [number, number]): (value: unknown) => number;
+}
+/** The package's public function name, over {@link OpacityScale.resolve}. */
+export declare const resolveOpacityScale: typeof OpacityScale.resolve;

package/dist/utils/OpacityScale.js

@@ -0,0 +1,43 @@
+import { ColorRamp } from './color';
+/** A value of the opacity channel mapped to an opacity. */
+export class OpacityScale {
+    /**
+     * Resolves an {@link OpacityScaleConfig} into a `value => opacity` function -
+     * mirrors {@link ColorRamp.resolve}'s shape, but the output is always a number in
+     * roughly `[0,1]` instead of a CSS color string. Callers must apply the
+     * result as a literal constant per mark instance (never a per-row function
+     * handed straight to svelteplot) - see the type's own doc comment for why.
+     */
+    static resolve(config, computedDomain, defaultRange) {
+        const domain = config?.domain ?? computedDomain;
+        const range = config?.range ?? defaultRange;
+        const unknown = config?.unknown ?? 1;
+        if (!domain || domain.length === 0)
+            return () => unknown;
+        if (typeof range === 'object' && !Array.isArray(range)) {
+            return (v) => (v == null ? unknown : (range[String(v)] ?? unknown));
+        }
+        if (typeof domain[0] === 'string') {
+            const categories = domain;
+            const [lo, hi] = range;
+            return (v) => {
+                if (v == null)
+                    return unknown;
+                const idx = categories.indexOf(String(v));
+                if (idx < 0)
+                    return unknown;
+                return categories.length > 1 ? lo + ((hi - lo) * idx) / (categories.length - 1) : lo;
+            };
+        }
+        const [dLo, dHi] = domain;
+        const [rLo, rHi] = range;
+        return (v) => {
+            if (v == null)
+                return unknown;
+            const t = ColorRamp.normalize(Number(v), dLo, dHi);
+            return rLo + (rHi - rLo) * t;
+        };
+    }
+}
+/** The package's public function name, over {@link OpacityScale.resolve}. */
+export const resolveOpacityScale = OpacityScale.resolve;

package/dist/utils/{symbol.d.ts → SymbolPath.d.ts}

@@ -1,16 +1,4 @@
-import type { SymbolScaleConfig } from '../types/layout/scales';
 import type { SymbolType } from '../types/plots/constants';
-/**
- * Resolves a {@link SymbolScaleConfig} into a `value => shape` function -
- * always a discrete category lookup, unlike every other channel here (there's
- * no continuous case for a shape). Resolves to a plain shape-name string,
- * which svelteplot recognizes as a literal and renders as-is - safe to hand
- * straight to a per-row accessor, unlike `resolveOpacityScale`'s output.
- * `defaultRange` mirrors `resolveOpacityScale`'s own required (not defaulted)
- * parameter - callers pass the theme's own `cfg.symbols` rather than this
- * module hardcoding a second copy of the default cycle.
- */
-export declare function resolveSymbolScale(config: SymbolScaleConfig | undefined, computedDomain: string[] | undefined, defaultRange: SymbolType[]): (value: unknown) => SymbolType;
 /**
  * A symbol's SVG path, as svelteplot's `dot` mark draws it: the same
  * d3-shape symbol, sized to the area of a circle of the given radius.