@visactor/vseed 0.1.5 → 0.1.7

package/dist/types/chartType/barPercent/zBarPercent.d.ts

@@ -19,11 +19,6 @@ export declare const zBarPercent: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zBarPercent: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,12 +1,28 @@
 import type { Locale } from '../../i18n';
 import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend, Encoding } from '../../properties';
 /**
- * 柱状图类型定义
  * @description 柱状图，适用于纵向数据对比场景，X轴为类目轴（分类数据），Y轴为数值轴（连续数据），柱子纵向排列
  * 适用场景:
  * - 数据项名称较短时
  * - 需要直观比较不同类别的数值大小
  * - 展示时间序列数据变化趋势
+ * @encoding
+ * 维度未包含任何encoding, 则使用默认映射规则:
+ * 1. x: 第一个维度映射至X轴
+ * 2. color: 非X轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 3. detail: 其余所有维度映射至Detail通道
+ * 指标未包含任何encoding, 则使用默认映射规则:
+ * 1. y: 全部指标映射至Y轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认映射第一个维度
+ * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认映射指标名称
+ * 3. 用户指定的detail维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置encoding, 则默认映射至Y轴;
+ * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）

package/dist/types/chartType/column/zColumn.d.ts

@@ -19,11 +19,6 @@ export declare const zColumn: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zColumn: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,12 +1,28 @@
 import type { Locale } from '../../i18n';
 import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, SortLegend, Sort, Encoding } from '../../properties';
 /**
- * 并列柱状图类型定义
  * @description 并列柱状图，适用于多指标并行对比场景，多个柱子并列排列展示不同指标值
  * 适用场景:
  * - 同一维度下多指标并行对比
  * - 多维度数据的横向比较
  * - 指标间关联性分析
+ * @encoding
+ * 维度未包含任何encoding, 则使用默认映射规则:
+ * 1. x: 第一个维度映射至X轴
+ * 2. color: 非X轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 3. detail: 其余所有维度映射至Detail通道
+ * 指标未包含任何encoding, 则使用默认映射规则:
+ * 1. y: 全部指标映射至Y轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认映射第一个维度
+ * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认映射指标名称
+ * 3. 用户指定的detail维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置encoding, 则默认映射至Y轴;
+ * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）

package/dist/types/chartType/columnParallel/zColumnParallel.d.ts

@@ -19,11 +19,6 @@ export declare const zColumnParallel: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zColumnParallel: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,12 +1,28 @@
 import type { Locale } from '../../i18n';
 import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend, Encoding } from '../../properties';
 /**
- * 百分比柱状图类型定义
  * @description 百分比柱状图，适用于展示各类别占比关系的场景，Y轴以百分比形式展示数据占比
  * 适用场景:
  * - 不同类别数据的占比对比
  * - 多维度数据的构成分析
  * - 时间序列的占比变化趋势
+ * @encoding
+ * 维度未包含任何encoding, 则使用默认映射规则:
+ * 1. x: 第一个维度映射至X轴
+ * 2. color: 非X轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 3. detail: 其余所有维度映射至Detail通道
+ * 指标未包含任何encoding, 则使用默认映射规则:
+ * 1. y: 全部指标映射至Y轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认映射第一个维度
+ * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认映射指标名称
+ * 3. 用户指定的detail维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置encoding, 则默认映射至Y轴;
+ * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）

package/dist/types/chartType/columnPercent/zColumnPercent.d.ts

@@ -19,11 +19,6 @@ export declare const zColumnPercent: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zColumnPercent: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,12 +1,27 @@
 import { type Locale } from '../../i18n';
 import type { BackgroundColor, Color, Dataset, Dimensions, Encoding, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
 /**
- * 环形图类型定义
  * @description 环形图，适用于展示单一维度数据的占比关系，中心留有空白区域可展示汇总信息
  * 适用场景:
  * - 需要同时展示整体数据和各部分占比
  * - 强调数据的整体与部分关系
  * - 中心区域需要展示关键指标或标题
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. color: 所有维度, 合并映射至颜色通道, 作为图例展示
+ * 2. detail: 所有维度, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. angle: 全部指标映射至angle轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置`encoding`, 则默认映射至angle轴;
+ * 2. 用户指定的`angle`指标映射至angle轴, 支持多个指标;
+ * 3. 用户指定的`color`指标映射至color通道, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）

package/dist/types/chartType/donut/zDonut.d.ts

@@ -19,11 +19,6 @@ export declare const zDonut: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zDonut: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,13 +1,29 @@
 import type { Locale } from '../../i18n';
 import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, AreaStyle, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, DualChartType, DualMeasures, Encoding, Label, Legend, LineStyle, MeasureTree, PointStyle, Sort, SortLegend, Theme, Tooltip, YLinearAxis } from '../../properties';
 /**
- * 双轴图类型定义
  * @description 双轴图，适用于展示两个不同量级或不同单位指标的对比关系，包含主坐标轴和次坐标轴
  * 适用场景:
  * - 不同量级指标的对比分析
  * - 相关性指标的趋势比较
  * - 需要同时展示数值和增长率等复合指标
  * - 支持不同类型图表组合（如折线图+柱状图/ 折线图+面积图/ 面积图+柱状图）
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. x: 第一个维度映射至X轴
+ * 2. color: 非`X`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 3. detail: 非`X`轴所有维度与指标名称, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. y: 第一个指标映射至主Y轴, 其余指标映射至次Y轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的`xAxis`维度映射至X轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至X轴
+ * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置encoding, 则第一个指标默认映射至Y轴, 其余指标默认映射至次Y轴
+ * 2. 用户指定的yAxis指标映射至主Y轴或次Y轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）

package/dist/types/chartType/dualAxis/zDualAxis.d.ts

@@ -5,11 +5,6 @@ export declare const zDualAxis: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -57,10 +52,12 @@ export declare const zDualAxis: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";
@@ -107,10 +104,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";
@@ -154,10 +153,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";
@@ -202,10 +203,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";
@@ -249,10 +252,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";

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

@@ -1,11 +1,25 @@
 import type { Locale } from '../../i18n';
 import type { BackgroundColor, ColorLegend, Dataset, Dimensions, Encoding, Label, LinearColor, MeasureTree, Theme, Tooltip } from '../../properties';
 /**
- * 漏斗图
  * @description 漏斗图，用于展示单一维度数据的占比关系
  * 适用场景:
  * 漏斗图适用场景:
  * - 适合用来分析具有多个连续、规范化步骤的流程，并清晰地展示在每个环节的数据流失或转化情况
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. color: 所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 2. detail: 所有维度与指标名称, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. size: 全部指标映射至size通道
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 2. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置`encoding`, 则默认映射至size通道;
+ * 2. 用户指定的`size`指标映射至size通道, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个数值字段（指标）

package/dist/types/chartType/funnel/zFunnel.d.ts

@@ -19,11 +19,6 @@ export declare const zFunnel: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zFunnel: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -2,12 +2,28 @@ import { type Locale } from '../../i18n';
 import type { ColorLegend, Encoding, LinearColor, MeasureTree } from '../../properties';
 import { type BackgroundColor, type Dataset, type Dimensions, type Label, type Theme, type Tooltip } from '../../properties';
 /**
- * 热力图类型定义
  * @description 热力图，通过二维矩阵的颜色深浅展示数据的分布和强弱关系
  * 适用场景:
  * - 大规模二维数据的密度和强度展示
  * - 分类与数值的关联分析
  * - 时间序列与类别的交叉对比
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. x: 第一个维度, 合并映射至x轴通道
+ * 2. y: 第二个(若没有第二个则复用第一个)及其之后的维度, 合并映射至y轴通道
+ * 3. color: 所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 4. detail: 所有维度与指标名称, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. color: 第一个指标映射至Color通道
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 2. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置`encoding`, 则默认映射至color通道, 只有一个指标时才会映射至color通道
+ * 2. 用户指定的`detail`指标映射至Detail通道, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少2个维度字段，用于确定热力图的行和列

package/dist/types/chartType/heatmap/zHeatmap.d.ts

@@ -5,11 +5,6 @@ export declare const zHeatmap: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -57,10 +52,12 @@ export declare const zHeatmap: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,14 +1,26 @@
 import type { Locale } from '../../i18n';
 import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, CrosshairLine, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend, Encoding } from '../../properties';
 /**
- * 折线图类型定义
- * @description
- * 折线图，适用于展示数据随时间或有序类别变化的趋势，通过线段连接数据点形成趋势线
- * @warning
+ * @description 折线图，适用于展示数据随时间或有序类别变化的趋势，通过线段连接数据点形成趋势线
  * 适用场景:
  * - 展示时间序列数据的变化趋势
  * - 比较多个数据系列的趋势对比
  * - 分析数据的增长或下降规律
+ * @encoding
+ * 维度未包含任何encoding, 则使用默认映射规则:
+ * 1. x: 第一个维度映射至X轴
+ * 2. color: 其余所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 指标未包含任何encoding, 则使用默认映射规则:
+ * 1. y: 全部指标映射至Y轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至X轴
+ * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 指标映射规则:
+ * 1. 指标未配置encoding, 则默认映射至Y轴;
+ * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）

package/dist/types/chartType/line/zLine.d.ts

@@ -19,11 +19,6 @@ export declare const zLine: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zLine: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,12 +1,27 @@
 import type { Locale } from '../../i18n';
 import type { BackgroundColor, Color, Dataset, Dimensions, Encoding, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
 /**
- * 饼图类型定义
  * @description 饼图，适用于展示单一维度数据的占比关系，通过扇形面积大小表示各类别占比
  * 适用场景:
  * - 展示分类数据的占比分布
  * - 强调数据的整体与部分关系
  * - 类别数量较少（建议不超过6个）的占比分析
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. color: 所有维度, 合并映射至颜色通道, 作为图例展示
+ * 2. detail: 所有维度, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. angle: 全部指标映射至angle轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置`encoding`, 则默认映射至angle轴;
+ * 2. 用户指定的`angle`指标映射至angle轴, 支持多个指标;
+ * 3. 用户指定的`color`指标映射至color通道, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）

package/dist/types/chartType/pie/zPie.d.ts

@@ -19,11 +19,6 @@ export declare const zPie: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -71,10 +66,12 @@ export declare const zPie: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -2,12 +2,19 @@ import { type Locale } from '../../i18n';
 import type { Measures } from '../../properties';
 import { type BackgroundColor, type Dataset, type Dimensions, type Theme } from '../../properties';
 /**
- * 透视表类型定义
- * @description 透视表，适用于多维度数据交叉分析场景，可灵活配置行、列维度和指标计算方式
+ * @description 透视表格，适用于多维度数据交叉分析场景，可灵活配置行、列维度和指标计算方式
  * 适用场景:
  * - 复杂多维数据统计分析
  * - 数据钻取与聚合展示
  * - 业务报表生成与数据探索
+ * @encoding
+ * 则使用默认映射规则:
+ * - 维度与指标名称, 交替映射到列维度和行维度
+ * - 指标默认映射到detail通道
+ *
+ * 存在`encoding`配置:
+ * - 用户指定的`row`与`column`维度, 精准映射到行维度与列维度, 若未指定row和column, 则交替映射到列维度和行维度
+ * - 用户指定的`detail`指标, 精准映射到detail通道, 若未指定detail, 则依旧映射到detail通道
  * @warning
  * 数据要求:
  * - 至少1个行维度 或 1个列维度 或 1个指标
@@ -33,7 +40,7 @@ export interface PivotTable {
      */
     dataset: Dataset;
     /**
-     * @description 透视表的行维度和列维度，会自动对数据进行处理为树形结构, 并映射到行和列轴, 可以通过 location : "rowDimension" | "columnDimension" 来控制一维度的映射位置
+     * @description 透视表的行维度和列维度，会自动对数据进行处理为树形结构, 并映射到行和列轴,
      * @type {Dimensions}
      * @example [{id: 'region', alias: '地区', isRow: true}, {id: 'product', alias: '产品', isColumn: true}]
      */

package/dist/types/chartType/pivotTable/zPivotTable.d.ts

@@ -5,11 +5,6 @@ export declare const zPivotTable: z.ZodObject<{
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;
-        location: z.ZodDefault<z.ZodEnum<{
-            dimension: "dimension";
-            rowDimension: "rowDimension";
-            columnDimension: "columnDimension";
-        }>>;
         encoding: z.ZodOptional<z.ZodEnum<{
             column: "column";
             xAxis: "xAxis";
@@ -57,10 +52,12 @@ export declare const zPivotTable: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";