@univerjs-pro/engine-chart 1.0.0-alpha.6 → 1.0.0-alpha.8

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

@@ -129,8 +129,53 @@ export declare const defaultChartConfig: {
     };
     pareto: {
         symbolSize: number;
+        barThemeColorIndex: number;
+        lineThemeColorIndex: number;
     };
     heatmap: {
         visualMapType: string;
     };
+    candlestick: {
+        rising: {
+            color: string;
+            fillOpacity: number;
+            border: {
+                color: string;
+                width: number;
+                opacity: number;
+            };
+            hollow: boolean;
+        };
+        falling: {
+            color: string;
+            fillOpacity: number;
+            border: {
+                color: string;
+                width: number;
+                opacity: number;
+            };
+            hollow: boolean;
+        };
+        doji: {
+            color: string;
+            fillOpacity: number;
+            border: {
+                color: string;
+                width: number;
+                opacity: number;
+            };
+            hollow: boolean;
+        };
+    };
+    histogram: {
+        binGap: number;
+        legendVisible: boolean;
+    };
+    treemap: {
+        parentLabelLayout: "banner";
+        label: {
+            visible: boolean;
+            contentType: LabelContentType;
+        };
+    };
 };

package/lib/types/models/constants/histogram-defaults.d.ts

@@ -0,0 +1,4 @@
+/** Ratio of each category band reserved as the default separator between Histogram bins. */
+export declare const DEFAULT_HISTOGRAM_BIN_GAP = 0.007;
+/** Largest supported ratio of a category band reserved between Histogram bins. */
+export declare const MAX_HISTOGRAM_BIN_GAP = 0.9;

package/lib/types/models/constants/treemap.d.ts

@@ -0,0 +1 @@
+export declare const TREEMAP_MAPPING_DIAGNOSTIC = "Treemap requires at least one hierarchy field and one numeric value field.";

package/lib/types/models/data-context-transformers/candlestick-data-context-transformer.d.ts

@@ -0,0 +1,4 @@
+import type { ChartModel } from '../chart-model';
+import { ChartTypeBits } from '../../enum';
+/** Transforms canonical context when entering or leaving the Candlestick type. */
+export declare function candlestickDataContextTransformer(fromType: ChartTypeBits, toType: ChartTypeBits, model: ChartModel): void;

package/lib/types/models/data-context-transformers/histogram-data-context-transformer.d.ts

@@ -0,0 +1,7 @@
+import type { IChartContext, IChartDataSource } from '../../types';
+import type { ChartModel } from '../chart-model';
+import { ChartTypeBits } from '../../enum';
+/** Selects the first finite-numeric source field without using header text. */
+export declare function resolveHistogramField(dataSource: IChartDataSource, context: IChartContext): number | undefined;
+/** Stashes normal mappings while Histogram owns exactly one active value field. */
+export declare function histogramDataContextTransformer(fromType: ChartTypeBits, toType: ChartTypeBits, model: ChartModel): void;

package/lib/types/models/data-context-transformers/treemap-data-context-transformer.d.ts

@@ -0,0 +1,11 @@
+import type { IChartDataSource } from '../../types';
+import type { ChartModel } from '../chart-model';
+import { ChartTypeBits } from '../../enum';
+export interface IResolvedTreemapMapping {
+    hierarchyIndexes: number[];
+    seriesIndexes: [number];
+}
+/** Infers the last field containing finite numeric data as value and all preceding fields as hierarchy. */
+export declare function resolveTreemapMapping(dataSource: IChartDataSource): IResolvedTreemapMapping | undefined;
+/** Stashes ordinary category/series mapping while Treemap owns hierarchy plus one value. */
+export declare function treemapDataContextTransformer(fromType: ChartTypeBits, toType: ChartTypeBits, model: ChartModel): void;

package/lib/types/models/echart-render-model.d.ts

@@ -1,4 +1,5 @@
-import type { ChartElementEventHandler, ChartElementEventType, ChartImageSource, ChartStyle, EChartInstance, EChartSpec, IChartConfig, IChartHostRect, IChartInstance, IChartRenderAsImageOptions, IChartRenderInstance, IChartRenderInstanceCreateContext, IChartRenderModel, IChartRenderModelImageExportInput, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IChartRenderModelStylizeInit, IChartRenderRuntimeOptions } from '../types';
+import type { ChartElementEventHandler, ChartElementEventType, ChartImageSource, ChartStyle, EChartInstance, IChartConfig, IChartElementHit, IChartHostRect, IChartInstance, IChartRenderAsImageOptions, IChartRenderInstance, IChartRenderInstanceCreateContext, IChartRenderModel, IChartRenderModelImageExportInput, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IChartRenderModelStylizeInit, IChartRenderRuntimeOptions } from '../types';
+import type { EChartsOption } from '../utils/echarts';
 import type { IWordCloudRenderConfig } from '../wordcloud-chart/word-cloud-render-config';
 import { Disposable } from '@univerjs/core';
 import { ChartHostRenderMode } from '../types';
@@ -14,17 +15,19 @@ export declare class EChartRenderModel extends Disposable implements IChartRende
     updateWatermark(addWatermark: boolean): void;
     private _addSpecConverters;
     private _addSpecOperators;
-    createChartInstance(): IChartInstance<EChartSpec>;
-    createChartInstance(mode: ChartHostRenderMode, context?: IChartRenderInstanceCreateContext<EChartSpec>): IChartRenderInstance;
+    createChartInstance(): IChartInstance<EChartsOption>;
+    createChartInstance(mode: ChartHostRenderMode, context?: IChartRenderInstanceCreateContext<EChartsOption>): IChartRenderInstance;
     clearRuntimeCache(chartId: string): void;
     clearAllRuntimeCache(): void;
     dispose(): void;
-    toSpec(config: IChartConfig, style: ChartStyle): import("echarts").EChartsOption;
-    stylizeSpec(spec: EChartSpec, stylizeInit: IChartRenderModelStylizeInit<EChartSpec>, rect: IChartHostRect): import("echarts").EChartsOption | {
+    toSpec(config: IChartConfig, style: ChartStyle): EChartsOption;
+    stylizeSpec(spec: EChartsOption, stylizeInit: IChartRenderModelStylizeInit<EChartsOption>, rect: IChartHostRect): EChartsOption | {
         backgroundColor: string;
     };
     exportImage(input: IChartRenderModelImageExportInput, options?: IChartRenderModelImageExportOptions): Promise<IChartRenderModelImageExportResult>;
 }
+/** Normalizes renderer-private marks, including Treemap residual leaves, to their semantic identity. */
+export declare function resolveEChartSeriesIdentity(spec: EChartsOption | null, seriesIndex: number | undefined, params?: any): Pick<IChartElementHit, 'seriesId' | 'seriesName' | 'baseSeriesIndex' | 'waterfallSeriesType'>;
 export declare class EChartRenderEngine extends Disposable implements EChartInstance {
     static engineName: string;
     private _instance;
@@ -47,8 +50,8 @@ export declare class EChartRenderEngine extends Disposable implements EChartInst
     resize(echartsProviderOrOptions?: any | IChartRenderRuntimeOptions): void;
     private _ensureChartInstance;
     get containerElement(): HTMLElement | null;
-    render(spec: EChartSpec, echartsProviderOrOptions?: any | IChartRenderRuntimeOptions): void;
-    renderAsImage(spec: EChartSpec, options: IChartRenderAsImageOptions): Promise<ChartImageSource>;
+    render(spec: EChartsOption, echartsProviderOrOptions?: any | IChartRenderRuntimeOptions): void;
+    renderAsImage(spec: EChartsOption, options: IChartRenderAsImageOptions): Promise<ChartImageSource>;
     on(type: ChartElementEventType, handler: ChartElementEventHandler): {
         dispose: () => void;
     };

package/lib/types/models/echart-to-chart-model-init.d.ts

@@ -1,3 +1,4 @@
+import type { EChartsOption } from '../utils/echarts';
 import type { IChartModelInitParams } from './mode-converter/mode-converter';
-export declare function echartToChartModelInit(echartOption: echarts.EChartsOption): IChartModelInitParams;
+export declare function echartToChartModelInit(echartOption: EChartsOption): IChartModelInitParams;
 export declare function isChartModelInit(option: any): option is IChartModelInitParams;

package/lib/types/models/mode-converter/converters/boxplot-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const boxplotChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const boxplotChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/bubble-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const bubbleChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const bubbleChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/candlestick-chart-converter.d.ts

@@ -0,0 +1,5 @@
+import type { IChartCandlestickPoint, IChartRenderSpecConverter } from '../../../types';
+import type { EChartsOption } from '../../../utils/echarts';
+import { ChartCandlestickState } from '../../../enum';
+export declare function classifyCandlestickPoint(point: Pick<IChartCandlestickPoint, 'open' | 'close'>): ChartCandlestickState;
+export declare const candlestickChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/combination-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const combinationChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const combinationChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/funnel-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const funnelChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const funnelChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/heatmap-chart-convert.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const heatmapChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const heatmapChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/histogram-chart-converter.d.ts

@@ -0,0 +1,4 @@
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartHistogramBin, IChartRenderSpecConverter } from '../../../types';
+export declare function createHistogramIntervalFormatter(bins: readonly IChartHistogramBin[], pattern?: string): (bin: IChartHistogramBin, index: number) => string;
+export declare const histogramChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/pareto-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const paretoChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const paretoChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/pie-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const pieChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const pieChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/radar-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const radarChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const radarChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/relation-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const relationChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const relationChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/sankey-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const sankeyChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const sankeyChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/scatter-chart-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const scatterChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const scatterChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/converters/treemap-chart-converter.d.ts

@@ -0,0 +1,4 @@
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const TREEMAP_RESIDUAL_ID_PREFIX = "__univer_treemap_residual__:";
+export declare const treemapChartConverter: IChartRenderSpecConverter<EChartsOption>;

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

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

package/lib/types/models/mode-converter/converters/word-cloud-converter.d.ts

@@ -1,2 +1,3 @@
-import type { EChartSpec, IChartRenderSpecConverter } from '../../../types';
-export declare const wordCloudChartConverter: IChartRenderSpecConverter<EChartSpec>;
+import type { EChartsOption } from '../../../utils/echarts';
+import type { IChartRenderSpecConverter } from '../../../types';
+export declare const wordCloudChartConverter: IChartRenderSpecConverter<EChartsOption>;

package/lib/types/models/mode-converter/render-spec-operators/auto-gradient-presets.d.ts

@@ -0,0 +1,5 @@
+import type { IChartLinearGradient } from '../../../chart-builder/chart-color';
+export declare function createBarAutoGradient(color: string, isVerticalSeriesValue: boolean, isNegative?: boolean): IChartLinearGradient;
+export declare function createAreaAutoGradient(color: string, isVerticalSeriesValue: boolean): IChartLinearGradient;
+export declare function createLineAutoGradient(color: string, isVerticalSeriesValue: boolean): IChartLinearGradient;
+export declare function createPieAutoGradient(color: string): IChartLinearGradient;

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

@@ -0,0 +1,23 @@
+import type { ChartColor, IChartLinearGradient } from '../../../chart-builder/chart-color';
+declare const ECHARTS_LINEAR_GRADIENT_TYPE = "linear";
+export interface IEChartsLinearGradientColor {
+    type: typeof ECHARTS_LINEAR_GRADIENT_TYPE;
+    x: number;
+    y: number;
+    x2: number;
+    y2: number;
+    global: false;
+    colorStops: Array<{
+        offset: number;
+        color: string;
+    }>;
+}
+export type ChartRenderColor = string | IEChartsLinearGradientColor;
+type RenderColorResolver = (color: string) => string;
+type AutoGradientFactory = (color: string) => IChartLinearGradient;
+export declare const keepRenderColor: RenderColorResolver;
+export declare function getChartColorRepresentative(color: ChartColor): string;
+export declare function toEChartsColor(color: ChartColor, getRenderColor: RenderColorResolver): ChartRenderColor;
+export declare function resolveChartColor(color: ChartColor, autoGradientFill: boolean, createAutoGradient: AutoGradientFactory, getRenderColor: RenderColorResolver): ChartRenderColor;
+export declare function resolveChartColorRepresentative(color: ChartColor, getRenderColor: RenderColorResolver): string;
+export {};

package/lib/types/models/mode-converter/render-spec-operators/rich-text-inheritance.operator.d.ts

@@ -0,0 +1,2 @@
+import type { EChartRenderSpecOperator } from '../../../types';
+export declare const richTextInheritanceOperator: EChartRenderSpecOperator;

package/lib/types/models/mode-converter/render-spec-operators/tool-tip-operator.d.ts

@@ -1,4 +1,5 @@
-import type { ChartDirection, ChartStyle, EChartRenderSpecOperator, EChartSpec, IChartConfig } from '../../../types';
+import type { EChartsOption } from '../../../utils/echarts';
+import type { ChartDirection, ChartStyle, EChartRenderSpecOperator, IChartConfig } from '../../../types';
 import { InvalidValueType } from '../../../enum';
 interface ITooltipFormatterDataContext {
     category: IChartConfig['category'];
@@ -14,6 +15,11 @@ interface ITooltipFormatterDataContext {
     maxText: string;
     wordText: string;
     frequencyText: string;
+    candlestickCategoryText: string;
+    candlestickOpenText: string;
+    candlestickHighText: string;
+    candlestickLowText: string;
+    candlestickCloseText: string;
     isDateAxis: boolean | undefined;
     allSeriesStyle: ChartStyle['allSeriesStyle'];
     seriesStyleMap: ChartStyle['seriesStyleMap'];
@@ -29,7 +35,7 @@ interface ITooltipFormatters {
     wordCloud: (params: any) => string;
 }
 export declare function excelDateToUnixMilliseconds(excelDate: number, useDefault1900DateSystem?: boolean): number;
-export declare function createTooltipFormatterDataContext(spec: EChartSpec, style: ChartStyle, config: IChartConfig): ITooltipFormatterDataContext;
+export declare function createTooltipFormatterDataContext(spec: EChartsOption, style: ChartStyle, config: IChartConfig): ITooltipFormatterDataContext;
 export declare function createLTRTooltipFormatters(context: ITooltipFormatterDataContext, config: IChartConfig): ITooltipFormatters;
 export declare function createRTLTooltipFormatters(context: ITooltipFormatterDataContext, config: IChartConfig): ITooltipFormatters;
 export declare function createTooltipFormatters(context: ITooltipFormatterDataContext, config: IChartConfig, direction: ChartDirection): ITooltipFormatters;

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

@@ -1,10 +1,11 @@
-import type { ChartStyle, EChartSeriesItem, EChartSpec, ILabelStyle } from '../../../types';
+import type { EChartsOption } from '../../../utils/echarts';
+import type { ChartStyle, EChartSeriesItem, ILabelStyle } from '../../../types';
 import type { ISpecGrid } from './operator-types';
 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 seriesForEach(series: EChartsOption['series'], func: (item: EChartSeriesItem, index: number) => void): void;
 export declare function toPercentage(value: number, fixed?: number): string;
 export declare const getCategoryLabelVertical: (gridInfo: ISpecGrid, style: ChartStyle) => number;
 export declare const getCategoryLabelHorizontal: (gridInfo: ISpecGrid, style: ChartStyle, seriesCount: number, axisLabelMaxWidth?: number) => number;

package/lib/types/types.d.ts

@@ -1,14 +1,19 @@
 import type { IDisposable, Nullable } from '@univerjs/core';
 import type { Observable } from 'rxjs';
-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 { ChartColor, IChartLinearGradient } from './chart-builder/chart-color';
+import type { AreaLineStyle, AxisAlignEnum, AxisValueType, BarShape, CategoryType, ChartAxisDimension, ChartBorderDashType, ChartHistogramBinKind, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartSourceDataTypeEnum, ChartTrendlineType, ChartTypeBits, ChartWaterfallPointRole, DataOrientation, HistogramBinningMode, InvalidValueType, IRuntimeAxisPosition, IRuntimeAxisPriority, LabelAlignEnum, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, TreemapParentLabelLayout, 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';
-import type { BarSeriesOption } from './utils/echarts';
+import type { BarSeriesOption, EChartsOption } from './utils/echarts';
 import type { IWordCloudRenderConfig } from './wordcloud-chart/word-cloud-render-config';
-export type DeepPartial<T> = T extends Record<string, any> ? T extends any[] ? T : {
+export type DeepPartial<T> = T extends IChartLinearGradient ? T : T extends Record<string, any> ? T extends any[] ? T : {
     [key in keyof T]+?: DeepPartial<T[key]>;
 } : T;
+/** Recursive patch shape that permits `null` at every field and treats arrays as atomic values. */
+export type DeepNullish<T> = T extends (...args: never[]) => unknown ? T : T extends readonly unknown[] ? T : T extends object ? {
+    [K in keyof T]?: DeepNullish<T[K]> | null;
+} : T;
 export type ChartDirection = 'ltr' | 'rtl';
 export interface IChartDataSource {
     data$: Observable<IUniverDataSet>;
@@ -27,8 +32,7 @@ export interface IDimensionDefinition {
 }
 export type DimensionDefinitionLoose = IDimensionDefinition['name'] | IDimensionDefinition;
 export type OptionDataValue = string | number | Date | null | undefined;
-export type ChartDataSourceValue = OptionDataValue;
-export type ChartDataSourceValues = ChartDataSourceValue[][];
+export type ChartDataSourceValues = OptionDataValue[][];
 /**
  * Canonical chart dataset used by chart context operators and chart-data builders.
  *
@@ -46,10 +50,93 @@ export interface IUniverDataSet {
     sourceType?: ChartSourceDataTypeEnum[][];
     sourceLabels?: string[][];
 }
+/** Ordered field names that define the persisted Candlestick OHLC mapping contract. */
+export declare const CHART_CANDLESTICK_MAPPING_FIELDS: readonly ["openIndex", "highIndex", "lowIndex", "closeIndex"];
+/** Required semantic OHLC source fields for one Candlestick series. */
+export interface IChartCandlestickMappingSpec {
+    openIndex: number;
+    highIndex: number;
+    lowIndex: number;
+    closeIndex: number;
+}
+/** Semantic body and wick appearance for one Candlestick state. */
+export interface IChartCandlestickStateStyleSpec {
+    color?: string;
+    fillOpacity?: number;
+    border?: {
+        color?: string;
+        width?: number;
+        opacity?: number;
+    };
+    hollow?: boolean;
+}
+/** Semantic Candlestick style overrides persisted by the chart model. */
+export interface IChartCandlestickSpec {
+    rising?: IChartCandlestickStateStyleSpec;
+    falling?: IChartCandlestickStateStyleSpec;
+    doji?: IChartCandlestickStateStyleSpec;
+    candleWidth?: number;
+}
+/** Histogram bin sizing configuration persisted by the semantic chart model. */
+export type IChartHistogramBinningSpec = {
+    mode: typeof HistogramBinningMode.Count;
+    count: number;
+} | {
+    mode: typeof HistogramBinningMode.Width;
+    width: number;
+};
+/** Persisted Histogram data-processing options. Omission selects Scott Auto binning. */
+export interface IChartHistogramDataSpec {
+    binning?: IChartHistogramBinningSpec;
+    underflowThreshold?: number;
+    overflowThreshold?: number;
+}
+/** Persisted Histogram appearance options. */
+export interface IChartHistogramStyleSpec {
+    /** Gap ratio between adjacent bins. Effective values are from 0 through 0.9. */
+    binGap?: number;
+}
+/** Public Histogram semantic configuration. */
+export interface IChartHistogramSpec extends IChartHistogramDataSpec, IChartHistogramStyleSpec {
+}
+/** Persisted leaf-label style supported by Treemap charts. */
+export interface IChartTreemapLabelSpec {
+    visible?: boolean;
+    contentType?: LabelContentType;
+    color?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    family?: string;
+}
+/** Public Treemap semantic style configuration. */
+export interface IChartTreemapSpec {
+    parentLabelLayout?: TreemapParentLabelLayout;
+    label?: IChartTreemapLabelSpec;
+}
+/** Runtime-only renderer-independent Treemap node. */
+export interface IChartTreemapNode {
+    id: string;
+    name: string;
+    path: string[];
+    value: number;
+    selfValue: number;
+    children?: IChartTreemapNode[];
+}
+/** Runtime-only Treemap data prepared from the canonical flat mapping. */
+export interface IChartTreemapData {
+    valueFieldName: string;
+    nodes: IChartTreemapNode[];
+    /** Runtime-only top-level first-source order used for stable palette assignment. */
+    paletteOrder?: string[];
+    diagnostic?: string;
+}
 export interface IChartContext {
     headers?: string[];
     categoryType?: CategoryType;
     categoryIndex?: number;
+    /** Ordered root-to-leaf hierarchy field indexes. Historical payloads omit it. */
+    hierarchyIndexes?: 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.
      */
@@ -66,6 +153,8 @@ export interface IChartContext {
     scatterLabelIndex?: number;
     bubbleSizeIndex?: number;
     bubbleSeriesIndex?: number;
+    candlestick?: IChartCandlestickMappingSpec;
+    histogram?: IChartHistogramDataSpec;
 }
 export interface IRelationNodes {
     id: string;
@@ -93,6 +182,9 @@ export interface IChartData {
      */
     dataset?: IUniverDataSet;
     cartesianPoint?: ICartesianPointData;
+    candlestickData?: IChartCandlestickData;
+    histogramData?: IChartHistogramData;
+    treemapData?: IChartTreemapData;
     heatmapData?: {
         xData: string[];
         yData: string[];
@@ -117,6 +209,38 @@ export interface IChartData {
         isCircular: boolean;
     };
 }
+/** One semantic OHLC point. Renderer tuple order is intentionally absent. */
+export interface IChartCandlestickPoint {
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    labels: {
+        open: string;
+        high: string;
+        low: string;
+        close: string;
+    };
+}
+/** One aligned semantic Candlestick series. */
+export interface IChartCandlestickData {
+    name: string;
+    items: Array<IChartCandlestickPoint | null>;
+}
+/** Numeric semantic Histogram bin. Renderer labels are intentionally absent. */
+export interface IChartHistogramBin {
+    kind: ChartHistogramBinKind;
+    lowerBound?: number;
+    upperBound?: number;
+    count: number;
+}
+/** Derived runtime-only Histogram data. */
+export interface IChartHistogramData {
+    sourceIndex: number;
+    name: string;
+    validSampleCount: number;
+    bins: IChartHistogramBin[];
+}
 export interface ISankeyNode {
     name: string;
 }
@@ -226,7 +350,8 @@ export interface IPointStyle {
     size: number;
     color: Nullable<string>;
 }
-export interface IDataPointStyle extends IPointStyle {
+export interface IDataPointStyle extends Omit<IPointStyle, 'color'> {
+    color: Nullable<ChartColor>;
     /** Fill opacity for this data point, from 0 (transparent) to 1 (opaque). */
     fillOpacity?: number;
 }
@@ -234,7 +359,7 @@ export interface ISeriesStyle {
     chartType?: ChartTypeBits.Line | ChartTypeBits.Column | ChartTypeBits.Area;
     /** Compatibility switch for placing this series on the secondary vertical axis. It does not change the yAxis/rightYAxis option bucket semantics. */
     rightYAxis?: boolean;
-    color: Nullable<string>;
+    color: Nullable<ChartColor>;
     /** Fill opacity for this series, from 0 (transparent) to 1 (opaque). */
     fillOpacity: number;
     border: {
@@ -378,6 +503,13 @@ export interface IChartStyle {
         valueScale: number;
         valueSuffix: string;
         digitalFixed: number;
+        /** Persisted sparse slice overrides. Slice data remains owned by the chart data source. */
+        sliceStyles: {
+            [index: number]: {
+                color: Nullable<ChartColor>;
+                fillOpacity?: number;
+            };
+        };
     };
     area: {
         lineStyle: AreaLineStyle;
@@ -430,6 +562,9 @@ export interface IChartStyle {
         unit?: string;
         label?: ISeriesLabelStyle;
     };
+    candlestick: IChartCandlestickSpec;
+    histogram: IChartHistogramStyleSpec;
+    treemap: IChartTreemapSpec;
 }
 export interface IRelationForceOptions {
     repulsion?: number;
@@ -448,13 +583,13 @@ export interface IChartSnapshot {
     id: string;
     chartType: ChartTypeBits;
     orient?: DataOrientation;
-    context?: Pick<IChartContext, 'categoryIndex' | 'seriesIndexes' | 'transform'>;
+    context?: Pick<IChartContext, 'categoryIndex' | 'hierarchyIndexes' | 'seriesIndexes' | 'transform' | 'candlestick' | 'histogram'>;
     style?: ChartStyle;
     dataAggregation?: IChartDataAggregation;
 }
 export interface IWaterfallLegendData {
     name: string;
-    color: string;
+    color: ChartColor;
 }
 export interface IChartRenderSpecConverter<ChartRenderSpec = Record<string, any>> {
     canConvert: (config: IChartConfig) => boolean;
@@ -653,13 +788,12 @@ export interface IChartInstanceConstructor<Spec> {
 }
 export type OptionalDataValue = number | string | null | undefined;
 export type ExtractArrayItem<T> = T extends Array<infer U> ? U : never;
-export type EChartSpec = echarts.EChartsOption;
-export type EChartSeriesItem = ExtractArrayItem<EChartSpec['series']> & {
+export type EChartSeriesItem = ExtractArrayItem<EChartsOption['series']> & {
     rawData?: number[];
     seriesId: string;
 };
-export type EChartInstance = IChartInstance<EChartSpec>;
-export type EChartRenderSpecOperator = RenderSpecOperator<EChartSpec>;
+export type EChartInstance = IChartInstance<EChartsOption>;
+export type EChartRenderSpecOperator = RenderSpecOperator<EChartsOption>;
 export interface IChartHostRect {
     width: number;
     height: number;

package/lib/types/util.d.ts

@@ -3,7 +3,7 @@ export declare const chartBitsUtils: {
     has(bit: number, attribute: number): boolean;
     baseOn(bit: number, base: number): boolean;
     remove(bit: number, attribute: number): number;
-    chartBitToString(bit: ChartTypeBits): "" | "line" | "bar" | "wordCloud" | "scatter" | "pie" | "radar" | "graph" | "funnel" | "sankey" | "boxplot" | "heatmap" | "combination";
+    chartBitToString(bit: ChartTypeBits): "" | "line" | "bar" | "wordCloud" | "candlestick" | "scatter" | "pie" | "radar" | "treemap" | "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;
@@ -14,11 +14,6 @@ export declare const getProperty: <T = any>(data: Record<string, any> | undefine
  */
 export declare const setGraphicToSpec: (spec: Record<string, any>, graphicElements: unknown[]) => void;
 export declare const translateAngleToRadian: (angle: number) => number;
-interface ISize {
-    width: number;
-    height: number;
-}
-export declare const calcPosition: (text: string, font: string) => ISize;
 /**
  * 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.
@@ -26,4 +21,3 @@ export declare const calcPosition: (text: string, font: string) => ISize;
  */
 export declare const chartTypeCanUseTrendLine: (chartType: ChartTypeBits) => boolean;
 export declare function isNegativeRedCached(fmt: string): boolean | undefined;
-export {};