@nokecy/qc-ui 1.0.65 → 1.0.67

package/dist/esm/components/RegexEditor/validation/validator.js

@@ -0,0 +1,213 @@
+/**
+ * 正则表达式语法验证器
+ *
+ * @module RegexEditor/validation/validator
+ * @description 检测正则表达式的常见语法错误和安全问题
+ *
+ * @remarks
+ * 该模块基于 regexp-tree AST 提供以下验证规则:
+ * 1. 空捕获组检测 - 检测 () 并建议使用 (?:)
+ * 2. 无效量词检测 - 检测 {min,max} 中 min > max
+ * 3. 嵌套量词检测 - 检测 (a+)+ 等导致灾难性回溯的模式
+ * 4. 未闭合组检测 - 通过解析错误自动检测
+ *
+ * @see {@link parseRegex} 用于解析正则表达式
+ */
+
+import { traverseAST } from "./parser";
+import { parseRegex } from "./parser";
+/**
+ * 验证正则表达式 AST
+ *
+ * @param ast - 抽象语法树节点
+ * @returns {RegexError[]} 错误和警告列表
+ *
+ * @remarks
+ * 该函数遍历 AST 节点,应用以下验证规则:
+ * - 空捕获组 (警告)
+ * - 无效量词 (错误)
+ * - 嵌套量词/灾难性回溯 (错误)
+ *
+ * @example
+ * ```typescript
+ * const result = parseRegex('()test');
+ * const errors = validateRegex(result.ast!);
+ * console.log(errors); // [{ type: 'empty_group', severity: 'warning', ... }]
+ * ```
+ */
+export var validateRegex = function validateRegex(ast) {
+  var errors = [];
+
+  // 规则1: 检查空捕获组
+  traverseAST(ast, {
+    Group: function Group(path) {
+      var node = path.node;
+
+      // 检查是否是捕获组且为空
+      if (node.capturing) {
+        // 空组的判断条件:
+        // - expression 为 undefined/null
+        // - expression.type 为 'Empty'
+        // - expression.type 为 'Alternative' 且 expressions 为空数组
+        var expression = node.expression;
+        var isEmpty = !expression || expression.type === 'Empty' || expression.type === 'Alternative' && Array.isArray(expression.expressions) && expression.expressions.length === 0;
+        if (isEmpty) {
+          var _node$loc, _node$loc2;
+          errors.push({
+            type: 'empty_group',
+            message: '空的捕获组,建议使用非捕获组 (?:)',
+            position: {
+              start: ((_node$loc = node.loc) === null || _node$loc === void 0 ? void 0 : _node$loc.start) || 0,
+              end: ((_node$loc2 = node.loc) === null || _node$loc2 === void 0 ? void 0 : _node$loc2.end) || 0
+            },
+            severity: 'warning',
+            suggestion: '使用 (?:) 代替 ()'
+          });
+        }
+      }
+    }
+  });
+
+  // 规则2: 检查无效量词
+  traverseAST(ast, {
+    Repetition: function Repetition(path) {
+      var node = path.node;
+      var quantifier = node.quantifier;
+
+      // 检查 {min,max} 形式的量词
+      if (quantifier && quantifier.kind === 'Range') {
+        var from = quantifier.from;
+        var to = quantifier.to;
+
+        // 检查最小值是否大于最大值
+        if (typeof from === 'number' && typeof to === 'number' && from > to) {
+          var _node$loc3, _node$loc4;
+          errors.push({
+            type: 'invalid_quantifier',
+            message: "\u65E0\u6548\u7684\u91CF\u8BCD: {".concat(from, ",").concat(to, "} - \u6700\u5C0F\u503C\u4E0D\u80FD\u5927\u4E8E\u6700\u5927\u503C"),
+            position: {
+              start: ((_node$loc3 = node.loc) === null || _node$loc3 === void 0 ? void 0 : _node$loc3.start) || 0,
+              end: ((_node$loc4 = node.loc) === null || _node$loc4 === void 0 ? void 0 : _node$loc4.end) || 0
+            },
+            severity: 'error',
+            suggestion: "\u4F7F\u7528 {".concat(to, ",").concat(from, "} \u6216\u4FEE\u6539\u4E3A\u6B63\u786E\u7684\u8303\u56F4")
+          });
+        }
+      }
+    }
+  });
+
+  // 规则3: 检查嵌套量词（灾难性回溯风险）
+  traverseAST(ast, {
+    Repetition: function Repetition(path) {
+      var _node$expression;
+      var node = path.node;
+
+      // 检查量词内部是否包含另一个量词
+      // 模式: (a+)+, (a*)+, (a?)+, (a{n,m})+
+      if (((_node$expression = node.expression) === null || _node$expression === void 0 ? void 0 : _node$expression.type) === 'Group') {
+        var group = node.expression;
+        var innerExpression = group.expression;
+
+        // 检查组内表达式是否是量词
+        if ((innerExpression === null || innerExpression === void 0 ? void 0 : innerExpression.type) === 'Repetition') {
+          var _node$loc5, _node$loc6;
+          errors.push({
+            type: 'catastrophic_backtracking',
+            message: '嵌套的量词可能导致灾难性回溯',
+            position: {
+              start: ((_node$loc5 = node.loc) === null || _node$loc5 === void 0 ? void 0 : _node$loc5.start) || 0,
+              end: ((_node$loc6 = node.loc) === null || _node$loc6 === void 0 ? void 0 : _node$loc6.end) || 0
+            },
+            severity: 'error',
+            suggestion: '考虑使用原子组 (?>...) 或重新设计表达式'
+          });
+        }
+
+        // 检查更复杂的嵌套: (a|b)+c
+        // Alternative 包含 Repetition
+        if ((innerExpression === null || innerExpression === void 0 ? void 0 : innerExpression.type) === 'Alternative') {
+          var expressions = innerExpression.expressions || [];
+          var hasInnerQuantifier = expressions.some(function (expr) {
+            return expr.type === 'Repetition';
+          });
+          if (hasInnerQuantifier) {
+            var _node$loc7, _node$loc8;
+            errors.push({
+              type: 'catastrophic_backtracking',
+              message: '嵌套的量词可能导致灾难性回溯',
+              position: {
+                start: ((_node$loc7 = node.loc) === null || _node$loc7 === void 0 ? void 0 : _node$loc7.start) || 0,
+                end: ((_node$loc8 = node.loc) === null || _node$loc8 === void 0 ? void 0 : _node$loc8.end) || 0
+              },
+              severity: 'error',
+              suggestion: '考虑使用原子组 (?>...) 或重新设计表达式'
+            });
+          }
+        }
+      }
+    }
+  });
+  return errors;
+};
+
+/**
+ * 整合验证流程: 解析 + 语法验证
+ *
+ * @param pattern - 正则表达式字符串
+ * @param flags - 可选的正则表达式标志
+ * @returns {ValidationResult} 完整的验证结果
+ *
+ * @remarks
+ * 该函数整合了以下步骤:
+ * 1. 解析正则表达式 {@link parseRegex}
+ * 2. 语法验证 {@link validateRegex}
+ * 3. 分类错误、警告和信息
+ *
+ * @example
+ * ```typescript
+ * const result = validatePattern('^LOT\\d{6}$');
+ * if (result.valid) {
+ *   console.log('验证通过');
+ * } else {
+ *   console.error('错误:', result.errors);
+ * }
+ * ```
+ */
+export var validatePattern = function validatePattern(pattern, flags) {
+  // 1. 解析正则表达式
+  var parseResult = parseRegex(pattern, flags);
+
+  // 解析失败,返回解析错误
+  if (!parseResult.success) {
+    return {
+      valid: false,
+      errors: parseResult.error ? [parseResult.error] : [],
+      warnings: [],
+      infos: [],
+      pattern: pattern
+    };
+  }
+
+  // 2. 语法验证
+  var allErrors = validateRegex(parseResult.ast);
+
+  // 3. 分类错误、警告和信息
+  var errors = allErrors.filter(function (e) {
+    return e.severity === 'error';
+  });
+  var warnings = allErrors.filter(function (e) {
+    return e.severity === 'warning';
+  });
+  var infos = allErrors.filter(function (e) {
+    return e.severity === 'info';
+  });
+  return {
+    valid: errors.length === 0,
+    // 只有错误才影响 valid 状态
+    errors: errors,
+    warnings: warnings,
+    infos: infos,
+    pattern: pattern
+  };
+};

package/dist/esm/components/RegexEditor/visualizer/FlagsSelector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * FlagsSelector 组件
+ *
+ * @module RegexEditor/visualizer/FlagsSelector
+ * @description 正则表达式标志选择器组件
+ */
+import React from 'react';
+import type { FlagsSelectorProps } from './types';
+/**
+ * 标志选择器组件
+ *
+ * @example
+ * ```tsx
+ * <FlagsSelector
+ *   value={{ global: true, ignoreCase: true }}
+ *   onChange={(flags) => console.log(flags)}
+ * />
+ * ```
+ */
+export declare const FlagsSelector: React.FC<FlagsSelectorProps>;

package/dist/esm/components/RegexEditor/visualizer/FlagsSelector.js

@@ -0,0 +1,93 @@
+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); }
+/**
+ * FlagsSelector 组件
+ *
+ * @module RegexEditor/visualizer/FlagsSelector
+ * @description 正则表达式标志选择器组件
+ */
+
+import React from 'react';
+import { Checkbox, Space, Tooltip } from 'antd';
+/**
+ * 标志配置
+ */
+var FLAG_CONFIG = [{
+  key: 'global',
+  label: 'g',
+  tooltip: '全局匹配 (global) - 查找所有匹配项'
+}, {
+  key: 'ignoreCase',
+  label: 'i',
+  tooltip: '忽略大小写 (ignoreCase) - 不区分大小写'
+}, {
+  key: 'multiline',
+  label: 'm',
+  tooltip: '多行模式 (multiline) - ^ 和 $ 匹配行首行尾'
+}, {
+  key: 'dotAll',
+  label: 's',
+  tooltip: 'dotAll 模式 - . 匹配包括换行符在内的所有字符'
+}, {
+  key: 'unicode',
+  label: 'u',
+  tooltip: 'Unicode 模式 - 启用 Unicode 匹配'
+}, {
+  key: 'sticky',
+  label: 'y',
+  tooltip: '粘性匹配 (sticky) - 从 lastIndex 位置开始匹配'
+}];
+
+/**
+ * 标志选择器组件
+ *
+ * @example
+ * ```tsx
+ * <FlagsSelector
+ *   value={{ global: true, ignoreCase: true }}
+ *   onChange={(flags) => console.log(flags)}
+ * />
+ * ```
+ */
+export var FlagsSelector = function FlagsSelector(_ref) {
+  var _ref$value = _ref.value,
+    value = _ref$value === void 0 ? {} : _ref$value,
+    onChange = _ref.onChange,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled;
+  /**
+   * 处理标志变化
+   */
+  var handleChange = function handleChange(key) {
+    return function (e) {
+      if (onChange) {
+        onChange(_objectSpread(_objectSpread({}, value), {}, _defineProperty({}, key, e.target.checked)));
+      }
+    };
+  };
+  return /*#__PURE__*/React.createElement(Space, {
+    size: "small"
+  }, /*#__PURE__*/React.createElement("span", {
+    style: {
+      color: '#666'
+    }
+  }, "\u6807\u5FD7:"), FLAG_CONFIG.map(function (flag) {
+    return /*#__PURE__*/React.createElement(Tooltip, {
+      key: flag.key,
+      title: flag.tooltip
+    }, /*#__PURE__*/React.createElement(Checkbox, {
+      checked: value[flag.key],
+      onChange: handleChange(flag.key),
+      disabled: disabled
+    }, /*#__PURE__*/React.createElement("code", {
+      style: {
+        fontSize: '13px',
+        fontWeight: 'bold'
+      }
+    }, flag.label)));
+  }));
+};

package/dist/esm/components/RegexEditor/visualizer/MatchItem.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MatchItem 组件
+ *
+ * @module RegexEditor/visualizer/MatchItem
+ * @description 匹配结果项组件
+ */
+import React from 'react';
+import type { MatchItemProps } from './types';
+/**
+ * 匹配项组件
+ *
+ * @example
+ * ```tsx
+ * <MatchItem
+ *   match={{
+ *     index: 0,
+ *     lastIndex: 3,
+ *     fullMatch: 'abc',
+ *     groups: ['abc', 'ab', 'c'],
+ *   }}
+ *   index={0}
+ * />
+ * ```
+ */
+export declare const MatchItem: React.FC<MatchItemProps>;

package/dist/esm/components/RegexEditor/visualizer/MatchItem.js

@@ -0,0 +1,194 @@
+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; }
+/**
+ * MatchItem 组件
+ *
+ * @module RegexEditor/visualizer/MatchItem
+ * @description 匹配结果项组件
+ */
+
+import React, { useState } from 'react';
+import { Card, Tag, Typography, Collapse, Space } from 'antd';
+import { formatPosition } from "./utils";
+var Text = Typography.Text,
+  Paragraph = Typography.Paragraph;
+var Panel = Collapse.Panel;
+
+/**
+ * 匹配项组件
+ *
+ * @example
+ * ```tsx
+ * <MatchItem
+ *   match={{
+ *     index: 0,
+ *     lastIndex: 3,
+ *     fullMatch: 'abc',
+ *     groups: ['abc', 'ab', 'c'],
+ *   }}
+ *   index={0}
+ * />
+ * ```
+ */
+export var MatchItem = function MatchItem(_ref) {
+  var match = _ref.match,
+    index = _ref.index,
+    _ref$highlighted = _ref.highlighted,
+    highlighted = _ref$highlighted === void 0 ? false : _ref$highlighted,
+    _onClick = _ref.onClick;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isHovered = _useState2[0],
+    setIsHovered = _useState2[1];
+  var hasGroups = match.groups.length > 1;
+  var hasNamedGroups = match.namedGroups && Object.keys(match.namedGroups).length > 0;
+  return /*#__PURE__*/React.createElement(Card, {
+    size: "small",
+    className: "regex-match-item ".concat(highlighted ? 'highlighted' : ''),
+    style: {
+      marginBottom: 8,
+      cursor: _onClick ? 'pointer' : 'default',
+      borderColor: isHovered ? '#1890ff' : undefined,
+      transition: 'border-color 0.3s'
+    },
+    onMouseEnter: function onMouseEnter() {
+      return setIsHovered(true);
+    },
+    onMouseLeave: function onMouseLeave() {
+      return setIsHovered(false);
+    },
+    onClick: function onClick() {
+      return _onClick === null || _onClick === void 0 ? void 0 : _onClick(match, index);
+    }
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      marginBottom: 8
+    }
+  }, /*#__PURE__*/React.createElement(Space, null, /*#__PURE__*/React.createElement(Tag, {
+    color: "blue"
+  }, "\u5339\u914D #", index + 1), /*#__PURE__*/React.createElement(Text, {
+    type: "secondary",
+    style: {
+      fontSize: '12px'
+    }
+  }, "\u4F4D\u7F6E: ", formatPosition(match)))), /*#__PURE__*/React.createElement("div", {
+    style: {
+      marginBottom: hasGroups || hasNamedGroups ? 8 : 0
+    }
+  }, /*#__PURE__*/React.createElement(Text, {
+    strong: true,
+    style: {
+      fontSize: '12px',
+      color: '#666'
+    }
+  }, "\u5B8C\u6574\u5339\u914D:"), /*#__PURE__*/React.createElement(Paragraph, {
+    code: true,
+    copyable: true,
+    style: {
+      margin: '4px 0 0 0',
+      backgroundColor: '#f6f6f6',
+      padding: '4px 8px',
+      borderRadius: '2px'
+    }
+  }, match.fullMatch)), hasGroups && /*#__PURE__*/React.createElement(Collapse, {
+    size: "small",
+    bordered: false,
+    ghost: true
+  }, /*#__PURE__*/React.createElement(Panel, {
+    header: /*#__PURE__*/React.createElement(Text, {
+      strong: true,
+      style: {
+        fontSize: '12px',
+        color: '#666'
+      }
+    }, "\u6355\u83B7\u7EC4 (", match.groups.length - 1, ")"),
+    key: "groups"
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      paddingLeft: 8
+    }
+  }, match.groups.slice(1).map(function (group, i) {
+    return /*#__PURE__*/React.createElement("div", {
+      key: i,
+      style: {
+        marginBottom: 8
+      }
+    }, /*#__PURE__*/React.createElement("div", {
+      style: {
+        marginBottom: 2
+      }
+    }, /*#__PURE__*/React.createElement(Tag, {
+      color: "geekblue",
+      style: {
+        fontSize: '11px'
+      }
+    }, "Group ", i + 1)), /*#__PURE__*/React.createElement(Paragraph, {
+      code: true,
+      copyable: true,
+      style: {
+        margin: 0,
+        backgroundColor: '#f0f5ff',
+        padding: '2px 6px',
+        borderRadius: '2px',
+        fontSize: '12px'
+      }
+    }, group || /*#__PURE__*/React.createElement(Text, {
+      type: "secondary"
+    }, "(empty)")));
+  })))), hasNamedGroups && /*#__PURE__*/React.createElement(Collapse, {
+    size: "small",
+    bordered: false,
+    ghost: true,
+    style: {
+      marginTop: hasGroups ? 8 : 0
+    }
+  }, /*#__PURE__*/React.createElement(Panel, {
+    header: /*#__PURE__*/React.createElement(Text, {
+      strong: true,
+      style: {
+        fontSize: '12px',
+        color: '#666'
+      }
+    }, "\u547D\u540D\u6355\u83B7\u7EC4 (", Object.keys(match.namedGroups).length, ")"),
+    key: "named-groups"
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      paddingLeft: 8
+    }
+  }, Object.entries(match.namedGroups).map(function (_ref2) {
+    var _ref3 = _slicedToArray(_ref2, 2),
+      name = _ref3[0],
+      value = _ref3[1];
+    return /*#__PURE__*/React.createElement("div", {
+      key: name,
+      style: {
+        marginBottom: 8
+      }
+    }, /*#__PURE__*/React.createElement("div", {
+      style: {
+        marginBottom: 2
+      }
+    }, /*#__PURE__*/React.createElement(Tag, {
+      color: "purple",
+      style: {
+        fontSize: '11px'
+      }
+    }, name)), /*#__PURE__*/React.createElement(Paragraph, {
+      code: true,
+      copyable: true,
+      style: {
+        margin: 0,
+        backgroundColor: '#f9f0ff',
+        padding: '2px 6px',
+        borderRadius: '2px',
+        fontSize: '12px'
+      }
+    }, value || /*#__PURE__*/React.createElement(Text, {
+      type: "secondary"
+    }, "(empty)")));
+  })))));
+};

package/dist/esm/components/RegexEditor/visualizer/RegexRailroadDiagram.d.ts

@@ -0,0 +1,32 @@
+/**
+ * RegexRailroadDiagram 组件
+ *
+ * @module RegexEditor/visualizer/RegexRailroadDiagram
+ * @description 使用 Railroad Diagram 可视化正则表达式结构
+ */
+import React from 'react';
+import 'railroad-diagrams/railroad-diagrams.css';
+export interface RegexRailroadDiagramProps {
+    /** 正则表达式模式 */
+    pattern: string;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 卡片大小 */
+    size?: 'small' | 'default';
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * Railroad Diagram 可视化组件
+ *
+ * @example
+ * ```tsx
+ * <RegexRailroadDiagram
+ *   pattern="\d{3}-\d{4}"
+ *   showTitle={true}
+ * />
+ * ```
+ */
+export declare const RegexRailroadDiagram: React.FC<RegexRailroadDiagramProps>;