@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/bars/candlestick.d.ts

@@ -0,0 +1,98 @@
+/**
+ * `candlestick`: candles (or OHLC bars) for price data. The wicks (and the
+ * OHLC ticks) are one instances node of `line`s, the bodies one of `rect`s.
+ *
+ * On reveal, each line's `progress` channel traces a wick from its low end
+ * and an OHLC tick out from its end, and a body grows from the open
+ * towards the close; a body not started is left out of the batch.
+ * Every wick paints under every body (candles don't overlap, so this
+ * looks the same as painting them candle by candle).
+ */
+import type { ColorInput } from "@sophistry/core/color";
+import type { BandKey } from "@sophistry/core/geometry";
+import type { Channel, PositionValue } from "../data/channels";
+import type { TooltipSpec } from "../tooltip";
+/**
+ * Props of {@link candlestick}.
+ *
+ * @category Charts
+ */
+export interface CandlestickProps<T = unknown> {
+    /** One candle per datum: a period. */
+    data: readonly T[];
+    /**
+     * The period: a `Date`, Temporal value or epoch ms on a time axis, a number, or a category on a
+     * band axis.
+     */
+    x: Channel<T, BandKey | PositionValue>;
+    /** Price at the period's open. */
+    open: Channel<T, number>;
+    /** Highest price in the period. */
+    high: Channel<T, number>;
+    /** Lowest price in the period. */
+    low: Channel<T, number>;
+    /** Price at the period's close. */
+    close: Channel<T, number>;
+    /**
+     * Body width: a fraction of the band on a band axis, or of the smallest gap between periods on
+     * a continuous one.
+     * @default 0.6
+     */
+    bodyWidth?: number;
+    /**
+     * Draw OHLC bars (open tick left, close tick right) instead of candles.
+     * @default false
+     */
+    ohlc?: boolean;
+    /** Colour of a period that closed up. Defaults to the theme's positive colour. */
+    upColor?: ColorInput;
+    /** Colour of a period that closed down. Defaults to the theme's negative colour. */
+    downColor?: ColorInput;
+    /** Wick and OHLC line width. */
+    strokeWidth?: number;
+    /**
+     * Reveal, 0..1: each wick draws from low to high, then its body grows from open to close.
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the reveal spent staggering period after period in time order, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    /**
+     * Hover tooltip: `true` for a row per channel (`x`, `open`, `high`, `low`, `close`), or a
+     * template, function or options. See {@link TooltipSpec}.
+     */
+    tooltip?: TooltipSpec<T>;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * Candlesticks (or OHLC bars) for price data, inside a `chart` on a time
+ * axis (`xAxis: { scale: "utc" }`) or a category axis. Wicks span low to
+ * high, bodies open to close coloured by direction; the value axis fits the
+ * prices without forcing zero.
+ *
+ * @example
+ * ```ts
+ * import { candlestick, chart } from "@sophistry/charts";
+ *
+ * const prices = [
+ * 	{ day: new Date("2024-03-04"), o: 101, h: 106, l: 99, c: 104 },
+ * 	{ day: new Date("2024-03-05"), o: 104, h: 105, l: 97, c: 98 },
+ * 	{ day: new Date("2024-03-06"), o: 98, h: 103, l: 96, c: 102 },
+ * ];
+ * chart.create({
+ * 	width: 8,
+ * 	height: 4,
+ * 	xAxis: { scale: "utc" },
+ * 	children: [candlestick.create({ data: prices, x: "day", open: "o", high: "h", low: "l", close: "c" })],
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#waterfalls-funnels-and-candlesticks
+ * @category Charts
+ */
+export declare const candlestick: import("@sophistry/core").Definition<CandlestickProps<any>, import("@sophistry/core/internal").CompositeNode<CandlestickProps<any>>, keyof CandlestickProps<any>>;
+//# sourceMappingURL=candlestick.d.ts.map

package/dist/bars/candlestick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candlestick.d.ts","sourceRoot":"","sources":["../../src/bars/candlestick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,0BAA0B,CAAC;AAOvE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAS/D,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ5D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC5C,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;;;OAGG;IACH,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACvC,kCAAkC;IAClC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACzB,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACzB,kCAAkC;IAClC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACxB,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,oFAAoF;IACpF,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAoRD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,WAAW,mKA2DtB,CAAC"}

package/dist/bars/funnel.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `funnel`: how many make it through each stage of a process. A preset: a
+ * `chart` with a band y axis whose one layer (the internal `FunnelStages`)
+ * draws the stages as one instances node of `rect`s, the necks between them
+ * as one path batch (each neck is its own trapezoid), and the names and
+ * values as label nodes.
+ */
+import type { ColorInput } from "@sophistry/core/color";
+import type { Point } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel } from "../data/channels";
+import type { TooltipSpec } from "../tooltip";
+/**
+ * Props of {@link funnel}: `value` is required unless `data` is `number[]`.
+ *
+ * @category Charts
+ */
+export interface FunnelProps<T = unknown> {
+    /** One stage per datum, widest (first) at the top. */
+    data: readonly T[];
+    /** How many reached this stage. Defaults to the datum when `data` is `number[]`. */
+    value?: Channel<T, number>;
+    /** The stage's name, drawn to its left. Omitted, no names are drawn. */
+    label?: Channel<T, string>;
+    /** 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;
+    /** One colour for every stage, or `(d, i) => colour`. Wins over `colors`. */
+    color?: ColorChannel<T>;
+    /** Colours cycled across the stages. Defaults to the theme's categorical colours. */
+    colors?: readonly ColorInput[];
+    /**
+     * Fill opacity of the stages, 0..1.
+     * @default 0.85
+     */
+    fillOpacity?: number;
+    /**
+     * Gap between stages, as a fraction of a stage's slot.
+     * @default 0.25
+     */
+    padding?: number;
+    /**
+     * Shade the narrowing between stages.
+     * @default true
+     */
+    connectors?: boolean;
+    /**
+     * What to write in each stage: `"value"`, `"percent"` (of the first stage), `"both"`, or
+     * `"none"`.
+     * @default "both"
+     */
+    show?: "value" | "percent" | "both" | "none";
+    /** Title above the chart. */
+    title?: string;
+    /**
+     * Reveal, 0..1: stage names first, then each stage widens out from the centre, top to bottom.
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the data reveal spent staggering stage after stage, 0..0.95.
+     * @default 0.5
+     */
+    stagger?: number;
+    /** Hover tooltip: `true` for "stage: value (pct)", or `(d, i) => string`. */
+    tooltip?: TooltipSpec<T>;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * A funnel: how many make it through each stage of a process. Stages stack
+ * top-down, each centred with a width proportional to its value, shaded
+ * necks showing the loss between them. A `chart` with a band y axis and no
+ * value axis.
+ *
+ * @example
+ * ```ts
+ * import { createScene } from "@sophistry/core";
+ * import { funnel } from "@sophistry/charts";
+ *
+ * const scene = createScene({ host: document.querySelector("#figure")!, units: 10 });
+ * scene.add(funnel.create({ data: [1200, 640, 310, 95], width: 6, height: 4 }));
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#waterfalls-funnels-and-candlesticks
+ * @category Charts
+ */
+export declare const funnel: import("@sophistry/core").Definition<FunnelProps<any>, import("@sophistry/core/internal").CompositeNode<FunnelProps<any>>, keyof FunnelProps<any>>;
+//# sourceMappingURL=funnel.d.ts.map

package/dist/bars/funnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.d.ts","sourceRoot":"","sources":["../../src/bars/funnel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAmB,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAQvE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAW9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY9C;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACvC,sDAAsD;IACtD,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,oFAAoF;IACpF,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3B,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,qFAAqF;IACrF,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AA0UD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,oJAqBjB,CAAC"}

package/dist/bars/histogram.d.ts

@@ -0,0 +1,109 @@
+/**
+ * `histogram`: values bucketed into equal-width bins, one touching bar per
+ * bin, drawn as one instances node of `rect`s keyed by the bin's place.
+ *
+ * The reveal and a transition's presence grow each bar's top from the
+ * baseline (geometry) or, on an axis without zero, fade it (per-item
+ * opacity); a bin not started is left out of the batch (it counts as
+ * `progress` 0).
+ */
+import type { ColorInput } from "@sophistry/core/color";
+import type { Range } from "@sophistry/core/geometry";
+import type { MarkTransition } from "../batch";
+import type { Channel } from "../data/channels";
+import type { RevealProps, TransitionProps } from "../props";
+/**
+ * Props of {@link histogram}: `value` is required unless `data` is `number[]`.
+ *
+ * @category Charts
+ */
+export interface HistogramProps<T = unknown> extends TransitionProps<T>, RevealProps {
+    /** One observation per datum. */
+    data: readonly T[];
+    /**
+     * The observed value, in data units. Defaults to the datum when `data` is `number[]`; required
+     * otherwise. Non-finite values and values outside `range` are not counted.
+     */
+    value?: Channel<T, number>;
+    /**
+     * Number of equal-width bins. Wins over a `range` step. Defaults to the count the `range` step
+     * implies, else 10.
+     */
+    binCount?: number;
+    /**
+     * `[min, max, step?]` spanned by the bins, in data units; `step` is the bin width when
+     * `binCount` is not given (`[0, 10, 2]` is five bins). Defaults to the finite extent of the
+     * values.
+     */
+    range?: Range;
+    /** Fill of every bar. Defaults to the theme's first series colour. */
+    color?: ColorInput;
+    /**
+     * Fill opacity, 0..1.
+     * @default 0.85
+     */
+    fillOpacity?: number;
+    /** Outline colour. @default "none" */
+    stroke?: string;
+    /** Outline width. */
+    strokeWidth?: number;
+    /** Opacity 0..1. @default 1 */
+    opacity?: number;
+    /**
+     * Reveal, 0..1: bars grow from the baseline (fading in when the axis has no zero).
+     * @default 1
+     */
+    progress?: number;
+    /**
+     * Fraction of the reveal spent staggering bin after bin, left to right, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    /**
+     * The data to transition to, bins matched by place: shared bins move their edges and counts, so
+     * every frame is a histogram; extra bins grow in or shrink away. See {@link TransitionProps}.
+     * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+     */
+    to?: readonly T[];
+    /**
+     * `to`'s bin count; `to={data}` with a new `toBinCount` re-bins as a transition. Defaults to
+     * `binCount`.
+     */
+    toBinCount?: number;
+    /** `to`'s binning range, as `range`. Defaults to `range`. */
+    toRange?: Range;
+    /**
+     * Fraction of a transition's enter stage spent staggering entering bins, left to right. See
+     * {@link TransitionProps}.
+     * @default 0
+     */
+    enterStagger?: number;
+    /**
+     * How bars move when `data` changes (outside a `to` blend): a tween or a
+     * spring in the node's tween bank. Omitted, data changes are instant.
+     */
+    transition?: MarkTransition;
+    /** Paint order; the bars paint at `zIndex + UNDER_AXES_Z_INDEX`. */
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * A histogram: values bucketed into equal-width bins, one touching bar per
+ * bin, its height the count. `progress` grows bars from the baseline
+ * (fading in when the axis has no zero). Inside a `chart` (which fits the
+ * counts) or an `axes`. See {@link histogramBins} for the binning rule (the
+ * last bin is right-inclusive). Drawn as one instances node of rects.
+ *
+ * @example
+ * ```ts
+ * import { chart, histogram } from "@sophistry/charts";
+ *
+ * const heights = [162, 170, 175, 168, 181, 159, 177, 173, 166, 185, 171, 169];
+ * chart.create({ width: 8, height: 4, children: [histogram.create({ data: heights, binCount: 12 })] });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#histograms
+ * @category Charts
+ */
+export declare const histogram: import("@sophistry/core").Definition<HistogramProps<any>, import("@sophistry/core/internal").CompositeNode<HistogramProps<any>>, keyof HistogramProps<any>>;
+//# sourceMappingURL=histogram.d.ts.map

package/dist/bars/histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../../src/bars/histogram.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAmB,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGvE,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,UAAU,CAAC;AAI1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQhD,OAAO,KAAK,EAAY,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMvE;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,CAC1C,SAAQ,eAAe,CAAC,CAAC,CAAC,EACzB,WAAW;IACZ,iCAAiC;IACjC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAsLD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,6JAoDpB,CAAC"}

package/dist/bars/index.d.ts

@@ -0,0 +1,23 @@
+/** Family barrel: bars and their kin. Owned by its family; re-exported from the package entry. */
+export type { BarChartHandle, BarChartProps } from "./bar-chart";
+export { barChart, barChartHandle } from "./bar-chart";
+export type { BarLabelOptions } from "./bar-labels";
+export type { BarsHandle, BarsProps } from "./bars";
+export { bars, barsHandle } from "./bars";
+export type { BulletProps } from "./bullet";
+export { bullet, bulletTooltip } from "./bullet";
+export type { CandlestickProps } from "./candlestick";
+export { candlestick } from "./candlestick";
+export type { FunnelProps } from "./funnel";
+export { funnel } from "./funnel";
+export type { HistogramProps } from "./histogram";
+export { histogram } from "./histogram";
+export type { RankRaceOptions } from "./race";
+export { rankRace } from "./race";
+export type { RuleBaseProps, RuleXProps, RuleYProps } from "./rules";
+export { ruleX, ruleY } from "./rules";
+export type { BinnedRow, BinOptions, DodgedRow, DodgeOptions, GroupedRow, GroupOptions, JitterTransformOptions, NormalizeOptions, RollingTransformOptions, StackedRow, StackOptions, SummarizeOptions, SummaryRow, } from "./transforms";
+export { bin, dodge, group, jitter, normalize, rolling, stack, summarize, } from "./transforms";
+export type { WaterfallProps } from "./waterfall";
+export { waterfall } from "./waterfall";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bars/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAElG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACvC,YAAY,EACX,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,GAAG,EACH,KAAK,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,OAAO,EACP,KAAK,EACL,SAAS,GACT,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/bars/race.d.ts

@@ -0,0 +1,29 @@
+/** `rankRace`: a bar chart race from long-format rows. */
+import type { BandKey } from "@sophistry/core/geometry";
+import type { Channel } from "../data/channels";
+import type { RaceOptions, RaceTimeline } from "../math/keyframes";
+/**
+ * Options for {@link rankRace}.
+ *
+ * @category Charts
+ */
+export interface RankRaceOptions<T> extends RaceOptions {
+    /** What races: a key of `T` or `(d, i) => key`. */
+    key: Channel<T, BandKey>;
+    /** When the row's value holds: a key of `T` or `(d, i) => number`. */
+    time: Channel<T, number>;
+    /** The value: a key of `T` or `(d, i) => number`. */
+    value: Channel<T, number>;
+}
+/**
+ * A bar chart race from long-format rows (one per key per moment): see
+ * {@link raceTimeline}. Missing keys count as 0; duplicate rows are summed.
+ * Pass `view(time)`'s `categories` and `slot` to the `chart`'s `yAxis` (with
+ * `clip`) so bars and names slide together, and pin colours with
+ * `chart.create({ color: { domain: race.keys } })`.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+ * @category Charts
+ */
+export declare function rankRace<T>(rows: readonly T[], options: RankRaceOptions<T>): RaceTimeline;
+//# sourceMappingURL=race.d.ts.map

package/dist/bars/race.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.d.ts","sourceRoot":"","sources":["../../src/bars/race.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAInE;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,WAAW;IACtD,mDAAmD;IACnD,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACzB,sEAAsE;IACtE,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACzB,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACzB,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,YAAY,CA+Bd"}

package/dist/bars/rules.d.ts

@@ -0,0 +1,122 @@
+/**
+ * `ruleX` / `ruleY`: reference lines across the plot, or segments between
+ * given ends, one per datum, drawn as one instances node of `line`s.
+ *
+ * Batched like every per-datum mark (see `points/scatter.ts`): each update
+ * builds one item per key (its two ends in scene units and its colour) and
+ * hands them to {@link createBatchedMark}. The reveal (and an entering or
+ * leaving rule's presence) is each item's `progress` channel: the line
+ * traces from its low end.
+ */
+import type { BandKey } from "@sophistry/core/geometry";
+import type { MarkTransition } from "../batch";
+import type { Channel, ColorChannel, PositionValue } from "../data/channels";
+import type { KeyedTransitionProps, RevealProps } from "../props";
+import type { TooltipSpec } from "../tooltip";
+/**
+ * Props every rule takes.
+ *
+ * @category Charts
+ */
+export interface RuleBaseProps<T> extends KeyedTransitionProps<T>, RevealProps {
+    /** One rule per datum. `ruleY.create({ data: [0] })` is a zero line. */
+    data: readonly T[];
+    /** Rule colour, constant or `(d, i) => colour`. Defaults to the theme foreground. */
+    color?: ColorChannel<T>;
+    /** Line width. */
+    strokeWidth?: number;
+    /** Dash pattern, as on any line: `[0.1, 0.08]`. */
+    dash?: number[];
+    opacity?: number;
+    /**
+     * Reveal, 0..1: each rule draws from its low end to its high end.
+     * @default 1
+     */
+    progress?: number;
+    /**
+     * Hover tooltip: `true` for the rule's value, or a template, function or options. See {@link
+     * TooltipSpec}.
+     */
+    tooltip?: TooltipSpec<T>;
+    /**
+     * How rules move when `data` changes (outside a `to` blend): a tween or a
+     * spring in the node's tween bank; new rules draw out of their low end,
+     * removed ones draw back into it. Omitted, data changes are instant.
+     */
+    transition?: MarkTransition;
+    zIndex?: number;
+    visible?: boolean;
+    /**
+     * The data to transition to, matched to `data` by `key`: rules slide and stretch to their new
+     * place; new ones draw out, removed ones draw back in. See {@link KeyedTransitionProps}.
+     * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+     */
+    to?: readonly T[];
+}
+/**
+ * Props of {@link ruleX}: `x` is required unless `data` is `number[]`.
+ *
+ * @category Charts
+ */
+export interface RuleXProps<T = unknown> extends RuleBaseProps<T> {
+    /**
+     * Where the vertical rule stands: a number in data units (a `Date` reads as epoch ms) or a
+     * category on a band axis. Defaults to the datum when `data` is `number[]`.
+     */
+    x?: Channel<T, BandKey | PositionValue>;
+    /** Lower end, in data units. Defaults to the bottom of the plotting area. */
+    y1?: Channel<T, PositionValue>;
+    /** Upper end, in data units. Defaults to the top of the plotting area. */
+    y2?: Channel<T, PositionValue>;
+}
+/**
+ * Props of {@link ruleY}: `y` is required unless `data` is `number[]`.
+ *
+ * @category Charts
+ */
+export interface RuleYProps<T = unknown> extends RuleBaseProps<T> {
+    /**
+     * Height of the horizontal rule: a number in data units (a `Date` reads as epoch ms) or a
+     * category on a band axis. Defaults to the datum when `data` is `number[]`.
+     */
+    y?: Channel<T, BandKey | PositionValue>;
+    /** Left end, in data units. Defaults to the left of the plotting area. */
+    x1?: Channel<T, PositionValue>;
+    /** Right end, in data units. Defaults to the right of the plotting area. */
+    x2?: Channel<T, PositionValue>;
+}
+/**
+ * Vertical reference lines across the plot; `y1`/`y2` shorten them to
+ * segments (a lollipop's stick, a candle's wick). Inside a `chart` or
+ * `axes`. Drawn as one instances node of lines: `event.key` is the datum's
+ * key.
+ *
+ * @example
+ * ```ts
+ * import { chart, ruleX } from "@sophistry/charts";
+ *
+ * chart.create({ width: 8, height: 4, children: [ruleX.create({ data: [2, 5], dash: [0.1, 0.08] })] });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#marks
+ * @category Charts
+ */
+export declare const ruleX: import("@sophistry/core").Definition<RuleXProps<any>, import("@sophistry/core/internal").CompositeNode<RuleXProps<any>>, keyof RuleXProps<any>>;
+/**
+ * Horizontal reference lines across the plot; `ruleY.create({ data: [0] })`
+ * is a zero line and `x1`/`x2` shorten them to segments. Inside a `chart`
+ * or `axes`. Drawn as one instances node of lines.
+ *
+ * @example
+ * ```ts
+ * import { chart, linePlot, ruleY } from "@sophistry/charts";
+ *
+ * const data = [-2, 1, 3, -1, 4];
+ * chart.create({ width: 8, height: 4, children: [linePlot.create({ data }), ruleY.create({ data: [0] })] });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#marks
+ * @category Charts
+ */
+export declare const ruleY: import("@sophistry/core").Definition<RuleYProps<any>, import("@sophistry/core/internal").CompositeNode<RuleYProps<any>>, keyof RuleYProps<any>>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/bars/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/bars/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,UAAU,CAAC;AAI1D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkB7E,OAAO,KAAK,EAAY,oBAAoB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAC,EAAE,WAAW;IAC7E,wEAAwE;IACxE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IAChE;;;OAGG;IACH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC,6EAA6E;IAC7E,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC/B,0EAA0E;IAC1E,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IAChE;;;OAGG;IACH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC,0EAA0E;IAC1E,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC/B,4EAA4E;IAC5E,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;CAC/B;AAqWD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,KAAK,iJAwBhB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,KAAK,iJAwBhB,CAAC"}

package/dist/bars/shared.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Helpers the bar family shares: a label placed beside a point, box arithmetic, and the tooltip props a batched node
+ * takes. Internal to the family.
+ */
+import type { Bounds, Placement, Point, Vec2 } from "@sophistry/core";
+import type { TooltipState } from "../tooltip";
+/** The metrics style labels are measured in: the label defaults. */
+export declare function labelStyle(fontSize: number, fontFamily: string): {
+    fontSize: number;
+    fontFamily: string;
+    fontWeight: number;
+    italic: boolean;
+    letterSpacing: number;
+};
+/**
+ * Where a label goes to sit beside `at` (in `direction`, `gap` away) rather
+ * than centred on it, measured the same
+ * way core's axes place their end labels (the label's own width, one line
+ * height per font).
+ *
+ * @returns The label's `place`.
+ */
+export declare function besidePlace(text: string, at: Point, direction: Vec2, gap: number, fontSize: number, fontFamily: string): Placement;
+/** A box's centre. */
+export declare function boxCenter(box: Bounds): Point;
+/** The box spanned by two corners. */
+export declare function boxOfCorners(a: Point, b: Point): Bounds;
+/** Whether two boxes are equal field by field. */
+export declare function sameBox(a: Bounds | null, b: Bounds | null): boolean;
+/**
+ * The interaction props a batched node shares for item tooltips: the
+ * handlers when the chart has a tooltip and the mark (or the chart) asks for
+ * one, else none.
+ */
+export declare function tooltipProps(tooltip: TooltipState | null, own: unknown, handlers: {
+    readonly label?: string;
+    readonly onEnter?: unknown;
+    readonly onLeave?: unknown;
+    readonly onTap?: unknown;
+    readonly itemLabel?: unknown;
+}): Record<string, unknown>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/bars/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/bars/shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;;;;;;EAQ9D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,KAAK,EACT,SAAS,EAAE,IAAI,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAChB,SAAS,CAYX;AAED,sBAAsB;AACtB,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAE5C;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAOvD;AAED,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CASnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE;IACT,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC7B,GACC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}