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

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

@@ -1,5 +1,5 @@
-import type { ChartModel } from '../../models/chart-model';
-import type { IUniverDataSet } from '../../types';
-import type { ChartPendingConfig, IResolvedChartData } from '../chart-types';
+import type { ChartModel } from '../../models/chart-model/chart-model';
+import type { IChartData, IUniverDataSet } from '../../types';
+import type { ChartPendingConfig } 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;
+export declare function resolveChartModelData(model: ChartModel, pending: ChartPendingConfig, dataSet?: IUniverDataSet): IChartData;

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

@@ -1,12 +1,16 @@
+import type { Injector } from '@univerjs/core';
+import type { InlineChartCellValue } from '../models/chart-host/resource/inline-chart-table';
 import type { IChartRenderModelImageExportOptions, IUniverDataSet } from '../types';
 import type { IChartBuilderAdapter } from './chart-builder-adapter';
 import type { ChartPendingConfig, IChartDescription } from './chart-types';
+import type { IInlineChartBuilderAdapter, IInlineChartHostPatch } from './internal/host-builder-runtime';
 /** 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);
+    constructor(_description: IChartDescription & THostDescription, _commitError: string, injector: Injector);
+    private readonly _localeTexts;
     /** 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. */
@@ -17,3 +21,8 @@ export declare class DetachedChartBuilderAdapter<THostDescription extends object
     exportImage(_options?: IChartRenderModelImageExportOptions): Promise<null>;
     protected rejectCommit(): never;
 }
+/** Detached behavior shared by inline-data builders before insertion into a host. */
+export declare class DetachedInlineChartBuilderAdapter<THostDescription extends object, TCell extends InlineChartCellValue, THostPatch extends IInlineChartHostPatch<TCell>> extends DetachedChartBuilderAdapter<THostDescription> implements IInlineChartBuilderAdapter<THostDescription, TCell, THostPatch> {
+    commitHost(_patch: THostPatch): never;
+    getData(): null;
+}

package/lib/types/chart-builder/internal/chart-patch-replace-policy.d.ts

@@ -0,0 +1,6 @@
+export declare const REPLACE_ONLY_PIE_COMPOSITE_SECONDARY_PLOT_SPLIT_PATH = "pie.composite.secondaryPlot.split";
+/**
+ * Object values at these paths are complete authored values, not partial object patches.
+ * Deep-merging them would retain fields omitted by the replacement value.
+ */
+export declare function isReplaceOnlyChartPatchPath(path: readonly string[]): boolean;

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

@@ -1,5 +1,3 @@
 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-data-aggregation.d.ts

@@ -0,0 +1,10 @@
+/** Canonical TopN configuration persisted with a chart. */
+export interface IChartTopNSpec {
+    count: number;
+    sourceIndex?: number;
+}
+/** Authored category aggregation and ranking configuration. */
+export interface IChartDataAggregation {
+    aggregate?: boolean;
+    topN?: IChartTopNSpec;
+}

package/lib/types/chart-text-measure-canvas.d.ts

@@ -0,0 +1,6 @@
+interface ISize {
+    width: number;
+    height: number;
+}
+export declare const calcPosition: (text: string, font: string) => ISize;
+export {};

package/lib/types/config/config.d.ts

@@ -0,0 +1,7 @@
+import type { IWordCloudRenderConfig } from '../wordcloud-chart/word-cloud-render-config';
+export declare const ENGINE_CHART_PLUGIN_CONFIG_KEY = "engine-chart.config";
+export declare const configSymbol: unique symbol;
+export interface IUniverChartConfig {
+    wordCloudRenderConfig?: IWordCloudRenderConfig;
+}
+export declare const defaultPluginConfig: IUniverChartConfig;

package/lib/types/enum.d.ts

@@ -76,8 +76,57 @@ export declare enum ChartTypeBits {
     /** Sankey chart */
     Sankey = 32768,
     Heatmap = 65536,
-    Boxplot = 131072
-}
+    Boxplot = 131072,
+    /** Candlestick chart */
+    Candlestick = 262144,
+    /** Histogram chart */
+    Histogram = 524288,
+    /** Treemap chart */
+    Treemap = 1048576,
+    /** Sunburst chart */
+    Sunburst = 2097152,
+    /** Gauge chart */
+    Gauge = 4194304,
+    /** Chord chart */
+    Chord = 8388608
+}
+export declare const ChartChordLabelPosition: {
+    readonly Inside: "inside";
+    readonly Outside: "outside";
+};
+export type ChartChordLabelPosition = typeof ChartChordLabelPosition[keyof typeof ChartChordLabelPosition];
+export declare const ChartChordFocusMode: {
+    readonly Adjacency: "adjacency";
+    readonly Self: "self";
+    readonly None: "none";
+};
+export type ChartChordFocusMode = typeof ChartChordFocusMode[keyof typeof ChartChordFocusMode];
+/** Persisted renderer-independent Chord ribbon color semantics. */
+export declare const ChartChordRibbonColorMode: {
+    readonly Source: "source";
+    readonly Target: "target";
+    readonly Gradient: "gradient";
+};
+export type ChartChordRibbonColorMode = typeof ChartChordRibbonColorMode[keyof typeof ChartChordRibbonColorMode];
+/** Persisted Gauge visual language. Missing historical values resolve to Modern. */
+export declare const ChartGaugeMode: {
+    readonly Modern: "modern";
+    readonly Classic: "classic";
+};
+export type ChartGaugeMode = typeof ChartGaugeMode[keyof typeof ChartGaugeMode];
+/** Persisted renderer-independent Gauge pointer shape. Missing historical values resolve to Needle. */
+export declare const ChartGaugePointerShape: {
+    readonly Needle: "needle";
+    readonly Slim: "slim";
+    readonly Arrow: "arrow";
+};
+export type ChartGaugePointerShape = typeof ChartGaugePointerShape[keyof typeof ChartGaugePointerShape];
+/** Persisted renderer-independent Sunburst label placement. */
+export declare const ChartSunburstLabelPosition: {
+    readonly Inside: "inside";
+    readonly Outside: "outside";
+};
+export type ChartSunburstLabelPosition = typeof ChartSunburstLabelPosition[keyof typeof ChartSunburstLabelPosition];
 export declare enum CategoryType {
     Linear = "Linear",
     Text = "Text",
@@ -116,6 +165,33 @@ export declare enum ChartWaterfallPointRole {
     Change = "change",
     Total = "total"
 }
+/** Candlestick point states used by persisted style keys and render classification. */
+export declare const ChartCandlestickState: {
+    readonly Rising: "rising";
+    readonly Falling: "falling";
+    readonly Doji: "doji";
+};
+export type ChartCandlestickState = typeof ChartCandlestickState[keyof typeof ChartCandlestickState];
+/** Histogram bin sizing modes persisted by the semantic chart model. */
+export declare const HistogramBinningMode: {
+    readonly Count: "count";
+    readonly Width: "width";
+};
+export type HistogramBinningMode = typeof HistogramBinningMode[keyof typeof HistogramBinningMode];
+/** Roles assigned to computed Histogram bins. */
+export declare const ChartHistogramBinKind: {
+    readonly Underflow: "underflow";
+    readonly Regular: "regular";
+    readonly Overflow: "overflow";
+};
+export type ChartHistogramBinKind = typeof ChartHistogramBinKind[keyof typeof ChartHistogramBinKind];
+/** Layout modes for Treemap parent labels. */
+export declare const TreemapParentLabelLayout: {
+    readonly Banner: "banner";
+    readonly Overlapping: "overlapping";
+    readonly None: "none";
+};
+export type TreemapParentLabelLayout = typeof TreemapParentLabelLayout[keyof typeof TreemapParentLabelLayout];
 export declare enum IRuntimeAxisPriority {
     Primary = 1,
     Secondary = 2,

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

@@ -0,0 +1,133 @@
+import type { IChartCandlestickMappingSpec, IChartCandlestickStateStyleSpec } from '@univerjs-pro/engine-chart';
+import { FAxisChartBuilder } from '../f-axis-chart-builder';
+/** Fluent semantic builder for a single OHLC Candlestick series. */
+export declare class FCandlestickChartBuilder extends FAxisChartBuilder {
+    /**
+     * Replaces Open, High, Low, and Close source fields atomically.
+     *
+     * Category remains configured through `setCategoryField()`. Every supplied index must be a
+     * unique non-negative integer. Read the pending or persisted value with
+     * `builder.describe().mapping?.candlestick`.
+     *
+     * @param fields Required semantic OHLC source field indexes.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create()
+     *   .setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setCategoryField(0)
+     *   .setCandlestickFields({ openIndex: 1, highIndex: 2, lowIndex: 3, closeIndex: 4 });
+     * const mapping = builder.describe().mapping?.candlestick;
+     * ```
+     */
+    setCandlestickFields(fields: IChartCandlestickMappingSpec): this;
+    /**
+     * Clears the atomic OHLC mapping while preserving the category field.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create()
+     *   .setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .clearCandlestickFields();
+     * ```
+     */
+    clearCandlestickFields(): this;
+    /**
+     * Sets semantic Rising candle body and wick style overrides.
+     *
+     * @param style Rising body and wick style values, passed through without Facade range validation.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setRisingStyle({ color: '#0DA471', hollow: true });
+     * ```
+     */
+    setRisingStyle(style: IChartCandlestickStateStyleSpec): this;
+    /**
+     * Clears explicit Rising style overrides so runtime defaults apply.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearRisingStyle();
+     * ```
+     */
+    clearRisingStyle(): this;
+    /**
+     * Sets semantic Falling candle body and wick style overrides.
+     *
+     * @param style Falling body and wick style values, passed through without Facade range validation.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setFallingStyle({ color: '#F05252' });
+     * ```
+     */
+    setFallingStyle(style: IChartCandlestickStateStyleSpec): this;
+    /**
+     * Clears explicit Falling style overrides so runtime defaults apply.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearFallingStyle();
+     * ```
+     */
+    clearFallingStyle(): this;
+    /**
+     * Sets semantic Doji body and wick style overrides.
+     *
+     * @param style Doji body and wick style values, passed through without Facade range validation.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setDojiStyle({ color: '#8C8C8C', border: { width: 2 } });
+     * ```
+     */
+    setDojiStyle(style: IChartCandlestickStateStyleSpec): this;
+    /**
+     * Clears explicit Doji style overrides so runtime defaults apply.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearDojiStyle();
+     * ```
+     */
+    clearDojiStyle(): this;
+    /**
+     * Sets a fixed candle width value without Facade range validation.
+     *
+     * @param width Fixed candle width in pixels.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).setCandleWidth(18);
+     * ```
+     */
+    setCandleWidth(width: number): this;
+    /**
+     * Removes the fixed candle width so the renderer chooses it automatically.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).resetCandleWidth();
+     * ```
+     */
+    resetCandleWidth(): this;
+}

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

@@ -0,0 +1,30 @@
+import type { IChartChordEmphasisSpec, IChartChordLabelSpec, IChartChordLayoutSpec, IChartChordMappingSpec, IChartChordNodeStyleSpec, IChartChordRibbonStyleSpec } from '@univerjs-pro/engine-chart';
+import { FChartBuilderBase } from '../f-chart-builder-base';
+/**
+ * Fluent semantic builder for an undirected Source/Target/optional-Value edge list.
+ *
+ * Final display labels own node identity. Duplicate and reverse rows aggregate,
+ * omitted Value means unit-weight counts, and blank endpoints, self-links, and
+ * non-positive/non-finite mapped weights are skipped without coercion. Aggregate
+ * values are formatted after summing. Defaults are renderer-owned and require the
+ * native ECharts 6.1 Chord series; no renderer nodes, links, or layout are persisted.
+ */
+export declare class FChordChartBuilder extends FChartBuilderBase {
+    setChordMapping(value: IChartChordMappingSpec): this;
+    getChordMapping(): IChartChordMappingSpec | undefined;
+    setChordLayout(value: IChartChordLayoutSpec): this;
+    resetChordLayout(): this;
+    getChordLayout(): IChartChordLayoutSpec | undefined;
+    setChordNode(value: IChartChordNodeStyleSpec): this;
+    resetChordNode(): this;
+    getChordNode(): IChartChordNodeStyleSpec | undefined;
+    setChordLabel(value: IChartChordLabelSpec): this;
+    resetChordLabel(): this;
+    getChordLabel(): IChartChordLabelSpec | undefined;
+    setChordRibbon(value: IChartChordRibbonStyleSpec): this;
+    resetChordRibbon(): this;
+    getChordRibbon(): IChartChordRibbonStyleSpec | undefined;
+    setChordEmphasis(value: IChartChordEmphasisSpec): this;
+    resetChordEmphasis(): this;
+    getChordEmphasis(): IChartChordEmphasisSpec | undefined;
+}

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

@@ -0,0 +1,52 @@
+import type { ChartGaugeMode, DeepNullish, IChartGaugeAnchorSpec, IChartGaugeAnglesSpec, IChartGaugeAxisLabelSpec, IChartGaugeAxisLineSpec, IChartGaugeAxisTickSpec, IChartGaugeDetailSpec, IChartGaugePointerSpec, IChartGaugeProgressSpec, IChartGaugeRangeSpec, IChartGaugeScaleSpec, IChartGaugeSplitLineSpec, IChartGaugeTicksPatch, IChartGaugeTitleSpec } from '@univerjs-pro/engine-chart';
+import { FChartBuilderBase } from '../f-chart-builder-base';
+/**
+ * Fluent semantic builder for Google-style label/value Gauge data.
+ *
+ * The category field is the label and exactly one value field is selected. Each
+ * finite numeric observation renders as an independently wrapped gauge; invalid
+ * values are skipped without coercion. Scale defaults to 0–100. Out-of-range raw
+ * values retain their source formatting for detail and tooltip text while only
+ * the rendered indicator is clamped. Angles use degrees, length/offset ratios use
+ * 0–1 units, and range bounds use scale-domain values. All style is chart-wide.
+ * Layout is derived at render time and is never part of this builder's state.
+ *
+ * @example
+ * chart.setType(ChartTypeString.Gauge)
+ *     .setCategoryField(0)
+ *     .setGaugeValueField(1)
+ *     .setGaugeRanges([{ from: 0, to: 60, color: '#dc2626' }]);
+ */
+export declare class FGaugeChartBuilder extends FChartBuilderBase {
+    /** Selects the only value field; labels use `setCategoryField()`. */
+    setGaugeValueField(index: number): this;
+    setGaugeMode(value: ChartGaugeMode): this;
+    resetGaugeMode(): this;
+    setGaugeScale(value: IChartGaugeScaleSpec): this;
+    resetGaugeScale(): this;
+    /** Sets regular major scale divisions and minor divisions per major interval. */
+    setGaugeTicks(value: IChartGaugeTicksPatch): this;
+    setGaugeAngles(value: IChartGaugeAnglesSpec): this;
+    resetGaugeAngles(): this;
+    setGaugeRanges(value: readonly IChartGaugeRangeSpec[]): this;
+    resetGaugeRanges(): this;
+    setGaugeAxisLine(value: IChartGaugeAxisLineSpec): this;
+    resetGaugeAxisLine(): this;
+    setGaugeAxisTick(value: IChartGaugeAxisTickSpec): this;
+    resetGaugeAxisTick(): this;
+    setGaugeSplitLine(value: IChartGaugeSplitLineSpec): this;
+    resetGaugeSplitLine(): this;
+    setGaugeAxisLabel(value: DeepNullish<IChartGaugeAxisLabelSpec>): this;
+    resetGaugeAxisLabel(): this;
+    /** Sets the pointer visibility, dimensions, color, and semantic shape preset. */
+    setGaugePointer(value: IChartGaugePointerSpec): this;
+    resetGaugePointer(): this;
+    setGaugeAnchor(value: IChartGaugeAnchorSpec): this;
+    resetGaugeAnchor(): this;
+    setGaugeProgress(value: IChartGaugeProgressSpec): this;
+    resetGaugeProgress(): this;
+    setGaugeTitle(value: IChartGaugeTitleSpec): this;
+    resetGaugeTitle(): this;
+    setGaugeDetail(value: DeepNullish<IChartGaugeDetailSpec>): this;
+    resetGaugeDetail(): this;
+}

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

@@ -0,0 +1,74 @@
+import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
+/**
+ * Fluent builder for a one-field raw-sample Histogram.
+ *
+ * Histogram settings are persisted as authored. Rendering uses Scott Auto when explicit
+ * binning is ineffective, never emits more than 1000 visible bins, and falls back to a
+ * zero visual gap for ineffective gap values.
+ *
+ * @example
+ * const chart = worksheet.charts.create()
+ *   .setType(univerAPI.Enum.ChartTypeString.Histogram)
+ *   .setHistogramField(0)
+ *   .setBinCount(12)
+ *   .setBinGap(0.1);
+ */
+export declare class FHistogramChartBuilder extends FCartesianChartBuilder {
+    /**
+     * Selects the only active Histogram value field by zero-based source index.
+     * @example `builder.setHistogramField(2)`
+     */
+    setHistogramField(index: number): this;
+    /**
+     * Clears the active Histogram value field.
+     * @example `builder.clearHistogramField()`
+     */
+    clearHistogramField(): this;
+    /**
+     * Stores an explicit total visible-bin count. Integers from 1 through 1000 are effective
+     * when enabled edge bins still leave room for a regular bin. Other finite values remain
+     * persisted and visible through `describe()` but render with Scott Auto. Non-finite calls
+     * produce no Pending change.
+     * @example `builder.setBinCount(20)`
+     */
+    setBinCount(count: number): this;
+    /**
+     * Stores an explicit width. A positive finite width is effective only when the current
+     * range produces at most 1000 visible bins; otherwise rendering uses Scott Auto without
+     * rewriting the stored value. Non-finite calls produce no Pending change.
+     * @example `builder.setBinWidth(2.5)`
+     */
+    setBinWidth(width: number): this;
+    /**
+     * Removes explicit binning and restores runtime-only Scott Auto.
+     * @example `builder.resetBinning()`
+     */
+    resetBinning(): this;
+    /**
+     * Enables the inclusive `x <= threshold` Underflow bin. If both thresholds are present,
+     * they are effective only when Underflow is less than Overflow. Non-finite calls are no-op.
+     * @example `builder.setUnderflowThreshold(0)`
+     */
+    setUnderflowThreshold(value: number): this;
+    /** Disables Underflow. @example `builder.clearUnderflowThreshold()` */
+    clearUnderflowThreshold(): this;
+    /**
+     * Enables the exclusive `x > threshold` Overflow bin. An ineffective finite threshold
+     * pair remains persisted but both thresholds are ignored for rendering. Non-finite calls are no-op.
+     * @example `builder.setOverflowThreshold(100)`
+     */
+    setOverflowThreshold(value: number): this;
+    /** Disables Overflow. @example `builder.clearOverflowThreshold()` */
+    clearOverflowThreshold(): this;
+    /**
+     * Stores the visual gap ratio. Values from 0 through 0.9 are effective; other finite values
+     * remain persisted but render with the 0.007-gap default. Non-finite calls are no-op.
+     * @example `builder.setBinGap(0.15)`
+     */
+    setBinGap(value: number): this;
+    /**
+     * Removes the explicit gap and restores the 0.007 runtime default.
+     * @example `builder.resetBinGap()`
+     */
+    resetBinGap(): this;
+}

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

@@ -1,6 +1,8 @@
-import type { IChartPieLabelSpec, IChartSliceStyleSpec } from '@univerjs-pro/engine-chart';
+import type { DeepNullish, IChartPieCompositeSpec, IChartPieLabelSpec, IChartSliceStyleSpec } from '@univerjs-pro/engine-chart';
 import { FChartBuilderBase } from '../f-chart-builder-base';
 export declare class FPieChartBuilder extends FChartBuilderBase {
+    setPieComposite(value: DeepNullish<IChartPieCompositeSpec>): this;
+    clearPieComposite(): this;
     /**
      * Sets the style for the materialized slice at `index`.
      *
@@ -270,65 +272,6 @@ export declare class FPieChartBuilder extends FChartBuilderBase {
      * ```
      */
     resetValueScale(): this;
-    /**
-     * Sets the value suffix 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.Pie);
-     * builder.setValueSuffix('%');
-     * ```
-     */
-    setValueSuffix(value: string): this;
-    /**
-     * Clears the value suffix so labels append no custom suffix.
-     *
-     * 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.Pie);
-     * builder.clearValueSuffix();
-     * ```
-     */
-    clearValueSuffix(): this;
-    /**
-     * Sets the decimal places 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.Pie);
-     * builder.setDecimalPlaces(2);
-     * ```
-     */
-    setDecimalPlaces(value: number): this;
-    /**
-     * Removes the explicit decimal-precision override. When a value scale or suffix still requires
-     * the custom formatter, that formatter falls back to one decimal place.
-     *
-     * 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.Pie);
-     * builder.resetDecimalPlaces();
-     * ```
-     */
-    resetDecimalPlaces(): this;
     /**
      * Sets the pie label configuration and returns this builder for chaining.
      *
@@ -346,7 +289,7 @@ export declare class FPieChartBuilder extends FChartBuilderBase {
      * builder.setPieLabel({ visible: true, position: univerAPI.Enum.PieLabelPosition.Outside });
      * ```
      */
-    setPieLabel(value: IChartPieLabelSpec): this;
+    setPieLabel(value: DeepNullish<IChartPieLabelSpec>): this;
     /**
      * Clears the pie label override. Labels fall back to visible outside labels containing category,
      * value, and percentage with the active chart font and theme colors.

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

@@ -0,0 +1,24 @@
+import type { DeepNullish, IChartSunburstCenterLabelSpec, IChartSunburstLabelSpec } from '@univerjs-pro/engine-chart';
+import { FChartBuilderBase } from '../f-chart-builder-base';
+/**
+ * Fluent semantic builder for an automatically laid-out Sunburst chart.
+ *
+ * Field indexes are zero-based in the orientation-normalized dataset. Rendering needs at
+ * least one ordered hierarchy field and exactly one value field. Duplicate complete paths
+ * sum finite numeric values; sparse hierarchy values inherit within ancestor scope; parent
+ * facts add to child totals. Ring layout is automatic and root navigation is disabled.
+ */
+export declare class FSunburstChartBuilder extends FChartBuilderBase {
+    /** Replaces the ordered inner-to-outer hierarchy with zero-based field indexes. */
+    setHierarchyFields(indexes: readonly number[]): this;
+    /** Replaces the sole numeric value field with a zero-based field index. */
+    setValueField(index: number): this;
+    /** Sets label visibility, CategoryName/Value content, and font appearance. */
+    setSunburstLabel(label: DeepNullish<IChartSunburstLabelSpec>): this;
+    /** Removes explicit label style and restores visible category-name labels. */
+    resetSunburstLabel(): this;
+    /** Sets visibility, number format, and font appearance for the aggregate center value. */
+    setCenterLabel(centerLabel: DeepNullish<IChartSunburstCenterLabelSpec>): this;
+    /** Removes the authored center-label style and restores its hidden default. */
+    resetCenterLabel(): this;
+}

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

@@ -0,0 +1,34 @@
+import type { DeepNullish, IChartTreemapLabelSpec, TreemapParentLabelLayout } from '@univerjs-pro/engine-chart';
+import { FChartBuilderBase } from '../f-chart-builder-base';
+/**
+ * Fluent semantic builder for an automatically laid-out Treemap.
+ *
+ * Field indexes are zero-based in the orientation-normalized dataset. Rendering needs at
+ * least one ordered hierarchy field and exactly one value field. Duplicate complete paths
+ * sum finite numeric values; blank, textual, non-finite, and final non-positive values do
+ * not render. Parent-owned facts add to child totals. Layout is automatic and navigation
+ * is disabled. The runtime defaults are banner parent labels and visible category-name
+ * leaf labels; labels may hide when their rectangle cannot fit the complete content.
+ *
+ * @example
+ * const chart = worksheet.charts.create()
+ *   .setType(univerAPI.Enum.ChartTypeString.Treemap)
+ *   .setHierarchyFields([0, 1, 2])
+ *   .setValueField(3)
+ *   .setParentLabelLayout('banner')
+ *   .setTreemapLabel({ visible: true, contentType: univerAPI.Enum.LabelContentType.CategoryName });
+ */
+export declare class FTreemapChartBuilder extends FChartBuilderBase {
+    /** Replaces the ordered root-to-leaf hierarchy with zero-based field indexes. */
+    setHierarchyFields(indexes: readonly number[]): this;
+    /** Replaces the sole numeric value field with a zero-based field index. */
+    setValueField(index: number): this;
+    /** Sets parent names to a reserved banner, overlapping text, or hidden. */
+    setParentLabelLayout(layout: TreemapParentLabelLayout): this;
+    /** Removes the explicit parent layout and restores the runtime banner default. */
+    resetParentLabelLayout(): this;
+    /** Sets leaf font and CategoryName/Value content. Other content bits are inert. */
+    setTreemapLabel(label: DeepNullish<IChartTreemapLabelSpec>): this;
+    /** Removes explicit leaf-label style and restores visible category-name labels. */
+    resetTreemapLabel(): this;
+}

package/lib/types/facade/chart-builder-type-map.d.ts

@@ -1,5 +1,24 @@
 import type { ChartTypeString } from '@univerjs-pro/engine-chart';
-import type { FAreaChartBuilder, FBoxplotChartBuilder, FBubbleChartBuilder, FCombinationChartBuilder, FFunnelChartBuilder, FHeatmapChartBuilder, FLineChartBuilder, FParetoChartBuilder, FPieChartBuilder, FRadarChartBuilder, FRelationChartBuilder, FScatterChartBuilder, FWaterfallChartBuilder, FWordCloudChartBuilder } from './builders';
+import type { FAreaChartBuilder } from './builders/f-area-chart-builder';
+import type { FBoxplotChartBuilder } from './builders/f-boxplot-chart-builder';
+import type { FBubbleChartBuilder } from './builders/f-bubble-chart-builder';
+import type { FCandlestickChartBuilder } from './builders/f-candlestick-chart-builder';
+import type { FChordChartBuilder } from './builders/f-chord-chart-builder';
+import type { FCombinationChartBuilder } from './builders/f-combination-chart-builder';
+import type { FFunnelChartBuilder } from './builders/f-funnel-chart-builder';
+import type { FGaugeChartBuilder } from './builders/f-gauge-chart-builder';
+import type { FHeatmapChartBuilder } from './builders/f-heatmap-chart-builder';
+import type { FHistogramChartBuilder } from './builders/f-histogram-chart-builder';
+import type { FLineChartBuilder } from './builders/f-line-chart-builder';
+import type { FParetoChartBuilder } from './builders/f-pareto-chart-builder';
+import type { FPieChartBuilder } from './builders/f-pie-chart-builder';
+import type { FRadarChartBuilder } from './builders/f-radar-chart-builder';
+import type { FRelationChartBuilder } from './builders/f-relation-chart-builder';
+import type { FScatterChartBuilder } from './builders/f-scatter-chart-builder';
+import type { FSunburstChartBuilder } from './builders/f-sunburst-chart-builder';
+import type { FTreemapChartBuilder } from './builders/f-treemap-chart-builder';
+import type { FWaterfallChartBuilder } from './builders/f-waterfall-chart-builder';
+import type { FWordCloudChartBuilder } from './builders/f-word-cloud-chart-builder';
 import type { FCartesianChartBuilder } from './f-cartesian-chart-builder';
 import type { FChartBuilderBase } from './f-chart-builder-base';
 export interface IChartBuilderTypeMap {
@@ -27,4 +46,10 @@ export interface IChartBuilderTypeMap {
     [ChartTypeString.Sankey]: FChartBuilderBase;
     [ChartTypeString.Heatmap]: FHeatmapChartBuilder;
     [ChartTypeString.Boxplot]: FBoxplotChartBuilder;
+    [ChartTypeString.Candlestick]: FCandlestickChartBuilder;
+    [ChartTypeString.Histogram]: FHistogramChartBuilder;
+    [ChartTypeString.Treemap]: FTreemapChartBuilder;
+    [ChartTypeString.Sunburst]: FSunburstChartBuilder;
+    [ChartTypeString.Gauge]: FGaugeChartBuilder;
+    [ChartTypeString.Chord]: FChordChartBuilder;
 }