@visactor/vseed 0.0.40 → 0.1.1

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

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zArea: z.ZodObject<{
     chartType: z.ZodLiteral<"area">;
     dataset: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>>>>;
+    encoding: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        y: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        angle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        radius: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        size: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        tooltip: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        row: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        column: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        group: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;

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 } 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, Encoding } from '../../properties';
 /**
  * 百分比面积图类型定义
  * @description 百分比面积图，适用于展示多类别占比随时间变化的趋势，Y轴以百分比形式展示占比关系
@@ -33,6 +33,18 @@ 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

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zAreaPercent: z.ZodObject<{
     chartType: z.ZodLiteral<"areaPercent">;
     dataset: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>>>>;
+    encoding: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        y: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        angle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        radius: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        size: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        tooltip: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        row: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        column: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        group: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;

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

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { MeasureTree, Sort, SortLegend } from '../../properties';
+import type { Encoding, 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';
 /**
  * 条形图类型定义
@@ -10,7 +10,7 @@ import { type AnnotationArea, type AnnotationHorizontalLine, type AnnotationPoin
  * - 展示正负双向数据
  * @warning
  * 数据要求:
- * - 至少1个指标字段（度量）
+ * - 至少1个指标（度量）
  * - 第一个维度会放至Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
  * - 所有指标会自动合并为一个指标
  * 默认开启的功能:
@@ -21,37 +21,44 @@ import { type AnnotationArea, type AnnotationHorizontalLine, type AnnotationPoin
  */
 export interface Bar {
     /**
-     * 条形图
      * @description 条形图，适用于横向数据对比场景，Y轴为类目轴（分类数据），X轴为数值轴（连续数据），柱子横向排列
      * @type {'bar'}
      * @example 'bar'
      */
     chartType: 'bar';
     /**
-     * 数据集
-     * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 条形图的数据最终会被转换为2个维度, 1个指标.
+     * @description 数据源, 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 条形图的数据最终会被转换为2个维度, 1个指标.
      * @type {Array<Record<string|number, any>>}
      * @example [{date:'2020-01-01', value:100}, {date:'2020-01-02', value:200}]
      */
     dataset: Dataset;
     /**
-     * 维度
-     * @description 第一个维度被映射到Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+     * @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}
      * @example [{id: "date", alias: "日期"}, {id: "value", alias: "数值"}]
      */
     dimensions?: Dimensions;
     /**
      * 指标
-     * @description 条形图指标会自动合并为一个指标, 映射到X轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
+     * @description 指标, 条形图指标会自动合并为一个指标, 映射到X轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
      * @type {DimensionTree}
      * @example [{id: "value", alias: "数值"}]
      */
     measures?: MeasureTree;
     /**
-     * 图表的背景颜色
-     * @default transparent 默认为透明背景
-     * @description 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
+     * @description 图表的背景颜色, 默认为透明背景, 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
      */
     backgroundColor?: BackgroundColor;
     /**
@@ -60,39 +67,31 @@ export interface Bar {
      */
     color?: Color;
     /**
-     * 标签
      * @description 标签配置, 用于定义图表的数据标签, 包括数据标签的位置, 格式, 样式等.
      */
     label?: Label;
     /**
-     * 图例
      * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
      */
     legend?: Legend;
     /**
-     * 提示信息
      * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
      */
     tooltip?: Tooltip;
     /**
-     * x轴
-     * @description 数值轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
+     * @description x轴, 数值轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
      */
     xAxis?: XLinearAxis;
     /**
-     * y轴
-     * @description 类目轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     * @description y轴, 类目轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
      */
     yAxis?: YBandAxis;
     /**
-     * 水平提示框
      * @description 水平提示框配置, 用于定义图表的水平提示框, 包括水平提示框的颜色、标签样式等.
      */
     crosshairRect?: CrosshairRect;
     /**
-     * 条形图 堆叠圆角
      * @description 条形图 堆叠圆角
-     * @default 8
      */
     stackCornerRadius?: StackCornerRadius;
     /**
@@ -120,17 +119,15 @@ export interface Bar {
      */
     sortLegend?: SortLegend;
     /**
-     * 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置
+     * @description 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置, 内置light与dark两种主题, 用户可以通过Builder自定义主题
      * @default light 默认为亮色主题
-     * @description 内置light与dark两种主题, 用户可以通过Builder自定义主题
      * @example 'dark'
      * @example 'light'
      * @example 'customThemeName'
      */
     theme?: Theme;
     /**
-     * 矩形图元样式
-     * @description 条形图样式配置, 用于定义图表的条形图样式, 包括条形图的颜色, 边框, 圆角等.
+     * @description 矩形图元样式, 条形图样式配置, 用于定义图表的条形图样式, 包括条形图的颜色, 边框, 圆角等.
      * 支持全局样式或条件样式配置
      * 数据筛选器
      * 若配置selector, 提供数值 selector, 局部数据 selector, 条件维度 selector, 条件指标 selector 共四类数据匹配能力
@@ -138,27 +135,22 @@ export interface Bar {
      */
     barStyle?: BarStyle | BarStyle[];
     /**
-     * 标注点
      * @description 标注点配置, 根据选择的数据, 定义图表的标注点, 包括标注点的位置, 格式, 样式等.
      */
     annotationPoint?: AnnotationPoint | AnnotationPoint[];
     /**
-     * 标注垂直线
      * @description 标注垂直线配置, 根据选择的数据, 定义图表的标注垂直线, 包括标注垂直线的位置, 样式等.
      */
     annotationVerticalLine?: AnnotationVerticalLine | AnnotationVerticalLine[];
     /**
-     * 标注水平线
      * @description 标注水平线配置, 根据选择的数据, 定义图表的标注水平线, 包括标注水平线的位置, 样式等.
      */
     annotationHorizontalLine?: AnnotationHorizontalLine | AnnotationHorizontalLine[];
     /**
-     * 标注区域
      * @description 标注区域配置, 根据选择的数据, 定义图表的标注区域, 包括标注区域的位置, 样式等.
      */
     annotationArea?: AnnotationArea | AnnotationArea[];
     /**
-     * 语言
      * @description 图表语言配置, 支持'zh-CN'与'en-US'两种语言, 另外可以调用 intl.setLocale('zh-CN') 方法设置语言
      * @default 'zh-CN'
      */

package/dist/types/chartType/bar/zBar.d.ts

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zBar: z.ZodObject<{
     chartType: z.ZodLiteral<"bar">;
     dataset: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>>>>;
+    encoding: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        y: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        angle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        radius: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        size: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        tooltip: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        row: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        column: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        group: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;

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 } from '../../properties';
+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';
 /**
  * 并列条形图类型定义
  * @description 并列条形图，适用于多指标横向并行对比场景，多个条形平行排列展示不同指标值
@@ -20,76 +20,74 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  */
 export interface BarParallel {
     /**
-     * 并列条形图
      * @description 并列条形图，适用于多指标横向并行对比场景
      * @type {'barParallel'}
      * @example 'barParallel'
      */
     chartType: 'barParallel';
     /**
-     * 数据集
-     * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 并列条形图的数据最终会被转换为2个维度, 1个指标.
+     * @description 数据源, 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 并列条形图的数据最终会被转换为2个维度, 1个指标.
      * @type {Array<Record<string|number, any>>}
      * @example [{category:'A', value1:100, value2:200}, {category:'B', value1:150, value2:250}]
      */
     dataset: Dataset;
     /**
-     * 维度
-     * @description 第一个维度被映射到Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+     * @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}
      * @example [{id: 'category', alias: '类别'}]
      */
     dimensions?: Dimensions;
     /**
-     * 指标
-     * @description 并列条形图指标会自动合并为一个指标, 映射到X轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
+     * @description 指标, 并列条形图指标会自动合并为一个指标, 映射到X轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
      * @type {DimensionTree}
      * @example [{id: 'value1', alias: '指标1'}, {id: 'value2', alias: '指标2'}]
      */
     measures?: MeasureTree;
     /**
-     * 图表的背景颜色
-     * @default transparent 默认为透明背景
-     * @description 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
+     * @description 图表的背景颜色, 默认为透明背景, 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
      */
     backgroundColor?: BackgroundColor;
     /**
-     * 颜色
      * @description 颜色配置, 用于定义图表的颜色方案, 包括颜色列表, 颜色映射, 颜色渐变等.
      */
     color?: Color;
     /**
-     * 标签
      * @description 标签配置, 用于定义图表的数据标签, 包括数据标签的位置, 格式, 样式等.
      */
     label?: Label;
     /**
-     * 图例
      * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
      */
     legend?: Legend;
     /**
-     * 提示信息
      * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
      */
     tooltip?: Tooltip;
     /**
-     * x轴
-     * @description 数值轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
+     * @description x轴, 数值轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
      */
     xAxis?: XLinearAxis;
     /**
-     * y轴
-     * @description 类目轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     * @description y轴, 类目轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
      */
     yAxis?: YBandAxis;
     /**
-     * 水平提示框
      * @description 水平提示框配置, 用于定义图表的水平提示框, 包括水平提示框的颜色、标签样式等.
      */
     crosshairRect?: CrosshairRect;
     /**
-     * 条形图 堆叠圆角
      * @description 条形图 堆叠圆角
      * @default 8
      */
@@ -119,17 +117,15 @@ export interface BarParallel {
      */
     sortLegend?: SortLegend;
     /**
-     * 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置
+     * @description 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置, 内置light与dark两种主题, 用户可以通过Builder自定义主题
      * @default light 默认为亮色主题
-     * @description 内置light与dark两种主题, 用户可以通过Builder自定义主题
      * @example 'dark'
      * @example 'light'
      * @example 'customThemeName'
      */
     theme?: Theme;
     /**
-     * 矩形图元样式
-     * @description 条形图样式配置, 用于定义图表的条形图样式, 包括条形图的颜色, 边框, 圆角等.
+     * @description 矩形图元样式, 条形图样式配置, 用于定义图表的条形图样式, 包括条形图的颜色, 边框, 圆角等.
      * 支持全局样式或条件样式配置
      * 数据筛选器
      * 若配置selector, 提供数值 selector, 局部数据 selector, 条件维度 selector, 条件指标 selector 共四类数据匹配能力
@@ -137,27 +133,22 @@ export interface BarParallel {
      */
     barStyle?: BarStyle | BarStyle[];
     /**
-     * 标注点
      * @description 标注点配置, 根据选择的数据, 定义图表的标注点, 包括标注点的位置, 格式, 样式等.
      */
     annotationPoint?: AnnotationPoint | AnnotationPoint[];
     /**
-     * 标注垂直线
      * @description 标注垂直线配置, 根据选择的数据, 定义图表的标注垂直线, 包括标注垂直线的位置, 样式等.
      */
     annotationVerticalLine?: AnnotationVerticalLine | AnnotationVerticalLine[];
     /**
-     * 标注水平线
      * @description 标注水平线配置, 根据选择的数据, 定义图表的标注水平线, 包括标注水平线的位置, 样式等.
      */
     annotationHorizontalLine?: AnnotationHorizontalLine | AnnotationHorizontalLine[];
     /**
-     * 标注区域
      * @description 标注区域配置, 根据选择的数据, 定义图表的标注区域, 包括标注区域的位置, 样式等.
      */
     annotationArea?: AnnotationArea | AnnotationArea[];
     /**
-     * 语言
      * @description 图表语言配置, 支持'zh-CN'与'en-US'两种语言, 另外可以调用 intl.setLocale('zh-CN') 方法设置语言
      * @default 'zh-CN'
      */

package/dist/types/chartType/barParallel/zBarParallel.d.ts

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zBarParallel: z.ZodObject<{
     chartType: z.ZodLiteral<"barParallel">;
     dataset: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>>>>;
+    encoding: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        y: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        angle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        radius: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        size: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        tooltip: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        row: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        column: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        group: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;

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 } from '../../properties';
+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';
 /**
  * 百分比条形图类型定义
  * @description 百分比条形图，适用于横向展示各类别占比关系的场景，X轴以百分比形式展示数据占比
@@ -20,76 +20,74 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  */
 export interface BarPercent {
     /**
-     * 百分比条形图
      * @description 百分比条形图，以横向百分比形式展示各类别数据占比关系
      * @type {'barPercent'}
      * @example 'barPercent'
      */
     chartType: 'barPercent';
     /**
-     * 数据集
-     * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 百分比条形图的数据最终会被转换为2个维度, 1个指标.
+     * @description 数据源, 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 百分比条形图的数据最终会被转换为2个维度, 1个指标.
      * @type {Array<Record<string|number, any>>}
      * @example [{category:'A', value:30}, {category:'B', value:70}]
      */
     dataset: Dataset;
     /**
-     * 维度
-     * @description 第一个维度会放至Y轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+     * @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}
      * @example [{id: 'category', alias: '类别'}]
      */
     dimensions?: Dimensions;
     /**
-     * 指标
-     * @description 指标会自动合并为一个指标, 映射到X轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
+     * @description 指标, 指标会自动合并为一个指标, 映射到X轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
      * @type {DimensionTree}
      * @example [{id: 'value', alias: '数值占比', format: 'percent'}]
      */
     measures?: MeasureTree;
     /**
-     * 图表的背景颜色
-     * @default transparent 默认为透明背景
-     * @description 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
+     * @description 图表的背景颜色, 默认为透明背景, 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
      */
     backgroundColor?: BackgroundColor;
     /**
-     * 颜色
      * @description 颜色配置, 用于定义图表的颜色方案, 包括颜色列表, 颜色映射, 颜色渐变等.
      */
     color?: Color;
     /**
-     * 标签
      * @description 标签配置, 用于定义图表的数据标签, 包括数据标签的位置, 格式, 样式等.
      */
     label?: Label;
     /**
-     * 图例
      * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
      */
     legend?: Legend;
     /**
-     * 提示信息
      * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
      */
     tooltip?: Tooltip;
     /**
-     * x轴
-     * @description 数值轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
+     * @description x轴, 数值轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
      */
     xAxis?: XLinearAxis;
     /**
-     * y轴
-     * @description 类目轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     * @description y轴, 类目轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
      */
     yAxis?: YBandAxis;
     /**
-     * 水平提示框
      * @description 水平提示框配置, 用于定义图表的水平提示框, 包括水平提示框的颜色、标签样式等.
      */
     crosshairRect?: CrosshairRect;
     /**
-     * 条形图 堆叠圆角
      * @description 条形图 堆叠圆角
      * @default 8
      */

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

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zBarPercent: z.ZodObject<{
     chartType: z.ZodLiteral<"barPercent">;
     dataset: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>>>>;
+    encoding: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        y: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        angle: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        radius: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        size: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        tooltip: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        row: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        column: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        group: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
     dimensions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         alias: z.ZodOptional<z.ZodString>;