/**
 * Configuration for a single axis drop zone in the chart configuration UI
 */
export interface AxisDropZoneConfig {
    /** The key to store this field in chartConfig (e.g., 'xAxis', 'yAxis', 'sizeField') */
    key: string;
    /** Display label for the drop zone */
    label: string;
    /** Optional description/help text shown below the label */
    description?: string;
    /** Whether at least one field is required in this drop zone */
    mandatory?: boolean;
    /** Maximum number of items allowed in this drop zone */
    maxItems?: number;
    /** Which field types this drop zone accepts */
    acceptTypes?: ('dimension' | 'timeDimension' | 'measure')[];
    /** Placeholder text when drop zone is empty */
    emptyText?: string;
    /** Enable L/R axis toggle for items in this drop zone (for dual Y-axis support) */
    enableDualAxis?: boolean;
}
/**
 * Configuration for a single display option
 */
export interface DisplayOptionConfig {
    /** The key to store this field in displayConfig */
    key: string;
    /** Display label for the option */
    label: string;
    /** Type of input control to render */
    type: 'boolean' | 'string' | 'number' | 'select' | 'color' | 'paletteColor' | 'axisFormat' | 'stringArray' | 'buttonGroup';
    /** Default value for the option */
    defaultValue?: any;
    /** Placeholder text for string/number inputs */
    placeholder?: string;
    /** Options for select type */
    options?: Array<{
        value: any;
        label: string;
    }>;
    /** Help text shown below the input */
    description?: string;
    /** Minimum value for number inputs */
    min?: number;
    /** Maximum value for number inputs */
    max?: number;
    /** Step value for number inputs */
    step?: number;
}
/**
 * Whether a chart type can be rendered with the current query shape.
 * Each chart's .config.ts declares its own `isAvailable` to keep requirements
 * co-located with the chart itself (rather than in a central switch).
 */
export interface ChartAvailability {
    /** Whether the chart type can be used with the current selections */
    available: boolean;
    /** Translation key explaining why the chart is unavailable (for tooltip) */
    reason?: string;
}
/**
 * Snapshot of the current query shape passed to each chart's `isAvailable`.
 */
export interface ChartAvailabilityContext {
    /** Number of measures selected */
    measureCount: number;
    /**
     * Number of dimension-like breakdowns (regular dimensions + time dimensions).
     * A time dimension can serve any role a regular dimension does (categories,
     * axes, heatmap rows/columns, pie slices, etc.), so they are counted together.
     */
    dimensionCount: number;
    /**
     * Number of time dimensions specifically. Only needed by charts that *require*
     * a time dimension (e.g. activityGrid).
     */
    timeDimensionCount: number;
}
/**
 * Configuration for which elements in a chart support clicking (for drill-down)
 */
export interface ClickableElementsConfig {
    /** Bars in bar charts */
    bar?: boolean;
    /** Points/dots in line/scatter charts */
    point?: boolean;
    /** Slices in pie/donut charts */
    slice?: boolean;
    /** Cells in heatmaps */
    cell?: boolean;
    /** Nodes in treemaps, sankey diagrams */
    node?: boolean;
    /** Areas in area charts */
    area?: boolean;
    /** Rows in data tables */
    row?: boolean;
}
/**
 * Complete configuration for a chart type
 */
export interface ChartTypeConfig {
    /** Display label for the chart type in the picker (e.g., 'Bar Chart', 'KPI Number') */
    label?: string;
    /** Configuration for each drop zone */
    dropZones: AxisDropZoneConfig[];
    /** Simple display options (backward compatibility) - rendered as boolean checkboxes */
    displayOptions?: string[];
    /** Structured display options with metadata for different input types */
    displayOptionsConfig?: DisplayOptionConfig[];
    /** Optional custom validation function */
    validate?: (config: any) => {
        isValid: boolean;
        message?: string;
    };
    /** Brief description of the chart */
    description?: string;
    /** When to use this chart type */
    useCase?: string;
    /** Whether this chart type skips query requirements (for content-based charts like markdown) */
    skipQuery?: boolean;
    /** Configuration for which elements support clicking (for drill-down) */
    clickableElements?: ClickableElementsConfig;
    /**
     * Whether this chart type can render with the given query shape.
     * Omit to mean "always available".
     */
    isAvailable?: (ctx: ChartAvailabilityContext) => ChartAvailability;
}
/**
 * Registry of all chart type configurations
 */
export interface ChartConfigRegistry {
    [chartType: string]: ChartTypeConfig;
}
/**
 * Default configuration for charts without specific requirements
 */
export declare const defaultChartConfig: ChartTypeConfig;
/**
 * Helper function to get configuration for a chart type
 */
export declare function getChartConfig(chartType: string, registry: ChartConfigRegistry): ChartTypeConfig;