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

package/lib/types/chart-builder/chart-types.d.ts

@@ -1,5 +1,6 @@
-import type { AreaLineStyle, BarShape, ChartAxisDimension, ChartBorderDashType, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartTrendlineType, ChartWaterfallPointRole, InvalidValueType, IRuntimeAxisPosition, LabelAlignEnum, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from '../enum';
-import type { DeepNullish, IChartCandlestickMappingSpec, IChartCandlestickSpec, IChartHistogramSpec, IChartTreemapSpec } from '../types';
+import type { IChartTopNSpec } from '../chart-data-aggregation';
+import type { AreaLineStyle, AxisAlignEnum, BarShape, ChartAxisDimension, ChartBorderDashType, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartTrendlineType, ChartWaterfallPointRole, InvalidValueType, IRuntimeAxisPosition, LabelAlignEnum, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from '../enum';
+import type { DeepNullish, IChartCandlestickMappingSpec, IChartCandlestickSpec, IChartChordMappingSpec, IChartChordSpec, IChartGaugeSpec, IChartHistogramSpec, IChartSunburstSpec, IChartTreemapSpec, IChartValueLabelSpec } from '../types';
 import type { ChartColor } from './chart-color';
 /** Canonical semantic chart type names exposed by the chart facade. */
 export declare enum ChartTypeString {
@@ -29,7 +30,10 @@ export declare enum ChartTypeString {
     Boxplot = "boxplot",
     Candlestick = "candlestick",
     Histogram = "histogram",
-    Treemap = "treemap"
+    Treemap = "treemap",
+    Sunburst = "sunburst",
+    Gauge = "gauge",
+    Chord = "chord"
 }
 export declare enum ChartSeriesTypeString {
     Column = "column",
@@ -64,6 +68,11 @@ export interface IChartFontSpec {
     italic?: boolean;
     family?: string;
 }
+/** Facade-only semantic patch for the regular divisions of a Gauge scale. */
+export interface IChartGaugeTicksPatch {
+    majorDivisions?: number | null;
+    minorDivisionsPerMajor?: number | null;
+}
 export interface IChartTitleOptions extends IChartFontSpec {
     text?: string;
     visible?: boolean;
@@ -89,6 +98,7 @@ export interface IChartAxisLabelSpec extends IChartFontSpec {
 }
 export interface IChartAxisSpec {
     title?: string;
+    titleAlignment?: AxisAlignEnum;
     min?: number;
     max?: number;
     reverse?: boolean;
@@ -111,6 +121,7 @@ export interface IChartAxisSpec {
         visible?: boolean;
         color?: string;
         width?: number;
+        dashType?: ChartBorderDashType;
     };
 }
 export interface IChartAxesSpec {
@@ -166,17 +177,19 @@ export interface IChartSeriesBorderSpec {
     opacity?: number;
     dashType?: ChartBorderDashType;
 }
+export interface IChartLineStyleSpec extends IChartSeriesBorderSpec {
+}
 export interface IChartSeriesPointSpec {
     shape?: LinePointShape;
     size?: number;
     color?: string;
 }
-export interface IChartSeriesLabelSpec extends IChartFontSpec {
+export interface IChartSeriesLabelSpec extends IChartFontSpec, IChartValueLabelSpec {
     visible?: boolean;
     position?: SeriesLabelPosition;
     contentType?: LabelContentType;
 }
-export interface IChartHeatmapLabelSpec extends IChartFontSpec {
+export interface IChartHeatmapLabelSpec extends IChartFontSpec, IChartValueLabelSpec {
     visible?: boolean;
     position?: SeriesLabelPosition;
 }
@@ -203,7 +216,10 @@ export interface IChartSeriesPatch extends IChartSeriesStyleSpec {
     selector: ChartSeriesSelector;
     type?: ChartSeriesTypeString;
     dataPoints?: Record<number, IChartSeriesDataPointStyleSpec>;
-    waterfallStyles?: Partial<Record<ChartWaterfallStyleTarget, Omit<IChartSeriesPatch, 'selector' | 'waterfallStyles'>>>;
+    waterfallStyles?: Partial<Record<ChartWaterfallStyleTarget, IChartWaterfallSeriesStyleSpec>>;
+}
+export interface IChartWaterfallSeriesStyleSpec extends Omit<IChartSeriesPatch, 'selector' | 'waterfallStyles'> {
+    name?: string;
 }
 /** Series patch for line-like marks whose data points are symbols. */
 export interface IChartLineSeriesPatch extends Omit<IChartSeriesPatch, 'dataPoints'> {
@@ -276,6 +292,11 @@ export interface IChartBubbleMappingSpec extends IChartScatterMappingSpec {
     sizeIndex?: number;
     seriesIndex?: number;
 }
+export interface IChartEdgeMappingSpec {
+    sourceIndex: number;
+    targetIndex: number;
+    valueIndex?: number;
+}
 export interface IChartMappingSpec {
     categoryIndex?: number;
     /** Ordered root-to-leaf hierarchy fields for hierarchy charts. */
@@ -285,12 +306,14 @@ export interface IChartMappingSpec {
     scatter?: IChartScatterMappingSpec;
     bubble?: IChartBubbleMappingSpec;
     candlestick?: IChartCandlestickMappingSpec;
+    chord?: IChartChordMappingSpec;
+    edge?: IChartEdgeMappingSpec;
 }
 export interface IChartAggregationSpec {
     aggregate?: boolean;
-    topN?: number;
+    topN?: IChartTopNSpec;
 }
-export interface IChartPieLabelSpec extends IChartFontSpec {
+export interface IChartPieLabelSpec extends IChartFontSpec, IChartValueLabelSpec {
     visible?: boolean;
     position?: PieLabelPosition;
     contentType?: LabelContentType;
@@ -300,7 +323,67 @@ export interface IChartSliceStyleSpec {
     color?: ChartColor;
     fillOpacity?: number;
 }
+export declare const PieSecondaryPlotType: {
+    readonly Pie: "pie";
+    readonly Bar: "bar";
+};
+export type PieSecondaryPlotType = typeof PieSecondaryPlotType[keyof typeof PieSecondaryPlotType];
+export declare const PieCompositePlot: {
+    readonly Primary: "primary";
+    readonly Secondary: "secondary";
+};
+export type PieCompositePlot = typeof PieCompositePlot[keyof typeof PieCompositePlot];
+export declare const PieCompositeMarkRole: {
+    readonly Source: "source";
+    readonly Aggregate: "aggregate";
+    readonly Connector: "connector";
+};
+export type PieCompositeMarkRole = typeof PieCompositeMarkRole[keyof typeof PieCompositeMarkRole];
+export declare const PieSecondarySplitType: {
+    readonly Auto: "auto";
+    readonly Position: "position";
+    readonly Value: "value";
+    readonly Percentage: "percentage";
+    readonly Custom: "custom";
+};
+export type PieSecondarySplitSpec = {
+    type: typeof PieSecondarySplitType.Auto;
+} | {
+    type: typeof PieSecondarySplitType.Position;
+    count: number;
+} | {
+    type: typeof PieSecondarySplitType.Value;
+    lessThan: number;
+} | {
+    type: typeof PieSecondarySplitType.Percentage;
+    lessThan: number;
+} | {
+    type: typeof PieSecondarySplitType.Custom;
+    pointIndexes: number[];
+};
+export interface IChartPieConnectorSpec extends IChartLineStyleSpec {
+    visible?: boolean;
+}
+export interface IChartPieSecondaryPlotSpec {
+    type: PieSecondaryPlotType;
+    split?: PieSecondarySplitSpec;
+    size?: number;
+    gapWidth?: number;
+    connector?: IChartPieConnectorSpec;
+}
+export interface IChartPieAggregateSpec {
+    label?: string;
+    style?: IChartSliceStyleSpec;
+}
+export interface IChartPieCompositeSpec {
+    enabled?: boolean;
+    secondaryPlot: IChartPieSecondaryPlotSpec;
+    aggregate?: IChartPieAggregateSpec;
+}
 export interface IChartPieSpec {
+    composite?: IChartPieCompositeSpec;
+    /** Clockwise degrees from 12 o'clock. */
+    startAngle?: number;
     doughnutHole?: number;
     explosion?: number;
     borderColor?: string;
@@ -309,8 +392,6 @@ export interface IChartPieSpec {
     rosePie?: boolean;
     showLabelLine?: boolean;
     valueScale?: number;
-    valueSuffix?: string;
-    digitalFixed?: number;
     label?: IChartPieLabelSpec;
     /** Sparse authored slice styles keyed by materialized slice index. */
     sliceStyles?: Partial<Record<number, IChartSliceStyleSpec>>;
@@ -333,7 +414,7 @@ export interface IChartParetoPointStyleSpec {
     color?: string;
 }
 interface IChartParetoLabelStyleBase extends Omit<IChartSeriesLabelSpec, 'contentType' | 'position'> {
-    contentType?: LabelContentType.Empty | LabelContentType.SeriesName | LabelContentType.CategoryName | LabelContentType.Value;
+    contentType?: LabelContentType;
 }
 /** Pareto bar-label appearance. */
 export interface IChartParetoBarLabelStyleSpec extends IChartParetoLabelStyleBase {
@@ -349,6 +430,7 @@ export interface IChartParetoBarStyleSpec {
     opacity?: number;
     border?: IChartParetoBorderStyleSpec;
     label?: IChartParetoBarLabelStyleSpec;
+    dataPoints?: Record<number, IChartSeriesDataPointStyleSpec>;
 }
 /** Supported appearance for the derived Pareto cumulative line. */
 export interface IChartParetoLineStyleSpec {
@@ -358,6 +440,7 @@ export interface IChartParetoLineStyleSpec {
     dashType?: ChartBorderDashType;
     point?: IChartParetoPointStyleSpec;
     label?: IChartParetoLineLabelStyleSpec;
+    dataPoints?: Record<number, IChartSeriesDataPointStyleSpec>;
 }
 /** Pareto semantic configuration exposed through the Facade. */
 export interface IChartParetoSpec {
@@ -375,11 +458,23 @@ export interface IChartAreaSpec {
     lineStyle?: AreaLineStyle;
 }
 export interface IChartBarSpec {
+    gapWidth?: number;
+    overlap?: number;
     is3D?: boolean;
     shape?: BarShape;
     rotX?: number;
     rotY?: number;
 }
+export interface IChartBubbleSpec {
+    scale?: number;
+    sizeRepresents?: 'area' | 'width';
+}
+export interface IChartPlotAreaSpec {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
 export interface IChartFunnelSpec {
     gap?: number;
     useAbsoluteValue?: boolean;
@@ -403,7 +498,7 @@ export interface IChartWaterfallSpec {
     useSubtotal?: boolean;
     pointRoles?: IChartWaterfallPointRoleSpec[];
     connector?: boolean | IChartWaterfallConnectorStyleSpec;
-    styles?: Partial<Record<ChartWaterfallStyleTarget, Omit<IChartSeriesPatch, 'selector'>>>;
+    styles?: Partial<Record<ChartWaterfallStyleTarget, IChartWaterfallSeriesStyleSpec>>;
 }
 /** Public Waterfall series selector; numbers are stable source-series indexes. */
 export type ChartWaterfallSeriesSelector = number | {
@@ -444,17 +539,39 @@ interface IChartSemanticConfig {
     axisPointer?: IChartAxisPointerSpec;
     area?: IChartAreaSpec;
     bar?: IChartBarSpec;
+    bubble?: IChartBubbleSpec;
+    plotArea?: IChartPlotAreaSpec;
     funnel?: IChartFunnelSpec;
     relation?: IChartRelationSpec;
     waterfall?: IChartWaterfallSpec;
     candlestick?: IChartCandlestickSpec;
     histogram?: IChartHistogramSpec;
     treemap?: IChartTreemapSpec;
+    sunburst?: IChartSunburstSpec;
+    gauge?: IChartGaugeSpec;
+    chord?: IChartChordSpec;
     markLines?: IChartMarkLineSpec[];
     theme?: string;
     /** Persisted absolute series colors. A non-empty value overrides theme colors. */
     palette?: string[];
 }
+/** Absolute Chart position in host coordinates. */
+export interface IChartPosition {
+    x: number;
+    y: number;
+}
+/** Chart frame size in host coordinates. */
+export interface IChartSize {
+    width: number;
+    height: number;
+}
+/** Detached information shared by host-specific Chart insertion APIs. */
+export interface IChartInfo<TSource> {
+    config: IChartCreateConfig;
+    dataSource: TSource;
+    position?: IChartPosition;
+    size?: IChartSize;
+}
 /** Pending chart edits; `null` is a runtime-only delete marker consumed before persistence. */
 export type ChartPendingConfig = Pick<IChartSemanticConfig, 'type'> & DeepNullish<Omit<IChartSemanticConfig, 'type' | 'series'>> & {
     series?: Array<{
@@ -472,7 +589,6 @@ export interface IChartSeriesDescription extends IChartSeriesStyleSpec {
 export interface IChartCategoryDescription {
     name: string;
 }
-/** Materialized engine semantic data returned explicitly by hosted builders. */
 export interface IChartDescription extends Omit<IChartSemanticConfig, 'autoGradientFill' | 'series'> {
     id: string;
     type: ChartTypeString;

package/lib/types/chart-builder/configuration/assertions.d.ts

@@ -1,3 +1,5 @@
 /** Validates semantic indexes before a Facade operation can mutate Pending state. */
 export declare function assertChartIndex(value: number, name: string): void;
 export declare function assertChartIndexes(values: readonly number[], name: string): void;
+export declare function assertDistinctChartIndexes(values: readonly number[], name: string): void;
+export declare function assertPositiveInteger(value: number, name: string): void;

package/lib/types/chart-builder/configuration/cartesian-series.d.ts

@@ -1,3 +1,4 @@
+import type { DeepNullish } from '../../types';
 import type { ChartPendingConfig, IChartSeriesStyleSpec } from '../chart-types';
 export declare enum ChartAllSeriesStyleTarget {
     Border = "border",
@@ -21,5 +22,6 @@ export type ChartPublicSeriesSelector = number | {
 };
 export declare const setSeries: (selector: ChartPublicSeriesSelector, patch: Omit<NonNullable<ChartPendingConfig["series"]>[number], "selector">) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearSeries: (selector: ChartPublicSeriesSelector, target?: ChartSeriesClearTarget) => import("./chart-config-operation").IChartConfigOperation;
-export declare const setAllSeriesStyle: (style: IChartSeriesStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearAllSeriesOverrides: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setAllSeriesStyle: (style: DeepNullish<IChartSeriesStyleSpec>) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearAllSeriesStyle: (target?: ChartAllSeriesStyleTarget) => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/chart-config-group.d.ts

@@ -0,0 +1,38 @@
+/** Top-level semantic groups accepted by the fluent chart builder. */
+export declare enum ChartConfigGroup {
+    AllSeriesStyle = "allSeriesStyle",
+    Area = "area",
+    AutoGradientFill = "autoGradientFill",
+    AxisPointer = "axisPointer",
+    Aggregation = "aggregation",
+    Appearance = "appearance",
+    Candlestick = "candlestick",
+    Histogram = "histogram",
+    Treemap = "treemap",
+    Sunburst = "sunburst",
+    Gauge = "gauge",
+    Chord = "chord",
+    Axes = "axes",
+    Bar = "bar",
+    Bubble = "bubble",
+    Heatmap = "heatmap",
+    Funnel = "funnel",
+    InvalidValueStrategy = "invalidValueStrategy",
+    Legend = "legend",
+    Mapping = "mapping",
+    MarkLines = "markLines",
+    Palette = "palette",
+    Pareto = "pareto",
+    Pie = "pie",
+    PlotArea = "plotArea",
+    Radar = "radar",
+    Relation = "relation",
+    Series = "series",
+    Subtitle = "subtitle",
+    Theme = "theme",
+    Title = "title",
+    Type = "type",
+    Trendlines = "trendlines",
+    WordCloud = "wordCloud",
+    Waterfall = "waterfall"
+}

package/lib/types/chart-builder/configuration/chart-config-operation.d.ts

@@ -1,36 +1,5 @@
 import type { ChartPendingConfig } from '../chart-types';
-/** Top-level semantic groups accepted by the fluent chart builder. */
-export declare enum ChartConfigGroup {
-    AllSeriesStyle = "allSeriesStyle",
-    Area = "area",
-    AutoGradientFill = "autoGradientFill",
-    AxisPointer = "axisPointer",
-    Aggregation = "aggregation",
-    Appearance = "appearance",
-    Candlestick = "candlestick",
-    Histogram = "histogram",
-    Treemap = "treemap",
-    Axes = "axes",
-    Bar = "bar",
-    Heatmap = "heatmap",
-    Funnel = "funnel",
-    InvalidValueStrategy = "invalidValueStrategy",
-    Legend = "legend",
-    Mapping = "mapping",
-    MarkLines = "markLines",
-    Palette = "palette",
-    Pareto = "pareto",
-    Pie = "pie",
-    Radar = "radar",
-    Relation = "relation",
-    Series = "series",
-    Subtitle = "subtitle",
-    Theme = "theme",
-    Title = "title",
-    Trendlines = "trendlines",
-    WordCloud = "wordCloud",
-    Waterfall = "waterfall"
-}
+import type { ChartConfigGroup } from './chart-config-group';
 export declare enum ChartConfigOperationMode {
     Merge = "merge",
     Replace = "replace"
@@ -41,4 +10,3 @@ export interface IChartConfigOperation {
     readonly patch: ChartPendingConfig;
 }
 export declare function chartConfigOperation<K extends ChartConfigGroup>(group: K, value: ChartPendingConfig[K], mode?: ChartConfigOperationMode): IChartConfigOperation;
-export declare function mergeChartPendingConfig(current: ChartPendingConfig, next: ChartPendingConfig): ChartPendingConfig;

package/lib/types/chart-builder/configuration/chord.d.ts

@@ -0,0 +1,12 @@
+import type { IChartChordEmphasisSpec, IChartChordLabelSpec, IChartChordLayoutSpec, IChartChordMappingSpec, IChartChordNodeStyleSpec, IChartChordRibbonStyleSpec } from '../../types';
+export declare function setChordMapping(value: IChartChordMappingSpec): import("./chart-config-operation").IChartConfigOperation;
+export declare const setChordLayout: (value: IChartChordLayoutSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetChordLayout: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setChordNode: (value: IChartChordNodeStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetChordNode: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setChordLabel: (value: IChartChordLabelSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetChordLabel: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setChordRibbon: (value: IChartChordRibbonStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetChordRibbon: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setChordEmphasis: (value: IChartChordEmphasisSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetChordEmphasis: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/gauge.d.ts

@@ -0,0 +1,31 @@
+import type { ChartGaugeMode } from '../../enum';
+import type { DeepNullish, IChartGaugeAnchorSpec, IChartGaugeAnglesSpec, IChartGaugeAxisLabelSpec, IChartGaugeAxisLineSpec, IChartGaugeAxisTickSpec, IChartGaugeDetailSpec, IChartGaugePointerSpec, IChartGaugeProgressSpec, IChartGaugeRangeSpec, IChartGaugeScaleSpec, IChartGaugeSplitLineSpec, IChartGaugeTitleSpec } from '../../types';
+import type { IChartGaugeTicksPatch } from '../chart-types';
+export declare function setGaugeValueField(index: number): import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeMode: (value: ChartGaugeMode) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeMode: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeScale: (value: IChartGaugeScaleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeScale: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeTicks: (value: IChartGaugeTicksPatch) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeAngles: (value: IChartGaugeAnglesSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeAngles: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeRanges: (value: readonly IChartGaugeRangeSpec[]) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeRanges: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeAxisLine: (value: IChartGaugeAxisLineSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeAxisLine: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeAxisTick: (value: IChartGaugeAxisTickSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeAxisTick: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeSplitLine: (value: IChartGaugeSplitLineSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeSplitLine: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeAxisLabel: (value: DeepNullish<IChartGaugeAxisLabelSpec>) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeAxisLabel: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugePointer: (value: IChartGaugePointerSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugePointer: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeAnchor: (value: IChartGaugeAnchorSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeAnchor: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeProgress: (value: IChartGaugeProgressSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeProgress: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeTitle: (value: IChartGaugeTitleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeTitle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setGaugeDetail: (value: DeepNullish<IChartGaugeDetailSpec>) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetGaugeDetail: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/pie.d.ts

@@ -1,4 +1,5 @@
-import type { IChartPieLabelSpec, IChartSliceStyleSpec } from '../chart-types';
+import type { DeepNullish } from '../../types';
+import type { IChartPieCompositeSpec, IChartPieLabelSpec, IChartSliceStyleSpec } from '../chart-types';
 export declare const setDoughnutHole: (value: number) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearDoughnutHole: () => import("./chart-config-operation").IChartConfigOperation;
 export declare const setExplosion: (value: number) => import("./chart-config-operation").IChartConfigOperation;
@@ -15,13 +16,11 @@ export declare const setLabelLineVisible: (value: boolean) => import("./chart-co
 export declare const resetLabelLineVisible: () => import("./chart-config-operation").IChartConfigOperation;
 export declare const setValueScale: (value: number) => import("./chart-config-operation").IChartConfigOperation;
 export declare const resetValueScale: () => import("./chart-config-operation").IChartConfigOperation;
-export declare const setValueSuffix: (value: string) => import("./chart-config-operation").IChartConfigOperation;
-export declare const clearValueSuffix: () => import("./chart-config-operation").IChartConfigOperation;
-export declare const setDecimalPlaces: (value: number) => import("./chart-config-operation").IChartConfigOperation;
-export declare const resetDecimalPlaces: () => import("./chart-config-operation").IChartConfigOperation;
-export declare const setPieLabel: (value: IChartPieLabelSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setPieLabel: (value: DeepNullish<IChartPieLabelSpec>) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearPieLabel: () => import("./chart-config-operation").IChartConfigOperation;
 /** Records the authored style for one materialized Pie or Donut slice. */
 export declare const setSliceStyle: (index: number, value: IChartSliceStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
 /** Clears the authored style for one materialized Pie or Donut slice. */
 export declare const clearSliceStyle: (index: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setPieComposite: (value: DeepNullish<IChartPieCompositeSpec>) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearPieComposite: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/sunburst.d.ts

@@ -0,0 +1,7 @@
+import type { DeepNullish, IChartSunburstCenterLabelSpec, IChartSunburstLabelSpec } from '../../types';
+export declare const setSunburstHierarchyFields: (indexes: readonly number[]) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setSunburstValueField: (index: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setSunburstLabel: (label: DeepNullish<IChartSunburstLabelSpec>) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetSunburstLabel: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setSunburstCenterLabel: (centerLabel: DeepNullish<IChartSunburstCenterLabelSpec>) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetSunburstCenterLabel: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/treemap.d.ts

@@ -1,8 +1,8 @@
 import type { TreemapParentLabelLayout } from '../../enum';
-import type { IChartTreemapLabelSpec } from '../../types';
+import type { DeepNullish, IChartTreemapLabelSpec } from '../../types';
 export declare const setTreemapHierarchyFields: (indexes: readonly number[]) => import("./chart-config-operation").IChartConfigOperation;
 export declare const setTreemapValueField: (index: number) => import("./chart-config-operation").IChartConfigOperation;
 export declare const setTreemapParentLabelLayout: (layout: TreemapParentLabelLayout) => import("./chart-config-operation").IChartConfigOperation;
 export declare const resetTreemapParentLabelLayout: () => import("./chart-config-operation").IChartConfigOperation;
-export declare const setTreemapLabel: (label: IChartTreemapLabelSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setTreemapLabel: (label: DeepNullish<IChartTreemapLabelSpec>) => import("./chart-config-operation").IChartConfigOperation;
 export declare const resetTreemapLabel: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/waterfall.d.ts

@@ -8,5 +8,7 @@ export declare const resetUseSubtotal: () => import("./chart-config-operation").
 export declare const setWaterfallPointRoles: (roles: readonly IChartWaterfallPointRoleSpec[]) => import("./chart-config-operation").IChartConfigOperation;
 export declare const setWaterfallConnector: (value: boolean | IChartWaterfallConnectorStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearWaterfallConnector: () => import("./chart-config-operation").IChartConfigOperation;
-export declare const setWaterfallStyle: (selector: ChartPublicSeriesSelector, target: ChartWaterfallStyleTarget, value: Omit<IChartSeriesPatch, "selector">) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setWaterfallStyle: (selector: ChartPublicSeriesSelector, target: ChartWaterfallStyleTarget, value: Omit<IChartSeriesPatch, "selector" | "waterfallStyles"> & {
+    name?: string;
+}) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearWaterfallStyle: (selector: ChartPublicSeriesSelector, target: ChartWaterfallStyleTarget) => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/conversion/chart-config-converter.d.ts

@@ -1,5 +1,6 @@
-import type { ChartStyle, DeepNullish, IChartContext, IChartDataAggregation, IChartDataSeries } from '../../types';
-import type { ChartPendingConfig, IChartDescription } from '../chart-types';
+import type { IChartDataAggregation } from '../../chart-data-aggregation';
+import type { ChartStyle, IChartContext, IChartDataSeries } from '../../types';
+import type { ChartPendingConfig, IChartCreateConfig, IChartDescription } from '../chart-types';
 import { ChartTypeBits } from '../../enum';
 interface IChartConfigConversionOptions {
     series?: IChartDataSeries[];
@@ -8,22 +9,36 @@ interface IChartConfigConversionOptions {
     currentContext?: IChartContext;
     currentDataAggregation?: IChartDataAggregation;
 }
-type ChartContextPendingPatch = DeepNullish<IChartContext>;
-interface IChartModelConfigPendingUpdate {
+interface IChartModelConfigUpdate {
     chartType?: ChartTypeBits;
     style?: ChartStyle;
-    context?: ChartContextPendingPatch;
-    dataAggregation?: Partial<IChartDataAggregation>;
-}
-interface IChartModelConfigUpdate extends Omit<IChartModelConfigPendingUpdate, 'context'> {
     context?: IChartContext;
+    dataAggregation?: Partial<IChartDataAggregation>;
 }
-export interface ICompleteChartModelConfig {
+export interface IResolvedChartModelConfigUpdate {
     chartType?: ChartTypeBits;
     style?: ChartStyle;
     context?: IChartContext;
     dataAggregation?: Partial<IChartDataAggregation>;
 }
 export declare function toChartModelConfig(config: ChartPendingConfig | IChartDescription, options?: IChartConfigConversionOptions): IChartModelConfigUpdate;
-export declare function toCompleteChartModelConfig(configChange: ChartPendingConfig, options?: IChartConfigConversionOptions): ICompleteChartModelConfig;
+/** Replaces the complete public semantic configuration while preserving engine-owned style fields. */
+export declare function toChartModelConfigReplacement(config: IChartCreateConfig, options?: IChartConfigConversionOptions): Required<IResolvedChartModelConfigUpdate>;
+interface IChartModelApplicationState {
+    chartType?: ChartTypeBits;
+    chartTypeChanged?: boolean;
+    style?: ChartStyle;
+    styleChanged?: boolean;
+    context?: IChartContext;
+    contextChanged?: boolean;
+    dataAggregation?: IChartDataAggregation;
+    dataAggregationChanged?: boolean;
+    series?: IChartDataSeries[];
+}
+interface IChartPendingApplicationState {
+    description: IChartDescription;
+    model?: IChartModelApplicationState;
+}
+export declare const chartPendingPatchInterpreter: import("../internal/patch-interpreter").IPatchInterpreter<IChartPendingApplicationState, ChartPendingConfig>;
+export declare function resolveChartModelConfigUpdate(configChange: ChartPendingConfig, options?: IChartConfigConversionOptions): IResolvedChartModelConfigUpdate;
 export {};

package/lib/types/chart-builder/conversion/chart-context-patch.d.ts

@@ -1,5 +1,5 @@
 import type { DeepNullish, IChartContext } from '../../types';
-/** Validates and clones a complete context received at a replacement boundary. */
+/** Validates a complete persisted context and returns the canonical snapshot fields only. */
 export declare function canonicalizeChartContext(value: unknown): IChartContext;
 /** Internal Pending boundary used before a command payload is created. */
 export declare function applyPendingChartContext(current: IChartContext | undefined, value: DeepNullish<IChartContext>): IChartContext;

package/lib/types/chart-builder/conversion/chart-create-config.d.ts

@@ -0,0 +1,6 @@
+import type { DeepReadonly } from '@univerjs/core';
+import type { ChartPendingConfig, IChartCreateConfig, IChartDescription } from '../chart-types';
+/** Converts an effective builder description into detached creation configuration. */
+export declare function toChartCreateConfig<TDescription extends IChartDescription>(description: DeepReadonly<TDescription>, pending: DeepReadonly<ChartPendingConfig>): IChartCreateConfig;
+/** Converts a complete live description into a reusable creation configuration. */
+export declare function toChartCreateConfigSnapshot<TDescription extends IChartDescription>(description: DeepReadonly<TDescription>, pending?: DeepReadonly<ChartPendingConfig>): IChartCreateConfig;

package/lib/types/chart-builder/conversion/chart-model-fields.d.ts

@@ -3,6 +3,7 @@ export declare enum ChartStyleField {
     AllSeriesStyle = "allSeriesStyle",
     Area = "area",
     Bar = "bar",
+    Bubble = "bubble",
     BackgroundColor = "backgroundColor",
     BorderColor = "borderColor",
     BorderWidth = "borderWidth",
@@ -11,15 +12,19 @@ export declare enum ChartStyleField {
     FontFamily = "fontFamily",
     FontSize = "fontSize",
     Funnel = "funnel",
+    Gauge = "gauge",
+    Chord = "chord",
     GradientFill = "gradientFill",
     Heatmap = "heatmap",
     Histogram = "histogram",
+    Sunburst = "sunburst",
     Treemap = "treemap",
     InvalidValueType = "invalidValueType",
     MarkLines = "markLines",
     Palette = "palette",
     Pareto = "pareto",
     Pie = "pie",
+    PlotArea = "plotArea",
     Radar = "radar",
     Relation = "relation",
     RightYAxis = "rightYAxis",
@@ -33,18 +38,28 @@ export declare enum ChartStyleField {
     YAxis = "yAxis"
 }
 export declare enum ChartContextField {
-    BubbleSeriesIndex = "bubbleSeriesIndex",
-    BubbleSizeIndex = "bubbleSizeIndex",
-    CategoryIndex = "categoryIndex",
-    Candlestick = "candlestick",
+    CategoryIndexes = "categoryIndexes",
     Histogram = "histogram",
+    SeriesIndexes = "seriesIndexes",
+    UseDateAxis = "useDateAxis"
+}
+export declare enum ChartMappingField {
+    Bubble = "bubble",
+    Candlestick = "candlestick",
+    CategoryIndex = "categoryIndex",
+    Chord = "chord",
+    Edge = "edge",
     HierarchyIndexes = "hierarchyIndexes",
-    ScatterLabelIndex = "scatterLabelIndex",
-    ScatterXIndex = "scatterXIndex",
-    ScatterYIndex = "scatterYIndex",
+    Scatter = "scatter",
     SeriesIndexes = "seriesIndexes",
     UseDateAxis = "useDateAxis"
 }
+export declare enum ChartHistogramField {
+    BinGap = "binGap",
+    Binning = "binning",
+    OverflowThreshold = "overflowThreshold",
+    UnderflowThreshold = "underflowThreshold"
+}
 export declare enum ChartDataAggregationField {
     Aggregate = "aggregate",
     TopN = "topN"
@@ -55,8 +70,10 @@ export declare enum ChartAxisTitleField {
     YAxisTitle = "yAxisTitle"
 }
 export declare enum ChartAxisStyleField {
+    AxisTitleAlignment = "label.axisTitleAlign",
     Format = "format",
     GridLineColor = "gridLine.color",
+    GridLineDashType = "gridLine.dashType",
     GridLineVisible = "gridLine.visible",
     GridLineWidth = "gridLine.width",
     LabelColor = "label.color",
@@ -105,6 +122,7 @@ export declare enum ChartSeriesStyleField {
     LabelContentType = "label.contentType",
     LabelFontSize = "label.fontSize",
     LabelFamily = "label.family",
+    LabelFormat = "label.format",
     LabelItalic = "label.italic",
     LabelPosition = "label.position",
     LabelVisible = "label.visible",