@prismiq/react 0.1.0

package/dist/index-C-Qcuu4Y.d.cts

@@ -0,0 +1,821 @@
+import { Q as QueryResult, q as ColumnSelection } from './types-WrCbOeAV.cjs';
+
+/**
+ * Theme type definitions for Prismiq.
+ */
+/**
+ * Complete theme configuration for Prismiq components.
+ */
+interface PrismiqTheme {
+    /** Theme identifier name. */
+    name: string;
+    /** Color palette. */
+    colors: {
+        /** Primary brand color. */
+        primary: string;
+        /** Primary color on hover. */
+        primaryHover: string;
+        /** Page background color. */
+        background: string;
+        /** Surface/card background color. */
+        surface: string;
+        /** Surface color on hover. */
+        surfaceHover: string;
+        /** Primary text color. */
+        text: string;
+        /** Secondary/muted text color. */
+        textMuted: string;
+        /** Text color for use on primary backgrounds. */
+        textInverse: string;
+        /** Border color. */
+        border: string;
+        /** Border color when focused. */
+        borderFocus: string;
+        /** Success state color. */
+        success: string;
+        /** Warning state color. */
+        warning: string;
+        /** Error state color. */
+        error: string;
+        /** Info state color. */
+        info: string;
+    };
+    /** Font families. */
+    fonts: {
+        /** Sans-serif font stack. */
+        sans: string;
+        /** Monospace font stack for code. */
+        mono: string;
+    };
+    /** Font sizes. */
+    fontSizes: {
+        /** Extra small (10px). */
+        xs: string;
+        /** Small (12px). */
+        sm: string;
+        /** Base (14px). */
+        base: string;
+        /** Large (16px). */
+        lg: string;
+        /** Extra large (18px). */
+        xl: string;
+        /** 2x extra large (20px). */
+        '2xl': string;
+    };
+    /** Spacing values. */
+    spacing: {
+        /** Extra small (4px). */
+        xs: string;
+        /** Small (8px). */
+        sm: string;
+        /** Medium (12px). */
+        md: string;
+        /** Large (16px). */
+        lg: string;
+        /** Extra large (24px). */
+        xl: string;
+    };
+    /** Border radius values. */
+    radius: {
+        /** No radius (0). */
+        none: string;
+        /** Small radius (2px). */
+        sm: string;
+        /** Medium radius (4px). */
+        md: string;
+        /** Large radius (8px). */
+        lg: string;
+        /** Full/pill radius (9999px). */
+        full: string;
+    };
+    /** Box shadow values. */
+    shadows: {
+        /** Small shadow. */
+        sm: string;
+        /** Medium shadow. */
+        md: string;
+        /** Large shadow. */
+        lg: string;
+    };
+    /** Chart-specific theme values. */
+    chart: {
+        /** Color palette for chart series. */
+        colors: string[];
+        /** Grid line color. */
+        gridColor: string;
+        /** Axis line and label color. */
+        axisColor: string;
+        /** Tooltip background color. */
+        tooltipBackground: string;
+    };
+}
+/**
+ * Theme mode options.
+ */
+type ThemeMode = 'light' | 'dark' | 'system';
+/**
+ * Value provided by the ThemeContext.
+ */
+interface ThemeContextValue {
+    /** The currently active theme. */
+    theme: PrismiqTheme;
+    /** The current theme mode setting. */
+    mode: ThemeMode;
+    /** Function to change the theme mode. */
+    setMode: (mode: ThemeMode) => void;
+    /** The resolved mode (light or dark) after system detection. */
+    resolvedMode: 'light' | 'dark';
+}
+/**
+ * Deep partial type for theme customization.
+ */
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+/**
+ * Chart type definitions for Prismiq.
+ */
+
+/**
+ * A single data point in a chart.
+ */
+interface ChartDataPoint {
+    [key: string]: string | number | null;
+}
+/**
+ * A series of data for a chart.
+ */
+interface ChartSeries {
+    /** Series name (used in legend). */
+    name: string;
+    /** Data values for this series. */
+    data: (number | null)[];
+    /** Chart type for this series (for mixed charts). */
+    type?: 'bar' | 'line' | 'scatter' | 'pie';
+    /** Color override for this series. */
+    color?: string;
+}
+/**
+ * Cross-filter configuration for charts.
+ */
+interface CrossFilterConfig {
+    /** Enable cross-filtering on this chart. */
+    enabled: boolean;
+    /** Widget ID (required for cross-filtering). */
+    widgetId: string;
+    /** Column to filter on (defaults to xAxis). */
+    column?: string;
+    /** Table for the filter (optional). */
+    table?: string;
+}
+/**
+ * Base props shared by all chart components.
+ */
+interface BaseChartProps {
+    /** Chart data - either QueryResult or array of data points. */
+    data: QueryResult | ChartDataPoint[];
+    /** Whether the chart is loading. */
+    loading?: boolean;
+    /** Error to display. */
+    error?: Error | null;
+    /** Chart height. */
+    height?: number | string;
+    /** Chart width. */
+    width?: number | string;
+    /** Additional CSS class name. */
+    className?: string;
+    /** Callback when a data point is clicked. */
+    onDataPointClick?: (params: ChartClickParams) => void;
+    /** Cross-filter configuration. */
+    crossFilter?: CrossFilterConfig;
+    /** Currently selected value for cross-filter highlight. */
+    selectedValue?: string | number | null;
+}
+/**
+ * Parameters passed to data point click handler.
+ */
+interface ChartClickParams {
+    /** Name of the series that was clicked. */
+    seriesName: string;
+    /** Index of the data point in the series. */
+    dataIndex: number;
+    /** Value of the clicked data point. */
+    value: number | string;
+    /** Category/label name of the clicked point. */
+    name: string;
+}
+/**
+ * Configuration for a reference line on a chart.
+ */
+interface ReferenceLineConfig {
+    /** Value where the line should be drawn. */
+    value: number;
+    /** Label to display on the line. */
+    label?: string;
+    /** Line color. */
+    color?: string;
+    /** Line style. */
+    lineStyle?: 'solid' | 'dashed' | 'dotted';
+}
+/**
+ * Axis format types for value formatting.
+ */
+type AxisFormat = 'number' | 'currency' | 'percent' | 'compact';
+/**
+ * Legend position options.
+ */
+type LegendPosition = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Props for the base EChart wrapper component.
+ */
+interface EChartWrapperProps {
+    /** ECharts option configuration. */
+    option: Record<string, unknown>;
+    /** Whether the chart is loading. */
+    loading?: boolean;
+    /** Chart height. */
+    height?: number | string;
+    /** Chart width. */
+    width?: number | string;
+    /** Theme mode. */
+    theme?: 'light' | 'dark';
+    /** Event handlers - use unknown for params to allow any ECharts event. */
+    onEvents?: Record<string, (params: unknown) => void>;
+    /** Additional CSS class name. */
+    className?: string;
+}
+/**
+ * Props for BarChart component.
+ */
+interface BarChartProps extends BaseChartProps {
+    /** Column name for X axis categories. */
+    xAxis: string;
+    /** Column name(s) for Y axis values. */
+    yAxis: string | string[];
+    /** Bar orientation. */
+    orientation?: 'vertical' | 'horizontal';
+    /** Whether to stack bars. */
+    stacked?: boolean;
+    /** Whether to show data labels on bars. */
+    showDataLabels?: boolean;
+    /** Whether to show legend. */
+    showLegend?: boolean;
+    /** Legend position. */
+    legendPosition?: LegendPosition;
+    /** Reference lines to draw. */
+    referenceLines?: ReferenceLineConfig[];
+    /** Custom colors for series. */
+    colors?: string[];
+    /** X axis label. */
+    xAxisLabel?: string;
+    /** Y axis label. */
+    yAxisLabel?: string;
+    /** X axis date format (.NET format string like "MMM-yyyy" for date axes). */
+    xAxisFormat?: string;
+    /** Y axis value format. */
+    yAxisFormat?: AxisFormat;
+    /** Currency symbol for currency format. */
+    currencySymbol?: string;
+    /** Compact notation mode (K, M, B, T) or null for no compacting. */
+    compactNotation?: 'K' | 'M' | 'B' | 'T' | null;
+    /** Number of decimal digits. */
+    decimalDigits?: number;
+}
+/**
+ * Props for LineChart component.
+ */
+interface LineChartProps extends BaseChartProps {
+    /** Column name for X axis categories. */
+    xAxis: string;
+    /** Column name(s) for Y axis values. */
+    yAxis: string | string[];
+    /** Column name that defines series (for multi-series charts with long-format data). */
+    seriesColumn?: string;
+    /** Maximum number of series to display (top N by total value). Useful for charts with many series. */
+    maxSeries?: number;
+    /** Whether to use smooth/curved lines. */
+    smooth?: boolean;
+    /** Whether to show area fill under lines. */
+    showArea?: boolean;
+    /** Whether to show data point markers. */
+    showPoints?: boolean;
+    /** Whether to show data labels. */
+    showDataLabels?: boolean;
+    /** Whether to show legend. */
+    showLegend?: boolean;
+    /** Reference lines to draw. */
+    referenceLines?: ReferenceLineConfig[];
+    /** Custom colors for series. */
+    colors?: string[];
+    /** X axis label. */
+    xAxisLabel?: string;
+    /** Y axis label. */
+    yAxisLabel?: string;
+    /** X axis date format (.NET format string like "MMM-yyyy" for date axes). */
+    xAxisFormat?: string;
+    /** Y axis value format. */
+    yAxisFormat?: AxisFormat;
+}
+/**
+ * Props for AreaChart component.
+ */
+interface AreaChartProps extends BaseChartProps {
+    /** Column name for X axis categories. */
+    xAxis: string;
+    /** Column name(s) for Y axis values. */
+    yAxis: string | string[];
+    /** Whether to stack areas. */
+    stacked?: boolean;
+    /** Stack type - normal sum or 100% stacked. */
+    stackType?: 'normal' | 'percent';
+    /** Whether to use smooth/curved lines. */
+    smooth?: boolean;
+    /** Whether to show legend. */
+    showLegend?: boolean;
+    /** Area opacity (0-1). */
+    opacity?: number;
+    /** Custom colors for series. */
+    colors?: string[];
+    /** X axis label. */
+    xAxisLabel?: string;
+    /** Y axis label. */
+    yAxisLabel?: string;
+    /** X axis date format (.NET format string like "MMM-yyyy" for date axes). */
+    xAxisFormat?: string;
+}
+/**
+ * Props for PieChart component.
+ */
+interface PieChartProps extends BaseChartProps {
+    /** Column name for slice labels. */
+    labelColumn: string;
+    /** Column name for slice values. */
+    valueColumn: string;
+    /** Chart variant. */
+    variant?: 'pie' | 'donut';
+    /** Inner radius ratio for donut (0-1). */
+    donutRatio?: number;
+    /** Whether to show labels. */
+    showLabels?: boolean;
+    /** Label position. */
+    labelPosition?: 'inside' | 'outside';
+    /** Whether to show percentages in labels. */
+    showPercentage?: boolean;
+    /** Whether to show legend. */
+    showLegend?: boolean;
+    /** Custom colors for slices. */
+    colors?: string[];
+    /** Start angle in degrees. */
+    startAngle?: number;
+    /** How to sort slices. */
+    sortSlices?: 'asc' | 'desc' | 'none';
+    /** Label format (.NET format string like "MMM-yyyy" for date labels). */
+    labelFormat?: string;
+}
+/**
+ * Props for ScatterChart component.
+ */
+interface ScatterChartProps extends BaseChartProps {
+    /** Column name for X axis values. */
+    xAxis: string;
+    /** Column name for Y axis values. */
+    yAxis: string;
+    /** Column name for bubble size (makes it a bubble chart). */
+    sizeColumn?: string;
+    /** Column name for color coding points. */
+    colorColumn?: string;
+    /** Minimum point size. */
+    minSize?: number;
+    /** Maximum point size. */
+    maxSize?: number;
+    /** Whether to show labels on points. */
+    showLabels?: boolean;
+    /** Column to use for point labels. */
+    labelColumn?: string;
+    /** Whether to show a trendline. */
+    showTrendline?: boolean;
+    /** X axis label. */
+    xAxisLabel?: string;
+    /** Y axis label. */
+    yAxisLabel?: string;
+}
+/**
+ * Trend indicator configuration.
+ */
+interface TrendConfig {
+    /** Percent change value. */
+    value: number;
+    /** Trend direction. */
+    direction: 'up' | 'down' | 'flat';
+    /** Label for the trend (e.g., "vs last month"). */
+    label?: string;
+}
+/**
+ * Props for MetricCard component.
+ */
+interface MetricCardProps {
+    /** Metric title/label. */
+    title: string;
+    /** Metric value. */
+    value: number | string;
+    /** Value format. */
+    format?: 'number' | 'currency' | 'percent' | 'compact';
+    /** Currency symbol for currency format. */
+    currencySymbol?: string;
+    /** Number of decimal places. */
+    decimals?: number;
+    /** Compact notation (K, M, B, T) - works with currency format for values like $24.32M. */
+    compactNotation?: 'K' | 'M' | 'B' | 'T' | null;
+    /** Trend configuration. */
+    trend?: TrendConfig;
+    /** Which direction is considered positive (green). */
+    trendPositive?: 'up' | 'down';
+    /** Data for sparkline chart. */
+    sparklineData?: number[];
+    /** Sparkline color override. */
+    sparklineColor?: string;
+    /** Card size variant. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Whether the card is loading. */
+    loading?: boolean;
+    /** Whether to center the value (for single-number displays). */
+    centered?: boolean;
+    /** Additional CSS class name. */
+    className?: string;
+    /** Click handler. */
+    onClick?: () => void;
+}
+/**
+ * Options for useChartData hook.
+ */
+interface ChartDataOptions {
+    /** Column to use for X axis / categories. */
+    xColumn: string;
+    /** Column(s) to use for Y axis values. */
+    yColumns: string[];
+    /** Column to group by for multi-series. */
+    groupColumn?: string;
+    /** How to sort the data. */
+    sortBy?: 'x' | 'y' | 'none';
+    /** Sort direction. */
+    sortDirection?: 'asc' | 'desc';
+    /** Maximum number of data points. */
+    limit?: number;
+}
+/**
+ * Result from useChartData hook.
+ */
+interface ChartDataResult {
+    /** Category labels for X axis. */
+    categories: string[];
+    /** Series data for charting. */
+    series: ChartSeries[];
+    /** Whether the data is empty. */
+    isEmpty: boolean;
+    /** Total number of rows in source data. */
+    totalRows: number;
+}
+/**
+ * Available chart types.
+ */
+type ChartType = 'bar' | 'line' | 'area' | 'pie' | 'scatter' | 'metric';
+/**
+ * A chart type suggestion.
+ */
+interface ChartSuggestion {
+    /** Suggested chart type. */
+    type: ChartType;
+    /** Confidence score (0-1). */
+    confidence: number;
+    /** Human-readable reason for the suggestion. */
+    reason: string;
+    /** Suggested configuration for the chart. */
+    config: Record<string, unknown>;
+}
+
+/**
+ * Base wrapper component for ECharts integration.
+ */
+
+/**
+ * Base chart wrapper that handles theme integration, loading states,
+ * and event handling for all Prismiq charts.
+ */
+declare function EChartWrapper({ option, loading, height, width, theme: themeOverride, onEvents, className, }: EChartWrapperProps): JSX.Element;
+
+/**
+ * MetricCard component for displaying KPIs.
+ */
+
+/**
+ * A card component for displaying key metrics with optional trend and sparkline.
+ *
+ * @example
+ * ```tsx
+ * <MetricCard
+ *   title="Revenue"
+ *   value={1234567}
+ *   format="currency"
+ *   trend={{ value: 12.5, direction: 'up', label: 'vs last month' }}
+ *   sparklineData={[100, 120, 115, 130, 145, 160]}
+ * />
+ * ```
+ */
+declare function MetricCard({ title, value, format, currencySymbol, decimals, compactNotation, trend, trendPositive, sparklineData, sparklineColor, size, loading, centered, className, onClick, }: MetricCardProps): JSX.Element;
+
+/**
+ * Trend indicator component for MetricCard.
+ */
+
+interface TrendIndicatorProps {
+    /** Trend configuration. */
+    trend: TrendConfig;
+    /** Which direction is considered positive (green). */
+    trendPositive?: 'up' | 'down';
+    /** Size variant. */
+    size?: 'sm' | 'md' | 'lg';
+}
+/**
+ * Displays a trend arrow with percentage change.
+ */
+declare function TrendIndicator({ trend, trendPositive, size, }: TrendIndicatorProps): JSX.Element;
+
+/**
+ * Sparkline component for MetricCard.
+ */
+interface SparklineProps {
+    /** Data points for the sparkline. */
+    data: number[];
+    /** Line/area color override. */
+    color?: string;
+    /** Height of the sparkline. */
+    height?: number;
+    /** Width of the sparkline. */
+    width?: number | string;
+}
+/**
+ * A minimal line chart for showing trends in a small space.
+ */
+declare function Sparkline({ data, color, height, width, }: SparklineProps): JSX.Element | null;
+
+/**
+ * BarChart component for Prismiq.
+ */
+
+/**
+ * A bar chart component with support for vertical/horizontal orientation,
+ * stacking, multi-series, and reference lines.
+ *
+ * @example
+ * ```tsx
+ * <BarChart
+ *   data={queryResult}
+ *   xAxis="month"
+ *   yAxis={["revenue", "cost"]}
+ *   orientation="vertical"
+ *   stacked={false}
+ *   showDataLabels={true}
+ *   referenceLines={[{ value: 100000, label: "Target" }]}
+ * />
+ * ```
+ */
+declare function BarChart({ data, xAxis, yAxis, orientation, stacked, showDataLabels, showLegend, legendPosition, referenceLines, colors, xAxisLabel, yAxisLabel, xAxisFormat, yAxisFormat, currencySymbol, compactNotation, decimalDigits, loading, error, height, width, className, onDataPointClick, crossFilter, selectedValue, }: BarChartProps): JSX.Element;
+
+/**
+ * LineChart component for Prismiq.
+ */
+
+/**
+ * A line chart component with support for smooth curves, area fill,
+ * multi-series, and reference lines.
+ *
+ * @example
+ * ```tsx
+ * <LineChart
+ *   data={queryResult}
+ *   xAxis="date"
+ *   yAxis={["revenue", "cost"]}
+ *   smooth={true}
+ *   showArea={true}
+ *   showPoints={true}
+ * />
+ * ```
+ */
+declare function LineChart({ data, xAxis, yAxis, seriesColumn, maxSeries, smooth, showArea, showPoints, showDataLabels, showLegend, referenceLines, colors, xAxisLabel, yAxisLabel, xAxisFormat, yAxisFormat, loading, error, height, width, className, onDataPointClick, crossFilter, selectedValue, }: LineChartProps): JSX.Element;
+
+/**
+ * AreaChart component for Prismiq.
+ */
+
+/**
+ * An area chart component with support for stacking and 100% stacking.
+ *
+ * @example
+ * ```tsx
+ * <AreaChart
+ *   data={queryResult}
+ *   xAxis="date"
+ *   yAxis={["category_a", "category_b", "category_c"]}
+ *   stacked={true}
+ *   stackType="percent"
+ *   smooth={true}
+ * />
+ * ```
+ */
+declare function AreaChart({ data, xAxis, yAxis, stacked, stackType, smooth, showLegend, opacity, colors, xAxisLabel, yAxisLabel, xAxisFormat, loading, error, height, width, className, onDataPointClick, crossFilter, selectedValue, }: AreaChartProps): JSX.Element;
+
+/**
+ * PieChart component for Prismiq.
+ */
+
+/**
+ * A pie/donut chart component.
+ *
+ * @example
+ * ```tsx
+ * <PieChart
+ *   data={queryResult}
+ *   labelColumn="category"
+ *   valueColumn="amount"
+ *   variant="donut"
+ *   showPercentage={true}
+ *   showLabels={true}
+ * />
+ * ```
+ */
+declare function PieChart({ data, labelColumn, valueColumn, variant, donutRatio, showLabels, labelPosition, showPercentage, showLegend, colors, startAngle, sortSlices, loading, error, height, width, className, onDataPointClick, crossFilter, selectedValue, labelFormat, }: PieChartProps): JSX.Element;
+
+/**
+ * ScatterChart component for Prismiq.
+ */
+
+/**
+ * A scatter/bubble chart component.
+ *
+ * @example
+ * ```tsx
+ * <ScatterChart
+ *   data={queryResult}
+ *   xAxis="revenue"
+ *   yAxis="profit"
+ *   sizeColumn="market_cap"
+ *   colorColumn="sector"
+ *   showTrendline={true}
+ * />
+ * ```
+ */
+declare function ScatterChart({ data, xAxis, yAxis, sizeColumn, colorColumn, minSize, maxSize, showLabels, labelColumn, showTrendline, xAxisLabel, yAxisLabel, loading, error, height, width, className, onDataPointClick, }: ScatterChartProps): JSX.Element;
+
+/**
+ * Auto-suggest utility for recommending chart types based on data.
+ */
+
+/**
+ * Suggests the best chart types for a given query result and column selections.
+ *
+ * Rules:
+ * - Single numeric value -> MetricCard
+ * - Date + numeric -> Line/Area chart
+ * - Category + numeric -> Bar chart
+ * - Category + numeric (few categories <= 7) -> Pie chart
+ * - Two numerics -> Scatter chart
+ * - Multiple numerics, no date -> Grouped bar chart
+ *
+ * @param result - The query result to analyze
+ * @param columns - The selected columns
+ * @returns Array of chart suggestions sorted by confidence
+ *
+ * @example
+ * ```tsx
+ * const suggestions = suggestChartType(queryResult, [
+ *   { table_id: 't1', column: 'month', aggregation: 'none' },
+ *   { table_id: 't1', column: 'revenue', aggregation: 'sum' },
+ * ]);
+ * // Returns [{ type: 'bar', confidence: 0.9, reason: '...', config: {...} }]
+ * ```
+ */
+declare function suggestChartType(result: QueryResult, columns: ColumnSelection[]): ChartSuggestion[];
+
+/**
+ * Chart utility functions for Prismiq.
+ */
+
+/**
+ * Converts a QueryResult to chart-ready data format.
+ *
+ * @param result - The query result to transform
+ * @param xColumn - Column name for X axis / categories
+ * @param yColumns - Column names for Y axis values (creates multiple series)
+ * @returns Object with categories and series arrays
+ */
+declare function queryResultToChartData(result: QueryResult, xColumn: string, yColumns: string[], seriesColumn?: string): {
+    categories: string[];
+    series: ChartSeries[];
+};
+/**
+ * Converts an array of data points to chart-ready format.
+ *
+ * @param data - Array of data points
+ * @param xColumn - Property name for X axis
+ * @param yColumns - Property names for Y axis values
+ * @param seriesColumn - Optional column that defines series (for long-format data)
+ * @returns Object with categories and series arrays
+ */
+declare function dataPointsToChartData(data: ChartDataPoint[], xColumn: string, yColumns: string[], seriesColumn?: string): {
+    categories: string[];
+    series: ChartSeries[];
+};
+/**
+ * Determines if data is a QueryResult.
+ */
+declare function isQueryResult(data: QueryResult | ChartDataPoint[]): data is QueryResult;
+/**
+ * Converts chart data (QueryResult or ChartDataPoint[]) to chart-ready format.
+ */
+declare function toChartData(data: QueryResult | ChartDataPoint[], xColumn: string, yColumns: string[], seriesColumn?: string): {
+    categories: string[];
+    series: ChartSeries[];
+};
+/**
+ * Creates an ECharts theme object from a Prismiq theme.
+ *
+ * @param theme - Prismiq theme
+ * @returns ECharts theme configuration object
+ */
+declare function createChartTheme(theme: PrismiqTheme): Record<string, unknown>;
+/**
+ * Applies theme styling to an existing ECharts option.
+ *
+ * @param option - ECharts option object
+ * @param theme - Prismiq theme
+ * @returns Modified option with theme applied
+ */
+declare function applyThemeToOption(option: Record<string, unknown>, theme: PrismiqTheme): Record<string, unknown>;
+/**
+ * Formats a number value for display on an axis.
+ *
+ * @param value - The number to format
+ * @param format - The format type
+ * @param options - Additional formatting options
+ * @returns Formatted string
+ */
+declare function formatAxisLabel(value: number, format: AxisFormat, options?: {
+    currencySymbol?: string;
+    decimals?: number;
+    compactNotation?: 'K' | 'M' | 'B' | 'T' | null;
+}): string;
+/**
+ * Formats a number in compact notation (K, M, B).
+ */
+declare function formatCompact(value: number, decimals?: number): string;
+/**
+ * Formats a metric value for display in a MetricCard.
+ *
+ * @param value - The numeric value to format
+ * @param format - Format type: 'number', 'currency', 'percent', or 'compact'
+ * @param options - Formatting options
+ * @param options.currencySymbol - Currency symbol (default: '$')
+ * @param options.decimals - Number of decimal places (default: 0)
+ * @param options.compactNotation - Compact notation: 'K', 'M', 'B', or 'T' (applies to currency too)
+ */
+declare function formatMetricValue(value: number | string, format?: 'number' | 'currency' | 'percent' | 'compact', options?: {
+    currencySymbol?: string;
+    decimals?: number;
+    compactNotation?: 'K' | 'M' | 'B' | 'T' | null;
+}): string;
+/**
+ * Gets an array of colors from the theme, cycling if needed.
+ *
+ * @param theme - Prismiq theme
+ * @param count - Number of colors needed
+ * @returns Array of color strings
+ */
+declare function getChartColors(theme: PrismiqTheme, count: number): string[];
+/**
+ * Generates a gradient color specification for ECharts.
+ */
+declare function createGradientColor(color: string, opacity?: number): Record<string, unknown>;
+/**
+ * Adjusts the opacity of a hex color.
+ */
+declare function adjustColorOpacity(hexColor: string, opacity: number): string;
+/**
+ * Creates ECharts markLine configuration from reference line configs.
+ */
+declare function createMarkLines(lines: {
+    value: number;
+    label?: string;
+    color?: string;
+    lineStyle?: 'solid' | 'dashed' | 'dotted';
+}[], theme: PrismiqTheme): Record<string, unknown>;
+/**
+ * Checks if chart data is empty.
+ */
+declare function isChartDataEmpty(data: QueryResult | ChartDataPoint[]): boolean;
+/**
+ * Creates an ECharts graphic config for empty state.
+ */
+declare function createEmptyStateGraphic(message?: string): Record<string, unknown>;
+
+export { AreaChart as A, BarChart as B, type ChartDataOptions as C, type DeepPartial as D, EChartWrapper as E, type AreaChartProps as F, type PieChartProps as G, type ScatterChartProps as H, type TrendConfig as I, type MetricCardProps as J, type TrendIndicatorProps as K, LineChart as L, MetricCard as M, type SparklineProps as N, type ChartType as O, type PrismiqTheme as P, type ChartSuggestion as Q, type ReferenceLineConfig as R, Sparkline as S, type ThemeMode as T, isQueryResult as U, adjustColorOpacity as V, createMarkLines as W, createEmptyStateGraphic as X, type ThemeContextValue as a, type ChartDataResult as b, TrendIndicator as c, PieChart as d, ScatterChart as e, dataPointsToChartData as f, createChartTheme as g, applyThemeToOption as h, formatAxisLabel as i, formatCompact as j, formatMetricValue as k, getChartColors as l, createGradientColor as m, isChartDataEmpty as n, type ChartDataPoint as o, type ChartSeries as p, queryResultToChartData as q, type BaseChartProps as r, suggestChartType as s, toChartData as t, type ChartClickParams as u, type AxisFormat as v, type LegendPosition as w, type EChartWrapperProps as x, type BarChartProps as y, type LineChartProps as z };