@nokecy/qc-ui-components 0.0.0-stage → 2.0.0-beta.1

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

@@ -0,0 +1,27 @@
+/**
+ * 规则组编辑器组件 - 紧凑版
+ *
+ * 生产环境优化：紧凑布局，小尺寸，优化空间利用
+ */
+import React from 'react';
+import type { RuleGroupDto, RulePath } from './types/index';
+export interface RuleGroupEditorProps {
+    /** 当前规则组的路径 */
+    path: RulePath;
+    /** 当前嵌套层级(从 0 开始) */
+    level: number;
+    /** 最大允许嵌套层级 */
+    maxLevel: number;
+    /** 是否只读模式 */
+    readonly?: boolean;
+    /** 是否允许与另一个字段比较 @author nokecy */
+    allowFieldComparison?: boolean;
+    /** 规则组变更回调(可选) */
+    onChange?: (group: RuleGroupDto) => void;
+}
+/**
+ * 规则组编辑器组件 - 紧凑版
+ * 移除Card组件，使用轻量级div布局
+ */
+export declare const RuleGroupEditor: React.FC<RuleGroupEditorProps>;
+export default RuleGroupEditor;

package/dist/cjs/RuleBuilder/RuleGroupEditor.js

@@ -0,0 +1,209 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.RuleGroupEditor = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _antd = require("antd");
+var _icons = require("@ant-design/icons");
+var _RuleCard = require("./RuleCard");
+var _LogicSelector = require("./LogicSelector");
+var _RuleBuilderContext = require("./context/RuleBuilderContext");
+var _pathHelpers = require("./utils/pathHelpers");
+var _ruleHelpers = require("./utils/ruleHelpers");
+var _indexModule = _interopRequireDefault(require("./styles/index.module.less"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+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 _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 _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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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); } /**
+ * 规则组编辑器组件 - 紧凑版
+ *
+ * 生产环境优化：紧凑布局，小尺寸，优化空间利用
+ */
+/**
+ * 规则组编辑器组件 - 紧凑版
+ * 移除Card组件，使用轻量级div布局
+ */
+var RuleGroupEditor = exports.RuleGroupEditor = function RuleGroupEditor(_ref) {
+  var path = _ref.path,
+    level = _ref.level,
+    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 = (0, _RuleBuilderContext.useRuleBuilderContext)(),
+    state = _useRuleBuilderContex.state,
+    dispatch = _useRuleBuilderContex.dispatch;
+  var currentGroup = (0, _pathHelpers.getRuleGroupByPath)(state.ruleGroup, path);
+  var handleLogicChange = (0, _react.useCallback)(function (logic) {
+    var updatedGroup = _objectSpread(_objectSpread({}, currentGroup), {}, {
+      logic: logic
+    });
+    dispatch({
+      type: 'UPDATE_RULE_GROUP',
+      payload: {
+        path: path,
+        group: updatedGroup
+      }
+    });
+    onChange === null || onChange === void 0 || onChange(updatedGroup);
+  }, [currentGroup, path, dispatch, onChange]);
+  var handleAddRule = (0, _react.useCallback)(function () {
+    var newRule = (0, _ruleHelpers.createEmptyRule)();
+    dispatch({
+      type: 'ADD_RULE',
+      payload: {
+        path: path,
+        rule: newRule
+      }
+    });
+    if (onChange) {
+      var updatedGroup = _objectSpread(_objectSpread({}, currentGroup), {}, {
+        rules: [].concat(_toConsumableArray(currentGroup.rules), [newRule])
+      });
+      onChange(updatedGroup);
+    }
+  }, [path, currentGroup, dispatch, onChange]);
+  var handleAddRuleGroup = (0, _react.useCallback)(function () {
+    if (level >= maxLevel) {
+      _antd.message.warning("\u89C4\u5219\u7EC4\u5D4C\u5957\u5C42\u7EA7\u4E0D\u80FD\u8D85\u8FC7 ".concat(maxLevel, " \u5C42"));
+      return;
+    }
+    var newGroup = (0, _ruleHelpers.createEmptyRuleGroup)();
+    dispatch({
+      type: 'ADD_RULE_GROUP',
+      payload: {
+        path: path,
+        group: newGroup
+      }
+    });
+    if (onChange) {
+      var updatedGroup = _objectSpread(_objectSpread({}, currentGroup), {}, {
+        groups: [].concat(_toConsumableArray(currentGroup.groups), [newGroup])
+      });
+      onChange(updatedGroup);
+    }
+  }, [level, maxLevel, path, currentGroup, dispatch, onChange]);
+  var handleDeleteGroup = (0, _react.useCallback)(function () {
+    if (level === 0) {
+      _antd.message.warning('根规则组不能删除');
+      return;
+    }
+    dispatch({
+      type: 'DELETE_RULE_GROUP',
+      payload: {
+        path: path
+      }
+    });
+  }, [level, path, dispatch]);
+  var levelClass = "level".concat(level);
+  var logicClass = currentGroup.logic === 1 ? _indexModule.default.orLogicGroup : '';
+  var className = "".concat(_indexModule.default.ruleGroupEditor, " ").concat(_indexModule.default[levelClass] || '', " ").concat(logicClass);
+  var marginLeft = level * 12; // 减小缩进
+
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+    className: className,
+    style: {
+      marginLeft: marginLeft
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+      className: _indexModule.default.groupHeader,
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        className: _indexModule.default.groupTitle,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.GroupOutlined, {
+          style: {
+            fontSize: '12px'
+          }
+        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)("span", {
+          children: ["\u89C4\u5219\u7EC4 ", level]
+        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_antd.Tag, {
+          color: currentGroup.logic === 0 ? 'blue' : 'orange',
+          style: {
+            marginLeft: '4px',
+            fontSize: '11px'
+          },
+          children: [currentGroup.rules.length, "\u6761\u89C4\u5219", currentGroup.groups.length > 0 && " + ".concat(currentGroup.groups.length, "\u7EC4")]
+        })]
+      }), /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        className: _indexModule.default.groupActions,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_LogicSelector.LogicSelector, {
+          value: currentGroup.logic,
+          onChange: handleLogicChange,
+          disabled: readonly,
+          size: "small"
+        }), !readonly && level > 0 && /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Button, {
+          type: "text",
+          danger: true,
+          size: "small",
+          icon: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.DeleteOutlined, {}),
+          onClick: handleDeleteGroup,
+          title: "\u5220\u9664\u89C4\u5219\u7EC4"
+        })]
+      })]
+    }), /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+      className: _indexModule.default.groupContent,
+      children: [currentGroup.rules.map(function (rule, ruleIndex) {
+        var rulePath = [].concat(_toConsumableArray(path), [ruleIndex]);
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_RuleCard.RuleCard, {
+          rule: rule,
+          path: rulePath,
+          readonly: readonly,
+          allowFieldComparison: allowFieldComparison
+        }, ruleIndex);
+      }), currentGroup.groups.length > 0 && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+        className: _indexModule.default.nestedGroups,
+        children: currentGroup.groups.map(function (group, groupIndex) {
+          var groupPath = [].concat(_toConsumableArray(path), [groupIndex]);
+          return /*#__PURE__*/(0, _jsxRuntime.jsx)(RuleGroupEditor, {
+            path: groupPath,
+            level: level + 1,
+            maxLevel: maxLevel,
+            readonly: readonly,
+            allowFieldComparison: allowFieldComparison,
+            onChange: onChange
+          }, groupIndex);
+        })
+      }), currentGroup.rules.length === 0 && currentGroup.groups.length === 0 && /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        className: _indexModule.default.emptyState,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+          className: _indexModule.default.emptyIcon,
+          children: "\uD83D\uDCCB"
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+          className: _indexModule.default.emptyText,
+          children: "\u6682\u65E0\u89C4\u5219"
+        })]
+      }), !readonly && /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        className: _indexModule.default.addButtonGroup,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Button, {
+          type: "primary",
+          size: "small",
+          icon: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.PlusOutlined, {}),
+          onClick: handleAddRule,
+          children: "\u6DFB\u52A0\u89C4\u5219"
+        }), level < maxLevel && /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Button, {
+          type: "default",
+          size: "small",
+          icon: /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.GroupOutlined, {}),
+          onClick: handleAddRuleGroup,
+          children: "\u6DFB\u52A0\u89C4\u5219\u7EC4"
+        })]
+      })]
+    })]
+  });
+};
+var _default = exports.default = RuleGroupEditor;

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

@@ -0,0 +1,52 @@
+/**
+ * 操作符常量定义
+ */
+import { MatchOperator, FieldDataType } from '../types/index';
+/**
+ * 操作符显示信息
+ */
+export interface OperatorInfo {
+    value: MatchOperator;
+    label: string;
+    symbol: string;
+    description: string;
+    /** 是否需要输入值 */
+    requiresValue: boolean;
+    /** 是否需要第二个值（Between） */
+    requiresValue2: boolean;
+    /** 是否需要多个值（In/NotIn） */
+    requiresMultiValue: boolean;
+}
+/**
+ * 所有操作符的显示信息
+ */
+export declare const OPERATOR_INFO_MAP: Record<MatchOperator, OperatorInfo>;
+/**
+ * 根据数据类型获取可用操作符
+ */
+export declare const getOperatorsByDataType: (dataType: FieldDataType) => MatchOperator[];
+/**
+ * 获取操作符信息
+ */
+export declare const getOperatorInfo: (operator: MatchOperator) => OperatorInfo;
+/**
+ * 检查操作符是否需要值输入
+ */
+export declare const operatorRequiresValue: (operator: MatchOperator) => boolean;
+/**
+ * 检查操作符是否需要第二个值（Between）
+ */
+export declare const operatorRequiresValue2: (operator: MatchOperator) => boolean;
+/**
+ * 检查操作符是否需要多个值（In/NotIn）
+ */
+export declare const operatorRequiresMultiValue: (operator: MatchOperator) => boolean;
+/**
+ * 检查操作符是否支持与另一个字段比较（与后端 RuleGroupValidator 一致：等于、不等于及 4 个大小比较）
+ * @author nokecy
+ */
+export declare const operatorSupportsValueField: (operator: MatchOperator) => boolean;
+/**
+ * 最大嵌套层级
+ */
+export declare const MAX_NESTING_LEVEL = 5;

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

@@ -0,0 +1,180 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.operatorSupportsValueField = exports.operatorRequiresValue2 = exports.operatorRequiresValue = exports.operatorRequiresMultiValue = exports.getOperatorsByDataType = exports.getOperatorInfo = exports.OPERATOR_INFO_MAP = exports.MAX_NESTING_LEVEL = void 0;
+var _index = require("../types/index");
+var _OPERATOR_INFO_MAP;
+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 _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); } /**
+ * 操作符常量定义
+ */
+/**
+ * 操作符显示信息
+ */
+
+/**
+ * 所有操作符的显示信息
+ */
+var OPERATOR_INFO_MAP = exports.OPERATOR_INFO_MAP = (_OPERATOR_INFO_MAP = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_OPERATOR_INFO_MAP, _index.MatchOperator.Equals, {
+  value: _index.MatchOperator.Equals,
+  label: '等于',
+  symbol: '=',
+  description: '字段值等于指定值',
+  requiresValue: true,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _index.MatchOperator.NotEquals, {
+  value: _index.MatchOperator.NotEquals,
+  label: '不等于',
+  symbol: '≠',
+  description: '字段值不等于指定值',
+  requiresValue: true,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _index.MatchOperator.GreaterThan, {
+  value: _index.MatchOperator.GreaterThan,
+  label: '大于',
+  symbol: '>',
+  description: '字段值大于指定值',
+  requiresValue: true,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _index.MatchOperator.GreaterThanOrEqual, {
+  value: _index.MatchOperator.GreaterThanOrEqual,
+  label: '大于等于',
+  symbol: '≥',
+  description: '字段值大于或等于指定值',
+  requiresValue: true,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _index.MatchOperator.LessThan, {
+  value: _index.MatchOperator.LessThan,
+  label: '小于',
+  symbol: '<',
+  description: '字段值小于指定值',
+  requiresValue: true,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _index.MatchOperator.LessThanOrEqual, {
+  value: _index.MatchOperator.LessThanOrEqual,
+  label: '小于等于',
+  symbol: '≤',
+  description: '字段值小于或等于指定值',
+  requiresValue: true,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _index.MatchOperator.In, {
+  value: _index.MatchOperator.In,
+  label: '在集合中',
+  symbol: 'IN',
+  description: '字段值在指定的值集合中',
+  requiresValue: false,
+  requiresValue2: false,
+  requiresMultiValue: true
+}), _index.MatchOperator.NotIn, {
+  value: _index.MatchOperator.NotIn,
+  label: '不在集合中',
+  symbol: 'NOT IN',
+  description: '字段值不在指定的值集合中',
+  requiresValue: false,
+  requiresValue2: false,
+  requiresMultiValue: true
+}), _index.MatchOperator.Between, {
+  value: _index.MatchOperator.Between,
+  label: '介于之间',
+  symbol: 'BETWEEN',
+  description: '字段值在指定的范围之间',
+  requiresValue: true,
+  requiresValue2: true,
+  requiresMultiValue: false
+}), _index.MatchOperator.Like, {
+  value: _index.MatchOperator.Like,
+  label: '模糊匹配',
+  symbol: 'LIKE',
+  description: '字段值模糊匹配指定模式（支持 % 通配符）',
+  requiresValue: true,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _defineProperty(_defineProperty(_OPERATOR_INFO_MAP, _index.MatchOperator.IsNull, {
+  value: _index.MatchOperator.IsNull,
+  label: '为空',
+  symbol: 'IS NULL',
+  description: '字段值为空（NULL）',
+  requiresValue: false,
+  requiresValue2: false,
+  requiresMultiValue: false
+}), _index.MatchOperator.IsNotNull, {
+  value: _index.MatchOperator.IsNotNull,
+  label: '不为空',
+  symbol: 'IS NOT NULL',
+  description: '字段值不为空（NOT NULL）',
+  requiresValue: false,
+  requiresValue2: false,
+  requiresMultiValue: false
+}));
+
+/**
+ * 根据数据类型获取可用操作符
+ */
+var getOperatorsByDataType = exports.getOperatorsByDataType = function getOperatorsByDataType(dataType) {
+  switch (dataType) {
+    case 'string':
+      return [_index.MatchOperator.Equals, _index.MatchOperator.NotEquals, _index.MatchOperator.In, _index.MatchOperator.NotIn, _index.MatchOperator.Like, _index.MatchOperator.IsNull, _index.MatchOperator.IsNotNull];
+    case 'number':
+      return [_index.MatchOperator.Equals, _index.MatchOperator.NotEquals, _index.MatchOperator.GreaterThan, _index.MatchOperator.GreaterThanOrEqual, _index.MatchOperator.LessThan, _index.MatchOperator.LessThanOrEqual, _index.MatchOperator.In, _index.MatchOperator.NotIn, _index.MatchOperator.Between, _index.MatchOperator.IsNull, _index.MatchOperator.IsNotNull];
+    case 'date':
+      return [_index.MatchOperator.Equals, _index.MatchOperator.NotEquals, _index.MatchOperator.GreaterThan, _index.MatchOperator.GreaterThanOrEqual, _index.MatchOperator.LessThan, _index.MatchOperator.LessThanOrEqual, _index.MatchOperator.Between, _index.MatchOperator.IsNull, _index.MatchOperator.IsNotNull];
+    case 'boolean':
+      return [_index.MatchOperator.Equals, _index.MatchOperator.NotEquals, _index.MatchOperator.IsNull, _index.MatchOperator.IsNotNull];
+    default:
+      return [];
+  }
+};
+
+/**
+ * 获取操作符信息
+ */
+var getOperatorInfo = exports.getOperatorInfo = function getOperatorInfo(operator) {
+  return OPERATOR_INFO_MAP[operator];
+};
+
+/**
+ * 检查操作符是否需要值输入
+ */
+var operatorRequiresValue = exports.operatorRequiresValue = function operatorRequiresValue(operator) {
+  var _OPERATOR_INFO_MAP$op;
+  return ((_OPERATOR_INFO_MAP$op = OPERATOR_INFO_MAP[operator]) === null || _OPERATOR_INFO_MAP$op === void 0 ? void 0 : _OPERATOR_INFO_MAP$op.requiresValue) || false;
+};
+
+/**
+ * 检查操作符是否需要第二个值（Between）
+ */
+var operatorRequiresValue2 = exports.operatorRequiresValue2 = function operatorRequiresValue2(operator) {
+  var _OPERATOR_INFO_MAP$op2;
+  return ((_OPERATOR_INFO_MAP$op2 = OPERATOR_INFO_MAP[operator]) === null || _OPERATOR_INFO_MAP$op2 === void 0 ? void 0 : _OPERATOR_INFO_MAP$op2.requiresValue2) || false;
+};
+
+/**
+ * 检查操作符是否需要多个值（In/NotIn）
+ */
+var operatorRequiresMultiValue = exports.operatorRequiresMultiValue = function operatorRequiresMultiValue(operator) {
+  var _OPERATOR_INFO_MAP$op3;
+  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
+ */
+var operatorSupportsValueField = exports.operatorSupportsValueField = function operatorSupportsValueField(operator) {
+  return [_index.MatchOperator.Equals, _index.MatchOperator.NotEquals, _index.MatchOperator.GreaterThan, _index.MatchOperator.GreaterThanOrEqual, _index.MatchOperator.LessThan, _index.MatchOperator.LessThanOrEqual].includes(operator);
+};
+
+/**
+ * 最大嵌套层级
+ */
+var MAX_NESTING_LEVEL = exports.MAX_NESTING_LEVEL = 5;

package/dist/cjs/RuleBuilder/context/RuleBuilderContext.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 规则构建器状态管理 Context
+ * 使用 React Context + useReducer 模式实现全局状态管理
+ */
+import React, { type ReactNode } from 'react';
+import type { RuleBuilderState, RuleBuilderAction, RuleGroupDto, FieldDefinition, ValidationResult } from '../types/index';
+/**
+ * Context 类型定义
+ */
+interface RuleBuilderContextValue {
+    /** 当前状态 */
+    state: RuleBuilderState;
+    /** Dispatch 方法 */
+    dispatch: React.Dispatch<RuleBuilderAction>;
+}
+/**
+ * Provider Props
+ */
+interface RuleBuilderProviderProps {
+    /** 子组件 */
+    children: ReactNode;
+    /** 初始规则组 */
+    initialRule?: RuleGroupDto;
+    /** 字段定义列表 */
+    fields: FieldDefinition[];
+}
+/**
+ * RuleBuilder Provider 组件
+ */
+export declare function RuleBuilderProvider({ children, initialRule, fields, }: RuleBuilderProviderProps): React.JSX.Element;
+/**
+ * 使用 RuleBuilder Context 的 Hook
+ * @throws {Error} 如果在 Provider 外部使用
+ */
+export declare function useRuleBuilderContext(): RuleBuilderContextValue;
+/**
+ * 便捷 Hook: 获取当前规则组
+ */
+export declare function useRuleGroup(): RuleGroupDto;
+/**
+ * 便捷 Hook: 获取字段列表
+ */
+export declare function useFields(): FieldDefinition[];
+/**
+ * 便捷 Hook: 获取加载状态
+ */
+export declare function useLoading(): boolean;
+/**
+ * 便捷 Hook: 获取验证结果
+ */
+export declare function useValidation(): ValidationResult;
+/**
+ * 便捷 Hook: 获取修改状态
+ */
+export declare function useIsDirty(): boolean;
+/**
+ * 便捷 Hook: 获取 state
+ */
+export declare function useRuleBuilderState(): RuleBuilderState;
+/**
+ * 便捷 Hook: 获取 dispatch
+ */
+export declare function useRuleBuilderDispatch(): React.Dispatch<RuleBuilderAction>;
+/**
+ * 便捷 Hook: 获取字段列表（别名，与 useFields 相同）
+ */
+export declare function useRuleBuilderFields(): FieldDefinition[];
+/**
+ * 便捷 Hook: 获取验证结果（别名，与 useValidation 相同）
+ */
+export declare function useRuleBuilderValidation(): ValidationResult;
+export {};