@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/multiview/pair-plot.d.ts

@@ -0,0 +1,154 @@
+/**
+ * A scatter-plot matrix: every pair of variables against each other, with
+ * each variable's distribution on the diagonal. One `chart` per panel in
+ * one group: columns share x, rows share y.
+ */
+import type { SceneNode } from "@sophistry/core";
+import type { BandKey, Point } from "@sophistry/core/geometry";
+import type { Channel } from "../data/channels";
+import type { ChartAxisOptions, ChartColorOptions } from "../frame/types";
+import type { FacetSpace } from "./facet";
+/**
+ * An off-diagonal panel of a {@link pairPlot}, as `offDiagonal` receives it.
+ *
+ * @category Charts
+ */
+export interface PairPanel<T> {
+    /** Every row. */
+    data: readonly T[];
+    /** The variable on this panel's x axis (its column's). */
+    x: string;
+    /** The variable on its y axis (its row's). */
+    y: string;
+    /** Grid row, from the top. */
+    row: number;
+    /** Grid column, from the left. */
+    column: number;
+}
+/**
+ * Props for {@link pairPlot}.
+ *
+ * @category Charts
+ */
+export interface PairPlotProps<T> {
+    /** The rows. */
+    data: readonly T[];
+    /** The numeric fields to pair, in order: the matrix's rows (top to bottom) and columns (left to right). */
+    variables: readonly string[];
+    /** A variable's title under its column and beside its row. Defaults to its name. */
+    variableLabels?: Partial<Record<string, string>>;
+    /** Splits the points and the diagonal's densities by category, one colour each, keyed by one legend. */
+    series?: Channel<T, BandKey>;
+    /** The points' identity channel, as `scatter`'s `key`. */
+    key?: Channel<T, BandKey>;
+    /** Width of the matrix of plots (a legend fits inside; see `autosize`). */
+    width: number;
+    /** Height of the matrix of plots. */
+    height: number;
+    /** Centre of the matrix. Defaults to the origin. */
+    center?: Point;
+    /**
+     * Space between neighbouring panels.
+     * @default 0.35
+     */
+    gap?: number;
+    /** Relative column widths, left to right (one per variable), as `facet`'s `widths`. */
+    widths?: readonly number[];
+    /** Relative row heights, top to bottom, as `facet`'s `heights`. */
+    heights?: readonly number[];
+    /**
+     * `"free"` sizes each column and row by its variable's range (or per axis), so one unit is one
+     * length across the matrix. As `facet`'s `space`; `widths`/`heights` win.
+     * @default "fixed"
+     */
+    space?: FacetSpace;
+    /**
+     * What the diagonal draws: `"density"` (one curve per series), `"histogram"` (bins of the whole
+     * sample), or `false` for nothing.
+     * @default "density"
+     */
+    diag?: "density" | "histogram" | false;
+    /** Histogram diagonal: how many bins. */
+    binCount?: number;
+    /**
+     * Draw only the lower triangle and the diagonal. Read once, at creation.
+     * @default false
+     */
+    corner?: boolean;
+    /**
+     * Marker radius.
+     * @default 0.05
+     */
+    radius?: number;
+    /**
+     * Draws an off-diagonal panel's layers instead of the default scatter: a function returning
+     * layer nodes, called when the panel is made and when `data` changes. A plain value prop; the
+     * bindings pass it through untouched.
+     */
+    offDiagonal?: (panel: PairPanel<T>) => readonly SceneNode[];
+    /** Every panel's axes (tick options, `nice`, `zero`, ...). */
+    axis?: ChartAxisOptions;
+    grid?: boolean | "x" | "y";
+    /**
+     * As `chart`'s `autosize`, over the whole matrix.
+     * @default "fit"
+     */
+    autosize?: "fit" | "pad" | "contain";
+    color?: ChartColorOptions;
+    /**
+     * One legend: on the right (`true`, `"right"`) or in a row over the matrix (`"top"`).
+     * On the right by default when `series` is given.
+     */
+    legend?: boolean | "right" | "top";
+    legendTitle?: string;
+    legendFontSize?: number;
+    title?: string;
+    titleFontSize?: number;
+    /**
+     * Font size of the variables' titles.
+     * @default 0.3
+     */
+    labelFontSize?: number;
+    /**
+     * Reveal, 0..1: every panel's frame, then the data (see `stagger`), then the legend.
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the data reveal spent staggering panels in reading order, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * A pair plot (scatter-plot matrix): panel (row `i`, column `j`) plots `variables[j]` against
+ * `variables[i]`, and the diagonal shows each variable's distribution. Columns share x scales
+ * and rows share y scales, so a point lines up across the matrix; a `series` is one colour
+ * everywhere with one legend.
+ *
+ * @example
+ * ```ts
+ * import { pairPlot } from "@sophistry/charts";
+ *
+ * const flowers = [
+ * 	{ kind: "iris", petal: 1.4, sepal: 5.1, width: 3.5 },
+ * 	{ kind: "iris", petal: 1.3, sepal: 4.9, width: 3 },
+ * 	{ kind: "lily", petal: 4.7, sepal: 7, width: 3.2 },
+ * 	{ kind: "lily", petal: 4.5, sepal: 6.4, width: 3.2 },
+ * ];
+ * pairPlot.create({
+ * 	data: flowers,
+ * 	variables: ["petal", "sepal", "width"],
+ * 	series: "kind",
+ * 	width: 6,
+ * 	height: 6,
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#multiple-views
+ * @category Charts
+ */
+export declare const pairPlot: import("@sophistry/core").Definition<PairPlotProps<any>, import("@sophistry/core/internal").CompositeNode<PairPlotProps<any>>, keyof PairPlotProps<any>>;
+//# sourceMappingURL=pair-plot.d.ts.map

package/dist/multiview/pair-plot.d.ts.map

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

package/dist/multiview/panels.d.ts

@@ -0,0 +1,23 @@
+/**
+ * What the grid presets (`pairPlot`, `jointPlot`) share: a panel is a
+ * `chart` inside a plain `group` that provides its group scope. Internal.
+ */
+import type { CompositeContext, ContainerNode, SceneNode } from "@sophistry/core";
+import type { SideRoom } from "../math/facet";
+import type { ChartGroup, ChartGroupScope } from "./chart-group";
+/** A panel's nodes: the wrapper providing its scope, and its chart. */
+export interface PanelNodes {
+    wrapper: ContainerNode;
+    plot: SceneNode;
+}
+/** Makes a panel: a chart with `children`, inside a group providing `scope`. */
+export declare function makePanel(scope: ChartGroupScope, children: readonly SceneNode[]): PanelNodes;
+/**
+ * The room kept free around a preset's grid of plots, inside its
+ * footprint, by `autosize`: none (`"pad"`), the right-hand guides
+ * (`"fit"`), or every side (`"contain"`).
+ */
+export declare function outerRoom(autosize: "fit" | "pad" | "contain" | undefined, panels: SideRoom, own: SideRoom, contained?: SideRoom): SideRoom;
+/** Watches a preset's group: reruns its update when a panel published something new. */
+export declare function watchGroup<P>(ctx: CompositeContext<P>, group: ChartGroup, reason: Parameters<CompositeContext<P>["invalidate"]>[0]): void;
+//# sourceMappingURL=panels.d.ts.map

package/dist/multiview/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../src/multiview/panels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGjE,uEAAuE;AACvE,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CACxB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,SAAS,SAAS,EAAE,GAC5B,UAAU,CAMZ;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACxB,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,EAC/C,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,QAAQ,EACb,SAAS,GAAE,QAKV,GACC,QAAQ,CAKV;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,CAAC,EAC3B,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACxB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GACtD,IAAI,CAEN"}

package/dist/multiview/parallel-coordinates.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Parallel coordinates: numeric variables side by side as vertical axes,
+ * each datum a polyline through its value on every axis.
+ *
+ * The lines are one path batch (one item per drawn datum, its own stroke;
+ * hover and taps resolve per item). A line's partial reveal is its item's
+ * `progress`, traced by arc length. The axes are
+ * core `numberLine`s and labels.
+ */
+import type { ColorInput } from "@sophistry/core/color";
+import type { Point, Range } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel } from "../data/channels";
+import type { TooltipSpec } from "../tooltip";
+/**
+ * One axis of a {@link parallelCoordinates} chart.
+ *
+ * @category Charts
+ */
+export interface ParallelAxis<T> {
+    /** The value each datum takes on this axis; non-finite values break the datum's line. */
+    value: Channel<T, number>;
+    /** Written above the axis. */
+    label?: string;
+    /** `[min, max, step?]` in data units. Omitted, fitted to the data. */
+    range?: Range;
+}
+/** @category Charts */
+export interface ParallelCoordinatesProps<T> {
+    /** One polyline per datum. */
+    data: readonly T[];
+    /** One vertical axis per entry, evenly spaced left to right. */
+    axes: readonly ParallelAxis<T>[];
+    /** Distance from the first axis to the last. */
+    width: number;
+    /** Height of each axis. */
+    height: number;
+    /** Centre of the chart. Defaults to the origin. */
+    center?: Point;
+    /** One colour for every line, or `(d, i) => colour`. Wins over `colors`. */
+    color?: ColorChannel<T>;
+    /** Colours cycled across the lines by index. Defaults to the theme's categorical colours. */
+    colors?: readonly ColorInput[];
+    /**
+     * Line width.
+     * @default 0.025
+     */
+    strokeWidth?: number;
+    /**
+     * Line opacity, 0..1, so dense bundles read darker.
+     * @default 0.6
+     */
+    opacity?: number;
+    /**
+     * Font size of the axis labels.
+     * @default 0.24
+     */
+    axisLabelFontSize?: number;
+    /**
+     * Font size of the tick numbers.
+     * @default 0.18
+     */
+    tickFontSize?: number;
+    /**
+     * Reveal, 0..1: the axes draw first, then every line draws left to right across them.
+     * @default 1
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the line reveal spent staggering one datum after the next, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    /** Hover tooltip: `true` lists the datum's value on each axis, or `(d, i) => string`. */
+    tooltip?: TooltipSpec<T>;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * Parallel coordinates: numeric variables side by side as vertical axes, each datum a
+ * polyline through its value on every axis, for spotting clusters and trade-offs across many
+ * dimensions. Sized by `width` and `height`; needs no `chart`. See {@link parallelLines}
+ * for the geometry alone. The lines are one path batch.
+ *
+ * @example
+ * ```ts
+ * import { parallelCoordinates } from "@sophistry/charts";
+ *
+ * const cars = [
+ * 	{ mpg: 30, hp: 95, weight: 1100 },
+ * 	{ mpg: 22, hp: 150, weight: 1500 },
+ * 	{ mpg: 15, hp: 240, weight: 1900 },
+ * ];
+ * parallelCoordinates.create({
+ * 	data: cars,
+ * 	axes: [
+ * 		{ value: "mpg", label: "mpg" },
+ * 		{ value: "hp", label: "hp" },
+ * 		{ value: "weight", label: "weight" },
+ * 	],
+ * 	width: 8,
+ * 	height: 4,
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#lines-scatter-and-error-bars
+ * @category Charts
+ */
+export declare const parallelCoordinates: import("@sophistry/core").Definition<ParallelCoordinatesProps<any>, import("@sophistry/core/internal").CompositeNode<ParallelCoordinatesProps<any>>, keyof ParallelCoordinatesProps<any>>;
+//# sourceMappingURL=parallel-coordinates.d.ts.map

package/dist/multiview/parallel-coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-coordinates.d.ts","sourceRoot":"","sources":["../../src/multiview/parallel-coordinates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAY,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGvE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAO9D,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAW5D;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,yFAAyF;IACzF,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,uBAAuB;AACvB,MAAM,WAAW,wBAAwB,CAAC,CAAC;IAC1C,8BAA8B;IAC9B,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,gEAAgE;IAChE,IAAI,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,6FAA6F;IAC7F,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,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAuLD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,mBAAmB,2LA2D9B,CAAC"}

package/dist/points/event-plot.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `eventPlot`: an event raster, one row of vertical ticks per sequence. One
+ * `line` instances node for every tick of every row (see
+ * `segment-marks.ts`), keyed `"row:tick"`.
+ */
+import type { ColorInput } from "@sophistry/core/color";
+import type { Channel, ColorChannel } from "../data/channels";
+/**
+ * Props of {@link eventPlot}.
+ *
+ * @category Charts
+ */
+export interface EventPlotProps<T = unknown> {
+    /** One row per datum (a spike train, a subject, ...). */
+    data: readonly T[];
+    /**
+     * The row's event positions along x, in data units. Defaults to the datum when `data` is
+     * `number[][]`. Empty rows are fine; non-finite entries are skipped.
+     */
+    events?: Channel<T, readonly number[]>;
+    /**
+     * Vertical spacing between rows, in data units: row `i` is centred on `y = i * lineOffset`.
+     * @default 1
+     */
+    lineOffset?: number;
+    /**
+     * Length of each tick in data units, centred on its row.
+     * @default 0.8
+     */
+    lineLength?: number;
+    /** One colour for every row, or `(d, i) => colour`. Wins over `colors`. */
+    color?: ColorChannel<T>;
+    /** Colours cycled across rows by index. Defaults to the theme's categorical colours. */
+    colors?: readonly ColorInput[];
+    /** Line width. */
+    strokeWidth?: number;
+    opacity?: number;
+    /**
+     * Reveal, 0..1: each tick draws from its low end.
+     * @default 1
+     */
+    progress?: number;
+    /**
+     * Fraction of the reveal spent staggering the ticks left to right across every row, 0..0.95, so
+     * the raster fills in as the events happened.
+     * @default 0
+     */
+    stagger?: number;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * An event raster: one row of vertical ticks per sequence (spike trains, say), each tick at an
+ * event's x. Row 0 is at `y = 0`, so give the axes a y range like `[-1, data.length]`. One
+ * instances node.
+ *
+ * @example
+ * ```ts
+ * import { chart, eventPlot } from "@sophistry/charts";
+ *
+ * chart.create({ width: 8, height: 4, yRange: [-1, 3], children: [eventPlot.create({ data: [[1, 2.5], [0.5, 3], [2]] })] });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#distributions
+ * @category Charts
+ */
+export declare const eventPlot: import("@sophistry/core").Definition<EventPlotProps<any>, import("@sophistry/core/internal").CompositeNode<EventPlotProps<any>>, keyof EventPlotProps<any>>;
+//# sourceMappingURL=event-plot.d.ts.map

package/dist/points/event-plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-plot.d.ts","sourceRoot":"","sources":["../../src/points/event-plot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgB9D;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IAC1C,yDAAyD;IACzD,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,wFAAwF;IACxF,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAuGD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,6JA2BpB,CAAC"}

package/dist/points/index.d.ts

@@ -0,0 +1,20 @@
+/** Family barrel: per-datum point marks. Re-exported from the package entry. */
+export type { EventPlotProps } from "./event-plot";
+export { eventPlot } from "./event-plot";
+export type { LabelsProps } from "./labels";
+export { labels } from "./labels";
+export type { LinksProps, SegmentStyleProps, VectorsProps } from "./links";
+export { links, vectors } from "./links";
+export type { RectsProps } from "./rects";
+export { rects } from "./rects";
+export type { RugProps } from "./rug";
+export { rug } from "./rug";
+export type { ScatterProps, ScatterTrailOptions } from "./scatter";
+export { scatter } from "./scatter";
+export type { StemProps } from "./stem";
+export { stem } from "./stem";
+export type { BeeswarmProps, DotDistributionProps, StripProps, } from "./strip";
+export { beeswarm, strip } from "./strip";
+export type { TickBaseProps, TickXProps, TickYProps } from "./ticks";
+export { tickX, tickY } from "./ticks";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/points/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,UAAU,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/points/labels.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `labels`: text at data positions.
+ *
+ * One `label` node per datum, kept by key: the core has no batched text
+ * (a text spec is one string with its own measured box), and a label beside
+ * its point (`direction`) is placed by that box. Labels annotate a few
+ * points, not thousands, so this is the one point mark that stays per datum.
+ */
+import type { Vec2 } from "@sophistry/core";
+import type { BandKey } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel, PositionValue } from "../data/channels";
+import type { KeyedTransitionProps, RevealProps } from "../props";
+/**
+ * Props of {@link labels}.
+ *
+ * @category Charts
+ */
+export interface LabelsProps<T = unknown> extends KeyedTransitionProps<T>, RevealProps {
+    /** One label per datum. */
+    data: readonly T[];
+    /** X position: a number in data units (a `Date` reads as epoch ms) or a category on a band axis. Defaults to the index when `data` is `number[]`. */
+    x?: Channel<T, BandKey | PositionValue>;
+    /** Y position: a number in data units or a category on a band axis. Defaults to the datum when `data` is `number[]`. */
+    y?: Channel<T, BandKey | PositionValue>;
+    /** The text. Defaults to the datum, as a number, when `data` is `number[]`. */
+    text?: Channel<T, string>;
+    /** Which side of the point the text sits on (`UP`, `RIGHT`, `UR`, ...), `gap` away. Omitted, the text is centred on the point. */
+    direction?: Vec2;
+    /**
+     * Gap between the point and the text when `direction` is set.
+     * @default 0.18
+     */
+    gap?: number;
+    /**
+     * Font size.
+     * @default 0.26
+     */
+    fontSize?: number;
+    /** Text colour, constant or `(d, i) => colour`. Defaults to the theme foreground. */
+    color?: ColorChannel<T>;
+    opacity?: number;
+    /**
+     * Reveal, 0..1: each label fades in, over the end of the data phase.
+     * @default 1
+     */
+    progress?: number;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * Text at data positions: names on a scatter, values over a line, annotations at a peak. Each
+ * label is placed by its measured box, so `direction: UP` clears the point by the same gap
+ * for any text. One `label` node per datum (see the file header).
+ *
+ * @example
+ * ```ts
+ * import { UP } from "@sophistry/core";
+ * import { chart, labels } from "@sophistry/charts";
+ *
+ * const cities = [
+ * 	{ name: "Lima", gdp: 15, life: 76 },
+ * 	{ name: "Oslo", gdp: 80, life: 83 },
+ * ];
+ * chart.create({ width: 8, height: 4, children: [labels.create({ data: cities, x: "gdp", y: "life", text: "name", direction: UP })] });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#marks
+ * @category Charts
+ */
+export declare const labels: import("@sophistry/core").Definition<LabelsProps<any>, import("@sophistry/core/internal").CompositeNode<LabelsProps<any>>, keyof LabelsProps<any>>;
+//# sourceMappingURL=labels.d.ts.map

package/dist/points/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/points/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAIX,IAAI,EACJ,MAAM,iBAAiB,CAAC;AAOzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAOxD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkB7E,OAAO,KAAK,EAAY,oBAAoB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAa5E;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO,CACvC,SAAQ,oBAAoB,CAAC,CAAC,CAAC,EAC9B,WAAW;IACZ,2BAA2B;IAC3B,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,qJAAqJ;IACrJ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC,wHAAwH;IACxH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1B,kIAAkI;IAClI,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAiMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,oJAgCjB,CAAC"}

package/dist/points/links.d.ts

@@ -0,0 +1,124 @@
+/**
+ * `links` and `vectors`: straight segments between data points, optionally
+ * arrowed. One instances node per layer: `line` items, or `arrow` items
+ * (with a tip) for `arrow: true` and for every vector. Items are keyed by
+ * datum index. The reveal is each item's
+ * `progress` channel, tracing its outline.
+ */
+import type { BandKey } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel, PositionValue } from "../data/channels";
+import type { TooltipSpec } from "../tooltip";
+/**
+ * Everything {@link links} and {@link vectors} share.
+ *
+ * @category Charts
+ */
+export interface SegmentStyleProps<T> {
+    /** Line colour, constant or `(d, i) => colour`. Defaults to the theme's first series colour. */
+    color?: ColorChannel<T>;
+    /** Line width. */
+    strokeWidth?: number;
+    opacity?: number;
+    /**
+     * Arrow-tip length, when there is a tip.
+     * @default 0.18
+     */
+    tipLength?: number;
+    /**
+     * Reveal, 0..1: each segment draws from its start to its end.
+     * @default 1
+     */
+    progress?: number;
+    /**
+     * Fraction of the reveal spent staggering one segment after the next, 0..0.95.
+     * @default 0
+     */
+    stagger?: number;
+    /** Hover tooltip: `true` for the segment's coordinates, or `(d, i) => string`. */
+    tooltip?: TooltipSpec<T>;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * Props of {@link links}.
+ *
+ * @category Charts
+ */
+export interface LinksProps<T = unknown> extends SegmentStyleProps<T> {
+    /** One segment per datum. */
+    data: readonly T[];
+    /** Start x: a number in data units (a `Date` reads as epoch ms) or a category on a band axis. */
+    x1: Channel<T, BandKey | PositionValue>;
+    /** Start y: a number in data units or a category on a band axis. */
+    y1: Channel<T, BandKey | PositionValue>;
+    /** End x, as `x1`. */
+    x2: Channel<T, BandKey | PositionValue>;
+    /** End y, as `y1`. */
+    y2: Channel<T, BandKey | PositionValue>;
+    /**
+     * Draw an arrow tip at the end.
+     * @default false
+     */
+    arrow?: boolean;
+}
+/**
+ * Props of {@link vectors}.
+ *
+ * @category Charts
+ */
+export interface VectorsProps<T = unknown> extends SegmentStyleProps<T> {
+    /** One arrow per datum. */
+    data: readonly T[];
+    /** Tail x, in data units (a `Date` reads as epoch ms). */
+    x: Channel<T, PositionValue>;
+    /** Tail y, in data units. */
+    y: Channel<T, PositionValue>;
+    /** X component, in data units (scaled by `scale`). */
+    u: Channel<T, number>;
+    /** Y component, in data units (scaled by `scale`). */
+    v: Channel<T, number>;
+    /**
+     * Multiplies every vector before drawing, to fit long ones in.
+     * @default 1
+     */
+    scale?: number;
+}
+/**
+ * Straight segments from `(x1, y1)` to `(x2, y2)`, optionally arrowed: before/after pairs,
+ * dumbbells, migrations. Each draws in the direction of change. One instances node.
+ *
+ * @example
+ * ```ts
+ * import { chart, links } from "@sophistry/charts";
+ *
+ * const moves = [
+ * 	{ from: 0, a: 1, to: 2, b: 3 },
+ * 	{ from: 1, a: 3, to: 3, b: 0 },
+ * ];
+ * chart.create({ width: 8, height: 4, children: [links.create({ data: moves, x1: "from", y1: "a", x2: "to", y2: "b", arrow: true })] });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#marks
+ * @category Charts
+ */
+export declare const links: import("@sophistry/core").Definition<LinksProps<any>, import("@sophistry/core/internal").CompositeNode<LinksProps<any>>, keyof LinksProps<any>>;
+/**
+ * Arrows from `(x, y)` along `(u, v)`, a quiver plot for data you already have (for a sampled
+ * function, use `vectorField`). Each grows from its tail. One instances node.
+ *
+ * @example
+ * ```ts
+ * import { chart, vectors } from "@sophistry/charts";
+ *
+ * const wind = [
+ * 	{ x: 0, y: 0, u: 1, v: 0.5 },
+ * 	{ x: 1, y: 0, u: 0.8, v: 1 },
+ * ];
+ * chart.create({ width: 8, height: 4, children: [vectors.create({ data: wind, x: "x", y: "y", u: "u", v: "v", scale: 0.5 })] });
+ * ```
+ *
+ * @see https://sophistry.dev/guides/charts/#marks
+ * @category Charts
+ */
+export declare const vectors: import("@sophistry/core").Definition<VectorsProps<any>, import("@sophistry/core/internal").CompositeNode<VectorsProps<any>>, keyof VectorsProps<any>>;
+//# sourceMappingURL=links.d.ts.map

package/dist/points/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/points/links.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,0BAA0B,CAAC;AAO/D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAU7E,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAQ5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IACnC,gGAAgG;IAChG,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IACpE,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,iGAAiG;IACjG,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC,oEAAoE;IACpE,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC,sBAAsB;IACtB,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC,sBAAsB;IACtB,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;IACxC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IACtE,2BAA2B;IAC3B,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,0DAA0D;IAC1D,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC7B,6BAA6B;IAC7B,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC7B,sDAAsD;IACtD,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB,sDAAsD;IACtD,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAmQD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK,iJAehB,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,OAAO,uJAelB,CAAC"}