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

package/dist/esm/RuleBuilder/RuleGroupEditor.js

@@ -0,0 +1,203 @@
+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); }
+/**
+ * 规则组编辑器组件 - 紧凑版
+ *
+ * 生产环境优化：紧凑布局，小尺寸，优化空间利用
+ */
+
+import React, { useCallback } from 'react';
+import { Button, message, Tag } from 'antd';
+import { PlusOutlined, DeleteOutlined, GroupOutlined } from '@ant-design/icons';
+import { RuleCard } from "./RuleCard";
+import { LogicSelector } from "./LogicSelector";
+import { useRuleBuilderContext } from "./context/RuleBuilderContext";
+import { getRuleGroupByPath } from "./utils/pathHelpers";
+import { createEmptyRule, createEmptyRuleGroup } from "./utils/ruleHelpers";
+import styles from "./styles/index.module.less";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * 规则组编辑器组件 - 紧凑版
+ * 移除Card组件，使用轻量级div布局
+ */
+export var 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 = useRuleBuilderContext(),
+    state = _useRuleBuilderContex.state,
+    dispatch = _useRuleBuilderContex.dispatch;
+  var currentGroup = getRuleGroupByPath(state.ruleGroup, path);
+  var handleLogicChange = 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 = useCallback(function () {
+    var newRule = 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 = useCallback(function () {
+    if (level >= maxLevel) {
+      message.warning("\u89C4\u5219\u7EC4\u5D4C\u5957\u5C42\u7EA7\u4E0D\u80FD\u8D85\u8FC7 ".concat(maxLevel, " \u5C42"));
+      return;
+    }
+    var newGroup = 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 = useCallback(function () {
+    if (level === 0) {
+      message.warning('根规则组不能删除');
+      return;
+    }
+    dispatch({
+      type: 'DELETE_RULE_GROUP',
+      payload: {
+        path: path
+      }
+    });
+  }, [level, path, dispatch]);
+  var levelClass = "level".concat(level);
+  var logicClass = currentGroup.logic === 1 ? styles.orLogicGroup : '';
+  var className = "".concat(styles.ruleGroupEditor, " ").concat(styles[levelClass] || '', " ").concat(logicClass);
+  var marginLeft = level * 12; // 减小缩进
+
+  return /*#__PURE__*/_jsxs("div", {
+    className: className,
+    style: {
+      marginLeft: marginLeft
+    },
+    children: [/*#__PURE__*/_jsxs("div", {
+      className: styles.groupHeader,
+      children: [/*#__PURE__*/_jsxs("div", {
+        className: styles.groupTitle,
+        children: [/*#__PURE__*/_jsx(GroupOutlined, {
+          style: {
+            fontSize: '12px'
+          }
+        }), /*#__PURE__*/_jsxs("span", {
+          children: ["\u89C4\u5219\u7EC4 ", level]
+        }), /*#__PURE__*/_jsxs(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__*/_jsxs("div", {
+        className: styles.groupActions,
+        children: [/*#__PURE__*/_jsx(LogicSelector, {
+          value: currentGroup.logic,
+          onChange: handleLogicChange,
+          disabled: readonly,
+          size: "small"
+        }), !readonly && level > 0 && /*#__PURE__*/_jsx(Button, {
+          type: "text",
+          danger: true,
+          size: "small",
+          icon: /*#__PURE__*/_jsx(DeleteOutlined, {}),
+          onClick: handleDeleteGroup,
+          title: "\u5220\u9664\u89C4\u5219\u7EC4"
+        })]
+      })]
+    }), /*#__PURE__*/_jsxs("div", {
+      className: styles.groupContent,
+      children: [currentGroup.rules.map(function (rule, ruleIndex) {
+        var rulePath = [].concat(_toConsumableArray(path), [ruleIndex]);
+        return /*#__PURE__*/_jsx(RuleCard, {
+          rule: rule,
+          path: rulePath,
+          readonly: readonly,
+          allowFieldComparison: allowFieldComparison
+        }, ruleIndex);
+      }), currentGroup.groups.length > 0 && /*#__PURE__*/_jsx("div", {
+        className: styles.nestedGroups,
+        children: currentGroup.groups.map(function (group, groupIndex) {
+          var groupPath = [].concat(_toConsumableArray(path), [groupIndex]);
+          return /*#__PURE__*/_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__*/_jsxs("div", {
+        className: styles.emptyState,
+        children: [/*#__PURE__*/_jsx("div", {
+          className: styles.emptyIcon,
+          children: "\uD83D\uDCCB"
+        }), /*#__PURE__*/_jsx("div", {
+          className: styles.emptyText,
+          children: "\u6682\u65E0\u89C4\u5219"
+        })]
+      }), !readonly && /*#__PURE__*/_jsxs("div", {
+        className: styles.addButtonGroup,
+        children: [/*#__PURE__*/_jsx(Button, {
+          type: "primary",
+          size: "small",
+          icon: /*#__PURE__*/_jsx(PlusOutlined, {}),
+          onClick: handleAddRule,
+          children: "\u6DFB\u52A0\u89C4\u5219"
+        }), level < maxLevel && /*#__PURE__*/_jsx(Button, {
+          type: "default",
+          size: "small",
+          icon: /*#__PURE__*/_jsx(GroupOutlined, {}),
+          onClick: handleAddRuleGroup,
+          children: "\u6DFB\u52A0\u89C4\u5219\u7EC4"
+        })]
+      })]
+    })]
+  });
+};
+export default RuleGroupEditor;

package/dist/esm/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/esm/RuleBuilder/constants/operators.js

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

package/dist/esm/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 {};