@visactor/vseed 0.1.4 → 0.1.6

package/dist/pipeline/advanced/chart/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/chart/pipes/default/defaultMeasureName.d.ts

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

package/dist/pipeline/advanced/chart/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/chart/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/chart/pipes/encoding/column.d.ts

@@ -1,2 +1,21 @@
 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 encodingForColumn: AdvancedPipe;

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

@@ -1,2 +1,19 @@
 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 encodingForLine: AdvancedPipe;

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

@@ -8,3 +8,4 @@ export * from './markStyle';
 export * from './annotation';
 export * from './analysis';
 export * from './measures';
+export * from './default';

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

@@ -1,3 +1 @@
 export { initAdvancedVSeed } from './initAdvancedVSeed';
-export { autoDimensions } from './autoDimensions';
-export { getBasicDimensions } from './utils';

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

@@ -1,28 +1,13 @@
-import type { Dataset, Measures, VSeed } from '../../../../../types';
-/**
- * @description 获取指标, 无指标时, 自动生成指标
- * @param vseed vseed
- * @returns 指标
- */
-export declare const getBasicMeasures: (vseed: VSeed) => Measures;
-/**
- * @description 自动根据数据集生成指标
- * @param dataset 数据集
- * @returns
- */
-export declare const generateMeasuresByDataset: (dataset: Dataset) => {
-    id: string;
-    alias: string;
-}[];
+import type { AdvancedVSeed, VSeed } from '../../../../../types';
 /**
  * @description 检查是否为指标树, 指标树深度大于1. 如果存在一个指标为组, 即有children配置, 则认为是指标树.
  * @param vseed vseed
  * @returns
  */
-export declare const isMeasureTreeWithChildren: (vseed: VSeed) => boolean;
+export declare const isMeasureTreeWithChildren: (vseed: VSeed | AdvancedVSeed) => boolean;
 /**
  * @description 检查是否为指标树, 指标树存在parentId. 如果存在一个指标有parentId, 则认为是指标树.
  * @param vseed vseed
  * @returns
  */
-export declare const isMeasureTreeWithParentId: (vseed: VSeed) => boolean;
+export declare const isMeasureTreeWithParentId: (vseed: VSeed | AdvancedVSeed) => boolean;

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

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

package/dist/pipeline/advanced/table/pipes/reshape/reshapePivotTable.d.ts

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

package/dist/pipeline/spec/chart/pipes/color/colorCellStyleFill.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const colorCellStyleFill: (stylePipe: SpecPipe) => SpecPipe;

package/dist/pipeline/spec/chart/pipes/color/colorFunnelStyleFill.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const colorFunnelStyleFill: (stylePipe: SpecPipe) => SpecPipe;

package/dist/pipeline/spec/chart/pipes/color/colorPieStyleFill.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const colorPieStyleFill: (stylePipe: SpecPipe) => SpecPipe;

package/dist/pipeline/spec/chart/pipes/color/colorRoseStyleFill.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const colorRoseStyleFill: (stylePipe: SpecPipe) => SpecPipe;

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

@@ -6,3 +6,7 @@ export { colorBarStyleFill } from './colorBarStyleFill';
 export { colorLineStyleFill } from './colorLineStyleFill';
 export { colorPointStyleFill } from './colorPointStyleFill';
 export { colorAreaStyleFill } from './colorAreaStyleFill';
+export { colorCellStyleFill } from './colorCellStyleFill';
+export { colorFunnelStyleFill } from './colorFunnelStyleFill';
+export { colorPieStyleFill } from './colorPieStyleFill';
+export { colorRoseStyleFill } from './colorRoseStyleFill';

package/dist/pipeline/spec/chart/pipes/markStyle/cellStyle.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const cellStyle: SpecPipe;

package/dist/pipeline/spec/chart/pipes/markStyle/funnelStyle.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const funnelStyle: SpecPipe;

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

@@ -1,5 +1,9 @@
+export * from './pointState';
 export { barStyle } from './barStyle';
 export { pointStyle } from './pointStyle';
-export * from './pointState';
 export { lineStyle } from './lineStyle';
 export { areaStyle } from './areaStyle';
+export { cellStyle } from './cellStyle';
+export { funnelStyle } from './funnelStyle';
+export { pieStyle } from './pieStyle';
+export { roseStyle } from './roseStyle';

package/dist/pipeline/spec/chart/pipes/markStyle/pieStyle.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const pieStyle: SpecPipe;

package/dist/pipeline/spec/chart/pipes/markStyle/roseStyle.d.ts

@@ -0,0 +1,2 @@
+import type { SpecPipe } from '../../../../../types';
+export declare const roseStyle: SpecPipe;

package/dist/types/advancedVSeed.d.ts

@@ -108,10 +108,12 @@ export declare const zAdvancedVSeed: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,6 +1,26 @@
 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';
 /**
+ * @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
+ *
  * @description 面积图, 适用于展示数据随时间变化的趋势及累积关系, 通过填充区域增强数据对比. X轴为类目轴(分类数据), Y轴为数值轴(连续数据).
  * 适用场景:
  * - 展示单一数据系列的趋势变化
@@ -14,9 +34,6 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * 默认开启的功能:
  * - 模块开启堆叠
  * - 默认开启图例、坐标轴、区域填充、数据标签、提示信息
- * @recommend
- * - 推荐字段配置: `1`个指标, `2`个维度
- * - 支持数据重塑: 至少`1`个指标, `0`个维度
  */
 export interface Area {
     /**

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

@@ -71,10 +71,12 @@ export declare const zArea: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -7,6 +7,22 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 时间序列的构成变化分析
  * - 多类别占比趋势对比
  * - 累积占比与单一类别占比同时展示
+ * @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
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）

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

@@ -71,10 +71,12 @@ export declare const zAreaPercent: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -71,10 +71,12 @@ export declare const zBar: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -71,10 +71,12 @@ export declare const zBarParallel: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -71,10 +71,12 @@ export declare const zBarPercent: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,12 +1,28 @@
 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';
 /**
- * 柱状图类型定义
  * @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
  * @warning
  * 数据要求:
  * - 至少1个数值字段（度量）

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

@@ -71,10 +71,12 @@ export declare const zColumn: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -7,6 +7,23 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * - 同一维度下多指标并行对比
  * - 多维度数据的横向比较
  * - 指标间关联性分析
+ * @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
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）

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

@@ -71,10 +71,12 @@ export declare const zColumnParallel: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -1,12 +1,28 @@
 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';
 /**
- * 百分比柱状图类型定义
  * @description 百分比柱状图，适用于展示各类别占比关系的场景，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
  * @warning
  * 数据要求:
  * - 至少1个指标字段（度量）

package/dist/types/chartType/columnPercent/zColumnPercent.d.ts

@@ -71,10 +71,12 @@ export declare const zColumnPercent: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

package/dist/types/chartType/donut/zDonut.d.ts

@@ -71,10 +71,12 @@ export declare const zDonut: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

package/dist/types/chartType/dualAxis/zDualAxis.d.ts

@@ -57,10 +57,12 @@ export declare const zDualAxis: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";
@@ -107,10 +109,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";
@@ -154,10 +158,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";
@@ -202,10 +208,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";
@@ -249,10 +257,12 @@ export declare const zDualAxis: z.ZodObject<{
                 }>>>;
             }, z.core.$strip>>>;
             encoding: z.ZodOptional<z.ZodEnum<{
+                column: "column";
                 xAxis: "xAxis";
                 yAxis: "yAxis";
                 angle: "angle";
                 color: "color";
+                detail: "detail";
                 tooltip: "tooltip";
                 label: "label";
                 primaryYAxis: "primaryYAxis";

package/dist/types/chartType/funnel/zFunnel.d.ts

@@ -71,10 +71,12 @@ export declare const zFunnel: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

package/dist/types/chartType/heatmap/zHeatmap.d.ts

@@ -57,10 +57,12 @@ export declare const zHeatmap: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -4,6 +4,22 @@ import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, Annotat
  * 折线图类型定义
  * @description
  * 折线图，适用于展示数据随时间或有序类别变化的趋势，通过线段连接数据点形成趋势线
+ * @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
  * @warning
  * 适用场景:
  * - 展示时间序列数据的变化趋势

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

@@ -71,10 +71,12 @@ export declare const zLine: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -71,10 +71,12 @@ export declare const zPie: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

package/dist/types/chartType/pivotTable/zPivotTable.d.ts

@@ -57,10 +57,12 @@ export declare const zPivotTable: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";

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

@@ -71,10 +71,12 @@ export declare const zRadar: z.ZodObject<{
             }>>>;
         }, z.core.$strip>>>;
         encoding: z.ZodOptional<z.ZodEnum<{
+            column: "column";
             xAxis: "xAxis";
             yAxis: "yAxis";
             angle: "angle";
             color: "color";
+            detail: "detail";
             tooltip: "tooltip";
             label: "label";
             primaryYAxis: "primaryYAxis";