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

package/lib/types/commands/mutations/sheets-chart-update-config.mutation.d.ts

@@ -9,3 +9,4 @@ export interface IChartUpdateConfigMutationParams {
     context?: IChartContext;
 }
 export declare const ChartUpdateConfigMutation: IMutation<IChartUpdateConfigMutationParams>;
+export declare const ChartReplaceConfigMutation: IMutation<IChartUpdateConfigMutationParams>;

package/lib/types/commands/mutations/sheets-chart.mutation.d.ts

@@ -1,16 +1,26 @@
 import type { ChartTypeBits, IChartSnapshot } from '@univerjs-pro/engine-chart';
 import type { IMutation, IRange } from '@univerjs/core';
 import type { ISheetCommandSharedParams } from '@univerjs/sheets';
-export interface IInsertSheetsChartMutationParams extends ISheetCommandSharedParams, Omit<IChartSnapshot, 'id' | 'chartType' | 'orient'> {
-    range: IRange;
-    rangeUnitId?: string;
-    rangeSubUnitId?: string;
+import type { IChartSourceMultiRangeItem, ISheetChartSourceRanges } from '../../models/types';
+type IInsertSheetsChartMutationCommonParams = ISheetCommandSharedParams & Omit<IChartSnapshot, 'id' | 'chartType' | 'orient'> & {
     chartId: string;
     chartType: ChartTypeBits;
+};
+/** Persisted source shape for insert-chart changesets. Keep `range` / `ranges` stable for replay compatibility. */
+export type IInsertSheetsChartMutationSource = {
+    range: IRange;
+    rangeUnitId: string;
+    rangeSubUnitId: string;
     isRowDirection?: boolean;
-}
+} | {
+    ranges: IChartSourceMultiRangeItem[];
+};
+export type IInsertSheetsChartMutationParams = IInsertSheetsChartMutationCommonParams & IInsertSheetsChartMutationSource;
+/** Converts the internal chart source into the stable mutation shape without persisting `rangeInfo`. */
+export declare function toInsertChartMutationSource(source: ISheetChartSourceRanges): IInsertSheetsChartMutationSource;
 export interface IRemoveSheetsChartMutationParams extends ISheetCommandSharedParams {
     chartId: string;
 }
 export declare const InsertSheetsChartMutation: IMutation<IInsertSheetsChartMutationParams>;
 export declare const RemoveSheetsChartMutation: IMutation<IRemoveSheetsChartMutationParams>;
+export {};

package/lib/types/common/util.d.ts

@@ -2,7 +2,7 @@ import type { IAccessor } from '@univerjs/core';
 export declare const BUILD_TIMESTAMP: number;
 export declare const DefaultLimitedTypes: string[];
 export declare const DefaultAllTypes: string[];
-export declare const DefaultInValidTypes: never[];
+export declare const DefaultInValidTypes: string[];
 export declare const setProperty: (data: Record<string, any>, propertyPath: string, value: any) => void;
 /**
  * Set graphic element to data.

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

@@ -0,0 +1,83 @@
+import type { FChartBuilderBase, HostAnyChartBuilder, HostComposedChartBuilder, IChartBuilderTypeMap } from '@univerjs-pro/engine-chart/facade';
+import type { ChartAnchorSpec, ChartSourceSpec } from '@univerjs-pro/sheets-chart';
+export interface ISheetChartMethods {
+    /**
+     * Sets the source configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param source The host-owned chart source.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create();
+     * builder.setSource('A1:B8');
+     * ```
+     */
+    setSource(source: ChartSourceSpec): ISheetChartMethods;
+    /**
+     * Returns the current source value.
+     *
+     * This method executes synchronously.
+     *
+     * @returns The current host-owned chart source, or `undefined` when no source has been set.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create();
+     * builder.getSource();
+     * ```
+     */
+    getSource(): Readonly<ChartSourceSpec> | undefined;
+    /**
+     * Sets the position configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param anchor The document or cell anchor.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create();
+     * builder.setPosition('D2');
+     * ```
+     */
+    setPosition(anchor: ChartAnchorSpec): ISheetChartMethods;
+    /**
+     * Sets the absolute position configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param x The horizontal position.
+     * @param y The vertical position.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create();
+     * builder.setAbsolutePosition(80, 80);
+     * ```
+     */
+    setAbsolutePosition(x: number, y: number): ISheetChartMethods;
+    /**
+     * Sets the size configuration and returns this builder for chaining.
+     *
+     * This method executes synchronously.
+     *
+     * @param width The width.
+     * @param height The height.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create();
+     * builder.setSize(640, 360);
+     * ```
+     */
+    setSize(width: number, height: number): ISheetChartMethods;
+}
+export type FSheetChartBuilder<TBuilder extends FChartBuilderBase = FChartBuilderBase> = HostComposedChartBuilder<TBuilder, ISheetChartMethods>;
+export type FSheetChartBuilderOf<T extends keyof IChartBuilderTypeMap> = FSheetChartBuilder<IChartBuilderTypeMap[T]>;
+export type FSheetAnyChartBuilder = HostAnyChartBuilder<ISheetChartMethods>;

package/lib/types/facade/chart/f-sheet-charts.d.ts

@@ -0,0 +1,100 @@
+import type { IEchartTheme } from '@univerjs-pro/engine-chart';
+import type { IChartBuilderHostTypes } from '@univerjs-pro/engine-chart/facade';
+import type { FWorksheet } from '@univerjs/sheets/facade';
+import type { FSheetAnyChartBuilder, FSheetChartBuilder } from './f-sheet-chart-builder';
+import { FChartsBase } from '@univerjs-pro/engine-chart/facade';
+interface ISheetChartBuilderTypes extends IChartBuilderHostTypes {
+    Initial: FSheetChartBuilder;
+    Any: FSheetAnyChartBuilder;
+}
+export declare class FSheetCharts extends FChartsBase<ISheetChartBuilderTypes> {
+    private readonly _worksheet;
+    private readonly _commands;
+    constructor(_worksheet: FWorksheet);
+    /**
+     * Creates a detached chart builder without mutating the host.
+     *
+     * This method executes synchronously.
+     *
+     * @returns A detached chart builder.
+     * @example
+     * ```ts
+     * const charts = univerAPI.getActiveWorkbook().getActiveSheet().charts;
+     * charts.create();
+     * ```
+     */
+    create(): FSheetChartBuilder;
+    /**
+     * Inserts a detached chart builder into this host.
+     *
+     * This method completes asynchronously.
+     *
+     * @param builder The detached chart builder to insert.
+     * @returns A promise that resolves to the inserted chart builder.
+     * @example
+     * ```ts
+     * const charts = univerAPI.getActiveWorkbook().getActiveSheet().charts;
+     * const builder = charts.create().setSource('A1:B8');
+     * await charts.insert(builder);
+     * ```
+     */
+    insert<T extends FSheetAnyChartBuilder>(builder: T): Promise<T>;
+    /**
+     * Returns a chart builder by its host-owned ID.
+     *
+     * This method executes synchronously.
+     *
+     * @param chartId The host-owned chart ID.
+     * @returns The matching chart builder, or null when absent.
+     * @example
+     * ```ts
+     * const charts = univerAPI.getActiveWorkbook().getActiveSheet().charts;
+     * charts.get('chart-id');
+     * ```
+     */
+    get(chartId: string): FSheetAnyChartBuilder | null;
+    /**
+     * Returns every chart builder owned by this host.
+     *
+     * This method executes synchronously.
+     *
+     * @returns All chart builders owned by this host.
+     * @example
+     * ```ts
+     * const charts = univerAPI.getActiveWorkbook().getActiveSheet().charts;
+     * charts.list();
+     * ```
+     */
+    list(): FSheetAnyChartBuilder[];
+    /**
+     * Removes a chart from this host.
+     *
+     * This method completes asynchronously.
+     *
+     * @param builderOrId A builder from this host or its chart ID.
+     * @returns A promise that resolves to `true` when the chart is removed, or `false` when it is absent.
+     * @example
+     * ```ts
+     * const charts = univerAPI.getActiveWorkbook().getActiveSheet().charts;
+     * await charts.remove('chart-id');
+     * ```
+     */
+    remove(builderOrId: FSheetAnyChartBuilder | string): Promise<boolean>;
+    /**
+     * Registers a chart theme shared by every chart host in this Univer runtime.
+     *
+     * This method executes synchronously.
+     *
+     * @param name The stable registered name.
+     * @param theme The ECharts theme definition.
+     * Returns no value.
+     * @example
+     * ```ts
+     * const charts = univerAPI.getActiveWorkbook().getActiveSheet().charts;
+     * charts.registerTheme('brand', { color: ['#1677ff'] });
+     * ```
+     */
+    registerTheme(name: string, theme: IEchartTheme): void;
+    private _wrap;
+}
+export {};

package/lib/types/facade/chart/index.d.ts

@@ -0,0 +1,2 @@
+export type { FSheetAnyChartBuilder, FSheetChartBuilder, FSheetChartBuilderOf, ISheetChartMethods } from './f-sheet-chart-builder';
+export { FSheetCharts } from './f-sheet-charts';

package/lib/types/facade/chart/sheet-chart-command-adapter.d.ts

@@ -0,0 +1,13 @@
+import type { IChartCreateSpec } from '@univerjs-pro/sheets-chart';
+import type { FWorksheet } from '@univerjs/sheets/facade';
+import { FChart } from '../f-chart';
+/** Owns the Sheet collection-to-command boundary. It is not part of the public facade. */
+export declare class SheetChartCommandAdapter {
+    private readonly _worksheet;
+    constructor(_worksheet: FWorksheet);
+    create(spec: IChartCreateSpec): Promise<FChart>;
+    get(chartId: string): FChart | null;
+    list(): FChart[];
+    remove(chartOrId: FChart | string): Promise<boolean>;
+    private _sourceContext;
+}

package/lib/types/facade/f-chart.d.ts

@@ -1,143 +1 @@
-import type { IChartDataCategory, IChartDataSeries } from '@univerjs-pro/engine-chart';
-import type { ISheetChartSourceSingleRange } from '@univerjs-pro/sheets-chart';
-import type { Injector } from '@univerjs/core';
-import type { ChartDescription, ChartInstanceCapabilities, ChartKnownTypeName, ChartLayoutPatch, ChartSourceSpec, ChartUpdatePatch, ChartUpdateResult, ChartValidationResult } from './chart-facade-types';
-import { FChartBuilderBase } from './chart-builder/chart-builder-base';
-import { ChartUpdateBuilder } from './chart-facade-builders';
-/**
- * The facade class for the chart.
- * @hideconstructor
- */
-export declare class FChart {
-    /**
-     * @ignore
-     */
-    unitId: string;
-    /**
-     * @ignore
-     */
-    subUnitId: string;
-    /**
-     * @ignore
-     */
-    chartId: string;
-    private _injector;
-    constructor(unitId: string, subUnitId: string, chartId: string, injector: Injector);
-    /**
-     * Get the chart id.
-     * @returns {string} The chart id.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     * const charts = fWorksheet.getCharts();
-     * console.log(charts[0]?.getChartId());
-     * ```
-     */
-    getChartId(): string;
-    /**
-     * Get the range of the chart.
-     * @returns {ISheetChartSourceSingleRange|undefined} The range of the chart.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     * const charts = fWorksheet.getCharts();
-     * console.log(charts[0]?.getRange());
-     * ```
-     */
-    getRange(): ISheetChartSourceSingleRange | undefined;
-    /**
-     * Update the range info of the chart. The range info includes the range of the chart and the direction in source.
-     * @param {ISheetChartSourceSingleRange} rangeInfo The new range of the chart.
-     * @param {IRange} rangeInfo.range.range The new range of the chart.
-     * @param {string} rangeInfo.range.subUnitId The new sheet id of the chart.
-     * @param {string} rangeInfo.range.unitId The new workbook id of the chart.
-     * @param {boolean} [rangeInfo.isRowDirection] Is treat row as category.
-     * @returns {Promise<boolean>} Whether the update is successful.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Get all charts on the active sheet.
-     * const charts = fWorksheet.getCharts();
-     *
-     * // Switch chart row direction
-     * if (charts.length > 0){
-     *   const rangeInfo = { ...charts[0].getRange() };
-     *   rangeInfo.isRowDirection = !rangeInfo.isRowDirection;
-     *   charts[0].updateRange(rangeInfo);
-     * }
-     * ```
-     */
-    updateRange(rangeInfo: ISheetChartSourceSingleRange): Promise<boolean>;
-    /**
-     * Get the series data list of the chart.
-     * @typedef ChartSeriesData
-     * @property {string} name The name of the series.
-     * @property {number} index The index of the series.
-     * @property {ChartSeriesItem[]} items The data of the series.
-     * @property {number} items.value The value of the series.
-     * @property {string} items.label The label of the series.
-     * @returns {IChartDataSeries[]|undefined} The series data list of the chart.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     * const charts = fWorksheet.getCharts();
-     * if (charts.length > 0){
-     *   const seriesData = charts[0].getSeriesData();
-     *   console.log(seriesData);
-     * }
-     * ```
-     */
-    getSeriesData(): IChartDataSeries[] | undefined;
-    /**
-     * Get the category data of the chart.
-     * @type ChartCategoryData
-     * @property {string} name The name of the category.
-     * @property {number} index The index of the category.
-     * @property {CategoryType} type The type of the category.
-     * @property {string[]} keys The keys of the category.
-     * @property {IChartDataItem[]} items The data of the category.
-     * @property {number} items.value The value of the category.
-     * @property {string} items.label The label of the category.
-     * @returns The category data of the chart.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     * const charts = fWorksheet.getCharts();
-     * if (charts.length > 0){
-     *   const categoryData = charts[0].getCategoryData();
-     *   console.log(categoryData);
-     * }
-     * ```
-     */
-    getCategoryData(): IChartDataCategory | undefined;
-    /**
-     * Returns a new FChartBuilderBase instance that modifies this chart.
-     * @returns {FChartBuilderBase} The new FChartBuilderBase instance.
-     */
-    modify(): FChartBuilderBase;
-    describe(): ChartDescription | null;
-    getCapabilities(): ChartInstanceCapabilities | null;
-    validateUpdate(patch: ChartUpdatePatch): ChartValidationResult<ChartUpdatePatch>;
-    newUpdateBuilder(): ChartUpdateBuilder;
-    update(patch: ChartUpdatePatch): Promise<ChartUpdateResult>;
-    setSource(source: ChartSourceSpec): Promise<ChartUpdateResult>;
-    setType(type: ChartKnownTypeName): Promise<ChartUpdateResult>;
-    setLayout(layout: ChartLayoutPatch): Promise<ChartUpdateResult>;
-    remove(): Promise<boolean>;
-}
+export {};

package/lib/types/facade/f-enum.d.ts

@@ -1,210 +1,12 @@
-import { AxisAlignEnum, ChartBorderDashType, ChartTypeBits, LegendPositionEnum, LinePointShape, RadarShape, SelectModeEnum, TitlePositionEnum } from '@univerjs-pro/engine-chart';
-/**
- * @ignore
- */
+import { ChartSourceOrientation } from '@univerjs-pro/sheets-chart';
+import { FEnum } from '@univerjs/core/facade';
+/** @ignore */
 export interface IFSheetsChartEnumMixin {
-    /**
-     * Represents the type of the chart. {@link ChartTypeBits}
-     * @description This enum is used to specify the type of the chart. Which is binary-like value, each bit represents a type of the chart.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a column chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * const chartInfo = fWorksheet.newChart()
-     *   .setChartType(univerAPI.Enum.ChartType.Column)
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    ChartType: typeof ChartTypeBits;
-    /**
-     * Represents the position of the legend in the chart. {@link LegendPositionEnum}
-     * The possible values are: BOTTOM, TOP, LEFT, RIGHT, HIDE.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a line chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * // The legend is positioned at the top of the chart.
-     * const chartInfo = fWorksheet.newChart()
-     *   .asLineChart()
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .setOptions('legend.position', univerAPI.Enum.LegendPositionEnum.Top)
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    LegendPositionEnum: typeof LegendPositionEnum;
-    /**
-     * Represents the selection mode of the chart. {@link SelectModeEnum}
-     * The possible values are: SINGLE, MULTIPLE, Close. It used to specify the selection mode of the chart legend.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a line chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * // The legend is in single selection mode.
-     * const chartInfo = fWorksheet.newChart()
-     *   .asLineChart()
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .setOptions('legend.selectMode', univerAPI.Enum.SelectModeEnum.Single)
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    SelectModeEnum: typeof SelectModeEnum;
-    /**
-     * Represents the alignment of the axis. {@link AxisAlignEnum}
-     * The possible values are: START, CENTER, END.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a line chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * // The x-axis title is set to 'X Axis Title' with red font color and aligned to the end of the axis.
-     * const chartInfo = fWorksheet.newChart()
-     *   .asLineChart()
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .setOptions('', {
-     *     xAxisTitle: {
-     *       content: 'X Axis Title',
-     *       fontColor: '#ff0000',
-     *       axisAlignment: univerAPI.Enum.AxisAlignEnum.End,
-     *     }
-     *   })
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    AxisAlignEnum: typeof AxisAlignEnum;
-    /**
-     * Represents the type of the border dash. {@link ChartBorderDashType}
-     * The possible values are: SOLID, DOTTED, DASHED.
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a line chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * // The axis pointer style is set.
-     * const chartInfo = fWorksheet.newChart()
-     *   .asLineChart()
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .setAxisPointerStyle({
-     *     indicatorLabelColor: '#ff0000',
-     *     indicatorLineType: univerAPI.Enum.ChartBorderDashType.Solid,
-     *     indicatorLineColor: '#00ff00',
-     *     indicatorLabelTextColor: '#0000ff',
-     *   })
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    ChartBorderDashType: typeof ChartBorderDashType;
-    /**
-     * Represents the shape of the data point in the line chart. {@link LinePointShape}
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a line chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * // The data point shape is set to circle, color is red, and size is 10.
-     * const chartInfo = fWorksheet.newChart()
-     *   .asLineChart()
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .setDataPointShape(univerAPI.Enum.LinePointShape.CIRCLE)
-     *   .setDataPointColor('#ff0000')
-     *   .setDataPointSize(10)
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    LinePointShape: typeof LinePointShape;
-    /**
-     * Represents the position of the title in the chart. {@link TitlePositionEnum}
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a line chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * // The title is positioned at the top of the chart.
-     * const chartInfo = fWorksheet.newChart()
-     *   .asLineChart()
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .setOptions('', {
-     *     title: {
-     *       content: 'Chart Title',
-     *       position: univerAPI.Enum.TitlePositionEnum.TOP,
-     *     },
-     *   })
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    TitlePositionEnum: typeof TitlePositionEnum;
-    /**
-     * Represents the shape of the radar chart. {@link RadarShape}
-     *
-     * @example
-     * ```ts
-     * const fWorkbook = univerAPI.getActiveWorkbook();
-     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
-     * if (!fWorksheet) return;
-     *
-     * // Create a radar chart with data source A1:D6.
-     * // The starting position is upper-left corner of cell B2.
-     * // The shape of the radar chart is set to polygon and filled with red color.
-     * const chartInfo = fWorksheet.newChart()
-     *   .asRadarChart()
-     *   .addRange('A1:D6')
-     *   .setPosition(1, 1, 0, 0)
-     *   .setShape(univerAPI.Enum.RadarShape.Polygon)
-     *   .setFill(true)
-     *   .build();
-     * await fWorksheet.insertChart(chartInfo);
-     * ```
-     */
-    RadarShape: typeof RadarShape;
+    ChartSourceOrientation: typeof ChartSourceOrientation;
+}
+export declare class FSheetsChartEnumMixin extends FEnum implements IFSheetsChartEnumMixin {
+    get ChartSourceOrientation(): typeof ChartSourceOrientation;
 }
-/**
- * @ignore
- */
 declare module '@univerjs/core/facade' {
     interface FEnum extends IFSheetsChartEnumMixin {
     }

package/lib/types/facade/f-worksheet-charts.d.ts

@@ -1,26 +1,10 @@
-import type { ChartCapabilities, ChartCreateSpec, ChartSourceSpec, ChartSuggestion, ChartUpdatePatch, ChartUpdateResult, ChartValidationResult } from './chart-facade-types';
 import { FWorksheet } from '@univerjs/sheets/facade';
-import { ChartCreateBuilder } from './chart-facade-builders';
-import { FChart } from './f-chart';
-export declare class FWorksheetCharts {
-    private readonly _worksheet;
-    constructor(_worksheet: FWorksheet);
-    create(spec: ChartCreateSpec): Promise<FChart>;
-    update(chart: FChart | string, patch: ChartUpdatePatch): Promise<ChartUpdateResult>;
-    remove(chart: FChart | string): Promise<boolean>;
-    list(): FChart[];
-    get(chartId: string): FChart | null;
-    validateCreate(spec: ChartCreateSpec): ChartValidationResult<ChartCreateSpec>;
-    getCapabilities(): ChartCapabilities;
-    newBuilder(): ChartCreateBuilder;
-    suggest(source: ChartSourceSpec): ChartSuggestion[];
-    private _sourceContext;
-}
+import { FSheetCharts } from './chart/f-sheet-charts';
 export interface IFWorksheetChartsMixin {
-    readonly charts: FWorksheetCharts;
+    readonly charts: FSheetCharts;
 }
 export declare class FWorksheetChartsMixin extends FWorksheet implements IFWorksheetChartsMixin {
-    get charts(): FWorksheetCharts;
+    get charts(): FSheetCharts;
 }
 declare module '@univerjs/sheets/facade' {
     interface FWorksheet extends IFWorksheetChartsMixin {

package/lib/types/facade/index.d.ts

@@ -1,25 +1,5 @@
-import type { ILineChartBuilderMixin, IPieChartBuilderInfo, IPieChartBuilderMixin, IRadarChartBuilderMixin } from './chart-builder/types';
-import './f-worksheet';
 import './f-worksheet-charts';
 import './f-enum';
-export { FChartBuilderBase } from './chart-builder/chart-builder-base';
-export type * from './chart-builder/chart-builder-base';
-export { LineChartBuilder } from './chart-builder/line-chart-builder';
-export { PieChartBuilder } from './chart-builder/pie-chart-builder';
-export { RadarChartBuilder } from './chart-builder/radar-chart-builder';
-export { ChartFacadeError } from './chart-facade-adapter';
-export { ChartCreateBuilder, ChartUpdateBuilder } from './chart-facade-builders';
-export type * from './chart-facade-types';
-export { FChart } from './f-chart';
-export type * from './f-chart';
-export type * from './f-worksheet';
-export { FWorksheetCharts } from './f-worksheet-charts';
-/**
- * @ignore
- */
-declare module '@univerjs-pro/sheets-chart/facade' {
-    interface FChartBuilderBase extends IPieChartBuilderMixin, IRadarChartBuilderMixin, ILineChartBuilderMixin {
-    }
-    interface IChartBuildOptions extends IPieChartBuilderInfo {
-    }
-}
+export type { FSheetAnyChartBuilder, FSheetChartBuilder, FSheetChartBuilderOf, ISheetChartMethods } from './chart';
+export { FSheetCharts } from './chart';
+export { ChartSourceOrientation } from '@univerjs-pro/sheets-chart';