schema-dsl 1.1.3 → 1.1.4

package/changelogs/v1.1.2.md

@@ -0,0 +1,183 @@
+# 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

@@ -0,0 +1,161 @@
+# 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
+