schema-dsl 1.2.4 → 2.0.0

package/changelogs/v1.1.2.md

@@ -1,183 +0,0 @@
-# v1.1.2 变更日志
-
-> **发布日期**: 2026-01-06  
-> **版本号**: v1.1.2  
-> **类型**: 🎉 新功能
-
----
-
-## 📋 变更概览
-
-| 类型 | 数量 | 说明 |
-|------|------|------|
-| 🎉 新功能 | 1 | 数字比较运算符 |
-| 🐛 Bug修复 | 若干 | 小问题修复 |
-
----
-
-## 🎉 新功能
-
-### 数字比较运算符 - 更直观的数值验证
-
-**新增 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` | **比较运算符**（精确匹配） |
-| 18 ≤ x ≤ 100 | `number:18-100` | - | **范围语法**（更简洁） |
-
-#### 实际应用场景
-
-**场景1：用户注册 - 年龄限制**
-```javascript
-const schema = dsl({
-  username: 'string:3-32!',
-  email: 'email!',
-  age: 'number:>=18!',  // 必须年满18岁
-  password: 'string:8-!'
-});
-```
-
-**场景2：电商系统 - 价格验证**
-```javascript
-const schema = dsl({
-  productName: 'string:1-100!',
-  price: 'number:>0!',      // 价格必须大于0
-  discount: 'number:0-100'  // 折扣 0-100
-});
-```
-
-**场景3：温度监控 - 范围告警**
-```javascript
-const schema = dsl({
-  temperature: 'number:<100',  // 温度不能达到100度
-  humidity: 'number:>=30'      // 湿度至少30%
-});
-```
-
-**场景4：评分系统 - 精确值**
-```javascript
-const schema = dsl({
-  rating: 'number:=5',  // 五星好评
-  stars: 'integer:1-5'  // 1-5星
-});
-```
-
----
-
-## 🐛 Bug 修复
-
-- ✅ 修复边界值判断的边缘情况
-- ✅ 修复错误消息模板中的参数传递
-- ✅ 优化数字类型的性能
-
----
-
-## 📚 文档更新
-
-- ✅ 新增数字比较运算符文档
-- ✅ 更新类型参考文档
-- ✅ 添加实际场景示例
-
----
-
-## 🔄 破坏性变更
-
-**无破坏性变更** - 所有新功能都是向后兼容的。
-
----
-
-## 🎯 升级指南
-
-### 从 v1.1.1 升级到 v1.1.2
-
-```bash
-npm install schema-dsl@1.1.2
-```
-
-**可选：使用新的比较运算符**
-
-```javascript
-// 之前：使用范围语法
-const schema1 = dsl({ age: 'number:18-' });  // >=18
-
-// 现在：使用比较运算符（更清晰）
-const schema2 = dsl({ age: 'number:>=18' }); // >=18
-
-// 新功能：排除边界值
-const schema3 = dsl({ value: 'number:>0' }); // >0（不包括0）
-```
-
----
-
-## 📦 依赖变更
-
-**无依赖变更**
-
----
-
-## 🔗 相关链接
-
-- [GitHub Repository](https://github.com/vextjs/schema-dsl)
-- [npm Package](https://www.npmjs.com/package/schema-dsl)
-- [数字运算符文档](../docs/number-operators.md)
-
----
-
-**发布者**: schema-dsl Team  
-**发布时间**: 2026-01-06  
-**下一版本**: v1.1.3
-

package/changelogs/v1.1.3.md

@@ -1,161 +0,0 @@
-# v1.1.3 变更日志
-
-> **发布日期**: 2026-01-09  
-> **版本号**: v1.1.3  
-> **类型**: 🐛 Bug修复
-
----
-
-## 📋 变更概览
-
-| 类型 | 数量 | 说明 |
-|------|------|------|
-| 🐛 Bug修复 | 1 | 类型错误消息模板变量未替换 |
-
----
-
-## 🐛 Bug 修复
-
-### 类型验证错误消息模板变量未替换
-
-**问题描述**：
-当类型验证失败时，错误消息中的 `{{#actual}}` 模板变量没有被替换，导致错误消息显示不完整。
-
-**修复前**：
-```javascript
-const schema = dsl({ age: 'string!' });
-const result = validate(schema, { age: 25 });
-// ❌ 错误消息: "age should be string, got {{#actual}}"
-```
-
-**修复后**：
-```javascript
-const schema = dsl({ age: 'string!' });
-const result = validate(schema, { age: 25 });
-// ✅ 错误消息: "age should be string, got number"
-```
-
-**技术细节**：
-
-修复文件：`lib/core/ErrorFormatter.js` 第 280-284 行
-
-**修复前代码**：
-```javascript
-static formatDetailed(error, data, customMessages = {}, locale = 'en-US') {
-  // ... existing code ...
-  
-  // ❌ 缺少 actual 参数
-  const message = MessageTemplate.render(template, {
-    value: data,
-    min: error.params?.limit,
-    max: error.params?.limit,
-    // 缺少 actual 参数
-  });
-}
-```
-
-**修复后代码**：
-```javascript
-static formatDetailed(error, data, customMessages = {}, locale = 'en-US') {
-  // ... existing code ...
-  
-  // ✅ 添加 actual 参数计算逻辑
-  const actual = data === null ? 'null' 
-    : data === undefined ? 'undefined'
-    : Array.isArray(data) ? 'array'
-    : typeof data;
-  
-  const message = MessageTemplate.render(template, {
-    value: data,
-    min: error.params?.limit,
-    max: error.params?.limit,
-    actual: actual  // ✅ 添加 actual 参数
-  });
-}
-```
-
-**支持的数据类型**：
-- ✅ `number` - 数字类型
-- ✅ `string` - 字符串类型
-- ✅ `boolean` - 布尔类型
-- ✅ `object` - 对象类型
-- ✅ `array` - 数组类型
-- ✅ `null` - 空值
-- ✅ `undefined` - 未定义
-
----
-
-## 📊 影响范围
-
-### 影响的功能
-
-- ✅ **类型验证错误消息**: 正确显示实际数据类型
-- ✅ **多语言错误消息**: `{{#actual}}` 变量在所有语言中正确替换
-- ✅ **开发体验**: 错误消息更清晰，便于调试
-
-### 不影响的功能
-
-- ✅ **验证逻辑**: 验证功能本身不受影响
-- ✅ **其他错误消息**: 非类型验证的错误消息不受影响
-- ✅ **API接口**: 所有API保持不变
-
----
-
-## ✅ 向后兼容性
-
-- ✅ **无破坏性变更**: 完全向后兼容
-- ✅ **API不变**: 所有公开API保持不变
-- ✅ **配置不变**: 无需修改配置
-
----
-
-## 🎯 升级指南
-
-### 从 v1.1.2 升级到 v1.1.3
-
-**推荐操作**:
-```bash
-npm install schema-dsl@1.1.3
-```
-
-**无需修改代码**: 本次更新仅修复错误消息显示，不影响验证逻辑。
-
-**验证升级成功**:
-```javascript
-const { dsl, validate } = require('schema-dsl');
-
-// 测试类型验证错误消息
-const schema = dsl({ age: 'string!' });
-const result = validate(schema, { age: 25 });
-
-console.log(result.errors[0].message);
-// 应该输出: "age should be string, got number"
-// 而不是: "age should be string, got {{#actual}}"
-```
-
----
-
-## 📦 依赖变更
-
-**无依赖变更**
-
----
-
-## 🙏 致谢
-
-感谢 [monSQLize](https://github.com/zy410419243/monSQLize) 项目发现并报告此问题。
-
----
-
-## 🔗 相关链接
-
-- [GitHub Repository](https://github.com/vextjs/schema-dsl)
-- [npm Package](https://www.npmjs.com/package/schema-dsl)
-- [Issue #XXX](https://github.com/vextjs/schema-dsl/issues/XXX) - 相关Issue
-
----
-
-**发布者**: schema-dsl Team  
-**发布时间**: 2026-01-09  
-**下一版本**: v1.1.4
-