@univerjs-pro/engine-chart 1.0.0-alpha.2 → 1.0.0-alpha.4

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

@@ -0,0 +1,29 @@
+export type { IChartAxisPointerSpec, IChartRelationForceSpec } from '../chart-types';
+export { ChartWaterfallStyleTarget } from '../chart-types';
+export * from './aggregation';
+export * from './appearance';
+export * from './area';
+export * from './axes';
+export * from './axis-pointer';
+export * from './bar';
+export * from './cartesian-series';
+export * from './combination';
+export * from './funnel';
+export * from './heatmap';
+export * from './invalid-value';
+export * from './legend';
+export * from './line';
+export * from './mapping';
+export * from './mark-lines';
+export * from './palette';
+export * from './pareto';
+export * from './pie';
+export * from './point-mapping';
+export * from './radar';
+export * from './relation';
+export * from './subtitle';
+export * from './theme';
+export * from './title';
+export * from './trendline';
+export * from './waterfall';
+export * from './word-cloud';

package/lib/types/chart-builder/configuration/invalid-value.d.ts

@@ -0,0 +1,3 @@
+import type { InvalidValueType } from '../../enum';
+export declare const setInvalidValueStrategy: (value: InvalidValueType) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetInvalidValueStrategy: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,3 @@
+import type { ChartLegendSpec } from '../chart-types';
+export declare const setLegend: (value: ChartLegendSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearLegend: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,3 @@
+import type { IChartSeriesBorderSpec } from '../chart-types';
+export declare const setLineStyle: (value: IChartSeriesBorderSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearLineStyle: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,4 @@
+export declare const setCategoryField: (index: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearCategoryField: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setValueFields: (indexes: readonly number[]) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearValueFields: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/mark-lines.d.ts

@@ -0,0 +1,3 @@
+import type { IChartMarkLineSpec } from '../chart-types';
+export declare const setMarkLines: (lines: readonly IChartMarkLineSpec[]) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearMarkLines: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,4 @@
+/** Creates a copied palette patch; an empty palette clears the chart-owned override. */
+export declare const setPalette: (colors: readonly string[]) => import("./chart-config-operation").IChartConfigOperation;
+/** Clears the chart-owned palette so the selected theme supplies series colors again. */
+export declare const clearPalette: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,7 @@
+import type { IChartParetoBarStyleSpec, IChartParetoLineStyleSpec } from '../chart-types';
+export declare const setParetoBarStyle: (value: IChartParetoBarStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearParetoBarStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setCumulativeLineStyle: (value: IChartParetoLineStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearCumulativeLineStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setIncludeZeroValues: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetIncludeZeroValues: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,23 @@
+import type { IChartPieLabelSpec } 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;
+export declare const resetExplosion: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setSliceBorderColor: (value: string) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearSliceBorderColor: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setPaddingAngleEnabled: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetPaddingAngleEnabled: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHalfPie: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetHalfPie: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setRosePie: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetRosePie: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setLabelLineVisible: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+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 clearPieLabel: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/point-mapping.d.ts

@@ -0,0 +1,5 @@
+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;

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

@@ -0,0 +1,5 @@
+import type { RadarShape } from '../../enum';
+export declare const setRadarShape: (value: RadarShape) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetRadarShape: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setRadarFill: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetRadarFill: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,14 @@
+import type { LinePointShape, RelationChartLayoutEnum } from '../../enum';
+import type { IChartRelationForceSpec } from '../chart-types';
+export declare const setRelationLayout: (value: RelationChartLayoutEnum) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetRelationLayout: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setUseValueAsSymbolSize: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetUseValueAsSymbolSize: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setEmphasisEnabled: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetEmphasisEnabled: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setRelationForce: (value: IChartRelationForceSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearRelationForce: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setCircularLabelRotation: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetCircularLabelRotation: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setRelationNodeShape: (value: LinePointShape) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetRelationNodeShape: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,3 @@
+import type { ChartSubtitleSpec } from '../chart-types';
+export declare const setSubtitle: (value: ChartSubtitleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearSubtitle: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,4 @@
+/** Selects a theme without changing the independently persisted palette override. */
+export declare const setTheme: (value: string) => import("./chart-config-operation").IChartConfigOperation;
+/** Clears only the selected theme while preserving any chart-owned palette. */
+export declare const clearTheme: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,3 @@
+import type { ChartTitleSpec } from '../chart-types';
+export declare const setTitle: (value: ChartTitleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearTitle: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,12 @@
+import type { DeepReadonly } from '@univerjs/core';
+import type { IChartDescription, IChartTrendlineSpec } from '../chart-types';
+export type ChartTrendlineValue = Omit<IChartTrendlineSpec, 'selector'>;
+export type ChartSeriesTrendlineSelector = number | {
+    name: string;
+};
+export type ChartTrendlineSelector = number | {
+    name: string;
+};
+export declare const setTrendline: (target: ChartSeriesTrendlineSelector, value: ChartTrendlineValue) => import("./chart-config-operation").IChartConfigOperation;
+export declare function removeTrendline(description: DeepReadonly<IChartDescription>, series: ChartSeriesTrendlineSelector, trendline: ChartTrendlineSelector): import("./chart-config-operation").IChartConfigOperation;
+export declare function clearTrendlines(description: DeepReadonly<IChartDescription>, series?: ChartSeriesTrendlineSelector): import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,12 @@
+import type { WaterfallStackTypeEnum } from '../../enum';
+import type { ChartWaterfallStyleTarget, IChartSeriesPatch, IChartWaterfallConnectorStyleSpec, IChartWaterfallPointRoleSpec } from '../chart-types';
+import type { ChartPublicSeriesSelector } from './cartesian-series';
+export declare const setWaterfallStackType: (value: WaterfallStackTypeEnum) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetWaterfallStackType: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setUseSubtotal: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetUseSubtotal: () => import("./chart-config-operation").IChartConfigOperation;
+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 clearWaterfallStyle: (selector: ChartPublicSeriesSelector, target: ChartWaterfallStyleTarget) => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/word-cloud.d.ts

@@ -0,0 +1,7 @@
+import type { WordCloudShapeEnum } from '../../enum';
+export declare const setWordCloudShape: (value: WordCloudShapeEnum) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetWordCloudShape: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setMaskImage: (resourceId: string) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearMaskImage: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setWordCloudRepeat: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetWordCloudRepeat: () => import("./chart-config-operation").IChartConfigOperation;

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

@@ -0,0 +1,24 @@
+import type { ChartStyle, IChartContext, IChartDataAggregation, IChartDataSeries } from '../../types';
+import type { ChartPendingConfig, IChartDescription } from '../chart-types';
+import { ChartTypeBits } from '../../enum';
+interface IChartConfigConversionOptions {
+    series?: IChartDataSeries[];
+    currentStyle?: ChartStyle;
+    currentContext?: IChartContext;
+    currentDataAggregation?: IChartDataAggregation;
+}
+interface IChartModelConfigUpdate {
+    chartType?: ChartTypeBits;
+    style?: ChartStyle;
+    context?: IChartContext;
+    dataAggregation?: Partial<IChartDataAggregation>;
+}
+export interface ICompleteChartModelConfig {
+    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;
+export {};

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

@@ -0,0 +1,115 @@
+/** Stable engine model keys shared by semantic facade encoding and description. */
+export declare enum ChartStyleField {
+    AllSeriesStyle = "allSeriesStyle",
+    Area = "area",
+    Bar = "bar",
+    BackgroundColor = "backgroundColor",
+    BorderColor = "borderColor",
+    BorderWidth = "borderWidth",
+    FontColor = "fontColor",
+    FontFamily = "fontFamily",
+    FontSize = "fontSize",
+    Funnel = "funnel",
+    GradientFill = "gradientFill",
+    Heatmap = "heatmap",
+    InvalidValueType = "invalidValueType",
+    MarkLines = "markLines",
+    Palette = "palette",
+    Pareto = "pareto",
+    Pie = "pie",
+    Radar = "radar",
+    Relation = "relation",
+    RightYAxis = "rightYAxis",
+    SeriesStyleMap = "seriesStyleMap",
+    Theme = "theme",
+    Tooltip = "tooltip",
+    Trendlines = "trendlines",
+    Waterfall = "waterfall",
+    WordCloud = "wordCloud",
+    XAxis = "xAxis",
+    YAxis = "yAxis"
+}
+export declare enum ChartContextField {
+    BubbleSeriesIndex = "bubbleSeriesIndex",
+    BubbleSizeIndex = "bubbleSizeIndex",
+    CategoryIndex = "categoryIndex",
+    ScatterLabelIndex = "scatterLabelIndex",
+    ScatterXIndex = "scatterXIndex",
+    ScatterYIndex = "scatterYIndex",
+    SeriesIndexes = "seriesIndexes",
+    UseDateAxis = "useDateAxis"
+}
+export declare enum ChartDataAggregationField {
+    Aggregate = "aggregate",
+    TopN = "topN"
+}
+export declare enum ChartAxisTitleField {
+    RightYAxisTitle = "rightYAxisTitle",
+    XAxisTitle = "xAxisTitle",
+    YAxisTitle = "yAxisTitle"
+}
+export declare enum ChartAxisStyleField {
+    Format = "format",
+    GridLineColor = "gridLine.color",
+    GridLineVisible = "gridLine.visible",
+    GridLineWidth = "gridLine.width",
+    LabelColor = "label.color",
+    LabelBold = "label.bold",
+    LabelFamily = "label.family",
+    LabelFontSize = "label.fontSize",
+    LabelItalic = "label.italic",
+    LabelRotate = "label.rotate",
+    LabelVisible = "label.visible",
+    LineStyleColor = "lineStyle.color",
+    LineStyleWidth = "lineStyle.width",
+    LineVisible = "lineVisible",
+    Max = "max",
+    Min = "min",
+    Reverse = "reverse",
+    TickLength = "tick.length",
+    TickLineColor = "tick.lineColor",
+    TickLineWidth = "tick.lineWidth",
+    TickPosition = "tick.position",
+    TickVisible = "tick.visible"
+}
+export declare enum ChartTitleStyleField {
+    Bold = "bold",
+    Color = "color",
+    Content = "content",
+    Family = "family",
+    FontSize = "fontSize",
+    Italic = "italic"
+}
+export declare enum ChartSeriesSelectorField {
+    Index = "index",
+    Name = "name",
+    Selector = "selector"
+}
+export declare enum ChartSeriesStyleField {
+    BorderColor = "border.color",
+    BorderDashType = "border.dashType",
+    BorderOpacity = "border.opacity",
+    BorderWidth = "border.width",
+    ChartType = "chartType",
+    Color = "color",
+    DataPoints = "dataPoints",
+    FillOpacity = "fillOpacity",
+    LabelBold = "label.bold",
+    LabelColor = "label.color",
+    LabelContentType = "label.contentType",
+    LabelFontSize = "label.fontSize",
+    LabelFamily = "label.family",
+    LabelItalic = "label.italic",
+    LabelPosition = "label.position",
+    LabelVisible = "label.visible",
+    PointColor = "point.color",
+    PointShape = "point.shape",
+    PointSize = "point.size",
+    RightYAxis = "rightYAxis"
+}
+export declare enum ChartDataPointStyleField {
+    Color = "color",
+    FillOpacity = "fillOpacity",
+    Shape = "shape",
+    Size = "size"
+}

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

@@ -0,0 +1,6 @@
+import type { ChartStyle } from '../../types';
+import { ChartTypeBits } from '../../enum';
+import { ChartTypeString } from '../chart-types';
+export declare function chartTypeToBits(type: ChartTypeString): ChartTypeBits;
+export declare function chartBitsToType(bits: ChartTypeBits, style?: ChartStyle): ChartTypeString;
+export declare function getInitialChartStyle(type: ChartTypeString): ChartStyle | undefined;

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

@@ -0,0 +1,11 @@
+import type { ChartModel } from '../../models/chart-model';
+import type { IUniverDataSet } from '../../types';
+import type { ChartPendingConfig, IChartDescription } from '../chart-types';
+export declare function describeChartModel(chartModel: ChartModel, pending?: ChartPendingConfig, dataSet?: IUniverDataSet): IChartDescription;
+/** Projects data-free field metadata from an effective source without materializing chart data. */
+export declare function resolveChartDescriptionMetadata(description: IChartDescription, dataSet: IUniverDataSet, localeTexts?: {
+    seriesDefaultName: string;
+    categoryDefaultName: string;
+}): Pick<IChartDescription, 'series' | 'category'>;
+/** Resolves pending semantic state from source metadata without consulting debounced render config. */
+export declare function resolveChartModelEffectiveConfig(chartModel: ChartModel, pending: ChartPendingConfig, dataSet: IUniverDataSet): import("./chart-config-converter").ICompleteChartModelConfig;

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

@@ -0,0 +1,5 @@
+import type { ChartModel } from '../../models/chart-model';
+import type { IUniverDataSet } from '../../types';
+import type { ChartPendingConfig, IResolvedChartData } from '../chart-types';
+/** Resolves fresh engine semantic data from the model plus an uncommitted Facade patch. */
+export declare function resolveChartModelData(model: ChartModel, pending: ChartPendingConfig, dataSet?: IUniverDataSet, isRowDirection?: boolean): IResolvedChartData;

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

@@ -0,0 +1,19 @@
+import type { IChartRenderModelImageExportOptions, IUniverDataSet } from '../types';
+import type { IChartBuilderAdapter } from './chart-builder-adapter';
+import type { ChartPendingConfig, IChartDescription } from './chart-types';
+/** Shared adapter behavior for builders that have not been inserted into a host. */
+export declare class DetachedChartBuilderAdapter<THostDescription extends object = object> implements IChartBuilderAdapter<THostDescription> {
+    private readonly _description;
+    private readonly _commitError;
+    /** Creates detached behavior for a description and host-specific commit error. */
+    constructor(_description: IChartDescription & THostDescription, _commitError: string);
+    /** Returns a clone of the detached description. */
+    describe(config?: ChartPendingConfig, dataSet?: IUniverDataSet): IChartDescription & THostDescription;
+    /** Rejects persistence until the chart has been inserted into a host. */
+    commit(): never;
+    /** Detached drafts have no hosted materialization lifecycle. */
+    resolveData(): never;
+    /** Returns `null` because a detached chart has no render model. */
+    exportImage(_options?: IChartRenderModelImageExportOptions): Promise<null>;
+    protected rejectCommit(): never;
+}

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

@@ -0,0 +1,12 @@
+export { ChartBuilder } from './chart-builder';
+export type { IChartBuilderAdapter } from './chart-builder-adapter';
+export type { ChartDescription } from './chart-description';
+export * from './chart-types';
+export * from './configuration';
+export { toChartModelConfig, toCompleteChartModelConfig } from './conversion/chart-config-converter';
+export { chartBitsToType, chartTypeToBits } from './conversion/chart-type-converter';
+export { describeChartModel, resolveChartDescriptionMetadata } from './conversion/describe-chart-model';
+export { resolveChartModelData } from './conversion/resolve-chart-model-data';
+export { DetachedChartBuilderAdapter } from './detached-chart-builder-adapter';
+export type { IInlineChartBuilderAdapter, IInlineChartHostPatch } from './internal/host-builder-runtime';
+export { InlineChartBuilder, resolveInlineChartDataSet } from './internal/host-builder-runtime';

package/lib/types/chart-builder/internal/deep-freeze.d.ts

@@ -0,0 +1 @@
+export declare function deepFreeze<T>(value: T): T;

package/lib/types/chart-builder/internal/host-builder-runtime.d.ts

@@ -0,0 +1,5 @@
+import type { IUniverDataSet } from '../../types';
+export { resolveChartDescriptionMetadata } from '../conversion/describe-chart-model';
+export { resolveChartModelData } from '../conversion/resolve-chart-model-data';
+/** Builds a detached data set from raw inline values and disposes the temporary source. */
+export declare function resolveInlineChartDataSet<TCell>(values: TCell[][], buildDataSet: (data: TCell[][]) => IUniverDataSet, isRowDirection?: boolean): IUniverDataSet;

package/lib/types/chart-builder/internal/merge-description.d.ts

@@ -0,0 +1,2 @@
+import type { ChartPendingConfig, IChartDescription } from '../chart-types';
+export declare function mergeChartDescription<THost extends object>(baseline: IChartDescription & THost, pending: ChartPendingConfig): IChartDescription & THost;

package/lib/types/enum.d.ts

@@ -88,10 +88,34 @@ export declare enum DataOrientation {
     Column = "Column"
 }
 export declare enum IRuntimeAxisPosition {
+    Top = "top",
     Left = "left",
     Right = "right",
     Bottom = "bottom"
 }
+/** Stable semantic roles for axes whose physical position may change. */
+export declare enum ChartSemanticAxis {
+    Category = "category",
+    SecondaryCategory = "secondaryCategory",
+    PrimaryValue = "primaryValue",
+    SecondaryValue = "secondaryValue"
+}
+/** Canvas dimension occupied by a resolved chart axis. */
+export declare enum ChartAxisDimension {
+    Horizontal = "horizontal",
+    Vertical = "vertical"
+}
+/** Physical label placement along a fixed-axis mark line. */
+export declare enum ChartMarkLineLabelPosition {
+    Start = "start",
+    Middle = "middle",
+    End = "end"
+}
+/** Meaning assigned to one Waterfall data point. */
+export declare enum ChartWaterfallPointRole {
+    Change = "change",
+    Total = "total"
+}
 export declare enum IRuntimeAxisPriority {
     Primary = 1,
     Secondary = 2,
@@ -210,6 +234,10 @@ export declare enum RadarShape {
     Polygon = "polygon",
     Circle = "circle"
 }
+export declare enum BarShape {
+    Box = "box",
+    Cylinder = "cylinder"
+}
 /**
  * The border type of the chart series.
  */
@@ -389,3 +417,11 @@ export declare enum WaterfallSeriesTypeEnum {
     negative = 8,
     subtotal = 16
 }
+export declare enum ParetoSeriesIndex {
+    Bar = 0,
+    Line = 1
+}
+export declare enum ParetoSeriesPart {
+    Bar = "bar",
+    Line = "line"
+}

package/lib/types/facade/builders/f-area-chart-builder.d.ts

@@ -0,0 +1,33 @@
+import type { AreaLineStyle } from '@univerjs-pro/engine-chart';
+import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
+export declare class FAreaChartBuilder extends FCartesianChartBuilder {
+    /**
+     * Sets the area line style configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param value The semantic value to record.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Area);
+     * builder.setAreaLineStyle(univerAPI.Enum.AreaLineStyle.Smooth);
+     * ```
+     */
+    setAreaLineStyle(value: AreaLineStyle): this;
+    /**
+     * Clears the area line style override and restores a straight line between points.
+     *
+     * This method executes synchronously.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Area);
+     * builder.clearAreaLineStyle();
+     * ```
+     */
+    clearAreaLineStyle(): this;
+}

package/lib/types/facade/builders/f-bubble-chart-builder.d.ts

@@ -0,0 +1,33 @@
+import type { IChartBubbleMappingSpec } from '@univerjs-pro/engine-chart';
+import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
+export declare class FBubbleChartBuilder extends FCartesianChartBuilder {
+    /**
+     * Sets the bubble mapping configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param value The semantic value to record.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Bubble);
+     * builder.setBubbleMapping({ xIndex: 0, yIndex: 1, sizeIndex: 2 });
+     * ```
+     */
+    setBubbleMapping(value: IChartBubbleMappingSpec): this;
+    /**
+     * Clears the bubble mapping configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Bubble);
+     * builder.clearBubbleMapping();
+     * ```
+     */
+    clearBubbleMapping(): this;
+}

package/lib/types/facade/builders/f-combination-chart-builder.d.ts

@@ -0,0 +1,66 @@
+import type { ChartPublicSeriesSelector, ChartSeriesAxis, ChartSeriesTypeString } from '@univerjs-pro/engine-chart';
+import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
+export declare class FCombinationChartBuilder extends FCartesianChartBuilder {
+    /**
+     * Sets the series type configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param selector The target series selector.
+     * @param value The semantic value to record.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Combination);
+     * builder.setSeriesType(0, univerAPI.Enum.ChartSeriesTypeString.Line);
+     * ```
+     */
+    setSeriesType(selector: ChartPublicSeriesSelector, value: ChartSeriesTypeString): this;
+    /**
+     * Removes the series override. The first series defaults to `Column` and later series default to `Line`.
+     *
+     * This method executes synchronously.
+     *
+     * @param selector The target series selector.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Combination);
+     * builder.resetSeriesType(0);
+     * ```
+     */
+    resetSeriesType(selector: ChartPublicSeriesSelector): this;
+    /**
+     * Sets the series axis configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param selector The target series selector.
+     * @param value The semantic value to record.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Combination);
+     * builder.setSeriesAxis(0, univerAPI.Enum.ChartSeriesAxis.Right);
+     * ```
+     */
+    setSeriesAxis(selector: ChartPublicSeriesSelector, value: ChartSeriesAxis): this;
+    /**
+     * Removes the series override so the series uses the primary value axis.
+     *
+     * This method executes synchronously.
+     *
+     * @param selector The target series selector.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Combination);
+     * builder.resetSeriesAxis(0);
+     * ```
+     */
+    resetSeriesAxis(selector: ChartPublicSeriesSelector): this;
+}