schema-dsl 1.0.9 → 1.1.1

package/docs/dsl-syntax.md

@@ -649,5 +649,5 @@ dsl.match('vipLevel', { gold: 'number:0-50', silver: 'number:0-20' })
 ---
 
 **最后更新**: 2025-12-29  
-**作者**: SchemaIO Team
+**作者**: SchemaI-DSL Team
 

package/docs/dynamic-locale.md

@@ -18,7 +18,7 @@
 
 ## 基本原理
 
-SchemaIO 的 `Validator` 支持在验证时动态指定语言，无需全局切换。
+SchemaI-DSL 的 `Validator` 支持在验证时动态指定语言，无需全局切换。
 
 ### 核心方法
 
@@ -593,6 +593,6 @@ const schema = dsl({
 ---
 
 **最后更新**: 2025-12-25  
-**作者**: SchemaIO Team
+**作者**: SchemaI-DSL Team
 
 

package/docs/error-handling.md

@@ -23,7 +23,7 @@
 
 ### 基础结构
 
-SchemaIO 验证返回的错误对象结构：
+SchemaI-DSL 验证返回的错误对象结构：
 
 ```javascript
 const { dsl, validate } = require('schema-dsl');
@@ -165,7 +165,7 @@ Locale.setMessages({
 
 ### 内置错误码（简化版）
 
-SchemaIO 对 ajv 的错误关键字进行了简化映射，使其更易用：
+SchemaI-DSL 对 ajv 的错误关键字进行了简化映射，使其更易用：
 
 #### 字符串错误码
 

package/docs/export-guide.md

@@ -3,7 +3,7 @@
 > **用途**: Schema 到数据库 DDL 的完整导出指南  
 > **阅读时间**: 10分钟
 
-> ⚠️ **重要提示**: 并非所有 SchemaIO 特性都能导出到数据库。请先阅读 [导出限制说明](export-limitations.md) 了解哪些特性不支持导出。
+> ⚠️ **重要提示**: 并非所有 SchemaI-DSL 特性都能导出到数据库。请先阅读 [导出限制说明](export-limitations.md) 了解哪些特性不支持导出。
 
 ---
 
@@ -21,7 +21,7 @@
 
 ## 概述
 
-SchemaIO 支持将 JSON Schema 导出为多种数据库的 DDL 语句，实现"一次定义，多处使用"。
+SchemaI-DSL 支持将 JSON Schema 导出为多种数据库的 DDL 语句，实现"一次定义，多处使用"。
 
 ### 支持的数据库
 

package/docs/export-limitations.md

@@ -49,7 +49,7 @@ const schema = dsl({
 
 **替代方案**:
 - 导出为最宽松的类型（`VARCHAR(255)`）
-- 验证逻辑保留在应用层（使用 SchemaIO 验证器）
+- 验证逻辑保留在应用层（使用 SchemaI-DSL 验证器）
 
 ---
 
@@ -331,7 +331,7 @@ const schema = dsl('string!')
 
 ```
 ┌─────────────────────────────────────────┐
-│  应用层（SchemaIO 完整验证）             │
+│  应用层（SchemaI-DSL 完整验证）             │
 │  - 条件逻辑（match/if）                 │
 │  - 自定义验证器                         │
 │  - 复杂约束（正则、范围等）              │
@@ -449,7 +449,7 @@ module.exports = {
 ```markdown
 ## 数据验证说明
 
-### 应用层验证（SchemaIO）
+### 应用层验证（SchemaI-DSL）
 - ✅ `contact` 字段根据 `contactType` 动态验证
 - ✅ 用户名正则验证（`^[a-zA-Z0-9_]+$`）
 - ✅ 自定义业务规则验证

package/docs/faq.md

@@ -20,12 +20,12 @@
 
 ## 基础问题
 
-### Q: SchemaIO 和 Joi、Yup 有什么区别？
+### Q: SchemaI-DSL 和 Joi、Yup 有什么区别？
 
-**A**: SchemaIO 采用 DSL 语法，更简洁：
+**A**: SchemaI-DSL 采用 DSL 语法，更简洁：
 
 ```javascript
-// SchemaIO - 简洁
+// SchemaI-DSL - 简洁
 const schema = dsl({
   username: 'string:3-32!',
   email: 'email!'
@@ -46,7 +46,7 @@ const schema = Joi.object({
 
 ---
 
-### Q: 如何安装 SchemaIO？
+### Q: 如何安装 SchemaI-DSL？
 
 ```bash
 npm install schema-dsl
@@ -299,7 +299,7 @@ app.post('/api/users', (req, res) => {
 
 ### Q: 缓存如何工作？
 
-**A**: SchemaIO 内置 LRU 缓存：
+**A**: SchemaI-DSL 内置 LRU 缓存：
 
 ```javascript
 const validator = new Validator({
@@ -523,7 +523,7 @@ MySQL 会生成 `COMMENT`，PostgreSQL 会生成 `COMMENT ON COLUMN`。
 
 ## TypeScript 支持
 
-### Q: SchemaIO 支持 TypeScript 吗？
+### Q: SchemaI-DSL 支持 TypeScript 吗？
 
 **A**: 支持，类型定义在 `index.d.ts`：
 

package/docs/frontend-i18n-guide.md

@@ -250,7 +250,7 @@ Locale.addLocale('de-DE', {
 **A**: 后端返回错误消息已经是本地化的，前端无需处理。如果需要前端验证：
 
 ```javascript
-// 前端可以使用相同的 SchemaIO（浏览器版）
+// 前端可以使用相同的 SchemaI-DSL（浏览器版）
 import { dsl, validate } from 'schema-dsl/browser';
 
 const schema = dsl({ /* ... */ });

package/docs/mongodb-exporter.md

@@ -19,7 +19,7 @@
 
 ## 概述
 
-`MongoDBExporter` 将 SchemaIO 生成的 JSON Schema 转换为 MongoDB 的 `$jsonSchema` 验证格式，可直接用于创建集合时的文档验证。
+`MongoDBExporter` 将 SchemaI-DSL 生成的 JSON Schema 转换为 MongoDB 的 `$jsonSchema` 验证格式，可直接用于创建集合时的文档验证。
 
 ### 核心功能
 
@@ -104,7 +104,7 @@ const mongoSchema = exporter.export(jsonSchema);
 ```
 
 **参数**：
-- `jsonSchema` (Object): SchemaIO 生成的 JSON Schema 对象
+- `jsonSchema` (Object): SchemaI-DSL 生成的 JSON Schema 对象
 
 **返回值**：
 - `Object`: 包含 `$jsonSchema` 的 MongoDB 验证对象
@@ -272,7 +272,7 @@ async function createValidatedCollection() {
 
 ## 导出限制
 
-⚠️ **重要提示**: 并非所有 SchemaIO 特性都能导出到数据库 Schema。
+⚠️ **重要提示**: 并非所有 SchemaI-DSL 特性都能导出到数据库 Schema。
 
 **不支持导出的特性**:
 - ❌ 条件验证逻辑（`dsl.match()`, `dsl.if()`）

package/docs/multi-type-support.md

@@ -1,8 +1,17 @@
 # 多类型支持设计说明
 
+---
+
+## 📖 快速导航
+
+- **单一类型验证**（本文档）
+- **[联合类型验证](./union-type-guide.md)** - 一个字段支持多种类型（使用 `.pattern()` 正则匹配）
+
+---
+
 ## 🎯 设计原理
 
-SchemaIO通过**类型无关的Builder模式**实现多类型支持。
+schema-dsl通过**类型无关的Builder模式**实现多类型支持。
 
 ### 核心设计
 
@@ -21,6 +30,7 @@ class DslBuilder {
 
 ---
 
+
 ## 📊 类型支持矩阵
 
 | DSL字符串 | 解析类型 | 支持的方法 |
@@ -307,7 +317,7 @@ amount: 'number:0-10000'
 
 ## 💡 总结
 
-SchemaIO的多类型支持采用**类型无关Builder + 方法智能适配**设计：
+SchemaI-DSL的多类型支持采用**类型无关Builder + 方法智能适配**设计：
 
 1. **统一入口**: 所有类型都通过DslBuilder
 2. **类型感知**: 方法内部检查类型兼容性

package/docs/mysql-exporter.md

@@ -19,7 +19,7 @@
 
 ## 概述
 
-`MySQLExporter` 将 SchemaIO 生成的 JSON Schema 转换为 MySQL 的 DDL 语句，包括 `CREATE TABLE` 和索引创建语句。
+`MySQLExporter` 将 SchemaI-DSL 生成的 JSON Schema 转换为 MySQL 的 DDL 语句，包括 `CREATE TABLE` 和索引创建语句。
 
 ### 核心功能
 

package/docs/plugin-system.md

@@ -20,7 +20,7 @@
 
 ## 概述
 
-SchemaIO 插件系统允许你扩展核心功能，添加自定义验证器、格式化器、导出器等。
+SchemaI-DSL 插件系统允许你扩展核心功能，添加自定义验证器、格式化器、导出器等。
 
 ### 特性
 
@@ -342,7 +342,7 @@ pluginManager.register({
 安装插件。
 
 **参数**:
-- `schema-dsl` (Object) - SchemaIO 实例
+- `schema-dsl` (Object) - SchemaI-DSL 实例
 - `pluginName` (String, optional) - 插件名称
 - `options` (Object, optional) - 安装选项
 
@@ -354,7 +354,7 @@ pluginManager.register({
 
 **参数**:
 - `pluginName` (String) - 插件名称
-- `schema-dsl` (Object) - SchemaIO 实例
+- `schema-dsl` (Object) - SchemaI-DSL 实例
 
 **返回**: `this`
 
@@ -398,7 +398,7 @@ pluginManager.register({
 清空所有插件。
 
 **参数**:
-- `schema-dsl` (Object) - SchemaIO 实例
+- `schema-dsl` (Object) - SchemaI-DSL 实例
 
 **返回**: `this`
 

package/docs/postgresql-exporter.md

@@ -20,7 +20,7 @@
 
 ## 概述
 
-`PostgreSQLExporter` 将 SchemaIO 生成的 JSON Schema 转换为 PostgreSQL 的 DDL 语句，支持丰富的 PostgreSQL 特性。
+`PostgreSQLExporter` 将 SchemaI-DSL 生成的 JSON Schema 转换为 PostgreSQL 的 DDL 语句，支持丰富的 PostgreSQL 特性。
 
 ### 核心功能
 

package/docs/quick-start.md

@@ -413,13 +413,13 @@ uninstallStringExtensions();
 
 ### Q: 支持TypeScript吗？
 
-**A**: 支持！SchemaIO提供完整的TypeScript类型定义。
+**A**: 支持！SchemaI-DSL提供完整的TypeScript类型定义。
 
 ---
 
 ## 🎉 恭喜！
 
-你已经掌握了SchemaIO的核心用法！
+你已经掌握了SchemaI-DSL的核心用法！
 
 **核心要点**:
 1. ✅ DSL语法简洁直观
@@ -737,13 +737,13 @@ uninstallStringExtensions();
 
 ### Q: 支持TypeScript吗？
 
-**A**: 支持！SchemaIO提供完整的TypeScript类型定义。
+**A**: 支持！SchemaI-DSL提供完整的TypeScript类型定义。
 
 ---
 
 ## 🎉 恭喜！
 
-你已经掌握了SchemaIO的核心用法！
+你已经掌握了SchemaI-DSL的核心用法！
 
 **核心要点**:
 1. ✅ DSL语法简洁直观

package/docs/troubleshooting.md

@@ -1,6 +1,6 @@
 # 常见问题排查指南
 
-> **用途**: 快速解决 SchemaIO 使用中的常见问题  
+> **用途**: 快速解决 SchemaI-DSL 使用中的常见问题  
 > **更新**: 2025-12-26  
 
 ---
@@ -378,7 +378,7 @@ db.createCollection('users', {
 
 **解决方案**:
 ```javascript
-// SchemaIO 默认会自动安装 String 扩展
+// SchemaI-DSL 默认会自动安装 String 扩展
 // 如果未生效，手动安装：
 const { installStringExtensions } = require('schema-dsl');
 installStringExtensions();

package/docs/type-reference.md

@@ -8,7 +8,7 @@
 
 ### 基本类型
 
-| 类型 | SchemaIO | JSON Schema | 说明 |
+| 类型 | SchemaI-DSL | JSON Schema | 说明 |
 |------|----------|-------------|------|
 | 字符串 | `string` | `{ type: 'string' }` | 文本类型 |
 | 数字 | `number` | `{ type: 'number' }` | 浮点数 |
@@ -23,7 +23,7 @@
 
 ### 格式类型（基于 string）
 
-| 类型 | SchemaIO | JSON Schema format | 说明 |
+| 类型 | SchemaI-DSL | JSON Schema format | 说明 |
 |------|----------|-------------------|------|
 | 邮箱 | `email` | `email` | 邮箱地址 |
 | URL | `url` | `uri` | 网址 |
@@ -38,7 +38,7 @@
 
 ### 特殊类型
 
-| 类型 | SchemaIO | JSON Schema | 说明 |
+| 类型 | SchemaI-DSL | JSON Schema | 说明 |
 |------|----------|-------------|------|
 | 二进制 | `binary` | `contentEncoding: base64` | Base64编码 |
 | ObjectId | `objectId` | `pattern: ^[0-9a-fA-F]{24}$` | MongoDB ObjectId |
@@ -156,7 +156,7 @@ const schema = dsl({
 
 ### 完整对照表
 
-| joi | SchemaIO DSL | 说明 |
+| joi | SchemaI-DSL | 说明 |
 |-----|--------------|------|
 | `Joi.string()` | `'string'` | 字符串 |
 | `Joi.string().email()` | `'email'` | 邮箱 |
@@ -206,7 +206,7 @@ const schema = dsl({
 
 ### Q2: 为什么 `integer` 不是 `number().integer()`？
 
-A: SchemaIO 使用 JSON Schema 标准，`integer` 是独立类型。
+A: SchemaI-DSL 使用 JSON Schema 标准，`integer` 是独立类型。
 
 ### Q3: 不支持简写吗？
 

package/docs/typescript-guide.md

@@ -479,12 +479,11 @@ const schema = dsl({
 const schema = dsl({
   userType: dsl('string!').label('用户类型'),
   
-  companyName: dsl('string')
-    .when('userType', {
-      is: 'company',
-      then: dsl('string!').label('公司名称'),  // 企业用户必填
-      otherwise: dsl('string').label('公司名称')  // 个人用户可选
-    })
+  // 使用 dsl.match() 根据 userType 字段动态验证
+  companyName: dsl.match('userType', {
+    'company': 'string!',  // 企业用户必填
+    '_default': 'string'   // 个人用户可选
+  })
 });
 ```
 

package/docs/union-type-guide.md

@@ -0,0 +1,147 @@
+# 一个字段支持多种类型
+
+> 使用 `.pattern()` 方法匹配多种格式
+
+---
+
+## 基本用法
+
+```javascript
+const { dsl, validate } = require('schema-dsl');
+
+// 邮箱 或 手机号
+const schema = dsl({
+  contact: dsl('string!')
+    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|1[3-9]\d{9})$/)
+    .messages({ pattern: '必须是邮箱或手机号' })
+});
+
+validate(schema, { contact: 'test@example.com' });  // ✅
+validate(schema, { contact: '13800138000' });       // ✅
+validate(schema, { contact: 'invalid' });           // ❌
+```
+
+**说明**：
+- 正则中使用 `|` 表示"或"，括号 `()` 分组
+- 使用 `.messages()` 设置错误消息，支持多语言
+
+---
+
+## 常用示例
+
+### 用户登录（用户名或邮箱）
+
+```javascript
+const loginSchema = dsl({
+  username: dsl('string:3-32!')
+    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|[a-zA-Z0-9_]+)$/)
+    .messages({ pattern: '必须是邮箱或用户名' }),
+  password: 'string:8-32!'
+});
+```
+
+### 联系方式（邮箱或手机号）
+
+```javascript
+const schema = dsl({
+  contact: dsl('string!')
+    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|1[3-9]\d{9})$/)
+    .messages({ pattern: '必须是邮箱或手机号' })
+});
+```
+
+### URL（http 或 https）
+
+```javascript
+const schema = dsl({
+  website: dsl('string!')
+    .pattern(/^https?:\/\/.+$/)
+    .messages({ pattern: '必须是 http 或 https 开头的 URL' })
+});
+```
+
+---
+
+## 支持多语言
+
+```javascript
+// 使用多语言 key
+const schema = dsl({
+  contact: dsl('string!')
+    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|1[3-9]\d{9})$/)
+    .messages({ pattern: 'pattern.emailOrPhone' })  // 多语言 key
+});
+
+// 验证时指定语言
+validate(schema, { contact: 'invalid' }, { locale: 'zh-CN' });  // 中文：必须是邮箱或手机号
+validate(schema, { contact: 'invalid' }, { locale: 'en-US' });  // 英文：Must be an email or phone number
+```
+
+**内置多语言 key**：
+- `pattern.emailOrPhone` - 邮箱或手机号
+- `pattern.usernameOrEmail` - 用户名或邮箱
+- `pattern.httpOrHttps` - http 或 https URL
+
+---
+
+## 正则表达式速查
+
+```javascript
+// 邮箱 或 手机号
+/^([^\s@]+@[^\s@]+\.[^\s@]+|1[3-9]\d{9})$/
+
+// http 或 https
+/^https?:\/\/.+$/
+
+// 用户名 或 邮箱
+/^([^\s@]+@[^\s@]+\.[^\s@]+|[a-zA-Z0-9_]{3,32})$/
+
+// 数字ID 或 UUID
+/^(\d+|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i
+
+// 多个邮箱域名
+/^[^\s@]+@(gmail\.com|qq\.com|163\.com)$/
+
+// 中国或美国手机号
+/^(1[3-9]\d{9}|\+1\d{10})$/
+```
+
+---
+
+
+## 完整示例
+
+```javascript
+const { dsl, validate } = require('schema-dsl');
+
+const registerSchema = dsl({
+  name: 'string:1-50!',
+  contact: dsl('string!')
+    .pattern(/^([^\s@]+@[^\s@]+\.[^\s@]+|1[3-9]\d{9})$/)
+    .messages({ pattern: '必须是邮箱或手机号' })
+});
+
+const testData = [
+  { name: '张三', contact: 'zhangsan@example.com' },
+  { name: '李四', contact: '13800138000' },
+  { name: '王五', contact: 'invalid' }
+];
+
+testData.forEach((data, index) => {
+  const result = validate(registerSchema, data);
+  console.log(`测试${index + 1}:`, result.valid ? '✅' : '❌');
+  if (!result.valid) {
+    console.log('  错误:', result.errors[0].message);
+  }
+});
+```
+
+**输出**：
+```
+测试1: ✅
+测试2: ✅
+测试3: ❌
+  错误: 必须是邮箱或手机号
+```
+
+