@nokecy/qc-ui 1.1.47 → 1.1.49

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/array-table/utils.js

@@ -8,6 +8,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 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 ArrayBase from "./arrayBase";
@@ -162,6 +163,26 @@ var readByFieldPath = function readByFieldPath(record, path) {
   }, record);
 };
 
+/** 「选一个」型组件:空值占位说「请选择」,其余说「请输入」 */
+var SELECT_LIKE = new Set(['Select', 'TreeSelect', 'Cascader', 'DatePicker', 'TimePicker', 'Radio.Group', 'Checkbox.Group', 'Transfer']);
+
+/**
+ * 懒挂载空值格显示什么。
+ *
+ * 懒挂载把未激活的可编辑格降成纯文本,值为空时整格一片空白——连输入框边框都没有,
+ * 用户看不出这里能填,以为功能坏了。故空值时按真控件的 placeholder 出淡灰占位,
+ * 点开前后看到同一句话,观感连续。
+ *
+ * 同样的理由 Switch/Checkbox 早就强制 eager 了(见 buildArrayTableColumns 的
+ * isInlineToggle),这里是把那条理由推广到其余可编辑列。@author nokecy
+ */
+var resolveEmptyPlaceholder = function resolveEmptyPlaceholder(fieldSchema) {
+  var _fieldSchema$xCompon;
+  var configured = fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon === void 0 ? void 0 : _fieldSchema$xCompon.placeholder;
+  if (typeof configured === 'string' && configured) return configured;
+  return SELECT_LIKE.has(fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']) ? '请选择' : '请输入';
+};
+
 /**
  * 懒挂载单元格渲染器(可编辑列)。
  *
@@ -188,6 +209,9 @@ var LazyAgField = function LazyAgField(params) {
     formatter = params.formatter,
     columnProps = params.columnProps,
     fieldSchema = params.fieldSchema;
+  // hook 必须在下面的条件 return 之前调用
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token;
   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) {
@@ -214,6 +238,18 @@ var LazyAgField = function LazyAgField(params) {
       fieldSchema: fieldSchema
     }) : liveValue == null ? '' : String(liveValue);
     // 纯文本占满单元格,点击交给 AG-Grid onCellClicked 激活;样式尽量贴近 Editable 只读态避免点开跳动
+    if (text === '') {
+      // 空值:出淡灰 placeholder,让用户看得出这格能填(颜色取 antd 输入框 placeholder 的 token,自动跟随暗色主题)
+      return /*#__PURE__*/React.createElement("span", {
+        className: "ag-array-table-lazy-placeholder",
+        style: {
+          display: 'inline-block',
+          width: '100%',
+          cursor: 'text',
+          color: token.colorTextPlaceholder
+        }
+      }, resolveEmptyPlaceholder(fieldSchema));
+    }
     return /*#__PURE__*/React.createElement("span", {
       className: "ag-array-table-lazy-text",
       style: {