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

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

@@ -0,0 +1,61 @@
+import { FChartBuilderBase } from '../f-chart-builder-base';
+export declare class FFunnelChartBuilder extends FChartBuilderBase {
+    /**
+     * Sets the gap 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.Funnel);
+     * builder.setGap(8);
+     * ```
+     */
+    setGap(value: number): this;
+    /**
+     * Restores the gap to 2 px 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.Funnel);
+     * builder.resetGap();
+     * ```
+     */
+    resetGap(): this;
+    /**
+     * Sets the use absolute value 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.Funnel);
+     * builder.setUseAbsoluteValue(true);
+     * ```
+     */
+    setUseAbsoluteValue(value: boolean): this;
+    /**
+     * Restores the default of preserving signed values 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.Funnel);
+     * builder.resetUseAbsoluteValue();
+     * ```
+     */
+    resetUseAbsoluteValue(): this;
+}

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

@@ -0,0 +1,124 @@
+import type { ChartVisualMapType, IChartHeatmapLabelSpec } from '@univerjs-pro/engine-chart';
+import { FAxisChartBuilder } from '../f-axis-chart-builder';
+export declare class FHeatmapChartBuilder extends FAxisChartBuilder {
+    /**
+     * Sets the visual map type 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.Heatmap);
+     * builder.setVisualMapType(univerAPI.Enum.ChartVisualMapType.Continuous);
+     * ```
+     */
+    setVisualMapType(value: ChartVisualMapType): this;
+    /**
+     * Restores the visual map type to `Continuous` 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.Heatmap);
+     * builder.resetVisualMapType();
+     * ```
+     */
+    resetVisualMapType(): this;
+    /**
+     * Sets the value range configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param min The minimum value.
+     * @param max The maximum value.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Heatmap);
+     * builder.setValueRange(0, 100);
+     * ```
+     */
+    setValueRange(min: number, max: number): this;
+    /**
+     * Clears the value range 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.Heatmap);
+     * builder.clearValueRange();
+     * ```
+     */
+    clearValueRange(): this;
+    /**
+     * Sets the value label rendered inside each Heatmap cell.
+     *
+     * With `{ visible: true }`, omitted style fields default to the cell value, an inside position,
+     * 12 px text, the chart font (or Arial), and the active theme's mark-text color.
+     *
+     * @param value Cell-label visibility and typography.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.registerTheme('support-demand', { color: ['#eff6ff', '#1d4ed8'] });
+     * const builder = worksheet.charts.create()
+     *   .setType(univerAPI.Enum.ChartTypeString.Heatmap)
+     *   .setTheme('support-demand')
+     *   .setValueRange(0, 80)
+     *   .setValueUnit('tickets')
+     *   .setCellLabel({ visible: true, position: univerAPI.Enum.SeriesLabelPosition.Inside });
+     * ```
+     */
+    setCellLabel(value: IChartHeatmapLabelSpec): this;
+    /**
+     * Clears the explicit Heatmap cell-label style. Heatmap cells render without labels until
+     * labels are enabled again with `setCellLabel({ visible: true })`.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Heatmap);
+     * builder.clearCellLabel();
+     * ```
+     */
+    clearCellLabel(): this;
+    /**
+     * Sets the unit appended to the Heatmap visual-map boundary labels.
+     *
+     * @param value Unit text such as `tickets`.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create()
+     *   .setType(univerAPI.Enum.ChartTypeString.Heatmap)
+     *   .setValueUnit('tickets');
+     * ```
+     */
+    setValueUnit(value: string): this;
+    /**
+     * Clears the explicit Heatmap value unit.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create()
+     *   .setType(univerAPI.Enum.ChartTypeString.Heatmap)
+     *   .clearValueUnit();
+     * ```
+     */
+    clearValueUnit(): this;
+}

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

@@ -0,0 +1,36 @@
+import type { IChartSeriesBorderSpec } from '@univerjs-pro/engine-chart';
+import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
+export declare class FLineChartBuilder extends FCartesianChartBuilder {
+    /**
+     * Sets the line style configuration and returns this builder for chaining.
+     *
+     * Omitted fields keep their current values. Without explicit overrides, lines use a 2 px solid
+     * stroke at full opacity in their active theme color.
+     *
+     * 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.Line);
+     * builder.setLineStyle({ width: 2, color: '#1677ff' });
+     * ```
+     */
+    setLineStyle(value: IChartSeriesBorderSpec): this;
+    /**
+     * Clears the line style override so the line uses a 2 px solid stroke in its active theme color.
+     *
+     * 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.Line);
+     * builder.clearLineStyle();
+     * ```
+     */
+    clearLineStyle(): this;
+}

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

@@ -0,0 +1,112 @@
+import type { IChartParetoBarStyleSpec, IChartParetoLineStyleSpec } from '@univerjs-pro/engine-chart';
+import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
+export declare class FParetoChartBuilder extends FCartesianChartBuilder {
+    /**
+     * Deep-merges supported Pareto bar appearance.
+     *
+     * Omitted fields keep their current values. Without explicit overrides, bars use the active
+     * chart theme palette, full opacity, and renderer-default borders and labels.
+     *
+     * This method executes synchronously.
+     *
+     * Read the current value from `builder.describe().pareto?.barStyle`.
+     *
+     * @param value Supported bar appearance fields.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pareto);
+     * builder.setBarStyle({ color: '#1677ff', opacity: 0.8 });
+     * const barStyle = builder.describe().pareto?.barStyle;
+     * ```
+     */
+    setBarStyle(value: IChartParetoBarStyleSpec): this;
+    /**
+     * Clears the complete Pareto bar style.
+     *
+     * After clearing, bars again use the active chart theme palette, full opacity, and
+     * renderer-default borders and labels.
+     *
+     * 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.Pareto);
+     * builder.clearBarStyle();
+     * const barStyle = builder.describe().pareto?.barStyle;
+     * ```
+     */
+    clearBarStyle(): this;
+    /**
+     * Deep-merges supported Pareto cumulative-line appearance.
+     *
+     * Omitted fields keep their current values. Without explicit overrides, the line uses the
+     * fourth active theme color, a 2 px solid stroke, full opacity, and 7 px points.
+     *
+     * This method executes synchronously.
+     *
+     * Non-positive widths are ignored because the cumulative line remains part of Pareto.
+     * Read the current value from `builder.describe().pareto?.cumulativeLineStyle`.
+     *
+     * @param value Supported cumulative-line appearance fields.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pareto);
+     * builder.setCumulativeLineStyle({ color: '#f5222d', width: 2 });
+     * const lineStyle = builder.describe().pareto?.cumulativeLineStyle;
+     * ```
+     */
+    setCumulativeLineStyle(value: IChartParetoLineStyleSpec): this;
+    /**
+     * Clears the complete Pareto cumulative-line style.
+     *
+     * The cumulative line remains visible and falls back to the fourth active theme color,
+     * a 2 px solid stroke, full opacity, and 7 px 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.Pareto);
+     * builder.clearCumulativeLineStyle();
+     * const lineStyle = builder.describe().pareto?.cumulativeLineStyle;
+     * ```
+     */
+    clearCumulativeLineStyle(): this;
+    /**
+     * Sets the include zero values 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.Pareto);
+     * builder.setIncludeZeroValues(true);
+     * ```
+     */
+    setIncludeZeroValues(value: boolean): this;
+    /**
+     * Restores the default of excluding zero-valued categories 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.Pareto);
+     * builder.resetIncludeZeroValues();
+     * ```
+     */
+    resetIncludeZeroValues(): this;
+}

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

@@ -0,0 +1,324 @@
+import type { IChartPieLabelSpec } from '@univerjs-pro/engine-chart';
+import { FChartBuilderBase } from '../f-chart-builder-base';
+export declare class FPieChartBuilder extends FChartBuilderBase {
+    /**
+     * Sets the doughnut hole 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.setDoughnutHole(0.6);
+     * ```
+     */
+    setDoughnutHole(value: number): this;
+    /**
+     * Clears the doughnut hole override. Doughnut charts fall back to a 50% inner radius; pie charts remain solid.
+     *
+     * 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.clearDoughnutHole();
+     * ```
+     */
+    clearDoughnutHole(): this;
+    /**
+     * Sets the explosion 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.setExplosion(8);
+     * ```
+     */
+    setExplosion(value: number): this;
+    /**
+     * Restores the default of no slice explosion 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.Pie);
+     * builder.resetExplosion();
+     * ```
+     */
+    resetExplosion(): this;
+    /**
+     * Sets the slice border color 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.setSliceBorderColor('#ffffff');
+     * ```
+     */
+    setSliceBorderColor(value: string): this;
+    /**
+     * Clears the slice border override so the renderer uses its theme-aware white base color.
+     *
+     * 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.clearSliceBorderColor();
+     * ```
+     */
+    clearSliceBorderColor(): this;
+    /**
+     * Sets the padding angle enabled 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.setPaddingAngleEnabled(true);
+     * ```
+     */
+    setPaddingAngleEnabled(value: boolean): this;
+    /**
+     * Restores the default of rendering slices without padding angles.
+     *
+     * This method executes synchronously.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pie).resetPaddingAngleEnabled();
+     * ```
+     */
+    resetPaddingAngleEnabled(): this;
+    /**
+     * Sets the half pie 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.setHalfPie(true);
+     * ```
+     */
+    setHalfPie(value: boolean): this;
+    /**
+     * Restores the default full-circle pie layout.
+     *
+     * This method executes synchronously.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pie).resetHalfPie();
+     * ```
+     */
+    resetHalfPie(): this;
+    /**
+     * Sets the rose pie 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.setRosePie(true);
+     * ```
+     */
+    setRosePie(value: boolean): this;
+    /**
+     * Restores the default non-rose pie layout.
+     *
+     * This method executes synchronously.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pie).resetRosePie();
+     * ```
+     */
+    resetRosePie(): this;
+    /**
+     * Sets the label line visible 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.setLabelLineVisible(true);
+     * ```
+     */
+    setLabelLineVisible(value: boolean): this;
+    /**
+     * Removes the label-line visibility override so the renderer determines visibility from the label layout.
+     *
+     * This method executes synchronously.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pie).resetLabelLineVisible();
+     * ```
+     */
+    resetLabelLineVisible(): this;
+    /**
+     * Sets the value scale 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.setValueScale(1);
+     * ```
+     */
+    setValueScale(value: number): this;
+    /**
+     * Restores the value scale to 1 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.Pie);
+     * builder.resetValueScale();
+     * ```
+     */
+    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.
+     *
+     * Omitted fields keep their current values. With no explicit label overrides, labels are visible
+     * outside the pie and contain category, value, and percentage using 12 px active-theme text.
+     *
+     * 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.setPieLabel({ visible: true, position: univerAPI.Enum.PieLabelPosition.Outside });
+     * ```
+     */
+    setPieLabel(value: 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.
+     *
+     * 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.clearPieLabel();
+     * ```
+     */
+    clearPieLabel(): this;
+}