schema-dsl 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -11,6 +11,7 @@
 
 | 版本               | 日期 | 变更摘要 | 详细 |
 |------------------|------|---------|------|
+| [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) |
@@ -26,6 +27,178 @@
 
 ---
 
+## [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.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`）不受影响
+- 完全向后兼容
+
+---
+
+### 📚 文档更新
+
+- 新增 [数字比较运算符文档](./docs/number-operators.md)
+- 更新 README.md 添加比较运算符示例
+- 更新 index.d.ts 添加比较运算符类型注释
+- 新增 28 个比较运算符单元测试
+
+---
+
+### 🧪 测试
+
+- **新增测试**：28 个比较运算符测试用例
+- **测试总数**：949 个（921 + 28）
+- **测试覆盖**：100% 通过
+- **测试文件**：`test/unit/number-operators.test.js`
+
+---
+
+### 📊 变更统计
+
+- **新增功能**：1 个（数字比较运算符）
+- **Bug 修复**：1 个（比较运算符误解析）
+- **文档更新**：3 个（README, docs/number-operators.md, index.d.ts）
+- **测试新增**：28 个
+- **代码变更**：2 个文件（lib/core/DslBuilder.js, lib/adapters/DslAdapter.js）
+
+---
+
 ## [v1.1.1] - 2026-01-06
 
 ### 🎉 新功能