schema-dsl 1.2.2 → 1.2.4

package/index.js

@@ -110,12 +110,83 @@ dsl.error = {
   assert: (condition, code, paramsOrLocale, statusCode, locale) => I18nError.assert(condition, code, paramsOrLocale, statusCode, locale)
 };
 
+/**
+ * 从目录递归加载语言包（内部函数）
+ *
+ * 支持子目录递归扫描，子目录名作为模块组织层（不影响语言 key）。
+ * 同名 key 冲突时：strict 模式抛错，默认模式打 WARN 日志。
+ *
+ * @param {string} dirPath - 目录绝对路径
+ * @param {Object} options - 配置选项
+ * @param {boolean} [options.strict=false] - 严格模式：同名 key 冲突时抛出 Error
+ * @private
+ */
+function loadLocalesFromDir(dirPath, options = {}) {
+  const fs = require('fs');
+  const path = require('path');
+
+  if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) {
+    console.warn('[schema-dsl] i18n path does not exist or is not a directory:', dirPath);
+    return;
+  }
+
+  // 语言代码格式校验：zh-CN / en-US / zh / en 等
+  const LOCALE_NAME_RE = /^[a-z]{2,3}(-[A-Z]{2,4})?$/;
+
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+
+  entries.forEach(entry => {
+    const fullPath = path.join(dirPath, entry.name);
+
+    if (entry.isDirectory()) {
+      // 递归进入子目录（子目录名仅作模块组织层，不影响语言 key）
+      loadLocalesFromDir(fullPath, options);
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name);
+      if (ext !== '.js' && ext !== '.json') return;
+
+      const localeName = path.basename(entry.name, ext);
+
+      // 文件名格式校验：只加载符合语言代码格式的文件
+      if (!LOCALE_NAME_RE.test(localeName)) {
+        // 仅 debug 级别，不影响正常运行
+        return;
+      }
+
+      let messages;
+      try {
+        messages = require(path.resolve(fullPath));
+      } catch (e) {
+        console.warn('[schema-dsl] Failed to load locale file:', fullPath, e.message);
+        return;
+      }
+
+      // 冲突检测：检查 messages 的每个 key 是否已存在于当前语言包
+      const existing = Locale.locales[localeName] || {};
+      const conflictKeys = Object.keys(messages).filter(k => Object.prototype.hasOwnProperty.call(existing, k));
+
+      if (conflictKeys.length > 0) {
+        const keyList = conflictKeys.join(', ');
+        const msg = `[schema-dsl] i18n key 冲突 in locale '${localeName}'\n  冲突 key: ${keyList}\n  来源文件: ${fullPath}`;
+        if (options.strict) {
+          throw new Error(msg);
+        } else {
+          console.warn(msg);
+        }
+      }
+
+      Locale.addLocale(localeName, messages);
+    }
+  });
+}
+
 /**
  * 全局配置
  * @param {Object} options - 配置选项
  * @param {Object} options.patterns - 验证规则扩展 (phone, idCard, creditCard)
- * @param {string|Object} options.i18n - 多语言配置（目录路径或语言包对象）
+ * @param {string|Object} options.i18n - 多语言配置（目录路径、对象语言包、或含 localesPath 的对象）
  * @param {Object} options.cache - 缓存配置
+ * @param {boolean} [options.strict=false] - 严格模式：i18n 目录扫描时 key 冲突直接抛错（默认 false）
  */
 dsl.config = function (options = {}) {
   const patterns = require('./lib/config/patterns');
@@ -127,31 +198,24 @@ dsl.config = function (options = {}) {
     if (options.patterns.creditCard) Object.assign(patterns.creditCard, options.patterns.creditCard);
   }
 
-  // 多语言支持 (v1.0.1 优化)
+  // 多语言支持 (v1.0.1 优化；v1.2.3 增强：递归子目录 + 冲突检测)
   if (options.i18n) {
-    // 方式 1: 传入目录路径（字符串）
+    // 方式 1: 传入目录路径（字符串）→ 递归扫描
     if (typeof options.i18n === 'string') {
-      const fs = require('fs');
-      const path = require('path');
-
-      if (fs.existsSync(options.i18n) && fs.statSync(options.i18n).isDirectory()) {
-        const files = fs.readdirSync(options.i18n);
-        files.forEach(file => {
-          if (file.endsWith('.js') || file.endsWith('.json')) {
-            const localeName = path.basename(file, path.extname(file));
-            const messages = require(path.resolve(options.i18n, file));
-            Locale.addLocale(localeName, messages);
-          }
-        });
-      } else {
-        console.warn('[schema-dsl] i18n path does not exist:', options.i18n);
-      }
+      loadLocalesFromDir(options.i18n, options);
     }
-    // 方式 2: 直接传入对象
+    // 方式 2: 传入对象
     else if (typeof options.i18n === 'object') {
-      Object.keys(options.i18n).forEach(locale => {
-        Locale.addLocale(locale, options.i18n[locale]);
-      });
+      // 方式 2a: 含 localesPath 字段 → 走目录扫描（兼容文档记载用法）
+      if (options.i18n.localesPath) {
+        loadLocalesFromDir(options.i18n.localesPath, options);
+      }
+      // 方式 2b: 直接传语言包对象 { 'zh-CN': {...}, 'en-US': {...} }（原有逻辑，不变）
+      else {
+        Object.keys(options.i18n).forEach(locale => {
+          Locale.addLocale(locale, options.i18n[locale]);
+        });
+      }
     }
   }
 
@@ -348,7 +412,6 @@ module.exports = {
   // 核心类
   JSONSchemaCore,
   Validator,
-  DslBuilder,                  // v1.1.0 新增：导出DslBuilder供插件使用
 
   // 便捷方法（推荐）
   validate,                    // 便捷验证（单例）
@@ -388,7 +451,7 @@ module.exports = {
   CONSTANTS,
 
   // 版本信息
-  VERSION: '1.0.4'
+  VERSION: '1.2.3'
 };
 
 

package/index.mjs

@@ -1,30 +1,60 @@
 import schemaDsl from './index.js';
 
 export const {
+  // 统一DSL API
   dsl,
-  validate,
-  getDefaultValidator,
+  DslBuilder,
+
+  // 配置函数 (v1.0.4+)
+  config,
+
+  // String 扩展控制
+  installStringExtensions,
+  uninstallStringExtensions,
+
+  // 核心类
   JSONSchemaCore,
   Validator,
+
+  // 便捷方法（推荐）
+  validate,
+  validateAsync,
+  getDefaultValidator,
   ErrorFormatter,
   CacheManager,
-  DslBuilder,
+
+  // 错误类 (v2.1.0 新增)
+  ValidationError,
+  I18nError,
+
+  // 错误消息系统
   ErrorCodes,
   MessageTemplate,
   Locale,
+
+  // 插件系统 (v2.2.0 新增)
+  PluginManager,
+
+  // 导出器
   exporters,
   MongoDBExporter,
   MySQLExporter,
   PostgreSQLExporter,
+  MarkdownExporter,
+
+  // 工具函数
   TypeConverter,
   SchemaHelper,
   SchemaUtils,
+
+  // 验证器扩展
   CustomKeywords,
+
+  // 常量
   CONSTANTS,
-  VERSION,
-  installStringExtensions,
-  uninstallStringExtensions
-} = schema-dsl;
 
-export default schemaDsl;
+  // 版本信息
+  VERSION
+} = schemaDsl;
 
+export default dsl;

package/package.json

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