@univerjs-pro/engine-chart 1.0.0-alpha.7 → 1.0.0-beta.0

package/lib/types/types.d.ts

@@ -1,15 +1,21 @@
 import type { IDisposable, Nullable } from '@univerjs/core';
+import type { BarSeriesOption, EChartsOption } from 'echarts';
 import type { Observable } from 'rxjs';
 import type { ChartColor, IChartLinearGradient } from './chart-builder/chart-color';
-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';
-import type { BarSeriesOption, EChartsOption } from './utils/echarts';
+import type { IChartPieCompositeSpec, PieCompositeMarkRole, PieCompositePlot } from './chart-builder/chart-types';
+import type { IChartDataAggregation } from './chart-data-aggregation';
+import type { AreaLineStyle, AxisAlignEnum, AxisValueType, BarShape, CategoryType, ChartAxisDimension, ChartBorderDashType, ChartChordFocusMode, ChartChordLabelPosition, ChartChordRibbonColorMode, ChartGaugeMode, ChartGaugePointerShape, ChartHistogramBinKind, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartSourceDataTypeEnum, ChartSunburstLabelPosition, 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/internal/cartesian-point-data';
+import type { IChartLocaleTexts } from './models/common/chart-locale-texts';
+import type { IEchartTheme } from './models/common/theme/build-in-theme/types';
 import type { IWordCloudRenderConfig } from './wordcloud-chart/word-cloud-render-config';
 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>;
@@ -28,8 +34,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.
  *
@@ -47,10 +52,310 @@ 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 {
+}
+/** Shared authored number format for chart labels that display a numeric Value fragment. */
+export interface IChartValueLabelSpec {
+    format?: string;
+}
+/** Persisted leaf-label style supported by Treemap charts. */
+export interface IChartTreemapLabelSpec extends IChartValueLabelSpec {
+    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;
+}
+/** Persisted semantic label style supported by Sunburst charts. */
+export interface IChartSunburstLabelSpec extends IChartValueLabelSpec {
+    visible?: boolean;
+    contentType?: LabelContentType;
+    position?: ChartSunburstLabelPosition;
+    color?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    family?: string;
+}
+/** Persisted style for the aggregate value rendered in the Sunburst center. */
+export interface IChartSunburstCenterLabelSpec extends IChartValueLabelSpec {
+    visible?: boolean;
+    color?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    family?: string;
+}
+/** Public Sunburst semantic style configuration. */
+export interface IChartSunburstSpec {
+    centerLabel?: IChartSunburstCenterLabelSpec;
+    label?: IChartSunburstLabelSpec;
+}
+export interface IChartGaugeFontSpec {
+    color?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    family?: string;
+}
+/** Values are semantic degrees; ratios are represented from 0 through 1. */
+export interface IChartGaugeScaleSpec {
+    min?: number;
+    max?: number;
+    splitNumber?: number;
+}
+export interface IChartGaugeAnglesSpec {
+    startAngle?: number;
+    endAngle?: number;
+}
+export interface IChartGaugeRangeSpec {
+    from: number;
+    to: number;
+    color: string;
+}
+export interface IChartGaugeAxisLineSpec {
+    visible?: boolean;
+    width?: number;
+    color?: string;
+}
+export interface IChartGaugeAxisTickSpec {
+    visible?: boolean;
+    splitNumber?: number;
+    length?: number;
+    width?: number;
+    color?: string;
+}
+export interface IChartGaugeSplitLineSpec {
+    visible?: boolean;
+    length?: number;
+    width?: number;
+    color?: string;
+}
+export interface IChartGaugeAxisLabelSpec extends IChartGaugeFontSpec, IChartValueLabelSpec {
+    visible?: boolean;
+    distance?: number;
+}
+export interface IChartGaugePointerSpec {
+    visible?: boolean;
+    length?: number;
+    width?: number;
+    color?: string;
+    shape?: ChartGaugePointerShape;
+}
+export interface IChartGaugeAnchorSpec {
+    visible?: boolean;
+    size?: number;
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+}
+export interface IChartGaugeProgressSpec {
+    visible?: boolean;
+    width?: number;
+    color?: string;
+    rounded?: boolean;
+}
+export interface IChartGaugeTitleSpec extends IChartGaugeFontSpec {
+    visible?: boolean;
+    offsetY?: number;
+}
+export interface IChartGaugeDetailSpec extends IChartGaugeFontSpec, IChartValueLabelSpec {
+    visible?: boolean;
+    offsetY?: number;
+}
+/** Persisted renderer-independent Gauge appearance shared by every rendered gauge item. */
+export interface IChartGaugeSpec {
+    mode?: ChartGaugeMode;
+    scale?: IChartGaugeScaleSpec;
+    angles?: IChartGaugeAnglesSpec;
+    ranges?: IChartGaugeRangeSpec[];
+    axisLine?: IChartGaugeAxisLineSpec;
+    axisTick?: IChartGaugeAxisTickSpec;
+    splitLine?: IChartGaugeSplitLineSpec;
+    axisLabel?: IChartGaugeAxisLabelSpec;
+    pointer?: IChartGaugePointerSpec;
+    anchor?: IChartGaugeAnchorSpec;
+    progress?: IChartGaugeProgressSpec;
+    title?: IChartGaugeTitleSpec;
+    detail?: IChartGaugeDetailSpec;
+}
+export interface IChartGaugeItem {
+    id: string;
+    name: string;
+    value: number;
+    formattedValue: string;
+}
+export interface IChartGaugeData {
+    items: IChartGaugeItem[];
+    diagnostic?: string;
+}
+/** Persisted Source/Target/optional-Value roles for an undirected Chord edge list. */
+export interface IChartChordMappingSpec {
+    sourceIndex: number;
+    targetIndex: number;
+    valueIndex?: number;
+}
+export interface IChartChordLayoutSpec {
+    startAngle?: number;
+    clockwise?: boolean;
+    padAngle?: number;
+    minAngle?: number;
+    innerRadiusRatio?: number;
+    outerRadiusRatio?: number;
+}
+export interface IChartChordNodeStyleSpec {
+    color?: string;
+    opacity?: number;
+    borderColor?: string;
+    borderWidth?: number;
+    borderType?: ChartBorderDashType;
+}
+export interface IChartChordLabelSpec {
+    visible?: boolean;
+    position?: ChartChordLabelPosition;
+    rotation?: number;
+    distance?: number;
+    color?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    family?: string;
+}
+export interface IChartChordRibbonStyleSpec {
+    color?: ChartChordRibbonColorMode;
+    opacity?: number;
+    width?: number;
+    type?: ChartBorderDashType;
+}
+export interface IChartChordEmphasisSpec {
+    focus?: ChartChordFocusMode;
+}
+export interface IChartChordSpec {
+    layout?: IChartChordLayoutSpec;
+    node?: IChartChordNodeStyleSpec;
+    label?: IChartChordLabelSpec;
+    ribbon?: IChartChordRibbonStyleSpec;
+    emphasis?: IChartChordEmphasisSpec;
+}
+export interface IChartChordNode {
+    id: string;
+    name: string;
+    value: number;
+    formattedValue: string;
+}
+export interface IChartChordLink {
+    id: string;
+    endpointAId: string;
+    endpointBId: string;
+    endpointAName: string;
+    endpointBName: string;
+    value: number;
+    formattedValue: string;
+}
+export interface IChartChordData {
+    valueFieldName?: string;
+    weightMode: 'value' | 'count';
+    nodes: IChartChordNode[];
+    links: IChartChordLink[];
+    diagnostic?: string;
+}
+/** Runtime-only renderer-independent Treemap node. */
+export interface IChartTreemapNode {
+    id: string;
+    name: string;
+    path: string[];
+    value: number;
+    selfValue: number;
+    formattedValue?: string;
+    formattedSelfValue?: string;
+    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;
+}
+/** Runtime-only renderer-independent Sunburst node. */
+export interface IChartSunburstNode {
+    id: string;
+    name: string;
+    path: string[];
+    value: number;
+    selfValue: number;
+    formattedValue?: string;
+    formattedSelfValue?: string;
+    children?: IChartSunburstNode[];
+}
+/** Runtime-only Sunburst data prepared from the canonical flat mapping. */
+export interface IChartSunburstData {
+    valueFieldName: string;
+    nodes: IChartSunburstNode[];
+    /** 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 selected Label field indexes. */
+    categoryIndexes?: 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.
      */
@@ -58,15 +363,7 @@ export interface IChartContext {
     categoryResourceIndexes?: number[];
     seriesIndexes?: number[];
     seriesResourceIndexes?: number[];
-    transform?: {
-        categoryIndex?: number;
-        seriesIndexes?: number[];
-    };
-    scatterXIndex?: number;
-    scatterYIndex?: number;
-    scatterLabelIndex?: number;
-    bubbleSizeIndex?: number;
-    bubbleSeriesIndex?: number;
+    histogram?: IChartHistogramDataSpec;
 }
 export interface IRelationNodes {
     id: string;
@@ -94,10 +391,18 @@ export interface IChartData {
      */
     dataset?: IUniverDataSet;
     cartesianPoint?: ICartesianPointData;
+    candlestickData?: IChartCandlestickData;
+    histogramData?: IChartHistogramData;
+    treemapData?: IChartTreemapData;
+    sunburstData?: IChartSunburstData;
+    gaugeData?: IChartGaugeData;
+    chordData?: IChartChordData;
+    fieldDiagnostic?: import('./models/common/chart-field-diagnostic').IChartFieldDiagnostic;
     heatmapData?: {
         xData: string[];
         yData: string[];
         values: number[][];
+        formattedValues: string[][];
         isValidateHeatmapSource: boolean;
     };
     relationData?: {
@@ -118,6 +423,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;
 }
@@ -153,6 +490,8 @@ export interface IChartRuntimeContext {
     axes: IRuntimeAxis[];
     themeInfo: IEchartTheme;
     wordCloudRenderConfig?: IWordCloudRenderConfig;
+    /** Runtime-only host policy for rendering a chart watermark. */
+    addWatermark?: boolean;
     /** Runtime-only extra inset reserved by host adapters around chart content. */
     layoutInset?: number;
     /**
@@ -185,6 +524,13 @@ export interface ILabelStyle {
     showMinLabel?: boolean;
     rotate?: number;
 }
+export interface IChartTitleStyle extends Omit<ILabelStyle, 'visible'> {
+    /** PowerPoint manual title anchor, as chart-relative edge coordinates. */
+    manualLayout?: {
+        left: number;
+        top: number;
+    };
+}
 export interface ILegendStyle {
     position?: LegendPositionEnum;
     label?: Omit<ILabelStyle, 'visible' | 'align' | 'content'>;
@@ -196,6 +542,7 @@ export interface IGridLineStyle {
     visible: boolean;
     color: string;
     width: number;
+    dashType?: ChartBorderDashType;
 }
 export interface IAxisOptions {
     lineVisible: boolean;
@@ -217,10 +564,14 @@ export interface IAxisOptions {
 export interface ISeriesLabelStyle extends ILabelStyle {
     contentType: number;
     position: SeriesLabelPosition;
+    format?: string;
+    /** Per-category text imported from OOXML data-label ranges. */
+    customValues?: Record<number, string>;
 }
 export interface IPieLabelStyle extends Omit<ILabelStyle, 'align' | 'content'> {
     contentType: number;
     position: PieLabelPosition;
+    format?: string;
 }
 export interface IPointStyle {
     shape: LinePointShape;
@@ -317,6 +668,10 @@ export type IChartMarkLine = {
     value: number;
 });
 export interface IBarStyle {
+    /** Gap between category clusters, as a percentage of one bar width. */
+    gapWidth?: number;
+    /** Series overlap from -100 (separated) through 100 (fully overlapped). */
+    overlap?: number;
     /** Exchange metadata. Renderers without 3D support may ignore these fields. */
     is3D: boolean;
     shape: BarShape;
@@ -325,6 +680,19 @@ export interface IBarStyle {
     /** OOXML view rotation around the vertical axis, in degrees. */
     rotY: number;
 }
+export interface IChartBubbleStyle {
+    /** Maximum bubble size as an OOXML-compatible percentage. */
+    scale?: number;
+    /** Whether the authored bubble value represents its area or width. */
+    sizeRepresents?: 'area' | 'width';
+}
+/** Manual inner plot rectangle, normalized against the whole chart frame. */
+export interface IChartPlotArea {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
 export interface IChartStyle {
     runtime: IChartRuntimeContext;
     /** Runtime-only locale direction. It must not be persisted in chart snapshots. */
@@ -343,9 +711,11 @@ export interface IChartStyle {
     fontFamily: string;
     borderColor: Nullable<string>;
     borderWidth: number;
+    /** Omission keeps renderer-owned automatic layout. */
+    plotArea?: IChartPlotArea;
     titles: {
-        title: Omit<ILabelStyle, 'visible'>;
-        subtitle: Omit<ILabelStyle, 'visible'>;
+        title: IChartTitleStyle;
+        subtitle: IChartTitleStyle;
         xAxisTitle: Omit<ILabelStyle, 'visible'>;
         /** Primary vertical axis title. RTL may render it on the physical right, but it is still persisted here. */
         yAxisTitle: Omit<ILabelStyle, 'visible'>;
@@ -364,8 +734,12 @@ export interface IChartStyle {
         [id: string]: ISeriesStyle;
     };
     bar: IBarStyle;
+    bubble: IChartBubbleStyle;
     trendlines: ITrendLine[];
     pie: {
+        composite?: IChartPieCompositeSpec;
+        /** Clockwise degrees from 12 o'clock, matching the authored chart semantic. */
+        startAngle?: number;
         doughnutHole: Nullable<number>;
         /** Slice offset as a ratio of the pie radius. */
         explosion?: number;
@@ -378,8 +752,6 @@ export interface IChartStyle {
         rosePie: boolean;
         showLabelLine: boolean;
         valueScale: number;
-        valueSuffix: string;
-        digitalFixed: number;
         /** Persisted sparse slice overrides. Slice data remains owned by the chart data source. */
         sliceStyles: {
             [index: number]: {
@@ -439,6 +811,12 @@ export interface IChartStyle {
         unit?: string;
         label?: ISeriesLabelStyle;
     };
+    candlestick: IChartCandlestickSpec;
+    histogram: IChartHistogramStyleSpec;
+    treemap: IChartTreemapSpec;
+    sunburst: IChartSunburstSpec;
+    gauge: IChartGaugeSpec;
+    chord: IChartChordSpec;
 }
 export interface IRelationForceOptions {
     repulsion?: number;
@@ -446,10 +824,10 @@ export interface IRelationForceOptions {
     gravity?: number;
 }
 export type ChartStyle = DeepPartial<IChartStyle>;
-export interface IChartDataAggregation {
-    aggregate?: boolean;
-    topN?: number;
-}
+export type ChartRenderRuntimeContext = Omit<DeepPartial<IChartRuntimeContext>, 'localeTexts'> & Pick<IChartRuntimeContext, 'localeTexts'>;
+export type ChartRuntimeStyle = Omit<ChartStyle, 'runtime'> & {
+    runtime: ChartRenderRuntimeContext;
+};
 export interface IChartConfig extends IChartData {
     type: ChartTypeBits;
 }
@@ -457,20 +835,25 @@ export interface IChartSnapshot {
     id: string;
     chartType: ChartTypeBits;
     orient?: DataOrientation;
-    context?: Pick<IChartContext, 'categoryIndex' | 'seriesIndexes' | 'transform'>;
+    context?: IChartSnapshotContext;
     style?: ChartStyle;
     dataAggregation?: IChartDataAggregation;
 }
+/** Persisted chart field selection accepted by the snapshot reader. */
+export interface IChartSnapshotContext extends Pick<IChartContext, 'categoryIndexes' | 'seriesIndexes' | 'histogram'> {
+    /** Historical snapshot field decoded only when `categoryIndexes` is absent. */
+    categoryIndex?: number;
+}
 export interface IWaterfallLegendData {
     name: string;
     color: ChartColor;
 }
 export interface IChartRenderSpecConverter<ChartRenderSpec = Record<string, any>> {
     canConvert: (config: IChartConfig) => boolean;
-    convert: (config: IChartConfig, style: ChartStyle) => ChartRenderSpec;
+    convert: (config: IChartConfig, style: ChartRuntimeStyle) => ChartRenderSpec;
 }
 export type ChartConfigInterceptor = (config: IChartConfig) => IChartConfig;
-export type RenderSpecOperator<ChartRenderSpec> = (spec: ChartRenderSpec, style: ChartStyle, config: IChartConfig, instance: IChartInstance) => void;
+export type RenderSpecOperator<ChartRenderSpec> = (spec: ChartRenderSpec, style: ChartRuntimeStyle, config: IChartConfig, instance: IChartInstance) => void;
 export declare enum ChartHostRenderMode {
     Image = "image",
     Dom = "dom"
@@ -514,7 +897,7 @@ export interface IDomChartHost extends IChartHost {
 export interface IChartRenderInput {
     chartId: string;
     config: IChartConfig;
-    style: ChartStyle;
+    style: ChartRuntimeStyle;
 }
 export interface IChartRenderModelImageExportInput extends IChartRenderInput {
     width: number;
@@ -555,12 +938,12 @@ export interface IChartRenderInstanceCreateContext<Spec = Record<string, any>> {
     prepareSpec?: (input: IChartRenderInstanceSpecInput<Spec>) => Spec;
 }
 export interface IChartRenderModelStylizeInit<Spec> {
-    chartStyle: ChartStyle;
+    chartStyle: ChartRuntimeStyle;
     chartConfig: IChartConfig;
     chartInstance?: IChartInstance<Spec>;
 }
 export interface IChartRenderModel<Spec extends Record<string, any> = Record<string, any>> extends IDisposable {
-    toSpec(chartConfig: IChartConfig, style: ChartStyle): Spec;
+    toSpec(chartConfig: IChartConfig, style: ChartRuntimeStyle): Spec;
     stylizeSpec(spec: Spec, stylizeInit: IChartRenderModelStylizeInit<Spec>, rect: IChartHostRect): Spec;
     exportImage(input: IChartRenderModelImageExportInput, options?: IChartRenderModelImageExportOptions): Promise<IChartRenderModelImageExportResult>;
     updateWatermark(addWatermark: boolean): void;
@@ -630,6 +1013,17 @@ export interface IChartElementHit {
     seriesId?: string;
     seriesName?: string;
     dataIndex?: number;
+    /** Stable runtime identity for an aggregated semantic mark. Renderer indexes are intentionally omitted. */
+    semanticId?: string;
+    semanticKind?: 'node' | 'link';
+    semanticValue?: number;
+    semanticFormattedValue?: string;
+    semanticEndpointAName?: string;
+    semanticEndpointBName?: string;
+    pieCompositeRole?: PieCompositeMarkRole;
+    pieCompositePlot?: PieCompositePlot;
+    pieSourcePointIndex?: number;
+    pieAggregateMemberSourcePointIndexes?: readonly number[];
     baseSeriesIndex?: string;
     waterfallSeriesType?: WaterfallSeriesTypeEnum;
 }
@@ -664,6 +1058,7 @@ export type OptionalDataValue = number | string | null | undefined;
 export type ExtractArrayItem<T> = T extends Array<infer U> ? U : never;
 export type EChartSpec = EChartsOption;
 export type EChartSeriesItem = ExtractArrayItem<EChartSpec['series']> & {
+    formattedData?: string[];
     rawData?: number[];
     seriesId: string;
 };

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" | "pie" | "radar" | "scatter" | "combination" | "wordCloud" | "funnel" | "sankey" | "heatmap" | "boxplot" | "candlestick" | "treemap" | "sunburst" | "gauge" | "chord" | "graph";
 };
 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 {};

package/lib/types/utils/echarts.d.ts

@@ -14,4 +14,3 @@ export declare const echarts: {
     registerPreprocessor: typeof registerPreprocessor;
     util: typeof util;
 };
-export type { BarSeriesOption, DatasetComponentOption, ECharts, EChartsInitOpts, EChartsOption, FunnelSeriesOption, LegendComponentOption, LineSeriesOption, PieSeriesOption, XAXisComponentOption, } from 'echarts';

package/lib/types/word-cloud-resource/word-cloud-resource-config.d.ts

@@ -2,4 +2,9 @@ interface IWordCloudResource {
     [iconName: string]: string;
 }
 export declare const WordCloudResourceConfig: IWordCloudResource;
+export declare const WordCloudMaskImageOptions: {
+    imageSrc: string;
+    label: string;
+    value: string;
+}[];
 export {};

package/lib/types/wordcloud-chart/adapters/echarts/chart-view.d.ts

@@ -1,7 +1,5 @@
 import type { echarts } from '../../../utils/echarts';
-import { WORD_CLOUD_SERIES_TYPE } from './echarts-options';
 export interface IRegisterWordCloudChartViewContext {
     createTextElement(layout: any, data: any, dataIndex: number, seriesModel: any): unknown;
 }
 export declare function registerWordCloudChartView(echartsInstance: typeof echarts, context: IRegisterWordCloudChartViewContext): void;
-export { WORD_CLOUD_SERIES_TYPE };