/**
 * Chart Organism Component
 *
 * Data visualization. Supports bar / line / pie / area / donut / scatter /
 * histogram chart types. Renders multi-series natively for bar / line / area
 * via the `series` prop. Pie / donut consume the first series only. Scatter
 * plots raw {x,y} points; histogram renders pre-binned data as gap-less bars.
 *
 * Bus integration:
 *  - top-level `actions[].event` → `UI:{event}` on click (existing behavior)
 *  - per-data-point `drillEvent` → `UI:{drillEvent}` with `{ label, value, seriesLabel? }`
 *
 * Time axis: when `timeAxis: true`, ISO date labels are formatted via Intl
 * (e.g. "Mar 2026"). Positioning remains evenly spaced (real time-scale
 * alignment is deliberately deferred).
 */
import React from "react";
export type ChartType = "bar" | "line" | "pie" | "area" | "donut" | "scatter" | "histogram";
export type ChartStackMode = "none" | "stack" | "normalize";
export interface ChartDataPoint {
    label: string;
    value: number;
    color?: string;
}
export interface ChartScatterPoint {
    x: number;
    y: number;
    label?: string;
    size?: number;
    color?: string;
}
export interface ChartSeries {
    name: string;
    data: readonly ChartDataPoint[];
    color?: string;
    dashed?: boolean;
}
export interface ChartAction {
    label: string;
    event?: string;
    navigatesTo?: string;
    variant?: "primary" | "secondary" | "ghost";
}
export interface ChartProps {
    /** Chart title */
    title?: string;
    /** Chart subtitle / description */
    subtitle?: string;
    /** Chart type */
    chartType?: ChartType;
    /** Multi-series data */
    series?: readonly ChartSeries[];
    /** Simple single-series shorthand (bar/line/pie/area/donut/histogram) */
    data?: readonly ChartDataPoint[];
    /** Raw {x,y} points for scatter */
    scatterData?: readonly ChartScatterPoint[];
    /** Chart height in px */
    height?: number;
    /** Show legend */
    showLegend?: boolean;
    /** Show values on chart */
    showValues?: boolean;
    /** Stack mode for bar / area */
    stack?: ChartStackMode;
    /** Format X-axis labels as time (ISO date in → "Mar 2026"-style label out) */
    timeAxis?: boolean;
    /** Event name emitted as `UI:{drillEvent}` with `{ label, value, seriesLabel? }` on data-point click */
    drillEvent?: string;
    /** Top-level chart actions (export, refresh, etc.) */
    actions?: readonly ChartAction[];
    /** Entity name for schema-driven auto-fetch */
    entity?: string;
    /** Loading state */
    isLoading?: boolean;
    /** Error state */
    error?: Error | null;
    /** Additional CSS classes */
    className?: string;
}
export declare const Chart: React.FC<ChartProps>;
