革命性正则表达式工具 magic-regexp：告别复杂模式，拥抱类型安全

还在为复杂的正则表达式语法而头疼吗？magic-regexp 是一款革命性的正则表达式工具，通过编译时转换和类型安全特性，让正则表达式编写变得简单直观。无论你是正则表达式新手还是资深开发者，这个工具都将彻底改变你的开发体验。

什么是 magic-regexp？

magic-regexp 是一个编译时转换、类型安全且可读性强的正则表达式替代方案。它采用自然语言语法，让你能够用更直观的方式构建复杂的正则模式，同时享受 TypeScript 提供的完整类型支持。

🚀 核心优势

零依赖运行时

magic-regexp 在运行时保持极简，所有复杂逻辑都在编译时处理完毕，确保你的应用性能不受影响。

自动类型捕获组

当你使用 groupedAs 方法创建命名捕获组时，magic-regexp 会自动为你生成类型定义，让你在使用 String.match() 时获得完整的类型提示。

自然语言语法

告别晦涩的正则符号，使用像 exactly('foo').or('bar') 这样直观的表达方式。

📦 快速开始

安装步骤

首先通过 npm 安装 magic-regexp：

npm install magic-regexp

基本用法

import { createRegExp, exactly } from 'magic-regexp'

const regExp = createRegExp(exactly('foo/test.js').after('bar/'))
console.log(regExp) // 输出：/(?<=bar\/)foo\/test\.js/

🔧 实用功能详解

创建输入模式

magic-regexp 提供了一系列辅助函数来构建模式：

• charIn, charNotIn - 匹配或不匹配指定字符
• anyOf - 匹配多个选项中的任意一个
• maybe - 标记模式为可选
• oneOrMore - 标记模式至少出现一次

链式操作

所有辅助函数都返回 Input 类型的对象，支持链式调用：

• and - 添加新模式
• or - 提供替代选项
• after, before - 实现前后查找

类型级匹配结果

通过导入 magic-regexp/further-magic，你可以获得正则表达式匹配结果的类型级信息，这在处理字符串字面量时尤其有用。

💡 实际应用场景

语义化版本匹配

构建语义化版本号的正则表达式变得异常简单：

import { char, createRegExp, digit, maybe, oneOrMore } from 'magic-regexp'

createRegExp(
  oneOrMore(digit).groupedAs('major'),
  '.',
  oneOrMore(digit).groupedAs('minor'),
  maybe('.', oneOrMore(char).groupedAs('patch'))
)

调试与开发

在开发过程中，只需将鼠标悬停在任意函数上，就能看到正在构建的正则表达式模式，大大提升了开发效率。

🎯 为什么选择 magic-regexp？

1. 开发体验提升 - 自然语言语法让正则表达式更易读易写
2. 类型安全保障 - 完整的 TypeScript 支持，减少运行时错误
3. 性能优化 - 编译时转换确保运行时零开销
4. 团队协作友好 - 清晰的代码结构便于团队维护

📚 进阶学习

想要深入了解 magic-regexp 的高级功能？建议查看项目文档中的示例部分，那里有更多实用的代码示例和应用场景。

magic-regexp 正在重新定义我们编写和使用正则表达式的方式。通过将复杂的符号转换为直观的方法调用，它让正则表达式重新变得友好而强大。无论你是要验证邮箱、解析URL还是提取特定格式的数据，magic-regexp 都能让你的开发工作更加高效愉快。