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

package/lib/types/models/{constants → common/constants}/default.d.ts

@@ -1,4 +1,5 @@
-import type { ChartStyle } from '../../types';
+import type { ChartDirection, ChartRuntimeStyle } from '../../../types';
+export declare const DEFAULT_CHART_DIRECTION: ChartDirection;
 export declare const EChartRenderEngineName = "EChartRenderEngine";
 export declare const defaultChartWidth = 468;
 export declare const defaultChartHeight = 369;
@@ -6,7 +7,7 @@ export declare const LegendPadding = 15;
 export declare const TitleOrLegendPadding = 12;
 export declare const TitleDefaultStartPosition = 8;
 export declare const DEFAULT_CHART_LAYOUT_PADDING = 14;
-export declare function getChartLayoutPadding(style?: ChartStyle): number;
+export declare function getChartLayoutPadding(style: ChartRuntimeStyle): number;
 export declare const TitleLineHeightBase = 1.2;
 export declare const AxisLabelMaxPercent = 0.15;
 export declare const defaultBubbleSize = 0.12;

package/lib/types/models/common/constants/hierarchy.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Canonical persisted blank string accepted by hierarchy path tables.
+ * The hierarchy builder either inherits the scoped value or terminates the path.
+ */
+export declare const CHART_HIERARCHY_BLANK_CELL = "";

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

@@ -0,0 +1,8 @@
+/** 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;
+/** Initial authored bin count when switching Histogram binning from Auto to Count. */
+export declare const DEFAULT_HISTOGRAM_BIN_COUNT = 10;
+/** Initial authored bin width when switching Histogram binning from Auto to Width. */
+export declare const DEFAULT_HISTOGRAM_BIN_WIDTH = 1;

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

@@ -0,0 +1 @@
+export declare const TREEMAP_ECHARTS_SERIES_TYPE = "treemap";

package/lib/types/models/common/theme/build-in-theme/theme-util.d.ts

@@ -0,0 +1,4 @@
+import type { IEchartTheme, IEchartThemeContent } from './types';
+export type axesType = 'category' | 'value' | 'time' | 'log' | 'all' | undefined;
+export declare function getThemeAxesByType(themeInfo: IEchartTheme, axesType: axesType): import("./types").IEchartThemeAxisConfig | undefined;
+export declare function getThemeProps<K extends keyof IEchartThemeContent>(themeInfo: IEchartTheme | undefined, key: K): IEchartThemeContent[K];

package/lib/types/models/{chart-theme.service.d.ts → common/theme/chart-theme.service.d.ts}

@@ -1,5 +1,4 @@
-import type { Injector } from '@univerjs/core';
-import type { IEchartTheme } from './constants/build-in-theme';
+import type { IEchartTheme } from './build-in-theme/types';
 import { Disposable, ThemeService } from '@univerjs/core';
 import { ICanvasColorService } from '@univerjs/engine-render';
 export interface IChartTheme {
@@ -37,4 +36,3 @@ export declare class ChartThemeService extends Disposable {
     getDefaultTheme(): IEchartTheme;
     dispose(): void;
 }
-export declare function registerChartThemeService(injector: Injector): void;

package/lib/types/plugin.d.ts

@@ -0,0 +1,15 @@
+import type { IUniverChartConfig } from './config/config';
+import { IConfigService, Injector, Plugin, UniverInstanceType } from '@univerjs/core';
+/** Registers the shared chart rendering runtime used by every chart host. */
+export declare class UniverChartPlugin extends Plugin {
+    private readonly _config;
+    protected readonly _injector: Injector;
+    private readonly _configService;
+    static type: UniverInstanceType;
+    static pluginName: string;
+    static packageName: string;
+    static version: string;
+    private readonly _resolvedConfig;
+    constructor(_config: IUniverChartConfig | undefined, _injector: Injector, _configService: IConfigService);
+    onStarting(): void;
+}

package/lib/types/types.d.ts

@@ -1,11 +1,13 @@
 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, 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, 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]>;
@@ -99,8 +101,12 @@ export interface IChartHistogramStyleSpec {
 /** 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 {
+export interface IChartTreemapLabelSpec extends IChartValueLabelSpec {
     visible?: boolean;
     contentType?: LabelContentType;
     color?: string;
@@ -114,6 +120,199 @@ 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;
@@ -121,6 +320,8 @@ export interface IChartTreemapNode {
     path: string[];
     value: number;
     selfValue: number;
+    formattedValue?: string;
+    formattedSelfValue?: string;
     children?: IChartTreemapNode[];
 }
 /** Runtime-only Treemap data prepared from the canonical flat mapping. */
@@ -131,12 +332,30 @@ export interface IChartTreemapData {
     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 root-to-leaf hierarchy field indexes. Historical payloads omit it. */
-    hierarchyIndexes?: 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.
      */
@@ -144,16 +363,6 @@ export interface IChartContext {
     categoryResourceIndexes?: number[];
     seriesIndexes?: number[];
     seriesResourceIndexes?: number[];
-    transform?: {
-        categoryIndex?: number;
-        seriesIndexes?: number[];
-    };
-    scatterXIndex?: number;
-    scatterYIndex?: number;
-    scatterLabelIndex?: number;
-    bubbleSizeIndex?: number;
-    bubbleSeriesIndex?: number;
-    candlestick?: IChartCandlestickMappingSpec;
     histogram?: IChartHistogramDataSpec;
 }
 export interface IRelationNodes {
@@ -185,10 +394,15 @@ export interface IChartData {
     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?: {
@@ -276,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;
     /**
@@ -308,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'>;
@@ -319,6 +542,7 @@ export interface IGridLineStyle {
     visible: boolean;
     color: string;
     width: number;
+    dashType?: ChartBorderDashType;
 }
 export interface IAxisOptions {
     lineVisible: boolean;
@@ -340,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;
@@ -440,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;
@@ -448,10 +680,20 @@ 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. */
-    direction: ChartDirection;
     width: number;
     height: number;
     theme: string;
@@ -466,9 +708,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'>;
@@ -487,8 +731,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;
@@ -501,8 +749,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]: {
@@ -565,6 +811,9 @@ export interface IChartStyle {
     candlestick: IChartCandlestickSpec;
     histogram: IChartHistogramStyleSpec;
     treemap: IChartTreemapSpec;
+    sunburst: IChartSunburstSpec;
+    gauge: IChartGaugeSpec;
+    chord: IChartChordSpec;
 }
 export interface IRelationForceOptions {
     repulsion?: number;
@@ -572,10 +821,11 @@ 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 = ChartStyle & {
+    direction: ChartDirection;
+    runtime: ChartRenderRuntimeContext;
+};
 export interface IChartConfig extends IChartData {
     type: ChartTypeBits;
 }
@@ -583,20 +833,25 @@ export interface IChartSnapshot {
     id: string;
     chartType: ChartTypeBits;
     orient?: DataOrientation;
-    context?: Pick<IChartContext, 'categoryIndex' | 'hierarchyIndexes' | 'seriesIndexes' | 'transform' | 'candlestick' | 'histogram'>;
+    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"
@@ -640,7 +895,7 @@ export interface IDomChartHost extends IChartHost {
 export interface IChartRenderInput {
     chartId: string;
     config: IChartConfig;
-    style: ChartStyle;
+    style: ChartRuntimeStyle;
 }
 export interface IChartRenderModelImageExportInput extends IChartRenderInput {
     width: number;
@@ -681,12 +936,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;
@@ -756,6 +1011,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;
 }
@@ -788,12 +1054,14 @@ export interface IChartInstanceConstructor<Spec> {
 }
 export type OptionalDataValue = number | string | null | undefined;
 export type ExtractArrayItem<T> = T extends Array<infer U> ? U : never;
-export type EChartSeriesItem = ExtractArrayItem<EChartsOption['series']> & {
+export type EChartSpec = EChartsOption;
+export type EChartSeriesItem = ExtractArrayItem<EChartSpec['series']> & {
+    formattedData?: string[];
     rawData?: number[];
     seriesId: string;
 };
-export type EChartInstance = IChartInstance<EChartsOption>;
-export type EChartRenderSpecOperator = RenderSpecOperator<EChartsOption>;
+export type EChartInstance = IChartInstance<EChartSpec>;
+export type EChartRenderSpecOperator = RenderSpecOperator<EChartSpec>;
 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" | "candlestick" | "scatter" | "pie" | "radar" | "treemap" | "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;

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

@@ -1,4 +1,10 @@
+/** Copies only the top-level container while preserving nested references. */
+export declare function shallowClone<T>(value: T): T;
 /** Deep-clones a value while removing own properties whose value is undefined. */
 export declare function cloneWithoutUndefined<T>(value: T): T;
 /** Returns an undefined-free record, or undefined when no fields remain. */
 export declare function compactRecord<T extends object>(value: T): T | undefined;
+/** Returns a shallow copy without own string fields whose value is undefined. */
+export declare function omitUndefinedFields<T extends object>(value: T): T;
+/** Deletes own string fields whose value is undefined and preserves object identity. */
+export declare function deleteUndefinedFields<T extends object>(target: T): T;

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 };

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

@@ -1,7 +1,7 @@
 export declare const WORD_CLOUD_SERIES_TYPE = "wordCloud";
 export declare const WORD_CLOUD_DEFAULT_OPTION: {
     readonly z: 2;
-    readonly maskSource: import("../..").IWordCloudEChartsMaskSource;
+    readonly maskSource: import("../../types").IWordCloudEChartsMaskSource;
     readonly colorBy: "data";
     readonly keepAspect: false;
     readonly left: "center";

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

@@ -1,5 +1,3 @@
 import type { echarts } from '../../../utils/echarts';
-import { WORD_CLOUD_SERIES_TYPE } from './echarts-options';
 export type PerformWordCloudSeriesLayout = (seriesModel: unknown, ecModel: unknown, api: unknown) => void;
 export declare function registerWordCloudLayout(echartsInstance: typeof echarts, performSeriesLayout: PerformWordCloudSeriesLayout): void;
-export { WORD_CLOUD_SERIES_TYPE };