@nokecy/qc-ui 1.0.65 → 1.0.67

package/dist/cjs/components/RegexEditor/core/extensions/errorMarker.js

@@ -0,0 +1,158 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.updateErrorMarkers = exports.setErrorsEffect = exports.errorDecorationsField = exports.createErrorMarkers = void 0;
+var _view = require("@codemirror/view");
+var _state = require("@codemirror/state");
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+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; } /**
+ * CodeMirror 错误标注扩展
+ *
+ * @description
+ * 为 CodeMirror 编辑器添加错误标注功能,支持波浪下划线高亮显示错误位置。
+ *
+ * @module RegexEditor/core/extensions/errorMarker
+ */
+/**
+ * 设置错误的 StateEffect
+ */
+var setErrorsEffect = exports.setErrorsEffect = _state.StateEffect.define();
+
+/**
+ * 错误标注装饰
+ *
+ * @description
+ * 使用红色波浪下划线标注错误位置
+ */
+var errorMark = _view.Decoration.mark({
+  attributes: {
+    class: 'cm-regex-error',
+    style: 'text-decoration: wavy underline red; text-decoration-skip-ink: none;'
+  }
+});
+
+/**
+ * 警告标注装饰
+ *
+ * @description
+ * 使用橙色波浪下划线标注警告位置
+ */
+var warningMark = _view.Decoration.mark({
+  attributes: {
+    class: 'cm-regex-warning',
+    style: 'text-decoration: wavy underline orange; text-decoration-skip-ink: none;'
+  }
+});
+
+/**
+ * 信息标注装饰
+ *
+ * @description
+ * 使用蓝色波浪下划线标注信息位置
+ */
+var infoMark = _view.Decoration.mark({
+  attributes: {
+    class: 'cm-regex-info',
+    style: 'text-decoration: wavy underline blue; text-decoration-skip-ink: none;'
+  }
+});
+
+/**
+ * 错误装饰状态字段
+ *
+ * @description
+ * 管理错误标注的 DecorationSet
+ */
+var errorDecorationsField = exports.errorDecorationsField = _state.StateField.define({
+  create: function create() {
+    return _view.Decoration.none;
+  },
+  update: function update(decorations, tr) {
+    // 遍历事务中的所有 effect
+    var _iterator = _createForOfIteratorHelper(tr.effects),
+      _step;
+    try {
+      var _loop = function _loop() {
+          var effect = _step.value;
+          if (effect.is(setErrorsEffect)) {
+            // 更新错误标注
+            var errors = effect.value;
+            var newDecorations = [];
+            errors.forEach(function (error) {
+              var _error$position = error.position,
+                start = _error$position.start,
+                end = _error$position.end;
+
+              // 确保位置有效
+              if (start >= 0 && end <= tr.newDoc.length && start < end) {
+                // 根据严重程度选择装饰
+                var mark = errorMark;
+                if (error.severity === 'warning') {
+                  mark = warningMark;
+                } else if (error.severity === 'info') {
+                  mark = infoMark;
+                }
+                newDecorations.push(mark.range(start, end));
+              }
+            });
+            return {
+              v: _view.Decoration.set(newDecorations, true)
+            };
+          }
+        },
+        _ret;
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        _ret = _loop();
+        if (_ret) return _ret.v;
+      }
+
+      // 如果文档改变,需要映射装饰位置
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    return decorations.map(tr.changes);
+  },
+  provide: function provide(f) {
+    return _view.EditorView.decorations.from(f);
+  }
+});
+
+/**
+ * 创建错误标注扩展
+ *
+ * @param errors - 错误列表
+ * @returns CodeMirror 扩展数组
+ *
+ * @example
+ * ```typescript
+ * const extensions = [
+ *   javascript(),
+ *   createErrorMarkers(errors)
+ * ];
+ * ```
+ */
+var createErrorMarkers = exports.createErrorMarkers = function createErrorMarkers(errors) {
+  return [errorDecorationsField];
+};
+
+/**
+ * 更新错误标注的辅助函数
+ *
+ * @param view - EditorView 实例
+ * @param errors - 新的错误列表
+ *
+ * @example
+ * ```typescript
+ * updateErrorMarkers(editorView, validationErrors);
+ * ```
+ */
+var updateErrorMarkers = exports.updateErrorMarkers = function updateErrorMarkers(view, errors) {
+  view.dispatch({
+    effects: setErrorsEffect.of(errors)
+  });
+};

package/dist/cjs/components/RegexEditor/core/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 正则表达式编辑器核心组件 - 类型定义
+ *
+ * @module RegexEditor/core/types
+ * @description 定义编辑器核心组件的 Props 和相关类型
+ */
+import type { RegexError, ValidationResult } from '../validation/types';
+/**
+ * CodeMirror 包装器组件属性
+ *
+ * @interface CodeMirrorWrapperProps
+ * @property {string} value - 编辑器内容
+ * @property {(value: string) => void} onChange - 内容变更回调
+ * @property {string} [placeholder] - 占位符文本
+ * @property {boolean} [readOnly] - 是否只读模式
+ * @property {boolean} [disabled] - 是否禁用编辑
+ * @property {RegexError[]} [errors] - 错误列表（用于标注）
+ * @property {string} [height] - 编辑器高度（CSS 值）
+ *
+ * @example
+ * ```tsx
+ * <CodeMirrorWrapper
+ *   value={pattern}
+ *   onChange={setPattern}
+ *   placeholder="请输入正则表达式"
+ *   errors={validationErrors}
+ *   height="120px"
+ * />
+ * ```
+ */
+export interface CodeMirrorWrapperProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    readOnly?: boolean;
+    disabled?: boolean;
+    errors?: RegexError[];
+    height?: string;
+}
+/**
+ * 正则表达式编辑器组件属性
+ *
+ * @interface RegexEditorProps
+ * @property {string} [value] - 正则表达式字符串
+ * @property {(value: string) => void} [onChange] - 值变更回调
+ * @property {string} [placeholder] - 占位符文本
+ * @property {boolean} [readOnly] - 是否只读模式
+ * @property {boolean} [disabled] - 是否禁用编辑
+ * @property {boolean} [showComplexity] - 是否显示复杂度分析
+ * @property {boolean} [showRailroadDiagram] - 是否显示 Railroad Diagram 可视化
+ * @property {(result: ValidationResult) => void} [onValidate] - 验证结果回调
+ * @property {string} [height] - 编辑器高度（CSS 值）
+ *
+ * @example
+ * ```tsx
+ * <RegexEditor
+ *   value={pattern}
+ *   onChange={setPattern}
+ *   showComplexity={true}
+ *   height="200px"
+ *   onValidate={(result) => {
+ *     if (!result.valid) {
+ *       console.error('验证失败:', result.errors);
+ *     }
+ *   }}
+ * />
+ * ```
+ */
+export interface RegexEditorProps {
+    value?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    readOnly?: boolean;
+    disabled?: boolean;
+    showComplexity?: boolean;
+    showRailroadDiagram?: boolean;
+    onValidate?: (result: ValidationResult) => void;
+    height?: string;
+}

package/dist/cjs/components/RegexEditor/core/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/components/RegexEditor/hooks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * React Hooks for RegexEditor
+ *
+ * @module RegexEditor/hooks
+ */
+export { useRegexValidation } from './useRegexValidation';
+export type { UseRegexValidationResult } from './useRegexValidation';
+export { useTemplateManager } from './useTemplateManager';
+export type { UseTemplateManagerOptions, UseTemplateManagerReturn, } from './useTemplateManager';

package/dist/cjs/components/RegexEditor/hooks/index.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "useRegexValidation", {
+  enumerable: true,
+  get: function get() {
+    return _useRegexValidation.useRegexValidation;
+  }
+});
+Object.defineProperty(exports, "useTemplateManager", {
+  enumerable: true,
+  get: function get() {
+    return _useTemplateManager.useTemplateManager;
+  }
+});
+var _useRegexValidation = require("./useRegexValidation");
+var _useTemplateManager = require("./useTemplateManager");

package/dist/cjs/components/RegexEditor/hooks/useRegexTester.d.ts

@@ -0,0 +1,95 @@
+/**
+ * useRegexTester Hook
+ *
+ * @module RegexEditor/hooks/useRegexTester
+ * @description 提供正则测试功能的 React Hook
+ */
+import type { RegexFlags, MatchResult } from '../visualizer/types';
+/**
+ * Hook 配置选项
+ */
+export interface UseRegexTesterOptions {
+    /** 初始测试文本 */
+    initialTestText?: string;
+    /** 初始标志 */
+    initialFlags?: RegexFlags;
+    /** 最大匹配数量 */
+    maxMatches?: number;
+    /** 匹配超时时间 (毫秒) */
+    matchTimeout?: number;
+    /** 匹配结果回调 */
+    onMatchResults?: (results: MatchResult[]) => void;
+    /** 防抖延迟 (毫秒) */
+    debounceDelay?: number;
+}
+/**
+ * Hook 返回值
+ */
+export interface UseRegexTesterResult {
+    /** 测试文本 */
+    testText: string;
+    /** 设置测试文本 */
+    setTestText: (text: string) => void;
+    /** 标志 */
+    flags: RegexFlags;
+    /** 设置标志 */
+    setFlags: (flags: RegexFlags) => void;
+    /** 匹配结果 */
+    matches: MatchResult[];
+    /** 是否正在匹配 */
+    isMatching: boolean;
+    /** 匹配错误 */
+    error: string | null;
+    /** 是否有效的正则表达式 */
+    isValid: boolean;
+    /** 清空测试文本 */
+    clearTestText: () => void;
+    /** 重新匹配 */
+    rematch: () => void;
+}
+/**
+ * 正则测试 Hook
+ *
+ * @param pattern - 正则表达式模式
+ * @param options - 配置选项
+ * @returns Hook 结果
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   testText,
+ *   setTestText,
+ *   flags,
+ *   setFlags,
+ *   matches,
+ *   isValid,
+ * } = useRegexTester(pattern, {
+ *   initialTestText: 'test@example.com',
+ *   initialFlags: { global: true },
+ * });
+ * ```
+ */
+export declare function useRegexTester(pattern: string, options?: UseRegexTesterOptions): UseRegexTesterResult;
+/**
+ * 替换预览 Hook
+ *
+ * @param pattern - 正则表达式模式
+ * @param text - 原始文本
+ * @param replaceText - 替换文本
+ * @param flags - 标志
+ * @returns 替换结果和错误
+ *
+ * @example
+ * ```tsx
+ * const { result, error } = useReplacePreview(
+ *   '(\\d+)',
+ *   'abc 123 def',
+ *   'NUM:$1',
+ *   { global: true }
+ * );
+ * ```
+ */
+export declare function useReplacePreview(pattern: string, text: string, replaceText: string, flags?: RegexFlags): {
+    result: string | null;
+    error: string | null;
+};

package/dist/cjs/components/RegexEditor/hooks/useRegexTester.js

@@ -0,0 +1,234 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useRegexTester = useRegexTester;
+exports.useReplacePreview = useReplacePreview;
+var _react = require("react");
+var _utils = require("../visualizer/utils");
+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; } /**
+ * useRegexTester Hook
+ *
+ * @module RegexEditor/hooks/useRegexTester
+ * @description 提供正则测试功能的 React Hook
+ */
+/**
+ * Hook 配置选项
+ */
+
+/**
+ * Hook 返回值
+ */
+
+/**
+ * 正则测试 Hook
+ *
+ * @param pattern - 正则表达式模式
+ * @param options - 配置选项
+ * @returns Hook 结果
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   testText,
+ *   setTestText,
+ *   flags,
+ *   setFlags,
+ *   matches,
+ *   isValid,
+ * } = useRegexTester(pattern, {
+ *   initialTestText: 'test@example.com',
+ *   initialFlags: { global: true },
+ * });
+ * ```
+ */
+function useRegexTester(pattern) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _options$initialTestT = options.initialTestText,
+    initialTestText = _options$initialTestT === void 0 ? '' : _options$initialTestT,
+    _options$initialFlags = options.initialFlags,
+    initialFlags = _options$initialFlags === void 0 ? {
+      global: true
+    } : _options$initialFlags,
+    _options$maxMatches = options.maxMatches,
+    maxMatches = _options$maxMatches === void 0 ? 1000 : _options$maxMatches,
+    _options$matchTimeout = options.matchTimeout,
+    matchTimeout = _options$matchTimeout === void 0 ? 5000 : _options$matchTimeout,
+    onMatchResults = options.onMatchResults,
+    _options$debounceDela = options.debounceDelay,
+    debounceDelay = _options$debounceDela === void 0 ? 300 : _options$debounceDela;
+
+  // 状态
+  var _useState = (0, _react.useState)(initialTestText),
+    _useState2 = _slicedToArray(_useState, 2),
+    testText = _useState2[0],
+    setTestText = _useState2[1];
+  var _useState3 = (0, _react.useState)(initialFlags),
+    _useState4 = _slicedToArray(_useState3, 2),
+    flags = _useState4[0],
+    setFlags = _useState4[1];
+  var _useState5 = (0, _react.useState)(false),
+    _useState6 = _slicedToArray(_useState5, 2),
+    isMatching = _useState6[0],
+    setIsMatching = _useState6[1];
+  var _useState7 = (0, _react.useState)(null),
+    _useState8 = _slicedToArray(_useState7, 2),
+    error = _useState8[0],
+    setError = _useState8[1];
+  var _useState9 = (0, _react.useState)(pattern),
+    _useState10 = _slicedToArray(_useState9, 2),
+    debouncedPattern = _useState10[0],
+    setDebouncedPattern = _useState10[1];
+  var _useState11 = (0, _react.useState)(testText),
+    _useState12 = _slicedToArray(_useState11, 2),
+    debouncedText = _useState12[0],
+    setDebouncedText = _useState12[1];
+
+  // 防抖: 模式变化
+  (0, _react.useEffect)(function () {
+    var timer = setTimeout(function () {
+      setDebouncedPattern(pattern);
+    }, debounceDelay);
+    return function () {
+      return clearTimeout(timer);
+    };
+  }, [pattern, debounceDelay]);
+
+  // 防抖: 文本变化
+  (0, _react.useEffect)(function () {
+    var timer = setTimeout(function () {
+      setDebouncedText(testText);
+    }, debounceDelay);
+    return function () {
+      return clearTimeout(timer);
+    };
+  }, [testText, debounceDelay]);
+
+  // 检查正则表达式是否有效
+  var isValid = (0, _react.useMemo)(function () {
+    return (0, _utils.isValidRegex)(debouncedPattern, flags);
+  }, [debouncedPattern, flags]);
+
+  // 执行匹配
+  var matches = (0, _react.useMemo)(function () {
+    // 清空错误
+    setError(null);
+
+    // 空模式或空文本
+    if (!debouncedPattern || !debouncedText) {
+      return [];
+    }
+
+    // 无效正则
+    if (!isValid) {
+      setError('无效的正则表达式');
+      return [];
+    }
+    try {
+      setIsMatching(true);
+      var _results = (0, _utils.performMatch)(debouncedPattern, debouncedText, flags, maxMatches, matchTimeout);
+      if (_results === null) {
+        setError('匹配失败或超时');
+        return [];
+      }
+      return _results;
+    } catch (err) {
+      var errorMessage = err instanceof Error ? err.message : '未知错误';
+      setError("\u5339\u914D\u9519\u8BEF: ".concat(errorMessage));
+      return [];
+    } finally {
+      setIsMatching(false);
+    }
+  }, [debouncedPattern, debouncedText, flags, isValid, maxMatches, matchTimeout]);
+
+  // 通知匹配结果
+  (0, _react.useEffect)(function () {
+    if (onMatchResults) {
+      onMatchResults(matches);
+    }
+  }, [matches, onMatchResults]);
+
+  // 清空测试文本
+  var clearTestText = (0, _react.useCallback)(function () {
+    setTestText('');
+  }, []);
+
+  // 重新匹配 (强制刷新)
+  var rematch = (0, _react.useCallback)(function () {
+    setDebouncedPattern(pattern);
+    setDebouncedText(testText);
+  }, [pattern, testText]);
+  return {
+    testText: testText,
+    setTestText: setTestText,
+    flags: flags,
+    setFlags: setFlags,
+    matches: matches,
+    isMatching: isMatching,
+    error: error,
+    isValid: isValid,
+    clearTestText: clearTestText,
+    rematch: rematch
+  };
+}
+
+/**
+ * 替换预览 Hook
+ *
+ * @param pattern - 正则表达式模式
+ * @param text - 原始文本
+ * @param replaceText - 替换文本
+ * @param flags - 标志
+ * @returns 替换结果和错误
+ *
+ * @example
+ * ```tsx
+ * const { result, error } = useReplacePreview(
+ *   '(\\d+)',
+ *   'abc 123 def',
+ *   'NUM:$1',
+ *   { global: true }
+ * );
+ * ```
+ */
+function useReplacePreview(pattern, text, replaceText, flags) {
+  return (0, _react.useMemo)(function () {
+    if (!pattern || !text) {
+      return {
+        result: null,
+        error: null
+      };
+    }
+    if (!(0, _utils.isValidRegex)(pattern, flags)) {
+      return {
+        result: null,
+        error: '无效的正则表达式'
+      };
+    }
+    try {
+      var result = (0, _utils.performReplace)(pattern, text, replaceText, flags);
+      if (result === null) {
+        return {
+          result: null,
+          error: '替换失败'
+        };
+      }
+      return {
+        result: result,
+        error: null
+      };
+    } catch (err) {
+      var errorMessage = err instanceof Error ? err.message : '未知错误';
+      return {
+        result: null,
+        error: "\u66FF\u6362\u9519\u8BEF: ".concat(errorMessage)
+      };
+    }
+  }, [pattern, text, replaceText, flags]);
+}

package/dist/cjs/components/RegexEditor/hooks/useRegexValidation.d.ts

@@ -0,0 +1,71 @@
+/**
+ * useRegexValidation Hook
+ *
+ * @description
+ * React Hook 用于正则表达式验证,集成解析、验证、复杂度分析。
+ * 提供去抖优化和完整的状态管理。
+ *
+ * @example
+ * ```tsx
+ * const { validationResult, complexity, isValidating } = useRegexValidation(pattern);
+ *
+ * if (validationResult?.valid) {
+ *   console.log('验证通过');
+ * } else {
+ *   console.error('错误:', validationResult?.errors);
+ * }
+ *
+ * if (complexity?.backtrackingRisk === 'high') {
+ *   console.warn('高回溯风险:', complexity.suggestions);
+ * }
+ * ```
+ */
+import type { ValidationResult, ComplexityMetrics } from '../validation/types';
+/**
+ * useRegexValidation Hook 返回值
+ */
+export interface UseRegexValidationResult {
+    /** 验证结果 */
+    validationResult: ValidationResult | null;
+    /** 复杂度分析结果 */
+    complexity: ComplexityMetrics | null;
+    /** 是否正在验证 */
+    isValidating: boolean;
+    /** 手动触发验证 */
+    validate: (value: string) => Promise<void>;
+}
+/**
+ * 正则表达式验证 Hook
+ *
+ * @param pattern - 正则表达式字符串
+ * @param options - 配置选项
+ * @param options.debounceMs - 去抖延迟时间（默认 300ms）
+ * @returns {UseRegexValidationResult} 验证结果和方法
+ *
+ * @remarks
+ * 该 Hook 提供以下功能:
+ * - 自动验证: 监听 pattern 变化并自动触发验证
+ * - 去抖优化: 300ms 防抖延迟,避免频繁验证
+ * - 完整状态: validationResult, complexity, isValidating
+ * - 手动验证: 提供 validate 方法支持手动触发
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const [pattern, setPattern] = useState('');
+ *   const { validationResult, complexity, isValidating } = useRegexValidation(pattern);
+ *
+ *   return (
+ *     <div>
+ *       <input value={pattern} onChange={e => setPattern(e.target.value)} />
+ *       {isValidating && <Spin />}
+ *       {validationResult?.errors.map(err => <Alert key={err.type} message={err.message} />)}
+ *       {complexity && <Badge>性能评分: {complexity.performanceScore}</Badge>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useRegexValidation: (pattern: string, options?: {
+    debounceMs?: number | undefined;
+}) => UseRegexValidationResult;