@nice2dev/ui-tools 1.0.10

package/dist/chart-builder.d.ts

@@ -0,0 +1,1404 @@
+/**
+ * @file chart-builder.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-15.2 — Chart Builder
+ *
+ * Types for advanced chart builder: 50+ chart types, customization, interactivity,
+ * animation, trendlines, annotations, combo charts, geographic maps, sankey, treemaps.
+ */
+/** Primary chart type */
+export type PrimaryChartType = 'line' | 'area' | 'bar' | 'column' | 'pie' | 'donut';
+/** Advanced chart type */
+export type AdvancedChartType = 'scatter' | 'bubble' | 'radar' | 'polar' | 'heatmap' | 'treemap' | 'sunburst' | 'sankey' | 'chord' | 'funnel' | 'pyramid' | 'waterfall' | 'boxplot' | 'violin' | 'candlestick' | 'ohlc' | 'histogram' | 'density' | 'pareto' | 'bullet' | 'gauge' | 'solidGauge' | 'speedometer';
+/** Geographic chart type */
+export type GeoChartType = 'choropleth' | 'bubbleMap' | 'heatMap' | 'flowMap' | 'connectionMap' | 'markerMap';
+/** Statistical chart type */
+export type StatisticalChartType = 'qqPlot' | 'correlationMatrix' | 'errorBar' | 'confidenceBand' | 'regressionLine';
+/** Combined chart type */
+export type CombinedChartType = PrimaryChartType | AdvancedChartType | GeoChartType | StatisticalChartType;
+/** Chart builder configuration */
+export interface ChartBuilderConfig {
+    /** Initial chart */
+    chart?: ChartDefinition;
+    /** Editor mode */
+    mode?: ChartEditorMode;
+    /** Theme */
+    theme?: ChartBuilderTheme;
+    /** Locale */
+    locale?: string;
+    /** Available chart types */
+    chartTypes?: CombinedChartType[];
+    /** Custom chart types */
+    customTypes?: CustomChartType[];
+    /** Data source */
+    dataSource?: ChartDataSource;
+    /** Enable preview */
+    preview?: boolean;
+    /** Enable code view */
+    codeView?: boolean;
+    /** Toolbar configuration */
+    toolbar?: ChartToolbarConfig;
+    /** Sidebar configuration */
+    sidebar?: ChartSidebarConfig;
+    /** Export options */
+    exportOptions?: ChartExportOptions;
+    /** Animation defaults */
+    animationDefaults?: ChartAnimationDefaults;
+}
+/** Chart editor mode */
+export type ChartEditorMode = 'visual' | 'code' | 'split';
+/** Chart builder theme */
+export interface ChartBuilderTheme {
+    name?: string;
+    background?: string;
+    text?: string;
+    grid?: string;
+    axis?: string;
+    tooltip?: string;
+    legend?: string;
+    colorPalettes?: ColorPalette[];
+    defaultPalette?: string;
+}
+/** Color palette */
+export interface ColorPalette {
+    id: string;
+    name: string;
+    colors: string[];
+    type?: 'categorical' | 'sequential' | 'diverging';
+}
+/** Custom chart type */
+export interface CustomChartType {
+    id: string;
+    name: string;
+    icon?: string;
+    category?: string;
+    baseType?: CombinedChartType;
+    defaultConfig: Partial<ChartConfiguration>;
+    render?: (chart: ChartDefinition, container: unknown) => void;
+}
+/** Chart data source */
+export interface ChartDataSource {
+    type: 'static' | 'api' | 'query' | 'stream';
+    data?: ChartDataPoint[];
+    apiConfig?: ChartApiConfig;
+    queryConfig?: ChartQueryConfig;
+    streamConfig?: ChartStreamConfig;
+}
+/** Chart data point */
+export interface ChartDataPoint {
+    [key: string]: unknown;
+}
+/** Chart API config */
+export interface ChartApiConfig {
+    url: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: unknown;
+    responseMapping?: ChartResponseMapping;
+    refreshInterval?: number;
+}
+/** Chart response mapping */
+export interface ChartResponseMapping {
+    dataPath?: string;
+    seriesPath?: string;
+    categoriesPath?: string;
+    fieldMappings?: ChartFieldMapping[];
+}
+/** Chart field mapping */
+export interface ChartFieldMapping {
+    source: string;
+    target: string;
+    type?: 'value' | 'category' | 'series' | 'label';
+    transform?: string;
+}
+/** Chart query config */
+export interface ChartQueryConfig {
+    sourceId: string;
+    query: string;
+    parameters?: Record<string, unknown>;
+}
+/** Chart stream config */
+export interface ChartStreamConfig {
+    type: 'websocket' | 'sse' | 'polling';
+    url: string;
+    reconnect?: boolean;
+    maxDataPoints?: number;
+    sliding?: boolean;
+}
+/** Chart toolbar configuration */
+export interface ChartToolbarConfig {
+    visible?: boolean;
+    items?: ChartToolbarItem[];
+    customItems?: CustomChartToolbarItem[];
+}
+/** Chart toolbar item */
+export type ChartToolbarItem = 'chartType' | 'save' | 'export' | 'undo' | 'redo' | 'preview' | 'fullscreen' | 'refresh' | 'settings' | 'annotations' | 'trendlines' | 'separator';
+/** Custom chart toolbar item */
+export interface CustomChartToolbarItem {
+    id: string;
+    label?: string;
+    icon?: string;
+    tooltip?: string;
+    handler: () => void;
+    disabled?: boolean;
+    position?: number;
+}
+/** Chart sidebar configuration */
+export interface ChartSidebarConfig {
+    visible?: boolean;
+    position?: 'left' | 'right';
+    width?: number;
+    tabs?: ('data' | 'style' | 'axes' | 'legend' | 'tooltip' | 'animation' | 'advanced')[];
+}
+/** Chart export options */
+export interface ChartExportOptions {
+    formats?: ChartExportFormat[];
+    scale?: number;
+    backgroundColor?: string;
+    width?: number;
+    height?: number;
+}
+/** Chart export format */
+export type ChartExportFormat = 'png' | 'svg' | 'pdf' | 'jpeg' | 'webp' | 'json' | 'csv';
+/** Chart animation defaults */
+export interface ChartAnimationDefaults {
+    enabled?: boolean;
+    duration?: number;
+    easing?: ChartEasing;
+    delay?: number;
+    stagger?: boolean;
+}
+/** Chart easing */
+export type ChartEasing = 'linear' | 'easeIn' | 'easeOut' | 'easeInOut' | 'cubicIn' | 'cubicOut' | 'cubicInOut' | 'elasticIn' | 'elasticOut' | 'bounceIn' | 'bounceOut';
+/** Chart definition */
+export interface ChartDefinition {
+    id: string;
+    name?: string;
+    description?: string;
+    type: CombinedChartType;
+    data: ChartData;
+    config: ChartConfiguration;
+    metadata?: ChartMetadata;
+}
+/** Chart data */
+export interface ChartData {
+    categories?: (string | number | Date)[];
+    series: ChartSeries[];
+    rawData?: ChartDataPoint[];
+}
+/** Chart series */
+export interface ChartSeries {
+    id?: string;
+    name: string;
+    data: SeriesDataPoint[];
+    type?: CombinedChartType;
+    yAxisIndex?: number;
+    xAxisIndex?: number;
+    color?: string | ChartGradient;
+    visible?: boolean;
+    legendIndex?: number;
+    stack?: string;
+    zIndex?: number;
+    style?: SeriesStyle;
+}
+/** Series data point */
+export interface SeriesDataPoint {
+    x?: string | number | Date;
+    y: number;
+    z?: number;
+    name?: string;
+    color?: string;
+    label?: string;
+    custom?: Record<string, unknown>;
+}
+/** Chart gradient */
+export interface ChartGradient {
+    type: 'linear' | 'radial';
+    x1?: number;
+    y1?: number;
+    x2?: number;
+    y2?: number;
+    r?: number;
+    stops: ChartGradientStop[];
+}
+/** Chart gradient stop */
+export interface ChartGradientStop {
+    offset: number;
+    color: string;
+    opacity?: number;
+}
+/** Series style */
+export interface SeriesStyle {
+    lineWidth?: number;
+    lineStyle?: 'solid' | 'dashed' | 'dotted';
+    fillOpacity?: number;
+    markerEnabled?: boolean;
+    markerSize?: number;
+    markerShape?: MarkerShape;
+    markerBorderWidth?: number;
+    markerBorderColor?: string;
+    barWidth?: number | string;
+    barBorderRadius?: number | number[];
+    borderWidth?: number;
+    borderColor?: string;
+}
+/** Marker shape */
+export type MarkerShape = 'circle' | 'square' | 'diamond' | 'triangle' | 'triangleDown' | 'cross' | 'plus' | 'star' | 'pentagon' | 'hexagon';
+/** Chart configuration */
+export interface ChartConfiguration {
+    title?: ChartTitle;
+    subtitle?: ChartSubtitle;
+    xAxis?: ChartAxis | ChartAxis[];
+    yAxis?: ChartAxis | ChartAxis[];
+    zAxis?: ChartAxis;
+    legend?: ChartLegend;
+    tooltip?: ChartTooltip;
+    grid?: ChartGrid;
+    colors?: string[];
+    colorPalette?: string;
+    animation?: ChartAnimation;
+    interaction?: ChartInteraction;
+    accessibility?: ChartAccessibility;
+    annotations?: ChartAnnotation[];
+    trendlines?: ChartTrendline[];
+    thresholds?: ChartThreshold[];
+    plotBands?: PlotBand[];
+    plotLines?: PlotLine[];
+    responsive?: ResponsiveConfig[];
+    typeSpecific?: TypeSpecificConfig;
+}
+/** Chart title */
+export interface ChartTitle {
+    text?: string;
+    show?: boolean;
+    align?: 'left' | 'center' | 'right';
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    x?: number;
+    y?: number;
+    style?: ChartTextStyle;
+    floating?: boolean;
+}
+/** Chart subtitle */
+export interface ChartSubtitle {
+    text?: string;
+    show?: boolean;
+    align?: 'left' | 'center' | 'right';
+    x?: number;
+    y?: number;
+    style?: ChartTextStyle;
+}
+/** Chart text style */
+export interface ChartTextStyle {
+    color?: string;
+    fontSize?: number;
+    fontWeight?: string | number;
+    fontFamily?: string;
+    fontStyle?: 'normal' | 'italic';
+    textDecoration?: string;
+    textShadow?: string;
+    letterSpacing?: number;
+    lineHeight?: number;
+}
+/** Chart axis */
+export interface ChartAxis {
+    id?: string;
+    show?: boolean;
+    type?: 'category' | 'value' | 'time' | 'log';
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    opposite?: boolean;
+    offset?: number;
+    name?: string;
+    nameLocation?: 'start' | 'middle' | 'end';
+    nameGap?: number;
+    nameRotate?: number;
+    nameStyle?: ChartTextStyle;
+    min?: number | 'auto' | 'dataMin';
+    max?: number | 'auto' | 'dataMax';
+    softMin?: number;
+    softMax?: number;
+    range?: [number, number];
+    categories?: (string | number)[];
+    reversed?: boolean;
+    logarithmic?: boolean;
+    logBase?: number;
+    tickCount?: number;
+    tickInterval?: number;
+    tickPositions?: number[];
+    minTickInterval?: number;
+    axisLine?: AxisLineConfig;
+    axisTick?: AxisTickConfig;
+    axisLabel?: AxisLabelConfig;
+    splitLine?: SplitLineConfig;
+    splitArea?: SplitAreaConfig;
+    minorTick?: MinorTickConfig;
+    minorSplitLine?: SplitLineConfig;
+    alignTicks?: boolean;
+    scale?: boolean;
+    boundaryGap?: boolean | [string, string];
+    plotBands?: PlotBand[];
+    plotLines?: PlotLine[];
+}
+/** Axis line config */
+export interface AxisLineConfig {
+    show?: boolean;
+    onZero?: boolean;
+    color?: string;
+    width?: number;
+    type?: 'solid' | 'dashed' | 'dotted';
+    symbol?: string | [string, string];
+    symbolSize?: number[];
+    symbolOffset?: number[];
+}
+/** Axis tick config */
+export interface AxisTickConfig {
+    show?: boolean;
+    alignWithLabel?: boolean;
+    inside?: boolean;
+    length?: number;
+    color?: string;
+    width?: number;
+}
+/** Axis label config */
+export interface AxisLabelConfig {
+    show?: boolean;
+    inside?: boolean;
+    rotate?: number;
+    margin?: number;
+    formatter?: string | ((value: unknown, index: number) => string);
+    showMinLabel?: boolean;
+    showMaxLabel?: boolean;
+    style?: ChartTextStyle;
+    interval?: number | 'auto';
+    align?: 'left' | 'center' | 'right';
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    overflow?: 'truncate' | 'break' | 'breakAll' | 'none';
+    width?: number;
+    rich?: Record<string, ChartTextStyle>;
+}
+/** Split line config */
+export interface SplitLineConfig {
+    show?: boolean;
+    color?: string | string[];
+    width?: number;
+    type?: 'solid' | 'dashed' | 'dotted';
+    interval?: number | 'auto';
+}
+/** Split area config */
+export interface SplitAreaConfig {
+    show?: boolean;
+    colors?: string[];
+    opacity?: number;
+    interval?: number | 'auto';
+}
+/** Minor tick config */
+export interface MinorTickConfig {
+    show?: boolean;
+    count?: number;
+    length?: number;
+    color?: string;
+    width?: number;
+}
+/** Plot band */
+export interface PlotBand {
+    from: number | string | Date;
+    to: number | string | Date;
+    color?: string;
+    opacity?: number;
+    label?: PlotBandLabel;
+    zIndex?: number;
+}
+/** Plot band label */
+export interface PlotBandLabel {
+    text: string;
+    align?: 'left' | 'center' | 'right';
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    rotation?: number;
+    style?: ChartTextStyle;
+    x?: number;
+    y?: number;
+}
+/** Plot line */
+export interface PlotLine {
+    value: number | string | Date;
+    color?: string;
+    width?: number;
+    dashStyle?: 'solid' | 'dashed' | 'dotted';
+    label?: PlotBandLabel;
+    zIndex?: number;
+}
+/** Chart legend */
+export interface ChartLegend {
+    show?: boolean;
+    type?: 'plain' | 'scroll';
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    orient?: 'horizontal' | 'vertical';
+    align?: 'auto' | 'left' | 'right';
+    padding?: number | number[];
+    itemGap?: number;
+    itemWidth?: number;
+    itemHeight?: number;
+    formatter?: string | ((name: string) => string);
+    selectedMode?: boolean | 'single' | 'multiple';
+    inactiveColor?: string;
+    selected?: Record<string, boolean>;
+    textStyle?: ChartTextStyle;
+    icon?: string;
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    shadowBlur?: number;
+    shadowColor?: string;
+    scrollDataIndex?: number;
+    pageButtonItemGap?: number;
+    pageButtonPosition?: 'start' | 'end';
+    pageTextStyle?: ChartTextStyle;
+}
+/** Chart tooltip */
+export interface ChartTooltip {
+    show?: boolean;
+    trigger?: 'item' | 'axis' | 'none';
+    triggerOn?: 'mousemove' | 'click' | 'mousemove|click' | 'none';
+    alwaysShowContent?: boolean;
+    showDelay?: number;
+    hideDelay?: number;
+    enterable?: boolean;
+    confine?: boolean;
+    appendToBody?: boolean;
+    transitionDuration?: number;
+    position?: TooltipPosition;
+    formatter?: string | ((params: unknown) => string);
+    valueFormatter?: (value: unknown) => string;
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    padding?: number | number[];
+    textStyle?: ChartTextStyle;
+    extraCssText?: string;
+    axisPointer?: AxisPointer;
+    order?: 'seriesAsc' | 'seriesDesc' | 'valueAsc' | 'valueDesc';
+}
+/** Tooltip position */
+export type TooltipPosition = 'inside' | 'top' | 'left' | 'right' | 'bottom' | [number, number] | [string, string] | ((point: [number, number], params: unknown, dom: unknown, rect: unknown, size: unknown) => [number, number] | Record<string, number>);
+/** Axis pointer */
+export interface AxisPointer {
+    show?: boolean;
+    type?: 'line' | 'shadow' | 'cross' | 'none';
+    snap?: boolean;
+    z?: number;
+    label?: AxisPointerLabel;
+    lineStyle?: PointerLineStyle;
+    shadowStyle?: PointerShadowStyle;
+    crossStyle?: PointerLineStyle;
+    animation?: boolean;
+    animationDuration?: number;
+    animationEasing?: ChartEasing;
+}
+/** Axis pointer label */
+export interface AxisPointerLabel {
+    show?: boolean;
+    precision?: number | 'auto';
+    formatter?: string | ((params: unknown) => string);
+    margin?: number;
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    shadowBlur?: number;
+    shadowColor?: string;
+    textStyle?: ChartTextStyle;
+    padding?: number | number[];
+}
+/** Pointer line style */
+export interface PointerLineStyle {
+    color?: string;
+    width?: number;
+    type?: 'solid' | 'dashed' | 'dotted';
+    opacity?: number;
+}
+/** Pointer shadow style */
+export interface PointerShadowStyle {
+    color?: string;
+    opacity?: number;
+}
+/** Chart grid */
+export interface ChartGrid {
+    show?: boolean;
+    left?: number | string;
+    right?: number | string;
+    top?: number | string;
+    bottom?: number | string;
+    width?: number | string;
+    height?: number | string;
+    containLabel?: boolean;
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    shadowBlur?: number;
+    shadowColor?: string;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+}
+/** Chart animation */
+export interface ChartAnimation {
+    enabled?: boolean;
+    duration?: number;
+    easing?: ChartEasing;
+    delay?: number | ((idx: number) => number);
+    threshold?: number;
+    update?: UpdateAnimation;
+    enter?: EnterExitAnimation;
+    exit?: EnterExitAnimation;
+}
+/** Update animation */
+export interface UpdateAnimation {
+    duration?: number;
+    easing?: ChartEasing;
+    delay?: number | ((idx: number) => number);
+}
+/** Enter/Exit animation */
+export interface EnterExitAnimation {
+    duration?: number;
+    easing?: ChartEasing;
+    type?: 'fade' | 'scale' | 'slide' | 'expand';
+}
+/** Chart interaction */
+export interface ChartInteraction {
+    zoom?: ChartZoom;
+    pan?: ChartPan;
+    brush?: ChartBrush;
+    cursor?: string;
+    hoverMode?: 'single' | 'series' | 'dataset';
+    activeOpacity?: number;
+    inactiveOpacity?: number;
+    dataPointClick?: boolean;
+    seriesClick?: boolean;
+    legendClick?: boolean;
+    contextMenu?: ChartContextMenu;
+}
+/** Chart zoom */
+export interface ChartZoom {
+    enabled?: boolean;
+    type?: 'x' | 'y' | 'xy';
+    wheel?: boolean;
+    drag?: boolean;
+    pinch?: boolean;
+    resetButton?: boolean;
+    minSpan?: number;
+    maxSpan?: number;
+}
+/** Chart pan */
+export interface ChartPan {
+    enabled?: boolean;
+    mode?: 'x' | 'y' | 'xy';
+}
+/** Chart brush */
+export interface ChartBrush {
+    enabled?: boolean;
+    type?: ('rect' | 'polygon' | 'lineX' | 'lineY' | 'keep' | 'clear')[];
+    mode?: 'single' | 'multiple';
+    transformable?: boolean;
+    brushStyle?: BrushStyle;
+    throttleType?: 'debounce' | 'fixRate';
+    throttleDelay?: number;
+}
+/** Brush style */
+export interface BrushStyle {
+    color?: string;
+    borderWidth?: number;
+    borderColor?: string;
+}
+/** Chart context menu */
+export interface ChartContextMenu {
+    enabled?: boolean;
+    items?: ContextMenuItem[];
+}
+/** Context menu item */
+export interface ContextMenuItem {
+    id: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    handler: (params: unknown) => void;
+    submenu?: ContextMenuItem[];
+}
+/** Chart accessibility */
+export interface ChartAccessibility {
+    enabled?: boolean;
+    description?: string;
+    announceNewData?: boolean;
+    landmarkVerbosity?: 'all' | 'one' | 'disabled';
+    keyboardNavigation?: KeyboardNavigation;
+    screenReaderSection?: ScreenReaderSection;
+    point?: AccessibilityPointConfig;
+    series?: AccessibilitySeriesConfig;
+}
+/** Keyboard navigation */
+export interface KeyboardNavigation {
+    enabled?: boolean;
+    focusBorder?: FocusBorder;
+    order?: string[];
+}
+/** Focus border */
+export interface FocusBorder {
+    enabled?: boolean;
+    style?: {
+        color?: string;
+        width?: number;
+        borderRadius?: number;
+    };
+    margin?: number;
+}
+/** Screen reader section */
+export interface ScreenReaderSection {
+    beforeChartFormat?: string;
+    afterChartFormat?: string;
+}
+/** Accessibility point config */
+export interface AccessibilityPointConfig {
+    descriptionFormat?: string;
+    valueDescriptionFormat?: string;
+    dateFormat?: string;
+}
+/** Accessibility series config */
+export interface AccessibilitySeriesConfig {
+    descriptionFormat?: string;
+}
+/** Chart metadata */
+export interface ChartMetadata {
+    created?: Date;
+    createdBy?: string;
+    modified?: Date;
+    modifiedBy?: string;
+    version?: string;
+    tags?: string[];
+    category?: string;
+}
+/** Chart annotation */
+export interface ChartAnnotation {
+    id: string;
+    type: AnnotationType;
+    position: AnnotationPosition;
+    content?: string;
+    style?: AnnotationStyle;
+    draggable?: boolean;
+    visible?: boolean;
+    labels?: AnnotationLabel[];
+    shapes?: AnnotationShape[];
+}
+/** Annotation type */
+export type AnnotationType = 'text' | 'line' | 'rect' | 'circle' | 'polygon' | 'arrow' | 'callout' | 'image' | 'custom';
+/** Annotation position */
+export interface AnnotationPosition {
+    x?: number | string | 'min' | 'max' | 'center';
+    y?: number | string | 'min' | 'max' | 'center';
+    xAxis?: number;
+    yAxis?: number;
+    x2?: number | string;
+    y2?: number | string;
+    points?: [number | string, number | string][];
+}
+/** Annotation style */
+export interface AnnotationStyle {
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: string | number;
+    textAlign?: 'left' | 'center' | 'right';
+    textBaseline?: 'top' | 'middle' | 'bottom';
+    rotation?: number;
+    offsetX?: number;
+    offsetY?: number;
+}
+/** Annotation label */
+export interface AnnotationLabel {
+    text: string;
+    position?: AnnotationLabelPosition;
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    padding?: number | number[];
+    style?: ChartTextStyle;
+}
+/** Annotation label position */
+export type AnnotationLabelPosition = 'start' | 'center' | 'end' | 'top' | 'bottom' | 'left' | 'right' | 'insideStart' | 'insideEnd';
+/** Annotation shape */
+export interface AnnotationShape {
+    type: 'line' | 'rect' | 'circle' | 'polygon' | 'path';
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    coordinates?: unknown;
+}
+/** Chart trendline */
+export interface ChartTrendline {
+    id: string;
+    seriesIndex?: number;
+    type: TrendlineType;
+    order?: number;
+    period?: number;
+    forwardForecast?: number;
+    backwardForecast?: number;
+    color?: string;
+    width?: number;
+    dashStyle?: 'solid' | 'dashed' | 'dotted';
+    label?: TrendlineLabel;
+    equation?: boolean;
+    rSquared?: boolean;
+}
+/** Trendline type */
+export type TrendlineType = 'linear' | 'exponential' | 'logarithmic' | 'polynomial' | 'power' | 'movingAverage' | 'weightedMovingAverage' | 'exponentialMovingAverage';
+/** Trendline label */
+export interface TrendlineLabel {
+    show?: boolean;
+    text?: string;
+    position?: 'start' | 'center' | 'end';
+    style?: ChartTextStyle;
+    showEquation?: boolean;
+    showRSquared?: boolean;
+}
+/** Chart threshold */
+export interface ChartThreshold {
+    id: string;
+    value: number;
+    label?: string;
+    color?: string;
+    width?: number;
+    dashStyle?: 'solid' | 'dashed' | 'dotted';
+    fill?: ThresholdFill;
+    labelStyle?: ThresholdLabelStyle;
+}
+/** Threshold fill */
+export interface ThresholdFill {
+    above?: string;
+    below?: string;
+    opacity?: number;
+}
+/** Threshold label style */
+export interface ThresholdLabelStyle {
+    position?: 'start' | 'center' | 'end';
+    align?: 'left' | 'center' | 'right';
+    style?: ChartTextStyle;
+    backgroundColor?: string;
+    padding?: number | number[];
+    borderRadius?: number;
+}
+/** Type specific config */
+export type TypeSpecificConfig = PieChartConfig | RadarChartConfig | TreemapConfig | SunburstConfig | SankeyConfig | ChordConfig | FunnelConfig | GaugeConfig | HeatmapChartConfig | BoxplotConfig | CandlestickConfig | MapChartConfig | ParallelConfig;
+/** Pie chart config */
+export interface PieChartConfig {
+    radius?: string | number | [string | number, string | number];
+    center?: [string | number, string | number];
+    startAngle?: number;
+    endAngle?: number;
+    clockwise?: boolean;
+    minAngle?: number;
+    minShowLabelAngle?: number;
+    roseType?: false | 'radius' | 'area';
+    avoidLabelOverlap?: boolean;
+    stillShowZeroSum?: boolean;
+    percentPrecision?: number;
+    padAngle?: number;
+    borderRadius?: number;
+    itemStyle?: PieItemStyle;
+    label?: PieLabel;
+    labelLine?: PieLabelLine;
+    emphasis?: PieEmphasis;
+}
+/** Pie item style */
+export interface PieItemStyle {
+    borderRadius?: number | number[];
+    borderColor?: string;
+    borderWidth?: number;
+    shadowBlur?: number;
+    shadowColor?: string;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+}
+/** Pie label */
+export interface PieLabel {
+    show?: boolean;
+    position?: 'outside' | 'inside' | 'center';
+    formatter?: string | ((params: unknown) => string);
+    alignTo?: 'none' | 'labelLine' | 'edge';
+    edgeDistance?: string | number;
+    bleedMargin?: number;
+    distanceToLabelLine?: number;
+    style?: ChartTextStyle;
+}
+/** Pie label line */
+export interface PieLabelLine {
+    show?: boolean;
+    showAbove?: boolean;
+    length?: number;
+    length2?: number;
+    smooth?: boolean | number;
+    minTurnAngle?: number;
+    maxSurfaceAngle?: number;
+    lineStyle?: PointerLineStyle;
+}
+/** Pie emphasis */
+export interface PieEmphasis {
+    scale?: boolean;
+    scaleSize?: number;
+    focus?: 'none' | 'self' | 'series' | 'ancestor' | 'descendant';
+    blurScope?: 'coordinateSystem' | 'series' | 'global';
+    itemStyle?: PieItemStyle;
+    label?: PieLabel;
+    labelLine?: PieLabelLine;
+}
+/** Radar chart config */
+export interface RadarChartConfig {
+    shape?: 'polygon' | 'circle';
+    center?: [string | number, string | number];
+    radius?: string | number | (string | number)[];
+    startAngle?: number;
+    axisName?: AxisNameConfig;
+    axisNameGap?: number;
+    splitNumber?: number;
+    splitArea?: SplitAreaConfig;
+    splitLine?: SplitLineConfig;
+    indicator: RadarIndicator[];
+}
+/** Axis name config */
+export interface AxisNameConfig {
+    show?: boolean;
+    formatter?: string | ((name: string) => string);
+    style?: ChartTextStyle;
+}
+/** Radar indicator */
+export interface RadarIndicator {
+    name: string;
+    max?: number;
+    min?: number;
+    color?: string;
+}
+/** Treemap config */
+export interface TreemapConfig {
+    width?: string | number;
+    height?: string | number;
+    left?: string | number;
+    top?: string | number;
+    right?: string | number;
+    bottom?: string | number;
+    squareRatio?: number;
+    leafDepth?: number;
+    drillDownIcon?: string;
+    roam?: boolean | 'scale' | 'move';
+    nodeClick?: 'zoomToNode' | 'link' | false;
+    zoomToNodeRatio?: number;
+    levels?: TreemapLevel[];
+    breadcrumb?: TreemapBreadcrumb;
+    label?: TreemapLabel;
+    itemStyle?: TreemapItemStyle;
+    emphasis?: TreemapEmphasis;
+}
+/** Treemap level */
+export interface TreemapLevel {
+    visualDimension?: number;
+    visualMin?: number;
+    visualMax?: number;
+    color?: string[];
+    colorMappingBy?: 'value' | 'index' | 'id';
+    itemStyle?: TreemapItemStyle;
+    label?: TreemapLabel;
+}
+/** Treemap breadcrumb */
+export interface TreemapBreadcrumb {
+    show?: boolean;
+    left?: string | number;
+    top?: string | number;
+    right?: string | number;
+    bottom?: string | number;
+    height?: number;
+    emptyItemWidth?: number;
+    itemStyle?: BreadcrumbItemStyle;
+}
+/** Breadcrumb item style */
+export interface BreadcrumbItemStyle {
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderType?: 'solid' | 'dashed' | 'dotted';
+    textStyle?: ChartTextStyle;
+}
+/** Treemap label */
+export interface TreemapLabel {
+    show?: boolean;
+    position?: TreemapLabelPosition;
+    formatter?: string | ((params: unknown) => string);
+    style?: ChartTextStyle;
+    ellipsis?: boolean;
+}
+/** Treemap label position */
+export type TreemapLabelPosition = 'inside' | 'insideTopLeft' | 'insideTop' | 'insideTopRight' | 'insideBottomLeft' | 'insideBottom' | 'insideBottomRight';
+/** Treemap item style */
+export interface TreemapItemStyle {
+    color?: string;
+    colorAlpha?: number;
+    colorSaturation?: number;
+    borderRadius?: number;
+    borderWidth?: number;
+    borderColor?: string;
+    gapWidth?: number;
+}
+/** Treemap emphasis */
+export interface TreemapEmphasis {
+    focus?: 'none' | 'self' | 'descendant' | 'ancestor';
+    blurScope?: 'coordinateSystem' | 'series' | 'global';
+    label?: TreemapLabel;
+    itemStyle?: TreemapItemStyle;
+}
+/** Sunburst config */
+export interface SunburstConfig {
+    center?: [string | number, string | number];
+    radius?: (string | number)[];
+    startAngle?: number;
+    minAngle?: number;
+    clockwise?: boolean;
+    stillShowZeroSum?: boolean;
+    nodeClick?: 'rootToNode' | 'link' | false;
+    sort?: 'desc' | 'asc' | ((a: unknown, b: unknown) => number) | null;
+    renderLabelForZeroData?: boolean;
+    levels?: SunburstLevel[];
+}
+/** Sunburst level */
+export interface SunburstLevel {
+    radius?: [string | number, string | number];
+    label?: PieLabel;
+    itemStyle?: PieItemStyle;
+    emphasis?: PieEmphasis;
+}
+/** Sankey config */
+export interface SankeyConfig {
+    left?: string | number;
+    top?: string | number;
+    right?: string | number;
+    bottom?: string | number;
+    width?: string | number;
+    height?: string | number;
+    nodeWidth?: number;
+    nodeGap?: number;
+    nodeAlign?: 'justify' | 'left' | 'right';
+    layoutIterations?: number;
+    orient?: 'horizontal' | 'vertical';
+    draggable?: boolean;
+    focusNodeAdjacency?: boolean | 'allEdges' | 'outEdges' | 'inEdges';
+    levels?: SankeyLevel[];
+    label?: SankeyLabel;
+    itemStyle?: SankeyItemStyle;
+    lineStyle?: SankeyLineStyle;
+    emphasis?: SankeyEmphasis;
+}
+/** Sankey level */
+export interface SankeyLevel {
+    depth: number;
+    label?: SankeyLabel;
+    itemStyle?: SankeyItemStyle;
+    lineStyle?: SankeyLineStyle;
+}
+/** Sankey label */
+export interface SankeyLabel {
+    show?: boolean;
+    position?: 'left' | 'right' | 'inside' | 'insideLeft' | 'insideRight';
+    formatter?: string | ((params: unknown) => string);
+    style?: ChartTextStyle;
+    offset?: [number, number];
+}
+/** Sankey item style */
+export interface SankeyItemStyle {
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    opacity?: number;
+}
+/** Sankey line style */
+export interface SankeyLineStyle {
+    color?: string | 'source' | 'target' | 'gradient';
+    opacity?: number;
+    curveness?: number;
+}
+/** Sankey emphasis */
+export interface SankeyEmphasis {
+    focus?: 'none' | 'self' | 'series' | 'adjacency';
+    label?: SankeyLabel;
+    itemStyle?: SankeyItemStyle;
+    lineStyle?: SankeyLineStyle;
+}
+/** Chord config */
+export interface ChordConfig {
+    radius?: string | number | (string | number)[];
+    center?: [string | number, string | number];
+    startAngle?: number;
+    endAngle?: number;
+    clockwise?: boolean;
+    padAngle?: number;
+    sortGroups?: 'ascending' | 'descending' | null;
+    sortSubgroups?: 'ascending' | 'descending' | null;
+    sortChords?: 'ascending' | 'descending' | null;
+}
+/** Funnel config */
+export interface FunnelConfig {
+    min?: number;
+    max?: number;
+    minSize?: string | number;
+    maxSize?: string | number;
+    orient?: 'horizontal' | 'vertical';
+    sort?: 'ascending' | 'descending' | 'none';
+    gap?: number;
+    left?: string | number;
+    top?: string | number;
+    right?: string | number;
+    bottom?: string | number;
+    width?: string | number;
+    height?: string | number;
+    funnelAlign?: 'left' | 'right' | 'center';
+    label?: FunnelLabel;
+    labelLine?: FunnelLabelLine;
+    itemStyle?: FunnelItemStyle;
+    emphasis?: FunnelEmphasis;
+}
+/** Funnel label */
+export interface FunnelLabel {
+    show?: boolean;
+    position?: 'inside' | 'outside' | 'left' | 'right' | 'leftTop' | 'leftBottom' | 'rightTop' | 'rightBottom';
+    formatter?: string | ((params: unknown) => string);
+    style?: ChartTextStyle;
+}
+/** Funnel label line */
+export interface FunnelLabelLine {
+    show?: boolean;
+    length?: number;
+    lineStyle?: PointerLineStyle;
+}
+/** Funnel item style */
+export interface FunnelItemStyle {
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    opacity?: number;
+}
+/** Funnel emphasis */
+export interface FunnelEmphasis {
+    focus?: 'none' | 'self' | 'series';
+    label?: FunnelLabel;
+    labelLine?: FunnelLabelLine;
+    itemStyle?: FunnelItemStyle;
+}
+/** Gauge config */
+export interface GaugeConfig {
+    center?: [string | number, string | number];
+    radius?: string | number;
+    startAngle?: number;
+    endAngle?: number;
+    clockwise?: boolean;
+    min?: number;
+    max?: number;
+    splitNumber?: number;
+    axisLine?: GaugeAxisLine;
+    progress?: GaugeProgress;
+    splitLine?: GaugeSplitLine;
+    axisTick?: GaugeAxisTick;
+    axisLabel?: GaugeAxisLabel;
+    pointer?: GaugePointer;
+    anchor?: GaugeAnchor;
+    itemStyle?: GaugeItemStyle;
+    emphasis?: GaugeEmphasis;
+    title?: GaugeTitle;
+    detail?: GaugeDetail;
+}
+/** Gauge axis line */
+export interface GaugeAxisLine {
+    show?: boolean;
+    roundCap?: boolean;
+    lineStyle?: GaugeAxisLineStyle;
+}
+/** Gauge axis line style */
+export interface GaugeAxisLineStyle {
+    width?: number;
+    color?: [number, string][];
+    opacity?: number;
+}
+/** Gauge progress */
+export interface GaugeProgress {
+    show?: boolean;
+    overlap?: boolean;
+    width?: number;
+    roundCap?: boolean;
+    clip?: boolean;
+    itemStyle?: GaugeItemStyle;
+}
+/** Gauge split line */
+export interface GaugeSplitLine {
+    show?: boolean;
+    length?: number;
+    distance?: number;
+    lineStyle?: PointerLineStyle;
+}
+/** Gauge axis tick */
+export interface GaugeAxisTick {
+    show?: boolean;
+    splitNumber?: number;
+    length?: number;
+    distance?: number;
+    lineStyle?: PointerLineStyle;
+}
+/** Gauge axis label */
+export interface GaugeAxisLabel {
+    show?: boolean;
+    distance?: number;
+    formatter?: string | ((value: number) => string);
+    style?: ChartTextStyle;
+}
+/** Gauge pointer */
+export interface GaugePointer {
+    show?: boolean;
+    showAbove?: boolean;
+    icon?: string;
+    offsetCenter?: [string | number, string | number];
+    length?: string | number;
+    width?: number;
+    keepAspect?: boolean;
+    itemStyle?: GaugeItemStyle;
+}
+/** Gauge anchor */
+export interface GaugeAnchor {
+    show?: boolean;
+    showAbove?: boolean;
+    size?: number;
+    icon?: string;
+    offsetCenter?: [string | number, string | number];
+    keepAspect?: boolean;
+    itemStyle?: GaugeItemStyle;
+}
+/** Gauge item style */
+export interface GaugeItemStyle {
+    color?: string | ChartGradient;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    opacity?: number;
+    shadowBlur?: number;
+    shadowColor?: string;
+}
+/** Gauge emphasis */
+export interface GaugeEmphasis {
+    itemStyle?: GaugeItemStyle;
+}
+/** Gauge title */
+export interface GaugeTitle {
+    show?: boolean;
+    offsetCenter?: [string | number, string | number];
+    style?: ChartTextStyle;
+    width?: number;
+    overflow?: 'none' | 'truncate' | 'break' | 'breakAll';
+    valueAnimation?: boolean;
+}
+/** Gauge detail */
+export interface GaugeDetail {
+    show?: boolean;
+    formatter?: string | ((value: number) => string);
+    offsetCenter?: [string | number, string | number];
+    style?: ChartTextStyle;
+    width?: number;
+    overflow?: 'none' | 'truncate' | 'break' | 'breakAll';
+    valueAnimation?: boolean;
+}
+/** Heatmap chart config */
+export interface HeatmapChartConfig {
+    blurSize?: number;
+    minOpacity?: number;
+    maxOpacity?: number;
+    pointSize?: number;
+    coordinateSystem?: 'cartesian2d' | 'geo' | 'calendar';
+    xAxisIndex?: number;
+    yAxisIndex?: number;
+    geoIndex?: number;
+    calendarIndex?: number;
+    label?: HeatmapLabel;
+    itemStyle?: HeatmapItemStyle;
+    emphasis?: HeatmapEmphasis;
+}
+/** Heatmap label */
+export interface HeatmapLabel {
+    show?: boolean;
+    position?: 'top' | 'bottom' | 'inside' | 'insideLeft' | 'insideRight' | 'insideTop' | 'insideBottom';
+    formatter?: string | ((params: unknown) => string);
+    style?: ChartTextStyle;
+}
+/** Heatmap item style */
+export interface HeatmapItemStyle {
+    color?: string;
+    borderRadius?: number;
+    borderColor?: string;
+    borderWidth?: number;
+    opacity?: number;
+}
+/** Heatmap emphasis */
+export interface HeatmapEmphasis {
+    focus?: 'none' | 'self' | 'series';
+    label?: HeatmapLabel;
+    itemStyle?: HeatmapItemStyle;
+}
+/** Boxplot config */
+export interface BoxplotConfig {
+    xAxisIndex?: number;
+    yAxisIndex?: number;
+    layout?: 'horizontal' | 'vertical';
+    boxWidth?: (string | number)[];
+    itemStyle?: BoxplotItemStyle;
+    emphasis?: BoxplotEmphasis;
+}
+/** Boxplot item style */
+export interface BoxplotItemStyle {
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderType?: 'solid' | 'dashed' | 'dotted';
+    opacity?: number;
+}
+/** Boxplot emphasis */
+export interface BoxplotEmphasis {
+    focus?: 'none' | 'self' | 'series';
+    itemStyle?: BoxplotItemStyle;
+}
+/** Candlestick config */
+export interface CandlestickConfig {
+    xAxisIndex?: number;
+    yAxisIndex?: number;
+    barWidth?: number | string;
+    barMinWidth?: number | string;
+    barMaxWidth?: number | string;
+    layout?: 'horizontal' | 'vertical';
+    itemStyle?: CandlestickItemStyle;
+    emphasis?: CandlestickEmphasis;
+}
+/** Candlestick item style */
+export interface CandlestickItemStyle {
+    color?: string;
+    color0?: string;
+    borderColor?: string;
+    borderColor0?: string;
+    borderWidth?: number;
+    opacity?: number;
+}
+/** Candlestick emphasis */
+export interface CandlestickEmphasis {
+    focus?: 'none' | 'self' | 'series';
+    itemStyle?: CandlestickItemStyle;
+}
+/** Map chart config */
+export interface MapChartConfig {
+    map: string;
+    roam?: boolean | 'scale' | 'move';
+    center?: [number, number];
+    aspectScale?: number;
+    boundingCoords?: [[number, number], [number, number]];
+    zoom?: number;
+    scaleLimit?: {
+        min?: number;
+        max?: number;
+    };
+    nameMap?: Record<string, string>;
+    nameProperty?: string;
+    selectedMode?: boolean | 'single' | 'multiple';
+    label?: MapLabel;
+    itemStyle?: MapItemStyle;
+    emphasis?: MapEmphasis;
+    select?: MapSelect;
+    regions?: MapRegion[];
+}
+/** Map label */
+export interface MapLabel {
+    show?: boolean;
+    formatter?: string | ((params: unknown) => string);
+    style?: ChartTextStyle;
+}
+/** Map item style */
+export interface MapItemStyle {
+    areaColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderType?: 'solid' | 'dashed' | 'dotted';
+    opacity?: number;
+}
+/** Map emphasis */
+export interface MapEmphasis {
+    focus?: 'none' | 'self' | 'series';
+    label?: MapLabel;
+    itemStyle?: MapItemStyle;
+}
+/** Map select */
+export interface MapSelect {
+    label?: MapLabel;
+    itemStyle?: MapItemStyle;
+}
+/** Map region */
+export interface MapRegion {
+    name: string;
+    selected?: boolean;
+    label?: MapLabel;
+    itemStyle?: MapItemStyle;
+    emphasis?: MapEmphasis;
+}
+/** Parallel config */
+export interface ParallelConfig {
+    left?: string | number;
+    top?: string | number;
+    right?: string | number;
+    bottom?: string | number;
+    width?: string | number;
+    height?: string | number;
+    layout?: 'horizontal' | 'vertical';
+    axisExpandable?: boolean;
+    axisExpandCenter?: number;
+    axisExpandCount?: number;
+    axisExpandWidth?: number;
+    axisExpandTriggerOn?: 'click' | 'mousemove';
+    parallelAxisDefault?: ParallelAxisDefault;
+}
+/** Parallel axis default */
+export interface ParallelAxisDefault {
+    type?: 'value' | 'category' | 'time' | 'log';
+    name?: string;
+    nameLocation?: 'start' | 'middle' | 'end';
+    nameStyle?: ChartTextStyle;
+    nameGap?: number;
+    nameRotate?: number;
+    inverse?: boolean;
+    boundaryGap?: boolean | [string, string];
+    min?: number | string;
+    max?: number | string;
+    scale?: boolean;
+    axisLine?: AxisLineConfig;
+    axisTick?: AxisTickConfig;
+    axisLabel?: AxisLabelConfig;
+    data?: (string | number | ParallelAxisData)[];
+}
+/** Parallel axis data */
+export interface ParallelAxisData {
+    value: string | number;
+    textStyle?: ChartTextStyle;
+}
+/** Responsive config */
+export interface ResponsiveConfig {
+    condition: ResponsiveCondition;
+    option: Partial<ChartConfiguration>;
+}
+/** Responsive condition */
+export interface ResponsiveCondition {
+    maxWidth?: number;
+    minWidth?: number;
+    maxHeight?: number;
+    minHeight?: number;
+    maxAspectRatio?: number;
+    minAspectRatio?: number;
+}
+//# sourceMappingURL=chart-builder.d.ts.map