@visactor/vseed 0.1.6 → 0.1.7

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";

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";

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";

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

@@ -1,11 +1,12 @@
 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
- * 折线图，适用于展示数据随时间或有序类别变化的趋势，通过线段连接数据点形成趋势线
- * @info
- * Encoding规则
+ * @description 折线图，适用于展示数据随时间或有序类别变化的趋势，通过线段连接数据点形成趋势线
+ * 适用场景:
+ * - 展示时间序列数据的变化趋势
+ * - 比较多个数据系列的趋势对比
+ * - 分析数据的增长或下降规律
+ * @encoding
  * 维度未包含任何encoding, 则使用默认映射规则:
  * 1. x: 第一个维度映射至X轴
  * 2. color: 其余所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
@@ -14,18 +15,13 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * 2. tooltip: 全部指标映射至Tooltip
  *
  * 维度映射规则:
- * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认映射第一个维度
- * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认映射指标名称
+ * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至X轴
+ * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
  * 指标映射规则:
  * 1. 指标未配置encoding, 则默认映射至Y轴;
  * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
  * 3. 所有指标均映射到Tooltip
  * @warning
- * 适用场景:
- * - 展示时间序列数据的变化趋势
- * - 比较多个数据系列的趋势对比
- * - 分析数据的增长或下降规律
- * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）
  * - 第一个维度会放至X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示

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";

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";

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";

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

@@ -2,12 +2,28 @@ import { type Locale } from '../../i18n';
 import type { AreaStyle, Encoding, LineStyle, MeasureTree, PointStyle } from '../../properties';
 import { type BackgroundColor, type Color, type Dataset, type Dimensions, type Label, type Legend, type Theme, type Tooltip } from '../../properties';
 /**
- * 雷达图类型定义
  * @description 雷达图，适用于多维度数据的对比分析，通过多轴坐标系展示各维度的数值分布
  * 适用场景:
  * - 多维度数据的综合表现对比
  * - 多个对象在多个指标上的性能评估
  * - 分类数据的多维度特征展示
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. angle: 第一个维度映射至angle轴
+ * 2. color: 非`Angle`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 3. detail: 非`Angle`轴所有维度与指标名称, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. radius: 全部指标映射至radius轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的`angle`维度映射至angle轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至angle轴
+ * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置`encoding`, 则默认映射至radius轴;
+ * 2. 用户指定的`radius`指标映射至radius轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）

package/dist/types/chartType/radar/zRadar.d.ts

@@ -19,11 +19,6 @@ export declare const zRadar: 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";

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

@@ -2,12 +2,28 @@ import { type Locale } from '../../i18n';
 import type { Encoding, MeasureTree } from '../../properties';
 import { type BackgroundColor, type Color, type Dataset, type Dimensions, type Label, type Legend, type Theme, type Tooltip } from '../../properties';
 /**
- * 堆叠玫瑰图类型定义
  * @description 堆叠玫瑰图，适用于多维度数据对比场景，通过极坐标系下的扇形弧度和半径展示数据大小
  * 适用场景:
  * - 多维度数据的分布对比
  * - 周期性数据的强弱比较
  * - 分类数据的数值与占比同时展示
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. angle: 第一个维度映射至angle轴
+ * 2. color: 非`angle`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 3. detail: 非`angle`轴所有维度与指标名称, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. radius: 全部指标映射至radius轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的`angle`维度映射至angle轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至angle轴
+ * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置`encoding`, 则默认映射至Y轴;
+ * 2. 用户指定的`radius`指标映射至radius轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）

package/dist/types/chartType/rose/zRose.d.ts

@@ -19,11 +19,6 @@ export declare const zRose: 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";

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

@@ -2,12 +2,28 @@ import { type Locale } from '../../i18n';
 import type { Encoding, MeasureTree } from '../../properties';
 import { type BackgroundColor, type Color, type Dataset, type Dimensions, type Label, type Legend, type Theme, type Tooltip } from '../../properties';
 /**
- * 分组玫瑰图类型定义
  * @description 分组玫瑰图，适用于多维度数据对比场景，通过极坐标系下的扇形弧度和半径展示数据大小
  * 适用场景:
  * - 多维度数据的分布对比
  * - 周期性数据的强弱比较
  * - 分类数据的数值与占比同时展示
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. angle: 第一个维度映射至angle轴
+ * 2. color: 非`angle`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 3. detail: 非`angle`轴所有维度与指标名称, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. radius: 全部指标映射至radius轴
+ * 2. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 1. 用户指定的`angle`维度映射至angle轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至angle轴
+ * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置`encoding`, 则默认映射至Y轴;
+ * 2. 用户指定的`radius`指标映射至radius轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）

package/dist/types/chartType/roseParallel/zRoseParallel.d.ts

@@ -19,11 +19,6 @@ export declare const zRoseParallel: 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";

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

@@ -1,10 +1,25 @@
 import type { Locale } from '../../i18n';
 import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, PointStyle, Theme, Tooltip, CrosshairLine, YLinearAxis, XLinearAxis, MeasureTree, Encoding, ScatterMeasures } from '../../properties';
 /**
- * 散点图类型定义
  * @description 散点图，适用于展示数据的分布情况，通过点的位置表示数据的数值
  * 适用场景:
  * - 分析数据的分布特征, 如数据的中心趋势, 分布范围, 异常值等
+ * @encoding
+ * 维度未包含任何`encoding`, 则使用默认映射规则:
+ * 1. color: 所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
+ * 2. detail: 所有维度与指标名称, 映射至Detail通道
+ * 指标未包含任何`encoding`, 则使用默认映射规则:
+ * 1. x: 第一个指标映射至X轴
+ * 2. y: 第二个及其之后的指标映射至Y轴
+ * 3. tooltip: 全部指标映射至Tooltip
+ *
+ * 维度映射规则:
+ * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
+ * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
+ * 指标映射规则:
+ * 1. 指标未配置encoding, 则第一个指标默认映射至X轴, 第二个指标默认映射至Y轴
+ * 2. 用户指定的yAxis指标映射至Y轴X轴, 支持多个指标;
+ * 3. 所有指标均映射到Tooltip
  * @warning
  * 数据要求:
  * - 至少2个数值字段（度量）

package/dist/types/chartType/scatter/zScatter.d.ts

@@ -19,11 +19,6 @@ export declare const zScatter: 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";

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

@@ -7,6 +7,8 @@ import { type BackgroundColor, type Dataset, type Theme } from '../../properties
  * - 需要展示详细数据明细
  * - 数据项需要精确比对
  * - 展示多维度数据属性
+ * @encoding
+ * 仅支持配置维度树与指标树, 默认encoding到column
  * @warning
  * 数据要求:
  * - 至少1个维度字段

package/dist/types/chartType/table/zTable.d.ts

@@ -5,11 +5,6 @@ export declare const zTable: 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";

package/dist/types/properties/dimensions/dimensions.d.ts

@@ -4,10 +4,6 @@
 export type Dimension = {
     id: string;
     alias?: string;
-    /**
-     * @deprecated 请使用 encoding 代替
-     */
-    location?: 'dimension' | 'rowDimension' | 'columnDimension';
     /**
      * @description 维度映射的通道
      * - x: 支持将多个维度映射到x轴, 支持柱状图、折线图、面积图等

package/dist/types/properties/dimensions/zDimensions.d.ts

@@ -3,11 +3,6 @@ import type { DimensionGroup } from './dimensions';
 export declare const zDimension: 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";
@@ -24,11 +19,6 @@ export declare const zDimensionGroup: z.ZodType<DimensionGroup>;
 export declare const zDimensions: 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";
@@ -44,11 +34,6 @@ export declare const zDimensions: z.ZodArray<z.ZodObject<{
 export declare const zDimensionTree: z.ZodArray<z.ZodUnion<[z.ZodType<DimensionGroup, unknown, z.core.$ZodTypeInternals<DimensionGroup, unknown>>, 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";