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

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

@@ -1,7 +1,7 @@
-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 { IChartData } 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';
-export { ChartAxisDimension, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartWaterfallPointRole } from '../enum';
 /** Canonical semantic chart type names exposed by the chart facade. */
 export declare enum ChartTypeString {
     Line = "line",
@@ -27,7 +27,13 @@ export declare enum ChartTypeString {
     Pareto = "pareto",
     Sankey = "sankey",
     Heatmap = "heatmap",
-    Boxplot = "boxplot"
+    Boxplot = "boxplot",
+    Candlestick = "candlestick",
+    Histogram = "histogram",
+    Treemap = "treemap",
+    Sunburst = "sunburst",
+    Gauge = "gauge",
+    Chord = "chord"
 }
 export declare enum ChartSeriesTypeString {
     Column = "column",
@@ -62,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;
@@ -87,8 +98,9 @@ export interface IChartAxisLabelSpec extends IChartFontSpec {
 }
 export interface IChartAxisSpec {
     title?: string;
-    min?: number | null;
-    max?: number | null;
+    titleAlignment?: AxisAlignEnum;
+    min?: number;
+    max?: number;
     reverse?: boolean;
     line?: {
         visible?: boolean;
@@ -102,13 +114,14 @@ export interface IChartAxisSpec {
         length?: number;
         position?: ChartAxisTickPosition;
     };
-    format?: string | null;
+    format?: string;
     titleStyle?: IChartFontSpec;
     label?: IChartAxisLabelSpec;
     gridLine?: {
         visible?: boolean;
         color?: string;
         width?: number;
+        dashType?: ChartBorderDashType;
     };
 }
 export interface IChartAxesSpec {
@@ -159,22 +172,24 @@ export type ChartSeriesSelector = {
     name: string;
 };
 export interface IChartSeriesBorderSpec {
-    color?: string | null;
+    color?: string;
     width?: number;
     opacity?: number;
     dashType?: ChartBorderDashType;
 }
+export interface IChartLineStyleSpec extends IChartSeriesBorderSpec {
+}
 export interface IChartSeriesPointSpec {
     shape?: LinePointShape;
     size?: number;
-    color?: string | null;
+    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;
 }
@@ -201,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'> {
@@ -240,7 +258,7 @@ export interface IChartHeatmapSpec {
 }
 export interface IChartWordCloudSpec {
     shape?: WordCloudShapeEnum;
-    maskImageId?: string | null;
+    maskImageId?: string;
     repeat?: boolean;
 }
 export interface IChartWordCloudDescription {
@@ -252,10 +270,10 @@ export interface IChartWordCloudDescription {
 export interface IChartAppearanceSpec {
     background?: {
         /** CSS background color. Use `'transparent'` for an explicit transparent chart and host background. */
-        color?: string | null;
+        color?: string;
     };
     border?: {
-        color?: string | null;
+        color?: string;
         /** Persisted host-border width. Use `0` to hide the host border without changing host-owned stroke state. */
         width?: number;
     };
@@ -268,24 +286,34 @@ export interface IChartAppearanceSpec {
 export interface IChartScatterMappingSpec {
     xIndex: number;
     yIndex: number;
-    labelIndex?: number | null;
+    labelIndex?: number;
 }
 export interface IChartBubbleMappingSpec extends IChartScatterMappingSpec {
-    sizeIndex?: number | null;
-    seriesIndex?: number | null;
+    sizeIndex?: number;
+    seriesIndex?: number;
+}
+export interface IChartEdgeMappingSpec {
+    sourceIndex: number;
+    targetIndex: number;
+    valueIndex?: number;
 }
 export interface IChartMappingSpec {
-    categoryIndex?: number | null;
-    seriesIndexes?: number[] | null;
-    useDateAxis?: boolean | null;
-    scatter?: IChartScatterMappingSpec | null;
-    bubble?: IChartBubbleMappingSpec | null;
+    categoryIndex?: number;
+    /** Ordered root-to-leaf hierarchy fields for hierarchy charts. */
+    hierarchyIndexes?: number[];
+    seriesIndexes?: number[];
+    useDateAxis?: boolean;
+    scatter?: IChartScatterMappingSpec;
+    bubble?: IChartBubbleMappingSpec;
+    candlestick?: IChartCandlestickMappingSpec;
+    chord?: IChartChordMappingSpec;
+    edge?: IChartEdgeMappingSpec;
 }
 export interface IChartAggregationSpec {
-    aggregate?: boolean | null;
-    topN?: number | null;
+    aggregate?: boolean;
+    topN?: IChartTopNSpec;
 }
-export interface IChartPieLabelSpec extends IChartFontSpec {
+export interface IChartPieLabelSpec extends IChartFontSpec, IChartValueLabelSpec {
     visible?: boolean;
     position?: PieLabelPosition;
     contentType?: LabelContentType;
@@ -295,8 +323,68 @@ 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 {
-    doughnutHole?: number | null;
+    composite?: IChartPieCompositeSpec;
+    /** Clockwise degrees from 12 o'clock. */
+    startAngle?: number;
+    doughnutHole?: number;
     explosion?: number;
     borderColor?: string;
     hasPaddingAngle?: boolean;
@@ -304,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>>;
@@ -328,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 {
@@ -344,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 {
@@ -353,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 {
@@ -367,17 +455,29 @@ export interface IChartAxisPointerSpec {
     indicatorLabelTextColor?: string;
 }
 export interface IChartAreaSpec {
-    lineStyle?: AreaLineStyle | null;
+    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 | null;
-    useAbsoluteValue?: boolean | null;
+    gap?: number;
+    useAbsoluteValue?: boolean;
 }
 export interface IChartRelationForceSpec {
     gravity?: number;
@@ -385,12 +485,12 @@ export interface IChartRelationForceSpec {
     edgeLength?: number;
 }
 export interface IChartRelationSpec {
-    layout?: RelationChartLayoutEnum | null;
-    useValueAsSymbolSize?: boolean | null;
-    emphasisEnabled?: boolean | null;
-    force?: IChartRelationForceSpec | null;
-    circularLabelRotation?: boolean | null;
-    nodeShape?: LinePointShape | null;
+    layout?: RelationChartLayoutEnum;
+    useValueAsSymbolSize?: boolean;
+    emphasisEnabled?: boolean;
+    force?: IChartRelationForceSpec;
+    circularLabelRotation?: boolean;
+    nodeShape?: LinePointShape;
 }
 /** Waterfall semantic configuration exposed through the Facade. */
 export interface IChartWaterfallSpec {
@@ -398,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 | {
@@ -420,33 +520,47 @@ export interface IChartWaterfallConnectorStyleSpec {
 interface IChartSemanticConfig {
     type?: ChartTypeString;
     autoGradientFill?: boolean;
-    title?: ChartTitleSpec | null;
-    subtitle?: ChartSubtitleSpec | null;
-    trendlines?: IChartTrendlineSpec[] | null;
-    heatmap?: IChartHeatmapSpec | null;
-    invalidValueStrategy?: InvalidValueType | null;
-    legend?: ChartLegendSpec | null;
-    axes?: IChartAxesSpec | null;
-    allSeriesStyle?: IChartSeriesStyleSpec | null;
-    series?: IChartSeriesPatch[] | null;
-    wordCloud?: IChartWordCloudSpec | null;
-    appearance?: IChartAppearanceSpec | null;
-    mapping?: IChartMappingSpec | null;
-    aggregation?: IChartAggregationSpec | null;
-    pie?: IChartPieSpec | null;
-    radar?: IChartRadarSpec | null;
-    pareto?: IChartParetoSpec | null;
-    axisPointer?: IChartAxisPointerSpec | null;
-    area?: IChartAreaSpec | null;
-    bar?: IChartBarSpec | null;
-    funnel?: IChartFunnelSpec | null;
-    relation?: IChartRelationSpec | null;
-    waterfall?: IChartWaterfallSpec | null;
-    markLines?: IChartMarkLineSpec[] | null;
-    theme?: string | null;
+    title?: ChartTitleSpec;
+    subtitle?: ChartSubtitleSpec;
+    trendlines?: IChartTrendlineSpec[];
+    heatmap?: IChartHeatmapSpec;
+    invalidValueStrategy?: InvalidValueType;
+    legend?: ChartLegendSpec;
+    axes?: IChartAxesSpec;
+    allSeriesStyle?: IChartSeriesStyleSpec;
+    series?: IChartSeriesPatch[];
+    wordCloud?: IChartWordCloudSpec;
+    appearance?: IChartAppearanceSpec;
+    mapping?: IChartMappingSpec;
+    aggregation?: IChartAggregationSpec;
+    pie?: IChartPieSpec;
+    radar?: IChartRadarSpec;
+    pareto?: IChartParetoSpec;
+    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[] | null;
+    palette?: string[];
 }
+/** 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<{
+        selector: ChartSeriesSelector;
+    } & DeepNullish<Omit<IChartSeriesPatch, 'selector'>>> | null;
+};
 /** Data-free metadata and semantic styling for one source series. */
 export interface IChartSeriesDescription extends IChartSeriesStyleSpec {
     name: string;
@@ -458,8 +572,6 @@ export interface IChartSeriesDescription extends IChartSeriesStyleSpec {
 export interface IChartCategoryDescription {
     name: string;
 }
-/** Materialized engine semantic data returned explicitly by hosted builders. */
-export type IResolvedChartData = IChartData;
 export interface IChartDescription extends Omit<IChartSemanticConfig, 'autoGradientFill' | 'series'> {
     id: string;
     type: ChartTypeString;
@@ -484,3 +596,4 @@ export interface IChartDescription extends Omit<IChartSemanticConfig, 'autoGradi
      */
     axisBindings?: Partial<Record<ChartSemanticAxis, IChartAxisBindingDescription>>;
 }
+export {};

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

@@ -1,2 +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/candlestick.d.ts

@@ -0,0 +1,9 @@
+import type { IChartCandlestickStateStyleSpec } from '../../types';
+export declare const setRisingStyle: (value: IChartCandlestickStateStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearRisingStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setFallingStyle: (value: IChartCandlestickStateStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearFallingStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setDojiStyle: (value: IChartCandlestickStateStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearDojiStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setCandleWidth: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetCandleWidth: () => import("./chart-config-operation").IChartConfigOperation;

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,5 @@ 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 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-operation.d.ts

@@ -7,8 +7,15 @@ export declare enum ChartConfigGroup {
     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",
@@ -18,6 +25,7 @@ export declare enum ChartConfigGroup {
     Palette = "palette",
     Pareto = "pareto",
     Pie = "pie",
+    PlotArea = "plotArea",
     Radar = "radar",
     Relation = "relation",
     Series = "series",
@@ -38,4 +46,4 @@ 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;
+export declare function mergeChartPendingConfig(current: ChartPendingConfig, next: ChartPendingConfig, path?: readonly string[]): 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 { DeepNullish, IChartGaugeAnchorSpec, IChartGaugeAnglesSpec, IChartGaugeAxisLabelSpec, IChartGaugeAxisLineSpec, IChartGaugeAxisTickSpec, IChartGaugeDetailSpec, IChartGaugePointerSpec, IChartGaugeProgressSpec, IChartGaugeRangeSpec, IChartGaugeScaleSpec, IChartGaugeSplitLineSpec, IChartGaugeTitleSpec } from '../../types';
+import type { ChartGaugeMode } from '../../enum';
+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/histogram.d.ts

@@ -0,0 +1,11 @@
+export declare const setHistogramField: (index: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearHistogramField: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramBinCount: (count: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramBinWidth: (width: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetHistogramBinning: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramUnderflowThreshold: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearHistogramUnderflowThreshold: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramOverflowThreshold: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearHistogramOverflowThreshold: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramBinGap: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetHistogramBinGap: () => 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/point-mapping.d.ts

@@ -1,5 +1,8 @@
+import type { IChartCandlestickMappingSpec } from '../../types';
 import type { IChartBubbleMappingSpec, IChartScatterMappingSpec } from '../chart-types';
 export declare const setScatterMapping: (value: IChartScatterMappingSpec) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearScatterMapping: () => import("./chart-config-operation").IChartConfigOperation;
 export declare const setBubbleMapping: (value: IChartBubbleMappingSpec) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearBubbleMapping: () => import("./chart-config-operation").IChartConfigOperation;
+export declare function setCandlestickFields(value: IChartCandlestickMappingSpec): import("./chart-config-operation").IChartConfigOperation;
+export declare const clearCandlestickFields: () => 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

@@ -0,0 +1,8 @@
+import type { TreemapParentLabelLayout } from '../../enum';
+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: 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,4 +1,5 @@
-import type { ChartStyle, IChartContext, IChartDataAggregation, IChartDataSeries } from '../../types';
+import type { IChartDataAggregation } from '../../chart-data-aggregation';
+import type { ChartStyle, DeepNullish, IChartContext, IChartDataSeries } from '../../types';
 import type { ChartPendingConfig, IChartDescription } from '../chart-types';
 import { ChartTypeBits } from '../../enum';
 interface IChartConfigConversionOptions {
@@ -8,12 +9,16 @@ interface IChartConfigConversionOptions {
     currentContext?: IChartContext;
     currentDataAggregation?: IChartDataAggregation;
 }
-interface IChartModelConfigUpdate {
+type ChartContextPendingPatch = DeepNullish<IChartContext>;
+interface IChartModelConfigPendingUpdate {
     chartType?: ChartTypeBits;
     style?: ChartStyle;
-    context?: IChartContext;
+    context?: ChartContextPendingPatch;
     dataAggregation?: Partial<IChartDataAggregation>;
 }
+interface IChartModelConfigUpdate extends Omit<IChartModelConfigPendingUpdate, 'context'> {
+    context?: IChartContext;
+}
 export interface ICompleteChartModelConfig {
     chartType?: ChartTypeBits;
     style?: ChartStyle;
@@ -22,4 +27,5 @@ export interface ICompleteChartModelConfig {
 }
 export declare function toChartModelConfig(config: ChartPendingConfig | IChartDescription, options?: IChartConfigConversionOptions): IChartModelConfigUpdate;
 export declare function toCompleteChartModelConfig(configChange: ChartPendingConfig, options?: IChartConfigConversionOptions): ICompleteChartModelConfig;
+export declare function applyChartStylePatch(current: ChartStyle | undefined, patch: DeepNullish<ChartStyle>): ChartStyle;
 export {};

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

@@ -0,0 +1,5 @@
+import type { DeepNullish, IChartContext } from '../../types';
+/** 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;