@sentropic/design-system-angular 0.36.54

package/dist/AreaChart.d.ts

@@ -0,0 +1,177 @@
+import { type ChartAnnotation, type ResolvedAnnotation } from "./chartAnnotations.js";
+import { type DataLabelsProp } from "./chartDataLabels.js";
+import * as i0 from "@angular/core";
+export type AreaChartTone = "category1" | "category2" | "category3" | "category4" | "category5" | "category6" | "category7" | "category8";
+export type AreaChartDatum = {
+    x: number | string;
+    y: number;
+};
+export type AreaChartProps = {
+    data: (number | AreaChartDatum)[];
+    width?: number;
+    height?: number;
+    tone?: AreaChartTone;
+    smooth?: boolean;
+    label: string;
+    /**
+     * Annotation overlay in DATA space (points, labels, axis lines, regions,
+     * polygons), resolved to pixels via the chart scales. Regions render behind
+     * the area, every other kind above it. Additive: absent ⇒ unchanged.
+     */
+    annotations?: ChartAnnotation[];
+    /**
+     * Per-point value labels. `false`/absent (default) → none. `true` → each
+     * point's value with the chart's numeric formatter. Object → `format(value)`
+     * and/or a `position` override. Default position is `top` (above the point).
+     * Labels are `aria-hidden` — the values already live in the accessible
+     * ChartDataList.
+     */
+    dataLabels?: DataLabelsProp;
+    /**
+     * CONTROLLED synchronised hover key (FR-3). A datum's key is `String(x)`. When
+     * provided (string or null), the crosshair + tooltip track this key instead of
+     * the chart's internal pointer hover (null ⇒ nothing shown), letting a parent
+     * share one hover channel across several aligned charts. Absent (`undefined`)
+     * keeps the legacy uncontrolled behaviour.
+     */
+    hoverKey?: string | null;
+    /**
+     * Emitted when the user hovers a datum (its key) or leaves the plot (`null`).
+     * Always fired on pointer move/leave — even while CONTROLLED — so dataviz can
+     * keep the shared hover channel in sync.
+     */
+    onHoverKeyChange?: (key: string | null) => void;
+    /**
+     * FR-5 — keyboard navigation of the data points (roving tabindex). When `true`
+     * (or implied by wiring `onSelectKey`), a thin focusable overlay is rendered
+     * over the points: the chart owns ONE tab stop, ←/↑/→/↓ move the focus between
+     * points (data order), Home/End jump to the first/last, Enter/Space select the
+     * focused point (`onSelectKey`), Escape leaves the navigation. Each focused
+     * point announces its `x` + value. Absent ⇒ no overlay, rendering unchanged.
+     */
+    keyboardNav?: boolean;
+    /**
+     * Emitted when the user selects the focused point via Enter/Space (its key,
+     * `String(x)`), or `null` when the navigation is left via Escape. Wiring it
+     * also turns the keyboard navigation on.
+     */
+    onSelectKey?: (key: string | null) => void;
+    class?: string;
+};
+type AnnotationRegion = Extract<ResolvedAnnotation, {
+    kind: "region";
+}>;
+type AnnotationAbove = Extract<ResolvedAnnotation, {
+    kind: "line" | "shape" | "point" | "label";
+}>;
+export declare class AreaChart {
+    static readonly stComponentName = "AreaChart";
+    readonly componentName = "AreaChart";
+    readonly MARGIN: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    readonly gradientId: string;
+    private hoveredIndex;
+    private focusedIndex;
+    data: (number | AreaChartDatum)[];
+    width?: number;
+    height?: number;
+    tone?: AreaChartTone;
+    smooth?: boolean;
+    label: string;
+    annotations?: ChartAnnotation[];
+    dataLabels?: DataLabelsProp;
+    hoverKey?: string | null;
+    onHoverKeyChange?: (key: string | null) => void;
+    keyboardNav?: boolean;
+    onSelectKey?: (key: string | null) => void;
+    classInput?: string;
+    get hostClass(): string;
+    get widthValue(): number;
+    get heightValue(): number;
+    get viewBox(): string;
+    get plotWidth(): number;
+    get plotHeight(): number;
+    get normalizedData(): AreaChartDatum[];
+    get yValues(): number[];
+    get yTicks(): number[];
+    get yDomain(): {
+        min: number;
+        max: number;
+    };
+    get xIsNumeric(): boolean;
+    get xDomainMin(): number;
+    get xDomainMax(): number;
+    xPixel(datum: AreaChartDatum, index: number): number;
+    yPixel(y: number): number;
+    get points(): Array<{
+        x: number;
+        y: number;
+        datum: AreaChartDatum;
+        index: number;
+    }>;
+    get linePath(): string;
+    get areaPath(): string;
+    get gridLines(): Array<{
+        value: number;
+        y: number;
+    }>;
+    get xTickEntries(): Array<{
+        key: string;
+        x: number;
+        label: string;
+    }>;
+    get annotationContext(): {
+        xScale: (value: number | string) => number | null;
+        yScale: (value: number) => number | null;
+        plotLeft: number;
+        plotTop: number;
+        plotWidth: number;
+        plotHeight: number;
+    };
+    get resolvedAnnotations(): ResolvedAnnotation[];
+    get annotationRegions(): AnnotationRegion[];
+    get annotationAbove(): AnnotationAbove[];
+    annotationShapePoints(annotation: Extract<ResolvedAnnotation, {
+        kind: "shape";
+    }>): string;
+    get dataLabelItems(): Array<{
+        key: string;
+        x: number;
+        y: number;
+        text: string;
+        baseline: string;
+    }>;
+    get dataValueItems(): string[];
+    get hoverKeys(): string[];
+    get activeIndex(): number;
+    get hoveredPoint(): {
+        x: number;
+        y: number;
+        datum: AreaChartDatum;
+        index: number;
+    } | null;
+    get navEnabled(): boolean;
+    formatTickLabel(v: number): string;
+    datapointLabel(pt: {
+        datum: AreaChartDatum;
+    }): string;
+    rovingTabIndexFor(index: number): number;
+    tooltipLeft(pt: {
+        x: number;
+    }): number;
+    tooltipTop(pt: {
+        y: number;
+    }): number;
+    handleLeave(): void;
+    handleVisualPointerMove(e: PointerEvent): void;
+    handleDatapointFocus(index: number): void;
+    handleDatapointKeyDown(e: KeyboardEvent, index: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AreaChart, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AreaChart, "st-area-chart", never, { "data": { "alias": "data"; "required": false; }; "width": { "alias": "width"; "required": false; }; "height": { "alias": "height"; "required": false; }; "tone": { "alias": "tone"; "required": false; }; "smooth": { "alias": "smooth"; "required": false; }; "label": { "alias": "label"; "required": false; }; "annotations": { "alias": "annotations"; "required": false; }; "dataLabels": { "alias": "dataLabels"; "required": false; }; "hoverKey": { "alias": "hoverKey"; "required": false; }; "onHoverKeyChange": { "alias": "onHoverKeyChange"; "required": false; }; "keyboardNav": { "alias": "keyboardNav"; "required": false; }; "onSelectKey": { "alias": "onSelectKey"; "required": false; }; "classInput": { "alias": "class"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};
+//# sourceMappingURL=AreaChart.d.ts.map

package/dist/AreaChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AreaChart.d.ts","sourceRoot":"","sources":["../src/AreaChart.ts"],"names":[],"mappings":"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"}