@sophistry/charts 0.0.0-stage → 0.0.1

package/dist/points/symbol-marker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `symbolMarker`: the shape a scatter's markers are instances of. Internal
+ * (not in the family barrel, so no binding is generated for it).
+ *
+ * An instances node of this shape covers every symbol at once, and the
+ * core picks the cheapest spec for what the items hold:
+ *
+ * - every item a circle: `circle` marks (the renderer's splat path), the
+ *   same spec `instances(circle, ...)` publishes;
+ * - one other symbol and one radius: one shared `outline`, placed per item;
+ * - mixed symbols or radii: a `paths` mark (one outline per distinct
+ *   symbol and radius, cached by the instances node).
+ *
+ * The radius is a geometry input rather than a `scale`, so a marker's
+ * outline stroke keeps its width at any size.
+ */
+import type { ShapeInstanceable, ShapeProps } from "@sophistry/core";
+import type { Point } from "@sophistry/core/geometry";
+import type { SymbolName } from "../math/symbol";
+/** Props of {@link symbolMarker}. */
+export interface SymbolMarkerProps extends ShapeProps {
+    /** Centre, in scene units. */
+    center?: Point;
+    /** The radius of the circle whose area the symbol has. */
+    radius?: number;
+    /** The symbol. @default "circle" */
+    symbol?: SymbolName;
+}
+/**
+ * A scatter marker: a circle, or a symbol with the area of a circle of
+ * `radius`, centred on `center`.
+ */
+export declare const symbolMarker: import("@sophistry/core").Definition<SymbolMarkerProps, import("@sophistry/core").ShapeNode<SymbolMarkerProps>, "center" | "radius" | "symbol" | ShapeInstanceable>;
+//# sourceMappingURL=symbol-marker.d.ts.map

package/dist/points/symbol-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-marker.d.ts","sourceRoot":"","sources":["../../src/points/symbol-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,qCAAqC;AACrC,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACpD,8BAA8B;IAC9B,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,qKA0CvB,CAAC"}

package/dist/points/ticks.d.ts

@@ -0,0 +1,103 @@
+/**
+ * `tickX` / `tickY`: short marks at positions along one axis, a rug on the
+ * axis or one tick spanning each band (a strip plot). One `line` instances
+ * node per layer (see `segment-marks.ts`).
+ */
+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";
+/**
+ * What {@link tickX} and {@link tickY} share.
+ *
+ * @category Charts
+ */
+export interface TickBaseProps<T> extends KeyedTransitionProps<T>, RevealProps {
+    /** One tick per datum. */
+    data: readonly T[];
+    /**
+     * Tick length, when not spanning a band.
+     * @default 0.3
+     */
+    length?: number;
+    /** Tick colour, constant or `(d, i) => colour`. Defaults to the theme's first series colour. */
+    color?: ColorChannel<T>;
+    /** Line width. */
+    strokeWidth?: number;
+    opacity?: number;
+    /**
+     * Reveal, 0..1: each tick draws from its low end.
+     * @default 1
+     */
+    progress?: number;
+    /** Hover tooltip: `true` for its category (if any) and value, or a template, function or options. */
+    tooltip?: TooltipSpec<T>;
+    /** How ticks move when `data` changes outside a `to` blend; see {@link MarkTransition}. */
+    transition?: MarkTransition;
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * Props of {@link tickX}.
+ *
+ * @category Charts
+ */
+export interface TickXProps<T = unknown> extends TickBaseProps<T> {
+    /** Position along x, in data units (a `Date` reads as epoch ms). Defaults to the datum when `data` is `number[]`. */
+    x?: Channel<T, PositionValue>;
+    /**
+     * Which row the tick sits in: a category on a band y axis spans that band (a strip plot); a
+     * number centres a `length`-long tick on it. Omitted, the tick sits on the x axis (a rug).
+     */
+    y?: Channel<T, BandKey | PositionValue>;
+}
+/**
+ * Props of {@link tickY}.
+ *
+ * @category Charts
+ */
+export interface TickYProps<T = unknown> extends TickBaseProps<T> {
+    /** Position along y, in data units (a `Date` reads as epoch ms). Defaults to the datum when `data` is `number[]`. */
+    y?: Channel<T, PositionValue>;
+    /** Which column the tick sits in; see {@link TickXProps.y}. Omitted, the tick sits on the y axis. */
+    x?: Channel<T, BandKey | PositionValue>;
+}
+/**
+ * Short vertical marks at x positions: a rug on the x axis, or with a category `y` one tick
+ * spanning each band, a strip plot that never overplots into a blob. One instances node.
+ *
+ * @example
+ * ```ts
+ * import { chart, tickX } from "@sophistry/charts";
+ *
+ * const rows = [
+ * 	{ group: "a", value: 3 },
+ * 	{ group: "b", value: 5 },
+ * ];
+ * chart.create({ width: 8, height: 4, children: [tickX.create({ data: rows, x: "value", y: "group" })] });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#distributions
+ * @category Charts
+ */
+export declare const tickX: import("@sophistry/core").Definition<TickXProps<any>, import("@sophistry/core/internal").CompositeNode<TickXProps<any>>, keyof TickXProps<any>>;
+/**
+ * Short horizontal marks at y positions: the transpose of {@link tickX}.
+ *
+ * @example
+ * ```ts
+ * import { chart, tickY } from "@sophistry/charts";
+ *
+ * const rows = [
+ * 	{ group: "a", value: 3 },
+ * 	{ group: "b", value: 5 },
+ * ];
+ * chart.create({ width: 8, height: 4, children: [tickY.create({ data: rows, y: "value", x: "group" })] });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#distributions
+ * @category Charts
+ */
+export declare const tickY: import("@sophistry/core").Definition<TickYProps<any>, import("@sophistry/core/internal").CompositeNode<TickYProps<any>>, keyof TickYProps<any>>;
+//# sourceMappingURL=ticks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../src/points/ticks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,0BAA0B,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAiB7E,OAAO,KAAK,EAAY,oBAAoB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAS5D;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAC,EAAE,WAAW;IAC7E,0BAA0B;IAC1B,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IAChE,qHAAqH;IACrH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC9B;;;OAGG;IACH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IAChE,qHAAqH;IACrH,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC9B,qGAAqG;IACrG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC;CACxC;AA8WD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK,iJAIhB,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK,iJAIhB,CAAC"}

package/dist/props.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Props shared by chart marks, documented once here: the data transition
+ * (`to`, `blend`, `staging`, `enterStagger`, `key`), the staggered reveal
+ * (`stagger`) and the named reveal styles. A mark re-declares a prop only
+ * where its meaning is narrower.
+ */
+import type { BandKey } from "@sophistry/core/geometry";
+import type { Channel } from "./data/channels";
+import type { JoinStaging } from "./math/join";
+/**
+ * Order for `stagger` and `enterStagger`: `"position"` follows the mark's own
+ * layout (along x, by value, by category); `"random"` shuffles by a hash of
+ * each datum's `key`, the same every frame, so it scrubs.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#reveals
+ * @category Charts
+ */
+export type StaggerOrder = "position" | "random";
+/**
+ * How a curve-like mark (`<LinePlot>`, `<Ecdf>`, `<Stairs>`, `<FillBetween>`)
+ * reveals: `"x"` sweeps left to right, `"length"` draws along its arc length.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#reveals
+ * @category Charts
+ */
+export type CurveReveal = "x" | "length";
+/** How `<Density>` reveals: `"x"` sweeps in along x, `"grow"` rises from the baseline. @category Charts */
+export type DensityReveal = "x" | "grow";
+/** How `<StackPlot>` reveals: `"grow"` from the baseline, `"x"` along x, `"length"` by arc length. @category Charts */
+export type StackReveal = "grow" | "x" | "length";
+/** How bars reveal: `"grow"` out of their foot, `"stack"` scaled about zero together, `"fade"` in place. @category Charts */
+export type BarReveal = "grow" | "stack" | "fade";
+/** How a radial mark (`<PieChart>`, `<RadarChart>`) reveals: `"grow"` out from the centre, `"sweep"` round the turn. @category Charts */
+export type RadialReveal = "grow" | "sweep";
+/** How a frame's layers reveal: `"layers"` each its own way, `"x"` behind one shared front. @category Charts */
+export type LayersReveal = "layers" | "x";
+/**
+ * A mark's data transition from `data` to `to`, driven by `blend`.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+ * @category Charts
+ */
+export interface TransitionProps<T> {
+    /**
+     * The data to transition to. Marks in both `data` and `to` move, marks only
+     * in `to` enter, marks only in `data` exit. At `blend` 0 the chart shows
+     * `data`, at 1 it shows `to`.
+     */
+    to?: readonly T[];
+    /** Transition progress from `data` (0) to `to` (1). @default 0 */
+    blend?: number;
+    /**
+     * How `blend` is spent: `"staged"` runs exit, then move, then enter, each
+     * eased (so drive `blend` linearly); `"together"` runs all at once, linearly.
+     * @default "staged"
+     */
+    staging?: JoinStaging;
+    /**
+     * Fraction of the enter stage spent staggering entering marks in `to`'s
+     * order, 0..0.95; 0 enters them together. Moves and exits never stagger.
+     * @default 0
+     */
+    enterStagger?: number;
+}
+/**
+ * {@link TransitionProps} for a per-datum mark, matching data between the
+ * two ends by `key`.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+ * @category Charts
+ */
+export interface KeyedTransitionProps<T> extends TransitionProps<T> {
+    /**
+     * Each mark's identity: a key of `T` or `(d, i) => key`. A datum with the
+     * same key keeps its mark across updates and transitions. Defaults to the datum's index.
+     */
+    key?: Channel<T, BandKey>;
+}
+/**
+ * {@link TransitionProps} for a mark drawing one shape per `series` (lines,
+ * curves, areas): shapes are matched by `series` and morphed.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#data-transitions
+ * @category Charts
+ */
+export interface SeriesTransitionProps<T> extends TransitionProps<T> {
+    /** As {@link TransitionProps.staging}, with series morphing in the move stage. @default "staged" */
+    staging?: JoinStaging;
+    /**
+     * Fraction of the enter stage spent staggering entering series in `to`'s
+     * order, 0..0.95; each sweeps in over its own share. Moves and exits never
+     * stagger.
+     * @default 0
+     */
+    enterStagger?: number;
+}
+/**
+ * A mark's staggered reveal.
+ *
+ * @see https://sophistry.dev/guides/chart-animation/#reveals
+ * @category Charts
+ */
+export interface RevealProps {
+    /**
+     * Fraction of the reveal spent staggering one mark after the next, 0..0.95;
+     * 0 reveals all marks together.
+     * @default 0
+     */
+    stagger?: number;
+}
+/** Checks at compile time that a key list names every key of `P` and nothing else. */
+export declare const TRANSITION_KEYS: readonly ["to", "blend", "staging", "enterStagger"];
+/** {@link KeyedTransitionProps}' keys. */
+export declare const KEYED_TRANSITION_KEYS: readonly ["to", "blend", "staging", "enterStagger", "key"];
+/** {@link RevealProps}' keys. */
+export declare const REVEAL_KEYS: readonly ["stagger"];
+/**
+ * The datum type chart definitions are declared over. A definition is one
+ * value (`scatter`), not a generic function, so its props cannot follow the
+ * type of `data`; over `any`, a channel key is any string and a channel
+ * function receives the datum untyped. Annotate the function's parameter
+ * (`(d: Row) => d.sales`) for checked reads.
+ *
+ * @category Channels
+ */
+export type AnyDatum = any;
+//# sourceMappingURL=props.d.ts.map

package/dist/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,QAAQ,CAAC;AAEzC,2GAA2G;AAC3G,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,MAAM,CAAC;AAEzC,uHAAuH;AACvH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC;AAElD,6HAA6H;AAC7H,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD,yIAAyI;AACzI,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,gHAAgH;AAChH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,GAAG,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC;;;;OAIG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAClB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IAClE;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACnE,oGAAoG;IACpG,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,sFAAsF;AACtF,eAAO,MAAM,eAAe,qDAK1B,CAAC;AAEH,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,4DAGhC,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,WAAW,sBAAqC,CAAC;AAE9D;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC"}

package/dist/radial/chord.d.ts

@@ -0,0 +1,149 @@
+/**
+ * `chord`: flows between groups round a circle.
+ *
+ * Two path batches: the ribbons (each its own fill and fade, paint order
+ * under the ring) and the group arcs (each its own fill). Hover, taps,
+ * tooltips and accessible names resolve per ribbon and per arc through
+ * `event.item` / `itemLabel`. Group names are anchored `label` nodes.
+ */
+import type { ColorInput } from "@sophistry/core";
+import type { Point } from "@sophistry/core/geometry";
+import type { Channel, ColorChannel, RequiredUnless } from "../data/channels";
+import type { SankeyId } from "../math/sankey";
+import type { TooltipSpec } from "../tooltip";
+/** @category Charts */
+export interface ChordBaseProps<L, N> {
+    /** The flows, one per datum; flows between the same two groups (same direction) add up. */
+    data: readonly L[];
+    /** The group a flow leaves. */
+    source: Channel<L, SankeyId>;
+    /** The group a flow enters. */
+    target: Channel<L, SankeyId>;
+    /** The flow's size; non-finite and negative values count as 0. */
+    value: Channel<L, number>;
+    /**
+     * The groups, in the order they go round the circle and are coloured. Every id a flow names
+     * must be here (else throws). Defaults to the flows' endpoints in first-seen order.
+     */
+    nodes?: readonly N[];
+    /**
+     * A group's id, matched against `source`/`target`. Defaults to the datum itself, when `nodes`
+     * is `(string | number)[]`.
+     */
+    nodeId?: Channel<N, SankeyId>;
+    /** The text beside a group's arc. Defaults to its id. */
+    nodeLabel?: Channel<N, string>;
+    /** Centre of the diagram. Defaults to the origin. */
+    center?: Point;
+    /**
+     * Outer radius of the ring; labels sit outside it.
+     * @default 2
+     */
+    radius?: number;
+    /** Thickness of the ring. Defaults to 0.08 × `radius`. */
+    thickness?: number;
+    /**
+     * Gap between neighbouring groups, in radians.
+     * @default 0.04
+     */
+    padAngle?: number;
+    /**
+     * Angle the first group begins at, in radians from +x. The default is 12 o'clock.
+     * @default Math.PI / 2
+     */
+    startAngle?: number;
+    /**
+     * Go round clockwise.
+     * @default true
+     */
+    clockwise?: boolean;
+    /**
+     * One chord per flow direction, and arcs sized by inflow plus outflow, so a group that only
+     * receives still shows. Otherwise one chord per pair of groups, arcs sized by outflow.
+     * @default false
+     */
+    directed?: boolean;
+    /**
+     * With `directed`: draw each chord's receiving end as an arrowhead.
+     * @default false
+     */
+    arrows?: boolean;
+    /** Length of an arrowhead. Defaults to 0.08 × `radius`. */
+    arrowSize?: number;
+    /** Group colours, cycled by group order. Defaults to the theme's categorical colours. */
+    colors?: readonly ColorInput[];
+    /**
+     * A chord's colour: its `"source"` group's (the larger end, or the sender when `directed`), its
+     * `"target"` group's, or a colour channel given the chord's first flow.
+     * @default "source"
+     */
+    ribbonColor?: "source" | "target" | ColorChannel<L>;
+    /**
+     * Fill opacity of the chords, 0..1.
+     * @default 0.55
+     */
+    ribbonOpacity?: number;
+    /**
+     * Draw group labels.
+     * @default true
+     */
+    labels?: boolean;
+    /**
+     * Font size of group labels.
+     * @default 0.22
+     */
+    labelFontSize?: number;
+    /**
+     * Reveal, 0..1: the ring sweeps round from `startAngle` with its labels, then the chords fade
+     * in.
+     * @default 1
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /**
+     * Fraction of the chords' reveal spent staggering them, 0..0.95.
+     * @default 0.5
+     */
+    stagger?: number;
+    /**
+     * Hover tooltip: `true` shows "A → B: value" on a chord and "name: value" on a group; a
+     * function replaces the chord text, given its first flow.
+     */
+    tooltip?: TooltipSpec<L>;
+    /** Paint order of the chords; the ring paints above them. */
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * Props of {@link chord}: `nodeId` is required when `nodes` holds records.
+ *
+ * @category Charts
+ */
+export type ChordProps<L, N = SankeyId> = ChordBaseProps<L, N> & RequiredUnless<N, SankeyId, "nodeId">;
+/**
+ * A chord diagram: flows between groups round a circle. Each group is an arc as long as its
+ * total, and each pair with any flow is joined by a ribbon as wide as the flow each way. Takes
+ * `source`/`target`/`value` like `sankey`; draws in scene units. Ribbons and arcs are one path
+ * batch each. See {@link chordLayout} and {@link chordRibbon} for the geometry alone.
+ *
+ * @example
+ * ```ts
+ * import { chord } from "@sophistry/charts";
+ *
+ * chord.create({
+ * 	data: [
+ * 		{ from: "north", to: "south", n: 5 },
+ * 		{ from: "south", to: "north", n: 3 },
+ * 	],
+ * 	source: "from",
+ * 	target: "to",
+ * 	value: "n",
+ * 	tooltip: true,
+ * });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#flows
+ * @category Charts
+ */
+export declare const chord: import("@sophistry/core").Definition<ChordBaseProps<any, any>, import("@sophistry/core/internal").CompositeNode<ChordBaseProps<any, any>>, keyof ChordBaseProps<any, any>>;
+//# sourceMappingURL=chord.d.ts.map

package/dist/radial/chord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chord.d.ts","sourceRoot":"","sources":["../../src/radial/chord.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,UAAU,EAMV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAQtD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAU9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuB9C,uBAAuB;AACvB,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC;IACnC,2FAA2F;IAC3F,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7B,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9B,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/B,qDAAqD;IACrD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACpD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;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,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7D,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AA+YvC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,4KAoEhB,CAAC"}

package/dist/radial/gauge.d.ts

@@ -0,0 +1,127 @@
+/**
+ * `gauge`: one value on an arc with a centre readout.
+ *
+ * One reading, so mostly single nodes: the track and the value arc
+ * (`annularSector`), the needle and its hub, the counting readout
+ * (`decimalNumber`) and the captions. The threshold bands, one outline each,
+ * draw as one path batch. Nodes are made once and shown or hidden; none is
+ * rebuilt while the reveal plays.
+ */
+import type { ColorInput } from "@sophistry/core";
+import type { Point } from "@sophistry/core/geometry";
+import type { TooltipSpec } from "../tooltip";
+/**
+ * One threshold zone of a {@link gauge}, given by where it *ends*.
+ *
+ * @category Charts
+ */
+export interface GaugeBand {
+    /**
+     * The value this band runs up to, in data units, starting where the previous band ends (or at
+     * `min`). `Infinity` means "to `max`".
+     */
+    to: number;
+    /** The band's colour. Defaults to the theme's categorical colours, by band index. */
+    color?: ColorInput;
+}
+/** @category Charts */
+export interface GaugeProps {
+    /**
+     * The reading, in data units. Drawn clamped to `[min, max]`; the readout shows it unclamped.
+     */
+    value: number;
+    /**
+     * The value at the start of the arc.
+     * @default 0
+     */
+    min?: number;
+    /**
+     * The value at the end of the arc.
+     * @default 100
+     */
+    max?: number;
+    /** Centre of the gauge. Defaults to the origin. */
+    center?: Point;
+    /**
+     * Outer radius of the arc.
+     * @default 1
+     */
+    radius?: number;
+    /** Radial thickness of the arc. Defaults to 0.18 × `radius`. */
+    thickness?: number;
+    /**
+     * Where `min` sits, in radians from +x (counter-clockwise positive, as on `arc`). The default
+     * is 210°: with the default `endAngle`, a 240° arc open at the bottom.
+     * @default 7 * Math.PI / 6
+     */
+    startAngle?: number;
+    /**
+     * Where `max` sits, in radians from +x; less than `startAngle` reads clockwise.
+     * @default -Math.PI / 6
+     */
+    endAngle?: number;
+    /**
+     * Threshold zones in ascending order (`[{ to: 60 }, { to: 85 }, { to: 100 }]`), drawn as a thin
+     * track inside the arc. Unless `color` is given, the value arc takes its band's colour.
+     */
+    bands?: readonly GaugeBand[];
+    /**
+     * Colour of the value arc. Defaults to the value's band colour, else the theme's first series
+     * colour.
+     */
+    color?: ColorInput;
+    /** Colour of the empty track behind the value arc. Defaults to the theme's grid colour. */
+    trackColor?: ColorInput;
+    /**
+     * Draw a needle from the centre to the value.
+     * @default false
+     */
+    needle?: boolean;
+    /**
+     * Decimal places of the readout (and tooltip).
+     * @default 0
+     */
+    decimalPlaces?: number;
+    /** Suffix on the readout, e.g. `"%"` or `" ms"`. */
+    unit?: string;
+    /** Readout font size. Defaults to 0.36 × `radius`. */
+    valueFontSize?: number;
+    /** Caption under the readout. */
+    label?: string;
+    /** Font size of `label` and the range labels. Defaults to 0.14 × `radius`. */
+    labelFontSize?: number;
+    /**
+     * Write `min` and `max` at the ends of the arc.
+     * @default true
+     */
+    rangeLabels?: boolean;
+    /**
+     * Reveal, 0..1: track and bands sweep in first, then the value arc sweeps to the value while
+     * the readout counts up.
+     * @default 1
+     * @see https://sophistry.dev/guides/chart-animation/#reveals
+     */
+    progress?: number;
+    /** Hover tooltip on the value arc: `true` for "label: value", or `(value) => string`. */
+    tooltip?: TooltipSpec<number>;
+    /** Paint order; higher draws later. */
+    zIndex?: number;
+    visible?: boolean;
+}
+/**
+ * A gauge: one value on an arc with a centre readout, the KPI dial of a dashboard. Optional
+ * threshold `bands` colour the value by zone; `needle` adds a pointer. Draws in scene units;
+ * needs no `chart`.
+ *
+ * @example
+ * ```ts
+ * import { gauge } from "@sophistry/charts";
+ *
+ * gauge.create({ value: 72, unit: "%", label: "CPU", bands: [{ to: 60 }, { to: 85 }, { to: 100 }] });
+ * ```
+ *
+ * @see https://sophistry.dev/reference/chart-catalogue/#gauges-bullets-waffles-mosaics-and-radial-bars
+ * @category Charts
+ */
+export declare const gauge: import("@sophistry/core").Definition<GaugeProps, import("@sophistry/core/internal").CompositeNode<GaugeProps>, keyof GaugeProps>;
+//# sourceMappingURL=gauge.d.ts.map

package/dist/radial/gauge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gauge.d.ts","sourceRoot":"","sources":["../../src/radial/gauge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEX,UAAU,EAKV,MAAM,iBAAiB,CAAC;AAazB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAUtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY9C;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACzB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qFAAqF;IACrF,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,uBAAuB;AACvB,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAkQD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,kIA6ChB,CAAC"}

package/dist/radial/index.d.ts

@@ -0,0 +1,16 @@
+/** Family barrel: radial. Owned by its family; re-exported from the package entry. */
+export type { ChordBaseProps, ChordProps } from "./chord";
+export { chord } from "./chord";
+export type { GaugeBand, GaugeProps } from "./gauge";
+export { gauge } from "./gauge";
+export type { PieChartBaseProps, PieChartProps } from "./pie-chart";
+export { pieChart } from "./pie-chart";
+export type { PolarAreaChartBaseProps, PolarAreaChartProps, } from "./polar-area-chart";
+export { polarAreaChart } from "./polar-area-chart";
+export type { RadarChartBaseProps, RadarChartProps } from "./radar-chart";
+export { radarChart } from "./radar-chart";
+export type { RadialBarChartBaseProps, RadialBarChartProps, } from "./radial-bar-chart";
+export { radialBarChart } from "./radial-bar-chart";
+export type { WaffleBaseProps, WaffleProps } from "./waffle";
+export { waffle } from "./waffle";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/radial/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EACX,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EACX,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}