schema-dsl 1.2.5 → 2.0.1

package/STATUS.md

@@ -1,491 +0,0 @@
-# schema-dsl 项目状态
-
-> **最后更新**: 2026-03-03  
-> **当前版本**: v1.2.3  
-> **项目状态**: ✅ 全部完成，测试100%通过（1003个测试）  
-
----
-
-## 📋 目录
-
-- [v1.2.3](#v123) - 2026-03-03 ✅ 已完成
-- [v1.1.5](#v115) - 2026-01-17 ✅ 已完成
-- [v1.1.4](#v114) - 2026-01-13 ✅ 已完成
-- [v1.1.3](#v113) - 2026-01-09 ✅ 已完成
-- [v1.1.1](#v111) - 2026-01-06 ✅ 已完成
-- [v1.1.0](#v110) - 2026-01-05 ✅ 已完成
-- [v1.0.9](#v109) - 2026-01-04 ✅ 已完成
-- [v1.0.8](#v108) - 2026-01-04 ✅ 已完成
-- [v1.0.7](#v107) - 2026-01-04 ✅ 已完成
-- [v1.0.6](#v106) - 2026-01-04 ✅ 已完成
-- [v1.0.5](#v105) - 2026-01-04 ✅ 已完成
-- [v1.0.4](#v104) - 2025-12-31 ✅ 已完成
-- [v1.0.3](#v103) - 2025-12-31 ⚠️ 破坏性变更
-- [v1.0.2](#v102) - 2025-12-31 ✅ 已完成
-- [v1.0.1](#v101) - 2025-12-31 ✅ 已完成
-- [v1.0.0](#v100) - 2025-12-29 ✅ 已完成
-
----
-
-## 版本发布计划
-
-### v1.2.3
-
-**发布日期**: 2026-03-03  
-**状态**: ✅ 已完成  
-**类型**: 🚀 功能增强 + 🐛 Bug修复  
-**进度**: 100%完成 | 测试: 1003个通过 (100%)
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| i18n 子目录递归扫描 | ✅ 完成 | P0 | index.js `loadLocalesFromDir` |
-| 同名 key 冲突检测（WARN + strict 模式）| ✅ 完成 | P1 | index.js |
-| 语言文件名格式校验 | ✅ 完成 | P1 | index.js |
-| localesPath 对象用法修复 | ✅ 完成 | P1 | index.js |
-| TypeScript 类型扩展（I18nConfig + strict）| ✅ 完成 | P0 | index.d.ts |
-| 新增单元测试（20个） | ✅ 完成 | P0 | test/unit/i18n-subdir.test.js |
-| 修复跨文件测试状态污染（3个 failing → 0）| ✅ 完成 | P0 | test/unit/i18n-subdir.test.js |
-| 更新文档 | ✅ 完成 | P1 | docs/add-custom-locale.md |
-| 更新 CHANGELOG | ✅ 完成 | P0 | changelogs/v1.2.3.md |
-| 更新 STATUS | ✅ 完成 | P0 | STATUS.md |
-
-**向后兼容性**: ✅ 100% 向后兼容
-
----
-
-### v1.1.5
-
-**发布日期**: 2026-01-17  
-**状态**: ✅ 已完成  
-**类型**: 🚀 功能增强 - 错误配置对象格式支持  
-**进度**: 100%完成 | 测试: 955个通过 (100%)
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| 实现 Locale.getMessage 对象格式支持 | ✅ 完成 | P0 | lib/core/Locale.js |
-| 修改 I18nError 构造函数支持对象格式 | ✅ 完成 | P0 | lib/errors/I18nError.js |
-| 新增 originalKey 字段 | ✅ 完成 | P0 | I18nError 类 |
-| 更新 TypeScript 类型定义 | ✅ 完成 | P0 | index.d.ts |
-| 更新语言包示例（对象格式） | ✅ 完成 | P1 | lib/locales/*.js |
-| 新增测试用例（6个） | ✅ 完成 | P0 | test/unit/i18n-error.test.js |
-| 更新现有测试适配对象格式 | ✅ 完成 | P0 | test/unit/*.test.js |
-| 更新 CHANGELOG | ✅ 完成 | P0 | v1.1.5 变更记录 |
-| 更新 STATUS | ✅ 完成 | P0 | 版本号和状态 |
-
-**实现状态统计**:
-- ✅ 完成: 9个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ✨ 语言包支持对象格式 `{ code, message }`
-- ✨ I18nError 新增 `originalKey` 字段
-- ✨ 多语言共享相同的 `code`
-- ✅ 完全向后兼容，字符串格式自动转换
-- ✅ `error.is()` 同时支持 code 和 originalKey 判断
-
-**向后兼容性**: ✅ 100% 向后兼容
-
-### v1.1.4
-
-**发布日期**: 2026-01-13  
-**状态**: ✅ 已完成  
-**类型**: 🔧 TypeScript类型修复 + 📚 文档完善  
-**进度**: 100%完成 | 测试: 921个通过
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| 修复 dsl.error.assert 重复签名 | ✅ 完成 | P0 | index.d.ts L1336-1343 |
-| 修复 I18nError.assert 重复签名 | ✅ 完成 | P0 | index.d.ts L1805-1821 |
-| 完善运行时多语言文档 | ✅ 完成 | P1 | docs/runtime-locale-support.md |
-| 更新 README.md | ✅ 完成 | P1 | 添加运行时语言支持示例 |
-| 生成深度分析报告 | ✅ 完成 | P2 | reports/schema-dsl/analysis/ |
-| 更新 CHANGELOG | ✅ 完成 | P0 | v1.1.4 变更记录 |
-| 更新 STATUS | ✅ 完成 | P0 | 版本号和状态 |
-
-**实现状态统计**:
-- ✅ 完成: 7个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ✅ **修复**: index.d.ts 中2处重复函数签名（46个类型错误→0个错误）
-- ✅ **文档**: 完善运行时多语言支持文档
-- ✅ **文档**: README.md 添加运行时语言指定示例
-- ✅ **验证**: string? 可选语法完整支持
-- ✅ **验证**: 多语言加载机制验证
-
----
-
-### v1.1.3
-
-**发布日期**: 2026-01-09  
-**状态**: ✅ 已完成  
-**类型**: 🐛 Bug修复 - 类型错误消息模板变量未替换  
-**进度**: 100%完成 | 测试: 921个通过
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| 修复类型错误消息模板 | ✅ 完成 | P0 | `{{#actual}}` 变量未替换 |
-| 添加 actual 参数计算 | ✅ 完成 | P0 | 正确显示实际数据类型 |
-| 更新 CHANGELOG | ✅ 完成 | P0 | v1.1.3 变更记录 |
-| 更新 STATUS | ✅ 完成 | P0 | 版本号和状态 |
-
-**实现状态统计**:
-- ✅ 完成: 4个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ✅ **修复**: ErrorFormatter.formatDetailed() 添加 `actual` 参数
-- ✅ **修复**: 类型错误消息正确显示实际数据类型
-- ✅ **支持**: `number`, `string`, `boolean`, `object`, `array`, `null`, `undefined`
-
-**Bug 详情**:
-- **问题**: `{{#actual}}` 模板变量未被替换
-- **原因**: `interpolateData` 缺少 `actual` 参数
-- **修复**: 添加类型计算逻辑（第 280-284 行）
-- **影响**: 仅影响错误消息显示，不影响验证逻辑
-
----
-
-### v1.1.1
-
-**发布日期**: 2026-01-06  
-**状态**: ✅ 已完成  
-**类型**: 🎉 新功能 - ConditionalBuilder 独立消息 + I18nError 多语言错误  
-**进度**: 100%完成 | 测试: 921个通过 | 新增: 52个测试
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| ConditionalBuilder 独立消息 | ✅ 完成 | P1 | `.and()/.or()` 后可调用 `.message()` |
-| I18nError 多语言错误 | ✅ 完成 | P1 | 统一的多语言错误抛出机制 |
-| dsl.error 快捷方法 | ✅ 完成 | P1 | create/throw/assert 三个方法 |
-| TypeScript 类型定义 | ✅ 完成 | P0 | I18nError + dsl.error 类型 |
-| 测试用例 | ✅ 完成 | P0 | 52个新测试（24+28） |
-| 文档更新 | ✅ 完成 | P0 | README + CHANGELOG + examples |
-| 语言包扩充 | ✅ 完成 | P1 | 中英文 20+ 错误消息 |
-
-**实现状态统计**:
-- ✅ 完成: 7个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ✅ **新增**: ConditionalBuilder 支持 `.and()/.or()` 独立消息
-- ✅ **新增**: I18nError 类 (lib/errors/I18nError.js)
-- ✅ **新增**: dsl.error 快捷方法 (create/throw/assert)
-- ✅ **新增**: 20+ 内置错误代码（通用/账户/用户/订单）
-- ✅ **新增**: examples/i18n-error.examples.js 示例文件
-- ✅ **更新**: README FAQ Q7/Q8
-- ✅ **更新**: CHANGELOG v1.1.1 完整记录
-- ✅ **更新**: index.d.ts TypeScript 类型定义
-
----
-
-### v1.1.0
-
-**发布日期**: 2026-01-05  
-**状态**: ✅ 已完成  
-**类型**: 🎉 重大功能 - 跨类型联合验证 + 插件系统增强  
-**进度**: 100%完成
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| 跨类型联合验证 | ✅ 完成 | P1 | `types:string|number` 语法 |
-| 插件 DSL 类型注册 | ✅ 完成 | P1 | 插件可注册自定义 DSL 类型 |
-| DslBuilder.registerType | ✅ 完成 | P0 | 静态方法供插件使用 |
-| 文档更新 | ✅ 完成 | P0 | README + CHANGELOG |
-
-**实现状态统计**:
-- ✅ 完成: 4个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ✅ **新增**: `types:` 语法支持跨类型联合验证
-- ✅ **增强**: 插件系统支持 DSL 类型注册
-- ✅ **新增**: DslBuilder.registerType() 静态方法
-
----
-
-### v1.0.9
-
-**发布日期**: 2026-01-04  
-**状态**: ✅ 已完成  
-**类型**: 📝 文档完善 + 性能验证  
-**进度**: 100%完成 | 优化: 多语言文档 | 性能: 2,879,606 ops/s
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| 多语言文档统一 | ✅ 完成 | P0 | "首次加载，运行时切换" |
-| 添加文档导航 | ✅ 完成 | P1 | i18n.md 导航指引 |
-| 性能数据更新 | ✅ 完成 | P0 | 更新到 2,879,606 ops/s |
-| README 更新 | ✅ 完成 | P0 | 性能+多语言章节 |
-| CHANGELOG 更新 | ✅ 完成 | P0 | 添加 v1.0.9 记录 |
-| 配置示例修复 | ✅ 完成 | P0 | i18n-user-guide.md |
-
-**实现状态统计**:
-- ✅ 完成: 6个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ✅ **优化**: 统一多语言文档描述（5个文档）
-- ✅ **新增**: 文档导航（i18n.md）
-- ✅ **更新**: 性能对比数据（提升3.19倍）
-- ✅ **修复**: i18n-user-guide.md 配置错误
-- ✅ **更新**: README.md 和 CHANGELOG.md
-
-**用户价值**:
-- 🎯 文档更清晰，用户快速找到所需信息
-- 🎯 性能数据更新，证明库的卓越性能
-
----
-
-### v1.0.8
-
-**发布日期**: 2026-01-04  
-**状态**: ✅ 已完成  
-**类型**: 🔧 错误消息过滤增强  
-
----
-
-### v1.0.7
-
-**发布日期**: 2026-01-04  
-**状态**: ✅ 已完成  
-**类型**: 🐛 嵌套支持修复  
-
----
-
-### v1.0.6
-
-**发布日期**: 2026-01-04  
-**状态**: ✅ 已完成  
-**类型**: 🚨 TypeScript 类型污染修复  
-
----
-
-### v1.0.5
-
-**发布日期**: 2026-01-04  
-**状态**: ✅ 已完成  
-**类型**: ✅ 测试覆盖率提升  
-
----
-
-### v1.0.4
-
-**发布日期**: 2025-12-31  
-**状态**: ✅ 已完成  
-**类型**: ✨ 功能增强（TypeScript 完整支持）  
-**进度**: 100%完成 | 新增: TypeScript 类型定义、使用指南 | 文档: 1500+ 行
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| 完善 index.d.ts | ✅ 完成 | P0 | validateAsync、ValidationError 类型 |
-| String 扩展 TS 说明 | ✅ 完成 | P0 | 添加详细使用说明和对比 |
-| TypeScript 使用指南 | ✅ 完成 | P0 | 1000+ 行完整文档 |
-| README 更新 | ✅ 完成 | P0 | 添加 TypeScript 章节 |
-| 类型错误修复 | ✅ 完成 | P0 | 修复 dsl.config i18n 类型 |
-| 发版文档更新 | ✅ 完成 | P0 | CHANGELOG、STATUS、package.json |
-
-**实现状态统计**:
-- ✅ 完成: 6个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ✅ **新增**: validateAsync 函数完整类型定义
-- ✅ **新增**: ValidationError 类完整类型（含所有方法）
-- ✅ **优化**: String 扩展添加 TypeScript 使用说明
-- ✅ **新增**: TypeScript 使用指南文档（1000+ 行）
-- ✅ **修复**: dsl.config 的 i18n 参数类型错误
-- ✅ **文档**: README 添加 TypeScript 快速开始章节
-
-**用户价值**:
-- 🎯 TypeScript 用户获得完整的类型安全和 IDE 提示
-- 🎯 详细的文档指导如何在 TypeScript 中正确使用
-- 🎯 JavaScript 用户体验不变，100% 向后兼容
-- 🎯 降低学习成本，提高开发效率
-
----
-
-### v1.0.3
-
-**发布日期**: 2025-12-31  
-**状态**: ✅ 已完成  
-**类型**: ⚠️ 破坏性变更  
-**进度**: 100%完成 | 修复: String单值语法 | 测试: 3个新增测试
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| String单值语法修复 | ✅ 完成 | P0 | 'string:N' 改为精确长度 |
-| 核心代码修改 | ✅ 完成 | P0 | DslBuilder.js |
-| 测试用例更新 | ✅ 完成 | P0 | 2个修改 + 1个新增 |
-| 文档更新 | ✅ 完成 | P0 | README + CHANGELOG |
-| 迁移指南 | ✅ 完成 | P0 | CHANGELOG 破坏性变更说明 |
-| 新增链式方法 | ✅ 完成 | P1 | dateGreater, dateLess |
-
-**实现状态统计**:
-- ✅ 完成: 6个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心变更**:
-- ⚠️ **破坏性**: `'string:N'` → exactLength: N（之前是 maxLength: N）
-- ✅ **新增**: `'string:-N'` → maxLength: N（明确语法）
-- ✅ **保持**: Number 单值仍为 maximum（无变更）
-- ✅ **新增**: dateGreater() 和 dateLess() 链式方法
-
----
-
-### v1.0.2
-
-**发布日期**: 2025-12-31  
-**状态**: ✅ 已完成  
-**进度**: 100%完成 | 新增: 15个验证器 | 测试: 75个新增测试
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| String验证器扩展 | ✅ 完成 | P1 | 6个新增验证器 |
-| Number验证器扩展 | ✅ 完成 | P1 | 2个新增验证器 |
-| Object验证器扩展 | ✅ 完成 | P1 | 2个新增验证器 |
-| Array验证器扩展 | ✅ 完成 | P1 | 2个新增验证器 |
-| Date验证器扩展 | ✅ 完成 | P1 | 3个新增验证器 |
-| 多语言支持 | ✅ 完成 | P0 | 中英文19个消息 |
-| 文档补充 | ✅ 完成 | P0 | 15个验证器文档 |
-| 示例代码 | ⏳ 待完成 | P1 | 演示新增功能 |
-| 单元测试 | ✅ 完成 | P0 | 75个测试用例 |
-
-**实现状态统计**:
-- ✅ 完成: 8个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 1个
-
-**核心功能**:
-- ✨ **String验证器**: exactLength, alphanum, trim, lowercase, uppercase, jsonString
-- 🔢 **Number验证器**: precision, port
-- 📦 **Object验证器**: requiredAll, strictSchema
-- 📋 **Array验证器**: noSparse, includesRequired
-- 📅 **Date验证器**: dateFormat, dateGreater, dateLess
-- 🌍 **多语言支持**: 中英文各19个新增消息
-- 📝 **完整文档**: validation-rules-v1.0.2.md（1200行）
-- 🧪 **测试覆盖**: 75个测试用例，100%通过
-
-### v1.0.1
-
-**发布日期**: 2025-12-31  
-**状态**: ✅ 已完成  
-**进度**: 100%完成 | 新增: 枚举功能 | 测试: 30个新增测试
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| 枚举语法支持 | ✅ 完成 | P0 | value1\|value2 简写语法 |
-| 枚举类型自动识别 | ✅ 完成 | P0 | 字符串/布尔值/数字自动识别 |
-| 枚举显式类型 | ✅ 完成 | P1 | enum:type:values 语法 |
-| 布尔值枚举 | ✅ 完成 | P0 | true\|false 自动识别 |
-| 数字枚举 | ✅ 完成 | P0 | 1\|2\|3 自动识别 |
-| 整数枚举 | ✅ 完成 | P1 | enum:integer:values |
-| 枚举必填标记 | ✅ 完成 | P0 | value1\|value2! |
-| 枚举错误消息 | ✅ 完成 | P0 | 统一使用 'enum' 键 |
-| 枚举文档 | ✅ 完成 | P0 | docs/enum.md 完整文档 |
-| 枚举示例 | ✅ 完成 | P1 | examples/enum.examples.js |
-| 枚举测试 | ✅ 完成 | P0 | 30个测试用例 |
-
-**实现状态统计**:
-- ✅ 完成: 11个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心功能**:
-- ✨ **枚举支持**: 'active|inactive', '1|2|3', 'true|false' 自动识别类型
-- 🎯 **简洁语法**: 统一使用 'enum' 键定义错误消息
-- 🔧 **灵活配置**: 支持显式指定类型 enum:type:values
-
-### v1.0.0
-
-**发布日期**: 2025-12-29  
-**状态**: ✅ 已完成  
-**进度**: 100%完成 | 测试: 447/447 passing (100%) | 覆盖率: >90%
-
-| 需求标题 | 状态 | 优先级 | 详细 |
-|---------|------|--------|------|
-| JSON Schema核心类实现 | ✅ 完成 | P0 | JSONSchemaCore.js |
-| ajv验证器集成 | ✅ 完成 | P0 | Validator.js |
-| DSL风格适配器 | ✅ 完成 | P0 | DslAdapter.js |
-| MongoDB导出器 | ✅ 完成 | P0 | MongoDBExporter.js |
-| MySQL导出器 | ✅ 完成 | P1 | MySQLExporter.js |
-| PostgreSQL导出器 | ✅ 完成 | P1 | PostgreSQLExporter.js |
-| 自定义验证扩展 | ✅ 完成 | P1 | CustomKeywords.js |
-| 类型转换工具 | ✅ 完成 | P1 | TypeConverter.js |
-| Schema辅助函数 | ✅ 完成 | P2 | SchemaHelper.js |
-| SchemaUtils工具 | ✅ 完成 | P1 | 4个核心方法: omit/pick/partial/extend |
-| String扩展 | ✅ 完成 | P1 | 字符串链式调用 |
-| validateAsync | ✅ 完成 | P1 | 异步验证方法 |
-| 多语言支持 | ✅ 完成 | P1 | i18n配置和语言包 |
-| 缓存优化 | ✅ 完成 | P1 | Schema和正则缓存 |
-| 完整文档 | ✅ 完成 | P0 | 纯使用指南 |
-| 示例代码 | ✅ 完成 | P1 | Express集成等 |
-| 单元测试 | ✅ 完成 | P0 | 447个测试 |
-
-**实现状态统计**:
-- ✅ 完成: 17个
-- 🔄 进行中: 0个
-- ⏳ 待完成: 0个
-
-**核心功能**:
-- ✨ **DSL语法**: 简洁的字符串DSL，如 `'string:1-50!'`, `'email!'`
-- 🔗 **String扩展**: 字符串直接链式调用，如 `'string!'.pattern(/.../).label('名称')`
-- 🛠️ **SchemaUtils**: 4个核心方法复用Schema（omit/pick/partial/extend）
-- ⚡ **validateAsync**: 异步验证，失败自动抛出错误
-- 🌍 **多语言**: i18n配置，支持自定义语言包
-- 📤 **多数据库导出**: MongoDB, MySQL, PostgreSQL
-
-**重大改进**:
-- 🎉 **简化设计**: SchemaUtils 只保留4个核心方法，覆盖95%场景
-- 📚 **用户友好**: 所有文档纯使用指南，无过度分析
-- ✅ **质量保证**: 447个测试100%通过，三轮验证全部通过
-- 🚀 **性能优化**: Schema缓存和正则缓存，大型项目性能提升3-10倍
-
-**测试数据**:
-- 单元测试: 447个全部通过 ✅
-- 测试时间: 8秒
-- 覆盖率: >90%
-- 文档示例: 45个全部可执行 ✅
-
----
-
-## 需求状态说明
-
-- ✅ **完成**: 功能已实现并验证
-- ⏳ **待完成**: 计划中，待实施
-- 🔄 **进行中**: 正在开发
-- ❌ **未开始**: 尚未开始
-- 🔴 **阻塞**: 存在阻塞问题
-
----
-
-## 进度对比
-
-| 版本 | 开始日期 | 完成日期 | 计划需求 | 完成需求 | 完成率 |
-|------|---------|---------|---------|---------|--------|
-| v1.0.0 | 2025-12-24 | 2025-12-24 | 15 | 13 | 87% |
-
----
-
-## 关键里程碑
-
-- [x] 2025-12-24: 架构设计完成（适配器模式）
-- [x] 2025-12-24: 核心层实现完成
-- [x] 2025-12-24: 适配器层实现完成
-- [x] 2025-12-24: 导出器层实现完成
-- [x] 2025-12-24: DSL语法验证通过
-- [x] 2025-12-24: README文档完成
-- [ ] 待定: 测试套件完成（目标覆盖率80%+）
-- [ ] 待定: v1.0.0正式版发布
-
----
-
-**项目总体状态**: ✅ 核心功能已完成，具备发布条件