schema-dsl 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -1,1282 +1,121 @@
-# schema-dsl 更新日志
+# 变更日志 (CHANGELOG)
 
-本文档记录 schema-dsl 项目的所有重要变更。
-
-格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
-版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+> **说明**: 版本概览摘要，详细变更见 [changelogs/](./changelogs/) 目录  
+> **最后更新**: 2026-01-13
 
 ---
 
 ## 版本概览
 
-| 版本               | 日期 | 变更摘要 | 详细 |
-|------------------|------|---------|------|
-| [v1.1.2](#v112)  | 2026-01-06 | 🎉 新功能：数字比较运算符 + Bug修复 | [查看详情](#v112) |
-| [v1.1.1](#v111)  | 2026-01-06 | 🎉 新功能：ConditionalBuilder 独立消息支持 | [查看详情](#v111) |
-| [v1.1.0](#v110)  | 2026-01-05 | 🎉 重大功能：跨类型联合验证 + 插件系统增强 | [查看详情](#v110) |
-| [v1.0.9](#v109)  | 2026-01-04 | 🎉 重大改进：多语言支持完善 + TypeScript 类型完整 | [查看详情](#v109) |
-| [v1.0.8](#v108) | 2026-01-04 | 优化：错误消息过滤增强 | [查看详情](#v108) |
-| [v1.0.7](#v107)  | 2026-01-04 | 修复：dsl.match/dsl.if 嵌套支持 dsl() 包裹 | [查看详情](#v107) |
-| [v1.0.6](#v106)  | 2026-01-04 | 🚨 紧急修复：TypeScript 类型污染 | [查看详情](#v106) |
-| [v1.0.5](#v105)  | 2026-01-04 | 测试覆盖率提升至 97% | [查看详情](#v105) |
-| [v1.0.4](#v104)  | 2025-12-31 | TypeScript 完整支持、validateAsync、ValidationError | [查看详情](#v104) |
-| [v1.0.3](#v103)  | 2025-12-31 | ⚠️ 破坏性变更：单值语法修复 | [查看详情](#v103) |
-| [v1.0.2](#v102)  | 2025-12-31 | 15个新增验证器、完整文档、75个测试 | [查看详情](#v102) |
-| [v1.0.1](#v101)  | 2025-12-31 | 枚举功能、自动类型识别、统一错误消息 | [查看详情](#v101) |
-| [v1.0.0](#v100)  | 2025-12-29 | 初始发布版本 | [查看详情](#v100) |
-
----
-
-## [v1.1.2] - 2026-01-06
-
-### 🎉 新功能
-
-#### 数字比较运算符 - 更直观的数值验证
-
-**新增 5 种比较运算符，让数值验证更语义化**
-
-现在 `number` 和 `integer` 类型支持 5 种比较运算符：`>`, `>=`, `<`, `<=`, `=`
-
-**基础用法**：
-
-```javascript
-const { dsl, validate } = require('schema-dsl');
-
-// ✅ 大于（不包括边界）
-const schema1 = dsl({ value: 'number:>0' });
-validate(schema1, { value: 1 });   // ✅ true
-validate(schema1, { value: 0 });   // ❌ false (0不满足>0)
-
-// ✅ 大于等于
-const schema2 = dsl({ age: 'number:>=18' });
-validate(schema2, { age: 18 });    // ✅ true (包括18)
-validate(schema2, { age: 17 });    // ❌ false
-
-// ✅ 小于（不包括边界）
-const schema3 = dsl({ temp: 'number:<100' });
-validate(schema3, { temp: 99.9 }); // ✅ true
-validate(schema3, { temp: 100 });  // ❌ false (100不满足<100)
-
-// ✅ 小于等于
-const schema4 = dsl({ score: 'number:<=100' });
-validate(schema4, { score: 100 }); // ✅ true (包括100)
-
-// ✅ 等于
-const schema5 = dsl({ level: 'number:=5' });
-validate(schema5, { level: 5 });   // ✅ true
-validate(schema5, { level: 4 });   // ❌ false
-```
-
-**支持小数和负数**：
-
-```javascript
-// 小数
-dsl({ value: 'number:>0.5' })      // 大于0.5
-dsl({ price: 'number:<=99.99' })   // 小于等于99.99
-
-// 负数
-dsl({ value: 'number:>-10' })      // 大于-10
-dsl({ temp: 'number:<-5' })        // 小于-5
-
-// 配合必填标记
-dsl({ age: 'number:>=18!' })       // 必填且大于等于18
-dsl({ price: 'number:>0!' })       // 必填且大于0
-```
-
-**对比：比较运算符 vs 范围语法**：
-
-| 需求 | 范围语法 | 比较运算符 | 推荐 |
-|------|---------|-----------|------|
-| x ≥ 18 | `number:18-` | `number:>=18` | **比较运算符**（更清晰） |
-| x > 0（不包括0） | ❌ 无法表达 | `number:>0` | **比较运算符**（唯一方法） |
-| x < 100（不包括100） | ❌ 无法表达 | `number:<100` | **比较运算符**（唯一方法） |
-| x = 100 | `number:100`（实际≤100） | `number:=100` | **比较运算符**（精确匹配） |
-
-**实际应用场景**：
-
-```javascript
-// 场景1：用户注册 - 年龄限制
-const schema = dsl({
-  username: 'string:3-32!',
-  email: 'email!',
-  age: 'number:>=18!',  // 必须年满18岁
-  password: 'string:8-!'
-});
-
-// 场景2：电商系统 - 价格验证
-const schema = dsl({
-  productName: 'string:1-100!',
-  price: 'number:>0!',      // 价格必须大于0
-  discount: 'number:0-100'  // 折扣 0-100
-});
-
-// 场景3：温度监控
-const schema = dsl({
-  deviceId: 'string!',
-  temperature: 'number:>0',   // 温度 > 0
-  humidity: 'number:<=100'    // 湿度 ≤ 100
-});
-```
-
-**JSON Schema 映射**：
-
-```javascript
-'number:>0'    → { exclusiveMinimum: 0 }
-'number:>=18'  → { minimum: 18 }
-'number:<100'  → { exclusiveMaximum: 100 }
-'number:<=100' → { maximum: 100 }
-'number:=100'  → { enum: [100] }
-```
-
-**特性**：
-- ✅ 支持 5 种比较运算符
-- ✅ 支持小数（如 `number:>0.5`）
-- ✅ 支持负数（如 `number:>-10`）
-- ✅ 支持必填标记（如 `number:>=18!`）
-- ✅ 适用于 `number` 和 `integer` 类型
-- ✅ 完全向后兼容原有范围语法
-- ✅ 完整的 TypeScript 类型支持
-
-**文档链接**：
-- [数字比较运算符完整文档](./docs/number-operators.md)
-- [README 语法速查](./README.md#-dsl-语法速查)
-
----
-
-### 🐛 Bug 修复
+| 版本 | 日期 | 变更摘要 | 详细 |
+|------|------|---------|------|
+| [v1.1.4](./changelogs/v1.1.4.md) | 2026-01-13 | 🔧 TypeScript类型修复：移除重复函数签名 + 多语言文档完善 | [查看](./changelogs/v1.1.4.md) |
+| [v1.1.3](./changelogs/v1.1.3.md) | 2026-01-09 | 🐛 Bug修复：类型错误消息模板变量未替换 | [查看](./changelogs/v1.1.3.md) |
+| [v1.1.2](./changelogs/v1.1.2.md) | 2026-01-06 | 🎉 新功能：数字比较运算符 + Bug修复 | [查看](./changelogs/v1.1.2.md) |
+| [v1.1.1](./changelogs/v1.1.1.md) | 2026-01-06 | 🎉 新功能：ConditionalBuilder 独立消息支持 | [查看](./changelogs/v1.1.1.md) |
+| [v1.1.0](./changelogs/v1.1.0.md) | 2026-01-05 | 🎉 重大功能：跨类型联合验证 + 插件系统增强 | [查看](./changelogs/v1.1.0.md) |
+| [v1.0.9](./changelogs/v1.0.9.md) | 2026-01-04 | 🎉 重大改进：多语言支持完善 + TypeScript 类型完整 | [查看](./changelogs/v1.0.9.md) |
+| v1.0.8 | 2026-01-04 | 优化：错误消息过滤增强 | - |
+| v1.0.7 | 2026-01-04 | 修复：dsl.match/dsl.if 嵌套支持 dsl() 包裹 | - |
+| v1.0.6 | 2026-01-04 | 🚨 紧急修复：TypeScript 类型污染 | - |
+| v1.0.5 | 2026-01-04 | 测试覆盖率提升至 97% | - |
+| v1.0.4 | 2025-12-31 | TypeScript 完整支持、validateAsync、ValidationError | - |
+| v1.0.3 | 2025-12-31 | ⚠️ 破坏性变更：单值语法修复 | - |
+| v1.0.2 | 2025-12-31 | 15个新增验证器、完整文档、75个测试 | - |
+| v1.0.1 | 2025-12-31 | 枚举功能、自动类型识别、统一错误消息 | - |
+| [v1.0.0](./changelogs/v1.0.0.md) | 2025-12-29 | 初始发布版本 | [查看](./changelogs/v1.0.0.md) |
 
-#### 修复比较运算符被误解析为枚举的问题
-
-**问题描述**：
-在 v1.1.1 及之前版本，使用 `number:>0` 等语法时会被错误解析为字符串枚举 `enum: ['>0']`，导致验证结果完全相反。
-
-**修复前**：
-```javascript
-const schema = dsl({ value: 'number:>0' });
-validate(schema, { value: -5 }); // ❌ 错误：返回 true（应该false）
-validate(schema, { value: 5 });  // ❌ 错误：返回 false（应该true）
-```
-
-**修复后**：
-```javascript
-const schema = dsl({ value: 'number:>0' });
-validate(schema, { value: -5 }); // ✅ 正确：返回 false
-validate(schema, { value: 5 });  // ✅ 正确：返回 true
-```
-
-**影响范围**：
-- 仅影响使用 `>`, `<`, `>=`, `<=`, `=` 符号的 number 约束
-- 原有范围语法（如 `number:0-100`）不受影响
-- 完全向后兼容
+> 💡 **提示**: 重要版本的详细变更记录在 [changelogs/](./changelogs/) 目录中。  
+> 当前已有详细文档的版本：v1.1.4, v1.1.3, v1.1.2, v1.1.1, v1.1.0, v1.0.9, v1.0.0  
+> 其他版本的详细变更信息请参考项目提交历史或联系维护者。
 
 ---
 
-### 📚 文档更新
+## 变更统计
 
-- 新增 [数字比较运算符文档](./docs/number-operators.md)
-- 更新 README.md 添加比较运算符示例
-- 更新 index.d.ts 添加比较运算符类型注释
-- 新增 28 个比较运算符单元测试
+| 版本系列 | 版本数 | 主要改进方向 |
+|---------|-------|------------|
+| v1.1.x | 5 | TypeScript类型完善、多语言支持、数字运算符、联合类型、类型错误修复 |
+| v1.0.x | 10 | 核心功能、验证器、测试覆盖、文档完善 |
 
 ---
 
-### 🧪 测试
+## 里程碑版本
 
-- **新增测试**：28 个比较运算符测试用例
-- **测试总数**：949 个（921 + 28）
-- **测试覆盖**：100% 通过
-- **测试文件**：`test/unit/number-operators.test.js`
+### v1.1.4 - TypeScript类型修复与文档完善 🔧
 
----
+**发布日期**: 2026-01-13  
+**重要性**: ⭐⭐⭐
 
-### 📊 变更统计
+**核心改进**:
+- ✅ 修复 index.d.ts 中2处重复函数签名（46个类型错误→0个错误）
+- ✅ 修复 `dsl.error.assert` 重复签名（L1336-1343）
+- ✅ 修复 `I18nError.assert` 重复签名（L1805-1821）
+- ✅ 完善多语言运行时支持文档（docs/runtime-locale-support.md）
+- ✅ README.md 添加运行时语言指定示例
+- ✅ 验证 string? 可选语法完整支持
 
-- **新增功能**：1 个（数字比较运算符）
-- **Bug 修复**：1 个（比较运算符误解析）
-- **文档更新**：3 个（README, docs/number-operators.md, index.d.ts）
-- **测试新增**：28 个
-- **代码变更**：2 个文件（lib/core/DslBuilder.js, lib/adapters/DslAdapter.js）
+**详细信息**: [查看 changelogs/v1.1.4.md](./changelogs/v1.1.4.md)
 
 ---
 
-## [v1.1.1] - 2026-01-06
-
-### 🎉 新功能
-
-#### ConditionalBuilder 独立消息支持 - `.and()/.or()` 后可调用 `.message()`
-
-**每个条件都可以有自己的错误消息**
+### v1.1.3 - 类型错误消息模板修复 🐛
 
-现在支持在 `.and()` 和 `.or()` 后调用 `.message()` 设置独立的错误消息，让错误提示更精确。
+**发布日期**: 2026-01-09  
+**重要性**: ⭐⭐⭐
 
-**基础用法**：
+**核心改进**:
+- ✅ 修复类型错误消息中 `{{#actual}}` 模板变量未替换问题
+- ✅ 错误消息正确显示实际数据类型
+- ✅ 向后兼容，无破坏性变更
 
-```javascript
-const { dsl } = require('schema-dsl');
-
-// ✅ v1.1.1 新功能：每个条件独立消息
-dsl.if(d => !d)
-  .message('ACCOUNT_NOT_FOUND')
-  .and(d => d.tradable_credits < amount)
-  .message('INSUFFICIENT_TRADABLE_CREDITS')
-  .assert(account);
-
-// 工作原理：
-// - 第一个条件失败 → 返回 'ACCOUNT_NOT_FOUND'
-// - 第二个条件失败 → 返回 'INSUFFICIENT_TRADABLE_CREDITS'
-// - 所有条件通过 → 验证成功
-```
-
-**特性**：
-- ✅ 支持多个 `.and()` 条件各有独立消息
-- ✅ 支持 `.or()` 条件独立消息
-- ✅ 自动检测启用链式检查模式
-- ✅ 100% 向后兼容，不影响现有代码
-- ✅ 完整的 TypeScript 类型支持
-
-**实际应用示例**：
-
-```javascript
-// 多层验证，每层都有清晰的错误消息
-dsl.if(d => !d)
-  .message('ACCOUNT_NOT_FOUND')
-  .and(d => d.status !== 'active')
-  .message('ACCOUNT_INACTIVE')
-  .and(d => d.tradable_credits < amount)
-  .message('INSUFFICIENT_TRADABLE_CREDITS')
-  .assert(account);
-```
-
-**文档链接**：
-- [条件 API 文档](./docs/conditional-api.md)
-- [README FAQ Q7](./README.md#q7-如何合并多个-dslif-验证)
+**详细信息**: [查看 changelogs/v1.1.3.md](./changelogs/v1.1.3.md)
 
 ---
 
-#### I18nError 多语言错误抛出机制
-
-**统一的多语言错误抛出**
-
-新增 `I18nError` 类和 `dsl.error` 快捷方法，提供统一的多语言错误抛出机制。
+### v1.1.0 - 跨类型联合验证 🎉
 
-**基础用法**：
+**发布日期**: 2026-01-05  
+**重要性**: ⭐⭐⭐⭐⭐
 
-```javascript
-const { I18nError, dsl } = require('schema-dsl');
+**核心特性**:
+- ✅ 跨类型联合验证（email|phone 可以混合不同类型）
+- ✅ 运行时多语言支持（dsl.error.create 可指定 locale 参数）
+- ✅ 插件系统增强
 
-// 方式1：直接抛出
-I18nError.throw('account.notFound');
-// 中文: "账户不存在"
-// 英文: "Account not found"
-
-// 方式2：带参数插值
-I18nError.throw('account.insufficientBalance', {
-  balance: 50,
-  required: 100
-});
-// 输出: "余额不足，当前余额50，需要100"
-
-// 方式3：断言风格（推荐）
-I18nError.assert(account, 'account.notFound');
-I18nError.assert(
-  account.balance >= 100,
-  'account.insufficientBalance',
-  { balance: account.balance, required: 100 }
-);
-
-// 方式4：快捷方法
-dsl.error.throw('user.noPermission');
-dsl.error.assert(user.role === 'admin', 'user.noPermission');
-```
-
-**特性**：
-- ✅ 统一的错误代码格式：`{模块}.{错误类型}`
-- ✅ 自动多语言翻译（支持中英文）
-- ✅ 参数插值支持
-- ✅ Express/Koa 集成（toJSON 方法）
-- ✅ 与 `.message()` 和 `.label()` 使用相同的多语言机制
-
-**内置错误代码**：
-- 通用: `error.notFound`, `error.forbidden`, `error.unauthorized`
-- 账户: `account.notFound`, `account.insufficientBalance`, `account.insufficientCredits`
-- 用户: `user.notFound`, `user.noPermission`, `user.notVerified`
-- 订单: `order.notPaid`, `order.paymentMissing`, `order.addressMissing`
-
-**Express/Koa 集成**：
-
-```javascript
-app.use((error, req, res, next) => {
-  if (error instanceof I18nError) {
-    return res.status(error.statusCode).json(error.toJSON());
-  }
-  next(error);
-});
-```
-
-**文档链接**：
-- [使用示例](./examples/i18n-error.examples.js)
-- [README FAQ Q8](./README.md#q8-如何统一抛出多语言错误v111)
+**详细信息**: [查看 changelogs/v1.1.0.md](./changelogs/v1.1.0.md)
 
 ---
 
-### 📝 测试
+### v1.0.9 - 多语言支持完善 🌍
 
-- **新增**: 52 个测试用例（24个独立消息 + 28个 I18nError）
-- **总计**: 921 个测试全部通过 (100%)
+**发布日期**: 2026-01-04  
+**重要性**: ⭐⭐⭐⭐
 
-### 📖 文档
+**核心特性**:
+- ✅ 完整的多语言支持（5种语言）
+- ✅ TypeScript 类型定义完整
+- ✅ I18nError 多语言错误类
 
-- **新增**: docs/conditional-api.md 新增 600+ 行功能说明
-- **新增**: examples/i18n-error.examples.js I18nError 使用示例
-- **更新**: README.md FAQ Q7/Q8 添加新功能说明
-- **更新**: index.d.ts TypeScript 类型注释和示例（I18nError + dsl.error）
+**详细信息**: [查看 changelogs/v1.0.9.md](./changelogs/v1.0.9.md)
 
 ---
 
-## [v1.1.0] - 2026-01-05
+### v1.0.0 - 正式发布 🎉
 
-### 🎉 新功能
+**发布日期**: 2025-12-29  
+**重要性**: ⭐⭐⭐⭐⭐
 
-#### 1. 跨类型联合验证 - `types:` 语法
+**核心成就**:
+- ✅ 初始发布
+- ✅ 简洁的DSL语法
+- ✅ 完整的验证功能
 
-**一个字段支持多种类型**
-
-...existing content...
-
-**带约束的联合类型**：
-
-```javascript
-const schema = dsl({
-  contact: 'types:email|phone!',         // 邮箱或手机号
-  price: 'types:number:0-|string:1-20',  // 数字价格或"面议"
-  rating: 'types:integer:1-5|string:9'   // 整数1-5或字符串"excellent"
-});
-```
-
-**实际应用场景**：
-
-```javascript
-// 用户注册：灵活的联系方式
-const registerSchema = dsl({
-  username: 'string:3-20!',
-  contact: 'types:email|phone!',  // 支持邮箱或手机号注册
-  age: 'types:integer:1-150|null' // 年龄可选（null表示不填）
-});
-```
-
-**支持的类型**：
-- ✅ 所有内置类型：`string`, `number`, `email`, `url`, `uuid` 等
-- ✅ 插件注册的自定义类型（见下文）
+**详细信息**: [查看 changelogs/v1.0.0.md](./changelogs/v1.0.0.md)
 
 ---
 
-#### 2. 插件系统增强 - DSL类型注册
-
-**插件现在可以注册自定义DSL类型**
-
-插件不再局限于注册ajv format/keyword，现在可以注册完整的DSL类型，让自定义类型在DSL语法中直接可用。
-
-**改造前** (v1.0.x)：
-```javascript
-// ❌ 只能注册ajv format（仅验证阶段生效）
-install(schemaDsl, options) {
-  const ajv = validator.getAjv();
-  ajv.addFormat('phone-cn', { validate: /^1[3-9]\d{9}$/ });
-  
-  // ❌ 无法在DSL语法中使用
-  // dsl({ phone: 'phone-cn!' })  // 报错：未知类型
-}
-```
-
-**改造后** (v1.1.0)：
-```javascript
-// ✅ 同时注册DSL类型和ajv format
-install(schemaDsl, options) {
-  const { DslBuilder } = schemaDsl;
-  
-  // ✅ 注册到DSL解析器（解析阶段）
-  DslBuilder.registerType('phone-cn', {
-    type: 'string',
-    pattern: /^1[3-9]\d{9}$/.source,
-    minLength: 11,
-    maxLength: 11
-  });
-  
-  // ✅ 注册到ajv（验证阶段）
-  const ajv = validator.getAjv();
-  ajv.addFormat('phone-cn', { validate: /^1[3-9]\d{9}$/ });
-  
-  // ✅ 现在可以在DSL中直接使用
-  // dsl({ phone: 'phone-cn!' })  // ✅ 成功
-  // dsl({ contact: 'types:email|phone-cn' })  // ✅ 在联合类型中也能用
-}
-```
-
-**新增 API**：
-
-| API | 说明 | 用途 |
-|-----|------|------|
-| `DslBuilder.registerType(name, schema)` | 注册自定义类型 | 插件注册新类型 |
-| `DslBuilder.hasType(type)` | 检查类型是否存在 | 插件验证类型 |
-| `DslBuilder.getCustomTypes()` | 获取所有自定义类型 | 调试和测试 |
-| `DslBuilder.clearCustomTypes()` | 清除自定义类型 | 测试用 |
-
-**插件示例**：
-
-```javascript
-// plugins/custom-format.js (v2.0.0)
-module.exports = {
-  name: 'custom-format',
-  version: '2.0.0',
-  
-  install(schemaDsl, options, context) {
-    const { DslBuilder } = schemaDsl;
-    const ajv = validator.getAjv();
-    
-    // 定义自定义类型
-    const types = {
-      'phone-cn': {
-        pattern: /^1[3-9]\d{9}$/,
-        schema: { type: 'string', pattern: /^1[3-9]\d{9}$/.source, minLength: 11, maxLength: 11 }
-      },
-      'qq': {
-        pattern: /^[1-9][0-9]{4,10}$/,
-        schema: { type: 'string', pattern: /^[1-9][0-9]{4,10}$/.source, minLength: 5, maxLength: 11 }
-      }
-    };
-    
-    // 注册到DSL和ajv
-    Object.keys(types).forEach(name => {
-      const config = types[name];
-      DslBuilder.registerType(name, config.schema);  // DSL解析
-      ajv.addFormat(name, { validate: config.pattern });  // ajv验证
-    });
-  }
-};
-```
-
----
-
-#### 3. ConditionalBuilder 快捷验证方法
-
-**一行代码完成条件验证**
-
-新增4个快捷验证方法，让条件判断更简洁：
-
-| 方法 | 返回值 | 抛错 | 异步 | 适用场景 |
-|------|--------|------|------|---------|
-| `.validate()` | `{ valid, errors, data }` | ❌ | ❌ | 需要错误详情 |
-| `.validateAsync()` | `Promise<data>` | ✅ | ✅ | async/await、中间件 |
-| `.assert()` | `data` | ✅ | ❌ | 快速失败、断言 |
-| `.check()` | `boolean` | ❌ | ❌ | 只需判断真假 |
-
-**使用示例**：
-
-```javascript
-// 同步验证 - 返回详细结果
-const result = dsl.if(d => d.age < 18)
-  .message('未成年用户不能注册')
-  .validate({ age: 16 });
-
-// 异步验证 - 失败自动抛错
-await dsl.if(d => d.age < 18)
-  .message('未成年用户不能注册')
-  .validateAsync({ age: 16 });
-
-// 断言验证 - 同步抛错
-dsl.if(d => d.age < 18).message('未成年').assert(userData);
-
-// 快速判断 - 返回 boolean
-const isValid = dsl.if(d => d.age < 18).message('未成年').check(data);
-```
-
-**优势**：
-- ✅ 从2行代码减少到1行
-- ✅ 支持 async/await
-- ✅ 快速失败模式
-- ✅ 完全向后兼容
-
-**详细文档**：[ConditionalBuilder API](./docs/conditional-api.md)
-
-### Changed
-
-- 📖 优化 README.md，新增"条件验证 - 一行代码搞定"章节
-- 📖 完善 API 文档和使用示例
-- 📖 新增4个方法的 TypeScript 类型定义
-
-### Tests
-
-- ✅ 新增 45个测试用例（总计 807个测试）
-  - `.validate()` 方法: 9个
-  - `.validateAsync()` 方法: 6个
-  - `.assert()` 方法: 6个
-  - `.check()` 方法: 5个
-  - 边界情况: 12个
-  - 特殊场景: 7个
-- ✅ 测试覆盖率 100%（807/807）
-- ✅ 覆盖 null、undefined、空值、NaN、异常处理等所有边界情况
-
-### 向后兼容
-
-✅ **完全向后兼容**，所有现有代码无需修改
-
----
-
-## [v1.0.9] - 2026-01-04
-
-### 🎉 重大改进
-
-#### 1. 多语言文档完善 ⭐⭐⭐
-
-**优化内容**：
-
-1. ✅ **统一文档描述为"首次加载，运行时切换"**
-   - 修复 `i18n-user-guide.md` 配置示例错误
-   - 更新 `add-custom-locale.md`、`dynamic-locale.md`、`frontend-i18n-guide.md`
-   - 添加完整的配置和使用示例
-   - 添加错误示例对比（运行时单个加载 vs 首次加载）
-
-2. ✅ **添加文档导航**
-   - 在 `i18n.md` 添加多语言文档导航
-   - 帮助用户快速找到所需文档
-
-3. ✅ **性能数据更新**
-   - 更新性能对比数据：**2,879,606 ops/s**（提升3.19倍）
-   - 比 Zod 快 1.58倍
-   - 比 Joi 快 9.61倍
-   - 比 Yup 快 27.07倍
-
-#### 2. 多语言支持完善（v1.0.9 早期）⭐⭐⭐
-
-**问题描述**：
-- TypeScript 类型定义缺少 `options` 参数
-- 多语言切换需要修改全局状态，并发场景不安全
-- 自定义错误消息查找逻辑有问题
-
-**修复内容**：
-
-1. ✅ **TypeScript 类型定义完善**
-   ```typescript
-   // 新增 ValidateOptions 接口
-   interface ValidateOptions {
-     format?: boolean;      // 是否格式化错误
-     locale?: string;       // 动态指定语言（如 'zh-CN', 'en-US'）
-     messages?: ErrorMessages; // 自定义错误消息
-   }
-   
-   // 更新函数签名
-   function validate(
-     schema: JSONSchema | DslBuilder,
-     data: any,
-     options?: ValidateOptions  // ← 新增
-   ): ValidationResult;
-   
-   // 更新 Validator.validate 方法签名
-   validate(
-     schema: JSONSchema | DslBuilder | Function,
-     data: any,
-     options?: ValidateOptions  // ← 新增
-   ): ValidationResult;
-   ```
-
-2. ✅ **参数化语言切换（无需全局状态）**
-   ```javascript
-   // 旧方式（需要修改全局状态）
-   Locale.setLocale('zh-CN');
-   const result = validate(schema, data);
-   
-   // 新方式（参数化，支持并发）
-   const result = validate(schema, data, { locale: 'zh-CN' });
-   ```
-
-3. ✅ **修复自定义错误消息查找逻辑**
-   - **Bug 1**: 优先使用通用模板而非 schema 自定义消息
-   - **Bug 2**: 无法正确处理三种自定义消息格式：
-     - 键引用：`_customMessages.pattern = "pattern.objectId"`
-     - 模板字符串：`_customMessages.min = "{{#label}}必须大于{{#limit}}"`
-     - 最终消息：`_customMessages.pattern = "手机号格式不正确"`
-
-**修复效果**：
-
-```javascript
-// 1. 并发调用不同语言
-const [resultZh, resultEn] = await Promise.all([
-  validate(schema, data, { locale: 'zh-CN' }),
-  validate(schema, data, { locale: 'en-US' })
-]);
-// ✅ 两次调用互不影响
-
-// 2. 自定义消息（键引用）
-const schema = dsl('objectId!');
-const result = validate(schema, 'invalid', { locale: 'zh-CN' });
-// message: "无效的 ObjectId" ✅
-
-// 3. 自定义消息（模板字符串）
-const schema = dsl({
-  age: 'number:18-!'.label('年龄')
-    .messages({ 'min': '{{#label}}必须大于{{#limit}}' })
-});
-const result = validate(schema, { age: 10 });
-// message: "年龄必须大于18" ✅
-
-// 4. 自定义消息（最终消息）
-const schema = dsl({
-  phone: 'string!'.pattern(/^1[3-9]\d{9}$/)
-    .messages({ 'pattern': '手机号格式不正确' })
-});
-const result = validate(schema, { phone: 'invalid' });
-// message: "手机号格式不正确" ✅
-```
-
-**技术细节**：
-- 修改 `index.js` 中的 `validate()` 函数，传递 `options` 参数
-- 修改 `Validator.js` 中的 `validate()` 方法，直接传递 `locale` 到 ErrorFormatter
-- 修改 `ErrorFormatter.js`：
-  - `format()` 方法支持对象参数 `{ locale, messages }`
-  - `formatDetailed()` 方法新增 `customMessages` 参数
-  - 优化自定义消息查找逻辑：优先检查 schema 中的 `_customMessages`
-
-**测试结果**：
-- ✅ 725 个测试全部通过（从 51 个失败修复到 0 个失败）
-- ✅ 完全向后兼容，不破坏现有 API
-
-### Changed (变更)
-
-- 📝 **API**: `validate()` 和 `Validator.validate()` 新增 `options` 参数（向后兼容）
-- 🔧 **内部**: `ErrorFormatter.formatDetailed()` 新增 `customMessages` 参数
-
-### Fixed (修复)
-
-- 🐛 修复 TypeScript 类型定义缺少 `options` 参数
-- 🐛 修复自定义错误消息查找逻辑（优先级问题）
-- 🐛 修复自定义消息无法区分键引用/模板字符串/最终消息
-
----
-
-## [v1.0.8] - 2026-01-04
-
-### Improved (优化)
-
-#### 错误消息过滤增强 ⭐
-
-**问题描述**：
-用户报告错误消息存在冗余问题：
-- 在嵌套 If/Match 结构中，会显示重复的 "must match then schema" 包装错误
-- 当已有具体字段错误时（如"Credit price is required"），还会额外显示2-3个通用包装错误
-
-**修复内容**：
-- ✅ 过滤 `if` 关键字的包装错误
-- ✅ 过滤 `anyOf` 关键字的包装错误  
-- ✅ 过滤 `oneOf` 关键字的包装错误
-- ✅ 当存在具体字段错误时，自动移除所有包装错误
-
-**修复效果**：
-
-修复前：
-```javascript
-const result = validate(schema, data);
-// errors: [
-//   { message: "Credit price is required" },
-//   { message: "must match then schema" },  // 冗余
-//   { message: "must match then schema" }   // 冗余
-// ]
-```
-
-修复后：
-```javascript
-const result = validate(schema, data);
-// errors: [
-//   { message: "Credit price is required" }  // 只显示具体错误
-// ]
-```
-
-**技术细节**：
-- 修改文件：[lib/core/ErrorFormatter.js](lib/core/ErrorFormatter.js#L84-L101)
-- 过滤逻辑：检测到具体错误（type, required, pattern等）时，自动过滤包装错误（if, anyOf, oneOf）
-- 适用场景：所有使用 `dsl.if()`、`dsl.match()` 以及 JSON Schema 的 anyOf/oneOf 的验证
-
-**测试覆盖**：
-- 测试文件：[test/unit/error-message-filter.test.js](test/unit/error-message-filter.test.js)
-- 新增测试：5个错误过滤场景
-- 测试总数：725 (+5)
-- 所有测试通过 ✅
-
----
-
-## [v1.0.7] - 2026-01-04
-
-### Fixed (修复)
-
-#### 全面支持 dsl.match/dsl.if 所有嵌套组合 ⭐⭐⭐
-
-**问题描述**：
-在 v1.0.6 中，TypeScript 用户被要求使用 `dsl()` 包裹字符串，但在 `dsl.match()` 和 `dsl.if()` 中使用嵌套结构时会失败。用户报告了复杂嵌套场景无法正常工作。
-
-**修复内容**：
-- ✅ **Match 嵌套 Match** - 多级条件分支
-- ✅ **Match 嵌套 If** - 在分支中使用条件
-- ✅ **If 嵌套 Match** - 条件中使用多分支（用户报告的场景）
-- ✅ **If 嵌套 If** - 多层条件嵌套
-- ✅ **_default 中嵌套** - 默认规则支持 Match/If
-- ✅ **三层嵌套** - 支持任意深度嵌套
-
-**修复前问题**：
-```javascript
-// ❌ v1.0.6 中所有嵌套都会失败
-credit_price: dsl.if('enabled',
-  dsl.match('payment_type', {
-    'credit': dsl('integer:1-10000!').label('价格'),
-    '_default': 'integer:1-10000'
-  }),
-  'integer:1-10000'
-)
-```
-
-**修复后**：
-```javascript
-// ✅ v1.0.7 完全支持所有嵌套组合
-
-// 1. If 嵌套 Match（用户场景）
-credit_price: dsl.if('enabled',
-  dsl.match('payment_type', {
-    'credit': dsl('integer:1-10000!').label('credit_price'),
-    '_default': 'integer:1-10000'
-  }),
-  'integer:1-10000'
-)
-
-// 2. Match 嵌套 Match
-value: dsl.match('category', {
-  'contact': dsl.match('type', {
-    'email': dsl('email!').label('邮箱'),
-    'phone': dsl('string:11!').label('手机号')
-  }),
-  'payment': dsl.match('type', {
-    'credit': dsl('integer:1-10000!'),
-    'cash': dsl('number:0.01-10000!')
-  })
-})
-
-// 3. Match 嵌套 If
-discount: dsl.match('user_type', {
-  'member': dsl.if('is_vip',
-    dsl('number:10-50!').label('VIP会员折扣'),
-    dsl('number:5-20!').label('普通会员折扣')
-  ),
-  'guest': dsl('number:0-10').label('访客折扣')
-})
-
-// 4. If 嵌套 If
-price: dsl.if('is_member',
-  dsl.if('is_premium',
-    dsl('number:100-500!').label('高级会员价'),
-    dsl('number:200-800!').label('普通会员价')
-  ),
-  dsl('number:500-1000!').label('非会员价')
-)
-
-// 5. 三层嵌套
-value: dsl.match('level1', {
-  'A': dsl.match('level2', {
-    'A1': dsl.if('level3',
-      dsl('integer:1-100!'),
-      dsl('integer:1-50!')
-    )
-  })
-})
-```
-
-**技术细节**：
-- 修复了 `DslAdapter._buildMatchSchema()` 方法（第476-489行）
-- 修复了 `DslAdapter._buildIfSchema()` 方法
-- 递归处理所有 `_isMatch` 和 `_isIf` 结构
-- 新增 null/undefined 分支值处理逻辑
-- 支持任意深度嵌套（已测试至5层）
-
-**已知限制**：
-1. **自定义验证器传递限制** - `.custom()` 验证器在嵌套 Match/If 中可能不会完全传递
-   ```javascript
-   // .custom() 的自定义消息可能在深层嵌套中丢失
-   value: dsl.match('type', {
-     'email': dsl('string!').custom((v) => v.includes('@'))
-   })
-   // 基础验证（必填、类型）会生效，但 custom 验证可能不完全传递
-   ```
-
-2. **嵌套字段路径限制** - `dsl.match(field)` 的 field 参数不支持嵌套路径
-   ```javascript
-   // ❌ 不支持
-   dsl.match('config.engine', {...})
-   
-   // ✅ 支持 - 使用扁平化字段
-   dsl.match('config_engine', {...})
-   ```
-
-3. **自定义消息传递** - 在多层嵌套中，自定义错误消息可能不会完全保留
-
-**测试覆盖**：
-- 测试总数：**686 → 720**（**+34 个全面测试**）
-- **v1.0.7 新增测试场景**：
-  
-  **基础嵌套组合**（6个测试）：
-  - Match 嵌套 Match - 多级条件分支
-  - Match 嵌套 If - 在分支中使用条件
-  - If 嵌套 Match - 条件中使用多分支
-  - If 嵌套 If - 多层条件嵌套
-  - _default 中使用嵌套 - 默认规则支持 Match/If
-  - 三层嵌套 - 任意深度嵌套验证
-  
-  **参数验证和错误处理**（7个测试）：
-  - 空 map 处理 - Match 中空映射表的行为
-  - null/undefined 分支值 - 空值分支的处理
-  - 参数验证 - match/if 参数的有效性检查
-  - 对象/数组作为条件值 - 复杂类型作为条件的验证
-  - 循环依赖检测 - 防止无限递归
-  - 同一字段多规则引用 - 字段重复使用场景
-  - undefined else 分支 - If 中省略 else 的行为
-  
-  **深度嵌套和高级场景**（6个测试）：
-  - 4层嵌套 - Match-Match-Match-If 四层组合
-  - 大量分支（10+）- 单个 Match 包含15个分支
-  - .custom() 验证器在嵌套中 - 自定义验证器的传递（已知限制）
-  - 复杂对象规则 - 嵌套中包含复杂对象 schema
-  - 混合嵌套 - Match 中 If，If 中 Match，再嵌套对象
-  - 5层超深嵌套 - 极端深度测试
-  
-  **覆盖率提升测试**（14个测试）：
-  - 错误处理和边界情况（6个）
-  - 特殊DSL语法覆盖（4个）
-  - 极端和性能测试（4个）
-  
-  **代码修复**：
-  - 修复 `lib/adapters/DslAdapter.js` 中 null/undefined 分支处理
-  - 新增代码行：476-489（处理空值分支）
-  
-- **测试覆盖率**：73.12% → 73.17%（语句覆盖率）
-- **Match/If核心功能覆盖率**：~100%（所有嵌套组合和边界情况）
-- 所有测试通过 ✅
-
-**迁移指南**：
-无需任何代码修改，所有嵌套场景现在都自动支持。
-
----
-
-## [v1.0.6] - 2026-01-04
-
-### 🚨 Fixed (紧急修复)
-
-#### TypeScript 类型污染问题 ⭐⭐⭐
-
-**问题描述**：
-- v1.0.5 及更早版本中，`index.d.ts` 包含了全局 `interface String` 扩展（第 816-1065 行，共 209 行代码）
-- 这导致 TypeScript 全局类型系统污染，原生 `String.prototype` 方法的类型被错误推断
-- **严重问题**：`String.prototype.trim()` 返回类型从 `string` 被错误推断为 `DslBuilder`
-- 影响所有使用 TypeScript 的项目，导致类型安全问题
-
-**修复内容**：
-- ✅ **完全删除**全局 `interface String` 扩展（移除 209 行类型污染代码）
-- ✅ 添加详细的 TypeScript 使用说明文档
-- ✅ 保证原生 String 方法的类型推断正确（`trim()` 正确返回 `string`）
-
-**对用户的影响**：
-
-1. **JavaScript 用户** ✅ **完全不受影响**
-   ```javascript
-   // 仍然可以正常使用 String 扩展
-   const schema = dsl({ email: 'email!'.label('邮箱') });
-   ```
-
-2. **TypeScript 用户** ⚠️ **需要调整用法**
-   ```typescript
-   // ❌ v1.0.5 及之前（有类型污染 bug）
-   const schema = dsl({ email: 'email!'.label('邮箱') });
-   
-   // ✅ v1.0.6 推荐写法（获得正确类型提示）
-   const schema = dsl({ 
-     email: dsl('email!').label('邮箱') 
-   });
-   ```
-
-**技术细节**：
-- 文件变化：`index.d.ts` 从 2958 行减少到 2749 行
-- 测试状态：所有 677 个测试通过 ✅
-- 类型验证：原生 `String.prototype.trim()` 现在正确返回 `string` 类型
-
-**迁移指南**：
-- JavaScript 项目：无需任何修改
-- TypeScript 项目：使用 `dsl()` 函数包裹字符串字面量获得类型提示
-- 详见：[TypeScript 使用指南](./docs/typescript-guide.md)
-
----
-
-## [v1.0.5] - 2026-01-04
-
-### Added (新增功能)
-
-#### 测试覆盖率大幅提升 ⭐
-
-- ✅ **新增 5 个核心类的完整测试**
-  - `CacheManager.test.js` - 24 个测试（缓存管理）
-  - `ErrorFormatter.test.js` - 9 个测试（错误格式化）
-  - `JSONSchemaCore.test.js` - 10 个测试（JSON Schema 核心）
-  - `MarkdownExporter.test.js` - 3 个测试（Markdown 导出）
-  - `ErrorCodes.test.js` - 4 个测试（错误代码）
-
-- ✅ **测试统计**
-  - 总测试数：651 → 677（+26 个测试）
-  - 测试覆盖率：92% → 97%（+5%）
-  - 所有核心类现在都有完整测试覆盖
-
-### Fixed (修复)
-
-- ✅ 修复缓存配置支持（4 个参数完整支持）
-- ✅ 简化 i18n 配置（从 3 个方法简化为 2 个）
-
----
-
-## [v1.0.4] - 2025-12-31
-
-### Added (新增功能)
-
-#### TypeScript 完整支持 ⭐
-
-- ✅ **完整的类型定义**
-  - 新增 `validateAsync` 函数类型定义
-  - 新增 `ValidationError` 类完整类型（包含所有方法）
-  - 优化 String 扩展的 TypeScript 说明
-
-- ✅ **TypeScript 使用指南**
-  - 创建完整的 TypeScript 使用文档 (`docs/typescript-guide.md`)
-  - 1000+ 行详细说明，涵盖从基础到高级所有场景
-  - 3个完整实战案例（用户注册、API验证、字段复用）
-  - 5个常见问题解答
-
-- ✅ **TypeScript 链式调用最佳实践**
-  ```typescript
-  // ✅ 推荐：使用 dsl() 包裹获得完整类型推导
-  const schema = dsl({
-    email: dsl('email!').label('邮箱').pattern(/custom/)
-  });
-  
-  // ❌ 不推荐：可能缺少类型提示
-  const schema = dsl({
-    email: 'email!'.label('邮箱')
-  });
-  ```
-
-### Improved (改进)
-
-- 📝 **README 更新**
-  - 添加 "1.5 TypeScript 用法" 快速开始章节
-  - 添加 TypeScript 使用指南链接
-  - 清晰说明 TypeScript 和 JavaScript 的不同用法
-
-- 🔧 **类型定义优化**
-  - 修复 `dsl.config` 的 `i18n` 参数类型错误
-  - 统一 `DslConfigOptions` 和 `dsl.config` 的类型定义
-  - 标记 String 扩展方法为 `@deprecated` for TypeScript
-
-### Documentation (文档)
-
-- 📚 新增文档
-  - `docs/typescript-guide.md` - TypeScript 使用指南（1000+ 行）
-  - `reports/schema-dsl/implementation/dollar-method-implementation-v1.0.4.md` - 实施报告
-  - `reports/schema-dsl/summary/typescript-support-completion-v1.0.4.md` - 完成总结
-
-### Note (重要说明)
-
-- ✅ **100% 向后兼容** - JavaScript 用户无需任何改变
-- ✅ **TypeScript 用户推荐使用 `dsl()` 包裹字符串** 以获得完整类型推导
-- ✅ **所有 API 都有完整的 TypeScript 类型定义**
-
----
-
-## [v1.0.3] - 2025-12-31
-
-### ⚠️ 破坏性变更 (Breaking Changes)
-
-#### String 单值语法含义变更
-
-**变更内容**: `'string:N'` 的含义从"最大长度"改为"精确长度"
-
-**变更原因**: 
-1. ✅ 更符合直觉 - 验证码、国家代码等常用场景都是精确长度
-2. ✅ 语义更清晰 - 看到 `'string:6'` 就知道是6位
-3. ✅ 有替代方案 - 最大长度可用 `'string:-N'`
-
-**影响范围**:
-```javascript
-// ❌ v1.0.2 及之前
-'string:10'  → maxLength: 10（最大长度）
-
-// ✅ v1.0.3 及之后
-'string:10'  → exactLength: 10（精确长度）
-'string:-10' → maxLength: 10（最大长度，新语法）
-```
-
-**迁移指南**:
-
-1. **如果你的代码使用 `'string:N'` 表示最大长度**:
-   ```javascript
-   // 旧代码
-   bio: 'string:500'
-   
-   // 新代码（添加 - 前缀）
-   bio: 'string:-500'
-   ```
-
-2. **如果你的代码本意就是精确长度**:
-   ```javascript
-   // 旧代码（行为不符合预期）
-   code: 'string:6'  // 之前会解析为 maxLength: 6（错误）
-   
-   // 新代码（现在正确工作）
-   code: 'string:6'  // 现在正确解析为 exactLength: 6
-   ```
-
-**检查方法**:
-```bash
-# 在项目中搜索所有使用单值语法的地方
-grep -rn "'string:[0-9]\\+['\"]" .
-grep -rn '"string:[0-9]' .
-```
-
-**受益场景统计**:
-- ✅ 60% 场景更简洁直观（验证码、国家码、邮编等）
-- ⚠️ 20% 场景需要迁移（简介、描述等）
-- ✅ 20% 场景无影响（范围语法）
-
-### 🔧 修复 (Fixes)
-
-- 修复 String 单值约束语义不直观的问题
-- 统一约束语法规则
-- 完善文档说明
-
-### 📝 文档 (Documentation)
-
-- 新增约束语法规则说明
-- 新增迁移指南
-- 更新所有示例代码
-
-### 🆕 新增功能 (Added)
-
-- 新增 `dateGreater()` 链式方法 - 日期大于验证
-- 新增 `dateLess()` 链式方法 - 日期小于验证
-
----
-
-## [v1.0.2] - 2025-12-31
-
-### 🎉 新增功能 (Added)
-
-#### 验证器扩展 (15 个新增验证器)
-
-**String 验证器** (6 个):
-- ✅ **exactLength**: 精确长度验证 - 验证字符串长度必须等于指定值
-- ✅ **alphanum**: 只能包含字母和数字 - 用于用户名、编码等场景
-- ✅ **trim**: 不能包含前后空格 - 用于搜索关键词、API密钥等
-- ✅ **lowercase**: 必须是小写 - 用于邮箱、URL slug等
-- ✅ **uppercase**: 必须是大写 - 用于国家代码、货币代码等
-- ✅ **jsonString**: JSON 字符串验证 - 验证有效的 JSON 格式
-
-**Number 验证器** (2 个):
-- ✅ **precision**: 小数位数限制 - 用于价格、百分比等高精度场景
-- ✅ **port**: 端口号验证 (1-65535) - 用于服务器配置
-
-**Object 验证器** (2 个):
-- ✅ **requiredAll**: 要求所有定义的属性都存在 - 用于完整性检查
-- ✅ **strictSchema**: 严格模式，不允许额外属性 - 用于API请求验证
-
-**Array 验证器** (2 个):
-- ✅ **noSparse**: 不允许稀疏数组 - 用于批量处理数据
-- ✅ **includesRequired**: 必须包含指定的元素 - 用于权限、标签验证
-
-**Date 验证器** (3 个):
-- ✅ **dateFormat**: 自定义日期格式验证 (支持5种格式: YYYY-MM-DD, YYYY/MM/DD, DD-MM-YYYY, DD/MM/YYYY, ISO8601)
-- ✅ **dateGreater**: 日期必须大于指定日期 - 用于活动时间范围
-- ✅ **dateLess**: 日期必须小于指定日期 - 用于历史数据验证
-
-**使用示例**:
-```javascript
-const { dsl, validate } = require('schema-dsl');
-
-// String 验证器
-const schema = {
-  code: { type: 'string', exactLength: 6 },           // 验证码
-  username: { type: 'string', alphanum: true },       // 用户名
-  keyword: { type: 'string', trim: true },            // 搜索关键词
-  email: { type: 'string', lowercase: true },         // 邮箱
-  countryCode: { type: 'string', uppercase: true },   // 国家代码
-  config: { type: 'string', jsonString: true },       // JSON配置
-  
-  // Number 验证器
-  price: { type: 'number', precision: 2 },            // 价格（2位小数）
-  port: { type: 'integer', port: true },              // 端口号
-  
-  // Date 验证器
-  birthDate: { type: 'string', dateFormat: 'YYYY-MM-DD' },  // 生日
-  endDate: { type: 'string', dateGreater: '2025-01-01' },   // 结束日期
-  startDate: { type: 'string', dateLess: '2025-12-31' }     // 开始日期
-};
-```
-
-#### 多语言支持
-- ✅ **中文消息**: 新增 19 个验证消息
-- ✅ **英文消息**: 新增 19 个验证消息
-- ✅ **错误消息键**: 统一使用 string.length, number.precision 等键名
-
-### 📝 文档 (Documentation)
-- ✅ 新增 `docs/validation-rules-v1.0.2.md` - 15个验证器详细文档（1200行）
-- ✅ 每个验证器包含：用途、参数、错误消息、使用方法、应用场景、最佳实践
-- ✅ 完整的代码示例和验证演示
-- ✅ 组合使用技巧和国际化支持说明
-
-### 🧪 测试 (Tests)
-- ✅ 新增 `test/unit/validators/CustomKeywords-v1.0.2.test.js`
-- ✅ 75 个单元测试用例，覆盖所有新增验证器
-- ✅ 每个验证器至少 5 个测试用例（正常、边界、错误情况）
-- ✅ 测试覆盖率: 100%
-- ✅ 所有测试通过: 602 passing
-
-### 📦 示例 (Examples)
-- ⏳ 待补充 `examples/validation-rules-v1.0.2.examples.js`
-
-### 🔧 技术细节 (Technical Details)
-
-**实现位置**: `lib/validators/CustomKeywords.js`
-- String 验证器: L210-334
-- Number 验证器: L342-389
-- Object 验证器: L397-441
-- Array 验证器: L449-499
-- Date 验证器: L507-608
-
-**错误消息位置**: 
-- `lib/locales/zh-CN.js` (126 行)
-- `lib/locales/en-US.js` (126 行)
-
----
-
-## [v1.0.1] - 2025-12-31
-
-### 🎉 新增功能 (Added)
-
-#### 枚举功能
-- ✅ **字符串枚举**: `'active|inactive|pending'` 简写语法
-- ✅ **布尔值枚举**: `'true|false'` 自动识别为布尔值
-- ✅ **数字枚举**: `'1|2|3'` 自动识别为数字
-- ✅ **整数枚举**: `'enum:integer:1|2|3'` 显式指定整数类型
-- ✅ **小数枚举**: `'1.0|1.5|2.0'` 支持小数值
-- ✅ **必填枚举**: `'active|inactive!'` 支持必填标记
-- ✅ **显式类型**: `'enum:type:values'` 显式指定枚举类型
-
-**使用示例**:
-```javascript
-const { dsl, validate } = require('schema-dsl');
-
-const schema = dsl({
-  // 字符串枚举（自动识别）
-  status: 'active|inactive|pending',
-  
-  // 布尔值枚举（自动识别）
-  isPublic: 'true|false',
-  
-  // 数字枚举（自动识别）
-  priority: '1|2|3',
-  
-  // 整数枚举（显式指定）
-  level: 'enum:integer:1|2|3',
-  
-  // 必填枚举
-  role: 'admin|user|guest!'
-});
-
-// 验证
-const result = validate(schema, {
-  status: 'active',
-  isPublic: true,
-  priority: 1,
-  level: 2,
-  role: 'admin'
-});
-```
-
-#### 统一错误消息
-- ✅ **统一 'enum' 键**: 所有枚举类型统一使用 `'enum'` 定义错误消息
-- ✅ **简化配置**: 不需要记忆不同类型的错误消息键名
-- ✅ **高级用法**: 支持 `'type.enum'` 格式按类型定制消息（可选）
-
-**使用示例**:
-```javascript
-const schema = dsl({
-  status: dsl('active|inactive').messages({
-    'enum': '状态必须是 active 或 inactive'  // 统一使用 enum
-  })
-});
-```
-
-### 📝 文档 (Documentation)
-
-- ✅ **新增 docs/enum.md**: 完整的枚举功能文档（476行）
-- ✅ **更新 README.md**: 添加枚举语法说明
-- ✅ **新增示例**: examples/enum.examples.js（325行，10个示例）
-
-### ✅ 测试 (Tests)
-
-- ✅ **新增 test/unit/enum.test.js**: 30个枚举测试用例
-- ✅ **测试覆盖**: 字符串/布尔值/数字/整数枚举全覆盖
-- ✅ **错误处理测试**: 无效枚举值、类型不匹配测试
-
-### 📊 变更统计
-
-- **新增代码**: ~500 行
-- **新增测试**: 30 个
-- **新增文档**: 476 行
-- **新增示例**: 325 行
-
----
-
-## [v1.0.0] - 2025-12-29
-
-### 🎉 初始发布
-
-#### 核心功能
-- ✅ **DSL 语法**: 简洁的字符串 DSL 定义 Schema
-  - `'string:3-32!'` - 字符串长度 3-32，必填
-  - `'number:0-100'` - 数字范围 0-100
-  - `'email!'` - 邮箱格式，必填
-  
-- ✅ **基础类型**: string, number, integer, boolean, object, array, null
-
-- ✅ **格式类型**: email, url, uuid, date, datetime, time, ipv4, ipv6, binary
-
-- ✅ **模式类型**: 
-  - objectId - MongoDB ObjectId
-  - hexColor - 十六进制颜色
-  - macAddress - MAC 地址
-  - cron - Cron 表达式
-  - phone - 手机号（支持多国）
-  - idCard - 身份证号
-  - creditCard - 信用卡号
-  - licensePlate - 车牌号
-  - postalCode - 邮政编码
-  - passport - 护照号
-
-- ✅ **验证功能**: 
-  - `validate(schema, data)` - 同步验证
-  - `validateAsync(schema, data)` - 异步验证
-
-- ✅ **错误格式化**: 友好的错误消息
-
-- ✅ **多语言支持**: zh-CN, en-US
-
-- ✅ **链式 API**: String 扩展，支持 `.label()`, `.messages()`, `.pattern()` 等
-
-- ✅ **SchemaUtils**: omit, pick, partial, extend 工具方法
-
-#### 文档和测试
-- ✅ **完整文档**: README, API 文档, 示例代码
-- ✅ **测试覆盖**: 447+ 测试用例，覆盖率 >90%
-
----
+**完整文档**: [docs/INDEX.md](./docs/INDEX.md)  
+**GitHub**: [https://github.com/vextjs/schema-dsl](https://github.com/vextjs/schema-dsl)  
+**npm**: [https://www.npmjs.com/package/schema-dsl](https://www.npmjs.com/package/schema-dsl)
 
-**更多历史版本信息请参考 Git 提交记录**