@univerjs-pro/engine-chart 1.0.0-alpha.3 → 1.0.0-alpha.4

package/lib/types/models/chart-model.d.ts

@@ -144,13 +144,16 @@ export declare class ChartModel extends Disposable {
         width?: number | undefined;
         height?: number | undefined;
         theme?: string | undefined;
+        palette?: string[] | undefined;
         invalidValueType?: import("..").InvalidValueType | undefined;
         gradientFill?: boolean | undefined;
         backgroundColor?: import("@univerjs/core").Nullable<string>;
         titleFontSize?: number | undefined;
         fontSize?: number | undefined;
         fontColor?: string | undefined;
+        fontFamily?: string | undefined;
         borderColor?: import("@univerjs/core").Nullable<string>;
+        borderWidth?: number | undefined;
         titles?: {
             title?: {
                 bold?: boolean | undefined;
@@ -251,6 +254,7 @@ export declare class ChartModel extends Disposable {
                 showMinLabel?: boolean | undefined;
             } | undefined;
             selectMode?: import("..").SelectModeEnum | undefined;
+            wrap?: boolean | undefined;
         } | undefined;
         xAxis?: {
             lineVisible?: boolean | undefined;
@@ -331,6 +335,7 @@ export declare class ChartModel extends Disposable {
             format?: string | undefined;
         } | undefined;
         rightYAxis?: {
+            min?: number | null | undefined;
             lineVisible?: boolean | undefined;
             label?: {
                 bold?: boolean | undefined;
@@ -364,12 +369,16 @@ export declare class ChartModel extends Disposable {
                 length?: number | undefined;
                 position?: import("..").PieLabelPosition | undefined;
             } | undefined;
-            min?: number | null | undefined;
             max?: number | null | undefined;
             format?: string | undefined;
         } | undefined;
         allSeriesStyle?: {
             color?: import("@univerjs/core").Nullable<string>;
+            point?: {
+                shape?: import("..").LinePointShape | undefined;
+                size?: number | undefined;
+                color?: import("@univerjs/core").Nullable<string>;
+            } | undefined;
             label?: {
                 contentType?: number | undefined;
                 position?: import("..").SeriesLabelPosition | undefined;
@@ -396,11 +405,7 @@ export declare class ChartModel extends Disposable {
                 dashType?: import("..").ChartBorderDashType | undefined;
             } | undefined;
             rightYAxis?: boolean | undefined;
-            point?: {
-                shape?: import("..").LinePointShape | undefined;
-                size?: number | undefined;
-                color?: import("@univerjs/core").Nullable<string>;
-            } | undefined;
+            fillOpacity?: number | undefined;
             waterfall?: {
                 positive?: {
                     chartType?: (ChartTypeBits.Line | ChartTypeBits.Column | ChartTypeBits.Area) | undefined;
@@ -728,6 +733,12 @@ export declare class ChartModel extends Disposable {
                 } | undefined;
             } | undefined;
         } | undefined;
+        bar?: {
+            is3D?: boolean | undefined;
+            shape?: import("..").BarShape | undefined;
+            rotX?: number | undefined;
+            rotY?: number | undefined;
+        } | undefined;
         trendlines?: import("..").ITrendLine[] | undefined;
         pie?: {
             doughnutHole?: import("@univerjs/core").Nullable<number>;
@@ -751,6 +762,7 @@ export declare class ChartModel extends Disposable {
             } | undefined;
             borderColor?: string | undefined;
             hasPaddingAngle?: boolean | undefined;
+            is3D?: boolean | undefined;
             isHalfPie?: boolean | undefined;
             rosePie?: boolean | undefined;
             showLabelLine?: boolean | undefined;
@@ -791,7 +803,15 @@ export declare class ChartModel extends Disposable {
         waterfall?: {
             stackType?: import("..").WaterfallStackTypeEnum | undefined;
             useSubtotal?: boolean | undefined;
+            pointRoles?: import("../types").IWaterfallPointRole[] | undefined;
+            connector?: boolean | {
+                color?: string | undefined;
+                width?: number | undefined;
+                opacity?: number | undefined;
+                dashType?: import("..").ChartBorderDashType | undefined;
+            } | undefined;
         } | undefined;
+        markLines?: import("../types").IChartMarkLine[] | undefined;
         tooltip?: {
             indicatorLabelColor?: string | undefined;
             indicatorLineType?: import("..").ChartBorderDashType | undefined;
@@ -1173,6 +1193,26 @@ export declare class ChartModel extends Disposable {
             visualMapType?: "continuous" | "piecewise" | undefined;
             max?: number | undefined;
             min?: number | undefined;
+            unit?: string | undefined;
+            label?: {
+                contentType?: number | undefined;
+                position?: import("..").SeriesLabelPosition | undefined;
+                visible?: boolean | undefined;
+                content?: string | undefined;
+                fontSize?: number | undefined;
+                color?: string | undefined;
+                align?: import("..").LabelAlignEnum | undefined;
+                bold?: boolean | undefined;
+                family?: string | undefined;
+                strikethrough?: boolean | undefined;
+                italic?: boolean | undefined;
+                underline?: boolean | undefined;
+                padAngle?: boolean | undefined;
+                axisTitleAlign?: import("..").AxisAlignEnum | undefined;
+                showMaxLabel?: boolean | undefined;
+                showMinLabel?: boolean | undefined;
+                rotate?: number | undefined;
+            } | undefined;
         } | undefined;
     }>;
     readonly style$: Observable<{
@@ -1282,13 +1322,16 @@ export declare class ChartModel extends Disposable {
         width?: number | undefined;
         height?: number | undefined;
         theme?: string | undefined;
+        palette?: string[] | undefined;
         invalidValueType?: import("..").InvalidValueType | undefined;
         gradientFill?: boolean | undefined;
         backgroundColor?: import("@univerjs/core").Nullable<string>;
         titleFontSize?: number | undefined;
         fontSize?: number | undefined;
         fontColor?: string | undefined;
+        fontFamily?: string | undefined;
         borderColor?: import("@univerjs/core").Nullable<string>;
+        borderWidth?: number | undefined;
         titles?: {
             title?: {
                 bold?: boolean | undefined;
@@ -1389,6 +1432,7 @@ export declare class ChartModel extends Disposable {
                 showMinLabel?: boolean | undefined;
             } | undefined;
             selectMode?: import("..").SelectModeEnum | undefined;
+            wrap?: boolean | undefined;
         } | undefined;
         xAxis?: {
             lineVisible?: boolean | undefined;
@@ -1469,6 +1513,7 @@ export declare class ChartModel extends Disposable {
             format?: string | undefined;
         } | undefined;
         rightYAxis?: {
+            min?: number | null | undefined;
             lineVisible?: boolean | undefined;
             label?: {
                 bold?: boolean | undefined;
@@ -1502,12 +1547,16 @@ export declare class ChartModel extends Disposable {
                 length?: number | undefined;
                 position?: import("..").PieLabelPosition | undefined;
             } | undefined;
-            min?: number | null | undefined;
             max?: number | null | undefined;
             format?: string | undefined;
         } | undefined;
         allSeriesStyle?: {
             color?: import("@univerjs/core").Nullable<string>;
+            point?: {
+                shape?: import("..").LinePointShape | undefined;
+                size?: number | undefined;
+                color?: import("@univerjs/core").Nullable<string>;
+            } | undefined;
             label?: {
                 contentType?: number | undefined;
                 position?: import("..").SeriesLabelPosition | undefined;
@@ -1534,11 +1583,7 @@ export declare class ChartModel extends Disposable {
                 dashType?: import("..").ChartBorderDashType | undefined;
             } | undefined;
             rightYAxis?: boolean | undefined;
-            point?: {
-                shape?: import("..").LinePointShape | undefined;
-                size?: number | undefined;
-                color?: import("@univerjs/core").Nullable<string>;
-            } | undefined;
+            fillOpacity?: number | undefined;
             waterfall?: {
                 positive?: {
                     chartType?: (ChartTypeBits.Line | ChartTypeBits.Column | ChartTypeBits.Area) | undefined;
@@ -1866,6 +1911,12 @@ export declare class ChartModel extends Disposable {
                 } | undefined;
             } | undefined;
         } | undefined;
+        bar?: {
+            is3D?: boolean | undefined;
+            shape?: import("..").BarShape | undefined;
+            rotX?: number | undefined;
+            rotY?: number | undefined;
+        } | undefined;
         trendlines?: import("..").ITrendLine[] | undefined;
         pie?: {
             doughnutHole?: import("@univerjs/core").Nullable<number>;
@@ -1889,6 +1940,7 @@ export declare class ChartModel extends Disposable {
             } | undefined;
             borderColor?: string | undefined;
             hasPaddingAngle?: boolean | undefined;
+            is3D?: boolean | undefined;
             isHalfPie?: boolean | undefined;
             rosePie?: boolean | undefined;
             showLabelLine?: boolean | undefined;
@@ -1929,7 +1981,15 @@ export declare class ChartModel extends Disposable {
         waterfall?: {
             stackType?: import("..").WaterfallStackTypeEnum | undefined;
             useSubtotal?: boolean | undefined;
+            pointRoles?: import("../types").IWaterfallPointRole[] | undefined;
+            connector?: boolean | {
+                color?: string | undefined;
+                width?: number | undefined;
+                opacity?: number | undefined;
+                dashType?: import("..").ChartBorderDashType | undefined;
+            } | undefined;
         } | undefined;
+        markLines?: import("../types").IChartMarkLine[] | undefined;
         tooltip?: {
             indicatorLabelColor?: string | undefined;
             indicatorLineType?: import("..").ChartBorderDashType | undefined;
@@ -2311,6 +2371,26 @@ export declare class ChartModel extends Disposable {
             visualMapType?: "continuous" | "piecewise" | undefined;
             max?: number | undefined;
             min?: number | undefined;
+            unit?: string | undefined;
+            label?: {
+                contentType?: number | undefined;
+                position?: import("..").SeriesLabelPosition | undefined;
+                visible?: boolean | undefined;
+                content?: string | undefined;
+                fontSize?: number | undefined;
+                color?: string | undefined;
+                align?: import("..").LabelAlignEnum | undefined;
+                bold?: boolean | undefined;
+                family?: string | undefined;
+                strikethrough?: boolean | undefined;
+                italic?: boolean | undefined;
+                underline?: boolean | undefined;
+                padAngle?: boolean | undefined;
+                axisTitleAlign?: import("..").AxisAlignEnum | undefined;
+                showMaxLabel?: boolean | undefined;
+                showMinLabel?: boolean | undefined;
+                rotate?: number | undefined;
+            } | undefined;
         } | undefined;
     }>;
     get style(): {
@@ -2420,13 +2500,16 @@ export declare class ChartModel extends Disposable {
         width?: number | undefined;
         height?: number | undefined;
         theme?: string | undefined;
+        palette?: string[] | undefined;
         invalidValueType?: import("..").InvalidValueType | undefined;
         gradientFill?: boolean | undefined;
         backgroundColor?: import("@univerjs/core").Nullable<string>;
         titleFontSize?: number | undefined;
         fontSize?: number | undefined;
         fontColor?: string | undefined;
+        fontFamily?: string | undefined;
         borderColor?: import("@univerjs/core").Nullable<string>;
+        borderWidth?: number | undefined;
         titles?: {
             title?: {
                 bold?: boolean | undefined;
@@ -2527,6 +2610,7 @@ export declare class ChartModel extends Disposable {
                 showMinLabel?: boolean | undefined;
             } | undefined;
             selectMode?: import("..").SelectModeEnum | undefined;
+            wrap?: boolean | undefined;
         } | undefined;
         xAxis?: {
             lineVisible?: boolean | undefined;
@@ -2607,6 +2691,7 @@ export declare class ChartModel extends Disposable {
             format?: string | undefined;
         } | undefined;
         rightYAxis?: {
+            min?: number | null | undefined;
             lineVisible?: boolean | undefined;
             label?: {
                 bold?: boolean | undefined;
@@ -2640,12 +2725,16 @@ export declare class ChartModel extends Disposable {
                 length?: number | undefined;
                 position?: import("..").PieLabelPosition | undefined;
             } | undefined;
-            min?: number | null | undefined;
             max?: number | null | undefined;
             format?: string | undefined;
         } | undefined;
         allSeriesStyle?: {
             color?: import("@univerjs/core").Nullable<string>;
+            point?: {
+                shape?: import("..").LinePointShape | undefined;
+                size?: number | undefined;
+                color?: import("@univerjs/core").Nullable<string>;
+            } | undefined;
             label?: {
                 contentType?: number | undefined;
                 position?: import("..").SeriesLabelPosition | undefined;
@@ -2672,11 +2761,7 @@ export declare class ChartModel extends Disposable {
                 dashType?: import("..").ChartBorderDashType | undefined;
             } | undefined;
             rightYAxis?: boolean | undefined;
-            point?: {
-                shape?: import("..").LinePointShape | undefined;
-                size?: number | undefined;
-                color?: import("@univerjs/core").Nullable<string>;
-            } | undefined;
+            fillOpacity?: number | undefined;
             waterfall?: {
                 positive?: {
                     chartType?: (ChartTypeBits.Line | ChartTypeBits.Column | ChartTypeBits.Area) | undefined;
@@ -3004,6 +3089,12 @@ export declare class ChartModel extends Disposable {
                 } | undefined;
             } | undefined;
         } | undefined;
+        bar?: {
+            is3D?: boolean | undefined;
+            shape?: import("..").BarShape | undefined;
+            rotX?: number | undefined;
+            rotY?: number | undefined;
+        } | undefined;
         trendlines?: import("..").ITrendLine[] | undefined;
         pie?: {
             doughnutHole?: import("@univerjs/core").Nullable<number>;
@@ -3027,6 +3118,7 @@ export declare class ChartModel extends Disposable {
             } | undefined;
             borderColor?: string | undefined;
             hasPaddingAngle?: boolean | undefined;
+            is3D?: boolean | undefined;
             isHalfPie?: boolean | undefined;
             rosePie?: boolean | undefined;
             showLabelLine?: boolean | undefined;
@@ -3067,7 +3159,15 @@ export declare class ChartModel extends Disposable {
         waterfall?: {
             stackType?: import("..").WaterfallStackTypeEnum | undefined;
             useSubtotal?: boolean | undefined;
+            pointRoles?: import("../types").IWaterfallPointRole[] | undefined;
+            connector?: boolean | {
+                color?: string | undefined;
+                width?: number | undefined;
+                opacity?: number | undefined;
+                dashType?: import("..").ChartBorderDashType | undefined;
+            } | undefined;
         } | undefined;
+        markLines?: import("../types").IChartMarkLine[] | undefined;
         tooltip?: {
             indicatorLabelColor?: string | undefined;
             indicatorLineType?: import("..").ChartBorderDashType | undefined;
@@ -3449,6 +3549,26 @@ export declare class ChartModel extends Disposable {
             visualMapType?: "continuous" | "piecewise" | undefined;
             max?: number | undefined;
             min?: number | undefined;
+            unit?: string | undefined;
+            label?: {
+                contentType?: number | undefined;
+                position?: import("..").SeriesLabelPosition | undefined;
+                visible?: boolean | undefined;
+                content?: string | undefined;
+                fontSize?: number | undefined;
+                color?: string | undefined;
+                align?: import("..").LabelAlignEnum | undefined;
+                bold?: boolean | undefined;
+                family?: string | undefined;
+                strikethrough?: boolean | undefined;
+                italic?: boolean | undefined;
+                underline?: boolean | undefined;
+                padAngle?: boolean | undefined;
+                axisTitleAlign?: import("..").AxisAlignEnum | undefined;
+                showMaxLabel?: boolean | undefined;
+                showMinLabel?: boolean | undefined;
+                rotate?: number | undefined;
+            } | undefined;
         } | undefined;
     };
     get config(): IChartConfig | null;
@@ -3461,8 +3581,11 @@ export declare class ChartModel extends Disposable {
     };
     getRuntimeContext(direction?: ChartStyle['direction']): IChartRuntimeContext;
     applyStyle(newStyle: ChartStyle): void;
+    replaceStyle(style: ChartStyle): void;
     assignChartContext(context: Partial<IChartContext>): void;
+    replaceChartContext(context: IChartContext): void;
     assignDataAggregation(config: Partial<IChartDataAggregation>): void;
+    replaceDataAggregation(config: IChartDataAggregation): void;
     setChartType(type: ChartTypeBits): void;
     serialize(): IChartSnapshot;
     onDispose(effect: () => void): void;

package/lib/types/models/chart-resource-serializer.d.ts

@@ -0,0 +1,10 @@
+import type { ChartStyle } from '../types';
+interface IChartResourceSnapshot {
+    style?: ChartStyle;
+}
+interface IChartResourceEnvelope<TChart extends IChartResourceSnapshot> {
+    charts: Record<string, TChart>;
+}
+/** Serializes a host chart resource while omitting non-canonical empty chart palettes. */
+export declare function serializeChartResource<TChart extends IChartResourceSnapshot, TResource extends IChartResourceEnvelope<TChart>>(resource: TResource): string;
+export {};

package/lib/types/models/chart-semantic-axes.d.ts

@@ -0,0 +1,4 @@
+import type { IChartAxisBinding, IRuntimeAxis } from '../types';
+import { ChartSemanticAxis, ChartTypeBits } from '../enum';
+/** Maps the renderer's transient axes to stable semantic roles used by Facade readback. */
+export declare function resolveChartSemanticAxisBindings(type: ChartTypeBits, axes: readonly IRuntimeAxis[]): Partial<Record<ChartSemanticAxis, IChartAxisBinding>> | undefined;

package/lib/types/models/constants/default-chart-style.d.ts

@@ -1,5 +1,5 @@
 import type { ChartStyle } from '../../types';
-import { AreaLineStyle, AxisAlignEnum, ChartBorderDashType, ChartTypeBits, InvalidValueType, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, SelectModeEnum, SeriesLabelPosition, TextAlign, TitlePositionEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from '../../enum';
+import { AreaLineStyle, AxisAlignEnum, BarShape, ChartBorderDashType, ChartTypeBits, InvalidValueType, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, SelectModeEnum, SeriesLabelPosition, TextAlign, TitlePositionEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from '../../enum';
 export declare const themeColors: string[];
 export declare const RTLChartStyle: ChartStyle;
 export declare const defaultChartConfig: {
@@ -47,6 +47,12 @@ export declare const defaultChartConfig: {
     area: {
         lineStyle: AreaLineStyle;
     };
+    bar: {
+        is3D: boolean;
+        shape: BarShape;
+        rotX: number;
+        rotY: number;
+    };
     labelContentType: LabelContentType;
     pie: {
         labelContentType: number;
@@ -55,6 +61,7 @@ export declare const defaultChartConfig: {
         borderColor: string;
         labelPosition: PieLabelPosition;
         hasPaddingAngle: boolean;
+        is3D: boolean;
     };
     combination: {
         firstChartType: ChartTypeBits;
@@ -76,6 +83,14 @@ export declare const defaultChartConfig: {
     waterfall: {
         stackType: WaterfallStackTypeEnum;
         useSubtotal: boolean;
+        pointRoles: never[];
+        connector: boolean;
+        connectorStyle: {
+            color: string;
+            width: number;
+            opacity: number;
+            dashType: ChartBorderDashType;
+        };
         subtotalColor: string;
     };
     trendline: {
@@ -88,6 +103,11 @@ export declare const defaultChartConfig: {
         showFormula: boolean;
         showR2: boolean;
     };
+    semanticLine: {
+        width: number;
+        opacity: number;
+        dashType: ChartBorderDashType;
+    };
     relation: {
         force: {
             gravity: number;

package/lib/types/models/mode-converter/converters/waterfall-layout.d.ts

@@ -0,0 +1,34 @@
+import type { IChartDataSeries, IWaterfallPointRole } from '../../../types';
+import { ChartWaterfallPointRole } from '../../../enum';
+export declare enum WaterfallPointClassification {
+    Increase = "increase",
+    Decrease = "decrease",
+    Total = "total"
+}
+export interface IResolvedWaterfallPoint {
+    seriesIndex: number;
+    dataPointIndex: number;
+    categoryIndex: number;
+    role: ChartWaterfallPointRole;
+    classification: WaterfallPointClassification;
+    value: number;
+    start: number;
+    end: number;
+}
+export interface IResolvedWaterfallConnector {
+    from: {
+        categoryIndex: number;
+        value: number;
+    };
+    to: {
+        categoryIndex: number;
+        value: number;
+    };
+}
+export interface IResolvedWaterfallLayout {
+    points: IResolvedWaterfallPoint[];
+    connectors: IResolvedWaterfallConnector[];
+    cumulative: number;
+}
+/** Resolves persisted Waterfall semantics without renderer or theme concerns. */
+export declare function resolveArrangementWaterfallLayout(series: IChartDataSeries[], roles?: readonly IWaterfallPointRole[]): IResolvedWaterfallLayout;

package/lib/types/models/mode-converter/render-spec-operators/mark-line.operator.d.ts

@@ -0,0 +1,3 @@
+import type { EChartRenderSpecOperator } from '../../../types';
+/** Attaches persisted semantic fixed-axis lines to visible business series. */
+export declare const markLineOperator: EChartRenderSpecOperator;

package/lib/types/models/mode-converter/render-spec-operators/tools.d.ts

@@ -1,12 +1,11 @@
-import type { ChartStyle, EChartSeriesItem, EChartSpec, IChartConfig, ILabelStyle } from '../../../types';
+import type { ChartStyle, EChartSeriesItem, EChartSpec, ILabelStyle } from '../../../types';
 import type { ISpecGrid } from './operator-types';
-type PartialLabelStyle = Partial<Pick<ILabelStyle, 'visible' | 'color' | 'fontSize' | 'italic' | 'bold' | 'underline' | 'strikethrough' | 'showMaxLabel' | 'showMinLabel'>>;
+type PartialLabelStyle = Partial<Pick<ILabelStyle, 'visible' | 'color' | 'fontSize' | 'family' | 'italic' | 'bold' | 'underline' | 'strikethrough' | 'showMaxLabel' | 'showMinLabel'>>;
 export declare function applyLabelStyle(spec: Record<string, any>, path: string, labelStyle: PartialLabelStyle): void;
 export declare function applyLineStyle(spec: Record<string, any>, path: string, labelStyle: PartialLabelStyle): void;
 export declare function toArray<T = unknown>(value: T | T[]): T[];
 export declare function seriesForEach(series: EChartSpec['series'], func: (item: EChartSeriesItem, index: number) => void): void;
 export declare function toPercentage(value: number, fixed?: number): string;
-export declare const getLegendOrSeriesMaxWidth: (gridInfo: ISpecGrid, config: IChartConfig, style: ChartStyle) => number;
 export declare const getCategoryLabelVertical: (gridInfo: ISpecGrid, style: ChartStyle) => number;
 export declare const getCategoryLabelHorizontal: (gridInfo: ISpecGrid, style: ChartStyle, seriesCount: number, axisLabelMaxWidth?: number) => number;
 export declare const getIntegerValue: (value: number, digit?: number) => number;

package/lib/types/source/chart-data-item.d.ts

@@ -0,0 +1,3 @@
+import type { IChartDataItem } from '../types';
+/** Normalizes a host cell value for semantic chart-series inspection. */
+export declare function toChartDataItem(value: unknown): IChartDataItem;

package/lib/types/types.d.ts

@@ -1,6 +1,6 @@
 import type { IDisposable, Nullable } from '@univerjs/core';
 import type { Observable } from 'rxjs';
-import type { AreaLineStyle, AxisAlignEnum, AxisValueType, CategoryType, ChartBorderDashType, ChartSourceDataTypeEnum, ChartTrendlineType, ChartTypeBits, DataOrientation, InvalidValueType, IRuntimeAxisPosition, IRuntimeAxisPriority, LabelAlignEnum, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, WaterfallSeriesTypeEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from './enum';
+import type { AreaLineStyle, AxisAlignEnum, AxisValueType, BarShape, CategoryType, ChartAxisDimension, ChartBorderDashType, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartSourceDataTypeEnum, ChartTrendlineType, ChartTypeBits, ChartWaterfallPointRole, DataOrientation, InvalidValueType, IRuntimeAxisPosition, IRuntimeAxisPriority, LabelAlignEnum, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, WaterfallSeriesTypeEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from './enum';
 import type { ICartesianPointData } from './models/chart-data-operators/cartesian-point-data';
 import type { IChartLocaleTexts } from './models/chart-locale-texts';
 import type { IEchartTheme } from './models/constants/build-in-theme';
@@ -188,6 +188,8 @@ export interface ILegendStyle {
     position?: LegendPositionEnum;
     label?: Omit<ILabelStyle, 'visible' | 'align' | 'content'>;
     selectMode?: SelectModeEnum;
+    /** Allow a horizontal legend to flow onto multiple rows instead of using pagination. */
+    wrap?: boolean;
 }
 export interface IGridLineStyle {
     visible: boolean;
@@ -259,7 +261,7 @@ export interface ISeriesStyle {
     };
 }
 export type RightYAxisOptions = Omit<IAxisOptions, 'reverse'>;
-export interface IAllSeriesStyle extends Pick<ISeriesStyle, 'border' | 'label' | 'rightYAxis' | 'point' | 'color' | 'waterfall'> {
+export interface IAllSeriesStyle extends Pick<ISeriesStyle, 'border' | 'label' | 'rightYAxis' | 'point' | 'color' | 'fillOpacity' | 'waterfall'> {
 }
 export interface ITrendLine {
     seriesIndex: number;
@@ -276,6 +278,51 @@ export interface ITrendLine {
     r2Color?: string;
     formulaColor?: string;
 }
+export interface IWaterfallPointRole {
+    seriesIndex: number;
+    dataPointIndex: number;
+    role: ChartWaterfallPointRole;
+}
+export interface IWaterfallConnectorStyle {
+    color?: string;
+    width?: number;
+    opacity?: number;
+    dashType?: ChartBorderDashType;
+}
+export interface IChartAxisBinding {
+    dimension: ChartAxisDimension;
+    position: IRuntimeAxisPosition;
+}
+export interface IChartMarkLineLabel {
+    visible?: boolean;
+    text?: string;
+    position?: ChartMarkLineLabelPosition;
+    color?: string;
+    fontSize?: number;
+    bold?: boolean;
+}
+export type IChartMarkLine = {
+    label?: IChartMarkLineLabel;
+    color?: string;
+    width?: number;
+    opacity?: number;
+    dashType?: ChartBorderDashType;
+} & ({
+    axis: ChartSemanticAxis.Category | ChartSemanticAxis.SecondaryCategory;
+    categoryIndex: number;
+} | {
+    axis: ChartSemanticAxis.PrimaryValue | ChartSemanticAxis.SecondaryValue;
+    value: number;
+});
+export interface IBarStyle {
+    /** Exchange metadata. Renderers without 3D support may ignore these fields. */
+    is3D: boolean;
+    shape: BarShape;
+    /** OOXML view rotation around the horizontal axis, in degrees. */
+    rotX: number;
+    /** OOXML view rotation around the vertical axis, in degrees. */
+    rotY: number;
+}
 export interface IChartStyle {
     runtime: IChartRuntimeContext;
     /** Runtime-only locale direction. It must not be persisted in chart snapshots. */
@@ -283,13 +330,17 @@ export interface IChartStyle {
     width: number;
     height: number;
     theme: string;
+    /** Persisted absolute series colors. A non-empty value overrides theme colors. */
+    palette?: string[];
     invalidValueType: InvalidValueType;
     gradientFill: boolean;
     backgroundColor: Nullable<string>;
     titleFontSize: number;
     fontSize: number;
     fontColor: string;
+    fontFamily: string;
     borderColor: Nullable<string>;
+    borderWidth: number;
     titles: {
         title: Omit<ILabelStyle, 'visible'>;
         subtitle: Omit<ILabelStyle, 'visible'>;
@@ -310,6 +361,7 @@ export interface IChartStyle {
     seriesStyleMap: {
         [id: string]: ISeriesStyle;
     };
+    bar: IBarStyle;
     trendlines: ITrendLine[];
     pie: {
         doughnutHole: Nullable<number>;
@@ -318,6 +370,8 @@ export interface IChartStyle {
         labelStyle: IPieLabelStyle;
         borderColor: string;
         hasPaddingAngle: boolean;
+        /** Exchange metadata. Renderers without 3D support may ignore this field. */
+        is3D: boolean;
         isHalfPie: boolean;
         rosePie: boolean;
         showLabelLine: boolean;
@@ -354,7 +408,10 @@ export interface IChartStyle {
     waterfall: {
         stackType: WaterfallStackTypeEnum;
         useSubtotal: boolean;
+        pointRoles: IWaterfallPointRole[];
+        connector: boolean | IWaterfallConnectorStyle;
     };
+    markLines: IChartMarkLine[];
     tooltip: {
         indicatorLabelColor: string;
         indicatorLineType: ChartBorderDashType;
@@ -370,6 +427,8 @@ export interface IChartStyle {
         visualMapType: 'continuous' | 'piecewise';
         max?: number;
         min?: number;
+        unit?: string;
+        label?: ISeriesLabelStyle;
     };
 }
 export interface IRelationForceOptions {

package/lib/types/util.d.ts

@@ -5,6 +5,7 @@ export declare const chartBitsUtils: {
     remove(bit: number, attribute: number): number;
     chartBitToString(bit: ChartTypeBits): "" | "line" | "bar" | "wordCloud" | "scatter" | "pie" | "radar" | "graph" | "funnel" | "sankey" | "boxplot" | "heatmap" | "combination";
 };
+export declare function mergeChartConfig<T extends object>(current: T | undefined, update: Partial<T>): T;
 export declare const setProperty: (data: Record<string, any>, propertyPath: string, value: any) => void;
 export declare const getProperty: <T = any>(data: Record<string, any> | undefined, propertyPath: string) => T | undefined;
 /**
@@ -17,15 +18,12 @@ interface ISize {
     width: number;
     height: number;
 }
-export declare const ChartTextMeasureCache: Map<string, ISize>;
 export declare const calcPosition: (text: string, font: string) => ISize;
-export declare const clearChartTextMeasureCache: () => void;
 /**
  * We define the chart type can use trend line. In excel it also can use for combined chart ro bar chart.
  * @param {ChartTypeBits} chartType The test chart type.
  * @returns {boolean} If the chart type can use trend line, return true, otherwise return false.
  */
 export declare const chartTypeCanUseTrendLine: (chartType: ChartTypeBits) => boolean;
-export declare const numfmtRedCache: Map<string, boolean>;
 export declare function isNegativeRedCached(fmt: string): boolean | undefined;
 export {};