@visactor/vseed 0.0.37 → 0.0.39

package/dist/pipeline/spec/chart/pipes/color/color.d.ts

@@ -1,2 +1,5 @@
 import type { SpecPipe } from '../../../../../types';
 export declare const color: SpecPipe;
+export declare const createSpecifiedForColorMapping: (colorMapping?: Record<string, string>, colorIdMap?: Record<string, string>, colorItems?: string[]) => {
+    [x: string]: string;
+} | undefined;

package/dist/pipeline/spec/chart/pipes/series/series.d.ts

@@ -1,3 +1,7 @@
 import type { SpecPipe, SpecPipeline } from '../../../../../types';
 export declare const series: (...args: SpecPipeline[]) => SpecPipe;
+/**
+ * @description 双轴图的透视场景, 不能使用此pipe, 请使用series
+ * 因为VTable.PivotVChart会自行解析数据, 而非VChart解析.
+ */
 export declare const seriesDualAxis: (...args: SpecPipeline[]) => SpecPipe;

package/dist/pipeline/utils/constant.d.ts

@@ -1,2 +1,4 @@
 export declare const ANNOTATION_Z_INDEX = 1000;
 export declare const LINEAR_AXIS_INNER_OFFSET_TOP = 7;
+export declare const DUAL_AXIS_CHART_COLUMN_Z_INDEX = 1000;
+export declare const DUAL_AXIS_CHART_NON_COLUMN_Z_INDEX = 1001;

package/dist/types/advancedVSeed.d.ts

@@ -1920,6 +1920,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                     scatter: "scatter";
                 }>>;
             }, z.core.$strip>]>>>;
+            alignTicks: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodBoolean>, z.ZodBoolean]>>>;
             primaryYAxis: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
                 visible: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodBoolean>>>;
                 min: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2670,6 +2671,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            barVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             barColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             barColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             barBorderColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2746,6 +2748,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            barVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             barColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             barColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             barBorderColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2823,6 +2826,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2903,6 +2907,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -2984,6 +2989,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -3063,6 +3069,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -3143,6 +3150,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
@@ -3215,6 +3223,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>]>>]>>>;
+            areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strip>>]>>>;
@@ -5040,6 +5049,7 @@ export declare const zAdvancedVSeed: z.ZodObject<{
                         scatter: "scatter";
                     }>>;
                 }, z.core.$strip>]>>>;
+                alignTicks: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodBoolean>, z.ZodBoolean]>>>;
                 primaryYAxis: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
                     visible: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodBoolean>>>;
                     min: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -6005,8 +6015,6 @@ export declare const zAdvancedVSeed: z.ZodObject<{
             lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
             lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-            offsetX: z.ZodDefault<z.ZodNumber>;
-            offsetY: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
                 field: z.ZodString;
@@ -6110,8 +6118,6 @@ export declare const zAdvancedVSeed: z.ZodObject<{
             lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
             lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-            offsetX: z.ZodDefault<z.ZodNumber>;
-            offsetY: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>]>>>;
         annotationHorizontalLine: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodObject<{
             selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -6216,8 +6222,6 @@ export declare const zAdvancedVSeed: z.ZodObject<{
             textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-            offsetX: z.ZodDefault<z.ZodNumber>;
-            offsetY: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
                 field: z.ZodString;
@@ -6321,8 +6325,6 @@ export declare const zAdvancedVSeed: z.ZodObject<{
             textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-            offsetX: z.ZodDefault<z.ZodNumber>;
-            offsetY: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>]>>>;
         annotationArea: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodObject<{
             selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -6430,8 +6432,6 @@ export declare const zAdvancedVSeed: z.ZodObject<{
             areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-            offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-            offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
                 field: z.ZodString;
@@ -6538,8 +6538,6 @@ export declare const zAdvancedVSeed: z.ZodObject<{
             areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
             outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-            offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-            offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         }, z.core.$strip>>]>>>;
     }, z.core.$strip>;
     locale: z.ZodDefault<z.ZodEnum<{

package/dist/types/chartType/area/area.d.ts

@@ -1,12 +1,12 @@
 import type { Locale } from '../../i18n';
 import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, AreaStyle, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, XBandAxis, YLinearAxis, CrosshairLine, MeasureTree, Sort, SortLegend } from '../../properties';
 /**
- * 面积图类型定义
  * @description 面积图, 适用于展示数据随时间变化的趋势及累积关系, 通过填充区域增强数据对比. X轴为类目轴(分类数据), Y轴为数值轴(连续数据).
  * 适用场景:
  * - 展示单一数据系列的趋势变化
  * - 强调总量随时间的累积效果
  * - 对比多个数据系列的总量差异
+ * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
  * - 第一个维度字段映射到X轴，其余维度字段会与指标名称(存在多个指标时)合并, 作为图例项展示.
@@ -14,13 +14,22 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * 默认开启的功能:
  * - 模块开启堆叠
  * - 默认开启图例、坐标轴、区域填充、数据标签、提示信息
+ * @recommend
+ * - 推荐字段配置: `1`个指标, `2`个维度
+ * - 支持数据重塑: 至少`1`个指标, `0`个维度
  */
 export interface Area {
     /**
      * 面积图
      * @description 面积图，展示数据趋势及累积关系的图表类型
      * @type {'area'}
-     * @example 'area'
+     * @example
+     * ```js {2}
+     * {
+     *   chartType: 'area',
+     *   dataset: [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}],
+     * }
+     * ```
      */
     chartType: 'area';
     /**
@@ -119,7 +128,6 @@ export interface Area {
      */
     theme?: Theme;
     /**
-     * 点图元样式
      * @description 点图元样式配置, 用于定义图表的点图元样式, 包括点图元的颜色, 边框等.
      * 支持全局样式或条件样式配置
      * 数据筛选器
@@ -128,7 +136,6 @@ export interface Area {
      */
     pointStyle?: PointStyle | PointStyle[];
     /**
-     * 线图元样式
      * @description 线图元样式配置, 用于定义图表的线图元样式, 包括线图元的颜色, 透明度, 曲线等.
      * 支持全局样式或条件样式配置
      * 数据筛选器
@@ -137,7 +144,6 @@ export interface Area {
      */
     lineStyle?: LineStyle | LineStyle[];
     /**
-     * 面积图元样式
      * @description 面积图元样式配置, 用于定义图表的面积图元样式, 包括面积图元的颜色, 透明度, 边框等.
      * 支持全局样式或条件样式配置
      * 数据筛选器
@@ -146,18 +152,15 @@ export interface Area {
      */
     areaStyle?: AreaStyle | AreaStyle[];
     /**
-     * 标注点
      * @description 标注点配置, 根据选择的数据, 定义图表的标注点, 包括标注点的位置, 格式, 样式等.
      */
     annotationPoint?: AnnotationPoint | AnnotationPoint[];
     /**
-     * 标注垂直线
-     * @description 标注垂直线配置, 根据选择的数据, 定义图表的标注垂直线, 包括标注垂直线的位置, 样式等.
+     * @description 垂直标注线配置, 根据选择的数据, 定义图表的标注垂直线, 包括标注垂直线的位置, 样式等.
      */
     annotationVerticalLine?: AnnotationVerticalLine | AnnotationVerticalLine[];
     /**
-     * 标注水平线
-     * @description 标注水平线配置, 根据选择的数据, 定义图表的标注水平线, 包括标注水平线的位置, 样式等.
+     * @description 水平标注线配置, 根据选择的数据, 定义图表的标注水平线, 包括标注水平线的位置, 样式等.
      */
     annotationHorizontalLine?: AnnotationHorizontalLine | AnnotationHorizontalLine[];
     /**

package/dist/types/chartType/area/zArea.d.ts

@@ -268,6 +268,7 @@ export declare const zArea: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -348,6 +349,7 @@ export declare const zArea: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -429,6 +431,7 @@ export declare const zArea: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -508,6 +511,7 @@ export declare const zArea: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -588,6 +592,7 @@ export declare const zArea: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>>, z.ZodObject<{
@@ -660,6 +665,7 @@ export declare const zArea: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>]>>>;
@@ -951,8 +957,6 @@ export declare const zArea: z.ZodObject<{
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
         lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1056,8 +1060,6 @@ export declare const zArea: z.ZodObject<{
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
         lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>]>>>;
     annotationHorizontalLine: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -1162,8 +1164,6 @@ export declare const zArea: z.ZodObject<{
         textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1267,8 +1267,6 @@ export declare const zArea: z.ZodObject<{
         textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>]>>>;
     annotationArea: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -1376,8 +1374,6 @@ export declare const zArea: z.ZodObject<{
         areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1484,8 +1480,6 @@ export declare const zArea: z.ZodObject<{
         areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>]>>>;
     locale: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodEnum<{
         "zh-CN": "zh-CN";

package/dist/types/chartType/areaPercent/areaPercent.d.ts

@@ -7,12 +7,16 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 时间序列的构成变化分析
  * - 多类别占比趋势对比
  * - 累积占比与单一类别占比同时展示
+ * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
  * - 第一个维度会放至Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
  * - 所有指标会自动合并为一个指标
  * 默认开启的功能:
  * - 默认开启图例、坐标轴、百分比标签、提示信息、占比计算
+ * @recommend
+ * - 推荐字段配置: `1`个指标, `2`个维度
+ * - 支持数据重塑: 至少`1`个指标, `0`个维度
  */
 export interface AreaPercent {
     /**

package/dist/types/chartType/areaPercent/zAreaPercent.d.ts

@@ -268,6 +268,7 @@ export declare const zAreaPercent: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -348,6 +349,7 @@ export declare const zAreaPercent: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -429,6 +431,7 @@ export declare const zAreaPercent: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -508,6 +511,7 @@ export declare const zAreaPercent: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -588,6 +592,7 @@ export declare const zAreaPercent: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>>, z.ZodObject<{
@@ -660,6 +665,7 @@ export declare const zAreaPercent: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>]>>>;
@@ -951,8 +957,6 @@ export declare const zAreaPercent: z.ZodObject<{
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
         lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1056,8 +1060,6 @@ export declare const zAreaPercent: z.ZodObject<{
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
         lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>]>>>;
     annotationHorizontalLine: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -1162,8 +1164,6 @@ export declare const zAreaPercent: z.ZodObject<{
         textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1267,8 +1267,6 @@ export declare const zAreaPercent: z.ZodObject<{
         textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>]>>>;
     annotationArea: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -1376,8 +1374,6 @@ export declare const zAreaPercent: z.ZodObject<{
         areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1484,8 +1480,6 @@ export declare const zAreaPercent: z.ZodObject<{
         areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>]>>>;
     locale: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodEnum<{
         "zh-CN": "zh-CN";

package/dist/types/chartType/areaRange/areaRange.d.ts

@@ -7,6 +7,7 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 展示单一数据系列的趋势变化
  * - 强调总量随时间的累积效果
  * - 对比多个数据系列的总量差异
+ * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
  * - 第一个维度字段映射到X轴，其余维度字段会与指标名称(存在多个指标时)合并, 作为图例项展示.
@@ -14,6 +15,9 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * 默认开启的功能:
  * - 模块开启堆叠
  * - 默认开启图例、坐标轴、区域填充、数据标签、提示信息
+ * @recommend
+ * - 推荐字段配置: `2`个指标, `1`个维度
+ * - 不支持数据重塑: 至少`2`个指标, `1`个维度
  */
 export interface AreaRange {
     /**

package/dist/types/chartType/areaRange/zAreaRange.d.ts

@@ -207,6 +207,7 @@ export declare const zAreaRange: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -287,6 +288,7 @@ export declare const zAreaRange: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        pointVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         pointSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         pointColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         pointColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -368,6 +370,7 @@ export declare const zAreaRange: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -447,6 +450,7 @@ export declare const zAreaRange: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        lineVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineSmooth: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         lineColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -527,6 +531,7 @@ export declare const zAreaRange: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>>, z.ZodObject<{
@@ -599,6 +604,7 @@ export declare const zAreaRange: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>>]>>>;
+        areaVisible: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         areaColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         areaColorOpacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, z.core.$strip>]>>>;
@@ -890,8 +896,6 @@ export declare const zAreaRange: z.ZodObject<{
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
         lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -995,8 +999,6 @@ export declare const zAreaRange: z.ZodObject<{
         lineColor: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>;
         lineWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         lineStyle: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"solid">, z.ZodLiteral<"dashed">, z.ZodLiteral<"dotted">]>>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>]>>>;
     annotationHorizontalLine: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -1101,8 +1103,6 @@ export declare const zAreaRange: z.ZodObject<{
         textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1206,8 +1206,6 @@ export declare const zAreaRange: z.ZodObject<{
         textBackgroundBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         textBackgroundPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodDefault<z.ZodNumber>;
-        offsetY: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>]>>>;
     annotationArea: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
@@ -1315,8 +1313,6 @@ export declare const zAreaRange: z.ZodObject<{
         areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>>, z.ZodObject<{
         selector: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
             field: z.ZodString;
@@ -1423,8 +1419,6 @@ export declare const zAreaRange: z.ZodObject<{
         areaBorderWidth: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         areaBorderRadius: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
-        offsetY: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>]>>>;
     locale: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodEnum<{
         "zh-CN": "zh-CN";

package/dist/types/chartType/bar/bar.d.ts

@@ -8,12 +8,16 @@ import { type AnnotationArea, type AnnotationHorizontalLine, type AnnotationPoin
  * - 数据项名称较长时
  * - 需要展示数据排名对比
  * - 展示正负双向数据
+ * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
  * - 第一个维度会放至Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
  * - 所有指标会自动合并为一个指标
  * 默认开启的功能:
  * - 默认开启图例、坐标轴、数据标签、提示信息
+ * @recommend
+ * - 推荐字段配置: `1`个指标, `2`个维度
+ * - 支持数据重塑: 至少`1`个指标, `0`个维度
  */
 export interface Bar {
     /**