@weeehaoooz/talos-ui 0.1.1 → 0.1.2

package/types/weeehaoooz-talos-ui-data-viz.d.ts

@@ -0,0 +1,839 @@
+import * as _angular_core from '@angular/core';
+import { DateRangeValue, DateRangePreset } from '@weeehaoooz/talos-ui/form';
+
+/**
+ * Talos Category Bar Type Definitions
+ */
+type CategoryBarSize = 'xs' | 'sm' | 'md' | 'lg';
+type CategoryBarShape = 'pill' | 'rounded' | 'square';
+type CategoryBarLabelPosition = 'top' | 'bottom' | 'none';
+type CategoryBarColorScheme = 'blue' | 'emerald' | 'violet' | 'amber' | 'rose' | 'cyan' | 'lime' | 'indigo' | 'pink' | 'orange' | 'fuchsia' | 'teal' | 'sky' | 'red' | 'slate' | 'purple';
+/**
+ * Individual category segment definition for the category bar.
+ */
+interface CategoryBarSegment {
+    /** Segment numeric value (width will be proportional to value / sum(values)) */
+    value: number;
+    /** Human-readable category label (displayed in tooltip, legend, or accessibility text) */
+    label?: string;
+    /** Specific CSS color string (e.g. '#3b82f6', 'rgb(59, 130, 246)', 'var(--talos-primary-color)') */
+    color?: string;
+    /** Named color scheme preset (e.g. 'blue', 'emerald', 'violet', 'amber', 'rose', etc.) */
+    colorScheme?: CategoryBarColorScheme | string;
+    /** Custom tooltip text or template text */
+    tooltip?: string;
+    /** Optional metadata passed to click and hover events */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Marker needle definition for the category bar.
+ */
+interface CategoryBarMarker {
+    /** Numeric value indicating where the marker sits along the range */
+    value: number;
+    /** Custom label displayed for the marker (e.g. 'Target: $220k', 'Current: 220') */
+    label?: string;
+    /** Custom marker color (defaults to neutral dark/white or category color) */
+    color?: string;
+    /** Custom tooltip content for the marker */
+    tooltip?: string;
+    /** Whether to animate marker position changes (defaults to true) */
+    showAnimation?: boolean;
+    /** Custom marker shape / style ('pill' | 'line' | 'pin' | 'needle') */
+    variant?: 'pill' | 'line' | 'pin' | 'needle';
+}
+/**
+ * Normalized computed segment model used internally by the template.
+ */
+interface CategoryBarComputedSegment {
+    index: number;
+    value: number;
+    label: string;
+    color: string;
+    percentage: number;
+    cumulativeStart: number;
+    cumulativeEnd: number;
+    cumulativeStartPercent: number;
+    cumulativeEndPercent: number;
+    formattedValue: string;
+    tooltipText: string;
+    raw: CategoryBarSegment;
+}
+/**
+ * Scale boundary label item.
+ */
+interface CategoryBarScaleLabel {
+    index: number;
+    value: number;
+    text: string;
+    leftPercent: number;
+}
+/**
+ * Event emitted when a segment is clicked.
+ */
+interface CategoryBarSegmentClickEvent {
+    segment: CategoryBarComputedSegment;
+    index: number;
+    event: Event;
+}
+type CategoryBarClickEvent = CategoryBarSegmentClickEvent;
+/**
+ * Event emitted when the marker is clicked.
+ */
+interface CategoryBarMarkerClickEvent {
+    marker: CategoryBarMarker;
+    value: number;
+    percent: number;
+    event: Event;
+}
+
+declare class TalosCategoryBarComponent {
+    private readonly elementRef;
+    /**
+     * Simple numeric values array for each category (e.g. [120, 80, 60, 40]).
+     */
+    readonly values: _angular_core.InputSignal<number[] | null>;
+    /**
+     * Detailed category segments with labels, colors, and metadata.
+     */
+    readonly categories: _angular_core.InputSignal<CategoryBarSegment[] | null>;
+    /**
+     * Custom palette or color list for segments. Can be CSS color strings or preset names.
+     */
+    readonly colors: _angular_core.InputSignal<string[]>;
+    /**
+     * Numeric position for the needle marker.
+     */
+    readonly markerValue: _angular_core.InputSignal<number | null>;
+    /**
+     * Detailed marker object definition.
+     */
+    readonly marker: _angular_core.InputSignal<CategoryBarMarker | null>;
+    /**
+     * Minimum scale bound (defaults to 0).
+     */
+    readonly minValue: _angular_core.InputSignal<number | null>;
+    /**
+     * Maximum scale bound (defaults to sum of all category values).
+     */
+    readonly maxValue: _angular_core.InputSignal<number | null>;
+    /**
+     * Whether to show category scale labels at segment boundaries.
+     */
+    readonly showLabels: _angular_core.InputSignal<boolean>;
+    /**
+     * Custom boundary label strings. If not provided, computed cumulative values are shown.
+     */
+    readonly labels: _angular_core.InputSignal<string[] | null>;
+    /**
+     * Placement of scale boundary labels: 'top', 'bottom', or 'none'.
+     */
+    readonly labelPosition: _angular_core.InputSignal<CategoryBarLabelPosition>;
+    /**
+     * Custom label formatter function for boundary values.
+     */
+    readonly labelFormatter: _angular_core.InputSignal<((value: number, index: number) => string) | null>;
+    /**
+     * Custom value formatter for segment tooltip / legends.
+     */
+    readonly valueFormatter: _angular_core.InputSignal<((value: number) => string) | null>;
+    /**
+     * Custom marker value formatter for tooltip.
+     */
+    readonly markerFormatter: _angular_core.InputSignal<((value: number) => string) | null>;
+    /**
+     * Height size variant of the category bar: 'xs' (6px), 'sm' (8px), 'md' (12px), 'lg' (16px).
+     */
+    readonly size: _angular_core.InputSignal<CategoryBarSize>;
+    /**
+     * Corner shape of the bar: 'pill' (fully rounded capsule), 'rounded' (6px), 'square' (0px).
+     */
+    readonly shape: _angular_core.InputSignal<CategoryBarShape>;
+    /**
+     * Optional title above the bar.
+     */
+    readonly title: _angular_core.InputSignal<string>;
+    /**
+     * Optional subtitle below the title.
+     */
+    readonly subtitle: _angular_core.InputSignal<string>;
+    /**
+     * Whether to display a bottom legend row with category names and color indicators.
+     */
+    readonly showLegend: _angular_core.InputSignal<boolean>;
+    /**
+     * Whether hovering segments or marker displays interactive tooltips.
+     */
+    readonly showTooltip: _angular_core.InputSignal<boolean>;
+    /**
+     * Enable smooth CSS transition animation.
+     */
+    readonly animated: _angular_core.InputSignal<boolean>;
+    /**
+     * Output event when a segment is clicked.
+     */
+    readonly segmentClick: _angular_core.OutputEmitterRef<CategoryBarSegmentClickEvent>;
+    /**
+     * Output event when the marker is clicked.
+     */
+    readonly markerClick: _angular_core.OutputEmitterRef<CategoryBarMarkerClickEvent>;
+    /**
+     * Output event when a segment is hovered.
+     */
+    readonly segmentHover: _angular_core.OutputEmitterRef<CategoryBarComputedSegment | null>;
+    protected readonly hoveredSegment: _angular_core.WritableSignal<CategoryBarComputedSegment | null>;
+    protected readonly hoveredMarker: _angular_core.WritableSignal<boolean>;
+    protected readonly tooltipPosition: _angular_core.WritableSignal<{
+        x: number;
+        y: number;
+    } | null>;
+    /**
+     * Resolves raw category items from either `categories` or `values` input.
+     */
+    private readonly rawCategories;
+    /**
+     * Resolved color array mapping named color presets to hex codes if needed.
+     */
+    private readonly resolvedPalette;
+    /**
+     * Total sum of all positive category values.
+     */
+    protected readonly totalSum: _angular_core.Signal<number>;
+    /**
+     * Computed minimum boundary.
+     */
+    protected readonly computedMin: _angular_core.Signal<number>;
+    /**
+     * Computed maximum boundary.
+     */
+    protected readonly computedMax: _angular_core.Signal<number>;
+    /**
+     * Normalized computed segments for rendering with cumulative positions and percentages.
+     */
+    protected readonly normalizedSegments: _angular_core.Signal<CategoryBarComputedSegment[]>;
+    /**
+     * Computed scale boundary labels positioned at tick intersections.
+     */
+    protected readonly scaleLabels: _angular_core.Signal<CategoryBarScaleLabel[]>;
+    /**
+     * Resolved marker value.
+     */
+    protected readonly markerVal: _angular_core.Signal<number | null>;
+    /**
+     * Marker needle placement and metadata.
+     */
+    protected readonly markerState: _angular_core.Signal<{
+        visible: boolean;
+        percent: number;
+        color: string;
+        label: string;
+        tooltip: string;
+        variant: "pill" | "line" | "pin" | "needle";
+    } | null>;
+    /**
+     * Accessible description for screen readers.
+     */
+    protected readonly ariaLabel: _angular_core.Signal<string>;
+    onSegmentClick(seg: CategoryBarComputedSegment, event: Event): void;
+    onSegmentMouseEnter(seg: CategoryBarComputedSegment, event: MouseEvent): void;
+    onSegmentMouseLeave(): void;
+    onMarkerMouseEnter(event: MouseEvent): void;
+    onMarkerMouseLeave(): void;
+    onMarkerClick(event: Event): void;
+    private updateTooltipPos;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosCategoryBarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TalosCategoryBarComponent, "talos-category-bar", never, { "values": { "alias": "values"; "required": false; "isSignal": true; }; "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "colors": { "alias": "colors"; "required": false; "isSignal": true; }; "markerValue": { "alias": "markerValue"; "required": false; "isSignal": true; }; "marker": { "alias": "marker"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "showLabels": { "alias": "showLabels"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "labelFormatter": { "alias": "labelFormatter"; "required": false; "isSignal": true; }; "valueFormatter": { "alias": "valueFormatter"; "required": false; "isSignal": true; }; "markerFormatter": { "alias": "markerFormatter"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "showTooltip": { "alias": "showTooltip"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; }, { "segmentClick": "segmentClick"; "markerClick": "markerClick"; "segmentHover": "segmentHover"; }, never, ["[talosCategoryBarHeader]"], true, never>;
+}
+
+declare class TalosCategoryBarModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosCategoryBarModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<TalosCategoryBarModule, never, [typeof TalosCategoryBarComponent], [typeof TalosCategoryBarComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<TalosCategoryBarModule>;
+}
+
+/**
+ * Talos Heatmap Type Definitions
+ */
+type HeatmapColorScheme = 'indigo' | 'blue' | 'emerald' | 'rose' | 'amber' | 'violet' | 'slate' | 'custom';
+type HeatmapTimeFormat = '12h' | '24h';
+type HeatmapCellShape = 'pill' | 'rounded' | 'square';
+type HeatmapCellSize = 'sm' | 'md' | 'lg';
+type HeatmapExportFormat = 'csv' | 'json';
+type HeatmapInterval = 'hour' | 'day';
+/**
+ * Standard flat data point representing an activity count for a given time slot.
+ */
+interface HeatmapDataPoint {
+    /** Day label ('Mon', 'Tue', ...), Day index (0-6), or Date string / object ('2026-08-13') */
+    day?: string | number | Date;
+    /** Specific ISO Date string ('2026-08-13') or Date object */
+    date?: string | Date;
+    /** Hour of the day (0 to 23), required for 'hour' interval */
+    hour?: number;
+    /** Numeric count / intensity value */
+    value: number;
+    /** Optional metadata passed to click events & tooltip */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 2D Record Map format: { [colKey: string]: { [rowKey: string | number]: number } }
+ */
+type HeatmapMatrixData = Record<string, Record<number | string, number>>;
+/**
+ * Raw timestamp list format: Array of ISO strings, Date objects, or unix timestamps in ms.
+ */
+type HeatmapTimestampData = (string | Date | number)[];
+/**
+ * Combined developer input data types.
+ */
+type HeatmapDataInput = HeatmapDataPoint[] | HeatmapMatrixData | HeatmapTimestampData;
+/**
+ * Multi-metric dataset item for switching metrics via the header dropdown.
+ */
+interface HeatmapMetric {
+    id: string;
+    label: string;
+    data: HeatmapDataInput;
+    unit?: string;
+    colorScheme?: HeatmapColorScheme;
+    customColorStops?: [string, string];
+}
+/**
+ * Internal normalized cell model rendered in the template.
+ */
+interface HeatmapCell {
+    id: string;
+    colKey: string | number;
+    colLabel: string;
+    rowKey: string | number;
+    rowLabel: string;
+    value: number;
+    intensity: number;
+    backgroundColor: string;
+    textColor: string;
+    formattedValue: string;
+    tooltipText: string;
+    date?: Date;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Time range emitted by the component for backend data fetching.
+ */
+interface HeatmapTimeRange {
+    startDate?: Date | string | null;
+    endDate?: Date | string | null;
+    interval: HeatmapInterval;
+    startHour?: number;
+    endHour?: number;
+    days: string[];
+    dateRange?: DateRangeValue | null;
+    swapAxes?: boolean;
+}
+/**
+ * Event payload emitted when a heatmap cell is clicked or activated.
+ */
+interface HeatmapCellClickEvent {
+    cell: HeatmapCell;
+    colKey: string | number;
+    rowKey: string | number;
+    value: number;
+    interval: HeatmapInterval;
+    event: MouseEvent | KeyboardEvent;
+}
+
+declare class TalosHeatmapComponent {
+    private readonly elementRef;
+    readonly data: _angular_core.InputSignal<HeatmapDataInput>;
+    readonly metrics: _angular_core.InputSignal<HeatmapMetric[]>;
+    readonly selectedMetricId: _angular_core.ModelSignal<string | undefined>;
+    readonly interval: _angular_core.ModelSignal<HeatmapInterval>;
+    readonly dateRange: _angular_core.ModelSignal<DateRangeValue | null>;
+    readonly swapAxes: _angular_core.ModelSignal<boolean>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly hoursRange: _angular_core.InputSignal<[number, number]>;
+    readonly timeFormat: _angular_core.InputSignal<HeatmapTimeFormat>;
+    readonly days: _angular_core.InputSignal<string[]>;
+    readonly colorScheme: _angular_core.InputSignal<HeatmapColorScheme>;
+    readonly customColorStops: _angular_core.InputSignal<[string, string] | undefined>;
+    readonly showLegend: _angular_core.InputSignal<boolean>;
+    readonly showValues: _angular_core.InputSignal<boolean>;
+    readonly cellShape: _angular_core.InputSignal<HeatmapCellShape>;
+    readonly cellSize: _angular_core.InputSignal<HeatmapCellSize>;
+    readonly fitWidth: _angular_core.InputSignal<boolean | undefined>;
+    readonly loading: _angular_core.InputSignal<boolean>;
+    readonly showToolbar: _angular_core.InputSignal<boolean>;
+    readonly showRefresh: _angular_core.InputSignal<boolean>;
+    readonly showExport: _angular_core.InputSignal<boolean>;
+    readonly showExpand: _angular_core.InputSignal<boolean>;
+    readonly showSwapAxes: _angular_core.InputSignal<boolean>;
+    readonly showIntervalToggle: _angular_core.InputSignal<boolean>;
+    readonly showDateRangePicker: _angular_core.InputSignal<boolean>;
+    readonly dateRangePresets: _angular_core.InputSignal<DateRangePreset[] | null>;
+    readonly unit: _angular_core.InputSignal<string>;
+    readonly maxValue: _angular_core.InputSignal<number | undefined>;
+    readonly minValue: _angular_core.InputSignal<number | undefined>;
+    readonly cellClick: _angular_core.OutputEmitterRef<HeatmapCellClickEvent>;
+    readonly cellHover: _angular_core.OutputEmitterRef<HeatmapCell | null>;
+    readonly timeRangeChange: _angular_core.OutputEmitterRef<HeatmapTimeRange>;
+    readonly refresh: _angular_core.OutputEmitterRef<void>;
+    readonly metricChange: _angular_core.OutputEmitterRef<HeatmapMetric>;
+    readonly export: _angular_core.OutputEmitterRef<{
+        format: HeatmapExportFormat;
+        data: unknown;
+    }>;
+    readonly isExpanded: _angular_core.WritableSignal<boolean>;
+    readonly isMetricDropdownOpen: _angular_core.WritableSignal<boolean>;
+    readonly isExportDropdownOpen: _angular_core.WritableSignal<boolean>;
+    readonly hoveredCell: _angular_core.WritableSignal<HeatmapCell | null>;
+    readonly focusedCoord: _angular_core.WritableSignal<{
+        colIndex: number;
+        rowIndex: number;
+    } | null>;
+    readonly isFitWidth: _angular_core.Signal<boolean>;
+    readonly currentMetric: _angular_core.Signal<HeatmapMetric | undefined>;
+    readonly activeColorScheme: _angular_core.Signal<HeatmapColorScheme>;
+    readonly activeUnit: _angular_core.Signal<string>;
+    readonly activeDataInput: _angular_core.Signal<HeatmapDataInput>;
+    readonly hours: _angular_core.Signal<number[]>;
+    readonly parsedDateRange: _angular_core.Signal<{
+        start: Date | null;
+        end: Date | null;
+    }>;
+    readonly dayModeWeeks: _angular_core.Signal<{
+        label: string;
+        start: Date;
+        end: Date;
+        days: Date[];
+    }[]>;
+    readonly normalizedValueMap: _angular_core.Signal<Map<string, {
+        value: number;
+        meta?: Record<string, unknown>;
+    }>>;
+    readonly computedScaleBounds: _angular_core.Signal<{
+        min: number;
+        max: number;
+    }>;
+    readonly legendGradientCss: _angular_core.Signal<string>;
+    readonly columnHeaders: _angular_core.Signal<{
+        key: string | number;
+        label: string;
+    }[]>;
+    readonly gridRows: _angular_core.Signal<{
+        key: string | number;
+        label: string;
+        cells: HeatmapCell[];
+    }[]>;
+    constructor();
+    formatHourLabel(hour: number, format: HeatmapTimeFormat): string;
+    setInterval(newInterval: HeatmapInterval): void;
+    toggleSwapAxes(): void;
+    onDateRangePickerChange(val: DateRangeValue | null): void;
+    toggleExpand(): void;
+    toggleMetricDropdown(event: MouseEvent): void;
+    toggleExportDropdown(event: MouseEvent): void;
+    selectMetric(metric: HeatmapMetric): void;
+    onRefreshClick(): void;
+    onCellMouseEnter(cell: HeatmapCell): void;
+    onCellMouseLeave(): void;
+    onCellClick(cell: HeatmapCell, event: MouseEvent): void;
+    onKeydown(event: KeyboardEvent, colIdx: number, rowIdx: number): void;
+    triggerExport(format: HeatmapExportFormat): void;
+    private downloadFile;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosHeatmapComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TalosHeatmapComponent, "talos-heatmap", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "metrics": { "alias": "metrics"; "required": false; "isSignal": true; }; "selectedMetricId": { "alias": "selectedMetricId"; "required": false; "isSignal": true; }; "interval": { "alias": "interval"; "required": false; "isSignal": true; }; "dateRange": { "alias": "dateRange"; "required": false; "isSignal": true; }; "swapAxes": { "alias": "swapAxes"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "hoursRange": { "alias": "hoursRange"; "required": false; "isSignal": true; }; "timeFormat": { "alias": "timeFormat"; "required": false; "isSignal": true; }; "days": { "alias": "days"; "required": false; "isSignal": true; }; "colorScheme": { "alias": "colorScheme"; "required": false; "isSignal": true; }; "customColorStops": { "alias": "customColorStops"; "required": false; "isSignal": true; }; "showLegend": { "alias": "showLegend"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "cellShape": { "alias": "cellShape"; "required": false; "isSignal": true; }; "cellSize": { "alias": "cellSize"; "required": false; "isSignal": true; }; "fitWidth": { "alias": "fitWidth"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "showRefresh": { "alias": "showRefresh"; "required": false; "isSignal": true; }; "showExport": { "alias": "showExport"; "required": false; "isSignal": true; }; "showExpand": { "alias": "showExpand"; "required": false; "isSignal": true; }; "showSwapAxes": { "alias": "showSwapAxes"; "required": false; "isSignal": true; }; "showIntervalToggle": { "alias": "showIntervalToggle"; "required": false; "isSignal": true; }; "showDateRangePicker": { "alias": "showDateRangePicker"; "required": false; "isSignal": true; }; "dateRangePresets": { "alias": "dateRangePresets"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; }, { "selectedMetricId": "selectedMetricIdChange"; "interval": "intervalChange"; "dateRange": "dateRangeChange"; "swapAxes": "swapAxesChange"; "cellClick": "cellClick"; "cellHover": "cellHover"; "timeRangeChange": "timeRangeChange"; "refresh": "refresh"; "metricChange": "metricChange"; "export": "export"; }, never, never, true, never>;
+}
+
+declare class TalosHeatmapModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosHeatmapModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<TalosHeatmapModule, never, [typeof TalosHeatmapComponent], [typeof TalosHeatmapComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<TalosHeatmapModule>;
+}
+
+/**
+ * Types and interfaces for TalosMiniDonutComponent
+ */
+type MiniDonutSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'custom';
+type MiniDonutLineCap = 'round' | 'butt';
+type MiniDonutColorScheme = 'primary' | 'success' | 'danger' | 'warning' | 'info' | 'violet' | 'emerald' | 'rose' | 'amber' | 'cyan' | 'slate' | string;
+interface MiniDonutSegment {
+    value: number;
+    color?: string;
+    label?: string;
+    tooltip?: string;
+    id?: string;
+}
+interface ComputedDonutSegment {
+    index: number;
+    value: number;
+    percentage: number;
+    color: string;
+    label?: string;
+    tooltip?: string;
+    dashArray: string;
+    dashOffset: number;
+    pathLength: number;
+}
+
+declare class TalosMiniDonutComponent {
+    /** Single progress value (e.g. 75 or 450) */
+    readonly value: _angular_core.InputSignal<number | null>;
+    /** Minimum value for single progress mode */
+    readonly min: _angular_core.InputSignal<number>;
+    /** Maximum value for single progress mode */
+    readonly max: _angular_core.InputSignal<number>;
+    /** Multi-segment dataset */
+    readonly segments: _angular_core.InputSignal<MiniDonutSegment[] | null>;
+    /** Size preset */
+    readonly size: _angular_core.InputSignal<MiniDonutSize>;
+    /** Custom dimension override in px */
+    readonly dimension: _angular_core.InputSignal<number | null>;
+    /** Custom stroke width override */
+    readonly strokeWidth: _angular_core.InputSignal<number | null>;
+    /** Color scheme or hex string for single progress mode */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Background track ring color */
+    readonly trackColor: _angular_core.InputSignal<string | null>;
+    /** Show background track */
+    readonly showTrack: _angular_core.InputSignal<boolean>;
+    /** SVG stroke linecap */
+    readonly lineCap: _angular_core.InputSignal<MiniDonutLineCap>;
+    /** Gap spacing between segments in multi-segment mode (in px) */
+    readonly gap: _angular_core.InputSignal<number>;
+    /** Show built-in center percentage or text */
+    readonly showCenterText: _angular_core.InputSignal<boolean>;
+    /** Explicit center primary text override */
+    readonly centerText: _angular_core.InputSignal<string | null>;
+    /** Secondary center subtext */
+    readonly centerSubtext: _angular_core.InputSignal<string | null>;
+    /** Enable smooth CSS animation */
+    readonly animated: _angular_core.InputSignal<boolean>;
+    /** Custom ARIA label */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Segment click event */
+    readonly segmentClick: _angular_core.OutputEmitterRef<MiniDonutSegment>;
+    protected readonly svgSize = 100;
+    protected readonly center = 50;
+    /** Computed pixel dimension */
+    readonly pixelDimension: _angular_core.Signal<number>;
+    /** Computed stroke width in SVG coordinates */
+    readonly computedStrokeWidth: _angular_core.Signal<number>;
+    /** Radius in SVG coordinates */
+    readonly radius: _angular_core.Signal<number>;
+    /** Circumference */
+    readonly circumference: _angular_core.Signal<number>;
+    /** Effective single progress color */
+    readonly effectiveColor: _angular_core.Signal<string>;
+    /** Computed percentage for single progress mode */
+    readonly singlePercentage: _angular_core.Signal<number>;
+    /** Single progress dash offset/array */
+    readonly singleDashArray: _angular_core.Signal<string>;
+    /** Computed multi-segment values with offsets */
+    readonly computedSegments: _angular_core.Signal<ComputedDonutSegment[]>;
+    /** Display text inside center */
+    readonly computedCenterText: _angular_core.Signal<string>;
+    /** ARIA attributes */
+    readonly currentAriaValue: _angular_core.Signal<number | null>;
+    readonly computedAriaLabel: _angular_core.Signal<string>;
+    protected onSegmentClick(segIndex: number): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosMiniDonutComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TalosMiniDonutComponent, "talos-mini-donut", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "segments": { "alias": "segments"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "dimension": { "alias": "dimension"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "showTrack": { "alias": "showTrack"; "required": false; "isSignal": true; }; "lineCap": { "alias": "lineCap"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "showCenterText": { "alias": "showCenterText"; "required": false; "isSignal": true; }; "centerText": { "alias": "centerText"; "required": false; "isSignal": true; }; "centerSubtext": { "alias": "centerSubtext"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "segmentClick": "segmentClick"; }, never, ["*"], true, never>;
+}
+
+declare class TalosMiniDonutModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosMiniDonutModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<TalosMiniDonutModule, never, [typeof TalosMiniDonutComponent], [typeof TalosMiniDonutComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<TalosMiniDonutModule>;
+}
+
+/**
+ * Types and interfaces for TalosMiniGaugeComponent
+ */
+type MiniGaugeType = 'semi-circle' | 'arch' | 'linear';
+type GaugeSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'responsive' | 'custom';
+type MiniGaugeIndicator = 'arc' | 'needle' | 'dot';
+interface GaugeThreshold {
+    from: number;
+    to: number;
+    color: string;
+    label?: string;
+}
+interface GaugeMarker {
+    value: number;
+    color?: string;
+    label?: string;
+    shape?: 'line' | 'dot' | 'triangle';
+}
+
+interface ArcSegment {
+    path: string;
+    color: string;
+    from: number;
+    to: number;
+    isFirst: boolean;
+    isLast: boolean;
+}
+declare class TalosMiniGaugeComponent {
+    /** Current gauge value */
+    readonly value: _angular_core.InputSignal<number>;
+    /** Minimum gauge scale */
+    readonly min: _angular_core.InputSignal<number>;
+    /** Maximum gauge scale */
+    readonly max: _angular_core.InputSignal<number>;
+    /** Optional target benchmark marker value */
+    readonly target: _angular_core.InputSignal<number | null>;
+    /** Gauge rendering style */
+    readonly type: _angular_core.InputSignal<MiniGaugeType>;
+    /** Value indicator pointer style: arc fill, needle, or dot */
+    readonly indicator: _angular_core.InputSignal<MiniGaugeIndicator>;
+    /** Custom colored threshold zones */
+    readonly thresholds: _angular_core.InputSignal<GaugeThreshold[] | null>;
+    /** Base color or palette when no thresholds are used */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Background track color */
+    readonly trackColor: _angular_core.InputSignal<string | null>;
+    /** Preset size */
+    readonly size: _angular_core.InputSignal<GaugeSize>;
+    /** Custom width */
+    readonly width: _angular_core.InputSignal<string | number | null>;
+    /** Custom height */
+    readonly height: _angular_core.InputSignal<string | number | null>;
+    /** Arc stroke width */
+    readonly strokeWidth: _angular_core.InputSignal<number>;
+    /** Arc stroke linecap style ('round' | 'butt') */
+    readonly lineCap: _angular_core.InputSignal<"round" | "butt">;
+    /** Show numerical value readout in center/bottom */
+    readonly showValue: _angular_core.InputSignal<boolean>;
+    /** Show min and max numbers at gauge edges */
+    readonly showMinMax: _angular_core.InputSignal<boolean>;
+    /** Unit label string (e.g. '%', 'ms', 'rpm') */
+    readonly unit: _angular_core.InputSignal<string>;
+    /** Value formatter */
+    readonly valueFormatter: _angular_core.InputSignal<(val: number) => string>;
+    /** Custom ARIA label */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Enable animation */
+    readonly animated: _angular_core.InputSignal<boolean>;
+    /** SVG Coordinate constants */
+    protected readonly cx = 50;
+    protected readonly cySemi = 44;
+    protected readonly cyArch = 42;
+    protected readonly radius = 36;
+    /** Needle length tailored per circular gauge type */
+    readonly needleLength: _angular_core.Signal<30 | 26>;
+    readonly hostWidth: _angular_core.Signal<string | null>;
+    readonly hostHeight: _angular_core.Signal<string | null>;
+    /** Clamped and normalized ratio [0..1] */
+    readonly normalizedRatio: _angular_core.Signal<number>;
+    /** Target ratio [0..1] */
+    readonly targetRatio: _angular_core.Signal<number | null>;
+    /** ViewBox string based on gauge type */
+    readonly viewBox: _angular_core.Signal<"0 0 100 50" | "0 0 100 66" | "0 0 100 14">;
+    /** Start & End angles in degrees for circular gauge types */
+    readonly angleSpan: _angular_core.Signal<{
+        start: number;
+        end: number;
+        total: number;
+    }>;
+    /** Current value angle in degrees */
+    readonly currentAngle: _angular_core.Signal<number>;
+    /** Needle transform for needle indicator */
+    readonly needleTransform: _angular_core.Signal<string>;
+    /** Target marker position & rotation */
+    readonly targetMarkerProps: _angular_core.Signal<{
+        x: number;
+        y: number;
+        rotation: number;
+        angle?: undefined;
+    } | {
+        x: number;
+        y: number;
+        angle: number;
+        rotation?: undefined;
+    } | null>;
+    /** Dot transform for dot indicator (rotates along the circular arc path) */
+    readonly dotTransform: _angular_core.Signal<string>;
+    /** Dot indicator position */
+    readonly dotIndicatorPosition: _angular_core.Signal<{
+        x: number;
+        y: number;
+    }>;
+    /** Base track SVG path */
+    readonly trackPath: _angular_core.Signal<string>;
+    /** Active value arc SVG path */
+    readonly valueArcPath: _angular_core.Signal<string>;
+    /** Active color based on thresholds or color input */
+    readonly activeColor: _angular_core.Signal<string>;
+    /** Threshold band segments */
+    readonly thresholdSegments: _angular_core.Signal<ArcSegment[]>;
+    readonly computedAriaLabel: _angular_core.Signal<string>;
+    /** Helper to generate SVG Arc Path 'M x1 y1 A r r 0 largeArc sweep x2 y2' */
+    private createArcSvgPath;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosMiniGaugeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TalosMiniGaugeComponent, "talos-mini-gauge", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "indicator": { "alias": "indicator"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "trackColor": { "alias": "trackColor"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "lineCap": { "alias": "lineCap"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "showMinMax": { "alias": "showMinMax"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "valueFormatter": { "alias": "valueFormatter"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class TalosMiniGaugeModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosMiniGaugeModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<TalosMiniGaugeModule, never, [typeof TalosMiniGaugeComponent], [typeof TalosMiniGaugeComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<TalosMiniGaugeModule>;
+}
+
+/**
+ * Types and interfaces for TalosSparklineComponent
+ */
+type SparklineType = 'line' | 'area' | 'bar';
+type SparklineSize = 'xs' | 'sm' | 'md' | 'lg' | 'responsive' | 'custom';
+type SparklineColorScheme = 'primary' | 'success' | 'danger' | 'warning' | 'info' | 'violet' | 'emerald' | 'rose' | 'amber' | 'cyan' | 'slate' | string;
+type SparklineMarkerMode = 'none' | 'all' | 'endpoints' | 'min-max' | 'last';
+interface SparklinePoint {
+    value: number;
+    label?: string;
+    date?: string;
+    color?: string;
+}
+type SparklineInputData = (number | SparklinePoint)[];
+declare const GOLDEN_RATIO = 1.618;
+type SparklineAspectRatio = number | 'golden' | string;
+interface SparklineHoverEvent {
+    index: number;
+    value: number;
+    label?: string;
+    x: number;
+    y: number;
+}
+
+interface InternalPoint {
+    index: number;
+    value: number;
+    label?: string;
+    date?: string;
+    x: number;
+    y: number;
+    color?: string;
+    isMin?: boolean;
+    isMax?: boolean;
+    isFirst?: boolean;
+    isLast?: boolean;
+}
+interface BarSegment {
+    index: number;
+    value: number;
+    label?: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color: string;
+}
+declare class TalosSparklineComponent {
+    private readonly elementRef;
+    private resizeObserver?;
+    /** Data points (numbers or objects) */
+    readonly data: _angular_core.InputSignal<SparklineInputData>;
+    /** Chart type: line, area, or bar */
+    readonly type: _angular_core.InputSignal<SparklineType>;
+    /** Visual color theme or custom hex code */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Automatically choose green/red based on first -> last delta */
+    readonly autoColorTrend: _angular_core.InputSignal<boolean>;
+    /** Smooth Bezier interpolation vs straight line */
+    readonly smooth: _angular_core.InputSignal<boolean>;
+    /** Stroke line width */
+    readonly strokeWidth: _angular_core.InputSignal<number>;
+    /** Marker dots display mode */
+    readonly showMarkers: _angular_core.InputSignal<SparklineMarkerMode>;
+    /** Marker circle radius */
+    readonly markerRadius: _angular_core.InputSignal<number>;
+    /** Optional reference horizontal baseline */
+    readonly referenceValue: _angular_core.InputSignal<number | null>;
+    /** Show interactive hover tooltip */
+    readonly showTooltip: _angular_core.InputSignal<boolean>;
+    /** Interactive mouse events enabled */
+    readonly interactive: _angular_core.InputSignal<boolean>;
+    /** Gap between bars for bar sparklines */
+    readonly barGap: _angular_core.InputSignal<number>;
+    /** Corner radius for bars */
+    readonly barRadius: _angular_core.InputSignal<number>;
+    /** Preset size */
+    readonly size: _angular_core.InputSignal<SparklineSize>;
+    /** Aspect ratio configuration (e.g. 'golden', 1.618, '2:1', '16:9') */
+    readonly aspectRatio: _angular_core.InputSignal<SparklineAspectRatio | null>;
+    /** Custom width override (e.g. '120px' or '100%') */
+    readonly width: _angular_core.InputSignal<string | number | null>;
+    /** Custom height override (e.g. '36px') */
+    readonly height: _angular_core.InputSignal<string | number | null>;
+    /** Explicit minimum value bounds */
+    readonly min: _angular_core.InputSignal<number | null>;
+    /** Explicit maximum value bounds */
+    readonly max: _angular_core.InputSignal<number | null>;
+    /** Custom accessible label */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /** Value formatter for tooltip */
+    readonly valueFormatter: _angular_core.InputSignal<(val: number) => string>;
+    /** Hover event emitter */
+    readonly pointHover: _angular_core.OutputEmitterRef<SparklineHoverEvent | null>;
+    /** Click event emitter */
+    readonly pointClick: _angular_core.OutputEmitterRef<SparklineHoverEvent>;
+    readonly gradientId: string;
+    protected readonly hoveredPoint: _angular_core.WritableSignal<InternalPoint | null>;
+    protected readonly isHovering: _angular_core.WritableSignal<boolean>;
+    protected readonly containerWidth: _angular_core.WritableSignal<number>;
+    protected readonly containerHeight: _angular_core.WritableSignal<number>;
+    readonly svgWidth: _angular_core.Signal<number>;
+    readonly svgHeight: _angular_core.Signal<number>;
+    protected readonly padding: _angular_core.Signal<2 | 3 | 5>;
+    constructor();
+    private updateDimensions;
+    /** Host styles */
+    readonly hostWidth: _angular_core.Signal<string | null>;
+    readonly hostHeight: _angular_core.Signal<string | null>;
+    readonly computedAspectRatio: _angular_core.Signal<string | null>;
+    /** Normalized points array */
+    readonly normalizedPoints: _angular_core.Signal<SparklinePoint[]>;
+    /** Determine effective color palette */
+    readonly effectiveColor: _angular_core.Signal<{
+        stroke: string;
+        fillStart: string;
+        fillEnd: string;
+    }>;
+    /** Min & Max calculation */
+    readonly valueBounds: _angular_core.Signal<{
+        min: number;
+        max: number;
+        span: number;
+        rawMin: number;
+        rawMax: number;
+    }>;
+    /** Computed internal points with SVG coordinates */
+    readonly internalPoints: _angular_core.Signal<InternalPoint[]>;
+    /** SVG Path line data */
+    readonly linePath: _angular_core.Signal<string>;
+    /** SVG Area path (closed polygon under curve) */
+    readonly areaPath: _angular_core.Signal<string>;
+    /** Bar chart segments */
+    readonly barSegments: _angular_core.Signal<BarSegment[]>;
+    /** Highlight markers based on showMarkers input */
+    readonly markersToRender: _angular_core.Signal<InternalPoint[]>;
+    /** Reference baseline Y coordinate */
+    readonly referenceLineY: _angular_core.Signal<number | null>;
+    /** Aria label for accessibility */
+    readonly computedAriaLabel: _angular_core.Signal<string>;
+    /** Handle mouse move for interactive hover tracking */
+    protected onMouseMove(event: MouseEvent): void;
+    /** Handle mouse leave */
+    protected onMouseLeave(): void;
+    /** Handle point click */
+    protected onPointClick(point: InternalPoint | BarSegment): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosSparklineComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TalosSparklineComponent, "talos-sparkline", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "autoColorTrend": { "alias": "autoColorTrend"; "required": false; "isSignal": true; }; "smooth": { "alias": "smooth"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "markerRadius": { "alias": "markerRadius"; "required": false; "isSignal": true; }; "referenceValue": { "alias": "referenceValue"; "required": false; "isSignal": true; }; "showTooltip": { "alias": "showTooltip"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "barGap": { "alias": "barGap"; "required": false; "isSignal": true; }; "barRadius": { "alias": "barRadius"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "valueFormatter": { "alias": "valueFormatter"; "required": false; "isSignal": true; }; }, { "pointHover": "pointHover"; "pointClick": "pointClick"; }, never, never, true, never>;
+}
+
+declare class TalosSparklineModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TalosSparklineModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<TalosSparklineModule, never, [typeof TalosSparklineComponent], [typeof TalosSparklineComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<TalosSparklineModule>;
+}
+
+export { GOLDEN_RATIO, TalosCategoryBarComponent, TalosCategoryBarModule, TalosHeatmapComponent, TalosHeatmapModule, TalosMiniDonutComponent, TalosMiniDonutModule, TalosMiniGaugeComponent, TalosMiniGaugeModule, TalosSparklineComponent, TalosSparklineModule };
+export type { CategoryBarClickEvent, CategoryBarColorScheme, CategoryBarComputedSegment, CategoryBarLabelPosition, CategoryBarMarker, CategoryBarMarkerClickEvent, CategoryBarScaleLabel, CategoryBarSegment, CategoryBarSegmentClickEvent, CategoryBarShape, CategoryBarSize, ComputedDonutSegment, GaugeMarker, GaugeSize, GaugeThreshold, HeatmapCell, HeatmapCellClickEvent, HeatmapCellShape, HeatmapCellSize, HeatmapColorScheme, HeatmapDataInput, HeatmapDataPoint, HeatmapExportFormat, HeatmapInterval, HeatmapMatrixData, HeatmapMetric, HeatmapTimeFormat, HeatmapTimeRange, HeatmapTimestampData, MiniDonutColorScheme, MiniDonutLineCap, MiniDonutSegment, MiniDonutSize, MiniGaugeIndicator, MiniGaugeType, SparklineAspectRatio, SparklineColorScheme, SparklineHoverEvent, SparklineInputData, SparklineMarkerMode, SparklinePoint, SparklineSize, SparklineType };
+//# sourceMappingURL=weeehaoooz-talos-ui-data-viz.d.ts.map