@geekron/strapi 0.2.7 → 0.2.9

package/i18n/translations/index.ts

@@ -1,53 +1,233 @@
-// 通用翻译加载器
-const loadTranslations = (locale: string) => {
-  // @ts-ignore
-  // 一次性导入所有语言目录下的所有 JSON 文件（静态 glob 模式）
-  const allModules = import.meta.glob('./*/**/*.json', { eager: true, import: 'default' });
-
-  const handlePrefix = (translations: Record<string, any>, prefix: string) => {
-    return Object.keys(translations).reduce((acc, key) => {
-      acc[`${prefix}.${key}`] = translations[key];
-      return acc;
-    }, {} as Record<string, any>);
-  };
-
-  // 处理动态导入的模块
-  const processModules = (modules: Record<string, any>) => {
-    return Object.keys(modules).reduce((acc, modulePath) => {
-      // 只处理指定语言目录下的文件
-      if (!modulePath.startsWith(`./${locale}/`)) {
-        return acc;
-      }
-
-      // 从路径中提取文件名作为 prefix
-      const fileNameMatch = modulePath.match(/\/([^/]+)\.json$/);
-      const fileName = fileNameMatch?.[1] || '';
-      if (fileName) {
-        console.log();
-        // 判断是否为子目录文件
-        const isPrefixFile = modulePath.split('/').length > 3;
-        if (isPrefixFile) {
-          return {
-            ...acc,
-            ...handlePrefix(modules[modulePath] as Record<string, any>, fileName)
-          };
-        } else {
-          // 根目录文件，不添加前缀
-          return {
-            ...acc,
-            ...modules[modulePath] as Record<string, any>
-          };
-        }
-      }
-      return acc;
-    }, {} as Record<string, any>);
-  };
+/**
+ * 为翻译对象添加前缀
+ * @param translations - 原始翻译对象
+ * @param prefix - 前缀字符串
+ * @returns 添加前缀后的翻译对象
+ */
+const addPrefix = (translations: Record<string, any>, prefix: string): Record<string, any> => {
+	return Object.keys(translations).reduce((acc, key) => {
+		acc[`${prefix}.${key}`] = translations[key];
+		return acc;
+	}, {} as Record<string, any>);
+};
+
+/**
+ * 判断文件是否在子目录中
+ * @param modulePath - 模块路径
+ * @param baseDepth - 基础路径深度（默认为 3，即 ./locale/*.json）
+ * @returns 是否为子目录文件
+ */
+const isNestedFile = (modulePath: string, baseDepth = 3): boolean => {
+	return modulePath.split('/').length > baseDepth;
+};
+
+/**
+ * 从路径中提取文件名（不含扩展名）
+ * @param modulePath - 模块路径
+ * @returns 文件名
+ */
+const extractFileName = (modulePath: string): string => {
+	const match = modulePath.match(/\/([^/]+)\.json$/);
+	return match?.[1] || '';
+};
+
+/**
+ * 处理单个语言目录下的所有翻译文件
+ * @param modules - 导入的模块对象
+ * @param locale - 语言代码
+ * @param basePath - 基础路径前缀（用于自定义目录）
+ * @returns 合并后的翻译对象
+ */
+const processLocaleModules = (
+	modules: Record<string, any>,
+	locale: string,
+	basePath = '.'
+): Record<string, any> => {
+	const localePrefix = `${basePath}/${locale}/`;
+
+	return Object.keys(modules).reduce((acc, modulePath) => {
+		// 只处理指定语言目录下的文件
+		if (!modulePath.startsWith(localePrefix)) {
+			return acc;
+		}
+
+		const fileName = extractFileName(modulePath);
+		if (!fileName) {
+			return acc;
+		}
+
+		const translation = modules[modulePath] as Record<string, any>;
+
+		// 判断是否为子目录文件，子目录文件添加文件名作为前缀
+		if (isNestedFile(modulePath)) {
+			return {
+				...acc,
+				...addPrefix(translation, fileName)
+			};
+		}
+
+		// 根目录文件，直接合并（不添加前缀）
+		return {
+			...acc,
+			...translation
+		};
+	}, {} as Record<string, any>);
+};
+
+/**
+ * 自动发现翻译目录下的所有语言
+ * @param modules - 导入的模块对象
+ * @param basePath - 基础路径前缀
+ * @returns 语言代码数组
+ */
+const discoverLocales = (modules: Record<string, any>, basePath = '.'): string[] => {
+	const locales = new Set<string>();
+	const pattern = new RegExp(`^${basePath.replace('.', '\\.')}/([^/]+)/`);
 
-  // 处理所有模块
-  return processModules(allModules);
+	Object.keys(modules).forEach(modulePath => {
+		const match = modulePath.match(pattern);
+		if (match?.[1]) {
+			locales.add(match[1]);
+		}
+	});
+
+	return Array.from(locales);
+};
+
+/**
+ * 深度合并翻译对象（后面的值会覆盖前面的值）
+ * @param target - 目标对象（基础对象）
+ * @param source - 源对象（覆盖对象，优先级更高）
+ * @returns 合并后的新对象
+ * @example
+ * ```typescript
+ * const base = { a: { b: 1, c: 2 }, d: 3 };
+ * const override = { a: { b: 10 }, e: 4 };
+ * const result = deepMerge(base, override);
+ * // 结果：{ a: { b: 10, c: 2 }, d: 3, e: 4 }
+ * // 说明：override.a.b 覆盖了 base.a.b，但 base.a.c 保留
+ * ```
+ */
+const deepMerge = (
+	target: Record<string, any>,
+	source: Record<string, any>
+): Record<string, any> => {
+	// 创建新对象，避免修改原始对象
+	const result = { ...target };
+
+	// 遍历源对象的所有键
+	for (const key in source) {
+		if (Object.prototype.hasOwnProperty.call(source, key)) {
+			const sourceValue = source[key];
+			const targetValue = result[key];
+
+			// 判断是否需要深度合并（两者都是对象且不是数组）
+			const shouldDeepMerge =
+				typeof sourceValue === 'object' &&
+				sourceValue !== null &&
+				!Array.isArray(sourceValue) &&
+				typeof targetValue === 'object' &&
+				targetValue !== null &&
+				!Array.isArray(targetValue);
+
+			if (shouldDeepMerge) {
+				// 递归深度合并对象
+				result[key] = deepMerge(targetValue, sourceValue);
+			} else {
+				// 直接覆盖（包括基本类型、数组、null、undefined）
+				result[key] = sourceValue;
+			}
+		}
+	}
+
+	return result;
+};
+
+/**
+ * 翻译加载器配置接口
+ */
+interface TranslationsConfig {
+	/** 扩展翻译目录配置数组（自定义目录的值会覆盖默认目录的值） */
+	extensions?: Array<{
+		/** 扩展目录的模块对象（使用 import.meta.glob 导入） */
+		modules: Record<string, any>;
+		/** 扩展目录的基础路径（用于路径匹配） */
+		basePath?: string;
+	}>;
+	/** 指定要加载的语言列表，如果不指定则自动发现 */
+	locales?: string[];
+}
+
+/**
+ * 创建多语言翻译对象
+ * @param config - 翻译加载器配置（可选）
+ * @returns 以语言为 key 的翻译对象
+ *
+ * @description
+ * 该方法实现了多目录翻译文件的深度合并机制：
+ * 1. 自动加载默认目录 (translations/) 下的 JSON 文件
+ * 2. 支持扩展自定义目录，可以添加多个自定义来源
+ * 3. 合并顺序：默认目录 → 自定义目录 1 → 自定义目录 2 → ...
+ * 4. 覆盖机制：后面的目录会 **深度覆盖**前面目录的值
+ *
+ * @example
+ * ```typescript
+ * // 基础用法：只加载默认目录
+ * const t = translations();
+ *
+ * // 高级用法：加载默认目录 + 自定义扩展目录（自定义目录会深度覆盖默认目录）
+ * const t = translations({
+ *   extensions: [
+ *     {
+ *       modules: import.meta.glob('../custom/ * \/ ** \/ *.json', { eager: true, import: 'default' }),
+ *       basePath: '../custom'
+ *     }
+ *   ]
+ * });
+ *
+ * // 指定语言列表
+ * const t = translations({
+ *   locales: ['en', 'zh-Hans', 'zh-Hant']
+ * });
+ *
+ * // 深度覆盖示例：
+ * // 默认目录的 en.json: { common: { hello: "Hello", world: "World" }, home: { title: "Home" } }
+ * // 自定义目录的 en.json: { common: { hello: "Hi" }, about: { title: "About" } }
+ * // 最终结果: { common: { hello: "Hi", world: "World" }, home: { title: "Home" }, about: { title: "About" } }
+ * ```
+ */
+export const translations = (config?: TranslationsConfig): Record<string, Record<string, any>> => {
+	const { extensions = [], locales: specifiedLocales } = config || {};
+
+	// @ts-ignore
+	// 自动加载默认翻译目录
+	const defaultModules = import.meta.glob('./*/**/*.json', { eager: true, import: 'default' });
+
+	// 收集所有模块（默认目录在前，自定义目录在后，确保自定义目录覆盖默认目录）
+	const allModuleSources = [
+		{ modules: defaultModules, basePath: '.' },
+		...extensions
+	];
+
+	// 自动发现所有语言或使用指定的语言列表
+	const allLocales = specifiedLocales || [
+		...new Set(
+			allModuleSources.flatMap(({ modules, basePath = '.' }) =>
+				discoverLocales(modules, basePath)
+			)
+		)
+	];
+
+	// 为每个语言构建翻译对象
+	return allLocales.reduce((result, locale) => {
+		// 合并所有来源的翻译（后面的会覆盖前面的）
+    result[locale] = allModuleSources.reduce((acc, {modules, basePath = '.'}) => {
+      const localeTranslations = processLocaleModules(modules, locale, basePath);
+      return deepMerge(acc, localeTranslations);
+    }, {} as Record<string, any>);
+		return result;
+	}, {} as Record<string, Record<string, any>>);
 };
 
-export default {
-  en: loadTranslations('en'),
-  'zh-Hans': loadTranslations('zh-Hans'),
-}
+// 默认导出：加载默认翻译目录
+export default translations();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekron/strapi",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "极客领航网站管理插件",
   "type": "commonjs",
   "author": "Geekron",
@@ -30,28 +30,40 @@
   ],
   "exports": {
     "./package.json": "./package.json",
+    "./admin": {
+      "source": "./admin/src/index.ts",
+      "import": "./dist/admin/index.mjs",
+      "require": "./dist/admin/index.js",
+      "default": "./dist/admin/index.js",
+      "types": "./dist/admin/index.d.ts"
+    },
+    "./server": {
+      "source": "./server/src/index.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js",
+      "default": "./dist/server/index.js",
+      "types": "./dist/server/index.d.ts"
+    },
     "./strapi-admin": {
       "source": "./admin/src/index.ts",
       "import": "./dist/admin/index.mjs",
       "require": "./dist/admin/index.js",
-      "default": "./dist/admin/index.js"
+      "default": "./dist/admin/index.js",
+      "types": "./dist/admin/index.d.ts"
     },
     "./strapi-server": {
       "source": "./server/src/index.ts",
       "import": "./dist/server/index.mjs",
       "require": "./dist/server/index.js",
-      "default": "./dist/server/index.js"
+      "default": "./dist/server/index.js",
+      "types": "./dist/server/index.d.ts"
     },
     "./i18n": {
       "source": "./i18n/index.ts",
       "import": "./dist/i18n/index.mjs",
       "require": "./dist/i18n/index.js",
-      "default": "./dist/i18n/index.js"
-    },
-    "./i18n/translations": {
-      "source": "./i18n/translations/index.ts",
-      "import": "./i18n/translations/index.ts",
-      "default": "./i18n/translations/index.ts"
+      "default": "./dist/i18n/index.js",
+      "types": "./dist/i18n/index.d.ts"
     }
   },
   "peerDependencies": {