@silverpoint/core 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,486 +1,5 @@
-/** A row of data. Charts reach its fields through accessors. */
-type Datum = Readonly<Record<string, unknown>>;
-/** Access to a field: key name or pure function. */
-type Accessor<T = number> = string | ((d: Datum, i: number) => T);
-/** Inking mode. `precision` amounts to using NullInker (REQ-021). */
-type InkMode = 'ink' | 'precision';
-/** Seed. A string is converted to an integer stably (REQ-003). */
-type Seed = number | string;
-/** Prepared substrates of the silverpoint ground (REQ-046). */
-type SubstrateName = 'cream' | 'green' | 'blue' | 'ochre';
-/** Active item resolved by the interaction engine (REQ-140). */
-interface ActiveItem {
-    readonly seriesKey: string;
-    readonly index: number;
-    readonly datum: Datum;
-    readonly value: number;
-    /** Coordinates in SVG space, not screen space. */
-    readonly point: Readonly<{
-        x: number;
-        y: number;
-    }>;
-}
-
-/** What a stroke is. Determines whether the Inker may touch it (REQ-022). */
-type StrokeRole = 'encoding' | 'ornament' | 'hatch';
-/** Semantic paint slot; maps to a CSS variable (API Spec §10). */
-type StrokePart = 'ink' | 'ink-secondary' | 'heighten' | 'rule' | 'grid' | 'axis';
-/**
- * How the stylesheet paints the shape: its outline, its interior with the part colour, its
- * interior with a hatch tile, or nothing — a toned shape whose edges other strokes draw, so the
- * Inker hatches it and no outline covers those edges.
- * @internal
- */
-type StrokePaint = 'stroke' | 'fill' | 'tile' | 'none';
-/** Tonal level on the ground's ramp; 0 is no fill (Data Model §3.4). */
-type ToneLevel = 0 | 1 | 2 | 3 | 4;
-/** Stroke instruction. It carries no color: color comes from CSS (REQ-042). */
-interface Stroke {
-    /** SVG path data, already rounded to 2 decimals (REQ-002). */
-    readonly d: string;
-    readonly role: StrokeRole;
-    readonly part: StrokePart;
-    /** Relative weight, resolved against the ground's token. */
-    readonly weight?: number;
-    /** @internal Defaults to `'stroke'`. */
-    readonly paint?: StrokePaint;
-    /** @internal Dash pattern, resolved by the stylesheet. */
-    readonly dash?: 'dotted';
-    /** @internal Tonal level a closed shape asks the Inker to hatch. */
-    readonly tone?: ToneLevel;
-    /** @internal Id of the tile in `Geometry.defs` that fills this shape. */
-    readonly tile?: string;
-}
-/** Kind of text a label carries; the stylesheet sets type by it. */
-type LabelKind = 'title' | 'badge' | 'value' | 'unit' | 'footer' | 'tick' | 'empty';
-interface TextLabel {
-    readonly x: number;
-    readonly y: number;
-    readonly text: string;
-    readonly kind: LabelKind;
-    /** Paint slot: `text` for primary labels, `axis` for muted ones. */
-    readonly part: 'text' | 'axis';
-    readonly anchor: 'start' | 'middle' | 'end';
-}
-/** A datum's position, as the interaction engine sees it (REQ-140). */
-interface HitArea {
-    readonly seriesKey: string;
-    readonly index: number;
-    readonly datum: Datum;
-    readonly value: number;
-    readonly x: number;
-    readonly y: number;
-    /** The item's area, when it has one — a bar, a cell, a tile. A pointer inside it wins. */
-    readonly box?: Rect;
-    /**
-     * The item's place in a grid, when the chart is one. When every item has one, the arrow keys
-     * move by column (left, right) and by row (up, down) across the whole grid (REQ-122).
-     */
-    readonly cell?: Readonly<{
-        column: number;
-        row: number;
-    }>;
-}
-/**
- * A hatch tile shared by every shape of one tonal level (REQ-029).
- * @internal
- */
-interface Tile {
-    /** Scoped to the chart instance (REQ-030). */
-    readonly id: string;
-    readonly width: number;
-    readonly height: number;
-    /** Rotation of the tile in degrees. */
-    readonly angle: number;
-    readonly strokes: readonly Stroke[];
-}
-interface Rect {
-    readonly x: number;
-    readonly y: number;
-    readonly width: number;
-    readonly height: number;
-}
-/** Everything a chart needs in order to draw itself. Serializable (REQ-011). */
-interface Geometry {
-    readonly viewBox: Rect;
-    readonly strokes: readonly Stroke[];
-    readonly labels: readonly TextLabel[];
-    readonly hitAreas: readonly HitArea[];
-    /** @internal Hatch tiles referenced by strokes painted with `'tile'`. */
-    readonly defs: readonly Tile[];
-    /** @internal The drawing area; the interaction engine ignores anything outside it. */
-    readonly plot: Rect;
-}
-
-/** One step of a ground's tonal ramp (Data Model §3.4). */
-interface ToneSpec {
-    readonly style: 'hachure' | 'cross-hatch';
-    readonly gap: number;
-    /** Hatch angle in degrees; cross-hatch adds the perpendicular. */
-    readonly angle: number;
-}
-type TonalRamp = Readonly<Record<Exclude<ToneLevel, 0>, ToneSpec>>;
-interface InkOptions {
-    readonly seed: number;
-    readonly roughness: number;
-    readonly bowing: number;
-    readonly hatchAngle: number;
-    readonly hatchGap: number;
-    readonly fillWeight: number;
-    /** Upper bound of nodes the Inker must not exceed. */
-    readonly nodeBudget: number;
-    /** @internal `tile` shares one hatch tile per tonal level (REQ-029). */
-    readonly hatchFill?: 'tile' | 'per-shape';
-    /** @internal The ground's tonal ramp. */
-    readonly tonalRamp?: TonalRamp;
-    /** @internal Prefix that scopes generated ids to the chart instance (REQ-030). */
-    readonly scope?: string;
-}
-interface Inker {
-    readonly name: string;
-    /** Receives exact geometry and returns the inked geometry. */
-    ink(geometry: Geometry, options: InkOptions): Geometry;
-}
-
-/** Name of a registered ground. */
-type GroundName = 'silverpoint' | (string & {});
-/** Declarative token set of a style ground (API Spec §6, Art. 7). */
-interface Ground {
-    readonly name: string;
-    /** How it builds tonal value. `wash` is the anticipated exception to Art. 6. */
-    readonly tonalMechanism: 'hatch' | 'weight' | 'wash';
-    /** Name of the registered Inker that inks it. */
-    readonly inker: string;
-    readonly substrates: Readonly<Record<string, string>>;
-    readonly ink: Readonly<{
-        primary: string;
-        secondary: string;
-        heighten: string;
-        rule: string;
-        grid: string;
-        text: string;
-        textMuted: string;
-    }>;
-    readonly inkOptions: Omit<InkOptions, 'seed' | 'nodeBudget' | 'hatchFill' | 'tonalRamp' | 'scope'>;
-    /** Hatch density bound, to stay within the node budget. */
-    readonly maxHatchDensity: number;
-    /** Tonal levels 1-4 (Data Model §3.4). */
-    readonly tonalRamp: TonalRamp;
-    readonly typography: Readonly<{
-        display: string;
-        scale: number;
-    }>;
-    /** What to draw when there is no data (REQ-007). */
-    readonly emptyState: Readonly<{
-        text: string;
-        rule: boolean;
-    }>;
-    /** Expansion of degenerate domains (REQ-010). */
-    readonly domainPadding: number;
-}
-/** Name of a registered ground, or a complete ground. */
-type GroundRef = GroundName | Ground;
-
-/** Props present in every chart, identical in React and Angular (REQ-094). */
-interface CommonChartProps {
-    /** Rows to draw. If omitted, the demo dataset is rendered (REQ-093). */
-    data?: readonly Datum[];
-    /** Style ground. Defaults to the app provider's, or `silverpoint`. */
-    ground?: GroundRef;
-    /** Prepared substrate within the ground (REQ-046). */
-    substrate?: SubstrateName;
-    /** `ink` by default; `precision` disables inking (REQ-021). */
-    mode?: InkMode;
-    /** Seed. If omitted, it is derived from `id` stably (REQ-003). */
-    seed?: Seed;
-    /** Stable identifier. If omitted, it is generated deterministically. */
-    id?: string;
-    /** Height of the drawing area in px. Width is the container's unless pinned. */
-    height?: number;
-    width?: number;
-    /** `card` draws the full frame; `bare` only the drawing area (REQ-095). */
-    chrome?: 'card' | 'bare';
-    /** How areas are filled (REQ-029). */
-    hatchFill?: 'tile' | 'per-shape';
-    title?: string;
-    badge?: string;
-    value?: string | number;
-    unit?: string;
-    footerLeft?: string;
-    footerRight?: string;
-    /** Accessible name. If omitted, it is derived from `title` (REQ-120). */
-    label?: string;
-    /** Long description for screen readers (REQ-120). */
-    description?: string;
-    /** Tabular alternative; `hidden` leaves it for assistive technology only (REQ-121). */
-    dataTable?: 'visible' | 'hidden' | 'none';
-    locale?: string;
-    numberFormat?: Intl.NumberFormatOptions;
-    className?: string;
-}
-type LineCurve = 'monotone' | 'linear' | 'natural' | 'step';
-/** `LineChart` (REQ-060): spline with an optional dotted baseline series. */
-interface LineChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    secondaryKey?: Accessor<number | null | undefined>;
-    curve?: LineCurve;
-    /** `all` draws the secondary series when there is one; `primary` omits it. */
-    series?: 'all' | 'primary';
-    /** Whether a gap left by a missing value is bridged (REQ-008). */
-    connectNulls?: boolean;
-}
-/** Configuration an application sets once for every chart (API Spec §8). */
-interface ProviderConfig {
-    ground?: GroundRef;
-    substrate?: SubstrateName;
-    mode?: InkMode;
-    locale?: string;
-}
-/** `BulletChart` (REQ-069): one bar per target, with a marker at the target. Values in 0-100. */
-interface BulletChartProps extends CommonChartProps {
-    titleKey?: Accessor<string>;
-    actualKey?: Accessor<number | null | undefined>;
-    targetKey?: Accessor<number | null | undefined>;
-}
-/** `PyramidChart` (REQ-070): stacked tiers whose width encodes the value (0-100). */
-interface PyramidChartProps extends CommonChartProps {
-    labelKey?: Accessor<string>;
-    widthKey?: Accessor<number | null | undefined>;
-    toneKey?: Accessor<number | null | undefined>;
-}
-/** `HeatmapChart` (REQ-084): labelled rows of values, normalised against `scaleMax`. */
-interface HeatmapChartProps extends CommonChartProps {
-    labelKey?: Accessor<string>;
-    valuesKey?: Accessor<readonly (number | null)[] | null | undefined>;
-    /** Value that maps to the darkest tone; 100 by default. */
-    scaleMax?: number;
-    /** Names of the columns, in order; missing ones fall back to `#k` (delta-006). */
-    columnLabels?: readonly string[];
-}
-/** `TreemapChart` (REQ-085): tiles of `cols × rows` cells placed in a `columns × rows` grid. */
-interface TreemapChartProps extends CommonChartProps {
-    labelKey?: Accessor<string>;
-    shareKey?: Accessor<number | null | undefined>;
-    columns?: number;
-    rows?: number;
-}
-/** `SankeyChart` (REQ-086): flow bands between layered nodes. */
-interface SankeyChartProps extends CommonChartProps {
-    sourceKey?: Accessor<string>;
-    targetKey?: Accessor<string>;
-    valueKey?: Accessor<number | null | undefined>;
-}
-/** `ActivityGrid` (REQ-087): one cell per day, a column per week. */
-interface ActivityGridProps extends CommonChartProps {
-    dateKey?: Accessor<string>;
-    countKey?: Accessor<number | null | undefined>;
-    levelKey?: Accessor<number | null | undefined>;
-    /** Weeks shown, the most recent last; 26 by default. */
-    weeks?: number;
-}
-/** `StepChart` (REQ-061): a series drawn as steps. */
-interface StepChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    /** Where the step sits between two points; `after` by default. */
-    step?: 'after' | 'before' | 'middle';
-}
-/** `SparklineRows` (REQ-062): one row per series — name, sparkline, readout (delta-008). */
-interface SparklineRowsProps extends CommonChartProps {
-    /** Rows shown, from the first; all by default. */
-    rows?: number;
-    nameKey?: Accessor<string>;
-    /** The printed readout; the last value of the series by default. */
-    readoutKey?: Accessor<string | number | null | undefined>;
-    /** The row's points: an array. */
-    seriesKey?: Accessor<readonly unknown[] | null | undefined>;
-    /** The value of one point; the point itself when it is a number, else its `value`. */
-    pointKey?: Accessor<number | null | undefined>;
-}
-/** `KpiCard` (REQ-063): a metric, its delta, and an area sparkline of the series. */
-interface KpiCardProps extends CommonChartProps {
-    valueKey?: Accessor<number | null | undefined>;
-    /** The metric's name, printed under the figure. */
-    metric?: string;
-    /** Signed change, printed with its sign and a direction mark. */
-    delta?: number;
-    /** Direction of the mark; from the sign of `delta` by default. */
-    deltaTone?: 'up' | 'down' | 'flat';
-}
-/** `BarChart` (REQ-064): pill bars, as columns or rows, with an optional second series. */
-interface BarChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    secondaryKey?: Accessor<number | null | undefined>;
-    orientation?: 'columns' | 'rows';
-}
-/** `StackedBarChart` (REQ-065): one stacked segment per key. */
-interface StackedBarChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    keys?: readonly string[];
-    /** Display names of the keys, in order; the keys themselves by default. */
-    names?: readonly string[];
-}
-/** `ComposedChart` (REQ-066): columns and a spline on one value scale. */
-interface ComposedChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    barKey?: Accessor<number | null | undefined>;
-    lineKey?: Accessor<number | null | undefined>;
-    showLine?: boolean;
-}
-/** `WaterfallChart` (REQ-067): totals from zero and floating deltas from the running total. */
-interface WaterfallChartProps extends CommonChartProps {
-    stepKey?: Accessor<string>;
-    /** An absolute total: the bar starts at zero and resets the running total. */
-    baseKey?: Accessor<number | null | undefined>;
-    /** A change from the running total. */
-    deltaKey?: Accessor<number | null | undefined>;
-}
-/** `FunnelChart` (REQ-068): horizontal, centred stages. */
-interface FunnelChartProps extends CommonChartProps {
-    stageKey?: Accessor<string>;
-    valueKey?: Accessor<number | null | undefined>;
-}
-/** `CandlestickChart` (REQ-071): OHLC bodies and wicks (Data Model §2.6). */
-interface CandlestickChartProps extends CommonChartProps {
-    timeKey?: Accessor<string | number>;
-    openKey?: Accessor<number | null | undefined>;
-    highKey?: Accessor<number | null | undefined>;
-    lowKey?: Accessor<number | null | undefined>;
-    closeKey?: Accessor<number | null | undefined>;
-    /** Price bounds of the scale; derived from the data when omitted (REQ-097). */
-    bounds?: readonly [number, number];
-}
-/** `AreaChart` (REQ-072): a curved, toned area under its line. */
-interface AreaChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    curve?: LineCurve;
-}
-/** `RangeBandChart` (REQ-073): the band between a low and a high series. */
-interface RangeBandChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    lowKey?: Accessor<number | null | undefined>;
-    highKey?: Accessor<number | null | undefined>;
-}
-/** `StreamChart` (REQ-074): two waves, overlaid or stacked. */
-interface StreamChartProps extends CommonChartProps {
-    xKey?: Accessor<string | number>;
-    keys?: readonly string[];
-    stacked?: boolean;
-}
-/** `ScatterChart` (REQ-082): points on two linear scales, optionally sized. */
-interface ScatterChartProps extends CommonChartProps {
-    xKey?: Accessor<number | null | undefined>;
-    yKey?: Accessor<number | null | undefined>;
-    sizeKey?: Accessor<number | null | undefined>;
-    /** Marker area in px², smallest to largest; `[60, 240]` by default. */
-    sizeRange?: readonly [number, number];
-}
-/** `BubbleChart` (REQ-083): circles whose area encodes `sizeKey`. */
-interface BubbleChartProps extends CommonChartProps {
-    xKey?: Accessor<number | null | undefined>;
-    yKey?: Accessor<number | null | undefined>;
-    sizeKey?: Accessor<number | null | undefined>;
-    /** Circle area in px², smallest to largest; `[100, 500]` by default. */
-    sizeRange?: readonly [number, number];
-}
-/** `DonutChart` (REQ-075): sectors ∝ value around a central readout (Data Model §2.2). */
-interface DonutChartProps extends CommonChartProps {
-    nameKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    /** Printed in the centre; the total by default. */
-    centerValue?: string | number;
-    /** A line under the centre value. */
-    centerLabel?: string;
-    /** Names every sector with its share beside the ring; `true` by default. */
-    legend?: boolean;
-}
-/** `RadarChart` (REQ-076): one spoke per subject, a closed polygon of values (Data Model §2.2). */
-interface RadarChartProps extends CommonChartProps {
-    subjectKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    /** The value range along a spoke; `[0, the largest value]`, niced, by default. */
-    domain?: readonly [number, number];
-}
-/** `PolarBarChart` (REQ-077): 360° bars out from a hole, length ∝ value (Data Model §2.2). */
-interface PolarBarChartProps extends CommonChartProps {
-    nameKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-}
-/** `CoxcombChart` (REQ-088): equal angles, sector **area** ∝ value (Data Model §2.2). */
-interface CoxcombChartProps extends CommonChartProps {
-    nameKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    /** Where the first sector starts, in degrees clockwise from 12 o'clock; 0 by default. */
-    startAngle?: number;
-}
-/** `RadialArcGroup` (REQ-078): concentric 180° tracks, sweep ∝ value / the largest (Data Model §2.2). */
-interface RadialArcGroupProps extends CommonChartProps {
-    nameKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-}
-/** `RadialRings` (REQ-079): concentric progress rings, sweep ∝ value in 0-100 (Data Model §2.2). */
-interface RadialRingsProps extends CommonChartProps {
-    nameKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-}
-/** `GaugeArc` (REQ-080): a 240° arc swept to a percent (Data Model §2.3). */
-interface GaugeArcProps extends CommonChartProps {
-    /** 0 to 100; saturated at the ends outside it. */
-    percent?: number;
-    /** Names the measure under the readout. */
-    caption?: string;
-    /** Printed in place of the percent. */
-    readout?: string;
-}
-/** `MeterChart` (REQ-081): a semicircular meter with a needle at a percent (Data Model §2.3). */
-interface MeterChartProps extends CommonChartProps {
-    /** 0 to 100; saturated at the ends outside it. */
-    percent?: number;
-    /** Names the measure under the readout. */
-    caption?: string;
-    /** Printed in place of the percent. */
-    readout?: string;
-}
-/** `WindRose` (REQ-089): observations of (bearing, speed) binned by compass sector and speed. */
-interface WindRoseProps extends CommonChartProps {
-    /** Where the wind blows from, in degrees clockwise from north. */
-    bearingKey?: Accessor<number | null | undefined>;
-    /** The wind speed; 0 is a calm, which has no direction. */
-    valueKey?: Accessor<number | null | undefined>;
-    /** Compass sectors: 4, 8, 16 or 32; 16 by default. */
-    sectors?: number;
-    /** Ascending speed thresholds that split each sector; `[5, 10, 15, 20]` by default. */
-    bins?: readonly number[];
-}
-/** `ChordRing` (REQ-091): directed flows between categories around a circle (Data Model §2.7). */
-interface ChordRingProps extends CommonChartProps {
-    sourceKey?: Accessor<string | number>;
-    targetKey?: Accessor<string | number>;
-    valueKey?: Accessor<number | null | undefined>;
-    /** Categories drawn; past it the smallest merge into "Other" (`SP010`). 12 by default. */
-    maxCategories?: number;
-}
-/** `OrbitChart` (REQ-092): nested elliptical orbits with markers along them (Data Model §2.10, delta-009). */
-interface OrbitChartProps extends CommonChartProps {
-    /** Orbits shown, from the inside out; all by default. */
-    orbits?: number;
-    /** A row's markers; `'markers'` by default. */
-    markerKey?: Accessor<readonly unknown[] | null | undefined>;
-    /** A marker's period, 0-1 over the cycle; `'period'` by default. */
-    periodKey?: Accessor<number | null | undefined>;
-}
-/** `VolvelleChart` (REQ-090): concentric categorical rings read against one index (delta-010). */
-interface VolvelleChartProps extends CommonChartProps {
-    /** Rings shown, from the inside out; all by default. */
-    rings?: number;
-    /** The ring whose segment is brought under the index, 0-based; 0 by default. */
-    indexRing?: number;
-    /** The segment of `indexRing` under the index; its first segment by default. */
-    indexValue?: string;
-}
+import { G as Geometry, C as CommonChartProps, a as Ground, S as Seed, b as Stroke, c as StrokePaint, I as InkMode, T as TextLabel, d as Inker, e as GroundRef, f as SubstrateName, P as ProviderConfig, L as LineChartProps, g as Datum, A as ActiveItem, R as Rect, B as BulletChartProps, h as PyramidChartProps, H as HeatmapChartProps, i as TreemapChartProps, j as SankeyChartProps, k as ActivityGridProps, l as StepChartProps, m as SparklineRowsProps, K as KpiCardProps, n as BarChartProps, o as StackedBarChartProps, p as ComposedChartProps, W as WaterfallChartProps, F as FunnelChartProps, q as DonutChartProps, r as RadarChartProps, s as PolarBarChartProps, t as CoxcombChartProps, u as RadialArcGroupProps, v as RadialRingsProps, w as GaugeArcProps, M as MeterChartProps, x as WindRoseProps, y as ChordRingProps, O as OrbitChartProps, V as VolvelleChartProps, z as CandlestickChartProps, E as AreaChartProps, J as RangeBandChartProps, N as StreamChartProps, Q as ScatterChartProps, U as BubbleChartProps, X as PerBreakpoint, Y as DashboardBreakpoint, Z as DashboardLayout, _ as ResolvedLayout, D as DashboardProps, $ as DashboardModel, a0 as DashboardView, a1 as DashboardCellContext } from './types-D1hjElfL.js';
+export { a2 as Accessor, a3 as DashboardCellLayout, a4 as DashboardCellProps, a5 as DashboardLink, a6 as GroundName, a7 as HatchToneSpec, a8 as HitArea, a9 as InkOptions, aa as LabelKind, ab as LineCurve, ac as ResolvedCell, ad as ResolvedSpan, ae as StrokePart, af as StrokeRole, ag as Tile, ah as TonalRamp, ai as ToneLevel, aj as ToneSpec, ak as WeightToneSpec } from './types-D1hjElfL.js';
 
 /** Tabular alternative of a chart's data, already formatted (REQ-121). */
 interface DataTable {
@@ -637,6 +156,8 @@ interface PathView {
     readonly paint: StrokePaint;
     /** `data-dash` attribute, omitted when `null`. */
     readonly dash: string | null;
+    /** `data-weight` attribute: a `weight` ground's tonal level (REQ-028), omitted when `null`. */
+    readonly weight: string | null;
     /** `fill` attribute — only ever a `url(#tile)` reference, omitted when `null`. */
     readonly fill: string | null;
 }
@@ -665,7 +186,7 @@ declare function toSvgView(model: ChartModel, style: ViewStyle): SvgView;
 declare function svgString(view: SvgView): string;
 
 /** Stable diagnostic codes, part of the public surface (API Spec §11). */
-type SpCode = 'SP001' | 'SP002' | 'SP003' | 'SP004' | 'SP005' | 'SP006' | 'SP007' | 'SP008' | 'SP009' | 'SP010' | 'SP011' | 'SP012' | 'SP013';
+type SpCode = 'SP001' | 'SP002' | 'SP003' | 'SP004' | 'SP005' | 'SP006' | 'SP007' | 'SP008' | 'SP009' | 'SP010' | 'SP011' | 'SP012' | 'SP013' | 'SP014' | 'SP015' | 'SP016';
 interface Detail {
     /** The property involved. */
     readonly property: string;
@@ -1015,4 +536,90 @@ declare const scatterChart: ChartRecipe<ScatterChartProps>;
 /** `BubbleChart` recipe (REQ-083): circles whose area encodes the size. */
 declare const bubbleChart: ChartRecipe<BubbleChartProps>;
 
-export { type Accessor, type ActiveItem, type ActivityGridProps, type AreaChartProps, type BandScale, type BarChartProps, type BubbleChartProps, type BulletChartProps, type CandlestickChartProps, type ChartHandle, type ChartModel, type ChartRecipe, type ChordRingProps, type CommonChartProps, type ComposedChartProps, type CoxcombChartProps, DEFAULTS, DISPLAY_FACE_PROBE, type DataTable, type Datum, type Detail, type DiagnosticSink, type DonutChartProps, FORCED_PRECISION_QUERY, type FontFaceSetLike, type FunnelChartProps, type GaugeArcProps, type Geometry, type Ground, type GroundName, type GroundRef, type HeatmapChartProps, type HitArea, type InkMode, type InkOptions, type Inker, type InteractionEvent, type InteractionResult, type KpiCardProps, LINE_CHART_DEMO, LINE_CHART_DEMO_KEYS, type LabelKind, type LineChartProps, type LineCurve, type LinearScale, MIN_TOUCH_TARGET, type MeterChartProps, NAVIGATION_KEYS, NullInker, type OrbitChartProps, PATH_BYTE_BUDGET, type PathView, type PatternView, type PointerKind, type PolarBarChartProps, type ProviderConfig, type PyramidChartProps, type RadarChartProps, type RadialArcGroupProps, type RadialRingsProps, type RangeBandChartProps, type Readout, type RecipeContext, type Rect, type ResolvedConfig, type SankeyChartProps, type ScaleSite, type ScatterChartProps, type Seed, SilverpointError, type SpCode, type SparklineRowsProps, type StackedBarChartProps, type StepChartProps, type StreamChartProps, type Stroke, type StrokePaint, type StrokePart, type StrokeRole, type SubstrateName, type SvgView, type TextLabel, type TextView, type Tile, type TonalRamp, type ToneLevel, type ToneSpec, type TreemapChartProps, type ViewStyle, type VolvelleChartProps, type WaterfallChartProps, type WindRoseProps, __setDiagnosticSink, activityGrid, addDays, areaChart, bandScale, barChart, bubbleChart, bulletChart, candlestickChart, checkTypeface, chordRing, circlePath, composedChart, coxcombChart, createPrng, deriveSeed, diagnose, donutChart, enforceHeightening, expandDomain, extent, fnv1a32, funnelChart, gaugeArc, heatmapChart, instanceId, isoDate, kpiCard, lineChart, linearScale, max, meterChart, min, orbitChart, parseGeometry, parseIsoDate, pathBytes, polarBarChart, pyramidChart, radarChart, radialArcGroup, radialRings, rangeBandChart, readout, reduceInteraction, registerInker, resolveActive, resolveConfig, resolveInker, resolveSeed, round2, roundGeometry, roundPathData, sameActive, sankeyChart, scatterChart, serializeGeometry, sparklineRows, stackedBarChart, stepActive, stepChart, streamChart, svgString, toSvgPoint, toSvgView, treemapChart, volvelleChart, waterfallChart, weekday, windRose };
+/** The dashboard's documented defaults (API Spec §5.1, REQ-208). */
+declare const DASHBOARD_DEFAULTS: Readonly<{
+    readonly columns: Readonly<{
+        sm: 1;
+        md: 2;
+        lg: 4;
+    }>;
+    readonly rowHeight: 240;
+    readonly gap: 16;
+    readonly span: 1;
+    readonly headingLevel: 2;
+    readonly ssrWidth: 1200;
+}>;
+/** A per-breakpoint value expanded to all three: a bare value applies everywhere, a gap keeps `fallback`. */
+declare function perBreakpoint<T>(value: PerBreakpoint<T> | undefined, fallback: Readonly<Record<DashboardBreakpoint, T>>): Record<DashboardBreakpoint, T>;
+/**
+ * The layout with its defaults applied and its numbers held to the contract of Data Model §2.13
+ * (REQ-201, REQ-204, REQ-208): invalid numbers fall back with SP002, a column span wider than its
+ * breakpoint is clamped with SP014 (I-12). Pure but for diagnostics; JSON-serialisable (I-10).
+ */
+declare function resolveLayout(layout: DashboardLayout | undefined): ResolvedLayout;
+
+/** The breakpoint a container of `width` px falls in (DD-014). */
+declare function breakpointOf(width: number): DashboardBreakpoint;
+/**
+ * The dashboard's resolved model (REQ-201): children matched to layout cells by id in the four
+ * rules of Data Model §2.13, spans held to the columns, chart ids derived from the dashboard's id
+ * (REQ-209), nominal boxes at `ssrWidth` (REQ-206) and the custom properties the adapters write
+ * (REQ-202). Pure but for diagnostics; never throws on a mismatch (REQ-205).
+ */
+declare function resolveDashboard(props: DashboardProps, childCells: readonly (string | undefined)[]): DashboardModel;
+/**
+ * The size a chart is drawn at inside a cell box (REQ-206): the cell's width, and its height less
+ * the chart's own card chrome, so every card in a row has the same outer height (I-13). The chrome
+ * is measured by building `recipe` at a probe height — the recipe may add rows of its own (KpiCard's
+ * value line) — and read from `cardLayout` when no recipe is given. The chart's own `width` and
+ * `height` take precedence (API Spec §7.1, size precedence).
+ */
+declare function cellChartBox<P extends CommonChartProps>(cell: {
+    width: number;
+    height: number;
+}, chartProps: P, recipe?: ChartRecipe<P>): {
+    width: number;
+    height: number;
+};
+
+/**
+ * The dashboard as an adapter writes it (REQ-200, REQ-214): the section's class, substrate, name
+ * and variables, the heading and description, and per cell its variables, its label and the
+ * context its chart reads. `children` gives, in source order, each child's `cell` and its chart's
+ * own `id` when the adapter can read it.
+ */
+declare function dashboardView(props: DashboardProps, children: readonly {
+    readonly cell?: string;
+    readonly id?: string;
+}[]): DashboardView;
+/**
+ * A chart's props inside a cell (API Spec §7.1, size precedence; REQ-212 config precedence): its
+ * own `id`, `height` and config win; the cell supplies the rest. `width` is the width to draw at
+ * until the chart is measured — the chart's own, else the cell's nominal width (REQ-207).
+ */
+declare function inCell<P extends CommonChartProps>(props: P, cell: DashboardCellContext | undefined, recipe: ChartRecipe<P>): {
+    props: P;
+    width: number | undefined;
+};
+
+/**
+ * The items of `model` whose datum carries `value` under `key` (REQ-216), by the index of their hit
+ * area: exact matches only, never the nearest (REQ-217). A chart whose data has no `key` at all
+ * shows no linked mark and warns SP016, once. Pure: the model is read, never touched.
+ */
+declare function linkedItems(model: ChartModel, key: string, value: unknown): readonly number[];
+/** A dashboard's linked value (REQ-216): the key, the value of the source's active item, and the source chart's id. */
+interface LinkState {
+    readonly key: string;
+    readonly value: unknown;
+    readonly source: string;
+}
+/** The link a chart's active item sets; `null` when it clears, which clears every chart (REQ-218). */
+declare function linkFrom(key: string, source: string, active: ActiveItem | null): LinkState | null;
+/**
+ * The marker paths a chart draws for a link (REQ-216): the readout's own marker, for each item
+ * carrying the value. None for the source, which shows its active item, nor for a cleared link.
+ */
+declare function linkedMarks(model: Pick<ChartModel, 'id' | 'chart' | 'geometry' | 'table'>, state: LinkState | null | undefined): readonly string[];
+
+export { ActiveItem, ActivityGridProps, AreaChartProps, type BandScale, BarChartProps, BubbleChartProps, BulletChartProps, CandlestickChartProps, type ChartHandle, type ChartModel, type ChartRecipe, ChordRingProps, CommonChartProps, ComposedChartProps, CoxcombChartProps, DASHBOARD_DEFAULTS, DEFAULTS, DISPLAY_FACE_PROBE, DashboardBreakpoint, DashboardCellContext, DashboardLayout, DashboardModel, DashboardProps, DashboardView, type DataTable, Datum, type Detail, type DiagnosticSink, DonutChartProps, FORCED_PRECISION_QUERY, type FontFaceSetLike, FunnelChartProps, GaugeArcProps, Geometry, Ground, GroundRef, HeatmapChartProps, InkMode, Inker, type InteractionEvent, type InteractionResult, KpiCardProps, LINE_CHART_DEMO, LINE_CHART_DEMO_KEYS, LineChartProps, type LinearScale, type LinkState, MIN_TOUCH_TARGET, MeterChartProps, NAVIGATION_KEYS, NullInker, OrbitChartProps, PATH_BYTE_BUDGET, type PathView, type PatternView, PerBreakpoint, type PointerKind, PolarBarChartProps, ProviderConfig, PyramidChartProps, RadarChartProps, RadialArcGroupProps, RadialRingsProps, RangeBandChartProps, type Readout, type RecipeContext, Rect, type ResolvedConfig, ResolvedLayout, SankeyChartProps, type ScaleSite, ScatterChartProps, Seed, SilverpointError, type SpCode, SparklineRowsProps, StackedBarChartProps, StepChartProps, StreamChartProps, Stroke, StrokePaint, SubstrateName, type SvgView, TextLabel, type TextView, TreemapChartProps, type ViewStyle, VolvelleChartProps, WaterfallChartProps, WindRoseProps, __setDiagnosticSink, activityGrid, addDays, areaChart, bandScale, barChart, breakpointOf, bubbleChart, bulletChart, candlestickChart, cellChartBox, checkTypeface, chordRing, circlePath, composedChart, coxcombChart, createPrng, dashboardView, deriveSeed, diagnose, donutChart, enforceHeightening, expandDomain, extent, fnv1a32, funnelChart, gaugeArc, heatmapChart, inCell, instanceId, isoDate, kpiCard, lineChart, linearScale, linkFrom, linkedItems, linkedMarks, max, meterChart, min, orbitChart, parseGeometry, parseIsoDate, pathBytes, perBreakpoint, polarBarChart, pyramidChart, radarChart, radialArcGroup, radialRings, rangeBandChart, readout, reduceInteraction, registerInker, resolveActive, resolveConfig, resolveDashboard, resolveInker, resolveLayout, resolveSeed, round2, roundGeometry, roundPathData, sameActive, sankeyChart, scatterChart, serializeGeometry, sparklineRows, stackedBarChart, stepActive, stepChart, streamChart, svgString, toSvgPoint, toSvgView, treemapChart, volvelleChart, waterfallChart, weekday, windRose };