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

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,166 +1 @@
-import type { ChartKnownTypeName, IChartDataCategory, IChartDataSeries } from '@univerjs-pro/engine-chart';
-import type { ISheetChartSourceSingleRange } from '@univerjs-pro/sheets-chart';
-import type { Injector } from '@univerjs/core';
-import type { ChartDescription, ChartExportImageOptions, ChartExportImageResult, ChartInstanceCapabilities, ChartLayoutPatch, ChartSourceSpec, ChartUpdatePatch, ChartUpdateResult, ChartValidationResult } from './chart-facade-types';
-import { FBaseChart } from '@univerjs-pro/engine-chart';
-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 extends FBaseChart<ChartDescription, ChartUpdateResult> {
-    /**
-     * @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;
-    getId(): 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.
-     * @see {@link update} for structured semantic patches and diagnostics.
-     */
-    modify(): FChartBuilderBase;
-    /**
-     * Returns a frozen semantic snapshot of this chart, or null if it no longer exists.
-     * `rawStyle` is read-only debug information and is not accepted as update input.
-     */
-    describe(): ChartDescription | null;
-    /** Returns verified patch groups for this chart's concrete type. */
-    getCapabilities(): ChartInstanceCapabilities | null;
-    /**
-     * Renders this chart through the shared engine-chart image export Seam.
-     * Returns data URL metadata, or null when the chart/drawing input is unavailable.
-     * The promise rejects when no render model is registered or rendering fails.
-     */
-    exportImage(options?: ChartExportImageOptions): Promise<ChartExportImageResult | null>;
-    /** Validates and normalizes a semantic patch without executing commands. */
-    validateUpdate(patch: ChartUpdatePatch): ChartValidationResult<ChartUpdatePatch>;
-    /** Returns a convenience adapter that builds the same JSON patch accepted by `update()`. */
-    newUpdateBuilder(): ChartUpdateBuilder;
-    /**
-     * Applies a semantic merge patch.
-     *
-     * Omitted/undefined fields are unchanged; null clears fields that explicitly
-     * support clearing. The result contains diagnostics and changed groups rather
-     * than throwing for validation or command failures.
-     */
-    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,91 +1,10 @@
-import type { ChartCapabilities, ChartCreateSpec, ChartSourceSpec, ChartSuggestion, ChartUpdatePatch, ChartUpdateResult, ChartValidationResult } from './chart-facade-types';
-import { FBaseCharts } from '@univerjs-pro/engine-chart';
 import { FWorksheet } from '@univerjs/sheets/facade';
-import { ChartCreateBuilder } from './chart-facade-builders';
-import { FChart } from './f-chart';
-/**
- * Structured chart authoring for a worksheet.
- *
- * JSON create/update specs are the canonical Interface. Builders returned by
- * `newBuilder()` compile to the same specs and are optional convenience adapters.
- */
-export declare class FWorksheetCharts extends FBaseCharts<FChart, ChartCreateSpec, ChartCapabilities> {
-    private readonly _worksheet;
-    constructor(_worksheet: FWorksheet);
-    /**
-     * Creates a chart from a serializable semantic spec.
-     *
-     * Call `validateCreate()` for a side-effect-free preflight. Validation or
-     * command failure throws `ChartFacadeError`, whose `diagnostics` explain the
-     * rejected fields.
-     */
-    create(spec: ChartCreateSpec): Promise<FChart>;
-    /** Applies a semantic merge patch and returns diagnostics plus changed groups. */
-    update(chart: FChart | string, patch: ChartUpdatePatch): Promise<ChartUpdateResult>;
-    remove(chart: FChart | string): Promise<boolean>;
-    /** Returns chart handles owned by this worksheet. */
-    list(): FChart[];
-    /** Returns the worksheet chart with `chartId`, or null when it is absent. */
-    get(chartId: string): FChart | null;
-    /** Validates and normalizes a create spec without executing commands. */
-    validateCreate(spec: ChartCreateSpec): ChartValidationResult<ChartCreateSpec>;
-    /** Describes runtime chart types, patch semantics, and available groups. */
-    getCapabilities(): ChartCapabilities;
-    /** Returns a convenience adapter that builds the same JSON spec accepted by `create()`. */
-    newBuilder(): ChartCreateBuilder;
-    suggest(source: ChartSourceSpec): ChartSuggestion[];
-    private _sourceContext;
-}
+import { FSheetCharts } from './chart/f-sheet-charts';
 export interface IFWorksheetChartsMixin {
-    /**
-     * Structured chart authoring, inspection, repair, and image export.
-     *
-     * @example
-     * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * if (!worksheet) return;
-     *
-     * const chart = await worksheet.charts.create({
-     *   type: 'pareto',
-     *   source: 'A1:B8',
-     *   pareto: {
-     *     barColor: '#1677ff',
-     *     cumulativeLineColor: '#f5222d',
-     *   },
-     * });
-     * const before = chart.describe();
-     * const result = await chart.update({
-     *   pareto: { cumulativeLineColor: '#722ed1' },
-     * });
-     * if (!result.ok) console.log(result.diagnostics);
-     * const after = chart.describe();
-     * const image = await chart.exportImage({ pixelRatio: 2 });
-     * console.log({ before, after, image });
-     * ```
-     */
-    readonly charts: FWorksheetCharts;
+    readonly charts: FSheetCharts;
 }
 export declare class FWorksheetChartsMixin extends FWorksheet implements IFWorksheetChartsMixin {
-    /**
-     * Structured chart authoring, inspection, repair, capabilities, and image export.
-     * Prefer serializable create/update specs; use `describe()` before repairing an
-     * existing chart and inspect update diagnostics before reading it back.
-     *
-     * @example
-     * ```ts
-     * const chart = await worksheet.charts.create({
-     *   type: 'pareto',
-     *   source: 'A1:B8',
-     *   pareto: { barColor: '#1677ff', cumulativeLineColor: '#f5222d' },
-     * });
-     * const before = chart.describe();
-     * const result = await chart.update({ pareto: { barColor: '#722ed1' } });
-     * if (!result.ok) console.log(result.diagnostics);
-     * const after = chart.describe();
-     * const image = await chart.exportImage({ pixelRatio: 2 });
-     * ```
-     */
-    get charts(): FWorksheetCharts;
+    get charts(): FSheetCharts;
 }
 declare module '@univerjs/sheets/facade' {
     interface FWorksheet extends IFWorksheetChartsMixin {