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

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 {};

package/dist/cjs/RuleBuilder/context/RuleBuilderContext.js

@@ -0,0 +1,287 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RuleBuilderProvider = RuleBuilderProvider;
+exports.useFields = useFields;
+exports.useIsDirty = useIsDirty;
+exports.useLoading = useLoading;
+exports.useRuleBuilderContext = useRuleBuilderContext;
+exports.useRuleBuilderDispatch = useRuleBuilderDispatch;
+exports.useRuleBuilderFields = useRuleBuilderFields;
+exports.useRuleBuilderState = useRuleBuilderState;
+exports.useRuleBuilderValidation = useRuleBuilderValidation;
+exports.useRuleGroup = useRuleGroup;
+exports.useValidation = useValidation;
+var _react = _interopRequireWildcard(require("react"));
+var _pathHelpers = require("../utils/pathHelpers");
+var _ruleHelpers = require("../utils/ruleHelpers");
+var _jsxRuntime = require("react/jsx-runtime");
+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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure 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 _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 _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+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); } /**
+ * 规则构建器状态管理 Context
+ * 使用 React Context + useReducer 模式实现全局状态管理
+ */ /**
+ * 初始验证结果
+ */
+var INITIAL_VALIDATION = {
+  isValid: true,
+  errors: [],
+  warnings: []
+};
+
+/**
+ * 创建初始状态
+ */
+function createInitialState(initialRule) {
+  var fields = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  return {
+    ruleGroup: initialRule || (0, _ruleHelpers.createEmptyRuleGroup)(0),
+    // And 逻辑组
+    fields: fields,
+    loading: false,
+    validationResult: INITIAL_VALIDATION,
+    isDirty: false
+  };
+}
+
+/**
+ * Reducer 函数
+ */
+function ruleBuilderReducer(state, action) {
+  switch (action.type) {
+    case 'SET_RULE_GROUP':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        ruleGroup: action.payload,
+        isDirty: false
+      });
+    case 'SET_FIELDS':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        fields: action.payload
+      });
+    case 'SET_LOADING':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        loading: action.payload
+      });
+    case 'UPDATE_RULE':
+      {
+        var _action$payload = action.payload,
+          path = _action$payload.path,
+          rule = _action$payload.rule;
+        var newRuleGroup = (0, _pathHelpers.updateRuleAtPath)(state.ruleGroup, path, rule);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          ruleGroup: newRuleGroup,
+          isDirty: true
+        });
+      }
+    case 'DELETE_RULE':
+      {
+        var _path = action.payload.path;
+        var _newRuleGroup = (0, _pathHelpers.deleteRuleAtPath)(state.ruleGroup, _path);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          ruleGroup: _newRuleGroup,
+          isDirty: true
+        });
+      }
+    case 'ADD_RULE':
+      {
+        var _action$payload2 = action.payload,
+          _path2 = _action$payload2.path,
+          _rule = _action$payload2.rule;
+        var _newRuleGroup2 = (0, _pathHelpers.addRuleAtPath)(state.ruleGroup, _path2, _rule);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          ruleGroup: _newRuleGroup2,
+          isDirty: true
+        });
+      }
+    case 'UPDATE_RULE_GROUP':
+      {
+        var _action$payload3 = action.payload,
+          _path3 = _action$payload3.path,
+          group = _action$payload3.group;
+        var _newRuleGroup3 = (0, _pathHelpers.updateRuleGroupAtPath)(state.ruleGroup, _path3, group);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          ruleGroup: _newRuleGroup3,
+          isDirty: true
+        });
+      }
+    case 'DELETE_RULE_GROUP':
+      {
+        var _path4 = action.payload.path;
+        var _newRuleGroup4 = (0, _pathHelpers.deleteRuleGroupAtPath)(state.ruleGroup, _path4);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          ruleGroup: _newRuleGroup4,
+          isDirty: true
+        });
+      }
+    case 'ADD_RULE_GROUP':
+      {
+        var _action$payload4 = action.payload,
+          _path5 = _action$payload4.path,
+          _group = _action$payload4.group;
+        var _newRuleGroup5 = (0, _pathHelpers.addRuleGroupAtPath)(state.ruleGroup, _path5, _group);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          ruleGroup: _newRuleGroup5,
+          isDirty: true
+        });
+      }
+    case 'SET_VALIDATION_RESULT':
+      return _objectSpread(_objectSpread({}, state), {}, {
+        validationResult: action.payload
+      });
+    case 'RESET':
+      {
+        return createInitialState(undefined, state.fields);
+      }
+    default:
+      return state;
+  }
+}
+
+/**
+ * Context 类型定义
+ */
+
+/**
+ * Context 对象
+ */
+var RuleBuilderContext = /*#__PURE__*/(0, _react.createContext)(undefined);
+
+/**
+ * Provider Props
+ */
+
+/**
+ * RuleBuilder Provider 组件
+ */
+function RuleBuilderProvider(_ref) {
+  var children = _ref.children,
+    initialRule = _ref.initialRule,
+    fields = _ref.fields;
+  var _useReducer = (0, _react.useReducer)(ruleBuilderReducer, createInitialState(initialRule, fields)),
+    _useReducer2 = _slicedToArray(_useReducer, 2),
+    state = _useReducer2[0],
+    dispatch = _useReducer2[1];
+
+  // 监听fields变化，同步更新到state
+  _react.default.useEffect(function () {
+    dispatch({
+      type: 'SET_FIELDS',
+      payload: fields
+    });
+  }, [fields]);
+
+  // 使用 useMemo 避免不必要的重渲染
+  var contextValue = (0, _react.useMemo)(function () {
+    return {
+      state: state,
+      dispatch: dispatch
+    };
+  }, [state]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(RuleBuilderContext.Provider, {
+    value: contextValue,
+    children: children
+  });
+}
+
+/**
+ * 使用 RuleBuilder Context 的 Hook
+ * @throws {Error} 如果在 Provider 外部使用
+ */
+function useRuleBuilderContext() {
+  var context = (0, _react.useContext)(RuleBuilderContext);
+  if (context === undefined) {
+    throw new Error('useRuleBuilderContext 必须在 RuleBuilderProvider 内部使用');
+  }
+  return context;
+}
+
+/**
+ * 便捷 Hook: 获取当前规则组
+ */
+function useRuleGroup() {
+  var _useRuleBuilderContex = useRuleBuilderContext(),
+    state = _useRuleBuilderContex.state;
+  return state.ruleGroup;
+}
+
+/**
+ * 便捷 Hook: 获取字段列表
+ */
+function useFields() {
+  var _useRuleBuilderContex2 = useRuleBuilderContext(),
+    state = _useRuleBuilderContex2.state;
+  return state.fields;
+}
+
+/**
+ * 便捷 Hook: 获取加载状态
+ */
+function useLoading() {
+  var _useRuleBuilderContex3 = useRuleBuilderContext(),
+    state = _useRuleBuilderContex3.state;
+  return state.loading;
+}
+
+/**
+ * 便捷 Hook: 获取验证结果
+ */
+function useValidation() {
+  var _useRuleBuilderContex4 = useRuleBuilderContext(),
+    state = _useRuleBuilderContex4.state;
+  return state.validationResult;
+}
+
+/**
+ * 便捷 Hook: 获取修改状态
+ */
+function useIsDirty() {
+  var _useRuleBuilderContex5 = useRuleBuilderContext(),
+    state = _useRuleBuilderContex5.state;
+  return state.isDirty;
+}
+
+/**
+ * 便捷 Hook: 获取 state
+ */
+function useRuleBuilderState() {
+  var _useRuleBuilderContex6 = useRuleBuilderContext(),
+    state = _useRuleBuilderContex6.state;
+  return state;
+}
+
+/**
+ * 便捷 Hook: 获取 dispatch
+ */
+function useRuleBuilderDispatch() {
+  var _useRuleBuilderContex7 = useRuleBuilderContext(),
+    dispatch = _useRuleBuilderContex7.dispatch;
+  return dispatch;
+}
+
+/**
+ * 便捷 Hook: 获取字段列表（别名，与 useFields 相同）
+ */
+function useRuleBuilderFields() {
+  return useFields();
+}
+
+/**
+ * 便捷 Hook: 获取验证结果（别名，与 useValidation 相同）
+ */
+function useRuleBuilderValidation() {
+  return useValidation();
+}

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

@@ -0,0 +1,25 @@
+/**
+ * RuleBuilder 规则构建器组件
+ *
+ * 主导出文件 - 导出所有公共 API
+ *
+ * @module RuleBuilder
+ */
+export { RuleBuilderContainer as RuleBuilder } from './RuleBuilderContainer';
+export { RuleBuilderContainer } from './RuleBuilderContainer';
+export { RuleGroupEditor } from './RuleGroupEditor';
+export { RuleCard } from './RuleCard';
+export { LogicSelector } from './LogicSelector';
+export { FieldSelector } from './selectors/FieldSelector';
+export { OperatorSelector } from './selectors/OperatorSelector';
+export { ValueInput } from './inputs/ValueInput';
+export { SingleValueInput } from './inputs/SingleValueInput';
+export { BetweenValueInput } from './inputs/BetweenValueInput';
+export { MultiValueInput } from './inputs/MultiValueInput';
+export { RuleBuilderProvider, useRuleBuilderContext, useRuleBuilderState, useRuleBuilderDispatch, useRuleBuilderFields, useRuleBuilderValidation, useRuleGroup, useFields, useLoading, useValidation, useIsDirty, } from './context/RuleBuilderContext';
+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, 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/index';
+export { RuleBuilderContainer as default } from './RuleBuilderContainer';