@univerjs-pro/engine-chart 0.6.10 → 0.7.0-beta.1

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;
@@ -13,6 +13,7 @@ export declare const defaultChartConfig: {
         labelVisible: boolean;
         reverse: boolean;
         titleAlign: AxisAlignEnum;
+        dateAxisRotate: number;
     };
     legend: {
         position: LegendPositionEnum;
@@ -70,6 +71,11 @@ export declare const defaultChartConfig: {
         maskImage: string;
         repeat: boolean;
     };
+    waterfall: {
+        stackType: WaterfallStackTypeEnum;
+        useSubtotal: boolean;
+        subtotalColor: string;
+    };
     trendline: {
         period: number;
         order: number;
@@ -93,4 +99,9 @@ export declare const defaultChartConfig: {
     tooltipAxisLabelBackground: string;
     tooltipAxisLabelColor: string;
     indicatorLineType: ChartBorderDashType;
+    formatStyle: {
+        red: {
+            color: string;
+        };
+    };
 };

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/tool-tip-operator.d.ts

@@ -1,2 +1,3 @@
 import { EChartRenderSpecOperator } from '../../../types';
+export declare function excelDateToUnixMilliseconds(excelDate: number, useDefault1900DateSystem?: boolean): number;
 export declare const toolTipStyleOperator: 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/source/source-util.d.ts

@@ -1,2 +1,6 @@
 import { OptionDataValue } from '../types';
-export declare function getCategoryData(source: OptionDataValue[][], categoryIndex: number, isRowDirection: boolean): OptionDataValue[];
+import { ChartSourceDataTypeEnum } from '../enum';
+export declare function getCategoryData(source: OptionDataValue[][], categoryIndex: number, isRowDirection: boolean, sourceType: ChartSourceDataTypeEnum[][]): {
+    categoryData: OptionDataValue[];
+    isAllDateTime: boolean;
+};

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, 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]>;
@@ -27,11 +28,16 @@ export type OptionDataValue = string | number | Date | null | undefined;
 export interface IUniverDataSet {
     source: OptionDataValue[][];
     dimensions: Array<DimensionDefinitionLoose>;
+    sourceType?: ChartSourceDataTypeEnum[][];
 }
 export interface IChartContext {
     headers?: string[];
     categoryType?: CategoryType;
     categoryIndex?: number;
+    /**
+     * the flag to indicate whether the chart use date axis, only all category data is date type, the chart will use date axis, if there are some string type data, the chart will use category axis even the flag is true.
+     */
+    useDateAxis?: boolean;
     categoryResourceIndexes?: number[];
     seriesIndexes?: number[];
     seriesResourceIndexes?: number[];
@@ -108,6 +114,7 @@ export interface IChartDataCategory {
     index: number;
     name: string;
     type: CategoryType;
+    useDateAxis: boolean;
     items: IChartDataItem[];
     keys: string[];
 }
@@ -131,7 +138,6 @@ export interface IChartRuntimeContext {
     themeInfo: IEchartTheme;
     hasSecondaryAxis: boolean;
     localeService: LocaleService;
-    emptyTips: string;
     wordCloudImageMaskMap: Map<string, HTMLImageElement>;
 }
 export interface ILabelStyle {
@@ -176,6 +182,7 @@ export interface IAxisOptions {
     reverse?: boolean;
     min?: number | null;
     max?: number | null;
+    format?: string;
 }
 export interface ISeriesLabelStyle extends ILabelStyle {
     contentType: number;
@@ -208,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;
@@ -290,6 +308,10 @@ export interface IChartStyle {
             rotateLabel: boolean;
         };
     };
+    waterfall: {
+        stackType: WaterfallStackTypeEnum;
+        useSubtotal: boolean;
+    };
     tooltip: {
         indicatorLabelColor: string;
         indicatorLineType: ChartBorderDashType;
@@ -318,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;
@@ -362,3 +388,7 @@ export interface IChartHostRect {
     width: number;
     height: number;
 }
+export type WaterfallBarSeriesOptionType = BarSeriesOption & {
+    baseSeriesIndex: string;
+    waterfallSeriesType: WaterfallSeriesTypeEnum;
+};

package/lib/types/util.d.ts

@@ -25,4 +25,6 @@ export declare const clearChartTextMeasureCache: () => void;
  * @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 {};