@silverpoint/core 0.3.0 → 0.7.0

package/dist/model-DVVt59AB.d.ts

@@ -0,0 +1,53 @@
+import { m as CommonChartProps, am as Ground, G as Geometry } from './props-BZ9CcrGv.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/palettes.d.ts

@@ -0,0 +1,29 @@
+import { au as Palette } from './props-BZ9CcrGv.js';
+export { aD as PALETTE_PROPERTIES, aE as nestProvider, aF as paletteStyle, aG as resolvePalette } from './props-BZ9CcrGv.js';
+export { a as PALETTE_PAIRS, P as PaletteFinding, c as checkPalette, b as contrastRatio } from './contrast-siWF_R5o.js';
+
+/**
+ * The palette presets (REQ-463, Data Model §2.26): named after historical drawing media, each
+ * passing every pair of Data Model §3.9 (REQ-464, verified by the contrast gate). A subpath of its
+ * own, with the palette API (resolution, declarations, contrast), so the main entry stays inside its
+ * 45 kB budget (REQ-164) and an application ships only the presets it imports.
+ */
+
+/** The silverpoint ground's own inks on cream: what a chart draws with no palette. */
+declare const silverpoint: Palette;
+/** Red chalk, as in Leonardo's and Andrea del Sarto's studies. */
+declare const sanguine: Palette;
+/** Sepia wash and bistre. */
+declare const sepia: Palette;
+/** Iron-gall ink: the blue-black of manuscripts. */
+declare const ironGall: Palette;
+/** Verdigris, the copper green of illuminators. */
+declare const verdigris: Palette;
+/** Indigo, the dyers' and printers' blue. */
+declare const indigo: Palette;
+/** The six presets by name. */
+declare const PALETTES: Readonly<Record<string, Palette>>;
+/** Written out, not `Object.keys(PALETTES)`: a call the bundler cannot drop would keep every preset. */
+declare const PALETTE_NAMES: readonly string[];
+
+export { PALETTES, PALETTE_NAMES, Palette, indigo, ironGall, sanguine, sepia, silverpoint, verdigris };

package/dist/palettes.js

@@ -0,0 +1,79 @@
+export { PALETTE_PAIRS, PALETTE_PROPERTIES, checkPalette, contrastRatio, nestProvider, paletteStyle, resolvePalette } from './chunk-ANJSW5JX.js';
+import './chunk-5MP3BLZK.js';
+import './chunk-WYFRHI4S.js';
+
+// src/palettes.ts
+var preset = (palette) => Object.freeze({ ...palette });
+var silverpoint = /* @__PURE__ */ preset({
+  substrate: "#EDE7DA",
+  ink: "#5A5E65",
+  inkSecondary: "#685C4D",
+  heighten: "#FFFFFF",
+  rule: "#737A82",
+  grid: "#737A82",
+  text: "#3F4348",
+  textMuted: "#5A5E65"
+});
+var sanguine = /* @__PURE__ */ preset({
+  substrate: "#F2E8DC",
+  ink: "#8A3A24",
+  inkSecondary: "#6A4A3A",
+  heighten: "#FFFFFF",
+  rule: "#9A6450",
+  grid: "#9A6450",
+  text: "#4A2216",
+  textMuted: "#7A3E2C"
+});
+var sepia = /* @__PURE__ */ preset({
+  substrate: "#F0E6D2",
+  ink: "#6B4C2C",
+  inkSecondary: "#5A5148",
+  heighten: "#FFFFFF",
+  rule: "#8A6E52",
+  grid: "#8A6E52",
+  text: "#3B2A18",
+  textMuted: "#6B4C2C"
+});
+var ironGall = /* @__PURE__ */ preset({
+  substrate: "#EEEAE0",
+  ink: "#3C4858",
+  inkSecondary: "#6A4E36",
+  heighten: "#FFFFFF",
+  rule: "#6C7584",
+  grid: "#6C7584",
+  text: "#232B36",
+  textMuted: "#4A5566"
+});
+var verdigris = /* @__PURE__ */ preset({
+  substrate: "#E7EDE6",
+  ink: "#2C6355",
+  inkSecondary: "#65563F",
+  heighten: "#FFFFFF",
+  rule: "#5C7B71",
+  grid: "#5C7B71",
+  text: "#1F3D36",
+  textMuted: "#3E6A5E"
+});
+var indigo = /* @__PURE__ */ preset({
+  substrate: "#E9EAF1",
+  ink: "#3A4884",
+  inkSecondary: "#675641",
+  heighten: "#FFFFFF",
+  rule: "#68709A",
+  grid: "#68709A",
+  text: "#232C52",
+  textMuted: "#4A5590"
+});
+var PALETTES = /* @__PURE__ */ Object.freeze({
+  silverpoint,
+  sanguine,
+  sepia,
+  ironGall,
+  verdigris,
+  indigo
+});
+var PALETTE_NAMES = /* @__PURE__ */ Object.freeze(["silverpoint", "sanguine", "sepia", "ironGall", "verdigris", "indigo"]);
+
+export { PALETTES, PALETTE_NAMES, indigo, ironGall, sanguine, sepia, silverpoint, verdigris };
+//# sourceMappingURL=palettes.js.map
+//# sourceMappingURL=palettes.js.map

package/dist/palettes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/palettes.ts"],"names":[],"mappings":";;;;;AAWA,IAAM,MAAA,GAAS,CAAC,OAAA,KAAuD,MAAA,CAAO,OAAO,EAAE,GAAG,SAAS,CAAA;AAG5F,IAAM,8BAA8B,MAAA,CAAO;AAAA,EAChD,SAAA,EAAW,SAAA;AAAA,EACX,GAAA,EAAK,SAAA;AAAA,EACL,YAAA,EAAc,SAAA;AAAA,EACd,QAAA,EAAU,SAAA;AAAA,EACV,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,SAAA,EAAW;AACb,CAAC;AAGM,IAAM,2BAA2B,MAAA,CAAO;AAAA,EAC7C,SAAA,EAAW,SAAA;AAAA,EACX,GAAA,EAAK,SAAA;AAAA,EACL,YAAA,EAAc,SAAA;AAAA,EACd,QAAA,EAAU,SAAA;AAAA,EACV,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,SAAA,EAAW;AACb,CAAC;AAGM,IAAM,wBAAwB,MAAA,CAAO;AAAA,EAC1C,SAAA,EAAW,SAAA;AAAA,EACX,GAAA,EAAK,SAAA;AAAA,EACL,YAAA,EAAc,SAAA;AAAA,EACd,QAAA,EAAU,SAAA;AAAA,EACV,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,SAAA,EAAW;AACb,CAAC;AAGM,IAAM,2BAA2B,MAAA,CAAO;AAAA,EAC7C,SAAA,EAAW,SAAA;AAAA,EACX,GAAA,EAAK,SAAA;AAAA,EACL,YAAA,EAAc,SAAA;AAAA,EACd,QAAA,EAAU,SAAA;AAAA,EACV,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,SAAA,EAAW;AACb,CAAC;AAGM,IAAM,4BAA4B,MAAA,CAAO;AAAA,EAC9C,SAAA,EAAW,SAAA;AAAA,EACX,GAAA,EAAK,SAAA;AAAA,EACL,YAAA,EAAc,SAAA;AAAA,EACd,QAAA,EAAU,SAAA;AAAA,EACV,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,SAAA,EAAW;AACb,CAAC;AAGM,IAAM,yBAAyB,MAAA,CAAO;AAAA,EAC3C,SAAA,EAAW,SAAA;AAAA,EACX,GAAA,EAAK,SAAA;AAAA,EACL,YAAA,EAAc,SAAA;AAAA,EACd,QAAA,EAAU,SAAA;AAAA,EACV,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,IAAA,EAAM,SAAA;AAAA,EACN,SAAA,EAAW;AACb,CAAC;AAGM,IAAM,QAAA,0BAAqE,MAAA,CAAO;AAAA,EACvF,WAAA;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF,CAAC;AAGM,IAAM,aAAA,mBAAmD,MAAA,CAAO,MAAA,CAAO,CAAC,aAAA,EAAe,YAAY,OAAA,EAAS,UAAA,EAAY,WAAA,EAAa,QAAQ,CAAC","file":"palettes.js","sourcesContent":["/**\n * The palette presets (REQ-463, Data Model §2.26): named after historical drawing media, each\n * passing every pair of Data Model §3.9 (REQ-464, verified by the contrast gate). A subpath of its\n * own, with the palette API (resolution, declarations, contrast), so the main entry stays inside its\n * 45 kB budget (REQ-164) and an application ships only the presets it imports.\n */\nimport type { Palette } from './palette/palette';\n\nexport { nestProvider, PALETTE_PROPERTIES, paletteStyle, resolvePalette } from './palette/palette';\nexport { checkPalette, contrastRatio, PALETTE_PAIRS, type PaletteFinding } from './palette/contrast';\n\nconst preset = (palette: Required<Omit<Palette, 'focus'>>): Palette => Object.freeze({ ...palette });\n\n/** The silverpoint ground's own inks on cream: what a chart draws with no palette. */\nexport const silverpoint = /* @__PURE__ */ preset({\n  substrate: '#EDE7DA',\n  ink: '#5A5E65',\n  inkSecondary: '#685C4D',\n  heighten: '#FFFFFF',\n  rule: '#737A82',\n  grid: '#737A82',\n  text: '#3F4348',\n  textMuted: '#5A5E65',\n});\n\n/** Red chalk, as in Leonardo's and Andrea del Sarto's studies. */\nexport const sanguine = /* @__PURE__ */ preset({\n  substrate: '#F2E8DC',\n  ink: '#8A3A24',\n  inkSecondary: '#6A4A3A',\n  heighten: '#FFFFFF',\n  rule: '#9A6450',\n  grid: '#9A6450',\n  text: '#4A2216',\n  textMuted: '#7A3E2C',\n});\n\n/** Sepia wash and bistre. */\nexport const sepia = /* @__PURE__ */ preset({\n  substrate: '#F0E6D2',\n  ink: '#6B4C2C',\n  inkSecondary: '#5A5148',\n  heighten: '#FFFFFF',\n  rule: '#8A6E52',\n  grid: '#8A6E52',\n  text: '#3B2A18',\n  textMuted: '#6B4C2C',\n});\n\n/** Iron-gall ink: the blue-black of manuscripts. */\nexport const ironGall = /* @__PURE__ */ preset({\n  substrate: '#EEEAE0',\n  ink: '#3C4858',\n  inkSecondary: '#6A4E36',\n  heighten: '#FFFFFF',\n  rule: '#6C7584',\n  grid: '#6C7584',\n  text: '#232B36',\n  textMuted: '#4A5566',\n});\n\n/** Verdigris, the copper green of illuminators. */\nexport const verdigris = /* @__PURE__ */ preset({\n  substrate: '#E7EDE6',\n  ink: '#2C6355',\n  inkSecondary: '#65563F',\n  heighten: '#FFFFFF',\n  rule: '#5C7B71',\n  grid: '#5C7B71',\n  text: '#1F3D36',\n  textMuted: '#3E6A5E',\n});\n\n/** Indigo, the dyers' and printers' blue. */\nexport const indigo = /* @__PURE__ */ preset({\n  substrate: '#E9EAF1',\n  ink: '#3A4884',\n  inkSecondary: '#675641',\n  heighten: '#FFFFFF',\n  rule: '#68709A',\n  grid: '#68709A',\n  text: '#232C52',\n  textMuted: '#4A5590',\n});\n\n/** The six presets by name. */\nexport const PALETTES: Readonly<Record<string, Palette>> = /* @__PURE__ */ Object.freeze({\n  silverpoint,\n  sanguine,\n  sepia,\n  ironGall,\n  verdigris,\n  indigo,\n});\n\n/** Written out, not `Object.keys(PALETTES)`: a call the bundler cannot drop would keep every preset. */\nexport const PALETTE_NAMES: readonly string[] = /* @__PURE__ */ Object.freeze(['silverpoint', 'sanguine', 'sepia', 'ironGall', 'verdigris', 'indigo']);\n\nexport type { Palette } from './palette/palette';\n"]}

package/dist/{props-3G1XYd-r.d.ts → props-BZ9CcrGv.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).
@@ -183,6 +200,10 @@ interface UiTokens {
         disabled: ToneStep;
         alertError: ToneStep;
     }>;
+    /** Tonal level of the hatched backdrop behind a modal overlay; unhatched (weight grounds, precision) it is the opaque substrate. Default `2` (REQ-499). */
+    readonly backdrop?: ToneStep;
+    /** Level of a table's striped and hovered rows. Default `1` (REQ-475). */
+    readonly rowTone?: ToneStep;
 }
 /** Name of a registered ground. */
 type GroundName = 'silverpoint' | (string & {});
@@ -225,11 +246,53 @@ interface Ground {
 /** Name of a registered ground, or a complete ground. */
 type GroundRef = GroundName | Ground;
 
+/**
+ * The colours of one ground's inks, for one element or one section (REQ-460, Data Model §2.26).
+ * Every field is optional: an unset field keeps the ground's own. Values are any CSS colour;
+ * `checkPalette` can only measure hex values.
+ */
+interface Palette {
+    /** The prepared ground the drawing sits on. */
+    readonly substrate?: string;
+    /** The main series and the frames of UI components. */
+    readonly ink?: string;
+    /** The second series and the hatch of tones. */
+    readonly inkSecondary?: string;
+    /** White heightening on the live value (always outlined with `ink`). */
+    readonly heighten?: string;
+    /** Rules and baselines. */
+    readonly rule?: string;
+    /** Grid lines. */
+    readonly grid?: string;
+    /** Large figures and primary labels. */
+    readonly text?: string;
+    /** Axis labels and secondary text. */
+    readonly textMuted?: string;
+    /** Focus ring of UI components; `ink` by default. */
+    readonly focus?: string;
+}
+/** Field → custom property, in the order of every emitted declaration (REQ-461). */
+declare const PALETTE_PROPERTIES: Readonly<Record<keyof Palette, `--sp-${string}`>>;
+/**
+ * The palettes of an element's layers merged field by field, a later layer winning: call it as
+ * `resolvePalette(provider, cell, element)` (REQ-462). Unknown fields and unsafe values are dropped
+ * with `SP024`; a weak hex pair is kept and warned `SP023` (REQ-466, REQ-467).
+ */
+declare function resolvePalette(...layers: readonly (Palette | undefined)[]): Palette | undefined;
+/** `--sp-ink:#8A3A24;--sp-text:#4A2216`: a palette's declarations, in PALETTE_PROPERTIES order; '' for none (REQ-461). */
+declare function paletteStyle(palette: Palette | undefined): string;
+/**
+ * A provider inside another (REQ-462): the inner one's set fields win, the rest is the outer's, and
+ * the palettes merge field by field, so a nested provider re-colours a section and keeps the rest.
+ */
+declare function nestProvider(outer: ProviderConfig | undefined, own: ProviderConfig): ProviderConfig;
+
 /** 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): 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`. */
@@ -238,6 +301,11 @@ interface CommonChartProps {
     substrate?: SubstrateName;
     /** `ink` by default; `precision` disables inking (REQ-021). */
     mode?: InkMode;
+    /**
+     * Colours over the ground's, field by field, written on the root's `style` (REQ-461). Merged over
+     * the dashboard's and the provider's (REQ-462); presets are on `@silverpoint/core/palettes`.
+     */
+    palette?: Palette;
     /** Seed. If omitted, it is derived from `id` stably (REQ-003). */
     seed?: Seed;
     /** Stable identifier. If omitted, it is generated deterministically. */
@@ -286,6 +354,8 @@ interface ProviderConfig {
     substrate?: SubstrateName;
     mode?: InkMode;
     locale?: string;
+    /** Colours for every chart and component below, under their own and their dashboard's (REQ-462). */
+    palette?: Palette;
 }
 /** `BulletChart` (REQ-069): one bar per target, with a marker at the target. Values in 0-100. */
 interface BulletChartProps extends CommonChartProps {
@@ -601,5 +671,327 @@ interface VolvelleChartProps extends CommonChartProps {
      */
     indexValue?: 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;
+}
+/** `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;
+    readonly label?: string;
+    readonly group?: string;
+    readonly x?: number;
+    readonly y?: number;
+}
+/** `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 { LabelKind as $, ActiveItem as A, BulletChartProps as B, CommonChartProps as C, Datum as D, RangeBandChartProps as E, FunnelChartProps as F, Geometry as G, HeatmapChartProps as H, InkMode as I, StreamChartProps as J, KpiCardProps as K, LineChartProps as L, MeterChartProps as M, ScatterChartProps as N, OrbitChartProps as O, ProviderConfig as P, BubbleChartProps as Q, Rect as R, Seed as S, TextLabel as T, Accessor as U, VolvelleChartProps as V, WaterfallChartProps as W, GroundName as X, HatchToneSpec as Y, HitArea as Z, InkOptions as _, Ground as a, LineCurve as a0, StrokePart as a1, StrokeRole as a2, Tile as a3, TonalRamp as a4, ToneLevel as a5, ToneSpec as a6, UiTokens as a7, WeightToneSpec as a8, Stroke as b, StrokePaint as c, Inker as d, GroundRef as e, SubstrateName as f, PyramidChartProps as g, TreemapChartProps as h, SankeyChartProps as i, ActivityGridProps as j, StepChartProps as k, SparklineRowsProps as l, BarChartProps as m, StackedBarChartProps as n, ComposedChartProps as o, DonutChartProps as p, RadarChartProps as q, PolarBarChartProps as r, CoxcombChartProps as s, RadialArcGroupProps as t, RadialRingsProps as u, GaugeArcProps as v, WindRoseProps as w, ChordRingProps as x, CandlestickChartProps as y, AreaChartProps as z };
+export { type ComposedChartProps as $, type ActiveItem as A, type BoxPlotChartProps as B, type ConnectedScatterChartProps as C, type DumbbellChartProps as D, type EcdfChartProps as E, type PyramidChartProps as F, type Geometry as G, type HistogramChartProps as H, type IntervalChartProps as I, type HeatmapChartProps as J, type TreemapChartProps as K, type LollipopChartProps as L, type MarimekkoChartProps as M, type NetworkChartProps as N, type SankeyChartProps as O, type ParallelCoordinatesChartProps as P, type ActivityGridProps as Q, type RidgelineChartProps as R, type SlopeChartProps as S, type TreeChartProps as T, type StepChartProps as U, type ViolinChartProps as V, type WaffleChartProps as W, type SparklineRowsProps as X, type KpiCardProps as Y, type BarChartProps as Z, type StackedBarChartProps as _, type BeeswarmChartProps as a, type WaterfallChartProps as a0, type FunnelChartProps as a1, type DonutChartProps as a2, type RadarChartProps as a3, type PolarBarChartProps as a4, type CoxcombChartProps as a5, type RadialArcGroupProps as a6, type RadialRingsProps as a7, type GaugeArcProps as a8, type MeterChartProps as a9, type ToneSpec as aA, type UiTokens as aB, type WeightToneSpec as aC, PALETTE_PROPERTIES as aD, nestProvider as aE, paletteStyle as aF, resolvePalette as aG, type WindRoseProps as aa, type ChordRingProps as ab, type OrbitChartProps as ac, type VolvelleChartProps as ad, type CandlestickChartProps as ae, type AreaChartProps as af, type RangeBandChartProps as ag, type StreamChartProps as ah, type ScatterChartProps as ai, type BubbleChartProps as aj, type Accessor as ak, type ChartOrientation as al, type Ground as am, type GroundName as an, type HatchToneSpec as ao, type HitArea as ap, type InkOptions as aq, type LabelKind as ar, type LineCurve as as, type NetworkNode as at, type Palette as au, type StrokePart as av, type StrokeRole as aw, type Tile as ax, type TonalRamp as ay, type ToneLevel as az, type BumpChartProps as b, type ErrorBarChartProps as c, type DivergingBarChartProps as d, type SquarifiedTreemapProps as e, type SunburstChartProps as f, type PolarLineChartProps as g, type PolarScatterChartProps as h, type DensityBinChartProps as i, type ContourChartProps as j, type DelaunayChartProps as k, type VectorFieldChartProps as l, type CommonChartProps as m, type Seed as n, type Stroke as o, type StrokePaint as p, type InkMode as q, type TextLabel as r, type Inker as s, type GroundRef as t, type SubstrateName as u, type ProviderConfig as v, type LineChartProps as w, type Datum as x, type Rect as y, type BulletChartProps as z };