@visactor/vseed 0.1.7 → 0.1.8

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

@@ -1,5 +1,5 @@
 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';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend } from '../../properties';
 /**
  * @description 柱状图，适用于纵向数据对比场景，X轴为类目轴（分类数据），Y轴为数值轴（连续数据），柱子纵向排列
  * 适用场景:
@@ -7,22 +7,13 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 需要直观比较不同类别的数值大小
  * - 展示时间序列数据变化趋势
  * @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
+ * 柱状图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）
@@ -47,18 +38,6 @@ export interface Column {
      * @example [{category:'A', value:100}, {category:'B', value:200}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 堆叠柱状图的视觉通道, 包括: x通道, color通道, detail通道, label通道, tooltip通道
-     * - x: 映射到X轴的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - y: measures会直接映射到Y轴通道
-     */
-    encoding?: Pick<Encoding, 'x' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * @description 柱状图的第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示
      * @type {Dimensions}

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

@@ -1,5 +1,5 @@
 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';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, SortLegend, Sort } from '../../properties';
 /**
  * @description 并列柱状图，适用于多指标并行对比场景，多个柱子并列排列展示不同指标值
  * 适用场景:
@@ -7,22 +7,13 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 多维度数据的横向比较
  * - 指标间关联性分析
  * @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
+ * 并列柱状图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -45,18 +36,6 @@ export interface ColumnParallel {
      * @example [{category:'A', value1:100, value2:200}, {category:'B', value1:150, value2:250}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 并列柱状图的视觉通道, 包括: x通道, color通道, detail通道, label通道, tooltip通道
-     * - x: 映射到X轴的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - y: measures会直接映射到Y轴通道
-     */
-    encoding?: Pick<Encoding, 'x' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * @description 维度, 第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
      * @type {Dimensions}
@@ -66,7 +45,7 @@ export interface ColumnParallel {
     /**
      * @description 指标, 并列柱状图的所有指标会自动合并为一个指标, 映射到Y轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
      * @type {DimensionTree}
-     * @example [{id: 'value1', alias: '指标1'}, {id: 'value2', alias: '指标2'}]
+   Axis  * @example [{id: 'value1', alias: '指标1'}, {id: 'value2', alias: '指标2'}]
      */
     measures?: MeasureTree;
     /**

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

@@ -1,5 +1,5 @@
 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';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend } from '../../properties';
 /**
  * @description 百分比柱状图，适用于展示各类别占比关系的场景，Y轴以百分比形式展示数据占比
  * 适用场景:
@@ -7,22 +7,13 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 多维度数据的构成分析
  * - 时间序列的占比变化趋势
  * @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
+ * 百分比柱状图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -49,18 +40,6 @@ export interface ColumnPercent {
      * @example [{category:'A', value:30}, {category:'B', value:70}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 百分比柱状图的视觉通道, 包括: x通道, color通道, detail通道, label通道, tooltip通道
-     * - x: 映射到X轴的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - y: measures会直接映射到Y轴通道
-     */
-    encoding?: Pick<Encoding, 'x' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.

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

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { BackgroundColor, Color, Dataset, Dimensions, Encoding, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
+import type { BackgroundColor, Color, Dataset, Dimensions, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
 /**
  * @description 环形图，适用于展示单一维度数据的占比关系，中心留有空白区域可展示汇总信息
  * 适用场景:
@@ -7,21 +7,12 @@ import type { BackgroundColor, Color, Dataset, Dimensions, Encoding, Label, Lege
  * - 强调数据的整体与部分关系
  * - 中心区域需要展示关键指标或标题
  * @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
+ * 环形图支持以下视觉通道:
+ * `angle`  : 角度通道, 支持`多个指标`, 按指标值映射至扇形角度
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -48,17 +39,6 @@ export interface Donut {
      * @example [{category:'A', value:30}, {category:'B', value:70}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 环形图的视觉通道, 包括: color通道, detail通道, label通道, tooltip通道
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - angle: measures会直接映射到角度通道
-     */
-    encoding?: Pick<Encoding, 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 环形图的所有维度会与指标名称(存在多个指标时)合并成1个维度, 映射到饼图的角度, 并作为图例项展示.

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

@@ -1,5 +1,5 @@
 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';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, AreaStyle, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, DualChartType, DualMeasures, Label, Legend, LineStyle, MeasureTree, PointStyle, Sort, SortLegend, Theme, Tooltip, YLinearAxis } from '../../properties';
 /**
  * @description 双轴图，适用于展示两个不同量级或不同单位指标的对比关系，包含主坐标轴和次坐标轴
  * 适用场景:
@@ -8,22 +8,14 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 需要同时展示数值和增长率等复合指标
  * - 支持不同类型图表组合（如折线图+柱状图/ 折线图+面积图/ 面积图+柱状图）
  * @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
+ * 双轴图支持以下视觉通道:
+ * `xAxis`          : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `primaryYAxis`   : 主轴y轴通道, 支持`多个指标`, 将指标映射至主轴
+ * `secondaryYAxis` : 次轴y轴通道, 支持`多个指标`, 将指标映射至次轴
+ * `detail`         : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`          : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`        : 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`          : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -47,18 +39,6 @@ export interface DualAxis {
      * @example [{month:'1月', value:100, growth:0.2}, {month:'2月', value:150, growth:0.5}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 双轴图的视觉通道, 包括: x通道, color通道, detail通道, label通道, tooltip通道
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - primaryY: measures会直接映射到主Y轴通道
-     * - secondaryY: measures会直接映射到次Y轴通道
-     */
-    encoding?: Pick<Encoding, 'x' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * @description 维度, 第一个维度会放至X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
      * @example [{id: 'month', alias: '月份'}]

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

@@ -1,25 +1,17 @@
 import type { Locale } from '../../i18n';
-import type { BackgroundColor, ColorLegend, Dataset, Dimensions, Encoding, Label, LinearColor, MeasureTree, Theme, Tooltip } from '../../properties';
+import type { BackgroundColor, ColorLegend, Dataset, Dimensions, 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
+ * 漏斗图支持以下视觉通道:
+ * `size`   : 大小通道, 支持`多个指标`, 按指标值映射至漏斗宽度
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个数值字段（指标）
@@ -46,17 +38,6 @@ export interface Funnel {
      * @example [{category:'A', value:30}, {category:'B', value:70}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置,漏斗图的视觉通道, 包括: color通道, detail通道, label通道, tooltip通道
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - size: measures会直接映射到尺寸通道
-     */
-    encoding?: Pick<Encoding, 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 漏斗图的所有维度会与指标名称(存在多个指标时)合并成一个维度,并作为图例项展示

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

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { ColorLegend, Encoding, LinearColor, MeasureTree } from '../../properties';
+import type { ColorLegend, LinearColor, MeasureTree } from '../../properties';
 import { type BackgroundColor, type Dataset, type Dimensions, type Label, type Theme, type Tooltip } from '../../properties';
 /**
  * @description 热力图，通过二维矩阵的颜色深浅展示数据的分布和强弱关系
@@ -8,22 +8,13 @@ import { type BackgroundColor, type Dataset, type Dimensions, type Label, type T
  * - 分类与数值的关联分析
  * - 时间序列与类别的交叉对比
  * @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
+ * 热力图支持以下视觉通道:
+ * `xAxis`      : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`      : y轴通道, 支持`多个维度`, 按维度值映射至y轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`一个指标`, 按指标值映射至颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少2个维度字段，用于确定热力图的行和列
@@ -50,18 +41,6 @@ export interface Heatmap {
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 热力图的视觉通道, 包括: x通道, y通道, color通道, label通道, tooltip通道
-     * - x: x轴映射通道, 支持放入多个维度
-     * - y: y轴映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - value: measures会直接映射到数值通道
-     */
-    encoding?: Pick<Encoding, 'color' | 'x' | 'y' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 热力图的第一个维度被映射到角度轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.

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

@@ -1,5 +1,5 @@
 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';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, CrosshairLine, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend } from '../../properties';
 /**
  * @description 折线图，适用于展示数据随时间或有序类别变化的趋势，通过线段连接数据点形成趋势线
  * 适用场景:
@@ -7,20 +7,12 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 比较多个数据系列的趋势对比
  * - 分析数据的增长或下降规律
  * @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
+ * 折线图支持以下视觉通道:
+ * `x`      : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `y`      : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）
@@ -45,18 +37,6 @@ export interface Line {
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 折线图的视觉通道, 包括: x通道, color通道, detail通道, label通道, tooltip通道
-     * - x: 映射到X轴的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - y: measures会直接映射到Y轴通道
-     */
-    encoding?: Pick<Encoding, 'x' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * @description 维度, 折线图的第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示
      * @type {Dimensions}

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

@@ -1,5 +1,5 @@
 import type { Locale } from '../../i18n';
-import type { BackgroundColor, Color, Dataset, Dimensions, Encoding, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
+import type { BackgroundColor, Color, Dataset, Dimensions, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
 /**
  * @description 饼图，适用于展示单一维度数据的占比关系，通过扇形面积大小表示各类别占比
  * 适用场景:
@@ -7,21 +7,12 @@ import type { BackgroundColor, Color, Dataset, Dimensions, Encoding, Label, Lege
  * - 强调数据的整体与部分关系
  * - 类别数量较少（建议不超过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
+ * 饼图支持以下视觉通道:
+ * `angle`  : 角度通道, 支持`多个指标`, 按指标值映射至扇形角度
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）
@@ -48,17 +39,6 @@ export interface Pie {
      * @example [{category:'A', value:30}, {category:'B', value:70}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 饼图的视觉通道, 包括: color通道, detail通道, label通道, tooltip通道
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - angle: measures会直接映射到角度通道
-     */
-    encoding?: Pick<Encoding, 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 饼图的所有维度会与指标名称(存在多个指标时)合并成一个维度, 映射到角度, 并作为图例项展示

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

@@ -8,13 +8,10 @@ import { type BackgroundColor, type Dataset, type Dimensions, type Theme } from
  * - 数据钻取与聚合展示
  * - 业务报表生成与数据探索
  * @encoding
- * 则使用默认映射规则:
- * - 维度与指标名称, 交替映射到列维度和行维度
- * - 指标默认映射到detail通道
- *
- * 存在`encoding`配置:
- * - 用户指定的`row`与`column`维度, 精准映射到行维度与列维度, 若未指定row和column, 则交替映射到列维度和行维度
- * - 用户指定的`detail`指标, 精准映射到detail通道, 若未指定detail, 则依旧映射到detail通道
+ * 透视表支持以下视觉通道:
+ * `row`    : 行维度, 支持`多个维度`, 按维度值在行上进行分组
+ * `column` : 列维度, 支持`多个维度`, 按维度值在列上进行分组
+ * `detail` : 细分通道, 支持`多个指标`, 在单元格中展示指标值
  * @warning
  * 数据要求:
  * - 至少1个行维度 或 1个列维度 或 1个指标

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

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { AreaStyle, Encoding, LineStyle, MeasureTree, PointStyle } from '../../properties';
+import type { AreaStyle, 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 雷达图，适用于多维度数据的对比分析，通过多轴坐标系展示各维度的数值分布
@@ -8,22 +8,12 @@ import { type BackgroundColor, type Color, type Dataset, type Dimensions, type L
  * - 多个对象在多个指标上的性能评估
  * - 分类数据的多维度特征展示
  * @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
+ * 雷达图支持以下视觉通道:
+ * `angle`  : 角度通道, 支持`多个维度`, 按维度值映射至角度轴
+ * `radius` : 半径通道, 支持`多个指标`, 按指标值映射至半径轴
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）
@@ -50,18 +40,6 @@ export interface Radar {
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 雷达图的视觉通道, 包括: angle通道, color通道, detail通道, label通道, tooltip通道
-     * - angle: 映射到角度的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - radius: measures会直接映射到半径通道
-     */
-    encoding?: Pick<Encoding, 'angle' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 雷达图的第一个维度被映射到角度轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.