feat: 为directus做I18n适配

- 添加getDirectusLocale方法用于获取Directus本地化字段

app/composables/useLocalizations.ts

@@ -3,38 +3,89 @@ import type { Language as ElementLanguage } from 'element-plus/es/locale';
 import zhCn from 'element-plus/es/locale/lang/zh-cn';
 import en from 'element-plus/es/locale/lang/en';
 
-// Strapi本地化映射
-export const strapiLocales: Record<string, StrapiLocale> = {
-  zh: 'zh-CN',
-  en: 'en',
-};
+/**
+ * 应用语言映射结构
+ * 用于统一 Strapi / Directus / Element Plus 的多语言配置
+ */
+export interface LocaleMapping {
+  /** 用于StrapiLocale **/
+  strapi: StrapiLocale;
+  /** 用于Directus translations.languages_code **/
+  directus: string;
+  /** Element Plus语言对象 **/
+  element: ElementLanguage;
+}
 
-// Element Plus本地化映射
-export const elementPlusLocales: Record<string, ElementLanguage> = {
-  zh: zhCn,
-  en: en,
-};
+/**
+ * 应用支持的语言映射表。
+ *
+ * 每个键（如 "zh"、"en"）对应一套统一的本地化配置，
+ * 方便在 Strapi / Directus / Element Plus 三方系统间保持一致。
+ */
+export const localeMap = {
+  zh: {
+    strapi: 'zh-CN',
+    directus: 'zh-CN',
+    element: zhCn,
+  },
+  en: {
+    strapi: 'en',
+    directus: 'en-US',
+    element: en,
+  },
+} satisfies Record<string, LocaleMapping>;
 
+/** 应用支持的语言键类型 **/
+export type AppLocale = keyof typeof localeMap;
+
+/** 默认语言， 当找不到匹配语言时回退到默认语言 **/
+const defaultLocale: AppLocale = 'zh';
+
+/**
+ * 提供 Strapi、 Directus 与 Element Plus的国际化映射工具
+ *
+ * ---
+ *  @example
+ *  ``` ts
+ * const { locale, getStrapiLocale, getElementPlusLocale } = useLocalizations()
+ *
+ * const strapiLang = getStrapiLocale()          // 当前 Strapi 语言码
+ * const elLocale = getElementPlusLocale('en')   // 获取 Element Plus 英文对象
+ * const all = getLocaleMapping('zh')            // 获取完整映射结构
+ *  ```
+ *  ---
+ *
+ *  @returns 返回当前语言及各系统的本地化获取方法
+ */
 export const useLocalizations = () => {
-  const { locale } = useI18n();
+  const { locale } = useI18n<{ locale: Ref<AppLocale> }>();
 
-  // 获取Strapi本地化代码
-  const getStrapiLocale = (nuxtLocale?: string): StrapiLocale => {
-    const currentLocale = nuxtLocale || locale.value;
-    return strapiLocales[currentLocale] || 'zh-Hans';
-  };
-
-  // 获取Element Plus本地化
-  const getElementPlusLocale = (nuxtLocale?: string) => {
-    const currentLocale = nuxtLocale || locale.value;
-    const elementPlusLocale =
-      elementPlusLocales[currentLocale] || elementPlusLocales['zh'];
-    return elementPlusLocale;
+  /**
+   * 获取对应语言的完整映射结构
+   *
+   * @param nuxtLocale - 可选的语言码参数，若提供则使用该语言码，否则使用当前应用语言
+   * @returns 返回当前语言的完整映射对象
+   */
+  const getMapping = (nuxtLocale?: AppLocale): LocaleMapping => {
+    const current = nuxtLocale || locale.value;
+    return localeMap[current] || localeMap[defaultLocale];
   };
 
   return {
+    /** 当前Nuxt I18n语言(只读) **/
     locale: readonly(locale),
-    getStrapiLocale,
-    getElementPlusLocale,
+    /** 获取Strapi的本地化代码 **/
+    getStrapiLocale: (l?: AppLocale) => getMapping(l).strapi,
+    /** 获取Directus的本地化代码 **/
+    getDirectusLocale: (l?: AppLocale) => getMapping(l).directus,
+    /** 获取Element Plus语言对象 **/
+    getElementPlusLocale: (l?: AppLocale) => getMapping(l).element,
+    /**
+     * 获取完整的语言映射结构(Strapi / Directus / Element Plus)
+     *
+     * @param l: 指定语言，默认为当前locale
+     * @returns 语言映射对象
+     */
+    getLocaleMapping: getMapping,
   };
 };