@univerjs-pro/engine-chart 0.6.10-experimental.20250424-9e348ed → 0.6.10-experimental.20250427-89a0949

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

@@ -1,4 +1,4 @@
-import { AreaLineStyle, AxisAlignEnum, ChartBorderDashType, ChartTypeBits, InvalidValueType, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, SelectModeEnum, SeriesLabelPosition, TextAlign, TitlePositionEnum } from '../../enum';
+import { AreaLineStyle, AxisAlignEnum, ChartBorderDashType, ChartTypeBits, InvalidValueType, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, SelectModeEnum, SeriesLabelPosition, TextAlign, TitlePositionEnum, WaterfallStackTypeEnum } from '../../enum';
 export declare const themeColors: string[];
 export declare const defaultChartConfig: {
     allSeriesId: string;
@@ -71,6 +71,11 @@ export declare const defaultChartConfig: {
         maskImage: string;
         repeat: boolean;
     };
+    waterfall: {
+        stackType: WaterfallStackTypeEnum;
+        useSubtotal: boolean;
+        subtotalColor: string;
+    };
     trendline: {
         period: number;
         order: number;

package/lib/types/model/mode-converter/converters/tools.d.ts

@@ -3,3 +3,13 @@ export declare function createLabelMap(config: IChartConfig): {
     categoryNameMap: Record<string, string>;
     seriesNameMap: Record<string, string>;
 };
+/**
+ * Generate colors for positive, negative, and subtotal values based on a base theme color.
+ * @param themeColor The base color in hex format (e.g., "#3498db").
+ * @returns An object containing colors for positive, negative, and subtotal values.
+ */
+export declare const generateSeriesColors: (themeColor: string) => {
+    positiveColor: string;
+    negativeColor: string;
+    subtotalColor: string;
+};

package/lib/types/model/mode-converter/converters/waterfall-chart-converter.d.ts

@@ -0,0 +1,2 @@
+import { EChartSpec, IChartRenderSpecConverter } from '../../../types';
+export declare const waterfallChartConverter: IChartRenderSpecConverter<EChartSpec>;

package/lib/types/model/mode-converter/render-spec-operators/series-style-operator/waterfall-series-style-operator.d.ts

@@ -0,0 +1,3 @@
+import { EChartRenderSpecOperator } from '../../../../types';
+export declare const waterfallSeriesStyleOperator: EChartRenderSpecOperator;
+export declare const waterfallSeriesDataLabelHandler: EChartRenderSpecOperator;

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

@@ -10,4 +10,15 @@ export declare const getLegendOrSeriesMaxWidth: (gridInfo: ISpecGrid, config: IC
 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;
+export declare const getGradientColor: (color: string, gradientFill: boolean) => string | {
+    gradient: string;
+    x: number;
+    y: number;
+    x2: number;
+    y2: number;
+    colorStops: {
+        offset: number;
+        color: string;
+    }[];
+};
 export {};

package/lib/types/types.d.ts

@@ -1,6 +1,7 @@
 import { CellValue, IDisposable, LocaleService, Nullable } from '@univerjs/core';
+import { BarSeriesOption } from 'echarts';
 import { Observable } from 'rxjs';
-import { AreaLineStyle, AxisAlignEnum, AxisValueType, CategoryType, ChartBorderDashType, ChartSourceDataTypeEnum, ChartTrendlineType, ChartTypeBits, DataOrientation, InvalidValueType, IRuntimeAxisPosition, IRuntimeAxisPriority, LabelAlignEnum, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, WordCloudShapeEnum } from './enum';
+import { 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 { IEchartTheme } from './model/constants/build-in-theme';
 export type DeepPartial<T> = T extends Record<string, any> ? T extends any[] ? T : {
     [key in keyof T]+?: DeepPartial<T[key]>;
@@ -214,9 +215,20 @@ export interface ISeriesStyle {
     dataPoints: {
         [index: number]: IDataPointStyle;
     };
+    waterfall: {
+        positive: ISeriesStyle & {
+            name: string;
+        };
+        negative: ISeriesStyle & {
+            name: string;
+        };
+        subtotal: ISeriesStyle & {
+            name: string;
+        };
+    };
 }
 export type RightYAxisOptions = Omit<IAxisOptions, 'reverse'>;
-export interface IAllSeriesStyle extends Pick<ISeriesStyle, 'border' | 'label' | 'rightYAxis' | 'point' | 'color'> {
+export interface IAllSeriesStyle extends Pick<ISeriesStyle, 'border' | 'label' | 'rightYAxis' | 'point' | 'color' | 'waterfall'> {
 }
 export interface ITrendLine {
     seriesIndex: number;
@@ -296,6 +308,10 @@ export interface IChartStyle {
             rotateLabel: boolean;
         };
     };
+    waterfall: {
+        stackType: WaterfallStackTypeEnum;
+        useSubtotal: boolean;
+    };
     tooltip: {
         indicatorLabelColor: string;
         indicatorLineType: ChartBorderDashType;
@@ -324,6 +340,10 @@ export interface IChartSnapshot {
     style?: ChartStyle;
     dataAggregation?: IChartDataAggregation;
 }
+export interface IWaterfallLegendData {
+    name: string;
+    color: string;
+}
 export interface IChartRenderSpecConverter<ChartRenderSpec = Record<string, any>> {
     canConvert: (config: IChartConfig) => boolean;
     convert: (config: IChartConfig, style: ChartStyle) => ChartRenderSpec;
@@ -368,3 +388,7 @@ export interface IChartHostRect {
     width: number;
     height: number;
 }
+export type WaterfallBarSeriesOptionType = BarSeriesOption & {
+    baseSeriesIndex: string;
+    waterfallSeriesType: WaterfallSeriesTypeEnum;
+};