schema-dsl 1.1.2 → 1.1.4

package/lib/core/DslBuilder.js

@@ -123,11 +123,20 @@ class DslBuilder {
       processedDsl = trimmed.replace(/^array!/, 'array:') + '!';
     }
 
+    // 🔴 处理必填标记 ! 和可选标记 ?
+    // 优先级：! > ?（如果同时存在，! 优先）
     this._required = processedDsl.endsWith('!');
-    const dslWithoutRequired = this._required ? processedDsl.slice(0, -1) : processedDsl;
+    this._optional = processedDsl.endsWith('?') && !this._required;
+
+    let dslWithoutMarker = processedDsl;
+    if (this._required) {
+      dslWithoutMarker = processedDsl.slice(0, -1);
+    } else if (this._optional) {
+      dslWithoutMarker = processedDsl.slice(0, -1);
+    }
 
     // 简单解析为基础Schema（避免循环依赖）
-    this._baseSchema = this._parseSimple(dslWithoutRequired);
+    this._baseSchema = this._parseSimple(dslWithoutMarker);
 
     // 扩展属性
     this._customMessages = {};

package/lib/core/ErrorFormatter.js

@@ -277,7 +277,12 @@ class ErrorFormatter {
         // 映射 min/max 以匹配模板
         min: limit,
         max: limit,
-        expected: err.params ? err.params.type : undefined
+        expected: err.params ? err.params.type : undefined,
+        // ✅ 修复：添加 actual 参数 - 实际接收到的数据类型
+        actual: err.data === null ? 'null' :
+                err.data === undefined ? 'undefined' :
+                Array.isArray(err.data) ? 'array' :
+                typeof err.data
       };
 
       message = this._interpolate(message, interpolateData);

package/lib/errors/I18nError.js

@@ -95,6 +95,7 @@ class I18nError extends Error {
    * @param {string} code - 错误代码（多语言 key）
    * @param {Object} params - 错误参数
    * @param {number} statusCode - HTTP 状态码
+   * @param {string} locale - 语言环境（可选，不传则使用全局语言）
    * @returns {I18nError} 错误实例
    *
    * @example
@@ -104,9 +105,13 @@ class I18nError extends Error {
    * @example
    * // 直接抛出
    * throw I18nError.create('error.notFound', { resource: '用户' });
+   *
+   * @example
+   * // 运行时指定语言
+   * const error = I18nError.create('error.notFound', {}, 404, 'en-US');
    */
-  static create(code, params = {}, statusCode = 400) {
-    return new I18nError(code, params, statusCode);
+  static create(code, params = {}, statusCode = 400, locale = null) {
+    return new I18nError(code, params, statusCode, locale);
   }
 
   /**
@@ -115,14 +120,19 @@ class I18nError extends Error {
    * @param {string} code - 错误代码（多语言 key）
    * @param {Object} params - 错误参数
    * @param {number} statusCode - HTTP 状态码
+   * @param {string} locale - 语言环境（可选，不传则使用全局语言）
    * @throws {I18nError} 直接抛出错误
    *
    * @example
    * I18nError.throw('error.notFound', { resource: '用户' });
    * // 等同于：throw I18nError.create('error.notFound', { resource: '用户' });
+   *
+   * @example
+   * // 运行时指定语言
+   * I18nError.throw('error.notFound', {}, 404, 'en-US');
    */
-  static throw(code, params = {}, statusCode = 400) {
-    throw new I18nError(code, params, statusCode);
+  static throw(code, params = {}, statusCode = 400, locale = null) {
+    throw new I18nError(code, params, statusCode, locale);
   }
 
   /**
@@ -132,6 +142,7 @@ class I18nError extends Error {
    * @param {string} code - 错误代码（多语言 key）
    * @param {Object} params - 错误参数
    * @param {number} statusCode - HTTP 状态码
+   * @param {string} locale - 语言环境（可选，不传则使用全局语言）
    * @throws {I18nError} 条件为 false 时抛出错误
    *
    * @example
@@ -144,10 +155,14 @@ class I18nError extends Error {
    *   'account.insufficientBalance',
    *   { balance: account.balance, required: 100 }
    * );
+   *
+   * @example
+   * // 运行时指定语言
+   * I18nError.assert(account, 'account.notFound', {}, 404, 'en-US');
    */
-  static assert(condition, code, params = {}, statusCode = 400) {
+  static assert(condition, code, params = {}, statusCode = 400, locale = null) {
     if (!condition) {
-      throw new I18nError(code, params, statusCode);
+      throw new I18nError(code, params, statusCode, locale);
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schema-dsl",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "简洁强大的JSON Schema验证库 - DSL语法 + String扩展 + 便捷validate",
   "main": "index.js",
   "types": "index.d.ts",