@visactor/vseed 0.4.1 → 0.4.3

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

@@ -1,6 +1,7 @@
 import { buildAdvanced } from "./buildAdvanced.js";
 import { buildSpec } from "./buildSpec.js";
 import { build } from "./build.js";
+import { prepare } from "./prepare.js";
 import { intl } from "../../i18n/index.js";
 import { getColorIdMap, getColorItems } from "./advanced/index.js";
 class Builder {
@@ -9,6 +10,7 @@ class Builder {
     _spec = null;
     _performance = {};
     _locale;
+    _isPrepared = false;
     constructor(vseed){
         this._vseed = vseed;
         this._locale = vseed.locale || intl.getLocale();
@@ -16,6 +18,7 @@ class Builder {
     get locale() {
         return this._locale;
     }
+    prepare = async ()=>prepare(this);
     build = ()=>build(this);
     buildSpec = (advanced)=>buildSpec(this, advanced);
     buildAdvanced = ()=>buildAdvanced(this);
@@ -26,6 +29,13 @@ class Builder {
     }
     set vseed(value) {
         this._vseed = value;
+        this._isPrepared = false;
+    }
+    get isPrepared() {
+        return this._isPrepared;
+    }
+    set isPrepared(value) {
+        this._isPrepared = value;
     }
     get advancedVSeed() {
         return this._advancedVSeed;

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 { 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  /**\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 生成最终的图表配置 (Spec)。\n   * 这是最常用的核心方法。拿到 Spec 后，直接传给 VChart 或 VTable 即可渲染图表。\n   * @returns VChart 或 VTable 的标准 Spec 对象。\n   * @example\n   * const spec = builder.build();\n   * // const vchart = new VChart(spec, { dom: 'chart-container' });\n   * // vchart.render();\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   * @param value 新的 VSeed 对象。\n   */\n  set vseed(value) {\n    this._vseed = 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) => Builder._themeMap[themeKey || 'light']\n\n  /**\n   * @description 获取所有已注册的主题配置。\n   * @returns 主题配置映射表。\n   */\n  static getThemeMap = () => 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","build","advanced","buildSpec","buildAdvanced","getColorItems","getColorIdMap","value","chartType","customPipe","pipeline","themeKey","pipe","key","theme"],"mappings":";;;;;AAmBO,MAAMA;IACH,OAAa;IACb,iBAAuC,KAAI;IAC3C,QAAqB,KAAI;IACzB,eAAgD,CAAC,EAAC;IAElD,QAAe;IAMvB,YAAYC,KAAY,CAAE;QACxB,IAAI,CAAC,MAAM,GAAGA;QACd,IAAI,CAAC,OAAO,GAAGA,MAAM,MAAM,IAAIC,KAAK,SAAS;IAC/C;IAMA,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO;IACrB;IAWA,QAAQ,IAAyBC,MAAM,IAAI,EAAM;IAQjD,YAAY,CAACC,WAAkCC,UAAU,IAAI,EAAED,UAAS;IAQxE,gBAAgB,IAA4BE,cAAc,IAAI,EAAC;IAO/D,gBAAgB,IAAMC,cAAc,IAAI,EAAC;IAMzC,gBAAgB,IAAMC,cAAc,IAAI,EAAC;IAKzC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM;IACpB;IAOA,IAAI,MAAMC,KAAK,EAAE;QACf,IAAI,CAAC,MAAM,GAAGA;IAChB;IAMA,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,cAAc;IAC5B;IAOA,IAAI,cAAcA,KAAK,EAAE;QACvB,IAAI,CAAC,cAAc,GAAGA;IACxB;IAMA,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK;IACnB;IAOA,IAAI,KAAKA,KAAK,EAAE;QACd,IAAI,CAAC,KAAK,GAAGA;IACf;IAMA,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,YAAY;IAC1B;IAMA,IAAI,YAAYA,KAAK,EAAE;QACrB,IAAI,CAAC,YAAY,GAAGA;IACtB;IAQA,OAAO,sBAAsB,CAACC;QAC5B,MAAMC,aAAaX,QAAQ,mBAAmB,CAACU,UAAU;QACzD,MAAME,WAAWZ,QAAQ,oBAAoB,CAACU,UAAU;QACxD,IAAIC,YACFC,SAAS,IAAI,CAACD;QAEhB,OAAOC;IACT,EAAC;IAQD,OAAO,kBAAkB,CAACF;QACxB,MAAMC,aAAaX,QAAQ,eAAe,CAACU,UAAU;QACrD,MAAME,WAAWZ,QAAQ,gBAAgB,CAACU,UAAU;QACpD,IAAIC,YACFC,SAAS,IAAI,CAACD;QAEhB,OAAOC;IACT,EAAC;IAOD,OAAO,WAAW,CAACC,WAAsBb,QAAQ,SAAS,CAACa,YAAY,QAAQ;IAM/E,OAAO,cAAc,IAAMb,QAAQ,SAAS;IAS5C,OAAO,OAAO,CAACC,QAAiB,IAAID,QAAQC,OAAM;IAQlD,OAAO,2BAA2B,CAACS,WAAsBE;QACvDZ,QAAQ,oBAAoB,CAACU,UAAU,GAAGE;IAC5C,EAAC;IAQD,OAAO,uBAAuB,CAACF,WAAsBE;QACnDZ,QAAQ,gBAAgB,CAACU,UAAU,GAAGE;IACxC,EAAC;IAQD,OAAO,iBAAiB,CAACF,WAAsBI;QAC7Cd,QAAQ,mBAAmB,CAACU,UAAU,GAAGI;IAC3C,EAAC;IAQD,OAAO,aAAa,CAACJ,WAAsBI;QACzCd,QAAQ,eAAe,CAACU,UAAU,GAAGI;IACvC,EAAC;IAOD,OAAO,gBAAgB,CAACC,KAAaC;QACnChB,QAAQ,SAAS,CAACe,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"}
+{"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) => Builder._themeMap[themeKey || 'light']\n\n  /**\n   * @description 获取所有已注册的主题配置。\n   * @returns 主题配置映射表。\n   */\n  static getThemeMap = () => 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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"}

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

@@ -0,0 +1,12 @@
+import type { Builder } from './builder';
+/**
+ * 准备阶段 - 执行动态过滤器代码
+ * @description 在 build() 之前调用，用于：
+ *   1. 检查是否存在需要执行的 dynamicFilter (有 code 字段)
+ *   2. 创建 vseed 的副本，给 dataset 添加 __row_index
+ *   3. 收集所有 dynamicFilter 并执行 code
+ *   4. 将结果直接写入 dynamicFilter.result
+ *   5. 更新 builder.vseed 为处理后的副本
+ * @returns Promise<void>
+ */
+export declare const prepare: (builder: Builder) => Promise<void>;

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

@@ -0,0 +1,269 @@
+import { InnerRowIndex } from "../../dataReshape/index.js";
+import { executeDynamicFilter, isDynamicFilter } from "../../dataSelector/selector.js";
+const generateDynamicFilterKeyPaths = ()=>{
+    const dynamicFilterConfig = {
+        table: [
+            'bodyCellStyle'
+        ],
+        pivotTable: [
+            'bodyCellStyle'
+        ],
+        bar: [
+            'barStyle',
+            'annotationPoint',
+            'annotationVerticalLine'
+        ],
+        barParallel: [
+            'barStyle',
+            'annotationPoint',
+            'annotationVerticalLine'
+        ],
+        barPercent: [
+            'barStyle',
+            'annotationPoint',
+            'annotationVerticalLine'
+        ],
+        column: [
+            'barStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        columnParallel: [
+            'barStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        columnPercent: [
+            'barStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        line: [
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        area: [
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        areaPercent: [
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        dualAxis: [
+            'barStyle',
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        scatter: [
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine',
+            'annotationVerticalLine'
+        ],
+        histogram: [
+            'annotationHorizontalLine'
+        ],
+        boxPlot: [
+            'annotationHorizontalLine'
+        ]
+    };
+    const result = {};
+    for (const [chartType, baseKeyPaths] of Object.entries(dynamicFilterConfig))result[chartType] = baseKeyPaths.flatMap((basePath)=>[
+            `${basePath}[].dynamicFilter`,
+            `${basePath}.dynamicFilter`
+        ]);
+    return result;
+};
+const dynamicFilterKeyPathsByChartType = generateDynamicFilterKeyPaths();
+const getBasePathsForDeepClone = (chartType)=>{
+    const config = {
+        table: [
+            'bodyCellStyle'
+        ],
+        pivotTable: [
+            'bodyCellStyle'
+        ],
+        bar: [
+            'barStyle',
+            'annotationPoint',
+            'annotationVerticalLine'
+        ],
+        barParallel: [
+            'barStyle',
+            'annotationPoint',
+            'annotationVerticalLine'
+        ],
+        barPercent: [
+            'barStyle',
+            'annotationPoint',
+            'annotationVerticalLine'
+        ],
+        column: [
+            'barStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        columnParallel: [
+            'barStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        columnPercent: [
+            'barStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        line: [
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        area: [
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        areaPercent: [
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        dualAxis: [
+            'barStyle',
+            'lineStyle',
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine'
+        ],
+        scatter: [
+            'pointStyle',
+            'annotationPoint',
+            'annotationHorizontalLine',
+            'annotationVerticalLine'
+        ],
+        histogram: [
+            'annotationHorizontalLine'
+        ],
+        boxPlot: [
+            'annotationHorizontalLine'
+        ]
+    };
+    return config[chartType] ?? [];
+};
+const parseKeyPath = (path)=>path.split('.').map((segment)=>{
+        if (segment.endsWith('[]')) return {
+            key: segment.slice(0, -2),
+            isArray: true
+        };
+        return {
+            key: segment,
+            isArray: false
+        };
+    });
+const getValuesByKeyPath = (target, path)=>{
+    const segments = parseKeyPath(path);
+    let current = [
+        target
+    ];
+    for (const segment of segments){
+        const next = [];
+        for (const node of current){
+            if (!node || 'object' != typeof node) continue;
+            const value = node[segment.key];
+            if (segment.isArray) {
+                if (Array.isArray(value)) next.push(...value);
+            } else if (void 0 !== value) next.push(value);
+        }
+        current = next;
+    }
+    return current;
+};
+const collectDynamicFiltersByKeyPaths = (target, chartType)=>{
+    const paths = dynamicFilterKeyPathsByChartType[chartType] ?? [];
+    if (!paths.length) return [];
+    return paths.flatMap((path)=>getValuesByKeyPath(target, path)).filter((value)=>isDynamicFilter(value) && !!value?.code);
+};
+const executeDynamicFiltersAndInject = async (filters, dataset)=>{
+    if (!filters.length || !dataset.length) return;
+    await Promise.all(filters.map(async (filter)=>{
+        const { success, data, error } = await executeDynamicFilter(filter, dataset);
+        filter.result = {
+            success,
+            error,
+            data: data
+        };
+    }));
+};
+const deepCloneDynamicFilterPaths = (vseed, chartType)=>{
+    const basePaths = getBasePathsForDeepClone(chartType);
+    if (!basePaths.length) return {
+        ...vseed
+    };
+    const clonedVseed = {
+        ...vseed
+    };
+    for (const basePath of basePaths){
+        if (!(basePath in clonedVseed)) continue;
+        const value = clonedVseed[basePath];
+        if (Array.isArray(value)) clonedVseed[basePath] = value.map((item)=>{
+            if (!item || 'object' != typeof item) return item;
+            const clonedItem = {
+                ...item
+            };
+            if (clonedItem.dynamicFilter && 'object' == typeof clonedItem.dynamicFilter) clonedItem.dynamicFilter = {
+                ...clonedItem.dynamicFilter
+            };
+            return clonedItem;
+        });
+        else if (value && 'object' == typeof value) {
+            clonedVseed[basePath] = {
+                ...value
+            };
+            if (clonedVseed[basePath].dynamicFilter && 'object' == typeof clonedVseed[basePath].dynamicFilter) clonedVseed[basePath].dynamicFilter = {
+                ...clonedVseed[basePath].dynamicFilter
+            };
+        }
+    }
+    return clonedVseed;
+};
+const prepare = async (builder)=>{
+    if (builder.isPrepared || !builder.vseed || !builder.vseed?.chartType || !builder.vseed.dataset) return;
+    const filters = collectDynamicFiltersByKeyPaths(builder.vseed, builder.vseed.chartType);
+    if (!filters.length) {
+        builder.isPrepared = true;
+        return;
+    }
+    const clonedVseed = deepCloneDynamicFilterPaths(builder.vseed, builder.vseed.chartType);
+    const originalDataset = clonedVseed.dataset;
+    let datasetWithIndex = originalDataset;
+    if (!originalDataset[0] || !(InnerRowIndex in originalDataset[0])) datasetWithIndex = originalDataset.map((item, index)=>({
+            ...item,
+            [InnerRowIndex]: index
+        }));
+    builder.vseed = {
+        ...clonedVseed,
+        dataset: datasetWithIndex
+    };
+    const clonedFilters = collectDynamicFiltersByKeyPaths(builder.vseed, builder.vseed.chartType);
+    try {
+        await executeDynamicFiltersAndInject(clonedFilters, datasetWithIndex);
+    } catch (e) {
+        throw new Error(`Failed to execute dynamic filters: ${e.message}`);
+    }
+    builder.isPrepared = true;
+};
+export { prepare };
+
+//# sourceMappingURL=prepare.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder/builder/prepare.js","sources":["webpack://@visactor/vseed/./src/builder/builder/prepare.ts"],"sourcesContent":["import type { ChartType } from 'src/types'\nimport { InnerRowIndex } from 'src/dataReshape'\nimport type { Builder } from './builder'\nimport { executeDynamicFilter, isDynamicFilter } from 'src/dataSelector/selector'\nimport type { DynamicFilter } from 'src/dataSelector/selector'\nimport type { ChartDynamicFilterRes, TableDynamicFilterRes } from 'src/types/dataSelector'\n\n/**\n * 生成完整的 keyPath 配置\n * 对每个基路径生成数组和非数组两种形式\n */\nconst generateDynamicFilterKeyPaths = (): Partial<Record<ChartType, string[]>> => {\n  /**\n   * 动态筛选器基础配置 - 配置每个图表类型中可能包含动态筛选器的字段\n   * 生成时会自动添加 [] 和非 [] 两种形式\n   */\n  const dynamicFilterConfig: Partial<Record<ChartType, string[]>> = {\n    table: ['bodyCellStyle'],\n    pivotTable: ['bodyCellStyle'],\n    bar: ['barStyle', 'annotationPoint', 'annotationVerticalLine'],\n    barParallel: ['barStyle', 'annotationPoint', 'annotationVerticalLine'],\n    barPercent: ['barStyle', 'annotationPoint', 'annotationVerticalLine'],\n    column: ['barStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    columnParallel: ['barStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    columnPercent: ['barStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    line: ['lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    area: ['lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    areaPercent: ['lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    dualAxis: ['barStyle', 'lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    scatter: ['pointStyle', 'annotationPoint', 'annotationHorizontalLine', 'annotationVerticalLine'],\n    histogram: ['annotationHorizontalLine'],\n    boxPlot: ['annotationHorizontalLine'],\n  }\n\n  const result: Partial<Record<ChartType, string[]>> = {}\n  for (const [chartType, baseKeyPaths] of Object.entries(dynamicFilterConfig)) {\n    result[chartType as ChartType] = baseKeyPaths.flatMap((basePath) => [\n      `${basePath}[].dynamicFilter`,\n      `${basePath}.dynamicFilter`,\n    ])\n  }\n  return result\n}\n\nconst dynamicFilterKeyPathsByChartType = generateDynamicFilterKeyPaths()\n\n/**\n * 提取图表类型对应的基础路径（用于深拷贝）\n */\nconst getBasePathsForDeepClone = (chartType: ChartType): string[] => {\n  const config: Partial<Record<ChartType, string[]>> = {\n    table: ['bodyCellStyle'],\n    pivotTable: ['bodyCellStyle'],\n    bar: ['barStyle', 'annotationPoint', 'annotationVerticalLine'],\n    barParallel: ['barStyle', 'annotationPoint', 'annotationVerticalLine'],\n    barPercent: ['barStyle', 'annotationPoint', 'annotationVerticalLine'],\n    column: ['barStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    columnParallel: ['barStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    columnPercent: ['barStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    line: ['lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    area: ['lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    areaPercent: ['lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    dualAxis: ['barStyle', 'lineStyle', 'pointStyle', 'annotationPoint', 'annotationHorizontalLine'],\n    scatter: ['pointStyle', 'annotationPoint', 'annotationHorizontalLine', 'annotationVerticalLine'],\n    histogram: ['annotationHorizontalLine'],\n    boxPlot: ['annotationHorizontalLine'],\n  }\n\n  return config[chartType] ?? []\n}\n\nconst parseKeyPath = (path: string) => {\n  return path.split('.').map((segment) => {\n    if (segment.endsWith('[]')) {\n      return { key: segment.slice(0, -2), isArray: true }\n    }\n    return { key: segment, isArray: false }\n  })\n}\n\nconst getValuesByKeyPath = (target: unknown, path: string): unknown[] => {\n  const segments = parseKeyPath(path)\n  let current: unknown[] = [target]\n\n  for (const segment of segments) {\n    const next: unknown[] = []\n    for (const node of current) {\n      if (!node || typeof node !== 'object') continue\n      const value = (node as Record<string, unknown>)[segment.key]\n      if (segment.isArray) {\n        if (Array.isArray(value)) {\n          next.push(...value)\n        }\n      } else if (value !== undefined) {\n        next.push(value)\n      }\n    }\n    current = next\n  }\n\n  return current\n}\n\nconst collectDynamicFiltersByKeyPaths = (target: unknown, chartType: ChartType): DynamicFilter[] => {\n  const paths = dynamicFilterKeyPathsByChartType[chartType] ?? []\n  if (!paths.length) return []\n\n  return paths\n    .flatMap((path) => getValuesByKeyPath(target, path))\n    .filter((value): value is DynamicFilter => isDynamicFilter(value) && !!value?.code)\n}\n/**\n * 执行所有 dynamicFilter 的 code，将结果直接写入 filter.result\n */\nconst executeDynamicFiltersAndInject = async (filters: DynamicFilter[], dataset: any[]): Promise<void> => {\n  if (!filters.length || !dataset.length) return\n\n  await Promise.all(\n    filters.map(async (filter) => {\n      const { success, data, error } = await executeDynamicFilter(filter, dataset)\n      filter.result = {\n        success,\n        error,\n        data: data as TableDynamicFilterRes[] | ChartDynamicFilterRes[],\n      }\n    }),\n  )\n}\n\n/**\n * 针对性深拷贝 vseed 中包含 dynamicFilter 的路径\n * @description 只深拷贝需要修改的路径，避免完全深拷贝的性能开销\n */\nconst deepCloneDynamicFilterPaths = (vseed: any, chartType: ChartType): any => {\n  const basePaths = getBasePathsForDeepClone(chartType)\n  if (!basePaths.length) return { ...vseed }\n\n  const clonedVseed = { ...vseed }\n\n  for (const basePath of basePaths) {\n    if (!(basePath in clonedVseed)) continue\n\n    const value = clonedVseed[basePath]\n\n    // 如果是数组，深拷贝数组及其元素\n    if (Array.isArray(value)) {\n      clonedVseed[basePath] = value.map((item) => {\n        if (!item || typeof item !== 'object') return item\n\n        const clonedItem = { ...item }\n\n        // 如果有 dynamicFilter，深拷贝它\n        if (clonedItem.dynamicFilter && typeof clonedItem.dynamicFilter === 'object') {\n          clonedItem.dynamicFilter = { ...clonedItem.dynamicFilter }\n        }\n\n        return clonedItem\n      })\n    }\n    // 如果是对象\n    else if (value && typeof value === 'object') {\n      clonedVseed[basePath] = { ...value }\n\n      // 如果有 dynamicFilter，深拷贝它\n      if (clonedVseed[basePath].dynamicFilter && typeof clonedVseed[basePath].dynamicFilter === 'object') {\n        clonedVseed[basePath].dynamicFilter = { ...clonedVseed[basePath].dynamicFilter }\n      }\n    }\n  }\n\n  return clonedVseed\n}\n\n/**\n * 准备阶段 - 执行动态过滤器代码\n * @description 在 build() 之前调用，用于：\n *   1. 检查是否存在需要执行的 dynamicFilter (有 code 字段)\n *   2. 创建 vseed 的副本，给 dataset 添加 __row_index\n *   3. 收集所有 dynamicFilter 并执行 code\n *   4. 将结果直接写入 dynamicFilter.result\n *   5. 更新 builder.vseed 为处理后的副本\n * @returns Promise<void>\n */\nexport const prepare = async (builder: Builder): Promise<void> => {\n  // 幂等性：如果已经准备过，直接返回\n  if (builder.isPrepared || !builder.vseed || !builder.vseed?.chartType || !builder.vseed.dataset) {\n    return\n  }\n\n  // 1. 收集原始 vseed 中的所有 dynamicFilter\n  const filters = collectDynamicFiltersByKeyPaths(builder.vseed, builder.vseed.chartType)\n  if (!filters.length) {\n    // 标记为已准备（虽然实际没做什么）\n    builder.isPrepared = true\n    return\n  }\n\n  // 2. 针对性深拷贝 vseed（只拷贝包含 dynamicFilter 的路径）\n  const clonedVseed = deepCloneDynamicFilterPaths(builder.vseed, builder.vseed.chartType)\n\n  // 3. 创建带 __row_index 的 dataset\n  const originalDataset = clonedVseed.dataset as any[]\n  let datasetWithIndex = originalDataset\n\n  // 如果还没有注入 __row_index，创建新的副本\n  if (!originalDataset[0] || !(InnerRowIndex in originalDataset[0])) {\n    datasetWithIndex = originalDataset.map((item, index) => ({\n      ...item,\n      [InnerRowIndex]: index,\n    }))\n  }\n\n  // 4. 更新 builder.vseed，使用深拷贝后的 vseed 和带 __row_index 的 dataset\n  builder.vseed = {\n    ...clonedVseed,\n    dataset: datasetWithIndex,\n  }\n\n  // 5. 重新收集 dynamicFilter（从新的 vseed 中）\n  const clonedFilters = collectDynamicFiltersByKeyPaths(builder.vseed, builder.vseed.chartType)\n\n  // 6. 执行所有 dynamicFilter 的 code，结果直接写入 filter.result\n  try {\n    await executeDynamicFiltersAndInject(clonedFilters, datasetWithIndex)\n  } catch (e) {\n    throw new Error(`Failed to execute dynamic filters: ${(e as Error).message}`)\n  }\n\n  // 7. 标记为已准备\n  builder.isPrepared = true\n}\n"],"names":["generateDynamicFilterKeyPaths","dynamicFilterConfig","result","chartType","baseKeyPaths","Object","basePath","dynamicFilterKeyPathsByChartType","getBasePathsForDeepClone","config","parseKeyPath","path","segment","getValuesByKeyPath","target","segments","current","next","node","value","Array","undefined","collectDynamicFiltersByKeyPaths","paths","isDynamicFilter","executeDynamicFiltersAndInject","filters","dataset","Promise","filter","success","data","error","executeDynamicFilter","deepCloneDynamicFilterPaths","vseed","basePaths","clonedVseed","item","clonedItem","prepare","builder","originalDataset","datasetWithIndex","InnerRowIndex","index","clonedFilters","e","Error"],"mappings":"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"}

package/dist/esm/dataReshape/constant.d.ts

@@ -31,3 +31,4 @@ export declare const BinStartMeasureId = "__BinStart__";
 export declare const BinEndMeasureId = "__BinEnd__";
 export declare const BinCountMeasureId = "__BinCount__";
 export declare const BinPercentageMeasureId = "__BinPercentage__";
+export declare const InnerRowIndex = "__row_index";

package/dist/esm/dataReshape/constant.js

@@ -31,6 +31,7 @@ const BinStartMeasureId = '__BinStart__';
 const BinEndMeasureId = '__BinEnd__';
 const BinCountMeasureId = '__BinCount__';
 const BinPercentageMeasureId = '__BinPercentage__';
-export { AngleEncoding, BinCountMeasureId, BinEndMeasureId, BinPercentageMeasureId, BinStartMeasureId, BoxPlotPivotIndicator, ColorEncoding, ColorIdEncoding, DetailEncoding, DimAxisType, FoldMeasureId, FoldMeasureName, FoldMeasureValue, FoldPrimaryMeasureValue, FoldSecondaryMeasureValue, FoldXMeasureId, FoldXMeasureValue, FoldYMeasureId, FoldYMeasureValue, HierarchyEncoding, LowerWhisker, MeasureId, MeasureName, MedianMeasureId, ORIGINAL_DATA, OutliersMeasureId, PlayerEncoding, Q1MeasureValue, Q3MeasureValue, Separator, UpperWhisker, XEncoding, YEncoding };
+const InnerRowIndex = '__row_index';
+export { AngleEncoding, BinCountMeasureId, BinEndMeasureId, BinPercentageMeasureId, BinStartMeasureId, BoxPlotPivotIndicator, ColorEncoding, ColorIdEncoding, DetailEncoding, DimAxisType, FoldMeasureId, FoldMeasureName, FoldMeasureValue, FoldPrimaryMeasureValue, FoldSecondaryMeasureValue, FoldXMeasureId, FoldXMeasureValue, FoldYMeasureId, FoldYMeasureValue, HierarchyEncoding, InnerRowIndex, LowerWhisker, MeasureId, MeasureName, MedianMeasureId, ORIGINAL_DATA, OutliersMeasureId, PlayerEncoding, Q1MeasureValue, Q3MeasureValue, Separator, UpperWhisker, XEncoding, YEncoding };
 
 //# sourceMappingURL=constant.js.map

package/dist/esm/dataReshape/constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataReshape/constant.js","sources":["webpack://@visactor/vseed/./src/dataReshape/constant.ts"],"sourcesContent":["// Reshape\nexport const ORIGINAL_DATA = '__OriginalData__'\nexport const Separator = '-'\n\n// Measures\nexport const FoldMeasureName = '__MeaName__'\nexport const FoldMeasureId = '__MeaId__'\nexport const FoldMeasureValue = '__MeaValue__'\nexport const MeasureId = FoldMeasureId\nexport const MeasureName = FoldMeasureName\n\n// Measures For DualAxis\nexport const FoldPrimaryMeasureValue = '__MeaPrimaryValue__'\nexport const FoldSecondaryMeasureValue = '__MeaSecondaryValue__'\nexport const DimAxisType = '__Dim_AxisType__'\n\n// Measures For Scatter\nexport const FoldXMeasureValue = '__MeaXValue__'\nexport const FoldYMeasureValue = '__MeaYValue__'\nexport const FoldXMeasureId = '__MeaXId__'\nexport const FoldYMeasureId = '__MeaYId__'\n// Encoding\nexport const XEncoding = '__Dim_X__'\nexport const YEncoding = '__Dim_Y__'\nexport const AngleEncoding = '__Dim_Angle__'\nexport const DetailEncoding = '__Dim_Detail__'\nexport const PlayerEncoding = '__Dim_Player__'\nexport const ColorEncoding = '__Dim_Color__'\nexport const ColorIdEncoding = '__Dim_ColorId__'\nexport const HierarchyEncoding = '__Dim_Hierarchy__'\n\n// Measures For boxPlot\nexport const BoxPlotPivotIndicator = '__BoxPlot_Pivot_Indicator__'\nexport const Q1MeasureValue = '__Q1__'\nexport const Q3MeasureValue = '__Q3__'\nexport const LowerWhisker = '__Lower_Whisker__'\nexport const UpperWhisker = '__Upper_Whisker__'\nexport const OutliersMeasureId = '__Outliers__'\nexport const MedianMeasureId = '__Meadian__'\n\n// Measures For Histogram\nexport const BinStartMeasureId = '__BinStart__'\nexport const BinEndMeasureId = '__BinEnd__'\nexport const BinCountMeasureId = '__BinCount__'\nexport const BinPercentageMeasureId = '__BinPercentage__'\n"],"names":["ORIGINAL_DATA","Separator","FoldMeasureName","FoldMeasureId","FoldMeasureValue","MeasureId","MeasureName","FoldPrimaryMeasureValue","FoldSecondaryMeasureValue","DimAxisType","FoldXMeasureValue","FoldYMeasureValue","FoldXMeasureId","FoldYMeasureId","XEncoding","YEncoding","AngleEncoding","DetailEncoding","PlayerEncoding","ColorEncoding","ColorIdEncoding","HierarchyEncoding","BoxPlotPivotIndicator","Q1MeasureValue","Q3MeasureValue","LowerWhisker","UpperWhisker","OutliersMeasureId","MedianMeasureId","BinStartMeasureId","BinEndMeasureId","BinCountMeasureId","BinPercentageMeasureId"],"mappings":"AACO,MAAMA,gBAAgB;AACtB,MAAMC,YAAY;AAGlB,MAAMC,kBAAkB;AACxB,MAAMC,gBAAgB;AACtB,MAAMC,mBAAmB;AACzB,MAAMC,YAAYF;AAClB,MAAMG,cAAcJ;AAGpB,MAAMK,0BAA0B;AAChC,MAAMC,4BAA4B;AAClC,MAAMC,cAAc;AAGpB,MAAMC,oBAAoB;AAC1B,MAAMC,oBAAoB;AAC1B,MAAMC,iBAAiB;AACvB,MAAMC,iBAAiB;AAEvB,MAAMC,YAAY;AAClB,MAAMC,YAAY;AAClB,MAAMC,gBAAgB;AACtB,MAAMC,iBAAiB;AACvB,MAAMC,iBAAiB;AACvB,MAAMC,gBAAgB;AACtB,MAAMC,kBAAkB;AACxB,MAAMC,oBAAoB;AAG1B,MAAMC,wBAAwB;AAC9B,MAAMC,iBAAiB;AACvB,MAAMC,iBAAiB;AACvB,MAAMC,eAAe;AACrB,MAAMC,eAAe;AACrB,MAAMC,oBAAoB;AAC1B,MAAMC,kBAAkB;AAGxB,MAAMC,oBAAoB;AAC1B,MAAMC,kBAAkB;AACxB,MAAMC,oBAAoB;AAC1B,MAAMC,yBAAyB"}
+{"version":3,"file":"dataReshape/constant.js","sources":["webpack://@visactor/vseed/./src/dataReshape/constant.ts"],"sourcesContent":["// Reshape\nexport const ORIGINAL_DATA = '__OriginalData__'\nexport const Separator = '-'\n\n// Measures\nexport const FoldMeasureName = '__MeaName__'\nexport const FoldMeasureId = '__MeaId__'\nexport const FoldMeasureValue = '__MeaValue__'\nexport const MeasureId = FoldMeasureId\nexport const MeasureName = FoldMeasureName\n\n// Measures For DualAxis\nexport const FoldPrimaryMeasureValue = '__MeaPrimaryValue__'\nexport const FoldSecondaryMeasureValue = '__MeaSecondaryValue__'\nexport const DimAxisType = '__Dim_AxisType__'\n\n// Measures For Scatter\nexport const FoldXMeasureValue = '__MeaXValue__'\nexport const FoldYMeasureValue = '__MeaYValue__'\nexport const FoldXMeasureId = '__MeaXId__'\nexport const FoldYMeasureId = '__MeaYId__'\n// Encoding\nexport const XEncoding = '__Dim_X__'\nexport const YEncoding = '__Dim_Y__'\nexport const AngleEncoding = '__Dim_Angle__'\nexport const DetailEncoding = '__Dim_Detail__'\nexport const PlayerEncoding = '__Dim_Player__'\nexport const ColorEncoding = '__Dim_Color__'\nexport const ColorIdEncoding = '__Dim_ColorId__'\nexport const HierarchyEncoding = '__Dim_Hierarchy__'\n\n// Measures For boxPlot\nexport const BoxPlotPivotIndicator = '__BoxPlot_Pivot_Indicator__'\nexport const Q1MeasureValue = '__Q1__'\nexport const Q3MeasureValue = '__Q3__'\nexport const LowerWhisker = '__Lower_Whisker__'\nexport const UpperWhisker = '__Upper_Whisker__'\nexport const OutliersMeasureId = '__Outliers__'\nexport const MedianMeasureId = '__Meadian__'\n\n// Measures For Histogram\nexport const BinStartMeasureId = '__BinStart__'\nexport const BinEndMeasureId = '__BinEnd__'\nexport const BinCountMeasureId = '__BinCount__'\nexport const BinPercentageMeasureId = '__BinPercentage__'\n\n// Inner row index for code execute\nexport const InnerRowIndex = '__row_index'\n"],"names":["ORIGINAL_DATA","Separator","FoldMeasureName","FoldMeasureId","FoldMeasureValue","MeasureId","MeasureName","FoldPrimaryMeasureValue","FoldSecondaryMeasureValue","DimAxisType","FoldXMeasureValue","FoldYMeasureValue","FoldXMeasureId","FoldYMeasureId","XEncoding","YEncoding","AngleEncoding","DetailEncoding","PlayerEncoding","ColorEncoding","ColorIdEncoding","HierarchyEncoding","BoxPlotPivotIndicator","Q1MeasureValue","Q3MeasureValue","LowerWhisker","UpperWhisker","OutliersMeasureId","MedianMeasureId","BinStartMeasureId","BinEndMeasureId","BinCountMeasureId","BinPercentageMeasureId","InnerRowIndex"],"mappings":"AACO,MAAMA,gBAAgB;AACtB,MAAMC,YAAY;AAGlB,MAAMC,kBAAkB;AACxB,MAAMC,gBAAgB;AACtB,MAAMC,mBAAmB;AACzB,MAAMC,YAAYF;AAClB,MAAMG,cAAcJ;AAGpB,MAAMK,0BAA0B;AAChC,MAAMC,4BAA4B;AAClC,MAAMC,cAAc;AAGpB,MAAMC,oBAAoB;AAC1B,MAAMC,oBAAoB;AAC1B,MAAMC,iBAAiB;AACvB,MAAMC,iBAAiB;AAEvB,MAAMC,YAAY;AAClB,MAAMC,YAAY;AAClB,MAAMC,gBAAgB;AACtB,MAAMC,iBAAiB;AACvB,MAAMC,iBAAiB;AACvB,MAAMC,gBAAgB;AACtB,MAAMC,kBAAkB;AACxB,MAAMC,oBAAoB;AAG1B,MAAMC,wBAAwB;AAC9B,MAAMC,iBAAiB;AACvB,MAAMC,iBAAiB;AACvB,MAAMC,eAAe;AACrB,MAAMC,eAAe;AACrB,MAAMC,oBAAoB;AAC1B,MAAMC,kBAAkB;AAGxB,MAAMC,oBAAoB;AAC1B,MAAMC,kBAAkB;AACxB,MAAMC,oBAAoB;AAC1B,MAAMC,yBAAyB;AAG/B,MAAMC,gBAAgB"}

package/dist/esm/dataSelector/selector.d.ts

@@ -1,7 +1,8 @@
 import type { Datum } from '../types';
-import type { DimensionSelector, MeasureSelector, PartialDatumSelector, Selector, Selectors, ValueSelector } from '../types/dataSelector';
+import type { ChartDynamicFilter, ChartDynamicFilterRes, DimensionSelector, MeasureSelector, PartialDatumSelector, Selector, Selectors, TableDynamicFilterRes, TableDynamicFilter, ValueSelector, ValueDynamicFilter } from '../types/dataSelector';
+export type DynamicFilter = TableDynamicFilter | ChartDynamicFilter | ValueDynamicFilter;
+export type DynamicFilterResult = TableDynamicFilterRes[] | ChartDynamicFilterRes[] | number | string;
 export declare const selector: (vchartDatum: Datum, selector: Selector | Selectors | undefined | null, selectorMode?: "And" | "Or") => boolean;
-export declare const selectorDatum: (datum: Datum, selector: Selector | Selectors | undefined | null) => Datum[];
 export declare const isValueSelector: (selector: Selector) => selector is ValueSelector;
 export declare const isPartialDatumSelector: (selector: Selector) => selector is PartialDatumSelector;
 export declare const isMeasureSelector: (selector: Selector) => selector is MeasureSelector;
@@ -10,3 +11,71 @@ export declare const selectByMeasure: (selector: MeasureSelector, datum: Datum)
 export declare const selectByDmension: (selector: DimensionSelector, datum: Datum) => boolean;
 export declare const selectByPartial: (selector: PartialDatumSelector, datum: Datum) => boolean;
 export declare const selectByValue: (selector: ValueSelector, datum: Datum) => boolean;
+/**
+ * 识别是否为row-with-field动态过滤器
+ */
+export declare const isRowWithFieldDynamicFilter: (selector: any) => selector is TableDynamicFilter;
+/**
+ * 识别是否为数值动态过滤器（用于标注线等场景）
+ */
+export declare const isValueDynamicFilter: (selector: any) => selector is ValueDynamicFilter;
+/**
+ * 识别是否为动态过滤器（通用判断，包含所有类型的动态过滤器）
+ */
+export declare const isDynamicFilter: (selector: any) => selector is DynamicFilter;
+/**
+ * 执行动态过滤器代码，获取匹配结果
+ * @description
+ * 阶段1：执行阶段 - 一次性执行 dynamicFilter.code，获取所有匹配结果
+ * - TableDynamicFilter → CellSelector[]
+ * - ChartDynamicFilter → PartialDatumSelector[]
+ * - ValueDynamicFilter → number | string
+ *
+ * @param filter 动态过滤器配置
+ * @param allData 完整数据集
+ * @returns 执行结果数组或标量值
+ */
+export declare const executeDynamicFilter: (filter: DynamicFilter, allData: Datum[]) => Promise<{
+    success: boolean;
+    data: DynamicFilterResult;
+    error?: string;
+}>;
+/**
+ * 匹配动态过滤器结果
+ * @description
+ * 阶段2：匹配阶段 - 判断当前 datum/cell 是否在执行结果中
+ * - 使用 OR 策略：结果数组中任一项匹配即返回 true
+ * - 表格场景：检查 { row, field } 是否在 CellSelector[] 中
+ * - 图表场景：检查 datum 的维度值是否匹配 PartialDatumSelector[] 中任一项
+ * - 数值场景：不适用（ValueDynamicFilter返回标量值，不用于匹配）
+ *
+ * @param result 动态过滤器执行结果（CellSelector[] 或 PartialDatumSelector[]，不包括 ValueDynamicFilter）
+ * @param datum 当前数据项
+ * @param selectorType 选择器类型（用于区分表格和图表动态过滤器）
+ * @returns 是否匹配（OR 策略）
+ */
+export declare const matchDynamicFilterResult: (result: DynamicFilterResult, datum: Datum, selectorType?: "table" | "chart") => boolean;
+/**
+ * 带有动态过滤器支持的选择器
+ * @description
+ * 处理流程（两阶段设计）：
+ *
+ * 阶段1 - 执行（Execute）：
+ *   - 在 prepare() 阶段执行，结果写入 dynamicFilter.result
+ *   - TableDynamicFilter → CellSelector[]
+ *   - ChartDynamicFilter → PartialDatumSelector[]
+ *   - ValueDynamicFilter → number | string（用于读取，不用于匹配）
+ *
+ * 阶段2 - 匹配（Match）：
+ *   - 读取 dynamicFilter.result
+ *   - 使用 OR 策略：结果数组中任一项匹配即返回 true
+ *   - 表格：判断 { row, field } 是否在 CellSelector[] 中
+ *   - 图表：判断 datum 是否匹配 PartialDatumSelector[] 中任一项
+ *   - 数值：不用于匹配，直接返回 false（数值过滤器在主要用于标注线值，不用于行列选择）
+ *
+ * @param vchartDatum 单个数据项
+ * @param selectorConfig 选择器配置（可包含 DynamicFilter）
+ * @param defaultSelector 传统选择器（仅在 DynamicFilter 无结果且有 fallback 时使用）
+ * @returns 该数据项是否符合选择条件
+ */
+export declare const selectorWithDynamicFilter: (vchartDatum: Datum, selectorConfig: DynamicFilter, defaultSelector?: Selector | Selector[] | null) => boolean;