@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/stagger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * How one `progress` becomes a staggered per-datum reveal, and the orders a
+ * stagger runs in: by position, by a hash of the key, or a grid's reading
+ * order. Pure; internal to the charts.
+ */
+import type { BandKey, Range } from "@sophistry/core/geometry";
+import type { StaggerOrder } from "./props";
+/**
+ * One datum's share of a reveal staggered across `count` data: start times
+ * spread over `spread` of the reveal, each datum taking `1 - spread`, so the
+ * last ends at `progress = 1` and 5 or 500 bars take equally long.
+ *
+ * @param rank - This datum's place in the reveal order, 0-based.
+ * @param spread - 0 (all together) to just under 1 (one after another).
+ * @returns This datum's own progress, 0..1.
+ */
+export declare function staggered(progress: number, rank: number, count: number, spread: number): number;
+/** Each value's 0-based place in ascending order: the left-to-right reveal order. Ties keep data order; non-finite values go last. */
+export declare function ranks(values: readonly number[]): number[];
+/** Each key's place in a "random" reveal order: ascending by a hash of the key, so it looks shuffled but is the same every frame and when scrubbed. */
+export declare function hashRanks(keys: readonly BandKey[]): number[];
+/**
+ * Each key's place in a stagger by `staggerOrder`: by key hash under
+ * `"random"`, else ascending by `position` (non-finite last, ties in key
+ * order).
+ *
+ * @param order - Omitted, `"position"`.
+ * @returns `rank[i]` for `keys[i]`.
+ */
+export declare function orderRanks(keys: readonly BandKey[], order: StaggerOrder | undefined, position: (key: BandKey, index: number) => number): number[];
+/** Which axes run backwards on screen (a range given end first, or `reverse`), for {@link readingRanks}. */
+export declare function reversedAxes(xRange: Readonly<Range>, yRange: Readonly<Range>): {
+    x: boolean;
+    y: boolean;
+};
+/**
+ * Each cell's place in screen reading order: top row first, each row left to
+ * right. Cells sharing a `y` are one row; ties keep data order.
+ *
+ * @param cells - One position per cell that is the same across a row, in data units.
+ * @param reversed - Axes that run backwards on screen ({@link reversedAxes}).
+ * @returns `rank[i]` for cell `i`.
+ */
+export declare function readingRanks(cells: readonly {
+    readonly x: number;
+    readonly y: number;
+}[], reversed?: {
+    readonly x?: boolean;
+    readonly y?: boolean;
+}): number[];
+/** Above this many cells a grid fades in as one, unstaggered. */
+export declare const GRID_STAGGER_LIMIT = 2000;
+/** A gridded layer's stagger: the one given, else 0.5, dropped to 0 above {@link GRID_STAGGER_LIMIT} cells. */
+export declare function gridStagger(stagger: number | undefined, count: number): number;
+//# sourceMappingURL=stagger.d.ts.map

package/dist/stagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagger.d.ts","sourceRoot":"","sources":["../src/stagger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACZ,MAAM,CAKR;AAED,sIAAsI;AACtI,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAWzD;AAED,uJAAuJ;AACvJ,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,SAAS,OAAO,EAAE,EACxB,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAC/C,MAAM,EAAE,CAIV;AAED,4GAA4G;AAC5G,wBAAgB,YAAY,CAC3B,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,EACvB,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GACrB;IAAE,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,EAAE,OAAO,CAAA;CAAE,CAE5B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC5D,QAAQ,CAAC,EAAE;IAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,MAAM,EAAE,CAgBV;AAED,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,+GAA+G;AAC/G,wBAAgB,WAAW,CAC1B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GACX,MAAM,CAGR"}

package/dist/statistics/box-plot.d.ts

@@ -0,0 +1,152 @@
+/**
+ * `boxPlot`: a box-and-whisker plot, its own chart with one box per group.
+ *
+ * The preset reads each group's sample and name (`groups.ts`), lays the
+ * groups out on a band x axis and fits a value y axis, and draws its boxes
+ * through an inner layer. Each box is whiskers with caps, a box over the
+ * quartiles, a median line and outlier dots. The layer draws every box,
+ * whisker and median as **one path batch** (each box's outlines differ, and
+ * one batch keeps the paint order within a box: whiskers, box, median),
+ * and the outliers as **one instances node** of circles keyed by box and
+ * outlier. Hover resolves per item (`event.item`).
+ *
+ * Reveals and keyed transitions are geometry: a box opens
+ * out of its median (its edges `opened` of the way to the quartiles), then
+ * its whiskers reach out (each part drawn whole once begun), then each
+ * outlier traces its outline as its fill comes up (its item's `progress`).
+ */
+import type { SceneNode } from "@sophistry/core";
+import type { ColorInput } from "@sophistry/core/color";
+import type { BandKey, Point, Range } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel } from "../data/channels";
+import type { ChartYAxisOptions } from "../frame/types";
+import type { RevealProps, TransitionProps } from "../props";
+/**
+ * Props of {@link boxPlot}. `values` is required unless `data` is
+ * `number[][]`.
+ *
+ * @category Charts
+ */
+export interface BoxPlotProps<T = unknown> extends TransitionProps<T>, RevealProps {
+    /** One box per datum, each holding (or yielding via `values`) one group's raw sample. */
+    data: readonly T[];
+    /**
+     * The group's raw sample, in data units. Defaults to the datum when `data` is `number[][]`;
+     * required otherwise. Non-finite entries are dropped.
+     */
+    values?: Channel<T, readonly number[]>;
+    /** The name drawn under each box. With a `series`, boxes sharing a name share its slot. */
+    label?: Channel<T, string>;
+    /**
+     * The series each box belongs to: colours boxes through the chart's colour scale and legend;
+     * with a `label`, boxes sharing a name stand side by side in its slot. `color` wins.
+     */
+    series?: Channel<T, BandKey>;
+    /**
+     * The legend for `series`: `"right"`, `"top"`, or `false`. As `chart`'s `legend`. Defaults to
+     * `"right"` with a series.
+     */
+    legend?: boolean | "right" | "top";
+    /** `[min, max, step?]` in data units. Omitted, fitted to every group's data (including 0). */
+    yRange?: Range;
+    /** Width of the plotting area. */
+    width: number;
+    /** Height of the plotting area. */
+    height: number;
+    /** Centre of the plotting area. Defaults to the origin. */
+    center?: Point;
+    /**
+     * Box width as a fraction of the slot pitch.
+     * @default 0.6
+     */
+    boxWidth?: number;
+    /**
+     * Tukey fence multiplier: how many IQRs past the box a whisker may reach before a point is an
+     * outlier.
+     * @default 1.5
+     */
+    whiskerScale?: number;
+    /**
+     * One colour for every box, or `(d, i) => colour`. Wins over `colors` and `series` (whose
+     * legend then goes).
+     */
+    color?: ColorChannel<T>;
+    /**
+     * Colours cycled across the boxes by index, or across the `series` categories. Defaults to the
+     * theme's categorical colours.
+     */
+    colors?: readonly ColorInput[];
+    /**
+     * Fill opacity, 0..1.
+     * @default 0.75
+     */
+    fillOpacity?: number;
+    /**
+     * The value axis: `false` hides it; an object styles it and sets its ticks.
+     * @default true
+     */
+    yAxis?: boolean | ChartYAxisOptions;
+    /**
+     * Whether to draw the line the boxes stand on.
+     * @default true
+     */
+    baseline?: boolean;
+    /**
+     * Font size of the box labels.
+     * @default 0.28
+     */
+    labelFontSize?: number;
+    /**
+     * Reveal, 0..1: the frame first, then each box opens out of its median, its whiskers reach out,
+     * and its outliers fade in.
+     * @default 1
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the boxes' reveal spent staggering box after box, left to right, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    /**
+     * The data to transition to, groups matched by `label` and `series` (else by place): statistics
+     * move to their new values, outliers move with the box, new groups open from their median and
+     * removed ones close. See {@link TransitionProps}.
+     * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+     */
+    to?: readonly T[];
+    /** Paint order; higher draws later. */
+    zIndex?: number;
+    visible?: boolean;
+    /** Drawn inside the chart's coordinate context. */
+    children?: readonly SceneNode[];
+}
+/**
+ * A box-and-whisker plot: one box per group over the quartiles with the
+ * median marked, whiskers to the furthest points within `whiskerScale` IQRs,
+ * and outliers as dots. It is its own plot, sized by `width`/`height`; don't
+ * put it inside an `axes` or `chart`. Boxes, whiskers and medians draw as one
+ * path batch, outliers as one instances node. See {@link boxplotStats} for
+ * the statistics alone.
+ *
+ * @example
+ * ```ts
+ * import { boxPlot } from "@sophistry/charts";
+ *
+ * boxPlot.create({
+ * 	data: [
+ * 		{ arm: "control", scores: [3, 4, 4, 5, 6, 7, 12] },
+ * 		{ arm: "treated", scores: [5, 6, 7, 7, 8, 9, 10] },
+ * 	],
+ * 	values: "scores",
+ * 	label: "arm",
+ * 	width: 6,
+ * 	height: 4,
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#box-and-violin-plots
+ * @category Charts
+ */
+export declare const boxPlot: import("@sophistry/core").Definition<BoxPlotProps<any>, import("@sophistry/core/internal").CompositeNode<BoxPlotProps<any>>, keyof BoxPlotProps<any>>;
+//# sourceMappingURL=box-plot.d.ts.map

package/dist/statistics/box-plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box-plot.d.ts","sourceRoot":"","sources":["../../src/statistics/box-plot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAKX,SAAS,EACT,MAAM,iBAAiB,CAAC;AAOzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAOtE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,KAAK,EAAc,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAcpE,OAAO,KAAK,EAAY,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAwBvE;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,CACxC,SAAQ,eAAe,CAAC,CAAC,CAAC,EACzB,WAAW;IACZ,yFAAyF;IACzF,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACvC,2FAA2F;IAC3F,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;IACnC,8FAA8F;IAC9F,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAChC;AA0kBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,OAAO,uJA8ClB,CAAC"}

package/dist/statistics/error-bar.d.ts

@@ -0,0 +1,149 @@
+/**
+ * `errorBar`: a marker per datum with capped vertical and horizontal error
+ * bars, drawn as two instances nodes.
+ *
+ * Follows `points/scatter.ts` step for step. Every bar and cap of every
+ * point is one item of a `line` instances node (keyed by the datum's key and
+ * the part: `y`, `y0`, `y1`, `x`, `x0`, `x1`), every marker one item of a
+ * `circle` instances node (keyed by the datum's key). The bars draw first
+ * and the markers over them.
+ *
+ * The reveal is geometry: each bar grows out of its marker
+ * (its ends `shown` of the way out) and its caps widen with it, so a bar is
+ * drawn whole once it has begun; the marker traces its outline as its fill
+ * comes up (its item's `progress`).
+ * Under the mark's `transition`, an entering bar draws out of its marker
+ * and a leaving one draws back into it; markers grow and shrink.
+ */
+import type { BandKey } from "@sophistry/core/geometry";
+import type { MarkTransition } from "../batch";
+import type { Channel, ColorChannel, PositionValue } from "../data/channels";
+import type { KeyedTransitionProps, RevealProps, StaggerOrder } from "../props";
+/**
+ * An error magnitude: a symmetric `±e`, or an asymmetric `[lower, upper]` pair.
+ *
+ * @category Charts
+ */
+export type ErrorMagnitude = number | readonly [lower: number, upper: number];
+/**
+ * Props of {@link errorBar}. `x` and `y` are required unless `data` is
+ * `number[]` (x = index, y = value).
+ *
+ * @category Charts
+ */
+export interface ErrorBarProps<T = unknown> extends KeyedTransitionProps<T>, RevealProps {
+    /** One marker (with optional bars) per datum; data with a non-finite `x` or `y` are skipped. */
+    data: readonly T[];
+    /**
+     * X position, in data units (a `Date` reads as epoch ms). Defaults to the index when `data` is
+     * `number[]`; required otherwise.
+     */
+    x?: Channel<T, PositionValue>;
+    /**
+     * Y position, in data units (a `Date` reads as epoch ms). Defaults to the datum when `data` is
+     * `number[]`; required otherwise.
+     */
+    y?: Channel<T, PositionValue>;
+    /**
+     * Vertical error, in data units: a symmetric `±e` or an asymmetric `[lower, upper]`. A datum
+     * without a finite magnitude gets no bar.
+     */
+    yError?: Channel<T, ErrorMagnitude>;
+    /** Horizontal error, in data units; same forms as `yError`. */
+    xError?: Channel<T, ErrorMagnitude>;
+    /**
+     * The series each point belongs to: colours markers and bars through the chart's shared colour
+     * scale and legend. `color` and `stroke` win.
+     */
+    series?: Channel<T, BandKey>;
+    /**
+     * Each point's identity across data changes and transitions. See {@link KeyedTransitionProps}.
+     * Defaults to the datum's place within its `series`, else its index.
+     */
+    key?: Channel<T, BandKey>;
+    /**
+     * Colour of the marker and both bars, constant or `(d, i) => colour`. Defaults to `stroke`,
+     * else the `series` colour, else the theme's first series colour.
+     */
+    color?: ColorChannel<T>;
+    /**
+     * Marker radius.
+     * @default 0.09
+     */
+    markerRadius?: number;
+    /**
+     * Width of the caps at each end of a bar.
+     * @default 0.15
+     */
+    capSize?: number;
+    /**
+     * Fraction of the reveal spent staggering point after point, left to right, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    /**
+     * The order `stagger` and `enterStagger` take. See {@link StaggerOrder}.
+     * @default "position"
+     */
+    staggerOrder?: StaggerOrder;
+    /**
+     * Fraction of a transition's enter stage spent staggering entering points, in `staggerOrder`.
+     * See {@link TransitionProps}.
+     * @default 0
+     */
+    enterStagger?: number;
+    /**
+     * The data to transition to, matched to `data` by `key`: markers and bar ends move to their new
+     * places; new points fade in with bars drawing outward, removed ones draw back in. See {@link
+     * KeyedTransitionProps}.
+     * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+     */
+    to?: readonly T[];
+    /**
+     * How points move when `data` changes (outside a `to` blend): a tween or
+     * a spring in the nodes' tween banks; new bars draw out of their markers,
+     * removed ones draw back in. Omitted, data changes are instant.
+     */
+    transition?: MarkTransition;
+    /** Colour of marker and bars when neither `color` nor `series` gives one (a colour; batched items take no gradients). */
+    stroke?: string;
+    /** Bar thickness. Defaults to the theme's stroke width. */
+    strokeWidth?: number;
+    /** Opacity 0..1. @default 1 */
+    opacity?: number;
+    /** Reveal 0..1: each bar grows out of its marker, which draws in. @default 1 */
+    progress?: number;
+    /** Paint order. */
+    zIndex?: number;
+    /** Set to false to hide the points. */
+    visible?: boolean;
+}
+/**
+ * A marker at each `(x, y)` with optional capped vertical (`yError`) and
+ * horizontal (`xError`) error bars. Bar lengths are in data units; caps and
+ * markers in scene units. `progress` draws each bar outward from its marker.
+ * Inside a `chart` or `axes`. Bars draw as one `line` instances node and
+ * markers as one `circle` instances node. See {@link errorBarPoints} for the
+ * endpoints alone.
+ *
+ * @example
+ * ```ts
+ * import { chart, errorBar } from "@sophistry/charts";
+ *
+ * const trials = [
+ * 	{ dose: 1, mean: 2.1, sd: 0.4 },
+ * 	{ dose: 2, mean: 3.4, sd: 0.6 },
+ * 	{ dose: 4, mean: 4.0, sd: 0.5 },
+ * ];
+ * chart.create({
+ * 	width: 8,
+ * 	height: 4,
+ * 	children: [errorBar.create({ data: trials, x: "dose", y: "mean", yError: "sd" })],
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#lines-scatter-and-error-bars
+ * @category Charts
+ */
+export declare const errorBar: import("@sophistry/core").Definition<ErrorBarProps<any>, import("@sophistry/core/internal").CompositeNode<ErrorBarProps<any>>, keyof ErrorBarProps<any>>;
+//# sourceMappingURL=error-bar.d.ts.map

package/dist/statistics/error-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-bar.d.ts","sourceRoot":"","sources":["../../src/statistics/error-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,UAAU,CAAC;AAI1D,OAAO,KAAK,EACX,OAAO,EACP,YAAY,EAEZ,aAAa,EACb,MAAM,kBAAkB,CAAC;AAqB1B,OAAO,KAAK,EAEX,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,MAAM,UAAU,CAAC;AAQlB;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,CACzC,SAAQ,oBAAoB,CAAC,CAAC,CAAC,EAC9B,WAAW;IACZ,gGAAgG;IAChG,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;;;OAGG;IACH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC9B;;;OAGG;IACH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACpC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7B;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,yHAAyH;IACzH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA+aD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ,0JA6EnB,CAAC"}

package/dist/statistics/groups.d.ts

@@ -0,0 +1,141 @@
+/**
+ * What the box and violin presets share: reading each group's sample and
+ * name (and, with `to`, the far end's), laying the groups out in band slots
+ * (one per group, or one per name with a `series`), each group's identity
+ * across a keyed transition, and the props of the `chart` the preset draws
+ * in. Internal.
+ */
+import type { SceneNode } from "@sophistry/core";
+import type { ColorInput } from "@sophistry/core/color";
+import type { BandKey, Point, Range } from "@sophistry/core/geometry";
+import type { Channel } from "../data/channels";
+import type { ChartProps, ChartYAxisOptions } from "../frame/types";
+import type { JoinStaging } from "../math/join";
+/** Gap between dodged boxes or violins, as a fraction of each one's sub-slot. */
+export declare const DODGE_GAP = 0.1;
+/** The band-axis categories of a box or violin plot, and each datum's. */
+export interface SlotKeys {
+    categories: BandKey[];
+    /** The categories are the names (so the axis writes the key); else indices. */
+    named: boolean;
+    of: (index: number) => BandKey;
+}
+/**
+ * The band-axis categories of a box or violin plot, and each datum's: one per datum, or with a
+ * `series` and names, one per distinct name.
+ *
+ * @internal
+ */
+export declare function slotKeys(series: unknown, labels: readonly (string | undefined)[] | undefined, data: readonly unknown[]): SlotKeys;
+/** Both ends' slots of a box or violin plot under a keyed transition. @internal */
+export interface TransitionSlots {
+    from: {
+        categories: BandKey[];
+        of: (index: number) => BandKey;
+    };
+    to: {
+        categories: BandKey[];
+        of: (index: number) => BandKey;
+    };
+    /** The categories are the names (so the axis writes the key); else indices. */
+    named: boolean;
+    /** Groups sharing a slot stand side by side, one sub-slot per series. */
+    dodge: boolean;
+}
+/** What a box or violin layer needs to transition to `to`. @internal */
+export interface GroupTransition<T> {
+    to: readonly T[];
+    /** Each `to` datum's sample. */
+    groups: readonly (readonly number[])[];
+    slots: TransitionSlots;
+    /** Each group's identity (see `groupKey`), or undefined to key by series, else index. */
+    key: Channel<T, BandKey> | undefined;
+}
+/** What a box or violin preset reads from its props on one update. */
+export interface GroupData<T> {
+    /** Each datum's sample. */
+    groups: (readonly number[])[];
+    /** Each datum's name, with a `label`. */
+    labels: (string | undefined)[] | undefined;
+    /** One slot per group (by index), or with a series and names, one per name. */
+    slots: SlotKeys;
+    /** With `to`: both ends' slots. */
+    ends: TransitionSlots | undefined;
+    /** Every group's values fitted to a range (zero included), read once per data change. */
+    fitted(): Range;
+    /** With `to`: a band category's name on the axis. */
+    nameOf(key: BandKey): string;
+    /** With `to`: what the inner layer needs of the far end (the same object while unchanged). */
+    transition: GroupTransition<T> | undefined;
+}
+/** The props {@link createGroupData}'s function reads. */
+export interface GroupDataProps<T> {
+    data: readonly T[];
+    to?: readonly T[];
+    blend?: number;
+    values?: Channel<T, readonly number[]>;
+    label?: Channel<T, string>;
+    series?: Channel<T, BandKey>;
+}
+/**
+ * Reads a box or violin preset's groups, names and (with `to`) the far end's, and lays out both
+ * ends' slots. Call once, in `setup`; call the result in each `update`. Each read is cached by
+ * the data and channels it depends on, so a frame of a `blend` or `progress` reads nothing again.
+ *
+ * @internal
+ */
+export declare function createGroupData<T>(): (props: GroupDataProps<T>) => GroupData<T>;
+/** The preset props the frame of a box or violin plot reads. */
+export interface PresetFrameProps {
+    width: number;
+    height: number;
+    center?: Point;
+    yRange?: Range;
+    legend?: boolean | "right" | "top";
+    series?: unknown;
+    colors?: readonly ColorInput[];
+    yAxis?: boolean | ChartYAxisOptions;
+    progress?: number;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * A band category's name on a box or violin plot's x axis: with `to`, the
+ * name at the nearer end; with names as slots, the key; else the datum's
+ * label.
+ *
+ * @internal
+ */
+export declare function categoryName(read: GroupData<unknown>, key: BandKey, index: number): string;
+/**
+ * The props of the `chart` a box or violin preset draws in: a band x axis
+ * over the slots (named by the labels), a value y axis fitted to every
+ * sample (both ends' under a transition, through the layer's report).
+ *
+ * @param band - The band axis options the preset adds (padding, font size,
+ *   line), and its `categoryLabel` (keep it one function for the preset's
+ *   life, reading the latest groups, so the axis options compare equal).
+ * @internal
+ */
+export declare function presetChartProps(props: PresetFrameProps, read: GroupData<unknown>, band: {
+    padding?: number;
+    numberFontSize: number;
+    numberGap?: number;
+    line: boolean;
+    categoryLabel: (key: BandKey, index: number) => string;
+}): Partial<ChartProps>;
+/**
+ * Writes the props of `next` that differ by structure from `last` (functions
+ * by identity) to `node`, so a preset's update leaves its chart alone when
+ * nothing it passes changed. Returns `next`, the new `last`.
+ *
+ * @internal
+ */
+export declare function updateChanged<P extends object>(node: SceneNode<P>, next: Partial<P>, last: Partial<P> | undefined, same?: (a: unknown, b: unknown) => boolean): Partial<P>;
+/** The staging props a preset passes through to its layer. */
+export interface PresetTransitionProps {
+    blend?: number;
+    staging?: JoinStaging;
+    enterStagger?: number;
+}
+//# sourceMappingURL=groups.d.ts.map

package/dist/statistics/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/statistics/groups.ts"],"names":[],"mappings":"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"}

package/dist/statistics/index.d.ts

@@ -0,0 +1,8 @@
+/** Family barrel: statistics. Owned by its family; re-exported from the package entry. */
+export type { BoxPlotProps } from "./box-plot";
+export { boxPlot } from "./box-plot";
+export type { ErrorBarProps, ErrorMagnitude } from "./error-bar";
+export { errorBar } from "./error-bar";
+export type { ViolinPlotProps } from "./violin-plot";
+export { violinPlot } from "./violin-plot";
+//# sourceMappingURL=index.d.ts.map

package/dist/statistics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/statistics/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}