@visactor/vseed 0.1.7 → 0.1.8

package/dist/pipeline/advanced/chart/pipes/encoding/bar.d.ts

@@ -1,21 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 条形图、堆叠条形图、并列条形图、百分比条形图
- * 维度未包含任何`encoding`, 则使用默认映射规则:
- * 1. y: 第一个维度映射至Y轴
- * 2. color: 非`Y`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
- * 3. detail: 非`Y`轴所有维度与指标名称, 映射至Detail通道
- * 指标未包含任何`encoding`, 则使用默认映射规则:
- * 1. x: 全部指标映射至`X`轴
- * 2. tooltip: 全部指标映射至`Tooltip`
- *
- * 维度映射规则:
- * 1. 用户指定的`yAxis`维度映射至Y轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至Y轴
- * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
- * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
- * 指标映射规则:
- * 1. 指标未配置`encoding`, 则默认映射至Y轴;
- * 2. 用户指定的`xAxis`指标映射至`X`轴, 支持多个指标;
- * 3. 所有指标均映射到`Tooltip`
- */
+export declare const defaultEncodingForBar: AdvancedPipe;
 export declare const encodingForBar: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/column.d.ts

@@ -1,21 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 堆叠柱状图、并列柱状图、百分比柱状图
- * 维度未包含任何`encoding`, 则使用默认映射规则:
- * 1. x: 第一个维度映射至X轴
- * 2. color: 非`X`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
- * 3. detail: 非`X`轴所有维度与指标名称, 映射至Detail通道
- * 指标未包含任何`encoding`, 则使用默认映射规则:
- * 1. y: 全部指标映射至Y轴
- * 2. tooltip: 全部指标映射至Tooltip
- *
- * 维度映射规则:
- * 1. 用户指定的`xAxis`维度映射至X轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至X轴
- * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
- * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
- * 指标映射规则:
- * 1. 指标未配置`encoding`, 则默认映射至Y轴;
- * 2. 用户指定的`yAxis`指标映射至Y轴, 支持多个指标;
- * 3. 所有指标均映射到Tooltip
- */
+export declare const defaultEncodingForColumn: AdvancedPipe;
 export declare const encodingForColumn: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/dualAxis.d.ts

@@ -1,21 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 双轴图
- * 维度未包含任何`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
- */
+export declare const defaultEncodingForDualAxis: AdvancedPipe;
 export declare const encodingForDualAxis: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/encodingAdapter.d.ts

@@ -0,0 +1,2 @@
+import type { AdvancedPipe, AdvancedPipeline } from '../../../../../types';
+export declare const encodingAdapter: (noEncodingPipeline: AdvancedPipeline, hasEncodingPipeline: AdvancedPipeline) => AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/funnel.d.ts

@@ -1,19 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 漏斗图
- * 维度未包含任何`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
- */
+export declare const defaultEncodingForFunnel: AdvancedPipe;
 export declare const encodingForFunnel: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/heatmap.d.ts

@@ -1,21 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 热力图
- * 维度未包含任何`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
- */
+export declare const defaultEncodingForHeatmap: AdvancedPipe;
 export declare const encodingForHeatmap: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/index.d.ts

@@ -1,9 +1,11 @@
-export { encodingForColumn } from './column';
-export { encodingForBar } from './bar';
-export { encodingForPie } from './pie';
-export { encodingForDualAxis } from './dualAxis';
-export { encodingForFunnel } from './funnel';
-export { encodingForHeatmap } from './heatmap';
-export { encodingForRadar } from './radar';
-export { encodingForScatter } from './scatter';
-export { encodingForLine } from './line';
+export { encodingForColumn, defaultEncodingForColumn } from './column';
+export { encodingForBar, defaultEncodingForBar } from './bar';
+export { encodingForPie, defaultEncodingForPie } from './pie';
+export { encodingForDualAxis, defaultEncodingForDualAxis } from './dualAxis';
+export { encodingForFunnel, defaultEncodingForFunnel } from './funnel';
+export { encodingForHeatmap, defaultEncodingForHeatmap } from './heatmap';
+export { encodingForRadar, defaultEncodingForRadar } from './radar';
+export { encodingForScatter, defaultEncodingForScatter } from './scatter';
+export { encodingForLine, defaultEncodingForLine } from './line';
+export { encodingForRose, defaultEncodingForRose } from './rose';
+export { encodingAdapter } from './encodingAdapter';

package/dist/pipeline/advanced/chart/pipes/encoding/line.d.ts

@@ -1,20 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 折线图、堆叠面积图、百分比面积图
- * 维度未包含任何encoding, 则使用默认映射规则:
- * 1. x: 第一个维度映射至X轴
- * 2. color: 其余所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
- * 指标未包含任何encoding, 则使用默认映射规则:
- * 1. y: 全部指标映射至Y轴
- * 2. tooltip: 全部指标映射至Tooltip
- *
- * 维度映射规则:
- * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至X轴
- * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
- * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
- * 指标映射规则:
- * 1. 指标未配置encoding, 则默认映射至Y轴;
- * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
- * 3. 所有指标均映射到Tooltip
- */
+export declare const defaultEncodingForLine: AdvancedPipe;
 export declare const encodingForLine: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/pie.d.ts

@@ -1,20 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 饼图、环形图
- * 维度未包含任何`encoding`, 则使用默认映射规则:
- * 1. color: 所有维度, 合并映射至颜色通道, 作为图例展示
- * 2. detail: 所有维度, 映射至Detail通道
- * 指标未包含任何`encoding`, 则使用默认映射规则:
- * 1. angle: 全部指标映射至angle轴
- * 2. tooltip: 全部指标映射至Tooltip
- *
- * 维度映射规则:
- * 1. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
- * 2. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
- * 指标映射规则:
- * 1. 指标未配置`encoding`, 则默认映射至angle轴;
- * 2. 用户指定的`angle`指标映射至angle轴, 支持多个指标;
- * 3. 用户指定的`color`指标映射至color通道, 支持多个指标;
- * 3. 所有指标均映射到Tooltip
- */
+export declare const defaultEncodingForPie: AdvancedPipe;
 export declare const encodingForPie: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/radar.d.ts

@@ -1,21 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 雷达图
- * 维度未包含任何`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
- */
+export declare const defaultEncodingForRadar: AdvancedPipe;
 export declare const encodingForRadar: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/rose.d.ts

@@ -1,21 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 堆叠玫瑰图、并列玫瑰图
- * 维度未包含任何`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
- */
+export declare const defaultEncodingForRose: AdvancedPipe;
 export declare const encodingForRose: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/encoding/scatter.d.ts

@@ -1,20 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 散点图
- * 维度未包含任何`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
- */
+export declare const defaultEncodingForScatter: AdvancedPipe;
 export declare const encodingForScatter: AdvancedPipe;

package/dist/pipeline/advanced/chart/pipes/measures/utils.d.ts

@@ -1,4 +1,4 @@
-import type { AdvancedVSeed, VSeed } from '../../../../../types';
+import type { AdvancedVSeed, MeasureGroup, MeasureTree, VSeed } from '../../../../../types';
 /**
  * @description 检查是否为指标树, 指标树深度大于1. 如果存在一个指标为组, 即有children配置, 则认为是指标树.
  * @param vseed vseed
@@ -11,3 +11,9 @@ export declare const isMeasureTreeWithChildren: (vseed: VSeed | AdvancedVSeed) =
  * @returns
  */
 export declare const isMeasureTreeWithParentId: (vseed: VSeed | AdvancedVSeed) => boolean;
+/**
+ * @description 保证指标树中的每一组都有children, 没有children的指标, 会被放到一个默认的指标组中.
+ * @param measures 指标树
+ * @returns
+ */
+export declare const normalizeMeasureTree: (measures: MeasureTree) => MeasureGroup[];

package/dist/pipeline/spec/chart/pipes/tooltip/index.d.ts

@@ -1,2 +1,4 @@
 export { tooltip } from './tooltip';
 export { tooltipPrimary, tooltipSecondary } from './tooltipDualAxis';
+export { tooltipScatter } from './tooltipScatter';
+export { tooltipHeatmap } from './tooltipHeatmap';

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

@@ -1,2 +1,22 @@
-import type { SpecPipe } from '../../../../../types';
+import type { Dimensions, FoldInfo, Locale, Measures, SpecPipe, UnfoldInfo } from '../../../../../types';
 export declare const tooltip: SpecPipe;
+export declare const createDimensionContent: (measures: Measures, foldInfo: FoldInfo, unfoldInfo: UnfoldInfo, locale: Locale) => {
+    visible: boolean;
+    shapeType: string;
+    hasShape: boolean;
+    key: (v: unknown) => string;
+    value: (v: unknown) => string;
+}[];
+export declare const createMarkContent: (tooltip: string[], dimensions: Dimensions, measures: Measures, locale: Locale, foldInfo: FoldInfo, unfoldInfo: UnfoldInfo) => ({
+    visible: boolean;
+    hasShape: boolean;
+    shapeType: string;
+    key: (v: unknown) => string;
+    value: (v: unknown) => string;
+} | {
+    visible: boolean;
+    hasShape: boolean;
+    shapeType: string;
+    key: string;
+    value: (v: unknown) => string;
+})[];

package/dist/pipeline/spec/chart/pipes/tooltip/tooltipHeatmap.d.ts

@@ -0,0 +1,15 @@
+import type { Dimensions, FoldInfo, Locale, Measures, SpecPipe } from '../../../../../types';
+export declare const tooltipHeatmap: SpecPipe;
+export declare const createMarkContent: (tooltip: string[], dimensions: Dimensions, measures: Measures, locale: Locale, foldInfo: FoldInfo) => ({
+    visible: boolean;
+    hasShape: boolean;
+    shapeType: string;
+    key: (v: unknown) => string;
+    value: (v: unknown) => string;
+} | {
+    visible: boolean;
+    hasShape: boolean;
+    shapeType: string;
+    key: string;
+    value: (v: unknown) => string;
+})[];

package/dist/pipeline/spec/chart/pipes/tooltip/tooltipScatter.d.ts

@@ -0,0 +1,15 @@
+import type { Dimensions, FoldInfo, Locale, Measures, SpecPipe } from '../../../../../types';
+export declare const tooltipScatter: SpecPipe;
+export declare const createMarkContent: (tooltip: string[], dimensions: Dimensions, measures: Measures, locale: Locale, foldInfoList: FoldInfo[]) => ({
+    visible: boolean;
+    hasShape: boolean;
+    shapeType: string;
+    key: (v: unknown) => string;
+    value: (v: unknown) => string;
+} | {
+    visible: boolean;
+    hasShape: boolean;
+    shapeType: string;
+    key: string;
+    value: (v: unknown) => string;
+})[];

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

@@ -1,24 +1,16 @@
 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, Encoding } from '../../properties';
+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';
 /**
  * @recommend
  * - 推荐字段配置: `1`个指标, `2`个维度
  * - 支持数据重塑: 至少`1`个指标, `0`个维度
  * @encoding
- * 维度未包含任何encoding, 则使用默认映射规则:
- * 1. x: 第一个维度映射至X轴
- * 2. color: 其余所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
- * 指标未包含任何encoding, 则使用默认映射规则:
- * 1. y: 全部指标映射至Y轴
- * 2. tooltip: 全部指标映射至Tooltip
- *
- * 维度映射规则:
- * 1. 用户指定的xAxis维度映射至X轴, 支持多个维度; 若未指定, 则默认映射第一个维度
- * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认映射指标名称
- * 指标映射规则:
- * 1. 指标未配置encoding, 则默认映射至Y轴;
- * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
- * 3. 所有指标均映射到Tooltip
+ * 面积图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  *
  * @description 面积图, 适用于展示数据随时间变化的趋势及累积关系, 通过填充区域增强数据对比. X轴为类目轴(分类数据), Y轴为数值轴(连续数据).
  * 适用场景:
@@ -55,18 +47,6 @@ export interface Area {
      * @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轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.

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

@@ -1,5 +1,5 @@
 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, Encoding } from '../../properties';
+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 百分比面积图，适用于展示多类别占比随时间变化的趋势，Y轴以百分比形式展示占比关系
  * 适用场景:
@@ -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轴, 支持多个维度; 若未指定, 则默认映射第一个维度
- * 2. 用户指定的color维度映射至颜色通道, 支持多个维度; 若未指定, 则默认映射指标名称
- * 指标映射规则:
- * 1. 指标未配置encoding, 则默认映射至Y轴;
- * 2. 用户指定的yAxis指标映射至Y轴, 支持多个指标;
- * 3. 所有指标均映射到Tooltip
+ * 百分比面积图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -47,18 +39,6 @@ export interface AreaPercent {
      * @example [{month:'1月', category:'A', value:30}, {month:'1月', 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/bar/bar.d.ts

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { Encoding, MeasureTree, Sort, SortLegend } from '../../properties';
+import type { MeasureTree, Sort, SortLegend } from '../../properties';
 import { type AnnotationArea, type AnnotationHorizontalLine, type AnnotationPoint, type AnnotationVerticalLine, type BackgroundColor, type BarStyle, type Color, type CrosshairRect, type Dataset, type Dimensions, type Label, type Legend, type StackCornerRadius, type Theme, type Tooltip, type XLinearAxis, type YBandAxis } from '../../properties';
 /**
  * @description 条形图，适用于横向数据对比场景，Y轴为类目轴（分类数据），X轴为数值轴（连续数据），柱子横向排列
@@ -8,22 +8,13 @@ import { type AnnotationArea, type AnnotationHorizontalLine, type AnnotationPoin
  * - 需要展示数据排名对比
  * - 展示正负双向数据
  * @encoding
- * 维度未包含任何`encoding`, 则使用默认映射规则:
- * 1. y: 第一个维度映射至Y轴
- * 2. color: 非`Y`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
- * 3. detail: 非`Y`轴所有维度与指标名称, 映射至Detail通道
- * 指标未包含任何`encoding`, 则使用默认映射规则:
- * 1. x: 全部指标映射至`X`轴
- * 2. tooltip: 全部指标映射至`Tooltip`
- *
- * 维度映射规则:
- * 1. 用户指定的`yAxis`维度映射至Y轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至Y轴
- * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
- * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
- * 指标映射规则:
- * 1. 指标未配置`encoding`, 则默认映射至Y轴;
- * 2. 用户指定的`xAxis`指标映射至`X`轴, 支持多个指标;
- * 3. 所有指标均映射到`Tooltip`
+ * 条形图支持以下视觉通道:
+ * `yAxis`  : y轴通道, 支持`多个维度`, 按维度值映射至y轴
+ * `xAxis`  : x轴通道, 支持`多个指标`, 按指标值映射至x轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标（度量）
@@ -48,18 +39,6 @@ export interface Bar {
      * @example [{date:'2020-01-01', value:100}, {date:'2020-01-02', value:200}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 条形图的视觉通道, 包括: y通道, color通道, detail通道, label通道, tooltip通道
-     * - y: 映射到Y轴的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - x: measures会直接映射到X轴通道
-     */
-    encoding?: Pick<Encoding, 'y' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * @description 维度, 第一个维度被映射到Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
      * @type {Dimensions}

package/dist/types/chartType/barParallel/barParallel.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, XLinearAxis, YBandAxis, MeasureTree, Sort, SortLegend, Encoding } from '../../properties';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XLinearAxis, YBandAxis, MeasureTree, Sort, SortLegend } from '../../properties';
 /**
  * @description 并列条形图，适用于多指标横向并行对比场景，多个条形平行排列展示不同指标值
  * 适用场景:
@@ -7,22 +7,13 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 排名与数值同时展示的横向比较
  * - 多维度数据的并列分析
  * @encoding
- * 维度未包含任何`encoding`, 则使用默认映射规则:
- * 1. y: 第一个维度映射至Y轴
- * 2. color: 非`Y`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
- * 3. detail: 非`Y`轴所有维度与指标名称, 映射至Detail通道
- * 指标未包含任何`encoding`, 则使用默认映射规则:
- * 1. x: 全部指标映射至`X`轴
- * 2. tooltip: 全部指标映射至`Tooltip`
- *
- * 维度映射规则:
- * 1. 用户指定的`yAxis`维度映射至Y轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至Y轴
- * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
- * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
- * 指标映射规则:
- * 1. 指标未配置`encoding`, 则默认映射至Y轴;
- * 2. 用户指定的`xAxis`指标映射至`X`轴, 支持多个指标;
- * 3. 所有指标均映射到`Tooltip`
+ * 并列条形图支持以下视觉通道:
+ * `yAxis`  : y轴通道, 支持`多个维度`, 按维度值映射至y轴
+ * `xAxis`  : x轴通道, 支持`多个指标`, 按指标值映射至x轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -47,18 +38,6 @@ export interface BarParallel {
      * @example [{category:'A', value1:100, value2:200}, {category:'B', value1:150, value2:250}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 并列条形图的视觉通道, 包括: y通道, color通道, detail通道, label通道, tooltip通道
-     * - y: 映射到Y轴的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - x: measures会直接映射到X轴通道
-     */
-    encoding?: Pick<Encoding, 'y' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * @description 维度, 第一个维度被映射到Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
      * @type {Dimensions}

package/dist/types/chartType/barPercent/barPercent.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, XLinearAxis, YBandAxis, MeasureTree, Sort, SortLegend, Encoding } from '../../properties';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XLinearAxis, YBandAxis, MeasureTree, Sort, SortLegend } from '../../properties';
 /**
  * @description 百分比条形图，适用于横向展示各类别占比关系的场景，X轴以百分比形式展示数据占比
  * 适用场景:
@@ -7,22 +7,13 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 多维度数据的横向构成分析
  * - 排名与占比同时展示的场景
  * @encoding
- * 维度未包含任何`encoding`, 则使用默认映射规则:
- * 1. y: 第一个维度映射至Y轴
- * 2. color: 非`Y`轴所有维度与指标名称, 合并映射至颜色通道, 作为图例展示
- * 3. detail: 非`Y`轴所有维度与指标名称, 映射至Detail通道
- * 指标未包含任何`encoding`, 则使用默认映射规则:
- * 1. x: 全部指标映射至`X`轴
- * 2. tooltip: 全部指标映射至`Tooltip`
- *
- * 维度映射规则:
- * 1. 用户指定的`yAxis`维度映射至Y轴, 支持多个维度; 若未指定, 则默认将第一个维度映射至Y轴
- * 2. 用户指定的`color`维度映射至颜色通道, 支持多个维度; 若未指定, 则默认将指标名称映射至颜色通道, 作为图例展示
- * 3. 用户指定的`detail`维度映射至Detail通道, 支持多个维度; 若未指定, 则默认将指标名称映射至Detail通道
- * 指标映射规则:
- * 1. 指标未配置`encoding`, 则默认映射至Y轴;
- * 2. 用户指定的`xAxis`指标映射至`X`轴, 支持多个指标;
- * 3. 所有指标均映射到`Tooltip`
+ * 百分比条形图支持以下视觉通道:
+ * `yAxis`  : y轴通道, 支持`多个维度`, 按维度值映射至y轴
+ * `xAxis`  : x轴通道, 支持`多个指标`, 按指标值映射至x轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个维度字段和1个度量字段
@@ -47,18 +38,6 @@ export interface BarPercent {
      * @example [{category:'A', value:30}, {category:'B', value:70}]
      */
     dataset: Dataset;
-    /**
-     * @description 编码配置, 百分比条形图的视觉通道, 包括: y通道, color通道, detail通道, label通道, tooltip通道
-     * - y: 映射到Y轴的字段, 支持放入多个维度
-     * - detail: 细分映射通道, 支持放入多个维度
-     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
-     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
-     * - label: 标签映射通道, 支持放入 多个维度 或 多个指标
-     *
-     * @tip 特殊的:
-     * - x: measures会直接映射到X轴通道
-     */
-    encoding?: Pick<Encoding, 'y' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * @description 维度, 第一个维度会放至Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
      * @type {Dimensions}