@visactor/vseed 0.0.40 → 0.1.0

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

@@ -1,5 +1,5 @@
 import type { Locale } from '../../i18n';
-import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, CrosshairLine, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend } from '../../properties';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, LineStyle, PointStyle, Theme, Tooltip, CrosshairLine, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend, Encoding } from '../../properties';
 /**
  * 折线图类型定义
  * @description
@@ -22,37 +22,41 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  */
 export interface Line {
     /**
-     * 折线图
      * @description 折线图，适用于展示数据随时间或有序类别变化的趋势
      * @type {string}
      * @example 'line'
      */
     chartType: 'line';
     /**
-     * 数据集
-     * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 折线图的数据最终会被转换为2个维度, 1个指标.
+     * @description 数据源, 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 折线图的数据最终会被转换为2个维度, 1个指标.
      * @type {Array<Record<string|number, any>>}
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
     /**
-     * 维度
-     * @description 折线图的第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示
+     * @description 编码配置, 折线图的视觉通道, 包括: x通道, color通道, detail通道, label通道, tooltip通道
+     * - x: 映射到X轴的字段, 支持放入多个维度
+     * - detail: 详情映射通道, 支持放入多个维度
+     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
+     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
+     * - label: 标签映射通道, 支持放入 多个维度 或 1个指标
+     */
+    encoding?: Pick<Encoding, 'x' | 'color' | 'detail' | 'label' | 'tooltip'>;
+    /**
+     * @description 维度, 折线图的第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示
      * @type {Dimensions}
      * @example [{id: "month", alias: "月份"}]
      */
     dimensions?: Dimensions;
     /**
-     * 指标
-     * @description 折线图的所有指标会自动合并为一个指标, 映射到Y轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
+     * @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;
     /**

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

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zLine: z.ZodObject<{
     chartType: z.ZodLiteral<"line">;
     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/pie/pie.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,15 @@ export interface Pie {
      * @example [{category:'A', value:30}, {category:'B', value:70}]
      */
     dataset: Dataset;
+    /**
+     * @description 编码配置, 饼图的视觉通道, 包括: angle通道, color通道, detail通道, label通道, tooltip通道
+     * - angle: 映射到角度的字段, 支持放入多个维度
+     * - detail: 详情映射通道, 支持放入多个维度
+     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
+     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
+     * - label: 标签映射通道, 支持放入 多个维度 或 1个指标
+     */
+    encoding?: Pick<Encoding, 'angle' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 饼图的所有维度会与指标名称(存在多个指标时)合并成一个维度, 映射到角度, 并作为图例项展示

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

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

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { AreaStyle, LineStyle, MeasureTree, PointStyle } from '../../properties';
+import type { AreaStyle, Encoding, LineStyle, MeasureTree, PointStyle } from '../../properties';
 import { type BackgroundColor, type Color, type Dataset, type Dimensions, type Label, type Legend, type Theme, type Tooltip } from '../../properties';
 /**
  * 雷达图类型定义
@@ -34,6 +34,15 @@ export interface Radar {
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
+    /**
+     * @description 编码配置, 雷达图的视觉通道, 包括: angle通道, color通道, detail通道, label通道, tooltip通道
+     * - angle: 映射到角度的字段, 支持放入多个维度
+     * - detail: 详情映射通道, 支持放入多个维度
+     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
+     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
+     * - label: 标签映射通道, 支持放入 多个维度 或 1个指标
+     */
+    encoding?: Pick<Encoding, 'angle' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 雷达图的第一个维度被映射到角度轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.

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

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

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { MeasureTree } from '../../properties';
+import type { Encoding, MeasureTree } from '../../properties';
 import { type BackgroundColor, type Color, type Dataset, type Dimensions, type Label, type Legend, type Theme, type Tooltip } from '../../properties';
 /**
  * 堆叠玫瑰图类型定义
@@ -34,6 +34,15 @@ export interface Rose {
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
+    /**
+     * @description 编码配置, 堆叠玫瑰图的视觉通道, 包括: angle通道, color通道, detail通道, label通道, tooltip通道
+     * - angle: 映射到角度的字段, 支持放入多个维度
+     * - detail: 详情映射通道, 支持放入多个维度
+     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
+     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
+     * - label: 标签映射通道, 支持放入 多个维度 或 1个指标
+     */
+    encoding?: Pick<Encoding, 'angle' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 玫瑰图的第一个维度被映射到角度轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.

package/dist/types/chartType/rose/zRose.d.ts

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

@@ -1,5 +1,5 @@
 import { type Locale } from '../../i18n';
-import type { MeasureTree } from '../../properties';
+import type { Encoding, MeasureTree } from '../../properties';
 import { type BackgroundColor, type Color, type Dataset, type Dimensions, type Label, type Legend, type Theme, type Tooltip } from '../../properties';
 /**
  * 分组玫瑰图类型定义
@@ -34,6 +34,15 @@ export interface RoseParallel {
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
+    /**
+     * @description 编码配置, 分组玫瑰图的视觉通道, 包括: angle通道, color通道, detail通道, label通道, tooltip通道
+     * - angle: 映射到角度的字段, 支持放入多个维度
+     * - detail: 详情映射通道, 支持放入多个维度
+     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
+     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
+     * - label: 标签映射通道, 支持放入 多个维度 或 1个指标
+     */
+    encoding?: Pick<Encoding, 'angle' | 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 玫瑰图的第一个维度被映射到角度轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.

package/dist/types/chartType/roseParallel/zRoseParallel.d.ts

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

@@ -1,5 +1,5 @@
 import type { Locale } from '../../i18n';
-import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, PointStyle, Theme, Tooltip, CrosshairLine, YLinearAxis, XLinearAxis, MeasureTree } from '../../properties';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, Color, Dataset, Dimensions, Label, Legend, PointStyle, Theme, Tooltip, CrosshairLine, YLinearAxis, XLinearAxis, MeasureTree, Encoding, ScatterMeasures } from '../../properties';
 /**
  * 散点图类型定义
  * @description 散点图，适用于展示数据的分布情况，通过点的位置表示数据的数值
@@ -31,6 +31,14 @@ export interface Scatter {
      * @example [{month:'1月', value:100}, {month:'2月', value:150}, {month:'3月', value:120}]
      */
     dataset: Dataset;
+    /**
+     * @description 编码配置, 散点图的视觉通道, 包括:  color通道, detail通道, label通道, tooltip通道
+     * - detail: 详情映射通道, 支持放入多个维度
+     * - tooltip: 提示映射通道, 支持放入多个维度 和 多个指标
+     * - color: 颜色映射通道, 支持放入多个维度 或 1个 指标
+     * - label: 标签映射通道, 支持放入 多个维度 或 1个指标
+     */
+    encoding?: Pick<Encoding, 'color' | 'detail' | 'label' | 'tooltip'>;
     /**
      * 维度
      * @description 散点图的第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示
@@ -39,12 +47,87 @@ export interface Scatter {
      */
     dimensions?: Dimensions;
     /**
-     * 指标
-     * @description 散点图的第一个指标字段会放至X轴, 其余指标会进行合并, 映射至Y轴
-     * @type {DimensionTree}
-     * @example [{id: "value", alias: "数值"}]
+     * @description 散点图指标
+     * measures可以使用2个指标组, 代表普通散点图的X轴和Y轴指标, 每个指标组内的指标会自动合并为一个指标.
+     * measures可以使用1个指标组, 再嵌套2个指标组, 绘制组合散点图. 最外层的每一个组, 代表一个散点图, 它们会纵向排列.
+     * @example
+     * 普通散点图
+     * [
+     *   {
+     *     id: "xAxis",
+     *     alias: '主轴',
+     *     children: [{id: 'profit', alias: '利润'}, {id: 'sales', alias: '销售额'}]
+     *   },
+     *   {
+     *     id: "y",
+     *     alias: '次轴',
+     *     children: [{id: 'growth', alias: '增长率'}, {id: 'returnRatio', alias: '回报率'}]
+     *   }
+     * ]
+     * 组合散点图
+     * [
+     *   {
+     *     id: "first",
+     *     alias: "第一个散点图",
+     *     children: [
+     *      {
+     *        id: "xAxis",
+     *        alias: '主轴',
+     *        children: [{id: 'profit', alias: '利润'}, {id: 'sales', alias: '销售额'}]
+     *      },
+     *      {
+     *        id: "y",
+     *        alias: '次轴',
+     *        children: [{id: 'growth', alias: '增长率'}, {id: 'returnRatio', alias: '回报率'}]
+     *      },
+     *     ]
+     *   },
+     *   {
+     *     id: "second",
+     *     alias: "第二个散点图",
+     *     children: [
+     *      {
+     *        id: "xAxis2",
+     *        alias: '主轴',
+     *        children: [{id: 'profit2', alias: '利润'}, {id: 'sales2', alias: '销售额'}]
+     *      },
+     *      {
+     *        id: "y2",
+     *        alias: '次轴',
+     *        children: [{id: 'growth2', alias: '增长率'}, {id: 'returnRatio2', alias: '回报率'}]
+     *      },
+     *     ]
+     *   },
+     * ]
      */
     measures?: MeasureTree;
+    /**
+     * @description 散点图指标, 是measures的简化形式
+     * 组合的散点图指标配置, 每个对象都代表一个散点图, 散点图之间纵向排列, 必须是数组.
+     * 每个配置对象内, xMeasures代表所有的X轴指标, yMeasures代表所有的Y轴指标, xMeasures和yMeasures可配置为数组或一个对象
+     * xMeasures 如果是多个指标, 则会自动合并, 映射至X轴
+     * yMeasures 如果是多个指标, 则会自动合并, 映射至Y轴
+     * @example
+     * 如下示例配置了一个双轴图, 主轴有1个value指标, 次轴有1个growth指标
+     * [
+     *   {
+     *     xMeasures:   {id: 'value', alias: '数值'}
+     *     yMeasures: {id: 'growth', alias: '增长率'}
+     *   }
+     * ]
+     * 如下示例配置了2个纵向排列的双轴图, 第一个双轴图, 主轴有1个value指标, 次轴有一个growth指标, 第二个双轴图, 主轴有2个指标: profit与sales, 次轴有一个returnRatio指标
+     * [
+     *   {
+     *     xMeasures:  {id: 'value', alias: '数值'}
+     *     yMeasures: {id: 'growth', alias: '增长率'}
+     *   },
+     *   {
+     *     xMeasures:   [{id: 'profit', alias: '利润'}, {id: 'sales', alias: '销售额'}],
+     *     yMeasures: [{id: 'returnRatio', alias: '回报率'}]
+     *   }
+     * ]
+     */
+    scatterMeasures?: ScatterMeasures;
     /**
      * 图表的背景颜色
      * @default transparent 默认为透明背景

package/dist/types/chartType/scatter/zScatter.d.ts

@@ -2,6 +2,20 @@ import { z } from 'zod';
 export declare const zScatter: z.ZodObject<{
     chartType: z.ZodLiteral<"scatter">;
     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>;
@@ -46,6 +60,147 @@ export declare const zScatter: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>]>>>>;
+    scatterMeasures: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        xMeasures: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            alias: z.ZodOptional<z.ZodString>;
+            autoFormat: z.ZodDefault<z.ZodBoolean>;
+            format: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    number: "number";
+                    percent: "percent";
+                    permille: "permille";
+                    scientific: "scientific";
+                }>>>;
+                ratio: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                symbol: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                thousandSeparator: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                prefix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                suffix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                fractionDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                significantDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                roundingPriority: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    morePrecision: "morePrecision";
+                    lessPrecision: "lessPrecision";
+                }>>>;
+                roundingMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    floor: "floor";
+                    ceil: "ceil";
+                    expand: "expand";
+                    trunc: "trunc";
+                    halfCeil: "halfCeil";
+                    halfFloor: "halfFloor";
+                    halfExpand: "halfExpand";
+                    halfTrunc: "halfTrunc";
+                    halfEven: "halfEven";
+                }>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>, z.ZodObject<{
+            id: z.ZodString;
+            alias: z.ZodOptional<z.ZodString>;
+            autoFormat: z.ZodDefault<z.ZodBoolean>;
+            format: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    number: "number";
+                    percent: "percent";
+                    permille: "permille";
+                    scientific: "scientific";
+                }>>>;
+                ratio: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                symbol: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                thousandSeparator: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                prefix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                suffix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                fractionDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                significantDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                roundingPriority: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    morePrecision: "morePrecision";
+                    lessPrecision: "lessPrecision";
+                }>>>;
+                roundingMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    floor: "floor";
+                    ceil: "ceil";
+                    expand: "expand";
+                    trunc: "trunc";
+                    halfCeil: "halfCeil";
+                    halfFloor: "halfFloor";
+                    halfExpand: "halfExpand";
+                    halfTrunc: "halfTrunc";
+                    halfEven: "halfEven";
+                }>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>]>>;
+        yMeasures: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            alias: z.ZodOptional<z.ZodString>;
+            autoFormat: z.ZodDefault<z.ZodBoolean>;
+            format: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    number: "number";
+                    percent: "percent";
+                    permille: "permille";
+                    scientific: "scientific";
+                }>>>;
+                ratio: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                symbol: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                thousandSeparator: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                prefix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                suffix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                fractionDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                significantDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                roundingPriority: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    morePrecision: "morePrecision";
+                    lessPrecision: "lessPrecision";
+                }>>>;
+                roundingMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    floor: "floor";
+                    ceil: "ceil";
+                    expand: "expand";
+                    trunc: "trunc";
+                    halfCeil: "halfCeil";
+                    halfFloor: "halfFloor";
+                    halfExpand: "halfExpand";
+                    halfTrunc: "halfTrunc";
+                    halfEven: "halfEven";
+                }>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>, z.ZodObject<{
+            id: z.ZodString;
+            alias: z.ZodOptional<z.ZodString>;
+            autoFormat: z.ZodDefault<z.ZodBoolean>;
+            format: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    number: "number";
+                    percent: "percent";
+                    permille: "permille";
+                    scientific: "scientific";
+                }>>>;
+                ratio: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                symbol: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                thousandSeparator: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                prefix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                suffix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+                fractionDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                significantDigits: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+                roundingPriority: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    morePrecision: "morePrecision";
+                    lessPrecision: "lessPrecision";
+                }>>>;
+                roundingMode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    floor: "floor";
+                    ceil: "ceil";
+                    expand: "expand";
+                    trunc: "trunc";
+                    halfCeil: "halfCeil";
+                    halfFloor: "halfFloor";
+                    halfExpand: "halfExpand";
+                    halfTrunc: "halfTrunc";
+                    halfEven: "halfEven";
+                }>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>>>;
     backgroundColor: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodString>>>>>;
     color: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         colorScheme: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;

package/dist/types/index.d.ts

@@ -2,6 +2,7 @@ export * from './properties';
 export type * from './pipeline';
 export * from './chartType';
 export type * from './builder';
-export * from './vseed';
+export type * from './vseed';
+export * from './zVseed';
 export * from './advancedVSeed';
 export * from './i18n';

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export type ChartType = 'table' | 'pivotTable' | 'line' | 'column' | 'columnPercent' | 'columnParallel' | 'bar' | 'barPercent' | 'barParallel' | 'area' | 'areaPercent' | 'areaRange' | 'scatter' | 'dualAxis' | 'rose' | 'roseParallel' | 'pie' | 'donut' | 'radar' | 'heatmap' | 'funnel';
+export type ChartType = 'table' | 'pivotTable' | 'line' | 'column' | 'columnPercent' | 'columnParallel' | 'bar' | 'barPercent' | 'barParallel' | 'area' | 'areaPercent' | 'scatter' | 'dualAxis' | 'rose' | 'roseParallel' | 'pie' | 'donut' | 'radar' | 'heatmap' | 'funnel';
 export declare enum ChartTypeEnum {
     Table = "table",
     PivotTable = "pivotTable",
@@ -12,7 +12,6 @@ export declare enum ChartTypeEnum {
     BarParallel = "barParallel",
     Area = "area",
     AreaPercent = "areaPercent",
-    AreaRange = "areaRange",
     DualAxis = "dualAxis",
     Scatter = "scatter",
     Rose = "rose",
@@ -35,7 +34,6 @@ export declare const zChartType: z.ZodEnum<{
     barParallel: "barParallel";
     area: "area";
     areaPercent: "areaPercent";
-    areaRange: "areaRange";
     scatter: "scatter";
     dualAxis: "dualAxis";
     rose: "rose";