@visactor/vseed 0.0.40 → 0.1.1

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 } from '../../properties';
+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';
 /**
  * 柱状图类型定义
  * @description 柱状图，适用于纵向数据对比场景，X轴为类目轴（分类数据），Y轴为数值轴（连续数据），柱子纵向排列
@@ -20,67 +20,67 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  */
 export interface Column {
     /**
-     * 柱状图
      * @description 柱状图，适用于纵向数据对比场景，X轴为类目轴（分类数据），Y轴为数值轴（连续数据），柱子纵向排列
      * @type {'column'}
      * @example 'column'
      */
     chartType: 'column';
     /**
-     * 数据集
      * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 柱状图的数据最终会被转换为2个维度, 1个指标.
      * @type {Array<Record<string|number, any>>}
      * @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}
      * @example [{id: "category", alias: "类别"}]
      */
     dimensions?: Dimensions;
     /**
-     * 指标
      * @description 柱状图的所有指标会自动合并为一个指标, 映射到Y轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
      * @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;
     /**
-     * 颜色
      * @description 颜色配置, 用于定义图表的颜色方案, 包括颜色列表, 颜色映射, 颜色渐变等.
      */
     color?: Color;
     /**
-     * 标签
      * @description 标签配置, 用于定义图表的数据标签, 包括数据标签的位置, 格式, 样式等.
      */
     label?: Label;
     /**
-     * 图例
      * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
      */
     legend?: Legend;
     /**
-     * 提示信息
      * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
      */
     tooltip?: Tooltip;
     /**
-     * x轴
-     * @description 类目轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
+     * @description x轴, 类目轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
      */
     xAxis?: XBandAxis;
     /**
-     * y轴
-     * @description 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     * @description y轴, 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
      */
     yAxis?: YLinearAxis;
     /**
@@ -108,28 +108,24 @@ export interface Column {
      */
     sortLegend?: SortLegend;
     /**
-     * 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置
+     * @description 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置, 内置light与dark两种主题, 用户可以通过Builder自定义主题
      * @default light 默认为亮色主题
-     * @description 内置light与dark两种主题, 用户可以通过Builder自定义主题
      * @example 'dark'
      * @example 'light'
      * @example 'customThemeName'
      */
     theme?: Theme;
     /**
-     * 垂直提示框
      * @description 垂直提示框配置, 用于定义图表的垂直提示框, 包括垂直提示框的颜色、标签样式等.
      */
     crosshairRect?: CrosshairRect;
     /**
-     * 柱状图 堆叠圆角
-     * @description 条形图 堆叠圆角
+     * @description 柱状图 堆叠圆角
      * @default 8
      */
     stackCornerRadius?: StackCornerRadius;
     /**
-     * 矩形图元样式
-     * @description 条形图样式配置, 用于定义图表的条形图样式, 包括条形图的颜色, 边框, 圆角等.
+     * @description 矩形图元样式, 柱状图样式配置, 用于定义图表的柱状图样式, 包括柱状图的颜色, 边框, 圆角等.
      * 支持全局样式或条件样式配置
      * 数据筛选器
      * 若配置selector, 提供数值 selector, 局部数据 selector, 条件维度 selector, 条件指标 selector 共四类数据匹配能力
@@ -137,27 +133,22 @@ export interface Column {
      */
     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/column/zColumn.d.ts

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zColumn: z.ZodObject<{
     chartType: z.ZodLiteral<"column">;
     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/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 } from '../../properties';
+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';
 /**
  * 并列柱状图类型定义
  * @description 并列柱状图，适用于多指标并行对比场景，多个柱子并列排列展示不同指标值
@@ -20,77 +20,74 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  */
 export interface ColumnParallel {
     /**
-     * 并列柱状图
      * @description 并列柱状图，适用于多指标并行对比场景
-     * @type {'columnParallel'}
      * @example 'columnParallel'
      */
     chartType: 'columnParallel';
     /**
-     * 数据集
-     * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 并列柱状图的数据最终会被转换为2个维度, 1个指标.
-     * @type {Array<Record<string|number, any>>}
+     * @description 数据集, 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 并列柱状图的数据最终会被转换为2个维度, 1个指标.
      * @example [{category:'A', value1:100, value2:200}, {category:'B', value1:150, value2:250}]
      */
     dataset: Dataset;
     /**
-     * 维度
-     * @description 第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+     * @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}
      * @example [{id: 'category', alias: '类别'}]
      */
     dimensions?: Dimensions;
     /**
-     * 指标
-     * @description 并列柱状图的所有指标会自动合并为一个指标, 映射到Y轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
+     * @description 指标, 并列柱状图的所有指标会自动合并为一个指标, 映射到Y轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
      * @type {DimensionTree}
      * @example [{id: 'value1', alias: '指标1'}, {id: 'value2', alias: '指标2'}]
      */
     measures?: MeasureTree;
     /**
-     * 图表的背景颜色
+     * @description 图表的背景颜色, 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
      * @default transparent 默认为透明背景
-     * @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?: XBandAxis;
     /**
-     * y轴
-     * @description 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     * @description y轴, 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
      */
     yAxis?: YLinearAxis;
     /**
-     * 垂直提示框
      * @description 垂直提示框配置, 用于定义图表的垂直提示框, 包括垂直提示框的颜色、标签样式等.
      */
     crosshairRect?: CrosshairRect;
     /**
-     * 柱状图 堆叠圆角
-     * @description 条形图 堆叠圆角
+     * @description 柱状图 堆叠圆角
      * @default 8
      */
     stackCornerRadius?: StackCornerRadius;
@@ -119,17 +116,15 @@ export interface ColumnParallel {
      */
     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 共四类数据匹配能力

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

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zColumnParallel: z.ZodObject<{
     chartType: z.ZodLiteral<"columnParallel">;
     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/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 } from '../../properties';
+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';
 /**
  * 百分比柱状图类型定义
  * @description 百分比柱状图，适用于展示各类别占比关系的场景，Y轴以百分比形式展示数据占比
@@ -33,6 +33,18 @@ 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轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
@@ -48,50 +60,39 @@ export interface ColumnPercent {
      */
     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?: XBandAxis;
     /**
-     * y轴
-     * @description 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     * @description y轴, 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
      */
     yAxis?: YLinearAxis;
     /**
-     * 垂直提示框
      * @description 垂直提示框配置, 用于定义图表的垂直提示框, 包括垂直提示框的颜色、标签样式等.
      */
     crosshairRect?: CrosshairRect;
     /**
-     * 柱状图 堆叠圆角
-     * @description 条形图 堆叠圆角
-     * @default 8
+     * @description 并列柱状图 堆叠圆角
      */
     stackCornerRadius?: StackCornerRadius;
     /**
@@ -119,17 +120,15 @@ export interface ColumnPercent {
      */
     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 +136,22 @@ export interface ColumnPercent {
      */
     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/columnPercent/zColumnPercent.d.ts

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zColumnPercent: z.ZodObject<{
     chartType: z.ZodLiteral<"columnPercent">;
     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/donut/donut.d.ts

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { BackgroundColor, Color, Dataset, Dimensions, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
+import type { BackgroundColor, Color, Dataset, Dimensions, Encoding, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
 /**
  * 环形图类型定义
  * @description 环形图，适用于展示单一维度数据的占比关系，中心留有空白区域可展示汇总信息
@@ -33,6 +33,17 @@ 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/donut/zDonut.d.ts

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zDonut: z.ZodObject<{
     chartType: z.ZodLiteral<"donut">;
     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/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, 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, Encoding, Label, Legend, LineStyle, MeasureTree, PointStyle, Sort, SortLegend, Theme, Tooltip, YLinearAxis } from '../../properties';
 /**
  * 双轴图类型定义
  * @description 双轴图，适用于展示两个不同量级或不同单位指标的对比关系，包含主坐标轴和次坐标轴
@@ -31,6 +31,18 @@ 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,5 +1,5 @@
 import type { Locale } from '../../i18n';
-import type { BackgroundColor, ColorLegend, Dataset, Dimensions, Label, LinearColor, MeasureTree, Theme, Tooltip } from '../../properties';
+import type { BackgroundColor, ColorLegend, Dataset, Dimensions, Encoding, Label, LinearColor, MeasureTree, Theme, Tooltip } from '../../properties';
 /**
  * 漏斗图
  * @description 漏斗图，用于展示单一维度数据的占比关系
@@ -32,6 +32,17 @@ 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/funnel/zFunnel.d.ts

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zFunnel: z.ZodObject<{
     chartType: z.ZodLiteral<"funnel">;
     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/heatmap/heatmap.d.ts

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { ColorLegend, LinearColor, MeasureTree } from '../../properties';
+import type { ColorLegend, Encoding, LinearColor, MeasureTree } from '../../properties';
 import { type BackgroundColor, type Dataset, type Dimensions, type Label, type Theme, type Tooltip } from '../../properties';
 /**
  * 热力图类型定义
@@ -34,6 +34,18 @@ 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/index.d.ts

@@ -9,7 +9,6 @@ export * from './barParallel';
 export * from './barPercent';
 export * from './area';
 export * from './areaPercent';
-export * from './areaRange';
 export * from './scatter';
 export * from './dualAxis';
 export * from './rose';