@nokecy/qc-ui 1.0.66 → 1.0.67

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

@@ -0,0 +1,17 @@
+/**
+ * RegexEditor Visualizer - 导出索引
+ *
+ * @module RegexEditor/visualizer
+ * @description 可视化组件导出
+ */
+
+// 组件导出
+export { RegexTester } from "./RegexTester";
+export { FlagsSelector } from "./FlagsSelector";
+export { MatchItem } from "./MatchItem";
+export { RegexRailroadDiagram } from "./RegexRailroadDiagram";
+
+// 类型导出
+
+// 工具函数导出
+export { flagsToString, stringToFlags, performMatch, performReplace, highlightMatches, formatPosition, isValidRegex } from "./utils";

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

@@ -0,0 +1,131 @@
+/**
+ * 正则表达式可视化 - 类型定义
+ *
+ * @module RegexEditor/visualizer/types
+ * @description 定义可视化组件的类型和接口
+ */
+/// <reference types="react" />
+/**
+ * 正则表达式标志
+ */
+export interface RegexFlags {
+    /** 全局匹配 */
+    global?: boolean;
+    /** 忽略大小写 */
+    ignoreCase?: boolean;
+    /** 多行模式 */
+    multiline?: boolean;
+    /** dotAll 模式 (. 匹配换行符) */
+    dotAll?: boolean;
+    /** Unicode 模式 */
+    unicode?: boolean;
+    /** 粘性匹配 */
+    sticky?: boolean;
+}
+/**
+ * 匹配结果
+ */
+export interface MatchResult {
+    /** 匹配的索引位置 */
+    index: number;
+    /** 匹配结束位置 */
+    lastIndex: number;
+    /** 完整匹配的文本 */
+    fullMatch: string;
+    /** 捕获组数组 (索引 0 是完整匹配) */
+    groups: string[];
+    /** 命名捕获组 */
+    namedGroups?: Record<string, string>;
+}
+/**
+ * RegexTester 组件属性
+ */
+export interface RegexTesterProps {
+    /** 正则表达式模式 */
+    pattern: string;
+    /** 正则表达式标志 */
+    flags?: RegexFlags;
+    /** 测试文本 */
+    testText?: string;
+    /** 测试文本变化回调 */
+    onTestTextChange?: (text: string) => void;
+    /** 标志变化回调 */
+    onFlagsChange?: (flags: RegexFlags) => void;
+    /** 匹配结果回调 */
+    onMatchResults?: (results: MatchResult[]) => void;
+    /** 是否启用替换功能 */
+    enableReplace?: boolean;
+    /** 最大匹配数量限制 */
+    maxMatches?: number;
+    /** 匹配超时时间 (毫秒) */
+    matchTimeout?: number;
+    /** 是否只读 */
+    readOnly?: boolean;
+}
+/**
+ * RegexVisualizer 主容器组件属性
+ */
+export interface RegexVisualizerProps {
+    /** 正则表达式模式 */
+    pattern: string;
+    /** 是否显示 AST 可视化 */
+    showAST?: boolean;
+    /** 是否显示 Railroad 图 */
+    showRailroad?: boolean;
+    /** 其他 RegexTester 属性 */
+    testerProps?: Omit<RegexTesterProps, 'pattern'>;
+}
+/**
+ * FlagsSelector 组件属性
+ */
+export interface FlagsSelectorProps {
+    /** 当前标志值 */
+    value?: RegexFlags;
+    /** 标志变化回调 */
+    onChange?: (flags: RegexFlags) => void;
+    /** 是否禁用 */
+    disabled?: boolean;
+}
+/**
+ * MatchItem 组件属性
+ */
+export interface MatchItemProps {
+    /** 匹配结果 */
+    match: MatchResult;
+    /** 匹配项索引 */
+    index: number;
+    /** 是否高亮显示 */
+    highlighted?: boolean;
+    /** 点击回调 */
+    onClick?: (match: MatchResult, index: number) => void;
+}
+/**
+ * ReplacePreview 组件属性
+ */
+export interface ReplacePreviewProps {
+    /** 原始文本 */
+    originalText: string;
+    /** 正则表达式模式 */
+    pattern: string;
+    /** 标志 */
+    flags?: RegexFlags;
+    /** 替换文本 (支持 $1, $2 等) */
+    replaceText: string;
+    /** 替换文本变化回调 */
+    onReplaceTextChange?: (text: string) => void;
+}
+/**
+ * RegexRailroadDiagram 组件属性
+ */
+export interface RegexRailroadDiagramProps {
+    /** 正则表达式模式 */
+    pattern: string;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 卡片大小 */
+    size?: 'small' | 'default';
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 自定义类名 */
+    className?: string;
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,106 @@
+/**
+ * 正则表达式可视化 - 工具函数
+ *
+ * @module RegexEditor/visualizer/utils
+ * @description 提供匹配、标志转换等工具函数
+ */
+import type { RegexFlags, MatchResult } from './types';
+/**
+ * 将标志对象转换为标志字符串
+ *
+ * @param flags - 标志对象
+ * @returns 标志字符串 (如 "gim")
+ *
+ * @example
+ * ```ts
+ * flagsToString({ global: true, ignoreCase: true })
+ * // => "gi"
+ * ```
+ */
+export declare function flagsToString(flags?: RegexFlags): string;
+/**
+ * 将标志字符串转换为标志对象
+ *
+ * @param flagsStr - 标志字符串 (如 "gim")
+ * @returns 标志对象
+ *
+ * @example
+ * ```ts
+ * stringToFlags("gi")
+ * // => { global: true, ignoreCase: true }
+ * ```
+ */
+export declare function stringToFlags(flagsStr: string): RegexFlags;
+/**
+ * 执行正则匹配并返回所有匹配结果
+ *
+ * @param pattern - 正则表达式模式
+ * @param text - 测试文本
+ * @param flags - 标志
+ * @param maxMatches - 最大匹配数量限制
+ * @param timeout - 超时时间 (毫秒)
+ * @returns 匹配结果数组,如果出错返回 null
+ *
+ * @example
+ * ```ts
+ * const results = performMatch('\\d+', 'abc 123 def 456', { global: true });
+ * // => [
+ * //   { index: 4, lastIndex: 7, fullMatch: '123', groups: ['123'] },
+ * //   { index: 12, lastIndex: 15, fullMatch: '456', groups: ['456'] }
+ * // ]
+ * ```
+ */
+export declare function performMatch(pattern: string, text: string, flags?: RegexFlags, maxMatches?: number, timeout?: number): MatchResult[] | null;
+/**
+ * 执行正则替换并返回结果
+ *
+ * @param pattern - 正则表达式模式
+ * @param text - 原始文本
+ * @param replaceText - 替换文本 (支持 $1, $2 等)
+ * @param flags - 标志
+ * @returns 替换后的文本,如果出错返回 null
+ *
+ * @example
+ * ```ts
+ * performReplace('(\\d+)', 'abc 123 def', 'NUM:$1', { global: true })
+ * // => "abc NUM:123 def"
+ * ```
+ */
+export declare function performReplace(pattern: string, text: string, replaceText: string, flags?: RegexFlags): string | null;
+/**
+ * 高亮文本中的匹配部分
+ *
+ * @param text - 原始文本
+ * @param matches - 匹配结果数组
+ * @returns 带高亮标记的 HTML 字符串
+ *
+ * @example
+ * ```ts
+ * highlightMatches('abc 123 def', [
+ *   { index: 4, lastIndex: 7, fullMatch: '123', groups: ['123'] }
+ * ])
+ * // => 'abc <mark class="regex-match">123</mark> def'
+ * ```
+ */
+export declare function highlightMatches(text: string, matches: MatchResult[]): string;
+/**
+ * 格式化匹配位置
+ *
+ * @param match - 匹配结果
+ * @returns 格式化的位置字符串
+ *
+ * @example
+ * ```ts
+ * formatPosition({ index: 10, lastIndex: 15, ... })
+ * // => "10-15"
+ * ```
+ */
+export declare function formatPosition(match: MatchResult): string;
+/**
+ * 检查正则表达式是否有效
+ *
+ * @param pattern - 正则表达式模式
+ * @param flags - 标志
+ * @returns 是否有效
+ */
+export declare function isValidRegex(pattern: string, flags?: RegexFlags): boolean;

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

@@ -0,0 +1,256 @@
+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; }
+/**
+ * 正则表达式可视化 - 工具函数
+ *
+ * @module RegexEditor/visualizer/utils
+ * @description 提供匹配、标志转换等工具函数
+ */
+
+/**
+ * 将标志对象转换为标志字符串
+ *
+ * @param flags - 标志对象
+ * @returns 标志字符串 (如 "gim")
+ *
+ * @example
+ * ```ts
+ * flagsToString({ global: true, ignoreCase: true })
+ * // => "gi"
+ * ```
+ */
+export function flagsToString(flags) {
+  if (!flags) return '';
+  var result = '';
+  if (flags.global) result += 'g';
+  if (flags.ignoreCase) result += 'i';
+  if (flags.multiline) result += 'm';
+  if (flags.dotAll) result += 's';
+  if (flags.unicode) result += 'u';
+  if (flags.sticky) result += 'y';
+  return result;
+}
+
+/**
+ * 将标志字符串转换为标志对象
+ *
+ * @param flagsStr - 标志字符串 (如 "gim")
+ * @returns 标志对象
+ *
+ * @example
+ * ```ts
+ * stringToFlags("gi")
+ * // => { global: true, ignoreCase: true }
+ * ```
+ */
+export function stringToFlags(flagsStr) {
+  return {
+    global: flagsStr.includes('g'),
+    ignoreCase: flagsStr.includes('i'),
+    multiline: flagsStr.includes('m'),
+    dotAll: flagsStr.includes('s'),
+    unicode: flagsStr.includes('u'),
+    sticky: flagsStr.includes('y')
+  };
+}
+
+/**
+ * 执行正则匹配并返回所有匹配结果
+ *
+ * @param pattern - 正则表达式模式
+ * @param text - 测试文本
+ * @param flags - 标志
+ * @param maxMatches - 最大匹配数量限制
+ * @param timeout - 超时时间 (毫秒)
+ * @returns 匹配结果数组,如果出错返回 null
+ *
+ * @example
+ * ```ts
+ * const results = performMatch('\\d+', 'abc 123 def 456', { global: true });
+ * // => [
+ * //   { index: 4, lastIndex: 7, fullMatch: '123', groups: ['123'] },
+ * //   { index: 12, lastIndex: 15, fullMatch: '456', groups: ['456'] }
+ * // ]
+ * ```
+ */
+export function performMatch(pattern, text, flags) {
+  var maxMatches = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 1000;
+  var timeout = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : 5000;
+  try {
+    // 创建正则表达式
+    var flagsStr = flagsToString(flags);
+    var regex = new RegExp(pattern, flagsStr);
+    var results = [];
+    var startTime = Date.now();
+
+    // 如果是全局匹配,使用 exec 循环
+    if (flags !== null && flags !== void 0 && flags.global) {
+      var match;
+      while ((match = regex.exec(text)) !== null) {
+        // 检查超时
+        if (Date.now() - startTime > timeout) {
+          console.warn('正则匹配超时');
+          break;
+        }
+
+        // 检查数量限制
+        if (results.length >= maxMatches) {
+          console.warn("\u5339\u914D\u6570\u91CF\u8D85\u8FC7\u9650\u5236 (".concat(maxMatches, ")"));
+          break;
+        }
+        if (match.index !== undefined) {
+          results.push({
+            index: match.index,
+            lastIndex: match.index + match[0].length,
+            fullMatch: match[0],
+            groups: Array.from(match),
+            namedGroups: match.groups
+          });
+        }
+
+        // 防止无限循环(零宽匹配)
+        if (match.index === regex.lastIndex) {
+          regex.lastIndex++;
+        }
+      }
+    } else {
+      // 非全局匹配,只匹配一次
+      var _match = regex.exec(text);
+      if (_match && _match.index !== undefined) {
+        results.push({
+          index: _match.index,
+          lastIndex: _match.index + _match[0].length,
+          fullMatch: _match[0],
+          groups: Array.from(_match),
+          namedGroups: _match.groups
+        });
+      }
+    }
+    return results;
+  } catch (error) {
+    console.error('正则匹配错误:', error);
+    return null;
+  }
+}
+
+/**
+ * 执行正则替换并返回结果
+ *
+ * @param pattern - 正则表达式模式
+ * @param text - 原始文本
+ * @param replaceText - 替换文本 (支持 $1, $2 等)
+ * @param flags - 标志
+ * @returns 替换后的文本,如果出错返回 null
+ *
+ * @example
+ * ```ts
+ * performReplace('(\\d+)', 'abc 123 def', 'NUM:$1', { global: true })
+ * // => "abc NUM:123 def"
+ * ```
+ */
+export function performReplace(pattern, text, replaceText, flags) {
+  try {
+    var flagsStr = flagsToString(flags);
+    var regex = new RegExp(pattern, flagsStr);
+    return text.replace(regex, replaceText);
+  } catch (error) {
+    console.error('正则替换错误:', error);
+    return null;
+  }
+}
+
+/**
+ * 高亮文本中的匹配部分
+ *
+ * @param text - 原始文本
+ * @param matches - 匹配结果数组
+ * @returns 带高亮标记的 HTML 字符串
+ *
+ * @example
+ * ```ts
+ * highlightMatches('abc 123 def', [
+ *   { index: 4, lastIndex: 7, fullMatch: '123', groups: ['123'] }
+ * ])
+ * // => 'abc <mark class="regex-match">123</mark> def'
+ * ```
+ */
+export function highlightMatches(text, matches) {
+  if (!matches || matches.length === 0) {
+    return escapeHtml(text);
+  }
+
+  // 按索引排序
+  var sortedMatches = _toConsumableArray(matches).sort(function (a, b) {
+    return a.index - b.index;
+  });
+  var result = '';
+  var lastIndex = 0;
+  sortedMatches.forEach(function (match, idx) {
+    // 添加未匹配部分
+    if (match.index > lastIndex) {
+      result += escapeHtml(text.substring(lastIndex, match.index));
+    }
+
+    // 添加匹配部分 (带高亮)
+    result += "<mark class=\"regex-match\" data-match-index=\"".concat(idx, "\">").concat(escapeHtml(match.fullMatch), "</mark>");
+    lastIndex = match.lastIndex;
+  });
+
+  // 添加剩余部分
+  if (lastIndex < text.length) {
+    result += escapeHtml(text.substring(lastIndex));
+  }
+  return result;
+}
+
+/**
+ * 转义 HTML 特殊字符
+ */
+function escapeHtml(text) {
+  var map = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#039;'
+  };
+  return text.replace(/[&<>"']/g, function (char) {
+    return map[char];
+  });
+}
+
+/**
+ * 格式化匹配位置
+ *
+ * @param match - 匹配结果
+ * @returns 格式化的位置字符串
+ *
+ * @example
+ * ```ts
+ * formatPosition({ index: 10, lastIndex: 15, ... })
+ * // => "10-15"
+ * ```
+ */
+export function formatPosition(match) {
+  return "".concat(match.index, "-").concat(match.lastIndex);
+}
+
+/**
+ * 检查正则表达式是否有效
+ *
+ * @param pattern - 正则表达式模式
+ * @param flags - 标志
+ * @returns 是否有效
+ */
+export function isValidRegex(pattern, flags) {
+  try {
+    new RegExp(pattern, flagsToString(flags));
+    return true;
+  } catch (_unused) {
+    return false;
+  }
+}

package/dist/esm/index.d.ts

@@ -19,10 +19,12 @@ import { GeneratedListPage } from "./generatedListPage";
 import { StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField } from "./standardFormDialog";
 import DeleteConfirm from "./deleteConfirm";
 import { RuleBuilder } from "./RuleBuilder";
-export { AgGridColumn, AgGridPlus, ArrayTable, ArrayTableIndex, Card, Dashboard, DialogSelect, DraggableModal, Editable, ExtensibleGrid, flattenTreeDeep, FormDesigner, FormProContext, FormProLayout, GridPlusContext, ImportModal, QueryBuilder, ToolBar, FullScreenAlert, ConfirmPro, GeneratedListPage, StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField, DeleteConfirm, RuleBuilder };
+import { RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram } from "./components/RegexEditor";
+export { AgGridColumn, AgGridPlus, ArrayTable, ArrayTableIndex, Card, Dashboard, DialogSelect, DraggableModal, Editable, ExtensibleGrid, flattenTreeDeep, FormDesigner, FormProContext, FormProLayout, GridPlusContext, ImportModal, QueryBuilder, ToolBar, FullScreenAlert, ConfirmPro, GeneratedListPage, StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField, DeleteConfirm, RuleBuilder, RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram, };
 export type * from "./generatedListPage";
 export type * from "./standardFormDialog";
 export type * from "./deleteConfirm";
 export type * from "./importModal";
 export type * from "./fullScreenAlert";
 export type * from "./RuleBuilder";
+export type { ParseResult as RegexParseResult, ValidationResult as RegexValidationResult, RegexError, ComplexityMetrics, ASTNode, AstRegExp, RegexTemplate, TestResult as RegexTestResult, CodeMirrorWrapperProps, RegexEditorProps, RegexFlags, MatchResult, RegexTesterProps, FlagsSelectorProps, MatchItemProps, RegexRailroadDiagramProps, } from "./components/RegexEditor";

package/dist/esm/index.js

@@ -19,6 +19,9 @@ import { GeneratedListPage } from "./generatedListPage";
 import { StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField } from "./standardFormDialog";
 import DeleteConfirm from "./deleteConfirm";
 import { RuleBuilder } from "./RuleBuilder";
-export { AgGridColumn, AgGridPlus, ArrayTable, ArrayTableIndex, Card, Dashboard, DialogSelect, DraggableModal, Editable, ExtensibleGrid, flattenTreeDeep, FormDesigner, FormProContext, FormProLayout, GridPlusContext, ImportModal, QueryBuilder, ToolBar, FullScreenAlert, ConfirmPro, GeneratedListPage, StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField, DeleteConfirm, RuleBuilder };
+import { RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram } from "./components/RegexEditor";
+export { AgGridColumn, AgGridPlus, ArrayTable, ArrayTableIndex, Card, Dashboard, DialogSelect, DraggableModal, Editable, ExtensibleGrid, flattenTreeDeep, FormDesigner, FormProContext, FormProLayout, GridPlusContext, ImportModal, QueryBuilder, ToolBar, FullScreenAlert, ConfirmPro, GeneratedListPage, StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField, DeleteConfirm, RuleBuilder, RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram };
 
-// 导出类型定义
+// 导出类型定义
+
+// RegexEditor 类型定义 - 使用命名导出避免冲突

package/dist/esm/types/railroad-diagrams.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Type definitions for railroad-diagrams
+ * Project: https://github.com/tabatkins/railroad-diagrams
+ */
+
+declare module 'railroad-diagrams' {
+  export class Diagram {
+    constructor(children: DiagramNode[]);
+    toSVG(): SVGElement;
+    toString(): string;
+  }
+
+  export class ComplexDiagram extends Diagram {}
+
+  export class Sequence {
+    constructor(children: DiagramNode[]);
+  }
+
+  export class Choice {
+    constructor(defaultIndex: number, children: DiagramNode[]);
+  }
+
+  export class Optional {
+    constructor(child: DiagramNode, skip?: 'skip');
+  }
+
+  export class OneOrMore {
+    constructor(child: DiagramNode, repeat?: DiagramNode);
+  }
+
+  export class ZeroOrMore {
+    constructor(child: DiagramNode, repeat?: DiagramNode, skip?: 'skip');
+  }
+
+  export class Terminal {
+    constructor(text: string);
+  }
+
+  export class NonTerminal {
+    constructor(text: string);
+  }
+
+  export class Comment {
+    constructor(text: string);
+  }
+
+  export class Skip {}
+
+  export type DiagramNode =
+    | Sequence
+    | Choice
+    | Optional
+    | OneOrMore
+    | ZeroOrMore
+    | Terminal
+    | NonTerminal
+    | Comment
+    | Skip;
+}