@visactor/vseed 0.1.6 → 0.1.8

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

@@ -1,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+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: 其余所有维度映射至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
- */
+export declare const defaultEncodingForColumn: AdvancedPipe;
 export declare const encodingForColumn: AdvancedPipe;

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

@@ -1,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+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,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+export declare const defaultEncodingForFunnel: AdvancedPipe;
 export declare const encodingForFunnel: AdvancedPipe;

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

@@ -1,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+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,19 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
-/**
- * @description 折线图、堆叠面积图、百分比面积图
- * 维度未包含任何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
- */
+export declare const defaultEncodingForLine: AdvancedPipe;
 export declare const encodingForLine: AdvancedPipe;

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

@@ -1,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+export declare const defaultEncodingForPie: AdvancedPipe;
 export declare const encodingForPie: AdvancedPipe;

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

@@ -1,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+export declare const defaultEncodingForRadar: AdvancedPipe;
 export declare const encodingForRadar: AdvancedPipe;

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

@@ -1,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+export declare const defaultEncodingForRose: AdvancedPipe;
 export declare const encodingForRose: AdvancedPipe;

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

@@ -1,2 +1,3 @@
 import type { AdvancedPipe } from '../../../../../types';
+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/advanced/table/pipes/{init/autoDimensions.d.ts → default/defaultDimensions.d.ts}

@@ -1,2 +1,2 @@
 import type { AdvancedPipe } from '../../../../../types';
-export declare const autoDimensions: AdvancedPipe;
+export declare const defaultDimensions: AdvancedPipe;

package/dist/pipeline/advanced/table/pipes/{init/autoMeasures.d.ts → default/defaultMeasureName.d.ts}

@@ -1,2 +1,2 @@
 import type { AdvancedPipe } from '../../../../../types';
-export declare const autoMeasures: AdvancedPipe;
+export declare const defaultMeasureName: AdvancedPipe;

package/dist/pipeline/advanced/table/pipes/default/defaultMeasures.d.ts

@@ -0,0 +1,5 @@
+import type { AdvancedPipe } from '../../../../../types';
+/**
+ * @description 如果用户没有配置 measures, 则基于 dataset 构建默认的 measures
+ */
+export declare const defaultMeasures: AdvancedPipe;

package/dist/pipeline/advanced/table/pipes/default/index.d.ts

@@ -0,0 +1,3 @@
+export { defaultMeasures } from './defaultMeasures';
+export { defaultMeasureName } from './defaultMeasureName';
+export { defaultDimensions } from './defaultDimensions';

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

@@ -0,0 +1 @@
+export { encodingForPivotTable } from './pivotTable';

package/dist/pipeline/advanced/table/pipes/{init/autoPivotMeasures.d.ts → encoding/pivotTable.d.ts}

@@ -1,2 +1,2 @@
 import type { AdvancedPipe } from '../../../../../types';
-export declare const autoPivotMeasures: AdvancedPipe;
+export declare const encodingForPivotTable: AdvancedPipe;

package/dist/pipeline/advanced/table/pipes/index.d.ts

@@ -1,3 +1,6 @@
 export * from './init';
 export * from './records';
 export * from './config';
+export * from './default';
+export * from './reshape';
+export * from './encoding';

package/dist/pipeline/advanced/table/pipes/init/index.d.ts

@@ -1,5 +1,2 @@
-export * from './autoMeasures';
-export * from './autoDimensions';
 export * from './autoPivotDimensions';
-export * from './autoPivotMeasures';
 export * from './initAdvancedVSeed';

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/advancedVSeed.d.ts

@@ -56,11 +56,6 @@ export declare const zAdvancedVSeed: z.ZodObject<{
     dimensions: z.ZodArray<z.ZodUnion<[z.ZodType<import("./properties").DimensionGroup, unknown, z.core.$ZodTypeInternals<import("./properties").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";

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

@@ -1,25 +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`个维度
- * @info
- * 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
+ * @encoding
+ * 面积图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  *
  * @description 面积图, 适用于展示数据随时间变化的趋势及累积关系, 通过填充区域增强数据对比. X轴为类目轴(分类数据), Y轴为数值轴(连续数据).
  * 适用场景:
@@ -56,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/area/zArea.d.ts

@@ -19,11 +19,6 @@ export declare const zArea: 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/areaPercent/areaPercent.d.ts

@@ -1,28 +1,18 @@
 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轴以百分比形式展示占比关系
  * 适用场景:
  * - 时间序列的构成变化分析
  * - 多类别占比趋势对比
  * - 累积占比与单一类别占比同时展示
- * @info
- * 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
+ * @encoding
+ * 百分比面积图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -49,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/areaPercent/zAreaPercent.d.ts

@@ -19,11 +19,6 @@ export declare const zAreaPercent: 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/bar/bar.d.ts

@@ -1,13 +1,20 @@
 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轴为数值轴（连续数据），柱子横向排列
  * 适用场景:
  * - 数据项名称较长时
  * - 需要展示数据排名对比
  * - 展示正负双向数据
+ * @encoding
+ * 条形图支持以下视觉通道:
+ * `yAxis`  : y轴通道, 支持`多个维度`, 按维度值映射至y轴
+ * `xAxis`  : x轴通道, 支持`多个指标`, 按指标值映射至x轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标（度量）
@@ -32,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/bar/zBar.d.ts

@@ -19,11 +19,6 @@ export declare const zBar: 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/barParallel/barParallel.d.ts

@@ -1,12 +1,19 @@
 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 并列条形图，适用于多指标横向并行对比场景，多个条形平行排列展示不同指标值
  * 适用场景:
  * - 类别名称较长时的多指标对比
  * - 排名与数值同时展示的横向比较
  * - 多维度数据的并列分析
+ * @encoding
+ * 并列条形图支持以下视觉通道:
+ * `yAxis`  : y轴通道, 支持`多个维度`, 按维度值映射至y轴
+ * `xAxis`  : x轴通道, 支持`多个指标`, 按指标值映射至x轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）
@@ -31,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/barParallel/zBarParallel.d.ts

@@ -19,11 +19,6 @@ export declare const zBarParallel: 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/barPercent/barPercent.d.ts

@@ -1,12 +1,19 @@
 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轴以百分比形式展示数据占比
  * 适用场景:
  * - 类别名称较长时的占比对比
  * - 多维度数据的横向构成分析
  * - 排名与占比同时展示的场景
+ * @encoding
+ * 百分比条形图支持以下视觉通道:
+ * `yAxis`  : y轴通道, 支持`多个维度`, 按维度值映射至y轴
+ * `xAxis`  : x轴通道, 支持`多个指标`, 按指标值映射至x轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
  * @warning
  * 数据要求:
  * - 至少1个维度字段和1个度量字段
@@ -31,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}

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

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

@@ -1,28 +1,19 @@
 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轴为数值轴（连续数据），柱子纵向排列
  * 适用场景:
  * - 数据项名称较短时
  * - 需要直观比较不同类别的数值大小
  * - 展示时间序列数据变化趋势
- * @info
- * 维度未包含任何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
+ * @encoding
+ * 柱状图支持以下视觉通道:
+ * `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/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";