@nokecy/qc-ui 1.1.48 → 1.1.50

package/dist/esm/RuleBuilder/RuleCard.js

@@ -16,7 +16,7 @@ import { FieldSelector } from "./selectors/FieldSelector";
 import { OperatorSelector } from "./selectors/OperatorSelector";
 import ValueInput from "./inputs/ValueInput";
 import { useRuleBuilderContext } from "./context/RuleBuilderContext";
-import { getOperatorInfo } from "./constants/operators";
+import { getOperatorInfo, operatorSupportsValueField } from "./constants/operators";
 import styles from "./styles/index.module.less";
 /**
  * 规则卡片组件 - 紧凑版
@@ -27,7 +27,9 @@ export var RuleCard = function RuleCard(_ref) {
   var rule = _ref.rule,
     path = _ref.path,
     _ref$readonly = _ref.readonly,
-    readonly = _ref$readonly === void 0 ? false : _ref$readonly;
+    readonly = _ref$readonly === void 0 ? false : _ref$readonly,
+    _ref$allowFieldCompar = _ref.allowFieldComparison,
+    allowFieldComparison = _ref$allowFieldCompar === void 0 ? false : _ref$allowFieldCompar;
   var _useRuleBuilderContex = useRuleBuilderContext(),
     state = _useRuleBuilderContex.state,
     dispatch = _useRuleBuilderContex.dispatch;
@@ -57,7 +59,9 @@ export var RuleCard = function RuleCard(_ref) {
         rule: _objectSpread(_objectSpread({}, rule), {}, {
           fieldName: fieldName,
           value: undefined,
-          value2: undefined
+          value2: undefined,
+          // 可比较的字段随数据类型变化，保留字段模式但清空已选字段。@author nokecy
+          valueField: rule.valueField !== undefined ? '' : undefined
         })
       }
     });
@@ -76,7 +80,8 @@ export var RuleCard = function RuleCard(_ref) {
         rule: _objectSpread(_objectSpread({}, rule), {}, {
           operator: operator,
           value: needsValue || needsValue2 || needsMultiValue ? rule.value : undefined,
-          value2: needsValue2 ? rule.value2 : undefined
+          value2: needsValue2 ? rule.value2 : undefined,
+          valueField: operatorSupportsValueField(operator) ? rule.valueField : undefined
         })
       }
     });
@@ -96,6 +101,21 @@ export var RuleCard = function RuleCard(_ref) {
     });
   };
 
+  // 比较字段改变处理：切换模式或选择字段时清空固定值，undefined 表示回到固定值模式。@author nokecy
+  var handleValueFieldChange = function handleValueFieldChange(valueField) {
+    dispatch({
+      type: 'UPDATE_RULE',
+      payload: {
+        path: path,
+        rule: _objectSpread(_objectSpread({}, rule), {}, {
+          value: undefined,
+          value2: undefined,
+          valueField: valueField
+        })
+      }
+    });
+  };
+
   // 删除规则处理
   var handleDelete = function handleDelete() {
     dispatch({
@@ -154,6 +174,10 @@ export var RuleCard = function RuleCard(_ref) {
     value: rule.value,
     value2: rule.value2,
     onChange: handleValueChange,
+    valueField: rule.valueField,
+    onValueFieldChange: allowFieldComparison ? handleValueFieldChange : undefined,
+    fields: state.fields,
+    fieldName: rule.fieldName,
     disabled: readonly,
     size: "small"
   }), ruleErrors.some(function (e) {

package/dist/esm/RuleBuilder/RuleGroupEditor.d.ts

@@ -14,6 +14,8 @@ export interface RuleGroupEditorProps {
     maxLevel: number;
     /** 是否只读模式 */
     readonly?: boolean;
+    /** 是否允许与另一个字段比较 @author nokecy */
+    allowFieldComparison?: boolean;
     /** 规则组变更回调(可选) */
     onChange?: (group: RuleGroupDto) => void;
 }

package/dist/esm/RuleBuilder/RuleGroupEditor.js

@@ -35,6 +35,8 @@ export var RuleGroupEditor = function RuleGroupEditor(_ref) {
     maxLevel = _ref.maxLevel,
     _ref$readonly = _ref.readonly,
     readonly = _ref$readonly === void 0 ? false : _ref$readonly,
+    _ref$allowFieldCompar = _ref.allowFieldComparison,
+    allowFieldComparison = _ref$allowFieldCompar === void 0 ? false : _ref$allowFieldCompar,
     onChange = _ref.onChange;
   var _useRuleBuilderContex = useRuleBuilderContext(),
     state = _useRuleBuilderContex.state,
@@ -147,7 +149,8 @@ export var RuleGroupEditor = function RuleGroupEditor(_ref) {
       key: ruleIndex,
       rule: rule,
       path: rulePath,
-      readonly: readonly
+      readonly: readonly,
+      allowFieldComparison: allowFieldComparison
     });
   }), currentGroup.groups.length > 0 && /*#__PURE__*/React.createElement("div", {
     className: styles.nestedGroups
@@ -159,6 +162,7 @@ export var RuleGroupEditor = function RuleGroupEditor(_ref) {
       level: level + 1,
       maxLevel: maxLevel,
       readonly: readonly,
+      allowFieldComparison: allowFieldComparison,
       onChange: onChange
     });
   })), currentGroup.rules.length === 0 && currentGroup.groups.length === 0 && /*#__PURE__*/React.createElement("div", {

package/dist/esm/RuleBuilder/constants/operators.d.ts

@@ -41,6 +41,11 @@ export declare const operatorRequiresValue2: (operator: MatchOperator) => boolea
  * 检查操作符是否需要多个值（In/NotIn）
  */
 export declare const operatorRequiresMultiValue: (operator: MatchOperator) => boolean;
+/**
+ * 检查操作符是否支持与另一个字段比较（与后端 RuleGroupValidator 一致：等于、不等于及 4 个大小比较）
+ * @author nokecy
+ */
+export declare const operatorSupportsValueField: (operator: MatchOperator) => boolean;
 /**
  * 最大嵌套层级
  */

package/dist/esm/RuleBuilder/constants/operators.js

@@ -163,6 +163,14 @@ export var operatorRequiresMultiValue = function operatorRequiresMultiValue(oper
   return ((_OPERATOR_INFO_MAP$op3 = OPERATOR_INFO_MAP[operator]) === null || _OPERATOR_INFO_MAP$op3 === void 0 ? void 0 : _OPERATOR_INFO_MAP$op3.requiresMultiValue) || false;
 };
 
+/**
+ * 检查操作符是否支持与另一个字段比较（与后端 RuleGroupValidator 一致：等于、不等于及 4 个大小比较）
+ * @author nokecy
+ */
+export var operatorSupportsValueField = function operatorSupportsValueField(operator) {
+  return [MatchOperator.Equals, MatchOperator.NotEquals, MatchOperator.GreaterThan, MatchOperator.GreaterThanOrEqual, MatchOperator.LessThan, MatchOperator.LessThanOrEqual].includes(operator);
+};
+
 /**
  * 最大嵌套层级
  */

package/dist/esm/RuleBuilder/index.d.ts

@@ -20,6 +20,6 @@ export { RuleBuilderProvider, useRuleBuilderContext, useRuleBuilderState, useRul
 export { createEmptyRule, createEmptyRuleGroup, generateRuleDescription, cloneRuleGroup, isRuleGroupEmpty, countRules, getMaxDepth, } from './utils/ruleHelpers';
 export { getRuleGroupByPath, getRuleByPath, updateRuleAtPath, deleteRuleAtPath, addRuleAtPath, updateRuleGroupAtPath, deleteRuleGroupAtPath, addRuleGroupAtPath, } from './utils/pathHelpers';
 export { validateRuleGroup, validateRule, isRuleGroupValid, } from './utils/validation';
-export { OPERATOR_INFO_MAP, getOperatorInfo, operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, getOperatorsByDataType, MAX_NESTING_LEVEL, } from './constants/operators';
+export { OPERATOR_INFO_MAP, getOperatorInfo, operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, operatorSupportsValueField, getOperatorsByDataType, MAX_NESTING_LEVEL, } from './constants/operators';
 export type { MatchOperator, MatchLogic, FieldDataType, RuleDto, RuleGroupDto, FieldDefinition, ValidationResult, ValidationError, RuleBuilderProps, RuleBuilderConfig, RulePath, RuleBuilderState, RuleBuilderAction, OperatorInfo, } from './types';
 export { RuleBuilderContainer as default } from './RuleBuilderContainer';

package/dist/esm/RuleBuilder/index.js

@@ -34,7 +34,7 @@ export { getRuleGroupByPath, getRuleByPath, updateRuleAtPath, deleteRuleAtPath,
 export { validateRuleGroup, validateRule, isRuleGroupValid } from "./utils/validation";
 
 // ============ 常量 ============
-export { OPERATOR_INFO_MAP, getOperatorInfo, operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, getOperatorsByDataType, MAX_NESTING_LEVEL } from "./constants/operators";
+export { OPERATOR_INFO_MAP, getOperatorInfo, operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, operatorSupportsValueField, getOperatorsByDataType, MAX_NESTING_LEVEL } from "./constants/operators";
 
 // ============ 类型定义 ============
 

package/dist/esm/RuleBuilder/inputs/ValueInput.d.ts

@@ -5,10 +5,10 @@
  * - IsNull/IsNotNull: 不渲染任何输入
  * - Between: 渲染 BetweenValueInput
  * - In/NotIn: 渲染 MultiValueInput
- * - 其他: 渲染 SingleValueInput
+ * - 其他: 渲染 SingleValueInput；允许比较字段时前置「固定值 / 字段」切换
  */
 import React from 'react';
-import type { MatchOperator, FieldDataType } from '../types';
+import type { MatchOperator, FieldDataType, FieldDefinition } from '../types';
 export interface ValueInputProps {
     /** 操作符 */
     operator: MatchOperator;
@@ -24,6 +24,14 @@ export interface ValueInputProps {
     disabled?: boolean;
     /** 尺寸 */
     size?: 'small' | 'middle' | 'large';
+    /** 比较字段（undefined 为固定值模式） @author nokecy */
+    valueField?: string;
+    /** 比较字段变更回调；不传则不提供「字段」模式 @author nokecy */
+    onValueFieldChange?: (valueField: string | undefined) => void;
+    /** 可供比较的字段列表 @author nokecy */
+    fields?: FieldDefinition[];
+    /** 当前规则的字段名（比较字段中排除自身） @author nokecy */
+    fieldName?: string;
 }
 export declare const ValueInput: React.FC<ValueInputProps>;
 export default ValueInput;

package/dist/esm/RuleBuilder/inputs/ValueInput.js

@@ -5,11 +5,12 @@
  * - IsNull/IsNotNull: 不渲染任何输入
  * - Between: 渲染 BetweenValueInput
  * - In/NotIn: 渲染 MultiValueInput
- * - 其他: 渲染 SingleValueInput
+ * - 其他: 渲染 SingleValueInput；允许比较字段时前置「固定值 / 字段」切换
  */
 
 import React from 'react';
-import { operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue } from "../constants/operators";
+import { Segmented, Select, Space } from 'antd';
+import { operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, operatorSupportsValueField } from "../constants/operators";
 import SingleValueInput from "./SingleValueInput";
 import BetweenValueInput from "./BetweenValueInput";
 import MultiValueInput from "./MultiValueInput";
@@ -22,7 +23,12 @@ export var ValueInput = function ValueInput(_ref) {
     _ref$disabled = _ref.disabled,
     disabled = _ref$disabled === void 0 ? false : _ref$disabled,
     _ref$size = _ref.size,
-    size = _ref$size === void 0 ? 'middle' : _ref$size;
+    size = _ref$size === void 0 ? 'middle' : _ref$size,
+    valueField = _ref.valueField,
+    onValueFieldChange = _ref.onValueFieldChange,
+    _ref$fields = _ref.fields,
+    fields = _ref$fields === void 0 ? [] : _ref$fields,
+    fieldName = _ref.fieldName;
   // 不需要值输入的操作符（IsNull/IsNotNull）
   if (!operatorRequiresValue(operator) && !operatorRequiresValue2(operator) && !operatorRequiresMultiValue(operator)) {
     return null;
@@ -58,9 +64,7 @@ export var ValueInput = function ValueInput(_ref) {
       size: size
     });
   }
-
-  // 其他操作符：渲染单值输入
-  return /*#__PURE__*/React.createElement(SingleValueInput, {
+  var singleValueInput = /*#__PURE__*/React.createElement(SingleValueInput, {
     value: value,
     onChange: function onChange(val) {
       return _onChange(val);
@@ -69,5 +73,52 @@ export var ValueInput = function ValueInput(_ref) {
     disabled: disabled,
     size: size
   });
+
+  // 其他操作符：渲染单值输入
+  if (!onValueFieldChange || !operatorSupportsValueField(operator)) {
+    return singleValueInput;
+  }
+
+  // 比较类操作符：可切换为与同类型的另一个字段比较。@author nokecy
+  var isFieldMode = valueField !== undefined;
+  return /*#__PURE__*/React.createElement(Space, {
+    size: 4
+  }, /*#__PURE__*/React.createElement(Segmented, {
+    size: size,
+    value: isFieldMode ? 'field' : 'value',
+    disabled: disabled,
+    options: [{
+      label: '固定值',
+      value: 'value'
+    }, {
+      label: '字段',
+      value: 'field'
+    }],
+    onChange: function onChange(mode) {
+      return onValueFieldChange(mode === 'field' ? '' : undefined);
+    }
+  }), isFieldMode ? /*#__PURE__*/React.createElement(Select, {
+    value: valueField || undefined,
+    onChange: function onChange(name) {
+      return onValueFieldChange(name);
+    },
+    placeholder: "\u8BF7\u9009\u62E9\u6BD4\u8F83\u5B57\u6BB5",
+    disabled: disabled,
+    size: size,
+    showSearch: true,
+    optionFilterProp: "label",
+    style: {
+      width: 200
+    },
+    options: fields.filter(function (field) {
+      return field.dataType === dataType && field.name !== fieldName;
+    }).map(function (field) {
+      return {
+        value: field.name,
+        label: field.displayName,
+        title: field.description
+      };
+    })
+  }) : singleValueInput);
 };
 export default ValueInput;

package/dist/esm/RuleBuilder/types/index.d.ts

@@ -8,7 +8,7 @@
  * JSON 序列化属性名：
  * - fieldName (不是 FieldName)
  * - operator (不是 Operator)
- * - value, value2
+ * - value, value2, valueField
  * - logic, rules, groups
  */
 /**
@@ -78,6 +78,12 @@ export interface RuleDto {
     value?: any;
     /** 第二个值（用于 Between 操作符） */
     value2?: any;
+    /**
+     * 比较字段：与另一个字段的值比较，与 value 互斥，仅 6 个比较操作符可用。
+     * undefined 为固定值模式；空字符串表示已切到字段模式但尚未选择。
+     * @author nokecy
+     */
+    valueField?: string;
 }
 /**
  * 规则组 DTO（与后端保持一致）
@@ -143,6 +149,12 @@ export interface RuleBuilderConfig {
     maxNestingLevel?: number;
     /** 是否显示 JSON 预览 */
     showJsonPreview?: boolean;
+    /**
+     * 是否允许规则与另一个字段比较（valueField）。
+     * 需要后端规则引擎与调用方的格式转换都支持 valueField 才能开启，默认关闭。
+     * @author nokecy
+     */
+    allowFieldComparison?: boolean;
     /** 自定义验证器 */
     validator?: (rule: RuleGroupDto) => ValidationResult;
 }

package/dist/esm/RuleBuilder/types/index.js

@@ -8,7 +8,7 @@
  * JSON 序列化属性名：
  * - fieldName (不是 FieldName)
  * - operator (不是 Operator)
- * - value, value2
+ * - value, value2, valueField
  * - logic, rules, groups
  */
 

package/dist/esm/RuleBuilder/utils/validation.js

@@ -14,7 +14,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  * 规则验证逻辑
  */
 
-import { operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, getOperatorsByDataType } from "../constants/operators";
+import { operatorRequiresValue, operatorRequiresValue2, operatorRequiresMultiValue, operatorSupportsValueField, getOperatorsByDataType } from "../constants/operators";
 
 /**
  * 验证规则组
@@ -107,6 +107,12 @@ export function validateRule(rule, fields) {
     });
   }
 
+  // 比较字段模式：值来自另一个字段，不再校验固定值。@author nokecy
+  if (rule.valueField !== undefined) {
+    errors.push.apply(errors, _toConsumableArray(validateValueField(rule, fields)));
+    return errors;
+  }
+
   // 4. 检查值是否为空（对于需要值的操作符）
   if (operatorRequiresValue(rule.operator)) {
     if (rule.value === undefined || rule.value === null || rule.value === '') {
@@ -189,6 +195,38 @@ export function validateRule(rule, fields) {
   return errors;
 }
 
+/**
+ * 验证比较字段模式的规则
+ * @param rule 规则（valueField 已设置）
+ * @param fields 字段定义列表
+ * @returns 错误列表
+ * @author nokecy
+ */
+function validateValueField(rule, fields) {
+  var errors = [];
+  var addError = function addError(message) {
+    return errors.push({
+      path: [],
+      message: message,
+      field: rule.fieldName
+    });
+  };
+  if (!operatorSupportsValueField(rule.operator)) {
+    addError('当前操作符不支持比较字段');
+  }
+  if (rule.value !== undefined && rule.value !== null && rule.value !== '') {
+    addError('固定值和比较字段只能设置一个');
+  }
+  if (!rule.valueField) {
+    addError('请选择比较字段');
+  } else if (!fields.some(function (f) {
+    return f.name === rule.valueField;
+  })) {
+    addError("\u6BD4\u8F83\u5B57\u6BB5 \"".concat(rule.valueField, "\" \u4E0D\u5B58\u5728"));
+  }
+  return errors;
+}
+
 /**
  * 验证值的类型是否匹配
  * @param value 值

package/dist/esm/ag-grid-plus/setting/ColumnSetting.js

@@ -33,7 +33,7 @@ import { AgGridReact } from 'ag-grid-react';
 import { agGridTheme } from "../theme";
 import { localeText } from "../locale";
 import { createForm, onFormInit } from '@formily/core';
-import { gridStateToFlatConfig, flatConfigToGridState, flatConfigToColumnState, isOldSchemeData, migrateOldScheme, generateId } from "./columnGroupUtils";
+import { gridStateToFlatConfig, flatConfigToGridState, flatConfigToColumnState, dropQueryOnlyItems, excludeQueryOnlyColumns, isOldSchemeData, migrateOldScheme, generateId } from "./columnGroupUtils";
 import ColumnConfigTable from "./ColumnConfigTable";
 import DraggableModal from "../../draggableModal";
 import { useGridSchemes } from "../context/useSchemeManager";
@@ -298,7 +298,8 @@ var ColumnSetting = function ColumnSetting(_ref) {
       // 【修复】修正 originalHeaderName,确保使用 initialColumnDefs 中的原始值
       var config = fixOriginalHeaderName(currentScheme.columnConfig);
       // 【修复】检测并追加代码中新增的列到配置末尾
-      config = mergeNewColumns(config, originalColumnDefs);
+      // 只做查询条件的列不进列配置：方案里存过的剔除，也不当新增列追加 @author nokecy
+      config = mergeNewColumns(dropQueryOnlyItems(config, originalColumnDefs), excludeQueryOnlyColumns(originalColumnDefs));
       // 【修复】按 order 字段排序，确保配置弹窗显示的列顺序与保存时一致
       config = _toConsumableArray(config).sort(function (a, b) {
         return a.order - b.order;

package/dist/esm/ag-grid-plus/setting/columnGroupUtils.d.ts

@@ -8,6 +8,18 @@ import type { FlatColumnItem, OldColumnState } from './columnGroupTypes';
  * 生成唯一 ID
  */
 export declare const generateId: () => string;
+/**
+ * 去掉只做查询条件的列（hideInTable），含分组内的
+ * 这类列只进查询表单，不是表格列：列方案的还原、新增列检测都不能把它带进表格
+ * @author nokecy
+ */
+export declare function excludeQueryOnlyColumns<T extends ColDef | ColGroupDef>(defs?: T[]): T[] | undefined;
+/**
+ * 从已存的列方案中去掉只做查询条件的列
+ * 旧版本方案会把它们当新增列存进去，还原时要按当前列定义剔除
+ * @author nokecy
+ */
+export declare function dropQueryOnlyItems(flatConfig: FlatColumnItem[], originalColumnDefs?: (ColDef | ColGroupDef)[]): FlatColumnItem[];
 /**
  * Grid State → 扁平化配置
  * 将 AG-Grid 的树形结构转换为扁平化数组，用于 UI 展示和编辑

package/dist/esm/ag-grid-plus/setting/columnGroupUtils.js

@@ -1,9 +1,4 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
-function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
@@ -11,6 +6,11 @@ function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToAr
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /**
  * 表头分组配置工具函数
  * 负责 Grid State 与扁平化配置之间的转换
@@ -25,6 +25,39 @@ export var generateId = function generateId() {
   return uniqueId('col_');
 };
 
+/**
+ * 去掉只做查询条件的列（hideInTable），含分组内的
+ * 这类列只进查询表单，不是表格列：列方案的还原、新增列检测都不能把它带进表格
+ * @author nokecy
+ */
+export function excludeQueryOnlyColumns(defs) {
+  return defs === null || defs === void 0 ? void 0 : defs.filter(function (def) {
+    return !def.hideInTable;
+  }).map(function (def) {
+    return 'children' in def && def.children ? _objectSpread(_objectSpread({}, def), {}, {
+      children: excludeQueryOnlyColumns(def.children)
+    }) : def;
+  });
+}
+
+/**
+ * 从已存的列方案中去掉只做查询条件的列
+ * 旧版本方案会把它们当新增列存进去，还原时要按当前列定义剔除
+ * @author nokecy
+ */
+export function dropQueryOnlyItems(flatConfig, originalColumnDefs) {
+  var queryOnlyFields = new Set();
+  var collect = function collect(defs) {
+    return defs.forEach(function (def) {
+      if ('children' in def && def.children) collect(def.children);else if (def.hideInTable && def.field) queryOnlyFields.add(def.field);
+    });
+  };
+  collect(originalColumnDefs !== null && originalColumnDefs !== void 0 ? originalColumnDefs : []);
+  return flatConfig.filter(function (item) {
+    return item.type !== 'column' || !item.field || !queryOnlyFields.has(item.field);
+  });
+}
+
 /**
  * Grid State → 扁平化配置
  * 将 AG-Grid 的树形结构转换为扁平化数组，用于 UI 展示和编辑
@@ -134,6 +167,10 @@ export function gridStateToFlatConfig(columnDefs, originalColumnDefs) {
  * @returns AG-Grid 列定义数组
  */
 export function flatConfigToGridState(flatConfig, originalColumnDefs) {
+  // 只做查询条件的列不进表格：方案里存过的剔除，也不当新增列补回 @author nokecy
+  flatConfig = dropQueryOnlyItems(flatConfig, originalColumnDefs);
+  originalColumnDefs = excludeQueryOnlyColumns(originalColumnDefs);
+
   /**
    * 从原始列定义中查找指定字段的列定义（支持递归查找分组内的列）
    */
@@ -451,6 +488,10 @@ export function isOldSchemeData(data) {
  * @returns AG-Grid columnState 数组
  */
 export function flatConfigToColumnState(flatConfig, originalColumnDefs) {
+  // 只做查询条件的列不进表格：方案里存过的剔除，也不当新增列补回 @author nokecy
+  flatConfig = dropQueryOnlyItems(flatConfig, originalColumnDefs);
+  originalColumnDefs = excludeQueryOnlyColumns(originalColumnDefs);
+
   /**
    * 递归收集所有列定义（包括分组内的列）
    */

package/dist/esm/array-table/utils.js

@@ -9,8 +9,9 @@ function _objectWithoutProperties(source, excluded) { if (source == null) return
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import React from 'react';
 import { theme } from 'antd';
-import { useField, useFieldSchema, RecursionField, Observer } from '@formily/react';
-import { isArr } from '@formily/shared';
+import { useField, useFieldSchema, RecursionField, Observer, useExpressionScope } from '@formily/react';
+import { isArr, lazyMerge } from '@formily/shared';
+import { Schema } from '@formily/json-schema';
 import ArrayBase from "./arrayBase";
 import { getReadOnlyFormatter } from "./readOnlyFormatters";
 var isColumnComponent = function isColumnComponent(schema) {
@@ -183,6 +184,54 @@ var resolveEmptyPlaceholder = function resolveEmptyPlaceholder(fieldSchema) {
   return SELECT_LIKE.has(fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']) ? '请选择' : '请输入';
 };
 
+/** Formily 字段的四种 pattern;x-pattern 求出来不在其中,视为「求不出」 */
+var CELL_PATTERNS = new Set(['editable', 'disabled', 'readOnly', 'readPretty']);
+
+/**
+ * 懒挂载格此刻的 pattern。
+ *
+ * 懒挂载不创建 Formily 字段,拿不到字段实例上求好的 pattern,只能按同一套规则自己求:
+ * 字段自己的 x-pattern 优先(表达式按本行本格的作用域求值,$self 只提供 path/index/value/form/parent/query),
+ * 没写则继承整表 pattern。表达式用到本格没有的能力、抛错或求出非法值时返回 undefined,
+ * 调用方按「可编辑」处理,保持原有提示。@author nokecy
+ */
+var resolveLazyCellPattern = function resolveLazyCellPattern(arrayField, record, dataKey, fieldSchema, scope) {
+  var own = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-pattern'];
+  if (own == null) return arrayField === null || arrayField === void 0 ? void 0 : arrayField.pattern;
+  if (typeof own !== 'string') return undefined;
+  if (CELL_PATTERNS.has(own)) return own;
+  var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+  if (!form || !dataKey) return undefined;
+  try {
+    var _arrayField$value$ind, _arrayField$value, _arrayField$value$ind2;
+    var index = (_arrayField$value$ind = (_arrayField$value = arrayField.value) === null || _arrayField$value === void 0 || (_arrayField$value$ind2 = _arrayField$value.indexOf) === null || _arrayField$value$ind2 === void 0 ? void 0 : _arrayField$value$ind2.call(_arrayField$value, record)) !== null && _arrayField$value$ind !== void 0 ? _arrayField$value$ind : -1;
+    var path = arrayField.address.concat(index).concat(dataKey);
+    var self = {
+      path: path,
+      address: path,
+      index: index,
+      form: form,
+      parent: arrayField,
+      get value() {
+        return readByFieldPath(record, dataKey);
+      },
+      query: function query(pattern) {
+        return form.query(pattern);
+      }
+    };
+    var result = Schema.shallowCompile(own, lazyMerge(scope !== null && scope !== void 0 ? scope : {}, {
+      $form: form,
+      $values: form.values,
+      $self: self,
+      $record: record,
+      $index: index
+    }));
+    return CELL_PATTERNS.has(result) ? result : undefined;
+  } catch (_unused) {
+    return undefined;
+  }
+};
+
 /**
  * 懒挂载单元格渲染器(可编辑列)。
  *
@@ -212,6 +261,7 @@ var LazyAgField = function LazyAgField(params) {
   // hook 必须在下面的条件 return 之前调用
   var _theme$useToken = theme.useToken(),
     token = _theme$useToken.token;
+  var scope = useExpressionScope();
   var key = "".concat(node === null || node === void 0 ? void 0 : node.id, ":").concat(colDef === null || colDef === void 0 ? void 0 : colDef.field);
   var activated = (record === null || record === void 0 ? void 0 : record._isNew) === true || (context === null || context === void 0 || (_context$activeCells = context.activeCells) === null || _context$activeCells === void 0 || (_context$activeCells$ = _context$activeCells.has) === null || _context$activeCells$ === void 0 ? void 0 : _context$activeCells$.call(_context$activeCells, key)) === true;
   if (activated) {
@@ -238,7 +288,9 @@ var LazyAgField = function LazyAgField(params) {
       fieldSchema: fieldSchema
     }) : liveValue == null ? '' : String(liveValue);
     // 纯文本占满单元格,点击交给 AG-Grid onCellClicked 激活;样式尽量贴近 Editable 只读态避免点开跳动
-    if (text === '') {
+    // 只读态(readPretty/disabled/readOnly)的空格不出编辑提示,留空与只读快路径一致
+    var pattern = text === '' ? resolveLazyCellPattern(field, record, dataKey, fieldSchema, scope) : undefined;
+    if (text === '' && (pattern == null || pattern === 'editable')) {
       // 空值:出淡灰 placeholder,让用户看得出这格能填(颜色取 antd 输入框 placeholder 的 token,自动跟随暗色主题)
       return /*#__PURE__*/React.createElement("span", {
         className: "ag-array-table-lazy-placeholder",