import { type IColor, type IColorPalette, type ISeparators, type Identifier } from "@gooddata/sdk-model";
import { type IDrillEventIntersectionElement, type VisType } from "@gooddata/sdk-ui";
import { type IChartFillConfig, type IColorMapping } from "@gooddata/sdk-ui-vis-commons";
import { type IComparison } from "./comparison.js";
/**
 * Chart config is used to customize visual aspects of the different charts.
 *
 * @remarks
 * At the moment, a single structure is used for all the charts - however not all options are applicable to all charts.
 *
 * As is, using the not-applicable option for a chart will be ignored. Going forward, we will add warnings to
 * notify developers that the option has no effect.
 *
 * Note: some properties of the chart config leak unnecessary implementation detail and should not be used. These
 * properties are marked as internal.
 *
 * @public
 */
export interface IChartConfig {
    /**
     * Customize what separators to use between different segments of formatted numbers (thousands, decimals etc).
     */
    separators?: ISeparators;
    /**
     * Specify list of colors (#rrggbb) to use when coloring the chart.
     */
    colors?: string[];
    /**
     * Specify color palette to use when coloring the chart.
     *
     * @remarks
     * Note: The color palette is the primary way to specify the colors. If you specify both `colorPalette` and `colors`,
     * then colorPalette will be used.
     */
    colorPalette?: IColorPalette;
    /**
     * Specify custom coloring.
     *
     * @remarks
     * This is done using (predicate, color) pairs. The different entities to chart (e.g.
     * data point, or a measure slice for particular attribute value) will be evaluated against the predicates. The color
     * will be associated in first-found approach.
     */
    colorMapping?: IColorMapping[];
    /**
     * Configure how legend appears and behaves.
     */
    legend?: ILegendConfig;
    /**
     * Configure for the total column of Waterfall chart.
     */
    total?: ITotalConfig;
    /**
     * Configure whether legend items should be laid-out vertically (column legend) or horizontally (line legend).
     */
    legendLayout?: "vertical" | "horizontal";
    /**
     * Configure chart grid.
     */
    grid?: IGridConfig;
    /**
     * Configure chart continuous line.
     */
    continuousLine?: IContinuousLineConfig;
    /**
     * Configure distinct point shapes for line-based charts.
     * @beta
     */
    distinctPointShapes?: IDistinctPointShapes;
    /**
     * Customize format string to use for numeric tics on the X axis.
     */
    xFormat?: string;
    /**
     * Customize name of the x axis
     */
    xLabel?: string;
    /**
     * Customize format string to use for numeric tics on the Y axis.
     *
     * @remarks
     * The format string conventions are exact same as when formatting measure values.
     */
    yFormat?: string;
    /**
     * Customize name of the y axis
     */
    yLabel?: string;
    /**
     * Customize visibility of the primary X axis, what should be on the primary X axis and how it should look like.
     */
    xaxis?: IAxisConfig;
    /**
     * Customize visibility of the primary Y axis, what should be on the primary Y axis and how it should look like.
     */
    yaxis?: IAxisConfig;
    /**
     * Customize visibility of the secondary X axis, what should be on the secondary X axis and how it should look like.
     */
    secondary_xaxis?: IAxisConfig;
    /**
     * Customize visibility of the secondary Y axis, what should be on the secondary Y axis and how it should look like.
     */
    secondary_yaxis?: IAxisConfig;
    /**
     * Customize visibility of the data labels.
     *
     * @remarks
     * Data Labels typically appear within chart (e.g. next to a bar, inside a pie slice)
     */
    dataLabels?: IDataLabelsConfig;
    /**
     * Customize visibility of the data points.
     *
     * @remarks
     * Data points mark non-extrapolated data in "continuous" charts like line chart, area chart and combo chart made up of these two.
     */
    dataPoints?: IDataPointsConfig;
    /**
     * This turns on dual axis support for ComboChart visualization.
     *
     * @remarks
     * Applicable for ComboChart only. When combo chart specifies both primary and secondary measures, it is by default
     * treated as dual-axis chart. Both primary and secondary axis will be visible.
     *
     * To turn the secondary axis off for ComboChart, set dualAxis: false
     */
    dualAxis?: boolean;
    /**
     * Sets the chart type for primary measures.
     *
     * @remarks
     * Applicable for ComboChart only. Specify type of chart to use for primary measures.
     */
    primaryChartType?: "line" | "column" | "area";
    /**
     * Sets the chart type for secondary measures.
     *
     * @remarks
     * Applicable for ComboChart only. Specify type of chart to use for secondary measures.
     */
    secondaryChartType?: "line" | "column" | "area";
    /**
     * Applicable for Area, Bar, Column and Combo charts which have more than one measure.
     *
     * @remarks
     * For Area chart, this is on by default. If disables, the areas will overall.
     * For Bar and Column charts, this is off by default and each measure has its own bar or column.
     * For Combo, only measures assigned to the left (primary) axis will be stacked.
     */
    stackMeasures?: boolean;
    /**
     * This turns on measure stacking and client-side calculation of percentage contribution.
     *
     * @remarks
     * Applicable for Area, Bar, Column and Combo charts which have more than one measure.
     *
     * This option has preference over the `stackMeasures` option.
     */
    stackMeasuresToPercent?: boolean;
    /**
     * Disables drilling by clicking on axis labels.
     *
     * @remarks
     * When drilling is configured for a chart, users can click either the charted entities (data points, bars, columns etc)
     * or labels on the axes. This setting an be used to disable clicks on the drillable labels on axes.
     */
    forceDisableDrillOnAxes?: boolean;
    /**
     * Disable underlining of drillable items.
     *
     * @remarks
     * Any label or text that is drillable and can be clicked is by default underlined. Set this option to true to
     * disable underlining.
     */
    disableDrillUnderline?: boolean;
    /**
     * Allow zooming and panning in a chart.
     *
     * @remarks
     * When this option is enabled, we will prepare some configs for the 'chart' option to allow the chart can be zooming/panning.
     */
    zoomInsight?: boolean;
    /**
     * Enables more compact rendering of visualization in small containers.
     *
     * @remarks
     * Note: this property might not be supported in all the visualizations.
     *
     */
    enableCompactSize?: boolean;
    /**
     * Enable attribute axis name for the column, bar and bullet charts when view by many attributes.
     */
    enableJoinedAttributeAxisName?: boolean;
    /**
     * Enables custom sorting of visualizations.
     *
     * @remarks
     * Note: this property might not be supported in all the visualizations.
     *
     */
    enableChartSorting?: boolean;
    /**
     * Enables change order of stacked items in bar chart.
     */
    enableReversedStacking?: boolean;
    enableSeparateTotalLabels?: boolean;
    /**
     * Enables accessible tooltip for the chart.
     */
    enableAccessibleTooltip?: boolean;
    /**
     * This configuration allows users to customize how the comparative measure looks.
     *
     * @remarks
     * Note: currently, this property only supports headlines.
     */
    comparison?: IComparison;
    /**
     * Do not use this. Instead use stackMeasures and/or stackMeasuresToPercent
     * @internal
     */
    stacking?: boolean;
    /**
     * Options passed directly to Highcharts constructor (ChartOptions type)
     *
     * @internal
     */
    chart?: any;
    /**
     * @internal
     */
    limits?: IChartLimits;
    /**
     * @internal
     */
    type?: VisType;
    /**
     * @internal
     */
    tooltip?: ITooltipConfig;
    /**
     * The orientation of the chart
     * @internal
     */
    orientation?: IOrientationConfig;
    /**
     * Disable the drill down attribute hierarchies for the chart
     * @internal
     */
    disableDrillDown?: boolean;
    /**
     * Use generic interaction tooltip that may include multiple actions
     * @internal
     */
    useGenericInteractionTooltip?: boolean;
    /**
     * Selected points to be highlighted defined by drill event intersections.
     * @internal
     */
    selectedPoints?: IDrillEventIntersectionElement[][];
    /**
     * Configuration specific for hyperlinks in the chart.
     * @beta
     */
    hyperLinks?: IDisplayFormHyperlinksConfig;
    /**
     * Configuration of row height of the chart.
     * @beta
     */
    rowHeight?: ChartRowHeight;
    /**
     * Configuration of the vertical chart alignment.
     * @beta
     */
    cellVerticalAlign?: ChartCellVerticalAlign;
    /**
     * Configuration of the text wrapping in the chart.
     * @beta
     */
    cellTextWrapping?: ChartCellTextWrapping;
    /**
     * Configuration of the image sizing in the chart.
     * @beta
     */
    cellImageSizing?: ChartCellImageSizing;
    /**
     * Configuration of the inline visualizations.
     * @beta
     */
    inlineVisualizations?: IInlineVisualizationsConfig;
    /**
     * Configuration of the forecast.
     * @beta
     */
    forecast?: IForecast;
    /**
     * Configuration of the anomalies.
     * @beta
     */
    anomalies?: IAnomalies;
    /**
     * Configuration of the clustering.
     * @beta
     */
    clustering?: IChartClusteringConfig;
    /**
     * Temporary configuration for charts to use proper alias for attribute label
     * @internal
     */
    enableAliasAttributeLabel?: boolean;
    /**
     * User provided override of the HighChart configuration.
     * @internal
     */
    chartConfigOverride?: string;
    /**
     * Temporary configuration to enable fine-tuning of visualizations, i.e., usage of chartConfigOverride
     * value during the charts rendering.
     * @internal
     */
    enableVisualizationFineTuning?: boolean;
    /**
     * Whether to enable execution cancelling.
     * @internal
     */
    enableExecutionCancelling?: boolean;
    /**
     * Whether to enable accessibility features in Highcharts visualizations.
     * @internal
     */
    enableHighchartsAccessibility?: boolean;
    /**
     * Determine if support for a configurable trend threshold measure should be enabled for a line
     * chart visualization. The flag enables the usage of thresholdMeasures visualization property.
     * @internal
     */
    enableLineChartTrendThreshold?: boolean;
    /**
     * Local identifier of measures that are used to render thresholds in the line and combo chart.
     * Currently only the one threshold measure is supported.
     * Requires enableLineChartTrendThreshold to be true to be applied.
     */
    thresholdMeasures?: string[];
    /**
     * Local identifier of measures that should not be affected by thresholdMeasures config.
     */
    thresholdExcludedMeasures?: string[];
    /**
     * Legend positioning is not respected in some contexts. This flag enforces the specific
     * legend position to be respected in all contexts.
     */
    respectLegendPosition?: boolean;
    /**
     * Specify the accessibility title. Requires enableHighchartsAccessibility FF.
     *
     * @internal
     */
    a11yTitle?: string;
    /**
     * Specify the accessibility description. Requires enableHighchartsAccessibility FF.
     *
     * @internal
     */
    a11yDescription?: string;
    /**
     * Configuration of the chart fill.
     */
    chartFill?: IChartFillConfig;
    /**
     * Whether the chart supports configurable chart fill.
     */
    supportsChartFill?: boolean;
    /**
     * Enables single series mode for bubble charts.
     *
     * @remarks
     * When enabled, all data points will be rendered as a single series instead of multiple series.
     * This can be useful for performance optimization with large datasets or when all bubbles
     * should be treated as a unified dataset.
     *
     * Default: false (multiple series mode)
     *
     * @beta
     */
    enableSingleBubbleSeries?: boolean;
}
/**
 * @beta
 * Forecast configuration
 */
export interface IChartClusteringConfig {
    /**
     * Indicates whether the clustering is enabled or not.
     */
    enabled: boolean;
    /**
     * Number of clusters.
     */
    numberOfClusters: number;
    /**
     * Threshold for clustering.
     */
    threshold?: number;
}
/**
 * @beta
 * Forecast configuration
 */
export interface IForecast {
    /**
     * @beta
     * Indicates whether the forecast is enabled or not.
     */
    enabled: boolean;
    /**
     * @beta
     * Indicates the confidence level of the forecast.
     * The value should be between (0, 1).
     */
    confidence: number;
    /**
     * @beta
     * Indicates the number of periods to forecast.
     */
    period: number;
    /**
     * @beta
     * Indicates whether the forecast is seasonal or not.
     */
    seasonal: boolean;
}
/**
 * @beta
 * Anomalies configuration
 */
export interface IAnomalies {
    /**
     * @beta
     * Indicates whether the forecast is enabled or not.
     */
    enabled: boolean;
    /**
     * @beta
     * Sensitivity of anomalies detection.
     */
    sensitivity: "low" | "medium" | "high";
    /**
     * @beta
     * Size if point
     */
    size: "small" | "medium" | "big";
    /**
     * @beta
     * Color of point
     *
     * @defaultValue rgb(255, 0, 0)
     */
    color: IColor;
}
/**
 * @beta
 */
export interface IInlineVisualizationsConfig {
    /**
     * Measure local identifier
     */
    [localIdentifier: string]: {
        /**
         * Visualization type
         */
        type: ChartInlineVisualizationType;
    };
}
/**
 * Possible types of the inline visualizations.
 * @beta
 */
export type ChartInlineVisualizationType = "metric" | "line" | "column";
/**
 * Row height configuration for the chart.
 * @beta
 */
export type ChartRowHeight = "small" | "medium" | "large";
/**
 * Vertical alignment configuration for the chart.
 * @beta
 */
export type ChartCellVerticalAlign = "top" | "middle" | "bottom";
/**
 * Text wrapping configuration for the chart.
 * @beta
 */
export type ChartCellTextWrapping = "clip" | "wrap";
/**
 * Image sizing configuration for the chart.
 * @beta
 */
export type ChartCellImageSizing = "fit" | "fill";
/**
 * Customize behavior of the hyperlink display forms in the chart.
 *
 * @beta
 */
export interface IDisplayFormHyperlinksConfig {
    /**
     * Hyperlink display form local identifier
     */
    [displayFormLocalIdentifier: string]: {
        /**
         * Custom hyperlink text to display for the elements of the display form.
         */
        staticElementsText: string;
    };
}
/**
 * @public
 */
export interface IGridConfig {
    enabled?: boolean;
}
/**
 * Chart orientation config
 *
 * @public
 */
export interface IOrientationConfig {
    position?: ChartOrientationType;
}
/**
 * Available orientation positions.
 *
 * @public
 */
export type ChartOrientationType = "horizontal" | "vertical";
/**
 * Indicates whether the continuous line for the missing value display or not on Area, Line, and Combo chart
 * @public
 */
export interface IContinuousLineConfig {
    /**
     * Enables the continuous line on Area, Line, and Combo chart.
     */
    enabled?: boolean;
}
/**
 * Supported point shape symbols for distinct point shapes feature.
 *
 * @beta
 */
export type PointShapeSymbolType = "circle" | "square" | "diamond" | "triangle" | "triangle-down";
/**
 * Configuration for distinct point shapes feature.
 *
 * @beta
 */
export interface IDistinctPointShapes {
    /**
     * Enables distinct point shapes for line-based charts.
     *
     * @remarks
     * When enabled, different series in line, area, and combo charts will use different point shapes
     * (circle, square, diamond, triangle, triangle-down) to help distinguish between series.
     */
    enabled?: boolean;
    /**
     * Optional mapping from measure local identifier to a specific point shape symbol.
     *
     * @remarks
     * This uses the local identifier of measures to determine which point shape to apply to each series.
     *
     * For measures that are not explicitly mapped in this configuration, the system will
     * automatically assign point shapes based on their series index using the predefined
     * order: "circle", "square", "triangle", "triangle-down", "diamond". The shapes cycle
     * through this sequence if there are more series than available shapes.
     *
     */
    pointShapeMapping?: Record<string, PointShapeSymbolType>;
}
/**
 * Available legend positions.
 *
 * @public
 */
export type PositionType = "left" | "right" | "top" | "bottom" | "auto";
/**
 * Data label visibility options.
 *
 * @remarks
 * - false: no labels
 * - true: labels shown, values can overlap when rendered
 * - "auto": labels shown, values will not overlap when rendered
 *
 * @public
 */
export type IDataLabelsVisible = boolean | string;
/**
 * Data points visibility options.
 *
 * @remarks
 * - false: no points
 * - true: datapoints shown, datapoints can overlap when rendered
 * - "auto": datapoints shown, datapoints will not overlap when rendered
 *
 * @public
 */
export type IDataPointsVisible = boolean | "auto";
/**
 * Vertical chart alignment options.
 *
 * @public
 */
export type ChartAlignTypes = "top" | "bottom" | "middle";
/**
 * @public
 */
export interface IDataLabelsConfig {
    visible?: IDataLabelsVisible;
    totalsVisible?: IDataLabelsVisible;
    /**
     * Indicates whether to render data labels enriched with percentages.
     * Applies only to funnel chart.
     */
    percentsVisible?: boolean;
    /**
     * Style of data labels rendering.
     * - "auto": default label style depending on chart type and context
     * - "backplate": render labels with a backplate behind text for better contrast
     */
    style?: "auto" | "backplate";
}
/**
 * @public
 */
export interface IDataPointsConfig {
    visible?: IDataPointsVisible;
}
/**
 * @public
 */
export interface ILegendConfig {
    /**
     * Indicates whether legend should be rendered or not.
     */
    enabled?: boolean;
    /**
     * Where, relative to the chart, should the legend appear.
     */
    position?: PositionType;
    /**
     * Turns on responsive behavior. Legend items will be rendered horizontally on
     * screens smaller than 767px.
     */
    responsive?: boolean | "autoPositionWithPopup";
}
/**
 * @public
 */
export interface ITotalConfig {
    /**
     * Indicates whether total column should be rendered or not.
     */
    enabled?: boolean;
    /**
     * Custom title for the total column (Total is default)
     */
    name?: string;
    /**
     * the list of localIdentifier of the measures which are the total measure
     */
    measures?: string[];
}
/**
 *
 * @public
 */
export interface IChartLimits {
    series?: number;
    categories?: number;
    nodes?: number;
    dataPoints?: number;
}
/**
 * Position of the axis label relative to the axis.
 *
 * @public
 */
export type AxisNamePosition = "high" | "low" | "middle";
/**
 * Customize whether to display the axis name and if so, where relative to the axis it should be positioned.
 *
 * @public
 */
export interface IAxisNameConfig {
    /**
     * Toggle axis name visibility.
     */
    visible?: boolean;
    /**
     * Customize where, relative to the axis should the axis name appear.
     */
    position?: AxisNamePosition;
}
/**
 * @public
 */
export interface IAxisConfig {
    /**
     * Toggle axis visilibity.
     */
    visible?: boolean;
    /**
     * Toggle visibility of labels describing the different axis tics.
     */
    labelsEnabled?: boolean;
    /**
     * If labels are enabled, rotation lets you customize how they should be rotated. Specify this as a number
     * of degrees. Positive number means clockwise rotation, negative is counter-clockwise rotation.
     */
    rotation?: string;
    /**
     * Fox axis with numeric tics, this can influence the minimum value shown on the axis and in the chart itself.
     *
     * The min and max can be used to zoom-in or zoom-out the chart.
     */
    min?: string;
    /**
     * For axis with numeric tics, this can influence the maximum value shown on the axis and in the chart itself.
     *
     * The min and max can be used to zoom-in or zoom-out the chart.
     */
    max?: string;
    /**
     * Customize whether to use format from measure or the default one
     */
    format?: string;
    /**
     * Customize measures which are bound to this axis. This setting comes into play in dual-axis charts where you
     * must specify which measures are on the primary and which on the secondary axis.
     */
    measures?: Identifier[];
    /**
     * Customize whether and how the axis name should appear.
     */
    name?: IAxisNameConfig;
}
/**
 * Tooltip customization
 *
 * @public
 */
export interface ITooltipConfig {
    /**
     * Indicates if tooltip is shown.
     *
     * @defaultValue defaults to true, meaning the tooltip is shown
     */
    enabled?: boolean;
    /**
     * Additional class name to be added to the tooltip container
     */
    className?: string;
}
//# sourceMappingURL=chartConfig.d.ts.map