@univerjs-pro/engine-chart 1.0.4 → 1.1.0

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

@@ -19,6 +19,59 @@ export declare function resolveChartDescriptionMetadata(description: IChartDescr
 export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pending: ChartPendingConfig, dataSet: IUniverDataSet): {
     chartType: ChartTypeBits;
     style: {
+        threeD?: {
+            view?: {
+                rotX?: number | undefined;
+                rotY?: number | undefined;
+                rightAngleAxes?: boolean | undefined;
+                perspective?: number | undefined;
+                heightPercent?: number | undefined;
+                depthPercent?: number | undefined;
+            } | undefined;
+            grouping?: "standard" | "clustered" | undefined;
+            gapDepth?: number | undefined;
+        } | undefined;
+        depthAxis?: {
+            label?: {
+                eastAsiaFontFamily?: string | undefined;
+                bold?: boolean | undefined;
+                italic?: boolean | undefined;
+                fontSize?: number | undefined;
+                color?: string | undefined;
+                visible?: boolean | undefined;
+                rotate?: number | undefined;
+                family?: string | undefined;
+                backgroundColor?: (ChartColor | import("../../types").IChartLabelPattern) | undefined;
+                strikethrough?: boolean | undefined;
+                underline?: boolean | undefined;
+                padAngle?: boolean | undefined;
+                axisTitleAlign?: import("../..").AxisAlignEnum | undefined;
+                showMaxLabel?: boolean | undefined;
+                showMinLabel?: boolean | undefined;
+                autoRotate?: boolean | undefined;
+            } | undefined;
+            reverse?: boolean | undefined;
+            tick?: {
+                visible?: boolean | undefined;
+                lineWidth?: number | undefined;
+                lineColor?: string | undefined;
+                length?: number | undefined;
+                position?: import("../..").PieLabelPosition | undefined;
+            } | undefined;
+            gridLine?: {
+                visible?: boolean | undefined;
+                color?: string | undefined;
+                width?: number | undefined;
+                dashType?: import("../..").ChartBorderDashType | undefined;
+            } | undefined;
+            lineVisible?: boolean | undefined;
+            lineStyle?: {
+                visible?: boolean | undefined;
+                color?: string | undefined;
+                width?: number | undefined;
+                dashType?: import("../..").ChartBorderDashType | undefined;
+            } | undefined;
+        } | undefined;
         width?: number | undefined;
         height?: number | undefined;
         theme?: string | undefined;
@@ -41,6 +94,29 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
         } | undefined;
         automaticLayout?: "powerpoint" | undefined;
         titles?: {
+            depthAxisTitle?: {
+                manualLayout?: {
+                    left?: number | undefined;
+                    top?: number | undefined;
+                } | undefined;
+                eastAsiaFontFamily?: string | undefined;
+                bold?: boolean | undefined;
+                italic?: boolean | undefined;
+                fontSize?: number | undefined;
+                color?: string | undefined;
+                rotate?: number | undefined;
+                family?: string | undefined;
+                backgroundColor?: (ChartColor | import("../../types").IChartLabelPattern) | undefined;
+                content?: string | undefined;
+                align?: import("../..").LabelAlignEnum | undefined;
+                strikethrough?: boolean | undefined;
+                underline?: boolean | undefined;
+                padAngle?: boolean | undefined;
+                axisTitleAlign?: import("../..").AxisAlignEnum | undefined;
+                showMaxLabel?: boolean | undefined;
+                showMinLabel?: boolean | undefined;
+                autoRotate?: boolean | undefined;
+            } | undefined;
             title?: {
                 manualLayout?: {
                     left?: number | undefined;
@@ -190,6 +266,8 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
             } | undefined;
         } | undefined;
         xAxis?: {
+            scaleType?: "linear" | "log" | undefined;
+            logBase?: number | undefined;
             visible?: boolean | undefined;
             crossing?: "autoZero" | "min" | "max" | number | undefined;
             tickLabelPosition?: "nextTo" | "low" | "high" | "none" | undefined;
@@ -241,6 +319,8 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
             format?: string | undefined;
         } | undefined;
         yAxis?: {
+            scaleType?: "linear" | "log" | undefined;
+            logBase?: number | undefined;
             visible?: boolean | undefined;
             crossing?: "autoZero" | "min" | "max" | number | undefined;
             tickLabelPosition?: "nextTo" | "low" | "high" | "none" | undefined;
@@ -312,7 +392,10 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
             } | undefined;
             min?: number | null | undefined;
             visible?: boolean | undefined;
+            scaleType?: "linear" | "log" | undefined;
+            logBase?: number | undefined;
             max?: number | null | undefined;
+            format?: string | undefined;
             tick?: {
                 visible?: boolean | undefined;
                 lineWidth?: number | undefined;
@@ -320,15 +403,12 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                 length?: number | undefined;
                 position?: import("../..").PieLabelPosition | undefined;
             } | undefined;
-            format?: string | undefined;
             gridLine?: {
                 visible?: boolean | undefined;
                 color?: string | undefined;
                 width?: number | undefined;
                 dashType?: import("../..").ChartBorderDashType | undefined;
             } | undefined;
-            crossing?: "autoZero" | "min" | "max" | number | undefined;
-            tickLabelPosition?: "nextTo" | "low" | "high" | "none" | undefined;
             lineVisible?: boolean | undefined;
             lineStyle?: {
                 visible?: boolean | undefined;
@@ -336,6 +416,8 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                 width?: number | undefined;
                 dashType?: import("../..").ChartBorderDashType | undefined;
             } | undefined;
+            crossing?: "autoZero" | "min" | "max" | number | undefined;
+            tickLabelPosition?: "nextTo" | "low" | "high" | "none" | undefined;
             majorUnit?: number | undefined;
             autoScale?: "office" | undefined;
             baseTimeUnit?: "days" | "months" | "years" | undefined;
@@ -391,6 +473,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                     rightYAxis?: boolean | undefined;
                     smooth?: boolean | undefined;
                     color?: import("@univerjs/core").Nullable<ChartColor>;
+                    fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                     fillOpacity?: number | undefined;
                     border?: {
                         visible?: boolean | undefined;
@@ -486,6 +569,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                 offset?: [number, number] | undefined;
                             } | undefined;
                             color?: import("@univerjs/core").Nullable<ChartColor>;
+                            fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                             fillOpacity?: number | undefined;
                             size?: number | undefined;
                             shape?: import("../..").LinePointShape | undefined;
@@ -501,6 +585,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                     rightYAxis?: boolean | undefined;
                     smooth?: boolean | undefined;
                     color?: import("@univerjs/core").Nullable<ChartColor>;
+                    fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                     fillOpacity?: number | undefined;
                     border?: {
                         visible?: boolean | undefined;
@@ -596,6 +681,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                 offset?: [number, number] | undefined;
                             } | undefined;
                             color?: import("@univerjs/core").Nullable<ChartColor>;
+                            fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                             fillOpacity?: number | undefined;
                             size?: number | undefined;
                             shape?: import("../..").LinePointShape | undefined;
@@ -611,6 +697,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                     rightYAxis?: boolean | undefined;
                     smooth?: boolean | undefined;
                     color?: import("@univerjs/core").Nullable<ChartColor>;
+                    fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                     fillOpacity?: number | undefined;
                     border?: {
                         visible?: boolean | undefined;
@@ -706,6 +793,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                 offset?: [number, number] | undefined;
                             } | undefined;
                             color?: import("@univerjs/core").Nullable<ChartColor>;
+                            fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                             fillOpacity?: number | undefined;
                             size?: number | undefined;
                             shape?: import("../..").LinePointShape | undefined;
@@ -724,6 +812,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                 dashType?: import("../..").ChartBorderDashType | undefined;
             } | undefined;
             fillOpacity?: number | undefined;
+            fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
             scatterLine?: import("../..").ScatterLineType | undefined;
             rightYAxis?: boolean | undefined;
         } | undefined;
@@ -734,6 +823,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                 rightYAxis?: boolean | undefined;
                 smooth?: boolean | undefined;
                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                 fillOpacity?: number | undefined;
                 border?: {
                     visible?: boolean | undefined;
@@ -829,6 +919,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                             offset?: [number, number] | undefined;
                         } | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         size?: number | undefined;
                         shape?: import("../..").LinePointShape | undefined;
@@ -842,6 +933,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -937,6 +1029,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -952,6 +1045,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -1047,6 +1141,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -1062,6 +1157,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -1157,6 +1253,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -1172,10 +1269,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
         bar?: {
             gapWidth?: number | undefined;
             overlap?: number | undefined;
-            is3D?: boolean | undefined;
             shape?: import("../..").BarShape | undefined;
-            rotX?: number | undefined;
-            rotY?: number | undefined;
         } | undefined;
         bubble?: {
             scale?: number | undefined;
@@ -1216,6 +1310,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                 aggregate?: {
                     label?: string | undefined;
                     style?: {
+                        explosion?: number | undefined;
                         color?: ChartColor | undefined;
                         fillOpacity?: number | undefined;
                     } | undefined;
@@ -1250,7 +1345,6 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
             } | undefined;
             borderColor?: string | undefined;
             hasPaddingAngle?: boolean | undefined;
-            is3D?: boolean | undefined;
             isHalfPie?: boolean | undefined;
             rosePie?: boolean | undefined;
             showLabelLine?: boolean | undefined;
@@ -1263,7 +1357,9 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
             sliceStyles?: {
                 [x: number]: {
                     color?: import("@univerjs/core").Nullable<ChartColor>;
+                    fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                     fillOpacity?: number | undefined;
+                    explosion?: number | undefined;
                 } | undefined;
             } | undefined;
         } | undefined;
@@ -1322,6 +1418,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                 rightYAxis?: boolean | undefined;
                 smooth?: boolean | undefined;
                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                 fillOpacity?: number | undefined;
                 border?: {
                     visible?: boolean | undefined;
@@ -1417,6 +1514,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                             offset?: [number, number] | undefined;
                         } | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         size?: number | undefined;
                         shape?: import("../..").LinePointShape | undefined;
@@ -1430,6 +1528,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -1525,6 +1624,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -1540,6 +1640,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -1635,6 +1736,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -1650,6 +1752,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -1745,6 +1848,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -1762,6 +1866,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                 rightYAxis?: boolean | undefined;
                 smooth?: boolean | undefined;
                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                 fillOpacity?: number | undefined;
                 border?: {
                     visible?: boolean | undefined;
@@ -1857,6 +1962,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                             offset?: [number, number] | undefined;
                         } | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         size?: number | undefined;
                         shape?: import("../..").LinePointShape | undefined;
@@ -1870,6 +1976,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -1965,6 +2072,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -1980,6 +2088,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -2075,6 +2184,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;
@@ -2090,6 +2200,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                         rightYAxis?: boolean | undefined;
                         smooth?: boolean | undefined;
                         color?: import("@univerjs/core").Nullable<ChartColor>;
+                        fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                         fillOpacity?: number | undefined;
                         border?: {
                             visible?: boolean | undefined;
@@ -2185,6 +2296,7 @@ export declare function mergeChartModelConfigPatch(chartModel: ChartModel, pendi
                                     offset?: [number, number] | undefined;
                                 } | undefined;
                                 color?: import("@univerjs/core").Nullable<ChartColor>;
+                                fillPattern?: (import("../../types").IChartSeriesFillPattern | null) | undefined;
                                 fillOpacity?: number | undefined;
                                 size?: number | undefined;
                                 shape?: import("../..").LinePointShape | undefined;

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

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

package/lib/types/enum.d.ts

@@ -1,4 +1,6 @@
 export declare enum ChartAttributeBits {
+    /** Persisted chart dimension; the underlying chart, direction and stacking bits remain unchanged. */
+    ThreeD = 134217728,
     Stack = 1073741824,
     PercentStack = 1610612736,
     Horizontal = 268435456
@@ -55,6 +57,17 @@ export declare enum ChartTypeBits {
      * Percent stacked area chart
      */
     AreaPercentStacked = 1610612752,
+    Line3D = 134217730,
+    Column3D = 134217732,
+    ColumnStacked3D = 1207959556,
+    ColumnPercentStacked3D = 1744830468,
+    Bar3D = 402653188,
+    BarStacked3D = 1476395012,
+    BarPercentStacked3D = 2013265924,
+    Pie3D = 134217736,
+    Area3D = 134217744,
+    AreaStacked3D = 1207959568,
+    AreaPercentStacked3D = 1744830480,
     /** Radar chart */
     Radar = 32,
     /** Scatter chart */

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

@@ -0,0 +1,6 @@
+import type { AreaLineStyle, IChartInfo } from '@univerjs-pro/engine-chart';
+import { FAxisThreeDChartBuilder } from '../f-axis-three-d-chart-builder';
+export declare class FAreaThreeDChartBuilder<TSource = never[], TDataSource = TSource, TInfo extends IChartInfo<TDataSource> = IChartInfo<TDataSource>> extends FAxisThreeDChartBuilder<TSource, TDataSource, TInfo> {
+    setAreaLineStyle(value: AreaLineStyle): this;
+    clearAreaLineStyle(): this;
+}

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

@@ -0,0 +1,6 @@
+import type { IChartBarSpec, IChartInfo } from '@univerjs-pro/engine-chart';
+import { FAxisThreeDChartBuilder } from '../f-axis-three-d-chart-builder';
+export declare class FColumnThreeDChartBuilder<TSource = never[], TDataSource = TSource, TInfo extends IChartInfo<TDataSource> = IChartInfo<TDataSource>> extends FAxisThreeDChartBuilder<TSource, TDataSource, TInfo> {
+    setBar(value: IChartBarSpec): this;
+    clearBar(): this;
+}

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

@@ -0,0 +1,6 @@
+import type { IChartInfo, IChartSeriesBorderSpec } from '@univerjs-pro/engine-chart';
+import { FAxisThreeDChartBuilder } from '../f-axis-three-d-chart-builder';
+export declare class FLineThreeDChartBuilder<TSource = never[], TDataSource = TSource, TInfo extends IChartInfo<TDataSource> = IChartInfo<TDataSource>> extends FAxisThreeDChartBuilder<TSource, TDataSource, TInfo> {
+    setLineStyle(value: IChartSeriesBorderSpec): this;
+    clearLineStyle(): this;
+}

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

@@ -0,0 +1,15 @@
+import type { DeepNullish, IChartInfo, IChartPieLabelSpec, IChartSliceStyleSpec } from '@univerjs-pro/engine-chart';
+import { FThreeDChartBuilder } from '../f-three-d-chart-builder';
+/** Solid 3D pie; hole, half-pie and rose geometry are intentionally unavailable. */
+export declare class FPieThreeDChartBuilder<TSource = never[], TDataSource = TSource, TInfo extends IChartInfo<TDataSource> = IChartInfo<TDataSource>> extends FThreeDChartBuilder<TSource, TDataSource, TInfo> {
+    setExplosion(value: number): this;
+    resetExplosion(): this;
+    setSliceStyle(index: number, value: IChartSliceStyleSpec): this;
+    clearSliceStyle(index: number): this;
+    setPieLabel(value: DeepNullish<IChartPieLabelSpec>): this;
+    clearPieLabel(): this;
+    setSliceBorderColor(value: string): this;
+    clearSliceBorderColor(): this;
+    setLabelLineVisible(value: boolean): this;
+    resetLabelLineVisible(): this;
+}

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

@@ -1,17 +1,21 @@
 import type { ChartTypeString, IChartInfo, IChartSeriesPatch, IChartSeriesStyleSpec } from '@univerjs-pro/engine-chart';
 import type { FAreaChartBuilder } from './builders/f-area-chart-builder';
+import type { FAreaThreeDChartBuilder } from './builders/f-area-three-d-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 { FColumnThreeDChartBuilder } from './builders/f-column-three-d-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 { FLineThreeDChartBuilder } from './builders/f-line-three-d-chart-builder';
 import type { FParetoChartBuilder } from './builders/f-pareto-chart-builder';
 import type { FPieChartBuilder } from './builders/f-pie-chart-builder';
+import type { FPieThreeDChartBuilder } from './builders/f-pie-three-d-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';
@@ -23,6 +27,17 @@ import type { FCartesianChartBuilder } from './f-cartesian-chart-builder';
 import type { FChartBuilderBase } from './f-chart-builder-base';
 /** Maps each canonical Chart type to its type-specific Facade Builder. */
 export interface IChartBuilderTypeMap<TSource = never[], TDataSource = TSource, TInfo extends IChartInfo<TDataSource> = IChartInfo<TDataSource>> {
+    [ChartTypeString.Line3D]: FLineThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.Column3D]: FColumnThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.ColumnStacked3D]: FColumnThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.ColumnPercentStacked3D]: FColumnThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.Bar3D]: FColumnThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.BarStacked3D]: FColumnThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.BarPercentStacked3D]: FColumnThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.Pie3D]: FPieThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.Area3D]: FAreaThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.AreaStacked3D]: FAreaThreeDChartBuilder<TSource, TDataSource, TInfo>;
+    [ChartTypeString.AreaPercentStacked3D]: FAreaThreeDChartBuilder<TSource, TDataSource, TInfo>;
     [ChartTypeString.Line]: FLineChartBuilder<TSource, TDataSource, TInfo>;
     [ChartTypeString.Column]: FCartesianChartBuilder<Omit<IChartSeriesPatch, 'selector'>, IChartSeriesStyleSpec, TSource, TDataSource, TInfo>;
     [ChartTypeString.ColumnStacked]: FCartesianChartBuilder<Omit<IChartSeriesPatch, 'selector'>, IChartSeriesStyleSpec, TSource, TDataSource, TInfo>;

package/lib/types/facade/create-chart-builder.d.ts

@@ -1,7 +1,8 @@
-import type { ChartTypeString, IChartDescription, IChartInfo } from '@univerjs-pro/engine-chart';
+import type { IChartDescription, IChartInfo } from '@univerjs-pro/engine-chart';
 import type { Injector } from '@univerjs/core';
 import type { IChartBuilderTypeMap } from './chart-builder-type-map';
 import type { HostComposedChartBuilder } from './chart-host-builder-types';
+import { ChartTypeString } from '@univerjs-pro/engine-chart';
 /** Host extension hooks used to add placement and ownership methods to a Chart Builder. */
 export interface IChartBuilderExtensionContext<TInfo extends IChartInfo<TDataSource>, TDataSource> {
     /** Returns a cloned host-specific information field from the detached draft. */

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

@@ -48,7 +48,9 @@ export declare abstract class FAxisChartBuilder<TSource = never[], TDataSource =
      */
     clearMarkLines(): this;
     /**
-     * Sets the xaxis configuration and returns this builder for chaining.
+     * Sets the X axis configuration and returns this detached builder for chaining.
+     * On a supported Bar chart, `{ scaleType: 'log', logBase: 2.5 }` selects its numeric scale.
+     * Unsupported axis configurations are retained and reported by chart diagnostics.
      *
      * This method executes synchronously.
      *
@@ -56,7 +58,13 @@ export declare abstract class FAxisChartBuilder<TSource = never[], TDataSource =
      * @returns This builder for chaining.
      * @example
      * ```ts
-     * builder.setXAxis({ title: 'Month' });
+     * // Bar charts use the X axis as their numeric axis.
+     * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const chartInfo = sheet.newChart(univerAPI.Enum.ChartTypeString.Bar)
+     *     .setSource('A1:B8')
+     *     .setXAxis({ scaleType: 'log', logBase: 10 })
+     *     .build();
+     * await sheet.insertChart(chartInfo);
      * ```
      */
     setXAxis(value: IChartAxisSpec): this;
@@ -74,7 +82,12 @@ export declare abstract class FAxisChartBuilder<TSource = never[], TDataSource =
      */
     clearXAxis(target?: ChartAxisTarget): this;
     /**
-     * Sets the yaxis configuration and returns this builder for chaining.
+     * Sets the Y axis configuration and returns this detached builder for chaining.
+     * Supported numeric axes accept `{ scaleType: 'log', logBase: 2.5 }`.
+     * Missing base defaults to 10 when first enabled. Finite out-of-range values are retained
+     * for compatibility and render with base 10 plus diagnostics. Normal input uses 2–1000.
+     * Apply an existing-chart draft with `await chart.update(builder.build())`.
+     * Explicit `scaleType: 'linear'` removes the base; unrelated patches preserve it.
      *
      * This method executes synchronously.
      *
@@ -82,12 +95,27 @@ export declare abstract class FAxisChartBuilder<TSource = never[], TDataSource =
      * @returns This builder for chaining.
      * @example
      * ```ts
-     * builder.setYAxis({ title: 'Revenue' });
+     * // Update an existing Line chart; Area and Column use the same Y-axis settings.
+     * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const chart = sheet.getCharts()[0];
+     * const builder = chart.toBuilder(univerAPI.Enum.ChartTypeString.Line)
+     *     .setYAxis({ scaleType: 'log', logBase: 2.5 });
+     * await chart.update(builder.build());
+     *
+     * // Change only the base of the logarithmic axis.
+     * await chart.update(chart.toBuilder(univerAPI.Enum.ChartTypeString.Line)
+     *     .setYAxis({ logBase: 2 }).build());
+     *
+     * // Restore linear scaling and remove the logarithm base.
+     * await chart.update(chart.toBuilder(univerAPI.Enum.ChartTypeString.Line)
+     *     .setYAxis({ scaleType: 'linear' }).build());
      * ```
      */
     setYAxis(value: IChartAxisSpec): this;
     /**
-     * Clears the yaxis configuration and returns this builder for chaining.
+     * Clears the Y axis configuration and returns this builder for chaining.
+     * Clearing an entire logarithmic axis writes explicit linear intent so imported raw
+     * chart data cannot restore the old logarithmic scale. Clearing a field keeps the scale.
      *
      * This method executes synchronously.
      *
@@ -100,7 +128,8 @@ export declare abstract class FAxisChartBuilder<TSource = never[], TDataSource =
      */
     clearYAxis(target?: ChartAxisTarget): this;
     /**
-     * Sets the right yaxis configuration and returns this builder for chaining.
+     * Sets the existing secondary Y axis configuration and returns this builder for chaining.
+     * Logarithmic settings follow `setYAxis`; this does not create a secondary Bar axis.
      *
      * This method executes synchronously.
      *
@@ -108,7 +137,13 @@ export declare abstract class FAxisChartBuilder<TSource = never[], TDataSource =
      * @returns This builder for chaining.
      * @example
      * ```ts
-     * builder.setRightYAxis({ title: 'Margin' });
+     * // The existing Line chart already has a series assigned to its secondary axis.
+     * const sheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const chart = sheet.getCharts()[0];
+     * const builder = chart.toBuilder(univerAPI.Enum.ChartTypeString.Line)
+     *     .setYAxis({ scaleType: 'linear' })
+     *     .setRightYAxis({ scaleType: 'log', logBase: 2 });
+     * await chart.update(builder.build());
      * ```
      */
     setRightYAxis(value: IChartAxisSpec): this;