@besaitech/ng-design-system 0.0.67 → 0.0.68

package/charts/index.d.ts

@@ -0,0 +1,1257 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as d3_scale from 'd3-scale';
+import * as _besaitech_ng_design_system from '@besaitech/ng-design-system';
+
+/** A value the x / category axis can carry. ISO date strings (`2026-03-01`) are read as dates. */
+type SdsXValue = string | number | Date;
+/**
+ * How a chart reads a field from a row: either the property name, or a function. The function form
+ * covers derived values (`row => row.cost / row.units`) and nested data (`row => row.stats.total`).
+ */
+type SdsAccessor<T, R> = (keyof T & string) | ((row: T, index: number) => R);
+/** A number format: `Intl.NumberFormatOptions` (locale-aware, the default) or your own function. */
+type SdsNumberFormat = Intl.NumberFormatOptions | ((value: number) => string);
+/**
+ * An x-axis format. Options objects are interpreted from the axis kind: `Intl.DateTimeFormatOptions`
+ * on a time axis, `Intl.NumberFormatOptions` on a numeric one. Category axes print the value as-is
+ * unless a function is given.
+ */
+type SdsXFormat = Intl.DateTimeFormatOptions | Intl.NumberFormatOptions | ((value: SdsXValue) => string);
+/** What the x axis is. `auto` infers it from the data: Date / ISO string → time, number → linear. */
+type SdsChartXType = 'auto' | 'time' | 'linear' | 'category';
+/** Value-axis scale. `log` needs strictly positive values (non-positive points are dropped). */
+type SdsChartScale = 'linear' | 'log';
+/**
+ * Where the legend sits. `auto` picks the chart's natural place (top for two or more series, none for
+ * one; right for a donut). `right` falls back to below on narrow containers.
+ */
+type SdsChartLegend = 'auto' | 'top' | 'bottom' | 'right' | 'none';
+/** Which gridlines to draw. They are always solid hairlines, never dashed. */
+type SdsChartGrid = 'y' | 'x' | 'both' | 'none';
+/** Stacking: `stacked` piles the series, `percent` normalises every stack to 100 %. */
+type SdsChartStack = 'none' | 'stacked' | 'percent';
+/** Semantic tone for annotations and single-colour charts. */
+type SdsChartTone = 'neutral' | 'brand' | 'success' | 'warning' | 'danger';
+/** One plotted measure. `key` is both the row property it reads and the series' identity. */
+interface SdsChartSeries<T = any> {
+    /** Row property holding the value — and the stable id used for colour, legend and toggling. */
+    key: string;
+    /** Human label (legend, tooltip, table header). Defaults to `key`. */
+    label?: string;
+    /** Read the value with a function instead of `row[key]` (derived or nested values). */
+    value?: (row: T, index: number) => number | null | undefined;
+    /** Any CSS colour, including `var(--token)`. Defaults to the categorical slot of its index. */
+    color?: string;
+    /** Per-series value format (tooltip, labels, table). Falls back to the chart's `valueFormat`. */
+    format?: SdsNumberFormat;
+    /** Line charts: draw dashed — a forecast, a target or a projection. */
+    dashed?: boolean;
+    /** Bar charts: draw this series as a line over the bars (a combo chart, on the SAME axis). */
+    type?: 'bar' | 'line';
+}
+/** A horizontal/vertical reference line — a target, a threshold, a mean. */
+interface SdsChartReferenceLine {
+    type: 'line';
+    /** `y` (default) draws across the plot at a value; `x` draws down it at an x position. */
+    axis?: 'x' | 'y';
+    value: SdsXValue;
+    label?: string;
+    tone?: SdsChartTone;
+}
+/** A shaded range — a normal range, a target zone, a holiday period. */
+interface SdsChartReferenceBand {
+    type: 'band';
+    axis?: 'x' | 'y';
+    from: SdsXValue;
+    to: SdsXValue;
+    label?: string;
+    tone?: SdsChartTone;
+}
+type SdsChartAnnotation = SdsChartReferenceLine | SdsChartReferenceBand;
+/** One line of the tooltip. `value` is already formatted; `raw` is the number behind it. */
+interface SdsChartTooltipRow {
+    key: string;
+    label: string;
+    value: string;
+    raw: number | null;
+    color: string;
+    /** Shape of the key glyph: a short line for lines, a square for bars/areas/slices, a dot for points. */
+    shape: 'line' | 'rect' | 'dot';
+}
+/** Context handed to a custom `<ng-template sdsChartTooltip let-tip>` template. */
+interface SdsChartTooltipContext<T = any> {
+    /** Formatted heading (the x value, the category, the slice…). */
+    title: string;
+    rows: SdsChartTooltipRow[];
+    /** Optional footer line (a total, a share…). */
+    footer?: string;
+    /** The source row(s) behind the hovered position. */
+    data: T[];
+    index: number;
+}
+/** Emitted when a mark is clicked (or activated with Enter on the keyboard). */
+interface SdsChartPointEvent<T = any> {
+    /** Series key — or the slice / cell / node id on charts without series. */
+    key: string;
+    /** The source row (null when the mark aggregates several rows, e.g. the "Other" slice). */
+    row: T | null;
+    index: number;
+    value: number | null;
+    x?: SdsXValue;
+    /** The row dimension (heatmap). */
+    y?: SdsXValue;
+}
+
+/**
+ * Replace a chart's default tooltip body with your own markup. The template receives the hovered
+ * position as `$implicit` ({ title, rows, footer, data, index }) — `data` holds the source rows, so the
+ * tooltip can show fields the chart does not plot (a comment, a status, a unit).
+ *
+ * Works on line, bar, scatter, donut, heatmap and treemap charts (not the sparkline). The chart still
+ * positions, flips and clamps the box; you style the body. The box is visual and pointer-transparent:
+ * never put links or buttons in it, and keep anything essential in the plotted data too — keyboard and
+ * screen-reader users get the default rows through the live region and the table twin.
+ *
+ * @example
+ * <sds-line-chart [data]="rows" x="day" [series]="series">
+ *   <ng-template sdsChartTooltip let-tip>
+ *     <p class="font-semibold">{{ tip.title }}</p>
+ *     <p>{{ tip.data[0].comment }}</p>
+ *   </ng-template>
+ * </sds-line-chart>
+ */
+declare class SdsChartTooltip {
+    readonly template: TemplateRef<{
+        $implicit: SdsChartTooltipContext;
+    }>;
+    static ngTemplateContextGuard(_dir: SdsChartTooltip, ctx: unknown): ctx is {
+        $implicit: SdsChartTooltipContext;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsChartTooltip, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SdsChartTooltip, "ng-template[sdsChartTooltip]", never, {}, {}, never, never, true, never>;
+}
+
+interface PlotRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+interface AxisTick {
+    pos: number;
+    label: string;
+}
+interface ResolvedAnnotation {
+    kind: 'line' | 'band';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    label: string;
+    color: string;
+    labelX: number;
+    labelY: number;
+    anchor: 'start' | 'middle' | 'end';
+}
+
+interface LegendItem {
+    key: string;
+    label: string;
+    color: string;
+    shape: 'line' | 'rect' | 'dot';
+    /** Optional trailing text — a value or a share (the donut's direct labels). */
+    detail?: string;
+    dashed?: boolean;
+}
+interface ChartTable {
+    columns: string[];
+    rows: string[][];
+}
+
+/** Line interpolation. `monotone` (default) is smooth but never overshoots the data. */
+type SdsLineCurve = 'linear' | 'monotone' | 'step' | 'natural';
+/** Point markers: `auto` = every point on sparse plain lines (≤ 16), only the last on dense lines and plain areas, none on stacks. */
+type SdsLineMarkers = 'auto' | 'all' | 'last' | 'none';
+interface Point<T> {
+    row: T;
+    index: number;
+    x: SdsXValue;
+    key: string;
+}
+/** [x, y, y0] in pixels; undefined where the value is missing (the line breaks there). */
+type P3 = readonly number[];
+/**
+ * Line and area chart for anything over an ordered axis — time series, numeric x, or categories.
+ * Multi-series, stacked or 100 % areas, smooth / step curves, log scale, reference lines and bands,
+ * dashed forecast series, a crosshair tooltip listing every series, legend toggling, keyboard
+ * navigation and a data-table twin. Rows are read with accessors, so API data plots as-is.
+ *
+ * @example
+ * <sds-line-chart
+ *   heading="Admissions"
+ *   [data]="rows"
+ *   x="date"
+ *   [series]="[{ key: 'urgences', label: 'Urgences' }, { key: 'programmees', label: 'Programmées' }]"
+ * />
+ */
+declare class SdsLineChart<T = any> {
+    /** The rows to plot — any shape; fields are read through `x` and each series' `key` / `value`. */
+    readonly data: _angular_core.InputSignal<readonly T[] | null | undefined>;
+    /** The x field: a property name or `(row, i) => value`. Dates, ISO strings, numbers or labels. */
+    readonly x: _angular_core.InputSignal<SdsAccessor<T, SdsXValue>>;
+    /** The measures to draw. A series keeps its colour slot (its index here) even when hidden. */
+    readonly series: _angular_core.InputSignal<readonly SdsChartSeries<T>[]>;
+    /** Force the x-axis kind instead of inferring it from the data. */
+    readonly xType: _angular_core.InputSignal<SdsChartXType>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    /** Plot height in px, axis labels included (the chart never scrolls inside itself). */
+    readonly height: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly curve: _angular_core.InputSignal<SdsLineCurve>;
+    /** Fill under each line with a soft wash of its colour. */
+    readonly area: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Stack the series as areas (`stacked`) or as shares of 100 % (`percent`). */
+    readonly stack: _angular_core.InputSignal<SdsChartStack>;
+    readonly markers: _angular_core.InputSignal<SdsLineMarkers>;
+    /** Label each line at its last point; converging labels spread apart with leader lines (dropped if they cannot fit). */
+    readonly endLabels: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly grid: _angular_core.InputSignal<SdsChartGrid>;
+    readonly legend: _angular_core.InputSignal<SdsChartLegend>;
+    /** Emphasise one series: the others fade back. */
+    readonly highlight: _angular_core.InputSignal<string | null>;
+    readonly annotations: _angular_core.InputSignal<readonly SdsChartAnnotation[]>;
+    readonly yScale: _angular_core.InputSignal<SdsChartScale>;
+    readonly yMin: _angular_core.InputSignal<number | null>;
+    readonly yMax: _angular_core.InputSignal<number | null>;
+    /** Start the value axis at zero. Defaults to true for areas/stacks, false for plain lines. */
+    readonly includeZero: _angular_core.InputSignal<boolean | null>;
+    /** Format of values in the tooltip, labels and table. Axis ticks derive a compact version. */
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** Override the value-axis tick format. */
+    readonly axisFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** Format of x values (ticks + tooltip heading). Time axes pick a sensible multi-scale default. */
+    readonly xFormat: _angular_core.InputSignal<SdsXFormat | null>;
+    readonly xLabel: _angular_core.InputSignal<string>;
+    readonly yLabel: _angular_core.InputSignal<string>;
+    /** BCP-47 locale for numbers and dates. Defaults to provideSdsCharts() / LOCALE_ID. */
+    readonly locale: _angular_core.InputSignal<string | null>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Hold the current render at reduced opacity while new data loads (no skeleton flash). */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Empty-state text. Default (`null`): the configured `labels.empty` ("No data to display"). */
+    readonly emptyText: _angular_core.InputSignal<string | null>;
+    /** Show a button that swaps the plot for its data table. */
+    readonly tableToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Keys of the series currently hidden (legend toggles write it back — two-way bindable). */
+    readonly hidden: _angular_core.ModelSignal<readonly string[]>;
+    /** A point was clicked (the series nearest the pointer) or activated with Enter. */
+    readonly pointClick: _angular_core.OutputEmitterRef<SdsChartPointEvent<T>>;
+    protected readonly customTooltip: _angular_core.Signal<SdsChartTooltip | undefined>;
+    protected readonly uid: string;
+    protected readonly legendFocus: _angular_core.WritableSignal<string | null>;
+    protected readonly active: _angular_core.WritableSignal<number | null>;
+    protected readonly keyboard: _angular_core.WritableSignal<boolean>;
+    /** Leaving the chart dismisses a keyboard-driven readout (a pointer one clears on pointerleave). */
+    protected onBlur(): void;
+    private readonly pointerY;
+    private readonly width;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    protected readonly text: _angular_core.Signal<_besaitech_ng_design_system.SdsChartLabels>;
+    private readonly animates;
+    private readonly palette;
+    protected readonly stacked: _angular_core.Signal<boolean>;
+    private readonly model;
+    private readonly allSeries;
+    private readonly visible;
+    /** Raw values per series, aligned with the sorted points (null = missing → a gap). */
+    private readonly values;
+    /** [y0, y1] per series and point — stacked offsets, or a baseline of 0 for plain lines. */
+    private readonly bands;
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    /** Axis formatter at a given precision (uniqueLabels raises it until ticks stop repeating). */
+    private readonly axisMaker;
+    private readonly fmtX;
+    protected readonly layout: _angular_core.Signal<{
+        width: number;
+        height: number;
+        plot: PlotRect;
+        y: d3_scale.ScaleLinear<number, number, never>;
+        xPos: (p: Point<T>) => number;
+        mapX: (v: SdsXValue) => number | null;
+        xTicks: AxisTick[];
+        yTicks: AxisTick[];
+        baseline: number;
+        baseY: number;
+    } | null>;
+    private timeTicks;
+    private readonly target;
+    /** Boolean, so a resize (width A → B) never counts as a data change: resizes snap, data animates. */
+    private readonly ready;
+    private readonly version;
+    private readonly geometry;
+    protected readonly drawn: _angular_core.Signal<{
+        key: string;
+        color: string;
+        dashed: boolean;
+        dim: boolean;
+        line: string;
+        area: string | null;
+        markers: P3[];
+    }[]>;
+    protected readonly annotationsPx: _angular_core.Signal<ResolvedAnnotation[]>;
+    /**
+     * End labels. Where lines converge the labels are spread apart (never stacked on each other) and a
+     * hairline leader ties each displaced label back to its line end. If they cannot all fit in the plot
+     * height the set is dropped — the legend then carries identity.
+     */
+    protected readonly endLabelsPx: _angular_core.Signal<{
+        tx: number;
+        leader: boolean;
+        key: string;
+        label: string;
+        x: number;
+        anchorY: number;
+        y: number;
+        dim: boolean;
+    }[]>;
+    protected readonly activePx: _angular_core.Signal<{
+        x: number;
+        dots: {
+            key: string;
+            y: number;
+            color: string;
+        }[];
+    } | null>;
+    protected readonly tooltipY: _angular_core.Signal<number>;
+    protected readonly tooltipCtx: _angular_core.Signal<SdsChartTooltipContext<T> | null>;
+    protected readonly liveText: _angular_core.Signal<string>;
+    protected onPointer(event: PointerEvent): void;
+    private nearestIndex;
+    protected onClick(): void;
+    protected onKey(event: KeyboardEvent): void;
+    protected toggleSeries(key: string): void;
+    protected readonly legendPosition: _angular_core.Signal<"top" | "bottom" | "right" | "none">;
+    protected readonly legendItems: _angular_core.Signal<LegendItem[]>;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly table: _angular_core.Signal<ChartTable>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsLineChart<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsLineChart<any>, "sds-line-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "x": { "alias": "x"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "xType": { "alias": "xType"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "area": { "alias": "area"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "markers": { "alias": "markers"; "required": false; "isSignal": true; }; "endLabels": { "alias": "endLabels"; "required": false; "isSignal": true; }; "grid": { "alias": "grid"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "highlight": { "alias": "highlight"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; "yScale": { "alias": "yScale"; "required": false; "isSignal": true; }; "yMin": { "alias": "yMin"; "required": false; "isSignal": true; }; "yMax": { "alias": "yMax"; "required": false; "isSignal": true; }; "includeZero": { "alias": "includeZero"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "axisFormat": { "alias": "axisFormat"; "required": false; "isSignal": true; }; "xFormat": { "alias": "xFormat"; "required": false; "isSignal": true; }; "xLabel": { "alias": "xLabel"; "required": false; "isSignal": true; }; "yLabel": { "alias": "yLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "tableToggle": { "alias": "tableToggle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "pointClick": "pointClick"; }, ["customTooltip"], never, true, never>;
+}
+
+/** `vertical` = columns rising from the category axis; `horizontal` = bars (best for long labels / rankings). */
+type SdsBarOrientation = 'vertical' | 'horizontal';
+/** Order the categories by their total. `none` keeps the data order. */
+type SdsBarSort = 'none' | 'asc' | 'desc';
+/**
+ * Bar and column chart for comparing categories: grouped, stacked or 100 % stacked, vertical or
+ * horizontal, with negative values, value labels that are only drawn where they fit, sorting,
+ * per-bar colours, a combo `type: 'line'` series on the same axis, reference lines (targets) and a
+ * per-category tooltip listing every series. Bars are capped in thickness, rounded on their data end
+ * only, and separated by a 2 px surface gap — never outlined.
+ *
+ * @example
+ * <sds-bar-chart
+ *   heading="Séjours par service"
+ *   [data]="rows"
+ *   x="mois"
+ *   [series]="[{ key: 'cardio', label: 'Cardiologie' }, { key: 'neuro', label: 'Neurologie' }]"
+ *   stack="stacked"
+ * />
+ */
+declare class SdsBarChart<T = any> {
+    readonly data: _angular_core.InputSignal<readonly T[] | null | undefined>;
+    /** The category field: a property name or `(row, i) => value`. */
+    readonly x: _angular_core.InputSignal<SdsAccessor<T, SdsXValue>>;
+    /** The measures. A `type: 'line'` series is drawn as a line over the bars (vertical only). */
+    readonly series: _angular_core.InputSignal<readonly SdsChartSeries<T>[]>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly orientation: _angular_core.InputSignal<SdsBarOrientation>;
+    readonly stack: _angular_core.InputSignal<SdsChartStack>;
+    /** Height in px, axes included. Defaults to 300 (vertical) or one row per category (horizontal). */
+    readonly height: _angular_core.InputSignalWithTransform<number | null, unknown>;
+    /** Maximum bar thickness in px — bars never fill their slot; the leftover is air. */
+    readonly maxBarSize: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Corner radius of the bar's data end (its baseline end stays square). */
+    readonly radius: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Print each bar's value at its tip (each stack's total when stacked) — only where it fits. */
+    readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly sort: _angular_core.InputSignal<SdsBarSort>;
+    /** Emphasise some categories (their x values): the other bars fade back. (Series emphasis: hover the legend.) */
+    readonly highlightCategories: _angular_core.InputSignal<SdsXValue | readonly SdsXValue[] | null>;
+    /** Colour one bar from its data — e.g. negatives in red, or a status. Return null to keep the series colour. */
+    readonly barColor: _angular_core.InputSignal<((row: T, seriesKey: string, value: number) => string | null | undefined) | null>;
+    readonly grid: _angular_core.InputSignal<SdsChartGrid | null>;
+    readonly legend: _angular_core.InputSignal<SdsChartLegend>;
+    /** Reference lines / bands. `axis: 'y'` (default) is the VALUE axis in both orientations. */
+    readonly annotations: _angular_core.InputSignal<readonly SdsChartAnnotation[]>;
+    readonly yMin: _angular_core.InputSignal<number | null>;
+    readonly yMax: _angular_core.InputSignal<number | null>;
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    readonly axisFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** Format of the category labels (dates are formatted at their granularity by default). */
+    readonly xFormat: _angular_core.InputSignal<SdsXFormat | null>;
+    readonly xLabel: _angular_core.InputSignal<string>;
+    readonly yLabel: _angular_core.InputSignal<string>;
+    readonly locale: _angular_core.InputSignal<string | null>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Empty-state text. Default (`null`): the configured `labels.empty` ("No data to display"). */
+    readonly emptyText: _angular_core.InputSignal<string | null>;
+    readonly tableToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    readonly hidden: _angular_core.ModelSignal<readonly string[]>;
+    /** A bar (or a category, from the keyboard) was clicked. */
+    readonly pointClick: _angular_core.OutputEmitterRef<SdsChartPointEvent<T>>;
+    protected readonly customTooltip: _angular_core.Signal<SdsChartTooltip | undefined>;
+    protected readonly legendFocus: _angular_core.WritableSignal<string | null>;
+    protected readonly active: _angular_core.WritableSignal<number | null>;
+    protected readonly keyboard: _angular_core.WritableSignal<boolean>;
+    /** Leaving the chart dismisses a keyboard-driven readout (a pointer one clears on pointerleave). */
+    protected onBlur(): void;
+    private readonly pointer;
+    private readonly width;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    protected readonly text: _angular_core.Signal<_besaitech_ng_design_system.SdsChartLabels>;
+    private readonly animates;
+    private readonly palette;
+    private readonly horizontal;
+    private readonly stacked;
+    private readonly allSeries;
+    private readonly visible;
+    private readonly barSeries;
+    private readonly lineSeries;
+    private readonly raw;
+    private readonly rawValues;
+    /** Categories in display order (sorted by total of the visible bar series when asked). */
+    private readonly order;
+    /** [v0, v1] per bar series per category (value space). */
+    private readonly extents;
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    private readonly axisMaker;
+    private readonly fmtCat;
+    /** Bars-per-group (1 when stacked) — drives row height for auto-sized horizontal charts. */
+    private readonly groupCount;
+    protected readonly resolvedHeight: _angular_core.Signal<number>;
+    protected readonly layout: _angular_core.Signal<{
+        readonly width: number;
+        readonly height: number;
+        readonly horizontal: boolean;
+        readonly plot: PlotRect;
+        readonly value: d3_scale.ScaleLinear<number, number, never>;
+        readonly band: d3_scale.ScaleBand<number>;
+        readonly bw: number;
+        readonly barSize: number;
+        readonly groupSize: number;
+        readonly base: number;
+        readonly grid: SdsChartGrid;
+        readonly xTicks: AxisTick[];
+        readonly yTicks: AxisTick[];
+    } | null>;
+    /** Formatted values that may be printed as labels (for margin sizing). */
+    private readonly labelTexts;
+    /** Target pixel geometry per bar / line point, plus the non-animated facts about each bar. */
+    private readonly targetModel;
+    private readonly target;
+    private readonly meta;
+    /** Boolean, so a resize (width A → B) never counts as a data change: resizes snap, data animates. */
+    private readonly ready;
+    private readonly version;
+    private readonly geometry;
+    private readonly highlightSet;
+    protected readonly bars: _angular_core.Signal<{
+        id: string;
+        d: string;
+        color: string;
+        dim: boolean;
+    }[]>;
+    protected readonly lines: _angular_core.Signal<{
+        key: string;
+        color: string;
+        dashed: boolean;
+        dim: boolean;
+        d: string;
+        points: (readonly number[])[];
+    }[]>;
+    /** Value labels at the bar tips — dropped wherever they would not fit or would collide. */
+    protected readonly valueLabels: _angular_core.Signal<{
+        id: string;
+        x: number;
+        y: number;
+        text: string;
+        anchor: "start" | "middle" | "end";
+    }[]>;
+    protected readonly annotationsPx: _angular_core.Signal<ResolvedAnnotation[]>;
+    /** One hit target per category — the whole band step, bigger than any bar in it. */
+    protected readonly hits: _angular_core.Signal<{
+        index: number;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[]>;
+    protected readonly hoverBand: _angular_core.Signal<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | null>;
+    protected readonly tooltipAt: _angular_core.Signal<{
+        x: number;
+        y: number;
+    }>;
+    protected readonly tooltipCtx: _angular_core.Signal<SdsChartTooltipContext<T> | null>;
+    protected readonly liveText: _angular_core.Signal<string>;
+    private local;
+    protected enter(index: number, event: PointerEvent): void;
+    protected move(event: PointerEvent): void;
+    protected onClick(index: number, event?: MouseEvent): void;
+    protected onKey(event: KeyboardEvent): void;
+    protected toggleSeries(key: string): void;
+    protected readonly legendPosition: _angular_core.Signal<"top" | "bottom" | "right" | "none">;
+    protected readonly legendItems: _angular_core.Signal<LegendItem[]>;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly table: _angular_core.Signal<ChartTable>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsBarChart<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsBarChart<any>, "sds-bar-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "x": { "alias": "x"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "maxBarSize": { "alias": "maxBarSize"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; "highlightCategories": { "alias": "highlightCategories"; "required": false; "isSignal": true; }; "barColor": { "alias": "barColor"; "required": false; "isSignal": true; }; "grid": { "alias": "grid"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; "yMin": { "alias": "yMin"; "required": false; "isSignal": true; }; "yMax": { "alias": "yMax"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "axisFormat": { "alias": "axisFormat"; "required": false; "isSignal": true; }; "xFormat": { "alias": "xFormat"; "required": false; "isSignal": true; }; "xLabel": { "alias": "xLabel"; "required": false; "isSignal": true; }; "yLabel": { "alias": "yLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "tableToggle": { "alias": "tableToggle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "pointClick": "pointClick"; }, ["customTooltip"], never, true, never>;
+}
+
+interface Dot<T> {
+    row: T;
+    index: number;
+    id: string;
+    x: number;
+    xDate: boolean;
+    y: number;
+    size: number | null;
+    group: string;
+    label: string;
+}
+/**
+ * Scatter and bubble chart for relationships between two measures — with an optional third measure
+ * as bubble area and a categorical group as colour. Linear / log / time axes, per-group least-squares
+ * trend lines, reference lines and bands on either axis, nearest-point hover (a Delaunay search, so
+ * the pointer only has to be closest — never dead-centre on an 8 px dot), keyboard stepping and a
+ * data-table twin. Keep groups to three or fewer: past that, colours stop separating in a cloud.
+ *
+ * @example
+ * <sds-scatter-chart
+ *   [data]="patients"
+ *   x="age"
+ *   y="duree"
+ *   group="service"
+ *   size="cout"
+ *   xLabel="Âge"
+ *   yLabel="Durée de séjour (j)"
+ *   trendline
+ * />
+ */
+declare class SdsScatterChart<T = any> {
+    readonly data: _angular_core.InputSignal<readonly T[] | null | undefined>;
+    /** Horizontal measure: numbers, Dates or ISO strings. */
+    readonly x: _angular_core.InputSignal<SdsAccessor<T, SdsXValue>>;
+    /** Vertical measure. */
+    readonly y: _angular_core.InputSignal<SdsAccessor<T, number | null | undefined>>;
+    /** Optional third measure, encoded as bubble AREA (not radius — area reads true). */
+    readonly size: _angular_core.InputSignal<SdsAccessor<T, number | null | undefined> | null>;
+    /** Optional categorical field coloured by slot. Three groups or fewer read best. */
+    readonly group: _angular_core.InputSignal<SdsAccessor<T, string | null | undefined> | null>;
+    /** Optional point name for the tooltip heading and the table (also the point's animation identity). */
+    readonly pointLabel: _angular_core.InputSignal<SdsAccessor<T, string | null | undefined> | null>;
+    /** Fix the group order (and so their colours) instead of first-appearance order. */
+    readonly groupOrder: _angular_core.InputSignal<readonly string[] | null>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly height: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Dot radius when there is no `size` measure. */
+    readonly radius: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Largest bubble radius when `size` is set. */
+    readonly maxRadius: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Draw a least-squares trend line per group (dashed — it is a model, not data). Linear axes only. */
+    readonly trendline: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly grid: _angular_core.InputSignal<SdsChartGrid>;
+    readonly legend: _angular_core.InputSignal<SdsChartLegend>;
+    readonly annotations: _angular_core.InputSignal<readonly SdsChartAnnotation[]>;
+    readonly xScale: _angular_core.InputSignal<SdsChartScale>;
+    readonly yScale: _angular_core.InputSignal<SdsChartScale>;
+    readonly xMin: _angular_core.InputSignal<number | null>;
+    readonly xMax: _angular_core.InputSignal<number | null>;
+    readonly yMin: _angular_core.InputSignal<number | null>;
+    readonly yMax: _angular_core.InputSignal<number | null>;
+    readonly includeZero: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly xFormat: _angular_core.InputSignal<SdsXFormat | null>;
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** Override the y-axis tick format (defaults to a compact form of `valueFormat`). */
+    readonly axisFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    readonly sizeFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    readonly xLabel: _angular_core.InputSignal<string>;
+    readonly yLabel: _angular_core.InputSignal<string>;
+    /** Name of the bubble size (tooltip, table). Default (`null`): the configured `labels.size`. */
+    readonly sizeLabel: _angular_core.InputSignal<string | null>;
+    protected readonly sizeName: _angular_core.Signal<string>;
+    readonly locale: _angular_core.InputSignal<string | null>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Empty-state text. Default (`null`): the configured `labels.empty` ("No data to display"). */
+    readonly emptyText: _angular_core.InputSignal<string | null>;
+    readonly tableToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Hidden group names (two-way bindable; the legend toggles them). */
+    readonly hidden: _angular_core.ModelSignal<readonly string[]>;
+    readonly pointClick: _angular_core.OutputEmitterRef<SdsChartPointEvent<T>>;
+    protected readonly customTooltip: _angular_core.Signal<SdsChartTooltip | undefined>;
+    protected readonly uid: string;
+    protected readonly legendFocus: _angular_core.WritableSignal<string | null>;
+    protected readonly active: _angular_core.WritableSignal<number | null>;
+    protected readonly keyboard: _angular_core.WritableSignal<boolean>;
+    /** Leaving the chart dismisses a keyboard-driven readout (a pointer one clears on pointerleave). */
+    protected onBlur(): void;
+    private readonly width;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    protected readonly text: _angular_core.Signal<_besaitech_ng_design_system.SdsChartLabels>;
+    private readonly animates;
+    private readonly palette;
+    protected readonly bubbles: _angular_core.Signal<boolean>;
+    private readonly points;
+    private readonly xIsTime;
+    /** Groups in colour order; a group keeps its slot when others are hidden. */
+    protected readonly groups: _angular_core.Signal<{
+        name: string;
+        color: string;
+    }[]>;
+    private readonly colorOf;
+    private readonly visiblePoints;
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    private readonly fmtY;
+    private readonly fmtSize;
+    private readonly fmtX;
+    protected readonly layout: _angular_core.Signal<{
+        width: number;
+        height: number;
+        plot: PlotRect;
+        x: (v: number) => number;
+        y: (v: number) => number;
+        radius: (p: Dot<T>) => number;
+        xTicks: AxisTick[];
+        yTicks: {
+            pos: number;
+            label: string;
+        }[];
+        clipPad: number;
+    } | null>;
+    private readonly target;
+    /** Boolean, so a resize (width A → B) never counts as a data change: resizes snap, data animates. */
+    private readonly ready;
+    private readonly version;
+    private readonly geometry;
+    protected readonly dots: _angular_core.Signal<{
+        id: string;
+        cx: number;
+        cy: number;
+        r: number;
+        color: string;
+        dim: boolean;
+        size: number;
+    }[]>;
+    /** Least-squares fit per visible group, drawn across that group's own x range. */
+    protected readonly trends: _angular_core.Signal<{
+        group: string;
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+        color: string;
+        dim: boolean;
+    }[]>;
+    protected readonly annotationsPx: _angular_core.Signal<ResolvedAnnotation[]>;
+    /** Nearest-point index, rebuilt only when the geometry settles. */
+    private readonly delaunay;
+    protected readonly activeDot: _angular_core.Signal<{
+        cx: number;
+        cy: number;
+        r: number;
+        color: string;
+    } | null>;
+    protected readonly tooltipCtx: _angular_core.Signal<SdsChartTooltipContext<T> | null>;
+    protected readonly liveText: _angular_core.Signal<string>;
+    protected onPointer(event: PointerEvent): void;
+    protected onClick(): void;
+    /** Arrow keys step through the points in x order. */
+    protected onKey(event: KeyboardEvent): void;
+    protected toggleGroup(name: string): void;
+    protected readonly legendPosition: _angular_core.Signal<"top" | "bottom" | "right" | "none">;
+    protected readonly legendItems: _angular_core.Signal<LegendItem[]>;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly table: _angular_core.Signal<ChartTable>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsScatterChart<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsScatterChart<any>, "sds-scatter-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "x": { "alias": "x"; "required": true; "isSignal": true; }; "y": { "alias": "y"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "pointLabel": { "alias": "pointLabel"; "required": false; "isSignal": true; }; "groupOrder": { "alias": "groupOrder"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "maxRadius": { "alias": "maxRadius"; "required": false; "isSignal": true; }; "trendline": { "alias": "trendline"; "required": false; "isSignal": true; }; "grid": { "alias": "grid"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; "xScale": { "alias": "xScale"; "required": false; "isSignal": true; }; "yScale": { "alias": "yScale"; "required": false; "isSignal": true; }; "xMin": { "alias": "xMin"; "required": false; "isSignal": true; }; "xMax": { "alias": "xMax"; "required": false; "isSignal": true; }; "yMin": { "alias": "yMin"; "required": false; "isSignal": true; }; "yMax": { "alias": "yMax"; "required": false; "isSignal": true; }; "includeZero": { "alias": "includeZero"; "required": false; "isSignal": true; }; "xFormat": { "alias": "xFormat"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "axisFormat": { "alias": "axisFormat"; "required": false; "isSignal": true; }; "sizeFormat": { "alias": "sizeFormat"; "required": false; "isSignal": true; }; "xLabel": { "alias": "xLabel"; "required": false; "isSignal": true; }; "yLabel": { "alias": "yLabel"; "required": false; "isSignal": true; }; "sizeLabel": { "alias": "sizeLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "tableToggle": { "alias": "tableToggle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "pointClick": "pointClick"; }, ["customTooltip"], never, true, never>;
+}
+
+/** `donut` has a hole for a headline figure; `pie` is solid. */
+type SdsDonutVariant = 'donut' | 'pie';
+/** What the legend prints after each label (the chart's direct labels). */
+type SdsDonutLegendValue = 'percent' | 'value' | 'both' | 'none';
+/** Slice order: `desc` = largest first, `none` = data order. */
+type SdsDonutSort = 'desc' | 'none';
+/** Key of the folded "Other" slice — in `hidden` and in `pointClick.key`. */
+declare const SDS_DONUT_OTHER_KEY = "__sds_other__";
+/**
+ * Donut, pie and half-donut for part-to-whole at a glance. Small tails fold into "Other" past
+ * `maxSlices` (a pie stops reading beyond ~6 parts), the legend doubles as direct labels with each
+ * share, the centre states the total and swaps to the hovered slice, slices separate with a
+ * constant 2 px gap, and the whole thing is keyboard-navigable with a data-table twin. Colour follows
+ * the category (its position in the data), never its rank.
+ *
+ * @example
+ * <sds-donut-chart heading="Motifs de séjour" [data]="rows" category="motif" value="sejours" />
+ */
+declare class SdsDonutChart<T = any> {
+    readonly data: _angular_core.InputSignal<readonly T[] | null | undefined>;
+    /** The part's name. Rows sharing a name are summed into one slice. */
+    readonly category: _angular_core.InputSignal<SdsAccessor<T, string | null | undefined>>;
+    /** The part's size (negative and missing values are ignored). */
+    readonly value: _angular_core.InputSignal<SdsAccessor<T, number | null | undefined>>;
+    /** Optional per-row colour (any CSS colour) — e.g. a status palette. */
+    readonly color: _angular_core.InputSignal<SdsAccessor<T, string | null | undefined> | null>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly variant: _angular_core.InputSignal<SdsDonutVariant>;
+    /** Draw a half-donut (a gauge-like arc) instead of a full circle. */
+    readonly half: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Diameter cap in px (the chart also shrinks to its container). */
+    readonly height: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Ring thickness in px. Defaults to ~26 % of the radius. */
+    readonly thickness: _angular_core.InputSignalWithTransform<number | null, unknown>;
+    /** Beyond this many slices the smallest fold into one "Other" slice. */
+    readonly maxSlices: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Name of the folded tail slice. Default (`null`): the configured `labels.other` ("Other"). */
+    readonly otherLabel: _angular_core.InputSignal<string | null>;
+    /** `desc` (default) orders slices largest first; `none` keeps the data order. */
+    readonly sort: _angular_core.InputSignal<SdsDonutSort>;
+    /** `auto` = right of the ring (below it on narrow containers). */
+    readonly legend: _angular_core.InputSignal<SdsChartLegend>;
+    readonly legendValue: _angular_core.InputSignal<SdsDonutLegendValue>;
+    /**
+     * Headline in the hole. Default (`null`): the configured `labels.total` ("Total"). An empty string
+     * `''` hides the centre readout entirely (label and figure — what `null` did before 0.0.67), and the
+     * hover tooltip takes over.
+     */
+    readonly centerLabel: _angular_core.InputSignal<string | null>;
+    /** Override the centre figure (e.g. "72 %" for a completion donut). */
+    readonly centerValue: _angular_core.InputSignal<string | null>;
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    readonly locale: _angular_core.InputSignal<string | null>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Empty-state text. Default (`null`): the configured `labels.empty` ("No data to display"). */
+    readonly emptyText: _angular_core.InputSignal<string | null>;
+    readonly tableToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Hidden slice keys (category names, or the "Other" slice). Two-way bindable. */
+    readonly hidden: _angular_core.ModelSignal<readonly string[]>;
+    readonly pointClick: _angular_core.OutputEmitterRef<SdsChartPointEvent<T>>;
+    protected readonly customTooltip: _angular_core.Signal<SdsChartTooltip | undefined>;
+    protected readonly focus: _angular_core.WritableSignal<string | null>;
+    protected readonly active: _angular_core.WritableSignal<string | null>;
+    protected readonly keyboard: _angular_core.WritableSignal<boolean>;
+    /** Leaving the chart dismisses a keyboard-driven readout (a pointer one clears on pointerleave). */
+    protected onBlur(): void;
+    protected readonly pointer: _angular_core.WritableSignal<{
+        x: number;
+        y: number;
+    }>;
+    private readonly width;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    protected readonly text: _angular_core.Signal<_besaitech_ng_design_system.SdsChartLabels>;
+    private readonly animates;
+    private readonly palette;
+    private readonly fmt;
+    private readonly pct;
+    /** Slices after grouping, sorting and folding the tail into "Other". */
+    private readonly slices;
+    private readonly visible;
+    private readonly total;
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    protected readonly size: _angular_core.Signal<number>;
+    protected readonly boxHeight: _angular_core.Signal<number>;
+    protected readonly showCenter: _angular_core.Signal<boolean>;
+    protected readonly showTooltip: _angular_core.Signal<boolean>;
+    protected readonly geo: _angular_core.Signal<{
+        cx: number;
+        cy: number;
+        outer: number;
+        inner: number;
+        start: number;
+        end: number;
+        valueSize: number;
+        labelSize: number;
+        labelY: number;
+        valueY: number;
+        subY: number;
+    } | null>;
+    private readonly target;
+    /** Boolean, so a resize (width A → B) never counts as a data change: resizes snap, data animates. */
+    private readonly ready;
+    private readonly version;
+    private readonly tween;
+    protected readonly arcs: _angular_core.Signal<{
+        key: string;
+        color: string;
+        d: string;
+        shift: string | null;
+        dim: boolean;
+    }[]>;
+    protected readonly center: _angular_core.Signal<{
+        label: string;
+        value: string;
+        sub: string;
+    }>;
+    protected readonly tooltipCtx: _angular_core.Signal<SdsChartTooltipContext<T> | null>;
+    /** Spoken readout — from the full label (the centre one is truncated to fit the hole). */
+    protected readonly liveText: _angular_core.Signal<string>;
+    protected readonly legendPosition: _angular_core.Signal<"top" | "bottom" | "right" | "none">;
+    protected hover(key: string, event: PointerEvent): void;
+    protected track(event: PointerEvent): void;
+    protected emit(key: string): void;
+    protected onKey(event: KeyboardEvent): void;
+    protected toggleSlice(key: string): void;
+    protected readonly legendItems: _angular_core.Signal<LegendItem[]>;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly table: _angular_core.Signal<ChartTable>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsDonutChart<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsDonutChart<any>, "sds-donut-chart", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "category": { "alias": "category"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "half": { "alias": "half"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "required": false; "isSignal": true; }; "maxSlices": { "alias": "maxSlices"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "legendValue": { "alias": "legendValue"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "tableToggle": { "alias": "tableToggle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "pointClick": "pointClick"; }, ["customTooltip"], never, true, never>;
+}
+
+/** `sequential` = magnitude (one hue, pale → strong); `diverging` = polarity around a midpoint. */
+type SdsHeatmapScheme = 'sequential' | 'diverging';
+/**
+ * Heatmap — a matrix of two categorical dimensions coloured by a measure: weekday × hour, service ×
+ * month, product × region. Sequential (one hue, light → dark) or diverging (two opposite hues around
+ * a neutral gray midpoint) colour, mixed by the browser in OKLab from theme tokens so it re-themes and
+ * flips to dark mode on its own. Values print inside cells only where they fit, missing cells read
+ * as empty (not as zero), arrow keys move cell by cell, and a scale legend states the range.
+ *
+ * @example
+ * <sds-heatmap [data]="rows" x="heure" y="jour" value="arrivees" heading="Arrivées aux urgences" />
+ */
+declare class SdsHeatmap<T = any> {
+    readonly data: _angular_core.InputSignal<readonly T[] | null | undefined>;
+    /** Column dimension. */
+    readonly x: _angular_core.InputSignal<SdsAccessor<T, SdsXValue>>;
+    /** Row dimension. */
+    readonly y: _angular_core.InputSignal<SdsAccessor<T, SdsXValue>>;
+    /** The measure colouring each cell. Rows sharing an (x, y) pair are summed. */
+    readonly value: _angular_core.InputSignal<SdsAccessor<T, number | null | undefined>>;
+    /** Fix column order (default: first appearance). */
+    readonly xOrder: _angular_core.InputSignal<readonly SdsXValue[] | null>;
+    /** Fix row order (default: first appearance). */
+    readonly yOrder: _angular_core.InputSignal<readonly SdsXValue[] | null>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly scheme: _angular_core.InputSignal<SdsHeatmapScheme>;
+    /** Fix the colour domain instead of the data extent. */
+    readonly domain: _angular_core.InputSignal<readonly [number, number] | null>;
+    /** The diverging scheme's neutral value. */
+    readonly midpoint: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Height in px. Defaults to `cellHeight` per row. */
+    readonly height: _angular_core.InputSignalWithTransform<number | null, unknown>;
+    readonly cellHeight: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly radius: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Print each value inside its cell — only when every value fits (never a partial matrix). */
+    readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show the colour-scale legend under the matrix. */
+    readonly scaleLegend: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** Format of the column / row labels (a function; dates default to their day). */
+    readonly xFormat: _angular_core.InputSignal<SdsXFormat | null>;
+    /** Name of the measure in the tooltip (e.g. "Arrivals"). Default (`null`): `labels.value`. */
+    readonly valueLabel: _angular_core.InputSignal<string | null>;
+    /** Column-axis title, drawn under the matrix. */
+    readonly xLabel: _angular_core.InputSignal<string>;
+    /** Row-axis title, drawn vertically on the left (and the table's first column header). */
+    readonly yLabel: _angular_core.InputSignal<string>;
+    readonly locale: _angular_core.InputSignal<string | null>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Cross-fade cell colours when the data changes. */
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Empty-state text. Default (`null`): the configured `labels.empty` ("No data to display"). */
+    readonly emptyText: _angular_core.InputSignal<string | null>;
+    readonly tableToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    readonly pointClick: _angular_core.OutputEmitterRef<SdsChartPointEvent<T>>;
+    protected readonly customTooltip: _angular_core.Signal<SdsChartTooltip | undefined>;
+    protected readonly active: _angular_core.WritableSignal<number | null>;
+    protected readonly keyboard: _angular_core.WritableSignal<boolean>;
+    /** Leaving the chart dismisses a keyboard-driven readout (a pointer one clears on pointerleave). */
+    protected onBlur(): void;
+    private readonly width;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    protected readonly text: _angular_core.Signal<_besaitech_ng_design_system.SdsChartLabels>;
+    protected readonly animates: _angular_core.Signal<boolean>;
+    private readonly fmt;
+    private readonly matrix;
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    private readonly fmtX;
+    /** Colour domain; the diverging arms are made symmetric so equal distances read as equal. */
+    protected readonly scale: _angular_core.Signal<{
+        lo: number;
+        hi: number;
+        mid: number;
+        minLabel: string;
+        maxLabel: string;
+        midLabel: string;
+        gradient: string;
+    }>;
+    /** Signed position on the scale: 0…1 sequential, −1…1 diverging. */
+    private position;
+    /**
+     * Where a cell label switches to the strong-end ink — measured, not guessed: the point where the
+     * strong ink starts to out-contrast the pale one, per ramp, in both modes.
+     */
+    private strongEnd;
+    protected readonly resolvedHeight: _angular_core.Signal<number>;
+    protected readonly layout: _angular_core.Signal<{
+        width: number;
+        height: number;
+        plot: {
+            left: number;
+            top: number;
+            width: number;
+            height: number;
+        };
+        bx: d3_scale.ScaleBand<number>;
+        by: d3_scale.ScaleBand<number>;
+        xTicks: AxisTick[];
+        yTicks: {
+            pos: number;
+            label: string;
+        }[];
+    } | null>;
+    protected readonly cells: _angular_core.Signal<{
+        id: string;
+        i: number;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        fill: string;
+        text: string;
+        ink: string;
+        missing: boolean;
+    }[]>;
+    protected readonly activeCell: _angular_core.Signal<{
+        id: string;
+        i: number;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        fill: string;
+        text: string;
+        ink: string;
+        missing: boolean;
+    } | null>;
+    protected readonly tooltipCtx: _angular_core.Signal<SdsChartTooltipContext<T> | null>;
+    protected readonly liveText: _angular_core.Signal<string>;
+    protected hover(i: number, _event: PointerEvent): void;
+    protected emit(i: number): void;
+    /** Arrow keys move one cell in any direction. */
+    protected onKey(event: KeyboardEvent): void;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly table: _angular_core.Signal<ChartTable>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsHeatmap<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsHeatmap<any>, "sds-heatmap", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "x": { "alias": "x"; "required": true; "isSignal": true; }; "y": { "alias": "y"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "xOrder": { "alias": "xOrder"; "required": false; "isSignal": true; }; "yOrder": { "alias": "yOrder"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "scheme": { "alias": "scheme"; "required": false; "isSignal": true; }; "domain": { "alias": "domain"; "required": false; "isSignal": true; }; "midpoint": { "alias": "midpoint"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "cellHeight": { "alias": "cellHeight"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "scaleLegend": { "alias": "scaleLegend"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "xFormat": { "alias": "xFormat"; "required": false; "isSignal": true; }; "valueLabel": { "alias": "valueLabel"; "required": false; "isSignal": true; }; "xLabel": { "alias": "xLabel"; "required": false; "isSignal": true; }; "yLabel": { "alias": "yLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "tableToggle": { "alias": "tableToggle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "pointClick": "pointClick"; }, ["customTooltip"], never, true, never>;
+}
+
+/** A treemap node: a leaf carries `value`; a branch carries `children` (its value is their sum). */
+interface SdsTreemapNode {
+    name: string;
+    value?: number | null;
+    children?: readonly SdsTreemapNode[];
+    /** Override the colour of this node's whole branch (top-level nodes) or of one leaf. */
+    color?: string;
+    /** Label ink for a custom `color` (defaults to white). */
+    ink?: string;
+}
+/**
+ * Treemap for part-to-whole across many items or a hierarchy — budget lines, stock by family, stays
+ * by service and unit. Squarified tiles sized by value, coloured by their top-level branch,
+ * separated by surface gaps (wider between branches), labelled only where the name fits, with a
+ * breadcrumb drill-down: click a branch to zoom into it, the breadcrumb to come back. Leaf clicks
+ * emit `pointClick`.
+ *
+ * @example
+ * <sds-treemap heading="Budget 2026" [data]="[{ name: 'Personnel', children: [{ name: 'Soins', value: 48 }] }]" />
+ */
+declare class SdsTreemap {
+    readonly data: _angular_core.InputSignal<readonly SdsTreemapNode[] | null | undefined>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly height: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** Click a branch to zoom into it (with a breadcrumb back). */
+    readonly drilldown: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Name of the top of the breadcrumb. */
+    /** Default (`null`): the configured `labels.all` ("All"). */
+    readonly rootLabel: _angular_core.InputSignal<string | null>;
+    protected readonly rootName: _angular_core.Signal<string>;
+    /** Print the value under the name inside tiles large enough. */
+    readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** `auto` = the branch legend below the tiles when there are two or more branches. */
+    readonly legend: _angular_core.InputSignal<SdsChartLegend>;
+    readonly locale: _angular_core.InputSignal<string | null>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Empty-state text. Default (`null`): the configured `labels.empty` ("No data to display"). */
+    readonly emptyText: _angular_core.InputSignal<string | null>;
+    readonly tableToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** A leaf tile was clicked (branches zoom instead while `drilldown` is on). `key` is the path "A › B". */
+    readonly pointClick: _angular_core.OutputEmitterRef<SdsChartPointEvent<SdsTreemapNode>>;
+    protected readonly customTooltip: _angular_core.Signal<SdsChartTooltip | undefined>;
+    /** Requested zoom: data indices from the root down to the zoomed branch. */
+    private readonly path;
+    protected readonly active: _angular_core.WritableSignal<string | null>;
+    protected readonly keyboard: _angular_core.WritableSignal<boolean>;
+    private readonly announcement;
+    protected readonly pointer: _angular_core.WritableSignal<{
+        x: number;
+        y: number;
+    }>;
+    protected readonly width: _angular_core.Signal<number>;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    protected readonly text: _angular_core.Signal<_besaitech_ng_design_system.SdsChartLabels>;
+    private readonly animates;
+    private readonly palette;
+    private readonly fmt;
+    private readonly pct;
+    /** Leaving the chart dismisses a keyboard-driven readout (a pointer one clears on pointerleave). */
+    protected onBlur(): void;
+    /** Full hierarchy, summed once. */
+    private readonly root;
+    private build;
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    /**
+     * The zoom that actually applies: the requested path walked against the CURRENT data, stopping at
+     * the first index that no longer names a branch — so new data can never leave a stale zoom behind.
+     */
+    protected readonly zoom: _angular_core.Signal<{
+        node: SdsTreemapNode;
+        indices: number[];
+        names: string[];
+    }>;
+    /** Branch colour + label ink per top-level data index (colour follows the entity, not its size). */
+    private readonly branchStyle;
+    /** The zoomed sub-tree, laid out at the current size. */
+    private readonly layoutRoot;
+    private readonly tiles;
+    private readonly target;
+    private readonly ready;
+    private readonly version;
+    private readonly geometry;
+    protected readonly rects: _angular_core.Signal<{
+        key: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        color: string;
+        ink: string;
+        name: string;
+        value: string;
+    }[]>;
+    protected readonly activeRect: _angular_core.Signal<{
+        key: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        color: string;
+        ink: string;
+        name: string;
+        value: string;
+    } | null>;
+    private readonly activeTile;
+    protected readonly tooltipCtx: _angular_core.Signal<SdsChartTooltipContext<SdsTreemapNode> | null>;
+    protected readonly liveText: _angular_core.Signal<string>;
+    protected hover(key: string, event: PointerEvent): void;
+    protected track(event: PointerEvent): void;
+    /** Zoom to a breadcrumb depth (0 = everything) and say so to screen readers. */
+    protected zoomTo(depth: number): void;
+    private announceZoom;
+    /** Zoom into the tile's branch — or, at the deepest level, report the leaf. */
+    protected activate(key: string): void;
+    protected onKey(event: KeyboardEvent): void;
+    protected readonly legendItems: _angular_core.Signal<LegendItem[]>;
+    protected readonly legendPosition: _angular_core.Signal<"top" | "bottom" | "right" | "none">;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly table: _angular_core.Signal<ChartTable>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsTreemap, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsTreemap, "sds-treemap", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "drilldown": { "alias": "drilldown"; "required": false; "isSignal": true; }; "rootLabel": { "alias": "rootLabel"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "tableToggle": { "alias": "tableToggle"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "pointClick": "pointClick"; }, ["customTooltip"], never, true, never>;
+}
+
+type SdsSparklineVariant = 'line' | 'area' | 'bar';
+/**
+ * A word-sized trend — in a table cell, a KPI tile, a list row. No axes, no legend: the shape is the
+ * message. Line, area or micro-bars; an optional normal range band and reference value; the last
+ * point (and optionally min / max) marked; a tiny hover readout; and an accessible summary (first,
+ * last, min, max) so the trend is never visual-only.
+ *
+ * @example
+ * <sds-sparkline [data]="[12, 14, 13, 18, 21, 19, 24]" label="Admissions sur 7 jours" />
+ */
+declare class SdsSparkline {
+    /** The values in order. `null` leaves a gap. */
+    readonly data: _angular_core.InputSignal<readonly (number | null | undefined)[] | null | undefined>;
+    /** Optional name per point (dates, weeks) for the hover readout. */
+    readonly labels: _angular_core.InputSignal<readonly string[] | null>;
+    readonly variant: _angular_core.InputSignal<SdsSparklineVariant>;
+    /** Width in px; `null` (default) fills the container. */
+    readonly width: _angular_core.InputSignalWithTransform<number | null, unknown>;
+    readonly height: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Any CSS colour. Defaults to the first categorical slot. */
+    readonly color: _angular_core.InputSignal<string | null>;
+    readonly strokeWidth: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Mark the last point. */
+    readonly showLast: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Mark the lowest and highest points. */
+    readonly showMinMax: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Shade a normal range, e.g. [60, 100]. */
+    readonly band: _angular_core.InputSignal<readonly [number, number] | null>;
+    /** Draw a reference value (a target, zero, last year's mean). */
+    readonly reference: _angular_core.InputSignal<number | null>;
+    /** Include zero in the value range (bars always do). */
+    readonly includeZero: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** What the trend measures — prefixes the spoken summary. */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Replace the generated summary ("Trend: from 12 to 24 — min…", `labels.sparklineSummary`) entirely. */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    readonly tooltip: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly locale: _angular_core.InputSignal<string | null>;
+    protected readonly uid: string;
+    protected readonly active: _angular_core.WritableSignal<number | null>;
+    private readonly measured;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    private readonly text;
+    private readonly animates;
+    private readonly fmt;
+    private readonly palette;
+    protected readonly tint: _angular_core.Signal<string>;
+    protected readonly barTint: _angular_core.Signal<string>;
+    private readonly values;
+    protected readonly geo: _angular_core.Signal<{
+        width: number;
+        x: (i: number) => number;
+        y: (v: number) => number;
+        base: number;
+        band: {
+            y: number;
+            h: number;
+        } | null;
+        ref: number | null;
+    } | null>;
+    private readonly target;
+    private readonly ready;
+    private readonly version;
+    private readonly tween;
+    private readonly seq;
+    protected readonly paths: _angular_core.Signal<{
+        line: string;
+        area: string;
+    }>;
+    protected readonly bars: _angular_core.Signal<{
+        d: string;
+        last: boolean;
+    }[]>;
+    protected readonly markers: _angular_core.Signal<{
+        kind: string;
+        x: number;
+        y: number;
+    }[]>;
+    protected readonly activePoint: _angular_core.Signal<{
+        x: number;
+        y: number;
+    } | null>;
+    protected readonly tooltipCtx: _angular_core.Signal<SdsChartTooltipContext<any> | null>;
+    /** "Admissions: from 12 to 24 — min 12, max 24, 7 points" (`labels.sparklineSummary`). */
+    protected readonly summary: _angular_core.Signal<string>;
+    protected onPointer(event: PointerEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsSparkline, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsSparkline, "sds-sparkline", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "showLast": { "alias": "showLast"; "required": false; "isSignal": true; }; "showMinMax": { "alias": "showMinMax"; "required": false; "isSignal": true; }; "band": { "alias": "band"; "required": false; "isSignal": true; }; "reference": { "alias": "reference"; "required": false; "isSignal": true; }; "includeZero": { "alias": "includeZero"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** How the change is expressed: relative (+12,4 %) or in the value's own unit (+38). */
+type SdsKpiDeltaMode = 'percent' | 'absolute';
+type SdsKpiSize = 'md' | 'lg';
+/** `card` draws its own surface; `plain` sits inside a card or grid you already have. */
+type SdsKpiAppearance = 'card' | 'plain';
+/**
+ * A stat tile — the number IS the chart. Label, headline value, a signed change against a named
+ * period whose colour means "good" or "bad" (set `upIsGood` false for waits, costs, incidents), an
+ * arrow glyph and a spoken sentence so the change never relies on colour, and an optional sparkline
+ * of the recent trend. Values auto-compact (12 900 → 12,9 k) unless a format says otherwise.
+ *
+ * @example
+ * <sds-kpi label="Admissions" [value]="1284" [previous]="1150" deltaLabel="vs semaine passée" [trend]="last12Weeks" />
+ */
+declare class SdsKpi {
+    readonly label: _angular_core.InputSignal<string>;
+    readonly value: _angular_core.InputSignal<number | null | undefined>;
+    /** Value format. Default: exact below 10 000, compact above (12,9 k · 4,2 M). */
+    readonly valueFormat: _angular_core.InputSignal<SdsNumberFormat | null>;
+    /** The comparison value — the change is computed from it. */
+    readonly previous: _angular_core.InputSignal<number | null | undefined>;
+    /** Give the change directly instead of `previous` (a ratio in `percent` mode: 0.124 = +12,4 %). */
+    readonly delta: _angular_core.InputSignal<number | null | undefined>;
+    readonly deltaMode: _angular_core.InputSignal<SdsKpiDeltaMode>;
+    /** The named period, e.g. "vs mois dernier". */
+    readonly deltaLabel: _angular_core.InputSignal<string>;
+    /** False when a rise is bad news (waiting time, cost, incidents). */
+    readonly upIsGood: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly trend: _angular_core.InputSignal<readonly (number | null)[] | null>;
+    readonly trendLabels: _angular_core.InputSignal<readonly string[] | null>;
+    readonly trendVariant: _angular_core.InputSignal<SdsSparklineVariant>;
+    readonly trendColor: _angular_core.InputSignal<string | null>;
+    readonly icon: _angular_core.InputSignal<"x" | "search" | "filter" | "menu" | "table" | "copy" | "square" | "chart-column" | "chart-line" | "chart-bar" | "chart-area" | "chart-pie" | "chart-scatter" | "grid-3x3" | "activity" | "gauge" | "trending-up" | "trending-down" | "clipboard-list" | "credit-card" | "external-link" | "languages" | "megaphone" | "monitor" | "store" | "user-round" | "home" | "user-plus" | "user-check" | "hand" | "users" | "bike" | "building-2" | "package" | "package-plus" | "package-open" | "rotate-ccw" | "bar-chart-3" | "log-out" | "panel-left-close" | "panel-left-open" | "panel-left" | "calendar" | "chevron-right" | "chevron-left" | "chevron-down" | "chevron-up" | "plus" | "minus" | "chevrons-left" | "chevrons-right" | "check" | "alert-circle" | "info" | "type" | "tag" | "ticket" | "square-check" | "circle-dot" | "circle-user" | "layout-grid" | "panels-top-left" | "panel-top" | "rows-3" | "book-open" | "palette" | "bell" | "phone" | "settings" | "align-left" | "toggle-left" | "arrow-up" | "arrow-down" | "chevrons-up-down" | "chevrons-up" | "chevrons-down" | "star" | "message-square" | "qr-code" | "eye" | "eye-off" | "user" | "check-circle" | "arrows-clockwise" | "file-text" | "file-check" | "hash" | "map-pin" | "inbox" | "arrow-right" | "refresh-cw" | "loader-circle" | "locate-fixed" | "locate-off" | "bug" | "scroll-text" | "moon" | "sun" | "search-x" | "command" | "sparkles" | "triangle-alert" | "octagon-x" | "ban" | "ellipsis" | "ellipsis-vertical" | "grip-vertical" | "upload" | "image" | "image-off" | "utensils" | "zoom-in" | "zoom-out" | "trash-2" | "clock" | "pencil" | "circle-help" | "stock" | "allergen-cereals-gluten" | "allergen-crustaceans" | "allergen-eggs" | "allergen-fish" | "allergen-peanuts" | "allergen-soybeans" | "allergen-milk" | "allergen-nuts" | "allergen-celery" | "allergen-mustard" | "allergen-sesame" | "allergen-sulphites" | "allergen-lupin" | "allergen-molluscs" | null>;
+    /** Shown under the value when there is no change to report. */
+    readonly hint: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<SdsKpiSize>;
+    readonly appearance: _angular_core.InputSignal<SdsKpiAppearance>;
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly locale: _angular_core.InputSignal<string | null>;
+    private readonly loc;
+    /** Built-in strings (provideSdsCharts labels over the English defaults). */
+    private readonly text;
+    protected readonly display: _angular_core.Signal<string>;
+    private readonly deltaValue;
+    /** The change, signed, with a tone that means good/bad — never colour alone (glyph + words). */
+    protected readonly deltaView: _angular_core.Signal<{
+        text: string;
+        tone: string;
+        icon: "trending-up" | "trending-down" | "minus";
+        spoken: string;
+    } | null>;
+    private absoluteFormat;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdsKpi, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdsKpi, "sds-kpi", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "previous": { "alias": "previous"; "required": false; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaMode": { "alias": "deltaMode"; "required": false; "isSignal": true; }; "deltaLabel": { "alias": "deltaLabel"; "required": false; "isSignal": true; }; "upIsGood": { "alias": "upIsGood"; "required": false; "isSignal": true; }; "trend": { "alias": "trend"; "required": false; "isSignal": true; }; "trendLabels": { "alias": "trendLabels"; "required": false; "isSignal": true; }; "trendVariant": { "alias": "trendVariant"; "required": false; "isSignal": true; }; "trendColor": { "alias": "trendColor"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { SDS_DONUT_OTHER_KEY, SdsBarChart, SdsChartTooltip, SdsDonutChart, SdsHeatmap, SdsKpi, SdsLineChart, SdsScatterChart, SdsSparkline, SdsTreemap };
+export type { SdsAccessor, SdsBarOrientation, SdsBarSort, SdsChartAnnotation, SdsChartGrid, SdsChartLegend, SdsChartPointEvent, SdsChartReferenceBand, SdsChartReferenceLine, SdsChartScale, SdsChartSeries, SdsChartStack, SdsChartTone, SdsChartTooltipContext, SdsChartTooltipRow, SdsChartXType, SdsDonutLegendValue, SdsDonutSort, SdsDonutVariant, SdsHeatmapScheme, SdsKpiAppearance, SdsKpiDeltaMode, SdsKpiSize, SdsLineCurve, SdsLineMarkers, SdsNumberFormat, SdsSparklineVariant, SdsTreemapNode, SdsXFormat, SdsXValue };