@visactor/vseed 0.4.8 → 0.4.10

package/dist/esm/types/dataSelector/selector.js.map

@@ -1 +1 @@
-{"version":3,"file":"types/dataSelector/selector.js","sources":["webpack://@visactor/vseed/./src/types/dataSelector/selector.ts"],"sourcesContent":["import { z } from 'zod'\nimport { zDatum, type Datum } from '../properties'\n\nexport type ValueSelector = string | number\n\nexport type PartialDatumSelector = Datum\n\n/**\n * @description 指标选择器, 用于选择数据项中指标字段的值\n */\nexport type MeasureSelector = {\n  /**\n   * @description 指标字段, measures 某一项的 id\n   */\n  field: string\n  /**\n   * @description 操作符\n   * - =: 选择数据项中指标字段的值等于 value 的数据项\n   * - ==: 选择数据项中指标字段的值等于 value 的数据项\n   * - !=: 选择数据项中指标字段的值不等于 value 的数据项\n   * - >: 选择数据项中指标字段的值大于 value 的数据项\n   * - <: 选择数据项中指标字段的值小于 value 的数据项\n   * - >=: 选择数据项中指标字段的值大于等于 value 的数据项\n   * - <=: 选择数据项中指标字段的值小于等于 value 的数据项\n   * - between: 选择数据项中指标字段的值在 value 之间的 data item\n   */\n  operator?: '=' | '==' | '!=' | '>' | '<' | '>=' | '<=' | 'between'\n  /**\n   * @description 操作符\n   * - =: 选择数据项中指标字段的值等于 value 的数据项, 会将值转换为字符串后进行比较, 因此 1 == \"1\" 为 true\n   * - ==: 选择数据项中指标字段的值精准等于 value 的数据项, 不会做任何特殊处理, 因此 1 == \"1\" 为 false\n   * - !=: 选择数据项中指标字段的值不等于 value 的数据项\n   * - >: 选择数据项中指标字段的值大于 value 的数据项\n   * - <: 选择数据项中指标字段的值小于 value 的数据项\n   * - >=: 选择数据项中指标字段的值大于等于 value 的数据项\n   * - <=: 选择数据项中指标字段的值小于等于 value 的数据项\n   * - between: 选择数据项中指标字段的值在 value 之间的 data item\n   * same as operator\n   */\n  op?: '=' | '==' | '!=' | '>' | '<' | '>=' | '<=' | 'between'\n  /**\n   * @description 选择数据项中指标字段的值\n   * - 仅 op 为 between 时, value 为长度为2的数组, 数组中的元素为指标字段的最小值和最大值\n   * - 其他情况, value 为指标字段的单个值\n   */\n  value: string | number | Array<string | number>\n  // /**\n  //  * @description 是否使用原始数据进行数据匹配, 开启后会有更多的数据被匹配到\n  //  * 若下述数据, measures 仅设置了 value, field 为 isHigh 或 isLow, op 为 =, value 为 1,\n  //  * 关闭useOrigin时, 数据项并不会考虑measures之外的字段, 因此field为isHigh或isLow的字段会被忽略\n  //  * 开启useOrigin时, 会直接使用整个数据项进行匹配\n  //  * [\n  //  *  {value: 100, isHigh: 1, isLow: 0},\n  //  *  {value: 200, isHigh: 0, isLow: 1},\n  //  *  {value: 300, isHigh: 1, isLow: 0},\n  //  * ]\n  //  * @default false\n  //  */\n  // useOrigin?: boolean\n}\n\n/**\n * @description 维度选择器, 用于选择数据项中维度字段的值\n */\nexport type DimensionSelector = {\n  /**\n   * @description 维度字段, dimensions 某一项的 id\n   */\n  field: string\n  /**\n   * @description 操作符\n   * - in: 选择数据项中维度字段的值在 value 中的数据项\n   * - not in: 选择数据项中维度字段的值不在 value 中的数据项\n   */\n  operator?: 'in' | 'not in'\n  /**\n   * @description 操作符\n   * - in: 选择数据项中维度字段的值在 value 中的数据项\n   * - not in: 选择数据项中维度字段的值不在 value 中的数据项\n   * same as operator\n   */\n  op?: 'in' | 'not in'\n  /**\n   * @description 选择数据项中维度字段的值, 支持数组\n   */\n  value: string | number | Array<string | number>\n  // /**\n  //  * @description 是否使用原始数据进行数据匹配, 开启后会有更多的数据被匹配到\n  //  * 若下述数据, dimensions 仅设置了 name, field 为 name, op 为 =, value 为 \"high\",\n  //  * 关闭useOrigin时, 数据项并不会考虑dimensions之外的字段, 因此field为name的字段会被忽略\n  //  * 开启useOrigin时, 会直接使用整个数据项进行匹配\n  //  * [\n  //  *  {name: \"low\", isHigh: \"false\", isLow: \"true\"},\n  //  *  {name: \"low\", isHigh: \"false\", isLow: \"true\"},\n  //  *  {name: \"high\", isHigh: \"true\", isLow: \"false\"},\n  //  * ]\n  //  * @default false\n  //  */\n  // useOrigin?: boolean\n}\n\nexport type Selector = ValueSelector | PartialDatumSelector | MeasureSelector | DimensionSelector\n\nexport type AreaSelector = MeasureSelector | DimensionSelector\n\nexport type AreaSelectors = Array<AreaSelector>\n\nexport type Selectors = Array<Selector>\n\n/**\n * 行索引与字段组合的数据结构\n * @description 用于表示动态筛选器返回的结果，指向原始数据中特定行的特定字段\n */\nexport type RowWithFieldRes = {\n  /**\n   * 原始数据项的行索引\n   * @description 从 0 开始计数，对应数据源中数据项的位置\n   */\n  __row_index: number\n  /**\n   * 字段名称\n   * @description\n   * - 具体字段名：表示该行中的某个特定字段\n   * - '*'：表示该行的所有字段（整行）\n   */\n  field: string | '*'\n}\n\n/**\n * 部分数据项结果\n * @description 用于表示动态筛选器返回的部分数据项\n */\nexport type PartialDatumRes = Datum\n\nexport type DynamicFilterExecutionResult<T> = {\n  success: boolean\n  data?: T[]\n  error?: string\n}\n\n/**\n * 表格动态筛选器配置\n * @description 通过 AI 生成的 JavaScript 代码实现表格单元格级别的精确筛选\n * @environment 仅支持浏览器环境（需要 Web Worker），Node.js 环境将使用 fallback\n */\nexport interface TableDynamicFilter {\n  type: 'row-with-field'\n  /**\n   * 用户的筛选需求描述（自然语言）\n   * @example \"高亮销售额大于1000的单元格\"\n   * @example \"高亮每行中最大值所在的单元格\"\n   */\n  description?: string\n\n  /**\n   * AI 生成的 JavaScript 筛选代码\n   * @description\n   * - 只能使用内置工具函数（通过 _ 或 R 访问）\n   * - 输入参数: data (数组)，每个 item 包含 _index 字段表示行号\n   * - 必须返回单元格选择器数组: Array<{ __row_index: number, field: string }>\n   * - field 为 \"*\" 时表示整行高亮\n   * - 禁止使用: eval, Function, 异步操作, DOM API, 网络请求\n   *\n   * @example Top N 筛选\n   * dynamicFilter = {\n   *   type: 'row-with-field',\n   *   description: '高亮销售额最高的前3个产品',\n   *   code: `\n   *     const sorted = _.sortBy(data, 'sales');\n   *     const reversed = [...sorted].reverse();\n   *     const result = _.take(reversed, 3);\n   *     return _.flatten(\n   *       _.map(result, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 多条件筛选\n   * dynamicFilter = {\n   *   type: 'row-with-field',\n   *   description: '高亮利润率大于20%且销售额超过5000的产品',\n   *   code: `\n   *     const matched = _.filter(data, item => {\n   *       const profitRate = (item.profit / item.sales) * 100;\n   *       return profitRate > 20 && item.sales > 5000;\n   *     });\n   *     return _.flatten(\n   *       _.map(matched, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 相对值筛选\n   * dynamicFilter = {   *\n   *   type: 'row-with-field',\n   *   description: '高亮销售额高于平均值的产品',\n   *   code: `\n   *     const avgSales = _.meanBy(data, 'sales');\n   *     const matched = _.filter(data, item => item.sales > avgSales);\n   *     return _.flatten(\n   *       _.map(matched, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 分组筛选\n   * dynamicFilter = {\n   *  type: 'row-with-field',\n   *  description: '每个区域中销售额最高的产品',\n   *  code: `\n   *     const grouped = _.groupBy(data, 'region');\n   *     const topByRegion = _.map(_.values(grouped), group => _.maxBy(group, 'sales'));\n   *     return _.flatten(\n   *       _.map(topByRegion, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 整行高亮\n   * dynamicFilter = {\n   *   description: '高亮销售额大于利润的整行',\n   *   code: `\n   *     const matched = _.filter(data, item => item.sales > item.profit);\n   *     return matched.map(item => ({\n   *       __row_index: item._index,\n   *       field: '*'\n   *     }));\n   *   `,\n   *   enabled: true\n   * }\n   */\n  code: string\n\n  /**\n   * 代码执行失败或环境不支持时的降级方案\n   */\n  fallback?: Selector | Selectors\n\n  /**\n   * 动态筛选执行结果（运行期字段）\n   * @description prepare() 阶段写入，运行时只读\n   */\n  result?: DynamicFilterExecutionResult<RowWithFieldRes>\n}\n\n/**\n * 图表动态筛选器配置\n * @description 通过 AI 生成的 JavaScript 代码实现图表标记（柱子、点等）的筛选\n * @environment 仅支持浏览器环境（需要 Web Worker），Node.js 环境将使用 fallback\n */\nexport interface ChartDynamicFilter {\n  type: 'row-with-field'\n  /**\n   * 用户的筛选需求描述（自然语言）\n   * @example \"高亮销售额大于1000的柱子\"\n   * @example \"高亮每个区域中利润率最高的柱子\"\n   */\n  description?: string\n\n  /**\n   * AI 生成的 JavaScript 筛选代码\n   * @description\n   * - 只能使用内置工具函数（通过 _ 或 R 访问）\n   * - 输入参数: data (数组)，每个 item 包含 __row_index 字段表示行号\n   * - 必须返回行索引与字段组合的数组: Array<{ __row_index: number, field: string }>\n   * - __row_index 表示原始数据项的行号，field 表示需要高亮的字段\n   * - 禁止使用: eval, Function, 异步操作, DOM API, 网络请求\n   *\n   * @example 高亮销售额大于1000的数据项的 sales 字段\n   * ```javascript\n   * const filtered = _.filter(data, item => item.sales > 1000);\n   * return _.map(filtered, item => ({\n   *   __row_index: item.__row_index,\n   *   field: 'sales'\n   * }));\n   * ```\n   *\n   * @example 高亮每个区域中利润率最高的数据项\n   * ```javascript\n   * const grouped = _.groupBy(data, 'area');\n   * const maxItems = _.map(grouped, group =>\n   *   _.maxBy(group, item => item.profit / item.sales)\n   * );\n   * return _.flatten(\n   *   _.map(maxItems, item => [\n   *     { __row_index: item.__row_index, field: 'product' },\n   *     { __row_index: item.__row_index, field: 'profit' }\n   *   ])\n   * );\n   * ```\n   *\n   * @example 高亮多条件筛选的数据项\n   * ```javascript\n   * const filtered = _.filter(data, item => {\n   *   const profitRate = item.profit / item.sales;\n   *   return profitRate > 0.2 && item.sales > 5000;\n   * });\n   * return _.flatten(\n   *   _.map(filtered, item => [\n   *     { __row_index: item.__row_index, field: 'product' },\n   *     { __row_index: item.__row_index, field: 'sales' }\n   *   ])\n   * );\n   * ```\n   */\n  code: string\n\n  /**\n   * 代码执行失败或环境不支持时的降级方案\n   */\n  fallback?: Selector | Selectors\n\n  /**\n   * 动态筛选执行结果（运行期字段）\n   * @description prepare() 阶段写入，运行时只读\n   */\n  result?: DynamicFilterExecutionResult<RowWithFieldRes>\n}\n\nexport interface ValueDynamicFilter {\n  type: 'value'\n  /**\n   * 用户的筛选需求描述（自然语言）\n   * @example \"获取销售额最高的值作为标注线参考\"\n   * @example \"计算平均销售额用于标注线\"\n   */\n  description?: string\n\n  /**\n   * AI 生成的 JavaScript 筛选代码\n   * @description\n   * - 只能使用内置工具函数（通过 _ 或 R 访问）\n   * - 输入参数: data (数组)\n   * - 必须返回单个数值或字符串: number | string\n   * - 适用场景：标注线（水平线、垂直线）需要的动态数值\n   * - 禁止使用: eval, Function, 异步操作, DOM API, 网络请求\n   *\n   * @example 获取销售额最大值作为标注线值\n   * ```javascript\n   * const maxSales = _.maxBy(data, 'sales')?.sales;\n   * return maxSales || 0;\n   * ```\n   *\n   * @example 计算平均值用于标注线\n   * ```javascript\n   * const avgSales = _.meanBy(data, 'sales');\n   * return _.round(avgSales, 2);\n   * ```\n   *\n   * @example 获取分位数作为标注线\n   * ```javascript\n   * const sorted = _.sortBy(data, 'sales');\n   * const index = Math.floor(sorted.length * 0.75);\n   * return sorted[index]?.sales || 0;\n   * ```\n   *\n   * @example 根据条件计算目标值\n   * ```javascript\n   * const currentYearTotal = _.sumBy(\n   *   _.filter(data, item => item.year === 2024),\n   *   'sales'\n   * );\n   * return currentYearTotal;\n   * ```\n   */\n  code: string\n\n  /**\n   * 代码执行失败或环境不支持时的降级方案\n   */\n  fallback?: string | number\n\n  /**\n   * 动态筛选执行结果（运行期字段）\n   * @description prepare() 阶段写入，运行时只读\n   */\n  result?: {\n    success: boolean\n    data?: number | string\n  }\n}\n\nexport const zPartialSelector = zDatum\nexport const zMeasureSelector = z.object({\n  field: z.string(),\n  operator: z.enum(['=', '==', '!=', '>', '<', '>=', '<=', 'between']).nullish(),\n  op: z.enum(['=', '==', '!=', '>', '<', '>=', '<=', 'between']).nullish(),\n  value: z.union([z.string(), z.number(), z.array(z.union([z.string(), z.number()]))]),\n})\n\nexport const zDimensionSelector = z.object({\n  field: z.string(),\n  operator: z.enum(['in', 'not in']).nullish(),\n  op: z.enum(['in', 'not in']).nullish(),\n  value: z.union([z.string(), z.number(), z.array(z.union([z.string(), z.number()]))]),\n})\n\nexport const zSelector = z.union([z.string(), z.number(), zMeasureSelector, zDimensionSelector, zPartialSelector])\n\nexport const zSelectors = z.array(zSelector)\n\nexport const zAreaSelector = z.union([zMeasureSelector, zDimensionSelector])\n\nexport const zAreaSelectors = z.array(zAreaSelector)\n\nexport const zCellSelector = z.object({\n  __row_index: z.number(),\n  field: z.union([z.string(), z.literal('*')]),\n})\n\nexport const zTableDynamicFilter = z.object({\n  type: z.literal('row-with-field'),\n  description: z.string().optional(),\n  code: z.string(),\n  fallback: z.union([zSelector, zSelectors]).optional(),\n  result: z\n    .object({\n      success: z.boolean(),\n      data: z.array(zCellSelector).optional(),\n    })\n    .optional(),\n})\n\nexport const zChartDynamicFilter = z.object({\n  type: z.literal('row-with-field'),\n  description: z.string().optional(),\n  code: z.string(),\n  fallback: z.union([zSelector, zSelectors]).optional(),\n  result: z\n    .object({\n      success: z.boolean(),\n      data: z.array(zCellSelector).optional(),\n    })\n    .optional(),\n})\n\nexport const zValueDynamicFilter = z.object({\n  type: z.literal('value'),\n  description: z.string().optional(),\n  code: z.string(),\n  fallback: z.union([z.string(), z.number()]).optional(),\n  result: z\n    .object({\n      success: z.boolean(),\n      data: z.union([z.number(), z.string()]).optional(),\n    })\n    .optional(),\n})\n\n/**\n * @deprecated 请使用 zTableDynamicFilter 或 zChartDynamicFilter\n */\nexport const zDynamicFilter = z.union([zTableDynamicFilter, zChartDynamicFilter])\n"],"names":["zPartialSelector","zDatum","zMeasureSelector","z","zDimensionSelector","zSelector","zSelectors","zAreaSelector","zAreaSelectors","zCellSelector","zTableDynamicFilter","zChartDynamicFilter","zValueDynamicFilter","zDynamicFilter"],"mappings":";;AA8YO,MAAMA,mBAAmBC;AACzB,MAAMC,mBAAmBC,EAAE,MAAM,CAAC;IACvC,OAAOA,EAAE,MAAM;IACf,UAAUA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAK;QAAM;QAAM;QAAK;QAAK;QAAM;QAAM;KAAU,EAAE,OAAO;IAC5E,IAAIA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAK;QAAM;QAAM;QAAK;QAAK;QAAM;QAAM;KAAU,EAAE,OAAO;IACtE,OAAOA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,MAAM;QAAIA,EAAE,KAAK,CAACA,EAAE,KAAK,CAAC;YAACA,EAAE,MAAM;YAAIA,EAAE,MAAM;SAAG;KAAG;AACrF;AAEO,MAAMC,qBAAqBD,EAAE,MAAM,CAAC;IACzC,OAAOA,EAAE,MAAM;IACf,UAAUA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAM;KAAS,EAAE,OAAO;IAC1C,IAAIA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAM;KAAS,EAAE,OAAO;IACpC,OAAOA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,MAAM;QAAIA,EAAE,KAAK,CAACA,EAAE,KAAK,CAAC;YAACA,EAAE,MAAM;YAAIA,EAAE,MAAM;SAAG;KAAG;AACrF;AAEO,MAAME,YAAYF,EAAE,KAAK,CAAC;IAACA,EAAE,MAAM;IAAIA,EAAE,MAAM;IAAID;IAAkBE;IAAoBJ;CAAiB;AAE1G,MAAMM,aAAaH,EAAE,KAAK,CAACE;AAE3B,MAAME,gBAAgBJ,EAAE,KAAK,CAAC;IAACD;IAAkBE;CAAmB;AAEpE,MAAMI,iBAAiBL,EAAE,KAAK,CAACI;AAE/B,MAAME,gBAAgBN,EAAE,MAAM,CAAC;IACpC,aAAaA,EAAE,MAAM;IACrB,OAAOA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,OAAO,CAAC;KAAK;AAC7C;AAEO,MAAMO,sBAAsBP,EAAE,MAAM,CAAC;IAC1C,MAAMA,EAAE,OAAO,CAAC;IAChB,aAAaA,EAAE,MAAM,GAAG,QAAQ;IAChC,MAAMA,EAAE,MAAM;IACd,UAAUA,EAAE,KAAK,CAAC;QAACE;QAAWC;KAAW,EAAE,QAAQ;IACnD,QAAQH,EAAAA,MACC,CAAC;QACN,SAASA,EAAE,OAAO;QAClB,MAAMA,EAAE,KAAK,CAACM,eAAe,QAAQ;IACvC,GACC,QAAQ;AACb;AAEO,MAAME,sBAAsBR,EAAE,MAAM,CAAC;IAC1C,MAAMA,EAAE,OAAO,CAAC;IAChB,aAAaA,EAAE,MAAM,GAAG,QAAQ;IAChC,MAAMA,EAAE,MAAM;IACd,UAAUA,EAAE,KAAK,CAAC;QAACE;QAAWC;KAAW,EAAE,QAAQ;IACnD,QAAQH,EAAAA,MACC,CAAC;QACN,SAASA,EAAE,OAAO;QAClB,MAAMA,EAAE,KAAK,CAACM,eAAe,QAAQ;IACvC,GACC,QAAQ;AACb;AAEO,MAAMG,sBAAsBT,EAAE,MAAM,CAAC;IAC1C,MAAMA,EAAE,OAAO,CAAC;IAChB,aAAaA,EAAE,MAAM,GAAG,QAAQ;IAChC,MAAMA,EAAE,MAAM;IACd,UAAUA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,MAAM;KAAG,EAAE,QAAQ;IACpD,QAAQA,EAAAA,MACC,CAAC;QACN,SAASA,EAAE,OAAO;QAClB,MAAMA,EAAE,KAAK,CAAC;YAACA,EAAE,MAAM;YAAIA,EAAE,MAAM;SAAG,EAAE,QAAQ;IAClD,GACC,QAAQ;AACb;AAKO,MAAMU,iBAAiBV,EAAE,KAAK,CAAC;IAACO;IAAqBC;CAAoB"}
+{"version":3,"file":"types/dataSelector/selector.js","sources":["webpack://@visactor/vseed/./src/types/dataSelector/selector.ts"],"sourcesContent":["import { z } from 'zod'\nimport { zDatum, type Datum } from '../properties'\n\nexport type ValueSelector = string | number\n\nexport type PartialDatumSelector = Datum\n\n/**\n * @description 字段选择器，用于直接选择指定字段（列），不涉及条件判断\n */\nexport type FieldSelector = {\n  /**\n   * @description 字段名，可以是单个字段或多个字段数组\n   * @example 单个字段\n   * field: 'sales'\n   * @example 多个字段\n   * field: ['sales', 'profit', 'revenue']\n   */\n  field: string | string[]\n}\n\n/**\n * @description 指标选择器, 用于选择数据项中指标字段的值\n */\nexport type MeasureSelector = {\n  /**\n   * @description 指标字段, measures 某一项的 id\n   */\n  field: string\n  /**\n   * @description 操作符\n   * - =: 选择数据项中指标字段的值等于 value 的数据项\n   * - ==: 选择数据项中指标字段的值等于 value 的数据项\n   * - !=: 选择数据项中指标字段的值不等于 value 的数据项\n   * - >: 选择数据项中指标字段的值大于 value 的数据项\n   * - <: 选择数据项中指标字段的值小于 value 的数据项\n   * - >=: 选择数据项中指标字段的值大于等于 value 的数据项\n   * - <=: 选择数据项中指标字段的值小于等于 value 的数据项\n   * - between: 选择数据项中指标字段的值在 value 之间的 data item\n   */\n  operator?: '=' | '==' | '!=' | '>' | '<' | '>=' | '<=' | 'between'\n  /**\n   * @description 操作符\n   * - =: 选择数据项中指标字段的值等于 value 的数据项, 会将值转换为字符串后进行比较, 因此 1 == \"1\" 为 true\n   * - ==: 选择数据项中指标字段的值精准等于 value 的数据项, 不会做任何特殊处理, 因此 1 == \"1\" 为 false\n   * - !=: 选择数据项中指标字段的值不等于 value 的数据项\n   * - >: 选择数据项中指标字段的值大于 value 的数据项\n   * - <: 选择数据项中指标字段的值小于 value 的数据项\n   * - >=: 选择数据项中指标字段的值大于等于 value 的数据项\n   * - <=: 选择数据项中指标字段的值小于等于 value 的数据项\n   * - between: 选择数据项中指标字段的值在 value 之间的 data item\n   * same as operator\n   */\n  op?: '=' | '==' | '!=' | '>' | '<' | '>=' | '<=' | 'between'\n  /**\n   * @description 选择数据项中指标字段的值\n   * - 仅 op 为 between 时, value 为长度为2的数组, 数组中的元素为指标字段的最小值和最大值\n   * - 其他情况, value 为指标字段的单个值\n   */\n  value: string | number | Array<string | number>\n  // /**\n  //  * @description 是否使用原始数据进行数据匹配, 开启后会有更多的数据被匹配到\n  //  * 若下述数据, measures 仅设置了 value, field 为 isHigh 或 isLow, op 为 =, value 为 1,\n  //  * 关闭useOrigin时, 数据项并不会考虑measures之外的字段, 因此field为isHigh或isLow的字段会被忽略\n  //  * 开启useOrigin时, 会直接使用整个数据项进行匹配\n  //  * [\n  //  *  {value: 100, isHigh: 1, isLow: 0},\n  //  *  {value: 200, isHigh: 0, isLow: 1},\n  //  *  {value: 300, isHigh: 1, isLow: 0},\n  //  * ]\n  //  * @default false\n  //  */\n  // useOrigin?: boolean\n}\n\n/**\n * @description 维度选择器, 用于选择数据项中维度字段的值\n */\nexport type DimensionSelector = {\n  /**\n   * @description 维度字段, dimensions 某一项的 id\n   */\n  field: string\n  /**\n   * @description 操作符\n   * - in: 选择数据项中维度字段的值在 value 中的数据项\n   * - not in: 选择数据项中维度字段的值不在 value 中的数据项\n   */\n  operator?: 'in' | 'not in'\n  /**\n   * @description 操作符\n   * - in: 选择数据项中维度字段的值在 value 中的数据项\n   * - not in: 选择数据项中维度字段的值不在 value 中的数据项\n   * same as operator\n   */\n  op?: 'in' | 'not in'\n  /**\n   * @description 选择数据项中维度字段的值, 支持数组\n   */\n  value: string | number | Array<string | number>\n  // /**\n  //  * @description 是否使用原始数据进行数据匹配, 开启后会有更多的数据被匹配到\n  //  * 若下述数据, dimensions 仅设置了 name, field 为 name, op 为 =, value 为 \"high\",\n  //  * 关闭useOrigin时, 数据项并不会考虑dimensions之外的字段, 因此field为name的字段会被忽略\n  //  * 开启useOrigin时, 会直接使用整个数据项进行匹配\n  //  * [\n  //  *  {name: \"low\", isHigh: \"false\", isLow: \"true\"},\n  //  *  {name: \"low\", isHigh: \"false\", isLow: \"true\"},\n  //  *  {name: \"high\", isHigh: \"true\", isLow: \"false\"},\n  //  * ]\n  //  * @default false\n  //  */\n  // useOrigin?: boolean\n}\n\nexport type Selector = ValueSelector | PartialDatumSelector | MeasureSelector | DimensionSelector\n\nexport type AreaSelector = MeasureSelector | DimensionSelector\n\nexport type AreaSelectors = Array<AreaSelector>\n\nexport type Selectors = Array<Selector>\n\n/**\n * 行索引与字段组合的数据结构\n * @description 用于表示动态筛选器返回的结果，指向原始数据中特定行的特定字段\n */\nexport type RowWithFieldRes = {\n  /**\n   * 原始数据项的行索引\n   * @description 从 0 开始计数，对应数据源中数据项的位置\n   */\n  __row_index: number\n  /**\n   * 字段名称\n   * @description\n   * - 具体字段名：表示该行中的某个特定字段\n   * - '*'：表示该行的所有字段（整行）\n   */\n  field: string | '*'\n}\n\n/**\n * 部分数据项结果\n * @description 用于表示动态筛选器返回的部分数据项\n */\nexport type PartialDatumRes = Datum\n\nexport type DynamicFilterExecutionResult<T> = {\n  success: boolean\n  data?: T[]\n  error?: string\n}\n\n/**\n * 表格动态筛选器配置\n * @description 通过 AI 生成的 JavaScript 代码实现表格单元格级别的精确筛选\n * @environment 仅支持浏览器环境（需要 Web Worker），Node.js 环境将使用 fallback\n */\nexport interface TableDynamicFilter {\n  type: 'row-with-field'\n  /**\n   * 用户的筛选需求描述（自然语言）\n   * @example \"高亮销售额大于1000的单元格\"\n   * @example \"高亮每行中最大值所在的单元格\"\n   */\n  description?: string\n\n  /**\n   * AI 生成的 JavaScript 筛选代码\n   * @description\n   * - 只能使用内置工具函数（通过 _ 或 R 访问）\n   * - 输入参数: data (数组)，每个 item 包含 _index 字段表示行号\n   * - 必须返回单元格选择器数组: Array<{ __row_index: number, field: string }>\n   * - field 为 \"*\" 时表示整行高亮\n   * - 禁止使用: eval, Function, 异步操作, DOM API, 网络请求\n   *\n   * @example Top N 筛选\n   * dynamicFilter = {\n   *   type: 'row-with-field',\n   *   description: '高亮销售额最高的前3个产品',\n   *   code: `\n   *     const sorted = _.sortBy(data, 'sales');\n   *     const reversed = [...sorted].reverse();\n   *     const result = _.take(reversed, 3);\n   *     return _.flatten(\n   *       _.map(result, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 多条件筛选\n   * dynamicFilter = {\n   *   type: 'row-with-field',\n   *   description: '高亮利润率大于20%且销售额超过5000的产品',\n   *   code: `\n   *     const matched = _.filter(data, item => {\n   *       const profitRate = (item.profit / item.sales) * 100;\n   *       return profitRate > 20 && item.sales > 5000;\n   *     });\n   *     return _.flatten(\n   *       _.map(matched, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 相对值筛选\n   * dynamicFilter = {   *\n   *   type: 'row-with-field',\n   *   description: '高亮销售额高于平均值的产品',\n   *   code: `\n   *     const avgSales = _.meanBy(data, 'sales');\n   *     const matched = _.filter(data, item => item.sales > avgSales);\n   *     return _.flatten(\n   *       _.map(matched, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 分组筛选\n   * dynamicFilter = {\n   *  type: 'row-with-field',\n   *  description: '每个区域中销售额最高的产品',\n   *  code: `\n   *     const grouped = _.groupBy(data, 'region');\n   *     const topByRegion = _.map(_.values(grouped), group => _.maxBy(group, 'sales'));\n   *     return _.flatten(\n   *       _.map(topByRegion, item => [\n   *         { __row_index: item._index, field: 'product' },\n   *         { __row_index: item._index, field: 'sales' }\n   *       ])\n   *     );\n   *   `,\n   *   enabled: true\n   * }\n   *\n   * @example 整行高亮\n   * dynamicFilter = {\n   *   description: '高亮销售额大于利润的整行',\n   *   code: `\n   *     const matched = _.filter(data, item => item.sales > item.profit);\n   *     return matched.map(item => ({\n   *       __row_index: item._index,\n   *       field: '*'\n   *     }));\n   *   `,\n   *   enabled: true\n   * }\n   */\n  code: string\n\n  /**\n   * 代码执行失败或环境不支持时的降级方案\n   */\n  fallback?: Selector | Selectors\n\n  /**\n   * 动态筛选执行结果（运行期字段）\n   * @description prepare() 阶段写入，运行时只读\n   */\n  result?: DynamicFilterExecutionResult<RowWithFieldRes>\n}\n\n/**\n * 图表动态筛选器配置\n * @description 通过 AI 生成的 JavaScript 代码实现图表标记（柱子、点等）的筛选\n * @environment 仅支持浏览器环境（需要 Web Worker），Node.js 环境将使用 fallback\n */\nexport interface ChartDynamicFilter {\n  type: 'row-with-field'\n  /**\n   * 用户的筛选需求描述（自然语言）\n   * @example \"高亮销售额大于1000的柱子\"\n   * @example \"高亮每个区域中利润率最高的柱子\"\n   */\n  description?: string\n\n  /**\n   * AI 生成的 JavaScript 筛选代码\n   * @description\n   * - 只能使用内置工具函数（通过 _ 或 R 访问）\n   * - 输入参数: data (数组)，每个 item 包含 __row_index 字段表示行号\n   * - 必须返回行索引与字段组合的数组: Array<{ __row_index: number, field: string }>\n   * - __row_index 表示原始数据项的行号，field 表示需要高亮的字段\n   * - 禁止使用: eval, Function, 异步操作, DOM API, 网络请求\n   *\n   * @example 高亮销售额大于1000的数据项的 sales 字段\n   * ```javascript\n   * const filtered = _.filter(data, item => item.sales > 1000);\n   * return _.map(filtered, item => ({\n   *   __row_index: item.__row_index,\n   *   field: 'sales'\n   * }));\n   * ```\n   *\n   * @example 高亮每个区域中利润率最高的数据项\n   * ```javascript\n   * const grouped = _.groupBy(data, 'area');\n   * const maxItems = _.map(grouped, group =>\n   *   _.maxBy(group, item => item.profit / item.sales)\n   * );\n   * return _.flatten(\n   *   _.map(maxItems, item => [\n   *     { __row_index: item.__row_index, field: 'product' },\n   *     { __row_index: item.__row_index, field: 'profit' }\n   *   ])\n   * );\n   * ```\n   *\n   * @example 高亮多条件筛选的数据项\n   * ```javascript\n   * const filtered = _.filter(data, item => {\n   *   const profitRate = item.profit / item.sales;\n   *   return profitRate > 0.2 && item.sales > 5000;\n   * });\n   * return _.flatten(\n   *   _.map(filtered, item => [\n   *     { __row_index: item.__row_index, field: 'product' },\n   *     { __row_index: item.__row_index, field: 'sales' }\n   *   ])\n   * );\n   * ```\n   */\n  code: string\n\n  /**\n   * 代码执行失败或环境不支持时的降级方案\n   */\n  fallback?: Selector | Selectors\n\n  /**\n   * 动态筛选执行结果（运行期字段）\n   * @description prepare() 阶段写入，运行时只读\n   */\n  result?: DynamicFilterExecutionResult<RowWithFieldRes>\n}\n\nexport interface ValueDynamicFilter {\n  type: 'value'\n  /**\n   * 用户的筛选需求描述（自然语言）\n   * @example \"获取销售额最高的值作为标注线参考\"\n   * @example \"计算平均销售额用于标注线\"\n   */\n  description?: string\n\n  /**\n   * AI 生成的 JavaScript 筛选代码\n   * @description\n   * - 只能使用内置工具函数（通过 _ 或 R 访问）\n   * - 输入参数: data (数组)\n   * - 必须返回单个数值或字符串: number | string\n   * - 适用场景：标注线（水平线、垂直线）需要的动态数值\n   * - 禁止使用: eval, Function, 异步操作, DOM API, 网络请求\n   *\n   * @example 获取销售额最大值作为标注线值\n   * ```javascript\n   * const maxSales = _.maxBy(data, 'sales')?.sales;\n   * return maxSales || 0;\n   * ```\n   *\n   * @example 计算平均值用于标注线\n   * ```javascript\n   * const avgSales = _.meanBy(data, 'sales');\n   * return _.round(avgSales, 2);\n   * ```\n   *\n   * @example 获取分位数作为标注线\n   * ```javascript\n   * const sorted = _.sortBy(data, 'sales');\n   * const index = Math.floor(sorted.length * 0.75);\n   * return sorted[index]?.sales || 0;\n   * ```\n   *\n   * @example 根据条件计算目标值\n   * ```javascript\n   * const currentYearTotal = _.sumBy(\n   *   _.filter(data, item => item.year === 2024),\n   *   'sales'\n   * );\n   * return currentYearTotal;\n   * ```\n   */\n  code: string\n\n  /**\n   * 代码执行失败或环境不支持时的降级方案\n   */\n  fallback?: string | number\n\n  /**\n   * 动态筛选执行结果（运行期字段）\n   * @description prepare() 阶段写入，运行时只读\n   */\n  result?: {\n    success: boolean\n    data?: number | string\n  }\n}\n\nexport const zPartialSelector = zDatum\n\nexport const zFieldSelector = z.object({\n  field: z.union([z.string(), z.array(z.string())]),\n})\n\nexport const zMeasureSelector = z.object({\n  field: z.string(),\n  operator: z.enum(['=', '==', '!=', '>', '<', '>=', '<=', 'between']).nullish(),\n  op: z.enum(['=', '==', '!=', '>', '<', '>=', '<=', 'between']).nullish(),\n  value: z.union([z.string(), z.number(), z.array(z.union([z.string(), z.number()]))]),\n})\n\nexport const zDimensionSelector = z.object({\n  field: z.string(),\n  operator: z.enum(['in', 'not in']).nullish(),\n  op: z.enum(['in', 'not in']).nullish(),\n  value: z.union([z.string(), z.number(), z.array(z.union([z.string(), z.number()]))]),\n})\n\nexport const zSelector = z.union([\n  z.string(),\n  z.number(),\n  zFieldSelector,\n  zMeasureSelector,\n  zDimensionSelector,\n  zPartialSelector,\n])\n\nexport const zSelectors = z.array(zSelector)\n\nexport const zAreaSelector = z.union([zFieldSelector, zMeasureSelector, zDimensionSelector])\n\nexport const zAreaSelectors = z.array(zAreaSelector)\n\nexport const zCellSelector = z.object({\n  __row_index: z.number(),\n  field: z.union([z.string(), z.literal('*')]),\n})\n\nexport const zTableDynamicFilter = z.object({\n  type: z.literal('row-with-field'),\n  description: z.string().optional(),\n  code: z.string(),\n  fallback: z.union([zSelector, zSelectors]).optional(),\n  result: z\n    .object({\n      success: z.boolean(),\n      data: z.array(zCellSelector).optional(),\n    })\n    .optional(),\n})\n\nexport const zChartDynamicFilter = z.object({\n  type: z.literal('row-with-field'),\n  description: z.string().optional(),\n  code: z.string(),\n  fallback: z.union([zSelector, zSelectors]).optional(),\n  result: z\n    .object({\n      success: z.boolean(),\n      data: z.array(zCellSelector).optional(),\n    })\n    .optional(),\n})\n\nexport const zValueDynamicFilter = z.object({\n  type: z.literal('value'),\n  description: z.string().optional(),\n  code: z.string(),\n  fallback: z.union([z.string(), z.number()]).optional(),\n  result: z\n    .object({\n      success: z.boolean(),\n      data: z.union([z.number(), z.string()]).optional(),\n    })\n    .optional(),\n})\n\n/**\n * @deprecated 请使用 zTableDynamicFilter 或 zChartDynamicFilter\n */\nexport const zDynamicFilter = z.union([zTableDynamicFilter, zChartDynamicFilter])\n"],"names":["zPartialSelector","zDatum","zFieldSelector","z","zMeasureSelector","zDimensionSelector","zSelector","zSelectors","zAreaSelector","zAreaSelectors","zCellSelector","zTableDynamicFilter","zChartDynamicFilter","zValueDynamicFilter","zDynamicFilter"],"mappings":";;AA4ZO,MAAMA,mBAAmBC;AAEzB,MAAMC,iBAAiBC,EAAE,MAAM,CAAC;IACrC,OAAOA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,KAAK,CAACA,EAAE,MAAM;KAAI;AAClD;AAEO,MAAMC,mBAAmBD,EAAE,MAAM,CAAC;IACvC,OAAOA,EAAE,MAAM;IACf,UAAUA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAK;QAAM;QAAM;QAAK;QAAK;QAAM;QAAM;KAAU,EAAE,OAAO;IAC5E,IAAIA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAK;QAAM;QAAM;QAAK;QAAK;QAAM;QAAM;KAAU,EAAE,OAAO;IACtE,OAAOA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,MAAM;QAAIA,EAAE,KAAK,CAACA,EAAE,KAAK,CAAC;YAACA,EAAE,MAAM;YAAIA,EAAE,MAAM;SAAG;KAAG;AACrF;AAEO,MAAME,qBAAqBF,EAAE,MAAM,CAAC;IACzC,OAAOA,EAAE,MAAM;IACf,UAAUA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAM;KAAS,EAAE,OAAO;IAC1C,IAAIA,CAAC,CAADA,OAAM,CAAC;QAAC;QAAM;KAAS,EAAE,OAAO;IACpC,OAAOA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,MAAM;QAAIA,EAAE,KAAK,CAACA,EAAE,KAAK,CAAC;YAACA,EAAE,MAAM;YAAIA,EAAE,MAAM;SAAG;KAAG;AACrF;AAEO,MAAMG,YAAYH,EAAE,KAAK,CAAC;IAC/BA,EAAE,MAAM;IACRA,EAAE,MAAM;IACRD;IACAE;IACAC;IACAL;CACD;AAEM,MAAMO,aAAaJ,EAAE,KAAK,CAACG;AAE3B,MAAME,gBAAgBL,EAAE,KAAK,CAAC;IAACD;IAAgBE;IAAkBC;CAAmB;AAEpF,MAAMI,iBAAiBN,EAAE,KAAK,CAACK;AAE/B,MAAME,gBAAgBP,EAAE,MAAM,CAAC;IACpC,aAAaA,EAAE,MAAM;IACrB,OAAOA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,OAAO,CAAC;KAAK;AAC7C;AAEO,MAAMQ,sBAAsBR,EAAE,MAAM,CAAC;IAC1C,MAAMA,EAAE,OAAO,CAAC;IAChB,aAAaA,EAAE,MAAM,GAAG,QAAQ;IAChC,MAAMA,EAAE,MAAM;IACd,UAAUA,EAAE,KAAK,CAAC;QAACG;QAAWC;KAAW,EAAE,QAAQ;IACnD,QAAQJ,EAAAA,MACC,CAAC;QACN,SAASA,EAAE,OAAO;QAClB,MAAMA,EAAE,KAAK,CAACO,eAAe,QAAQ;IACvC,GACC,QAAQ;AACb;AAEO,MAAME,sBAAsBT,EAAE,MAAM,CAAC;IAC1C,MAAMA,EAAE,OAAO,CAAC;IAChB,aAAaA,EAAE,MAAM,GAAG,QAAQ;IAChC,MAAMA,EAAE,MAAM;IACd,UAAUA,EAAE,KAAK,CAAC;QAACG;QAAWC;KAAW,EAAE,QAAQ;IACnD,QAAQJ,EAAAA,MACC,CAAC;QACN,SAASA,EAAE,OAAO;QAClB,MAAMA,EAAE,KAAK,CAACO,eAAe,QAAQ;IACvC,GACC,QAAQ;AACb;AAEO,MAAMG,sBAAsBV,EAAE,MAAM,CAAC;IAC1C,MAAMA,EAAE,OAAO,CAAC;IAChB,aAAaA,EAAE,MAAM,GAAG,QAAQ;IAChC,MAAMA,EAAE,MAAM;IACd,UAAUA,EAAE,KAAK,CAAC;QAACA,EAAE,MAAM;QAAIA,EAAE,MAAM;KAAG,EAAE,QAAQ;IACpD,QAAQA,EAAAA,MACC,CAAC;QACN,SAASA,EAAE,OAAO;QAClB,MAAMA,EAAE,KAAK,CAAC;YAACA,EAAE,MAAM;YAAIA,EAAE,MAAM;SAAG,EAAE,QAAQ;IAClD,GACC,QAAQ;AACb;AAKO,MAAMW,iBAAiBX,EAAE,KAAK,CAAC;IAACQ;IAAqBC;CAAoB"}

package/dist/esm/types/properties/annotation/annotation.d.ts

@@ -2,6 +2,8 @@ import { z } from 'zod';
 export declare const zAnnotation: z.ZodObject<{
     annotationPoint: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -36,6 +38,8 @@ export declare const zAnnotation: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -75,6 +79,8 @@ export declare const zAnnotation: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             code: z.ZodString;
             fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";
@@ -109,6 +115,8 @@ export declare const zAnnotation: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";
@@ -175,6 +183,8 @@ export declare const zAnnotation: z.ZodObject<{
         offsetX: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>, z.ZodArray<z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -209,6 +219,8 @@ export declare const zAnnotation: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -248,6 +260,8 @@ export declare const zAnnotation: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             code: z.ZodString;
             fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";
@@ -282,6 +296,8 @@ export declare const zAnnotation: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";
@@ -527,6 +543,8 @@ export declare const zAnnotation: z.ZodObject<{
     }, z.core.$strip>>]>>>;
     annotationArea: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -561,6 +579,8 @@ export declare const zAnnotation: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -634,6 +654,8 @@ export declare const zAnnotation: z.ZodObject<{
         outerPadding: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodNumber>>>;
     }, z.core.$strip>, z.ZodArray<z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -668,6 +690,8 @@ export declare const zAnnotation: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";

package/dist/esm/types/properties/annotation/zAnnotationArea.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 export declare const zAnnotationArea: z.ZodObject<{
     selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+        field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>, z.ZodObject<{
         field: z.ZodString;
         operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             "=": "=";
@@ -35,6 +37,8 @@ export declare const zAnnotationArea: z.ZodObject<{
         }>>>;
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
     }, z.core.$strip>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>, z.ZodObject<{
         field: z.ZodString;
         operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             "=": "=";

package/dist/esm/types/properties/annotation/zAnnotationPoint.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 export declare const zAnnotationPoint: z.ZodObject<{
     selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+        field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>, z.ZodObject<{
         field: z.ZodString;
         operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             "=": "=";
@@ -35,6 +37,8 @@ export declare const zAnnotationPoint: z.ZodObject<{
         }>>>;
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
     }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+        field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>, z.ZodObject<{
         field: z.ZodString;
         operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             "=": "=";
@@ -74,6 +78,8 @@ export declare const zAnnotationPoint: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         code: z.ZodString;
         fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -108,6 +114,8 @@ export declare const zAnnotationPoint: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";

package/dist/esm/types/properties/cellStyle/bodyCellStyle.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { TableDynamicFilter } from '../../dataSelector';
+import type { FieldSelector, TableDynamicFilter } from '../../dataSelector';
 import { type Selector, type Selectors } from '../../dataSelector';
 export type BodyCellStyle = {
     /**
@@ -41,8 +41,15 @@ export type BodyCellStyle = {
      *  operator: 'between'
      *  value: [100, 300]
      * }
+     * @example 字段列筛选
+     * selector = {
+     *  field: 'category'
+     * }
+     * selector = {
+     *  field: ['category', 'profit']
+     * }
      */
-    selector?: Selector | Selectors;
+    selector?: Selector | Selectors | FieldSelector;
     /**
      * 动态筛选器（代码驱动）
      * @description
@@ -66,7 +73,45 @@ export type BodyCellStyle = {
      */
     backgroundColor?: string;
     /**
-     * 单元格文字颜色
+     * 是否开启背景色的色阶配置（color scale）
+     */
+    enableBackgroundColorScale?: boolean;
+    /**
+     * 单元格背景色scale映射，优先级高于backgroundColor
+     */
+    backgroundColorScale?: {
+        /** 最小值，不配置时默认为当前数据列中的最小值 */
+        minValue?: number;
+        /** 最大值，不配置时默认为当前数据列中的最大值 */
+        maxValue?: number;
+        /** 最小值对应的颜色 */
+        minColor: string;
+        /** 最大值对应的颜色 */
+        maxColor: string;
+    };
+    /**
+     * 是否开启背景数据条条（一个条形柱来显示当前单元格的大小）功能，默认不开启
+     */
+    enableProgressBar?: boolean;
+    /**
+     * 当前单元格直为正数时的背景数据条颜色
+     */
+    barPositiveColor?: string;
+    /**
+     * 数值为负数时的背景数据条条颜色
+     */
+    barNegativeColor?: string;
+    /**
+     * 进度条最小值
+     * @description 未配置时自动计算列的最小值
+     */
+    barMin?: number;
+    /**
+     * 进度条最大值
+     * @description 未配置时自动计算列的最大值
+     */
+    barMax?: number;
+    /**   * 单元格文字颜色
      */
     textColor?: string;
     /**
@@ -84,6 +129,8 @@ export type BodyCellStyle = {
 };
 export declare const zBodyCellStyle: z.ZodObject<{
     selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+        field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>, z.ZodObject<{
         field: z.ZodString;
         operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             "=": "=";
@@ -118,6 +165,8 @@ export declare const zBodyCellStyle: z.ZodObject<{
         }>>>;
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
     }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+        field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>, z.ZodObject<{
         field: z.ZodString;
         operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             "=": "=";
@@ -151,12 +200,16 @@ export declare const zBodyCellStyle: z.ZodObject<{
             "not in": "not in";
         }>>>;
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
-    }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>>]>>>;
+    }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>>, z.ZodObject<{
+        field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>]>>>;
     dynamicFilter: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         type: z.ZodLiteral<"row-with-field">;
         description: z.ZodOptional<z.ZodString>;
         code: z.ZodString;
         fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -191,6 +244,8 @@ export declare const zBodyCellStyle: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -234,8 +289,19 @@ export declare const zBodyCellStyle: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
     backgroundColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enableBackgroundColorScale: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    backgroundColorScale: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        minValue: z.ZodOptional<z.ZodNumber>;
+        maxValue: z.ZodOptional<z.ZodNumber>;
+        minColor: z.ZodString;
+        maxColor: z.ZodString;
+    }, z.core.$strip>>>;
     textFontSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     borderColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     borderLineWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    enableProgressBar: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    barMin: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    barMax: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    barPositiveColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    barNegativeColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;

package/dist/esm/types/properties/cellStyle/bodyCellStyle.js

@@ -1,16 +1,28 @@
 import { z } from "zod";
-import { zSelector, zSelectors, zTableDynamicFilter } from "../../dataSelector/index.js";
+import { zFieldSelector, zSelector, zSelectors, zTableDynamicFilter } from "../../dataSelector/index.js";
 const zBodyCellStyle = z.object({
     selector: z.union([
         zSelector,
-        zSelectors
+        zSelectors,
+        zFieldSelector
     ]).nullish(),
     dynamicFilter: zTableDynamicFilter.nullish(),
     backgroundColor: z.string().nullish(),
-    textColor: z.string().nullish(),
+    enableBackgroundColorScale: z.boolean().nullish(),
+    backgroundColorScale: z.object({
+        minValue: z.number().optional(),
+        maxValue: z.number().optional(),
+        minColor: z.string(),
+        maxColor: z.string()
+    }).nullish(),
     textFontSize: z.number().nullish(),
     borderColor: z.string().nullish(),
-    borderLineWidth: z.number().nullish()
+    borderLineWidth: z.number().nullish(),
+    enableProgressBar: z.boolean().nullish(),
+    barMin: z.number().nullish(),
+    barMax: z.number().nullish(),
+    barPositiveColor: z.string().nullish(),
+    barNegativeColor: z.string().nullish()
 });
 export { zBodyCellStyle };
 

package/dist/esm/types/properties/cellStyle/bodyCellStyle.js.map

@@ -1 +1 @@
-{"version":3,"file":"types/properties/cellStyle/bodyCellStyle.js","sources":["webpack://@visactor/vseed/./src/types/properties/cellStyle/bodyCellStyle.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { TableDynamicFilter } from '../../dataSelector'\nimport { zSelector, zSelectors, zTableDynamicFilter, type Selector, type Selectors } from '../../dataSelector'\n\nexport type BodyCellStyle = {\n  /**\n   * 数据选择器\n   * @description\n   * 若配置selector, 提供数值 selector, 局部数据 selector, 条件维度 selector, 条件指标 selector 共四类数据匹配能力\n   * 若未配置selector, 则样式全局生效.\n   *\n   * 注意: selector 和 dynamicFilter 不能同时使用，dynamicFilter 优先级更高\n   *\n   * @type {Selector | Selectors}\n   * @example 数值选择器\n   * selector = \"tool\"\n   * selector = [\"tool\", \"book\"]\n   * selector = 100\n   * selector = [100, 200]\n   * @example 局部数据选择器\n   * selector = { profit: 100 }\n   * selector = [{ profit: 100 }, { profit: 200 }]\n   * @example 条件维度选择器\n   * selector = {\n   *  field: 'category',\n   *  operator: 'in',\n   *  value: 'tool'\n   * }\n   * selector = {\n   *  field: 'category',\n   *  operator: 'not in',\n   *  value: 'book'\n   * }\n   * @example 条件指标选择器\n   * selector = {\n   *  field: 'profit',\n   *  operator: '>=',\n   *  value: 100\n   * }\n   * selector = {\n   *  field: 'profit',\n   *  operator: 'between'\n   *  value: [100, 300]\n   * }\n   */\n  selector?: Selector | Selectors\n  /**\n   * 动态筛选器（代码驱动）\n   * @description\n   * 通过 AI 生成的 JavaScript 代码实现复杂数据筛选逻辑\n   * 适用于 Top N、统计分析、复杂条件等静态 selector 难以表达的场景\n   *\n   * 核心能力:\n   * - 支持任意复杂的数据筛选条件\n   * - 使用 内置工具函数 进行数据操作\n   * - 在浏览器环境中安全执行（Web Worker 沙箱）\n   *\n   * 环境要求: 仅支持浏览器环境，Node.js 环境将使用 fallback\n   *\n   * 注意: selector 和 dynamicFilter 不能同时使用，dynamicFilter 优先级更高\n   *\n   * @type {TableDynamicFilter}\n   */\n  dynamicFilter?: TableDynamicFilter\n  /**\n   * 单元格背景色\n   */\n  backgroundColor?: string\n  /**\n   * 单元格文字颜色\n   */\n  textColor?: string\n  /**\n   * 单元格文字大小\n   */\n  textFontSize?: number\n  /**\n   * 单元格边框颜色\n   */\n  borderColor?: string\n  /**\n   * 单元格边框线宽\n   */\n  borderLineWidth?: number\n}\n\nexport const zBodyCellStyle = z.object({\n  selector: z.union([zSelector, zSelectors]).nullish(),\n  dynamicFilter: zTableDynamicFilter.nullish(),\n  backgroundColor: z.string().nullish(),\n  textColor: z.string().nullish(),\n  textFontSize: z.number().nullish(),\n  borderColor: z.string().nullish(),\n  borderLineWidth: z.number().nullish(),\n})\n"],"names":["zBodyCellStyle","z","zSelector","zSelectors","zTableDynamicFilter"],"mappings":";;AAsFO,MAAMA,iBAAiBC,EAAE,MAAM,CAAC;IACrC,UAAUA,EAAE,KAAK,CAAC;QAACC;QAAWC;KAAW,EAAE,OAAO;IAClD,eAAeC,oBAAoB,OAAO;IAC1C,iBAAiBH,EAAE,MAAM,GAAG,OAAO;IACnC,WAAWA,EAAE,MAAM,GAAG,OAAO;IAC7B,cAAcA,EAAE,MAAM,GAAG,OAAO;IAChC,aAAaA,EAAE,MAAM,GAAG,OAAO;IAC/B,iBAAiBA,EAAE,MAAM,GAAG,OAAO;AACrC"}
+{"version":3,"file":"types/properties/cellStyle/bodyCellStyle.js","sources":["webpack://@visactor/vseed/./src/types/properties/cellStyle/bodyCellStyle.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { FieldSelector, TableDynamicFilter } from '../../dataSelector'\nimport {\n  zFieldSelector,\n  zSelector,\n  zSelectors,\n  zTableDynamicFilter,\n  type Selector,\n  type Selectors,\n} from '../../dataSelector'\n\nexport type BodyCellStyle = {\n  /**\n   * 数据选择器\n   * @description\n   * 若配置selector, 提供数值 selector, 局部数据 selector, 条件维度 selector, 条件指标 selector 共四类数据匹配能力\n   * 若未配置selector, 则样式全局生效.\n   *\n   * 注意: selector 和 dynamicFilter 不能同时使用，dynamicFilter 优先级更高\n   *\n   * @type {Selector | Selectors}\n   * @example 数值选择器\n   * selector = \"tool\"\n   * selector = [\"tool\", \"book\"]\n   * selector = 100\n   * selector = [100, 200]\n   * @example 局部数据选择器\n   * selector = { profit: 100 }\n   * selector = [{ profit: 100 }, { profit: 200 }]\n   * @example 条件维度选择器\n   * selector = {\n   *  field: 'category',\n   *  operator: 'in',\n   *  value: 'tool'\n   * }\n   * selector = {\n   *  field: 'category',\n   *  operator: 'not in',\n   *  value: 'book'\n   * }\n   * @example 条件指标选择器\n   * selector = {\n   *  field: 'profit',\n   *  operator: '>=',\n   *  value: 100\n   * }\n   * selector = {\n   *  field: 'profit',\n   *  operator: 'between'\n   *  value: [100, 300]\n   * }\n   * @example 字段列筛选\n   * selector = {\n   *  field: 'category'\n   * }\n   * selector = {\n   *  field: ['category', 'profit']\n   * }\n   */\n  selector?: Selector | Selectors | FieldSelector\n  /**\n   * 动态筛选器（代码驱动）\n   * @description\n   * 通过 AI 生成的 JavaScript 代码实现复杂数据筛选逻辑\n   * 适用于 Top N、统计分析、复杂条件等静态 selector 难以表达的场景\n   *\n   * 核心能力:\n   * - 支持任意复杂的数据筛选条件\n   * - 使用 内置工具函数 进行数据操作\n   * - 在浏览器环境中安全执行（Web Worker 沙箱）\n   *\n   * 环境要求: 仅支持浏览器环境，Node.js 环境将使用 fallback\n   *\n   * 注意: selector 和 dynamicFilter 不能同时使用，dynamicFilter 优先级更高\n   *\n   * @type {TableDynamicFilter}\n   */\n  dynamicFilter?: TableDynamicFilter\n  /**\n   * 单元格背景色\n   */\n  backgroundColor?: string\n  /**\n   * 是否开启背景色的色阶配置（color scale）\n   */\n  enableBackgroundColorScale?: boolean\n  /**\n   * 单元格背景色scale映射，优先级高于backgroundColor\n   */\n  backgroundColorScale?: {\n    /** 最小值，不配置时默认为当前数据列中的最小值 */\n    minValue?: number\n    /** 最大值，不配置时默认为当前数据列中的最大值 */\n    maxValue?: number\n    /** 最小值对应的颜色 */\n    minColor: string\n    /** 最大值对应的颜色 */\n    maxColor: string\n  }\n  /**\n   * 是否开启背景数据条条（一个条形柱来显示当前单元格的大小）功能，默认不开启\n   */\n  enableProgressBar?: boolean\n  /**\n   * 当前单元格直为正数时的背景数据条颜色\n   */\n  barPositiveColor?: string\n  /**\n   * 数值为负数时的背景数据条条颜色\n   */\n  barNegativeColor?: string\n  /**\n   * 进度条最小值\n   * @description 未配置时自动计算列的最小值\n   */\n  barMin?: number\n  /**\n   * 进度条最大值\n   * @description 未配置时自动计算列的最大值\n   */\n  barMax?: number\n  /**   * 单元格文字颜色\n   */\n  textColor?: string\n  /**\n   * 单元格文字大小\n   */\n  textFontSize?: number\n  /**\n   * 单元格边框颜色\n   */\n  borderColor?: string\n  /**\n   * 单元格边框线宽\n   */\n  borderLineWidth?: number\n}\n\nexport const zBodyCellStyle = z.object({\n  selector: z.union([zSelector, zSelectors, zFieldSelector]).nullish(),\n  dynamicFilter: zTableDynamicFilter.nullish(),\n  backgroundColor: z.string().nullish(),\n  enableBackgroundColorScale: z.boolean().nullish(),\n  backgroundColorScale: z\n    .object({\n      minValue: z.number().optional(),\n      maxValue: z.number().optional(),\n      minColor: z.string(),\n      maxColor: z.string(),\n    })\n    .nullish(),\n  textFontSize: z.number().nullish(),\n  borderColor: z.string().nullish(),\n  borderLineWidth: z.number().nullish(),\n  enableProgressBar: z.boolean().nullish(),\n  barMin: z.number().nullish(),\n  barMax: z.number().nullish(),\n  barPositiveColor: z.string().nullish(),\n  barNegativeColor: z.string().nullish(),\n})\n"],"names":["zBodyCellStyle","z","zSelector","zSelectors","zFieldSelector","zTableDynamicFilter"],"mappings":";;AA0IO,MAAMA,iBAAiBC,EAAE,MAAM,CAAC;IACrC,UAAUA,EAAE,KAAK,CAAC;QAACC;QAAWC;QAAYC;KAAe,EAAE,OAAO;IAClE,eAAeC,oBAAoB,OAAO;IAC1C,iBAAiBJ,EAAE,MAAM,GAAG,OAAO;IACnC,4BAA4BA,EAAE,OAAO,GAAG,OAAO;IAC/C,sBAAsBA,EAAAA,MACb,CAAC;QACN,UAAUA,EAAE,MAAM,GAAG,QAAQ;QAC7B,UAAUA,EAAE,MAAM,GAAG,QAAQ;QAC7B,UAAUA,EAAE,MAAM;QAClB,UAAUA,EAAE,MAAM;IACpB,GACC,OAAO;IACV,cAAcA,EAAE,MAAM,GAAG,OAAO;IAChC,aAAaA,EAAE,MAAM,GAAG,OAAO;IAC/B,iBAAiBA,EAAE,MAAM,GAAG,OAAO;IACnC,mBAAmBA,EAAE,OAAO,GAAG,OAAO;IACtC,QAAQA,EAAE,MAAM,GAAG,OAAO;IAC1B,QAAQA,EAAE,MAAM,GAAG,OAAO;IAC1B,kBAAkBA,EAAE,MAAM,GAAG,OAAO;IACpC,kBAAkBA,EAAE,MAAM,GAAG,OAAO;AACtC"}

package/dist/esm/types/properties/cellStyle/cellStyle.d.ts

@@ -2,6 +2,8 @@ import { z } from 'zod';
 export declare const zCellStyle: z.ZodObject<{
     bodyCellStyle: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         selector: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -36,6 +38,8 @@ export declare const zCellStyle: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -69,12 +73,16 @@ export declare const zCellStyle: z.ZodObject<{
                 "not in": "not in";
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
-        }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>>]>>>;
+        }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>>, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>]>>>;
         dynamicFilter: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             type: z.ZodLiteral<"row-with-field">;
             description: z.ZodOptional<z.ZodString>;
             code: z.ZodString;
             fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";
@@ -109,6 +117,8 @@ export declare const zCellStyle: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";
@@ -152,10 +162,21 @@ export declare const zCellStyle: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
         backgroundColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        textColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        enableBackgroundColorScale: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        backgroundColorScale: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            minValue: z.ZodOptional<z.ZodNumber>;
+            maxValue: z.ZodOptional<z.ZodNumber>;
+            minColor: z.ZodString;
+            maxColor: z.ZodString;
+        }, z.core.$strip>>>;
         textFontSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         borderColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         borderLineWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        enableProgressBar: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        barMin: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        barMax: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        barPositiveColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        barNegativeColor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type CellStyle = z.infer<typeof zCellStyle>;

package/dist/esm/types/properties/config/annotation/zAnnotation.d.ts

@@ -5,6 +5,8 @@ export declare const zAnnotationPointConfig: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         code: z.ZodString;
         fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -39,6 +41,8 @@ export declare const zAnnotationPointConfig: z.ZodObject<{
             }>>>;
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
         }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+            field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>, z.ZodObject<{
             field: z.ZodString;
             operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 "=": "=";
@@ -170,6 +174,8 @@ export declare const zAnnotationConfig: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             code: z.ZodString;
             fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";
@@ -204,6 +210,8 @@ export declare const zAnnotationConfig: z.ZodObject<{
                 }>>>;
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
             }, z.core.$strip>, z.ZodRecord<z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodAny>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodObject<{
+                field: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strip>, z.ZodObject<{
                 field: z.ZodString;
                 operator: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     "=": "=";