@visactor/vseed 0.4.5 → 0.4.6

package/dist/esm/builder/builder/builder.d.ts

@@ -1,5 +1,5 @@
 import type { AdvancedPipe, AdvancedPipeline, AdvancedVSeed, ChartType, CustomThemeConfig, Locale, Spec, SpecPipe, SpecPipeline, VSeed, VSeedBuilder } from '../../types';
-export declare class Builder implements VSeedBuilder {
+export declare class Builder<S extends Spec = Spec> implements VSeedBuilder {
     private _vseed;
     private _advancedVSeed;
     private _spec;
@@ -7,212 +7,121 @@ export declare class Builder implements VSeedBuilder {
     private _locale;
     private _isPrepared;
     /**
-     * @description 初始化 Builder 实例。
-     * @param vseed VSeed 数据对象，包含图表类型、数据和映射配置。
+     * @description 初始化 Builder 实例
      */
     constructor(vseed: VSeed);
     /**
-     * @description 获取当前 Builder 使用的语言环境。
-     * @returns 语言环境代码 (如 'zh-CN', 'en-US')。
+     * @description 获取当前 Builder 使用的语言环境
      */
     get locale(): Locale;
     /**
-     * @description 准备阶段 - 异步执行动态过滤器代码。
-     *
-     * 在 build() 之前调用，用于执行 dynamicFilter 中的 code。包含以下步骤：
-     *   1. 检查是否存在需要执行的 dynamicFilter (有 code 字段)
-     *   2. 如果存在，给 dataset 添加内部索引 __row_index
-     *   3. 生成 AdvancedVSeed 中间配置
-     *   4. 执行所有 dynamicFilter 的 code，将结果写入 filter.result
-     *   5. 缓存 AdvancedVSeed，供后续 build() 使用
-     *
-     * **注意：**
-     * - 此方法具有幂等性，多次调用不会重复执行
-     * - 如果没有 dynamicFilter code，调用此方法无副作用
-     * - 如果 dynamicFilter 只有静态 result 而没有 code，无需调用此方法
-     *
-     * @returns Promise<void>
-     * @example
-     * // 有 dynamicFilter code 的场景
-     * const builder = VBI.from(data, 'table')
-     *   .dynamicFilter({ code: 'return data.filter(d => d.sales > 1000)' })
-     *
-     * await builder.prepare()  // 异步执行 code
-     * const spec = builder.build()  // 同步构建 spec
-     *
-     * // 没有 dynamicFilter 的场景
-     * const builder = VBI.from(data, 'table')
-     * const spec = builder.build()  // 直接构建，无需 prepare
+     * @description 异步执行动态过滤器代码。在 build() 前调用，用于执行 dynamicFilter 中的 code。幂等方法，多次调用不会重复执行
      */
     prepare: () => Promise<void>;
     /**
-     * @description 生成最终的图表配置 (Spec)。
-     *
-     * 这是最常用的核心方法。拿到 Spec 后，直接传给 VChart 或 VTable 即可渲染图表。
-     *
-     * **注意：**
-     * - 如果配置中包含 dynamicFilter code，需要先调用 prepare() 异步执行
-     * - 如果已调用过 prepare()，build() 会复用缓存的结果，提升性能
-     *
-     * @returns VChart 或 VTable 的标准 Spec 对象。
-     * @example
-     * // 场景 1: 无 dynamicFilter，直接构建
-     * const spec = builder.build();
-     *
-     * // 场景 2: 有 dynamicFilter code，先 prepare 再 build
-     * await builder.prepare();
-     * const spec = builder.build();
-     */
-    build: <T extends Spec>() => T;
-    /**
-     * @description 将中间层配置 (AdvancedVSeed) 转换为最终 Spec。
-     * 仅当你需要深度定制中间层配置时使用。通常流程是：buildAdvanced() -> 修改配置 -> buildSpec()。
-     * @param advanced 修改后的 AdvancedVSeed 对象。
-     * @returns VChart 或 VTable 的标准 Spec 对象。
-     */
-    buildSpec: (advanced: AdvancedVSeed) => Spec;
-    /**
-     * @description 生成中间层配置 (AdvancedVSeed)。
-     * 中间层配置也就是常说的 "图表模版"，它比原始 VSeed 更详细，暴露了更多图表细节（如坐标轴、图例的具体配置）。
-     * 如果默认的 build() 结果不满足需求，可以先获取这个中间配置进行修改，再调用 buildSpec 生成最终结果。
-     * @returns AdvancedVSeed 对象 (模版配置)。
+     * @description 生成最终的图表配置 (Spec)。这是最常用的核心方法。如果配置中包含 dynamicFilter code，需要先调用 prepare()
+     */
+    build: <T = S>() => T;
+    /**
+     * @description 将中间层配置 (AdvancedVSeed) 转换为最终 Spec。仅当你需要深度定制中间层配置时使用
+     */
+    buildSpec: <T = S>(advanced: AdvancedVSeed) => T;
+    /**
+     * @description 生成中间层配置 (AdvancedVSeed)，即图表模版。比原始 VSeed 更详细，暴露了更多图表细节
      */
     buildAdvanced: () => AdvancedVSeed | null;
     /**
-     * @description 获取数据中涉及颜色的字段信息。
-     * 常用于生成图表的图例或颜色筛选器 UI。
-     * @returns 颜色字段列表 (包含 id 和别名)。
+     * @description 获取数据中涉及颜色的字段信息。常用于生成图表的图例或颜色筛选器 UI
      */
     getColorItems: () => {
         id: string;
         alias: string;
     }[];
     /**
-     * @description 获取颜色字段的详细映射表。
-     * @returns Key 为颜色 ID，Value 为详细信息的对象。
+     * @description 获取颜色字段的详细映射表。Key 为颜色 ID，Value 为详细信息
      */
     getColorIdMap: () => Record<string, {
         id: string;
         alias: string;
     }>;
     /**
-     * @description 获取当前的 VSeed 输入数据。
+     * @description 获取当前的 VSeed 输入数据
      */
     get vseed(): VSeed;
     /**
-     * @description 更新 VSeed 输入数据。
-     * 更新后，后续调用 build() 将基于新数据生成。
-     * **注意：** 更新 vseed 后会清除 prepare() 的缓存状态。
-     * @param value 新的 VSeed 对象。
+     * @description 更新 VSeed 输入数据。更新后会清除 prepare() 的缓存状态
      */
     set vseed(value: VSeed);
     /**
      * @description 获取 prepare() 状态
-     * @internal
      */
     get isPrepared(): boolean;
     /**
      * @description 设置 prepare() 状态
-     * @internal
      */
     set isPrepared(value: boolean);
     /**
-     * @description 获取当前的 AdvancedVSeed 中间配置对象。
-     * @returns AdvancedVSeed 对象。
+     * @description 获取当前的 AdvancedVSeed 中间配置对象
      */
     get advancedVSeed(): AdvancedVSeed | null;
     /**
-     * @description 设置 AdvancedVSeed 中间配置对象。
-     * 通常用于缓存或复用已有的中间配置。
-     * @param value 新的 AdvancedVSeed 对象。
+     * @description 设置 AdvancedVSeed 中间配置对象。通常用于缓存或复用已有的中间配置
      */
     set advancedVSeed(value: AdvancedVSeed | null);
     /**
-     * @description 获取当前生成的最终 Spec 对象。
-     * @returns Spec 对象。
+     * @description 获取当前生成的最终 Spec 对象
      */
     get spec(): Spec | null;
     /**
-     * @description 设置 Spec 对象。
-     * 通常用于缓存。
-     * @param value 新的 Spec 对象。
+     * @description 设置 Spec 对象。通常用于缓存
      */
     set spec(value: Spec | null);
     /**
-     * @description 获取构建过程中的性能统计信息。
-     * @returns 包含各阶段耗时的对象 (单位: ms)。
+     * @description 获取构建过程中的性能统计信息。包含各阶段耗时 (单位: ms)
      */
     get performance(): Record<string, string | number>;
     /**
-     * @description 设置性能统计信息。
-     * @param value 新的性能统计对象。
+     * @description 设置性能统计信息
      */
     set performance(value: Record<string, string | number>);
     /**
-     * @description [内部方法] 获取指定图表类型的模版构建管线。
-     * 用于查看或调试该图表类型是如何从 VSeed 转换为 AdvancedVSeed 的。
-     * @param chartType 图表类型 (如 'bar', 'line')。
-     * @returns AdvancedPipeline 数组。
+     * @description [内部方法] 获取指定图表类型的模版构建管线，用于调试 VSeed 到 AdvancedVSeed 的转换过程
      */
-    static getAdvancedPipeline: (chartType: ChartType) => AdvancedPipeline;
+    static getAdvancedPipeline: (chartType: ChartType) => import("../../types").Pipe<AdvancedVSeed, import("src/types").AdvancedPipelineContext>[];
     /**
-     * @description [内部方法] 获取指定图表类型的 Spec 构建管线。
-     * 用于查看或调试该图表类型是如何从 AdvancedVSeed 转换为 Spec 的。
-     * @param chartType 图表类型。
-     * @returns SpecPipeline 数组。
+     * @description [内部方法] 获取指定图表类型的 Spec 构建管线，用于调试 AdvancedVSeed 到 Spec 的转换过程
      */
-    static getSpecPipeline: (chartType: ChartType) => SpecPipeline;
+    static getSpecPipeline: (chartType: ChartType) => SpecPipe[];
     /**
-     * @description 获取指定主题的配置。
-     * @param themeKey 主题名称 (例如 'light', 'dark')。如果不传，默认为 'light'。
-     * @returns 主题配置对象。
+     * @description 获取指定主题的配置。不传 themeKey 默认返回 'light' 主题
      */
     static getTheme: (themeKey?: string) => CustomThemeConfig;
     /**
-     * @description 获取所有已注册的主题配置。
-     * @returns 主题配置映射表。
+     * @description 获取所有已注册的主题配置
      */
     static getThemeMap: () => Record<string, CustomThemeConfig>;
     /**
-     * @description 静态工厂方法，用于便捷地创建 Builder 实例。
-     * @param vseed VSeed 数据对象。
-     * @returns 新的 Builder 实例。
-     * @example
-     * const builder = Builder.from(vseedJson);
+     * @description 静态工厂方法，用于便捷地创建 Builder 实例
      */
-    static from: (vseed: VSeed) => Builder;
+    static from: <T extends Spec = Spec>(vseed: VSeed) => Builder<T>;
     /**
-     * @description [扩展方法] 注册一个新的图表类型（模版构建阶段）。
-     * 如果你要让 Builder 支持一种全新的图表，需要在这里注册它的模版构建逻辑。
-     * @param chartType 新图表类型的名称。
-     * @param pipeline 处理管道数组。
+     * @description [扩展方法] 注册新图表类型的模版构建管线
      */
     static registerAdvancedPipeline: (chartType: ChartType, pipeline: AdvancedPipeline) => void;
     /**
-     * @description [扩展方法] 注册一个新的图表类型（Spec 构建阶段）。
-     * 如果你要让 Builder 支持一种全新的图表，需要在这里注册它的 Spec 构建逻辑。
-     * @param chartType 图表类型。
-     * @param pipeline 处理管道数组。
+     * @description [扩展方法] 注册新图表类型的 Spec 构建管线
      */
     static registerSpecPipeline: (chartType: ChartType, pipeline: SpecPipeline) => void;
     /**
-     * @description [扩展方法] 修改现有的图表模版构建逻辑。
-     * 可以在现有图表的构建流程中插入自定义逻辑（Pipe），从而影响生成的 AdvancedVSeed。
-     * @param chartType 目标图表类型。
-     * @param pipe 自定义处理函数。
+     * @description [扩展方法] 修改现有图表的模版构建逻辑，插入自定义 Pipe 影响生成的 AdvancedVSeed
      */
     static updateAdvanced: (chartType: ChartType, pipe: AdvancedPipe) => void;
     /**
-     * @description [扩展方法] 修改现有的图表 Spec 构建逻辑。
-     * 可以在现有图表的构建流程中插入自定义逻辑（Pipe），从而影响生成的最终 Spec。
-     * @param chartType 目标图表类型。
-     * @param pipe 自定义处理函数。
+     * @description [扩展方法] 修改现有图表的 Spec 构建逻辑，插入自定义 Pipe 影响生成的最终 Spec
      */
     static updateSpec: (chartType: ChartType, pipe: SpecPipe) => void;
     /**
-     * @description [扩展方法] 注册自定义主题。
-     * @param key 主题名称。
-     * @param theme 主题配置对象。
+     * @description [扩展方法] 注册自定义主题
      */
     static registerTheme: (key: string, theme: CustomThemeConfig) => void;
     private static _advancedPipelineMap;

package/dist/esm/builder/builder/builder.js

@@ -57,13 +57,21 @@ class Builder {
     }
     static getAdvancedPipeline = (chartType)=>{
         const customPipe = Builder._customAdvancedPipe[chartType];
-        const pipeline = Builder._advancedPipelineMap[chartType];
+        const originalPipeline = Builder._advancedPipelineMap[chartType];
+        if (!originalPipeline) return originalPipeline;
+        const pipeline = [
+            ...originalPipeline
+        ];
         if (customPipe) pipeline.push(customPipe);
         return pipeline;
     };
     static getSpecPipeline = (chartType)=>{
         const customPipe = Builder._customSpecPipe[chartType];
-        const pipeline = Builder._specPipelineMap[chartType];
+        const originalPipeline = Builder._specPipelineMap[chartType];
+        if (!originalPipeline) return originalPipeline;
+        const pipeline = [
+            ...originalPipeline
+        ];
         if (customPipe) pipeline.push(customPipe);
         return pipeline;
     };

package/dist/esm/builder/builder/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder/builder/builder.js","sources":["webpack://@visactor/vseed/./src/builder/builder/builder.ts"],"sourcesContent":["import type {\n  AdvancedPipe,\n  AdvancedPipeline,\n  AdvancedVSeed,\n  ChartType,\n  CustomThemeConfig,\n  Locale,\n  Spec,\n  SpecPipe,\n  SpecPipeline,\n  VSeed,\n  VSeedBuilder,\n} from 'src/types'\nimport { buildAdvanced } from './buildAdvanced'\nimport { buildSpec } from './buildSpec'\nimport { build } from './build'\nimport { prepare } from './prepare'\nimport { intl } from 'src/i18n'\nimport { getColorIdMap, getColorItems } from './advanced'\n\nexport class Builder implements VSeedBuilder {\n  private _vseed: VSeed\n  private _advancedVSeed: AdvancedVSeed | null = null\n  private _spec: Spec | null = null\n  private _performance: Record<string, string | number> = {}\n\n  private _locale: Locale\n\n  // prepare() 相关状态\n  private _isPrepared: boolean = false\n\n  /**\n   * @description 初始化 Builder 实例。\n   * @param vseed VSeed 数据对象，包含图表类型、数据和映射配置。\n   */\n  constructor(vseed: VSeed) {\n    this._vseed = vseed\n    this._locale = vseed.locale || intl.getLocale()\n  }\n\n  /**\n   * @description 获取当前 Builder 使用的语言环境。\n   * @returns 语言环境代码 (如 'zh-CN', 'en-US')。\n   */\n  get locale() {\n    return this._locale\n  }\n\n  /**\n   * @description 准备阶段 - 异步执行动态过滤器代码。\n   *\n   * 在 build() 之前调用，用于执行 dynamicFilter 中的 code。包含以下步骤：\n   *   1. 检查是否存在需要执行的 dynamicFilter (有 code 字段)\n   *   2. 如果存在，给 dataset 添加内部索引 __row_index\n   *   3. 生成 AdvancedVSeed 中间配置\n   *   4. 执行所有 dynamicFilter 的 code，将结果写入 filter.result\n   *   5. 缓存 AdvancedVSeed，供后续 build() 使用\n   *\n   * **注意：**\n   * - 此方法具有幂等性，多次调用不会重复执行\n   * - 如果没有 dynamicFilter code，调用此方法无副作用\n   * - 如果 dynamicFilter 只有静态 result 而没有 code，无需调用此方法\n   *\n   * @returns Promise<void>\n   * @example\n   * // 有 dynamicFilter code 的场景\n   * const builder = VBI.from(data, 'table')\n   *   .dynamicFilter({ code: 'return data.filter(d => d.sales > 1000)' })\n   *\n   * await builder.prepare()  // 异步执行 code\n   * const spec = builder.build()  // 同步构建 spec\n   *\n   * // 没有 dynamicFilter 的场景\n   * const builder = VBI.from(data, 'table')\n   * const spec = builder.build()  // 直接构建，无需 prepare\n   */\n  prepare = async (): Promise<void> => prepare(this)\n\n  /**\n   * @description 生成最终的图表配置 (Spec)。\n   *\n   * 这是最常用的核心方法。拿到 Spec 后，直接传给 VChart 或 VTable 即可渲染图表。\n   *\n   * **注意：**\n   * - 如果配置中包含 dynamicFilter code，需要先调用 prepare() 异步执行\n   * - 如果已调用过 prepare()，build() 会复用缓存的结果，提升性能\n   *\n   * @returns VChart 或 VTable 的标准 Spec 对象。\n   * @example\n   * // 场景 1: 无 dynamicFilter，直接构建\n   * const spec = builder.build();\n   *\n   * // 场景 2: 有 dynamicFilter code，先 prepare 再 build\n   * await builder.prepare();\n   * const spec = builder.build();\n   */\n  build = <T extends Spec>(): T => build(this) as T\n\n  /**\n   * @description 将中间层配置 (AdvancedVSeed) 转换为最终 Spec。\n   * 仅当你需要深度定制中间层配置时使用。通常流程是：buildAdvanced() -> 修改配置 -> buildSpec()。\n   * @param advanced 修改后的 AdvancedVSeed 对象。\n   * @returns VChart 或 VTable 的标准 Spec 对象。\n   */\n  buildSpec = (advanced: AdvancedVSeed): Spec => buildSpec(this, advanced)\n\n  /**\n   * @description 生成中间层配置 (AdvancedVSeed)。\n   * 中间层配置也就是常说的 \"图表模版\"，它比原始 VSeed 更详细，暴露了更多图表细节（如坐标轴、图例的具体配置）。\n   * 如果默认的 build() 结果不满足需求，可以先获取这个中间配置进行修改，再调用 buildSpec 生成最终结果。\n   * @returns AdvancedVSeed 对象 (模版配置)。\n   */\n  buildAdvanced = (): AdvancedVSeed | null => buildAdvanced(this)\n\n  /**\n   * @description 获取数据中涉及颜色的字段信息。\n   * 常用于生成图表的图例或颜色筛选器 UI。\n   * @returns 颜色字段列表 (包含 id 和别名)。\n   */\n  getColorItems = () => getColorItems(this)\n\n  /**\n   * @description 获取颜色字段的详细映射表。\n   * @returns Key 为颜色 ID，Value 为详细信息的对象。\n   */\n  getColorIdMap = () => getColorIdMap(this)\n\n  /**\n   * @description 获取当前的 VSeed 输入数据。\n   */\n  get vseed() {\n    return this._vseed\n  }\n\n  /**\n   * @description 更新 VSeed 输入数据。\n   * 更新后，后续调用 build() 将基于新数据生成。\n   * **注意：** 更新 vseed 后会清除 prepare() 的缓存状态。\n   * @param value 新的 VSeed 对象。\n   */\n  set vseed(value) {\n    this._vseed = value\n    // 清除 prepare 缓存\n    this._isPrepared = false\n  }\n\n  /**\n   * @description 获取 prepare() 状态\n   * @internal\n   */\n  get isPrepared() {\n    return this._isPrepared\n  }\n\n  /**\n   * @description 设置 prepare() 状态\n   * @internal\n   */\n  set isPrepared(value: boolean) {\n    this._isPrepared = value\n  }\n\n  /**\n   * @description 获取当前的 AdvancedVSeed 中间配置对象。\n   * @returns AdvancedVSeed 对象。\n   */\n  get advancedVSeed() {\n    return this._advancedVSeed\n  }\n\n  /**\n   * @description 设置 AdvancedVSeed 中间配置对象。\n   * 通常用于缓存或复用已有的中间配置。\n   * @param value 新的 AdvancedVSeed 对象。\n   */\n  set advancedVSeed(value) {\n    this._advancedVSeed = value\n  }\n\n  /**\n   * @description 获取当前生成的最终 Spec 对象。\n   * @returns Spec 对象。\n   */\n  get spec() {\n    return this._spec\n  }\n\n  /**\n   * @description 设置 Spec 对象。\n   * 通常用于缓存。\n   * @param value 新的 Spec 对象。\n   */\n  set spec(value) {\n    this._spec = value\n  }\n\n  /**\n   * @description 获取构建过程中的性能统计信息。\n   * @returns 包含各阶段耗时的对象 (单位: ms)。\n   */\n  get performance() {\n    return this._performance\n  }\n\n  /**\n   * @description 设置性能统计信息。\n   * @param value 新的性能统计对象。\n   */\n  set performance(value) {\n    this._performance = value\n  }\n\n  /**\n   * @description [内部方法] 获取指定图表类型的模版构建管线。\n   * 用于查看或调试该图表类型是如何从 VSeed 转换为 AdvancedVSeed 的。\n   * @param chartType 图表类型 (如 'bar', 'line')。\n   * @returns AdvancedPipeline 数组。\n   */\n  static getAdvancedPipeline = (chartType: ChartType) => {\n    const customPipe = Builder._customAdvancedPipe[chartType] as AdvancedPipe\n    const pipeline = Builder._advancedPipelineMap[chartType] as AdvancedPipeline\n    if (customPipe) {\n      pipeline.push(customPipe)\n    }\n    return pipeline\n  }\n\n  /**\n   * @description [内部方法] 获取指定图表类型的 Spec 构建管线。\n   * 用于查看或调试该图表类型是如何从 AdvancedVSeed 转换为 Spec 的。\n   * @param chartType 图表类型。\n   * @returns SpecPipeline 数组。\n   */\n  static getSpecPipeline = (chartType: ChartType) => {\n    const customPipe = Builder._customSpecPipe[chartType] as SpecPipe\n    const pipeline = Builder._specPipelineMap[chartType] as SpecPipeline\n    if (customPipe) {\n      pipeline.push(customPipe)\n    }\n    return pipeline\n  }\n\n  /**\n   * @description 获取指定主题的配置。\n   * @param themeKey 主题名称 (例如 'light', 'dark')。如果不传，默认为 'light'。\n   * @returns 主题配置对象。\n   */\n  static getTheme = (themeKey?: string): CustomThemeConfig => Builder._themeMap[themeKey || 'light']\n\n  /**\n   * @description 获取所有已注册的主题配置。\n   * @returns 主题配置映射表。\n   */\n  static getThemeMap = (): Record<string, CustomThemeConfig> => Builder._themeMap\n\n  /**\n   * @description 静态工厂方法，用于便捷地创建 Builder 实例。\n   * @param vseed VSeed 数据对象。\n   * @returns 新的 Builder 实例。\n   * @example\n   * const builder = Builder.from(vseedJson);\n   */\n  static from = (vseed: VSeed) => new Builder(vseed)\n\n  /**\n   * @description [扩展方法] 注册一个新的图表类型（模版构建阶段）。\n   * 如果你要让 Builder 支持一种全新的图表，需要在这里注册它的模版构建逻辑。\n   * @param chartType 新图表类型的名称。\n   * @param pipeline 处理管道数组。\n   */\n  static registerAdvancedPipeline = (chartType: ChartType, pipeline: AdvancedPipeline) => {\n    Builder._advancedPipelineMap[chartType] = pipeline\n  }\n\n  /**\n   * @description [扩展方法] 注册一个新的图表类型（Spec 构建阶段）。\n   * 如果你要让 Builder 支持一种全新的图表，需要在这里注册它的 Spec 构建逻辑。\n   * @param chartType 图表类型。\n   * @param pipeline 处理管道数组。\n   */\n  static registerSpecPipeline = (chartType: ChartType, pipeline: SpecPipeline) => {\n    Builder._specPipelineMap[chartType] = pipeline\n  }\n\n  /**\n   * @description [扩展方法] 修改现有的图表模版构建逻辑。\n   * 可以在现有图表的构建流程中插入自定义逻辑（Pipe），从而影响生成的 AdvancedVSeed。\n   * @param chartType 目标图表类型。\n   * @param pipe 自定义处理函数。\n   */\n  static updateAdvanced = (chartType: ChartType, pipe: AdvancedPipe) => {\n    Builder._customAdvancedPipe[chartType] = pipe\n  }\n\n  /**\n   * @description [扩展方法] 修改现有的图表 Spec 构建逻辑。\n   * 可以在现有图表的构建流程中插入自定义逻辑（Pipe），从而影响生成的最终 Spec。\n   * @param chartType 目标图表类型。\n   * @param pipe 自定义处理函数。\n   */\n  static updateSpec = (chartType: ChartType, pipe: SpecPipe) => {\n    Builder._customSpecPipe[chartType] = pipe\n  }\n\n  /**\n   * @description [扩展方法] 注册自定义主题。\n   * @param key 主题名称。\n   * @param theme 主题配置对象。\n   */\n  static registerTheme = (key: string, theme: CustomThemeConfig) => {\n    Builder._themeMap[key] = theme\n  }\n\n  private static _advancedPipelineMap: Partial<Record<ChartType, AdvancedPipeline>> = {}\n  private static _specPipelineMap: Partial<Record<ChartType, SpecPipeline>> = {}\n  private static _customAdvancedPipe: Partial<Record<ChartType, AdvancedPipe>> = {}\n  private static _customSpecPipe: Partial<Record<ChartType, SpecPipe>> = {}\n  private static _themeMap: Record<string, CustomThemeConfig> = {}\n}\n"],"names":["Builder","vseed","intl","prepare","build","advanced","buildSpec","buildAdvanced","getColorItems","getColorIdMap","value","chartType","customPipe","pipeline","themeKey","pipe","key","theme"],"mappings":"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"}
+{"version":3,"file":"builder/builder/builder.js","sources":["webpack://@visactor/vseed/./src/builder/builder/builder.ts"],"sourcesContent":["import type {\n  AdvancedPipe,\n  AdvancedPipeline,\n  AdvancedVSeed,\n  ChartType,\n  CustomThemeConfig,\n  Locale,\n  Spec,\n  SpecPipe,\n  SpecPipeline,\n  VSeed,\n  VSeedBuilder,\n} from 'src/types'\nimport { buildAdvanced } from './buildAdvanced'\nimport { buildSpec } from './buildSpec'\nimport { build } from './build'\nimport { prepare } from './prepare'\nimport { intl } from 'src/i18n'\nimport { getColorIdMap, getColorItems } from './advanced'\n\nexport class Builder<S extends Spec = Spec> implements VSeedBuilder {\n  private _vseed: VSeed\n  private _advancedVSeed: AdvancedVSeed | null = null\n  private _spec: Spec | null = null\n  private _performance: Record<string, string | number> = {}\n\n  private _locale: Locale\n\n  private _isPrepared: boolean = false\n\n  /**\n   * @description 初始化 Builder 实例\n   */\n  constructor(vseed: VSeed) {\n    this._vseed = vseed\n    this._locale = vseed.locale || intl.getLocale()\n  }\n\n  /**\n   * @description 获取当前 Builder 使用的语言环境\n   */\n  get locale() {\n    return this._locale\n  }\n\n  /**\n   * @description 异步执行动态过滤器代码。在 build() 前调用，用于执行 dynamicFilter 中的 code。幂等方法，多次调用不会重复执行\n   */\n  prepare = async (): Promise<void> => prepare(this)\n\n  /**\n   * @description 生成最终的图表配置 (Spec)。这是最常用的核心方法。如果配置中包含 dynamicFilter code，需要先调用 prepare()\n   */\n  build = <T = S>(): T => build(this) as T\n\n  /**\n   * @description 将中间层配置 (AdvancedVSeed) 转换为最终 Spec。仅当你需要深度定制中间层配置时使用\n   */\n  buildSpec = <T = S>(advanced: AdvancedVSeed): T => buildSpec(this, advanced) as T\n\n  /**\n   * @description 生成中间层配置 (AdvancedVSeed)，即图表模版。比原始 VSeed 更详细，暴露了更多图表细节\n   */\n  buildAdvanced = (): AdvancedVSeed | null => buildAdvanced(this)\n\n  /**\n   * @description 获取数据中涉及颜色的字段信息。常用于生成图表的图例或颜色筛选器 UI\n   */\n  getColorItems = () => getColorItems(this)\n\n  /**\n   * @description 获取颜色字段的详细映射表。Key 为颜色 ID，Value 为详细信息\n   */\n  getColorIdMap = () => getColorIdMap(this)\n\n  /**\n   * @description 获取当前的 VSeed 输入数据\n   */\n  get vseed() {\n    return this._vseed\n  }\n\n  /**\n   * @description 更新 VSeed 输入数据。更新后会清除 prepare() 的缓存状态\n   */\n  set vseed(value) {\n    this._vseed = value\n    this._isPrepared = false\n  }\n\n  /**\n   * @description 获取 prepare() 状态\n   */\n  get isPrepared() {\n    return this._isPrepared\n  }\n\n  /**\n   * @description 设置 prepare() 状态\n   */\n  set isPrepared(value: boolean) {\n    this._isPrepared = value\n  }\n\n  /**\n   * @description 获取当前的 AdvancedVSeed 中间配置对象\n   */\n  get advancedVSeed() {\n    return this._advancedVSeed\n  }\n\n  /**\n   * @description 设置 AdvancedVSeed 中间配置对象。通常用于缓存或复用已有的中间配置\n   */\n  set advancedVSeed(value) {\n    this._advancedVSeed = value\n  }\n\n  /**\n   * @description 获取当前生成的最终 Spec 对象\n   */\n  get spec() {\n    return this._spec\n  }\n\n  /**\n   * @description 设置 Spec 对象。通常用于缓存\n   */\n  set spec(value) {\n    this._spec = value\n  }\n\n  /**\n   * @description 获取构建过程中的性能统计信息。包含各阶段耗时 (单位: ms)\n   */\n  get performance() {\n    return this._performance\n  }\n\n  /**\n   * @description 设置性能统计信息\n   */\n  set performance(value) {\n    this._performance = value\n  }\n\n  /**\n   * @description [内部方法] 获取指定图表类型的模版构建管线，用于调试 VSeed 到 AdvancedVSeed 的转换过程\n   */\n  static getAdvancedPipeline = (chartType: ChartType) => {\n    const customPipe = Builder._customAdvancedPipe[chartType] as AdvancedPipe\n    const originalPipeline = Builder._advancedPipelineMap[chartType] as AdvancedPipeline\n    if (!originalPipeline) return originalPipeline\n\n    const pipeline = [...originalPipeline]\n    if (customPipe) {\n      pipeline.push(customPipe)\n    }\n    return pipeline\n  }\n\n  /**\n   * @description [内部方法] 获取指定图表类型的 Spec 构建管线，用于调试 AdvancedVSeed 到 Spec 的转换过程\n   */\n  static getSpecPipeline = (chartType: ChartType) => {\n    const customPipe = Builder._customSpecPipe[chartType] as SpecPipe\n    const originalPipeline = Builder._specPipelineMap[chartType] as SpecPipeline\n    if (!originalPipeline) return originalPipeline\n\n    const pipeline = [...originalPipeline]\n    if (customPipe) {\n      pipeline.push(customPipe)\n    }\n    return pipeline\n  }\n\n  /**\n   * @description 获取指定主题的配置。不传 themeKey 默认返回 'light' 主题\n   */\n  static getTheme = (themeKey?: string): CustomThemeConfig => Builder._themeMap[themeKey || 'light']\n\n  /**\n   * @description 获取所有已注册的主题配置\n   */\n  static getThemeMap = (): Record<string, CustomThemeConfig> => Builder._themeMap\n\n  /**\n   * @description 静态工厂方法，用于便捷地创建 Builder 实例\n   */\n  static from = <T extends Spec = Spec>(vseed: VSeed) => new Builder<T>(vseed)\n\n  /**\n   * @description [扩展方法] 注册新图表类型的模版构建管线\n   */\n  static registerAdvancedPipeline = (chartType: ChartType, pipeline: AdvancedPipeline) => {\n    Builder._advancedPipelineMap[chartType] = pipeline\n  }\n\n  /**\n   * @description [扩展方法] 注册新图表类型的 Spec 构建管线\n   */\n  static registerSpecPipeline = (chartType: ChartType, pipeline: SpecPipeline) => {\n    Builder._specPipelineMap[chartType] = pipeline\n  }\n\n  /**\n   * @description [扩展方法] 修改现有图表的模版构建逻辑，插入自定义 Pipe 影响生成的 AdvancedVSeed\n   */\n  static updateAdvanced = (chartType: ChartType, pipe: AdvancedPipe) => {\n    Builder._customAdvancedPipe[chartType] = pipe\n  }\n\n  /**\n   * @description [扩展方法] 修改现有图表的 Spec 构建逻辑，插入自定义 Pipe 影响生成的最终 Spec\n   */\n  static updateSpec = (chartType: ChartType, pipe: SpecPipe) => {\n    Builder._customSpecPipe[chartType] = pipe\n  }\n\n  /**\n   * @description [扩展方法] 注册自定义主题\n   */\n  static registerTheme = (key: string, theme: CustomThemeConfig) => {\n    Builder._themeMap[key] = theme\n  }\n\n  private static _advancedPipelineMap: Partial<Record<ChartType, AdvancedPipeline>> = {}\n  private static _specPipelineMap: Partial<Record<ChartType, SpecPipeline>> = {}\n  private static _customAdvancedPipe: Partial<Record<ChartType, AdvancedPipe>> = {}\n  private static _customSpecPipe: Partial<Record<ChartType, SpecPipe>> = {}\n  private static _themeMap: Record<string, CustomThemeConfig> = {}\n}\n"],"names":["Builder","vseed","intl","prepare","build","advanced","buildSpec","buildAdvanced","getColorItems","getColorIdMap","value","chartType","customPipe","originalPipeline","pipeline","themeKey","pipe","key","theme"],"mappings":";;;;;;AAoBO,MAAMA;IACH,OAAa;IACb,iBAAuC,KAAI;IAC3C,QAAqB,KAAI;IACzB,eAAgD,CAAC,EAAC;IAElD,QAAe;IAEf,cAAuB,MAAK;IAKpC,YAAYC,KAAY,CAAE;QACxB,IAAI,CAAC,MAAM,GAAGA;QACd,IAAI,CAAC,OAAO,GAAGA,MAAM,MAAM,IAAIC,KAAK,SAAS;IAC/C;IAKA,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO;IACrB;IAKA,UAAU,UAA2BC,QAAQ,IAAI,EAAC;IAKlD,QAAQ,IAAgBC,MAAM,IAAI,EAAM;IAKxC,YAAY,CAAQC,WAA+BC,UAAU,IAAI,EAAED,UAAc;IAKjF,gBAAgB,IAA4BE,cAAc,IAAI,EAAC;IAK/D,gBAAgB,IAAMC,cAAc,IAAI,EAAC;IAKzC,gBAAgB,IAAMC,cAAc,IAAI,EAAC;IAKzC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM;IACpB;IAKA,IAAI,MAAMC,KAAK,EAAE;QACf,IAAI,CAAC,MAAM,GAAGA;QACd,IAAI,CAAC,WAAW,GAAG;IACrB;IAKA,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW;IACzB;IAKA,IAAI,WAAWA,KAAc,EAAE;QAC7B,IAAI,CAAC,WAAW,GAAGA;IACrB;IAKA,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,cAAc;IAC5B;IAKA,IAAI,cAAcA,KAAK,EAAE;QACvB,IAAI,CAAC,cAAc,GAAGA;IACxB;IAKA,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK;IACnB;IAKA,IAAI,KAAKA,KAAK,EAAE;QACd,IAAI,CAAC,KAAK,GAAGA;IACf;IAKA,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,YAAY;IAC1B;IAKA,IAAI,YAAYA,KAAK,EAAE;QACrB,IAAI,CAAC,YAAY,GAAGA;IACtB;IAKA,OAAO,sBAAsB,CAACC;QAC5B,MAAMC,aAAaZ,QAAQ,mBAAmB,CAACW,UAAU;QACzD,MAAME,mBAAmBb,QAAQ,oBAAoB,CAACW,UAAU;QAChE,IAAI,CAACE,kBAAkB,OAAOA;QAE9B,MAAMC,WAAW;eAAID;SAAiB;QACtC,IAAID,YACFE,SAAS,IAAI,CAACF;QAEhB,OAAOE;IACT,EAAC;IAKD,OAAO,kBAAkB,CAACH;QACxB,MAAMC,aAAaZ,QAAQ,eAAe,CAACW,UAAU;QACrD,MAAME,mBAAmBb,QAAQ,gBAAgB,CAACW,UAAU;QAC5D,IAAI,CAACE,kBAAkB,OAAOA;QAE9B,MAAMC,WAAW;eAAID;SAAiB;QACtC,IAAID,YACFE,SAAS,IAAI,CAACF;QAEhB,OAAOE;IACT,EAAC;IAKD,OAAO,WAAW,CAACC,WAAyCf,QAAQ,SAAS,CAACe,YAAY,QAAQ;IAKlG,OAAO,cAAc,IAAyCf,QAAQ,SAAS;IAK/E,OAAO,OAAO,CAAwBC,QAAiB,IAAID,QAAWC,OAAM;IAK5E,OAAO,2BAA2B,CAACU,WAAsBG;QACvDd,QAAQ,oBAAoB,CAACW,UAAU,GAAGG;IAC5C,EAAC;IAKD,OAAO,uBAAuB,CAACH,WAAsBG;QACnDd,QAAQ,gBAAgB,CAACW,UAAU,GAAGG;IACxC,EAAC;IAKD,OAAO,iBAAiB,CAACH,WAAsBK;QAC7ChB,QAAQ,mBAAmB,CAACW,UAAU,GAAGK;IAC3C,EAAC;IAKD,OAAO,aAAa,CAACL,WAAsBK;QACzChB,QAAQ,eAAe,CAACW,UAAU,GAAGK;IACvC,EAAC;IAKD,OAAO,gBAAgB,CAACC,KAAaC;QACnClB,QAAQ,SAAS,CAACiB,IAAI,GAAGC;IAC3B,EAAC;IAED,OAAe,uBAAqE,CAAC,EAAC;IACtF,OAAe,mBAA6D,CAAC,EAAC;IAC9E,OAAe,sBAAgE,CAAC,EAAC;IACjF,OAAe,kBAAwD,CAAC,EAAC;IACzE,OAAe,YAA+C,CAAC,EAAC;AAClE"}

package/dist/umd/index.js

@@ -2390,13 +2390,21 @@ self.R = R;
             }
             static getAdvancedPipeline = (chartType)=>{
                 const customPipe = Builder._customAdvancedPipe[chartType];
-                const pipeline = Builder._advancedPipelineMap[chartType];
+                const originalPipeline = Builder._advancedPipelineMap[chartType];
+                if (!originalPipeline) return originalPipeline;
+                const pipeline = [
+                    ...originalPipeline
+                ];
                 if (customPipe) pipeline.push(customPipe);
                 return pipeline;
             };
             static getSpecPipeline = (chartType)=>{
                 const customPipe = Builder._customSpecPipe[chartType];
-                const pipeline = Builder._specPipelineMap[chartType];
+                const originalPipeline = Builder._specPipelineMap[chartType];
+                if (!originalPipeline) return originalPipeline;
+                const pipeline = [
+                    ...originalPipeline
+                ];
                 if (customPipe) pipeline.push(customPipe);
                 return pipeline;
             };