@silverpoint/core 0.2.0 → 0.6.0

package/dist/model-CLhtoG75.d.ts

@@ -0,0 +1,53 @@
+import { m as CommonChartProps, am as Ground, G as Geometry } from './props-Dq8FC8GG.js';
+
+/** Tabular alternative of a chart's data, already formatted (REQ-121). */
+interface DataTable {
+    readonly caption: string;
+    readonly columns: readonly string[];
+    readonly rows: readonly (readonly string[])[];
+}
+/** What a recipe needs beyond the props: the resolved environment. */
+interface RecipeContext {
+    /** Resolved instance id. */
+    readonly id: string;
+    /** Resolved container width in px; `undefined` while it has not been measured. */
+    readonly width: number | undefined;
+    readonly locale: string;
+    readonly emptyState: Ground['emptyState'];
+    readonly domainPadding: number;
+}
+/**
+ * Everything an adapter renders: the geometry plus the accessible layer. Adapters translate
+ * it into nodes and compute nothing (Art. 2).
+ */
+interface ChartModel {
+    readonly chart: string;
+    readonly id: string;
+    /** `deferred` while the container has no usable size (REQ-009). */
+    readonly status: 'ready' | 'deferred';
+    readonly geometry: Geometry;
+    readonly chrome: 'card' | 'bare';
+    /** Accessible name (REQ-120). */
+    readonly name: string;
+    /** Description summarising the series (REQ-120). */
+    readonly description: string;
+    readonly ids: Readonly<{
+        title: string;
+        desc: string;
+        table: string;
+    }>;
+    readonly table: DataTable;
+    readonly dataTable: 'visible' | 'hidden' | 'none';
+}
+/** A chart: its display name and the pure function from props to model. */
+interface ChartRecipe<P extends CommonChartProps> {
+    readonly name: string;
+    build(props: P, context: RecipeContext): ChartModel;
+}
+/** Imperative handle every adapter exposes, deliberately minimal (API Spec §8.1). */
+interface ChartHandle {
+    getGeometry(): Geometry;
+    toSVGString(): string;
+}
+
+export type { ChartRecipe as C, DataTable as D, RecipeContext as R, ChartModel as a, ChartHandle as b };

package/dist/{types-D1hjElfL.d.ts → props-Dq8FC8GG.d.ts}

@@ -85,6 +85,23 @@ interface HitArea {
         column: number;
         row: number;
     }>;
+    /**
+     * The item's place in a hierarchy, when the chart draws one; `order` is the depth-first
+     * pre-order (REQ-438).
+     */
+    readonly node?: Readonly<{
+        id: string;
+        parent: string | null;
+        depth: number;
+        order: number;
+    }>;
+    /**
+     * Where each navigation key moves from this item, as an index into `hitAreas`, for a chart with
+     * its own keyboard model (a tree, REQ-438). When the first item has them, the keys follow them
+     * and nothing else; a key without a move stays. Computed in the core with the layout, so a chart
+     * without such a model carries none of its code (REQ-444).
+     */
+    readonly moves?: Readonly<Partial<Record<string, number>>>;
 }
 /**
  * A hatch tile shared by every shape of one tonal level (REQ-029).
@@ -155,6 +172,35 @@ interface Inker {
     ink(geometry: Geometry, options: InkOptions): Geometry;
 }
 
+type ToneStep = 1 | 2 | 3 | 4;
+/**
+ * The interface components' tokens of a ground (Data Model §3.8, REQ-312). Optional: a ground
+ * without them takes the defaults, so grounds registered before `0.3.0` keep working.
+ */
+interface UiTokens {
+    /** `inked`: build-time pieces laid as masks (DD-022). `css`: an exact border. */
+    readonly frame: 'inked' | 'css';
+    /** Frame variants generated per kind, 1..6. */
+    readonly frameVariants: number;
+    /** Control heights in px per size, each ≥ 24 (REQ-317). */
+    readonly controlHeight: Readonly<{
+        sm: number;
+        md: number;
+        lg: number;
+    }>;
+    /** Corner radius of the exact frame (`precision`, `css`), px. */
+    readonly radius: number;
+    /** Focus indicator width, px, ≥ 2 (REQ-316). */
+    readonly focusWidth: number;
+    /** Tonal level per state (DD-026); `alertError` fills an error Alert's box (C-3). */
+    readonly tone: Readonly<{
+        selected: ToneStep;
+        primary: ToneStep;
+        danger: ToneStep;
+        disabled: ToneStep;
+        alertError: ToneStep;
+    }>;
+}
 /** Name of a registered ground. */
 type GroundName = 'silverpoint' | (string & {});
 /** Declarative token set of a style ground (API Spec §6, Art. 7). */
@@ -190,6 +236,8 @@ interface Ground {
     }>;
     /** Expansion of degenerate domains (REQ-010). */
     readonly domainPadding: number;
+    /** Interface components' tokens (Data Model §3.8); defaults when absent. */
+    readonly ui?: UiTokens;
 }
 /** Name of a registered ground, or a complete ground. */
 type GroundRef = GroundName | Ground;
@@ -198,7 +246,8 @@ type GroundRef = GroundName | Ground;
 interface CommonChartProps {
     /**
      * Rows to draw. If omitted, the demo dataset is rendered (REQ-093): accessor props (`…Key`,
-     * `keys`, `names`) are ignored, every other prop applies.
+     * `keys`, `names`, `levels`, `axis`, `dimensions`, `period`, `nodes`) are ignored, every other
+     * prop applies.
      */
     data?: readonly Datum[];
     /** Style ground. Defaults to the app provider's, or `silverpoint`. */
@@ -570,150 +619,327 @@ interface VolvelleChartProps extends CommonChartProps {
      */
     indexValue?: string;
 }
-
-/** The three container breakpoints; their widths are fixed (TD DD-014). */
-type DashboardBreakpoint = 'sm' | 'md' | 'lg';
-/** A value that may differ per breakpoint; a bare number applies to all three. */
-type PerBreakpoint<T> = T | Partial<Record<DashboardBreakpoint, T>>;
-/** Serialisable layout (REQ-201). No functions, no DOM, no chart references. */
-interface DashboardLayout {
-    /** Columns per breakpoint. Default `{ sm: 1, md: 2, lg: 4 }` (REQ-208). */
-    columns?: PerBreakpoint<number>;
-    /** Height of one row unit, in px, card chrome included. Default `240`. */
-    rowHeight?: number;
-    /** Gap between cells, in px. Default `16`. */
-    gap?: number;
-    /** Cells in reading order (REQ-203). Omitted: every child, span 1. */
-    cells?: readonly DashboardCellLayout[];
-}
-interface DashboardCellLayout {
-    /** Matches `DashboardCell`'s `cell` prop; unique within the dashboard (REQ-205). */
-    id: string;
-    /** Default `1`. Clamped to the breakpoint's columns with `SP014` (REQ-204). */
-    colSpan?: PerBreakpoint<number>;
-    /** Default `1`. */
-    rowSpan?: PerBreakpoint<number>;
-}
-/** Link on a category key across the dashboard's charts (REQ-216). */
-interface DashboardLink {
-    /** The datum field whose value is matched, e.g. `'hour'`. */
-    key: string;
-}
-/** Name is required by the type: `title` or `label` (REQ-214). */
-type DashboardName = {
-    title: string;
-    label?: string;
-} | {
-    title?: undefined;
-    label: string;
-};
-type DashboardProps = DashboardName & {
-    /** Stable identifier; seeds of unnamed charts derive from it (REQ-209). Required. */
-    id: string;
-    layout?: DashboardLayout;
-    /** Long description, exposed as the region's description (REQ-214). */
-    description?: string;
-    /** Heading level of `title`. Default `2`. */
-    headingLevel?: 2 | 3 | 4 | 5 | 6;
-    /** Width in px used for nominal cell boxes on the server and at hydration (REQ-207). Default `1200`. */
-    ssrWidth?: number;
-    /** Linked interaction (REQ-216); client entry points only. */
-    link?: DashboardLink;
-    /** Inherited by every chart inside, below the chart's own prop (REQ-212). */
-    ground?: GroundRef;
-    substrate?: SubstrateName;
-    mode?: InkMode;
-    locale?: string;
-    className?: string;
-};
-interface DashboardCellProps {
-    /** The layout cell this child fills. Omitted: next in source order, span 1. */
-    cell?: string;
-}
-/** A cell's spans at every breakpoint. */
-type ResolvedSpan = Readonly<Record<DashboardBreakpoint, {
-    readonly col: number;
-    readonly row: number;
-}>>;
-/** The layout with every default applied and every per-breakpoint value expanded (internal surface). */
-interface ResolvedLayout {
-    readonly columns: Readonly<Record<DashboardBreakpoint, number>>;
-    readonly rowHeight: number;
-    readonly gap: number;
-    /** The layout's own cells, in its order; children are matched to them by `resolveDashboard`. */
-    readonly cells: readonly {
-        readonly id: string;
-        readonly span: ResolvedSpan;
-    }[];
-}
-/** The resolved dashboard (internal surface, API Spec §2). */
-interface DashboardModel {
-    readonly id: string;
-    /** In reading order. */
-    readonly cells: readonly ResolvedCell[];
-    /** The CSS custom properties of the wrapper, e.g. `--sp-dashboard-columns-md: 2`. */
-    readonly style: Readonly<Record<string, string>>;
+/** Bars as columns or rows, as `BarChart` has them. */
+type ChartOrientation = 'columns' | 'rows';
+/** `HistogramChart` (REQ-400): raw observations binned in the core (Data Model §2.15). */
+interface HistogramChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /**
+     * A number asks for that many equal-width bins over the niced extent; an array gives the
+     * thresholds, increasing. Freedman–Diaconis by default, Sturges when the IQR is 0 (REQ-432).
+     */
+    bins?: number | readonly number[];
+    /** Turns the counts into a running total. */
+    cumulative?: boolean;
+    orientation?: ChartOrientation;
+}
+/** `EcdfChart` (REQ-401): the empirical cumulative distribution as a step function. */
+interface EcdfChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** Two groups at most are drawn. Ignored without `data`. */
+    groupKey?: Accessor<string | null | undefined>;
+    /** Quantiles, in 0-1, drawn as rules. */
+    markers?: readonly number[];
+}
+/** `BoxPlotChart` (REQ-402): quartiles, median, Tukey whiskers and outliers per group. */
+interface BoxPlotChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    groupKey?: Accessor<string | null | undefined>;
+    /** Whisker reach as a multiple of the IQR; 1.5 by default (REQ-432). */
+    whisker?: number;
+    /** Draws the observations past the whiskers; `true` by default. */
+    outliers?: boolean;
+    orientation?: ChartOrientation;
+}
+/** `ViolinChart` (REQ-403): a mirrored kernel density per group, quartiles marked inside. */
+interface ViolinChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    groupKey?: Accessor<string | null | undefined>;
+    /** Kernel bandwidth in data units, shared by every group; Silverman's rule by default. */
+    bandwidth?: number;
+    /** Marks the quartiles inside each violin; `true` by default. */
+    quartiles?: boolean;
+    orientation?: ChartOrientation;
+}
+/** `RidgelineChart` (REQ-404): a kernel density per group on overlapping baselines. */
+interface RidgelineChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** The group of an observation; one ridge per group. Ignored without `data`. */
+    groupKey: Accessor<string | null | undefined>;
+    /** Kernel bandwidth in data units, shared by every group; Silverman's rule by default. */
+    bandwidth?: number;
+    /** How far a ridge reaches into the one behind it, 0-1; 0.5 by default. */
+    overlap?: number;
+}
+/** `BeeswarmChart` (REQ-405): one point per observation, packed without overlap. */
+interface BeeswarmChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    groupKey?: Accessor<string | null | undefined>;
+    /** Names the point in the readout and the table. Ignored without `data`. */
+    labelKey?: Accessor<string | null | undefined>;
+    /** Point radius in px; 3 by default. */
+    radius?: number;
+}
+/** `LollipopChart` (REQ-406): a stem from the baseline and a head at the value (Data Model §2.1). */
+interface LollipopChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    xKey?: Accessor<string | number>;
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    orientation?: ChartOrientation;
+    /** Order of the categories; `none` keeps the data order. */
+    sort?: 'none' | 'ascending' | 'descending';
+}
+/** `DumbbellChart` (REQ-407): two values per category joined by a segment (Data Model §2.16). */
+interface DumbbellChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    startKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    endKey?: Accessor<number | null | undefined>;
+    /** Titles of the two values; `['start', 'end']` by default. Ignored without `data`. */
+    names?: readonly [string, string];
+    /** `arrow` encodes the direction from the first value to the second. */
+    endMarker?: 'dot' | 'arrow';
+    /** `rows` by default: long category names read across. */
+    orientation?: ChartOrientation;
+}
+/** `SlopeChart` (REQ-408): two period axes, one segment per category (Data Model §2.16). */
+interface SlopeChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    startKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    endKey?: Accessor<number | null | undefined>;
+    /** Titles of the two periods; `['start', 'end']` by default. Ignored without `data`. */
+    names?: readonly [string, string];
+}
+/** `BumpChart` (REQ-409): the rank of each series at each x, computed in the core (Data Model §2.17). */
+interface BumpChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    xKey?: Accessor<string | number>;
+    /** Ignored without `data`. */
+    seriesKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** `descending` gives rank 1 to the highest value (the default). */
+    order?: 'descending' | 'ascending';
+    /** Series drawn, the best-ranked first; all by default. */
+    series?: number;
+}
+/** `ErrorBarChart` (REQ-410): a point estimate with its interval (Data Model §2.18). */
+interface ErrorBarChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    estimateKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    lowKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    highKey?: Accessor<number | null | undefined>;
+    /** A reference value drawn as a dotted rule. */
+    reference?: number;
+    /** `rows` by default, as a forest plot reads. */
+    orientation?: ChartOrientation;
 }
-interface ResolvedCell {
-    /** The layout cell's id; for a child placed in source order, its source index. */
+/** `IntervalChart` (REQ-411): floating bars from start to end on lanes (Data Model §2.19). */
+interface IntervalChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    laneKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    startKey?: Accessor<number | string | null | undefined>;
+    /** Ignored without `data`. */
+    endKey?: Accessor<number | string | null | undefined>;
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string | null | undefined>;
+    /** `date` reads ISO `YYYY-MM-DD` days in UTC; `number` by default. Ignored without `data`. */
+    axis?: 'number' | 'date';
+}
+/** `DivergingBarChart` (REQ-412): ordered levels stacked on both sides of a neutral centre (Data Model §2.20). */
+interface DivergingBarChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string>;
+    /** The level columns, most negative first. Ignored without `data`. */
+    levels: readonly string[];
+    /** Index of the neutral level, split across the centre; `null` for none. The middle one by default. */
+    neutral?: number | null;
+    /** Normalises each row to 100 %; `true` by default. */
+    percent?: boolean;
+}
+/** `ConnectedScatterChart` (REQ-413): an ordered path through x-y points (Data Model §2.21). */
+interface ConnectedScatterChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    xKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    yKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string | null | undefined>;
+    /** Draws direction marks along the path; `true` by default. */
+    arrows?: boolean;
+}
+/** `WaffleChart` (REQ-414): a unit grid filled in reading order by category (Data Model §2.2). */
+interface WaffleChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    nameKey?: Accessor<string | number>;
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** Cells in the grid; 100 by default. */
+    cells?: number;
+    /** Cells per row; 10 by default. */
+    columns?: number;
+}
+/** `MarimekkoChart` (REQ-415): column width ∝ total, segment height ∝ share (Data Model §2.22). */
+interface MarimekkoChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    columnKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    segmentKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+}
+/** Props shared by the hierarchy charts (Data Model §2.23). */
+interface HierarchyChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    idKey?: Accessor<string>;
+    /** `null` for the root. Ignored without `data`. */
+    parentKey?: Accessor<string | null | undefined>;
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string | null | undefined>;
+}
+/** `SquarifiedTreemap` (REQ-416): a hierarchy laid out by the squarified algorithm. */
+interface SquarifiedTreemapProps extends HierarchyChartProps {
+    /** Read on leaves; an internal node is the sum of its children. Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** Levels drawn below the root; all by default. */
+    depth?: number;
+    /** The node drawn as root, controlled (REQ-439); the data root by default. */
+    rootId?: string | null;
+}
+/** `SunburstChart` (REQ-417): a hierarchy as concentric rings of arcs. */
+interface SunburstChartProps extends HierarchyChartProps {
+    /** Read on leaves; an internal node is the sum of its children. Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** Rings drawn below the root; all by default. */
+    depth?: number;
+    /** The node drawn as root, controlled (REQ-439); the data root by default. */
+    rootId?: string | null;
+}
+/** `TreeChart` (REQ-418): a tidy node-link tree. */
+interface TreeChartProps extends HierarchyChartProps {
+    /** Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    orientation?: 'horizontal' | 'vertical';
+}
+/** `ParallelCoordinatesChart` (REQ-419): one axis per dimension, one polyline per row (Data Model §2.20). */
+interface ParallelCoordinatesChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string | null | undefined>;
+    /** The dimension columns, in axis order. Ignored without `data`. */
+    dimensions: readonly string[];
+    /** Axis domains by dimension; derived from the data when omitted (REQ-097). */
+    domains?: Readonly<Record<string, readonly [number, number]>>;
+}
+/** `PolarLineChart` (REQ-420): a line over angle × radius (Data Model §2.21). */
+interface PolarLineChartProps extends CommonChartProps {
+    /** In the units of `period`. Ignored without `data`. */
+    angleKey?: Accessor<number | null | undefined>;
+    /** The radius, `≥ 0`. Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** One turn, in the units of the angle; when set, the line closes. Ignored without `data`. */
+    period?: number;
+    /** Where the angle 0 sits, in degrees clockwise from 12 o'clock; 0 by default. */
+    startAngle?: number;
+}
+/** `PolarScatterChart` (REQ-421): points over angle × radius (Data Model §2.21). */
+interface PolarScatterChartProps extends CommonChartProps {
+    /** In the units of `period`. Ignored without `data`. */
+    angleKey?: Accessor<number | null | undefined>;
+    /** The radius, `≥ 0`. Ignored without `data`. */
+    radiusKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    sizeKey?: Accessor<number | null | undefined>;
+    /** One turn, in the units of the angle; 360 by default. Ignored without `data`. */
+    period?: number;
+}
+/** `DensityBinChart` (REQ-422): x-y points binned in two dimensions (Data Model §2.24). */
+interface DensityBinChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    xKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    yKey?: Accessor<number | null | undefined>;
+    binShape?: 'hexagon' | 'rect';
+    /** Bin size in px; 14 by default. */
+    binSize?: number;
+}
+/** `ContourChart` (REQ-423): iso-lines and filled bands of a density or a grid (Data Model §2.24). */
+interface ContourChartProps extends CommonChartProps {
+    /** `points` estimates a density from a point cloud; `grid` reads a regular grid of values. */
+    source?: 'points' | 'grid';
+    /** Ignored without `data`. */
+    xKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    yKey?: Accessor<number | null | undefined>;
+    /** The grid value (`source: 'grid'`). Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** A count of levels, or the thresholds, increasing: in the grid's values, or as shares of the density's peak. Ignored without `data`. */
+    levels?: number | readonly number[];
+    /** Fills the bands between levels; `true` by default. */
+    filled?: boolean;
+}
+/** `DelaunayChart` (REQ-424): the triangulation of x-y points, or its Voronoi cells (Data Model §2.24). */
+interface DelaunayChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    xKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    yKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    labelKey?: Accessor<string | null | undefined>;
+    mesh?: 'delaunay' | 'voronoi';
+}
+/** `VectorFieldChart` (REQ-425): an arrow per grid point (Data Model §2.24). */
+interface VectorFieldChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    xKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    yKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    uKey?: Accessor<number | null | undefined>;
+    /** Ignored without `data`. */
+    vKey?: Accessor<number | null | undefined>;
+    /** Arrow length per unit of magnitude; fitted to the grid by default. */
+    scale?: number;
+}
+/** A node of a `NetworkChart`; with finite `x` and `y` on every node, no layout runs (REQ-436). */
+interface NetworkNode {
     readonly id: string;
-    /** The child this cell holds: its index in `childCells`, so the adapter emits it here (I-11). */
-    readonly child: number;
-    /** Derived chart id: `${dashboard.id}--${cell.id}` (REQ-209). */
-    readonly chartId: string;
-    readonly span: ResolvedSpan;
-    /** Outer box at `ssrWidth`, 2 decimals (REQ-002, REQ-206). */
-    readonly nominal: {
-        readonly width: number;
-        readonly height: number;
-    };
-    /** The cell's CSS custom properties, e.g. `--sp-cell-col-lg: 2`. */
-    readonly style: Readonly<Record<string, string>>;
+    readonly label?: string;
+    readonly group?: string;
+    readonly x?: number;
+    readonly y?: number;
 }
-/**
- * What a cell hands its chart (TD §3.3): the derived id, the nominal box and the configuration the
- * dashboard sets. Plain data, so it crosses a React Server Components boundary as a prop.
- */
-interface DashboardCellContext {
-    readonly chartId: string;
-    readonly box: {
-        readonly width: number;
-        readonly height: number;
-    };
-    /** Only the keys the dashboard sets; the chart's own props and then the provider come around it. */
-    readonly config: Readonly<ProviderConfig>;
-}
-/** Everything an adapter writes for a dashboard: attributes, texts and cells, all from the core (Art. 2). */
-interface DashboardView {
-    readonly model: DashboardModel;
-    readonly section: {
-        readonly className: string;
-        readonly substrate: SubstrateName;
-        /** The heading's id, when there is a title. */
-        readonly labelledby?: string;
-        readonly describedby?: string;
-        /** `aria-label`, when only `label` names the dashboard. */
-        readonly label?: string;
-        readonly style: Readonly<Record<string, string>>;
-    };
-    readonly heading?: {
-        readonly level: 2 | 3 | 4 | 5 | 6;
-        readonly id: string;
-        readonly text: string;
-    };
-    readonly description?: {
-        readonly id: string;
-        readonly text: string;
-    };
-    /** In reading order. */
-    readonly cells: readonly {
-        /** Index of the child this cell holds. */
-        readonly child: number;
-        /** The chart's title id: `aria-labelledby` of the `article` (REQ-214). */
-        readonly labelledby: string;
-        readonly style: Readonly<Record<string, string>>;
-        readonly context: DashboardCellContext;
-    }[];
+/** `NetworkChart` (REQ-426): a node-link graph laid out deterministically (Data Model §2.7, §2.24). */
+interface NetworkChartProps extends CommonChartProps {
+    /** Ignored without `data`. */
+    sourceKey?: Accessor<string>;
+    /** Ignored without `data`. */
+    targetKey?: Accessor<string>;
+    /** 1 by default. Ignored without `data`. */
+    valueKey?: Accessor<number | null | undefined>;
+    /** The nodes, as data; the distinct ends of the links by default. Ignored without `data`. */
+    nodes?: readonly NetworkNode[];
+    /** Layout iterations; 300 by default. */
+    iterations?: number;
 }
 
-export type { DashboardModel as $, ActiveItem as A, BulletChartProps as B, CommonChartProps as C, DashboardProps as D, AreaChartProps as E, FunnelChartProps as F, Geometry as G, HeatmapChartProps as H, InkMode as I, RangeBandChartProps as J, KpiCardProps as K, LineChartProps as L, MeterChartProps as M, StreamChartProps as N, OrbitChartProps as O, ProviderConfig as P, ScatterChartProps as Q, Rect as R, Seed as S, TextLabel as T, BubbleChartProps as U, VolvelleChartProps as V, WaterfallChartProps as W, PerBreakpoint as X, DashboardBreakpoint as Y, DashboardLayout as Z, ResolvedLayout as _, Ground as a, DashboardView as a0, DashboardCellContext as a1, Accessor as a2, DashboardCellLayout as a3, DashboardCellProps as a4, DashboardLink as a5, GroundName as a6, HatchToneSpec as a7, HitArea as a8, InkOptions as a9, LabelKind as aa, LineCurve as ab, ResolvedCell as ac, ResolvedSpan as ad, StrokePart as ae, StrokeRole as af, Tile as ag, TonalRamp as ah, ToneLevel as ai, ToneSpec as aj, WeightToneSpec as ak, Stroke as b, StrokePaint as c, Inker as d, GroundRef as e, SubstrateName as f, Datum as g, PyramidChartProps as h, TreemapChartProps as i, SankeyChartProps as j, ActivityGridProps as k, StepChartProps as l, SparklineRowsProps as m, BarChartProps as n, StackedBarChartProps as o, ComposedChartProps as p, DonutChartProps as q, RadarChartProps as r, PolarBarChartProps as s, CoxcombChartProps as t, RadialArcGroupProps as u, RadialRingsProps as v, GaugeArcProps as w, WindRoseProps as x, ChordRingProps as y, CandlestickChartProps as z };
+export type { ComposedChartProps as $, ActiveItem as A, BoxPlotChartProps as B, ConnectedScatterChartProps as C, DumbbellChartProps as D, EcdfChartProps as E, PyramidChartProps as F, Geometry as G, HistogramChartProps as H, IntervalChartProps as I, HeatmapChartProps as J, TreemapChartProps as K, LollipopChartProps as L, MarimekkoChartProps as M, NetworkChartProps as N, SankeyChartProps as O, ParallelCoordinatesChartProps as P, ActivityGridProps as Q, RidgelineChartProps as R, SlopeChartProps as S, TreeChartProps as T, StepChartProps as U, ViolinChartProps as V, WaffleChartProps as W, SparklineRowsProps as X, KpiCardProps as Y, BarChartProps as Z, StackedBarChartProps as _, BeeswarmChartProps as a, WaterfallChartProps as a0, FunnelChartProps as a1, DonutChartProps as a2, RadarChartProps as a3, PolarBarChartProps as a4, CoxcombChartProps as a5, RadialArcGroupProps as a6, RadialRingsProps as a7, GaugeArcProps as a8, MeterChartProps as a9, UiTokens as aA, WeightToneSpec as aB, WindRoseProps as aa, ChordRingProps as ab, OrbitChartProps as ac, VolvelleChartProps as ad, CandlestickChartProps as ae, AreaChartProps as af, RangeBandChartProps as ag, StreamChartProps as ah, ScatterChartProps as ai, BubbleChartProps as aj, Accessor as ak, ChartOrientation as al, Ground as am, GroundName as an, HatchToneSpec as ao, HitArea as ap, InkOptions as aq, LabelKind as ar, LineCurve as as, NetworkNode as at, StrokePart as au, StrokeRole as av, Tile as aw, TonalRamp as ax, ToneLevel as ay, ToneSpec as az, BumpChartProps as b, ErrorBarChartProps as c, DivergingBarChartProps as d, SquarifiedTreemapProps as e, SunburstChartProps as f, PolarLineChartProps as g, PolarScatterChartProps as h, DensityBinChartProps as i, ContourChartProps as j, DelaunayChartProps as k, VectorFieldChartProps as l, CommonChartProps as m, Seed as n, Stroke as o, StrokePaint as p, InkMode as q, TextLabel as r, Inker as s, GroundRef as t, SubstrateName as u, ProviderConfig as v, LineChartProps as w, Datum as x, Rect as y, BulletChartProps as z };