@liujitcn/kratos-admin-core 0.0.21 → 0.0.23

package/dist/package/src/locales/index.ts

@@ -3,22 +3,21 @@
  * 各语言 JSON 由对应模块定义文件导入，不能在 JSON 文件内添加注释。
  */
 import dayjs from "dayjs";
-import "dayjs/locale/en";
-import "dayjs/locale/ja";
-import "dayjs/locale/zh-cn";
-import "dayjs/locale/zh-tw";
-import "dayjs/locale/ko";
-import "dayjs/locale/fr";
-import "dayjs/locale/es";
 import { computed, readonly, ref } from "vue";
 import { createI18n } from "vue-i18n";
 import type { AdminModule } from "../modules";
-import type { GetLanguageResponse } from "../rpc/base/v1/language";
-
-/** 管理端支持的语言区域。 */
-export const SUPPORTED_LOCALES = ["zh-CN", "zh-TW", "en-US", "ja-JP", "ko-KR", "fr-FR", "es-ES"] as const;
+import type { OptionLanguageResponse } from "../rpc/base/v1/language";
+import {
+  DAYJS_LOCALE_MAP,
+  DEFAULT_LOCALE as GENERATED_DEFAULT_LOCALE,
+  SUPPORTED_LOCALES as GENERATED_SUPPORTED_LOCALES,
+  type GeneratedLocale,
+} from "./generated";
+
+/** 管理端已打包的语言区域；运行时可切换列表由 base_language 接口决定。 */
+export const SUPPORTED_LOCALES = GENERATED_SUPPORTED_LOCALES;
 /** 管理端支持的语言区域类型。 */
-export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+export type SupportedLocale = GeneratedLocale;
 /** 单个模块的扁平语言包。 */
 export type LocaleMessages = Record<string, string>;
 /** 翻译插值参数。 */
@@ -28,15 +27,11 @@ export type LocaleParams = Record<string, string | number>;
 export interface LocaleOption {
   /** 标准语言代码。 */
   language_code: SupportedLocale;
-  /** 语言名称。 */
-  language_name: string;
   /** 本地语言名称。 */
   native_name: string;
-  /** 排序值。 */
-  sort: number;
 }
 
-export const DEFAULT_LOCALE: SupportedLocale = "zh-CN";
+export const DEFAULT_LOCALE: SupportedLocale = GENERATED_DEFAULT_LOCALE;
 export const LOCALE_STORAGE_KEY = "kratos-admin:locale";
 
 const mutableLocale = ref<SupportedLocale>(DEFAULT_LOCALE);
@@ -48,7 +43,6 @@ export const adminI18n = createI18n({
   legacy: false,
   locale: DEFAULT_LOCALE,
   fallbackLocale: DEFAULT_LOCALE,
-  flatJson: true,
   messages: {},
   missingWarn: false,
   fallbackWarn: false
@@ -56,48 +50,37 @@ export const adminI18n = createI18n({
 
 /** 规范化任意语言输入到管理端白名单。 */
 export function normalizeLocale(value?: string): SupportedLocale {
-  const normalized = String(value ?? "")
-    .replace("_", "-")
-    .toLowerCase();
-  if (normalized.startsWith("ja")) return "ja-JP";
-  if (normalized.startsWith("en")) return "en-US";
-  if (normalized.startsWith("zh-tw") || normalized.startsWith("zh-hk") || normalized.startsWith("zh-mo")) return "zh-TW";
-  if (normalized.startsWith("ko")) return "ko-KR";
-  if (normalized.startsWith("fr")) return "fr-FR";
-  if (normalized.startsWith("es")) return "es-ES";
-  return DEFAULT_LOCALE;
+  return parseSupportedLocale(value) ?? DEFAULT_LOCALE;
 }
 
 /** 将接口或系统语言代码解析为已打包的语言区域。 */
 function parseSupportedLocale(value?: string): SupportedLocale | undefined {
   const normalized = String(value ?? "").replace("_", "-").toLowerCase();
-  if (normalized.startsWith("zh-tw") || normalized.startsWith("zh-hk") || normalized.startsWith("zh-mo")) return "zh-TW";
-  if (normalized.startsWith("zh")) return "zh-CN";
-  if (normalized.startsWith("en")) return "en-US";
-  if (normalized.startsWith("ja")) return "ja-JP";
-  if (normalized.startsWith("ko")) return "ko-KR";
-  if (normalized.startsWith("fr")) return "fr-FR";
-  if (normalized.startsWith("es")) return "es-ES";
-  return undefined;
+  if (!normalized) return undefined;
+  const alias = normalized.startsWith("zh-hk") || normalized.startsWith("zh-mo") ? "zh-tw" : normalized;
+  const exact = SUPPORTED_LOCALES.find(locale => locale.toLowerCase() === alias);
+  if (exact) return exact;
+  const language = alias.split("-", 1)[0];
+  return SUPPORTED_LOCALES.find(locale => locale.toLowerCase().split("-", 1)[0] === language);
 }
 
-/** 注册模块语言包并校验七语键、占位符和命名空间。 */
+/** 注册模块语言包并校验语言键、占位符和命名空间。 */
 export function registerLocaleMessages(modules: AdminModule[]): void {
   const merged = new Map<SupportedLocale, LocaleMessages>(SUPPORTED_LOCALES.map(locale => [locale, {}]));
 
   modules.forEach(module => {
     if (!module.messages) return;
-    const expectedKeys = Object.keys(module.messages[DEFAULT_LOCALE] ?? {}).sort();
+    const expectedKeys = requiredLocaleKeys(module.messages[DEFAULT_LOCALE] ?? {});
     SUPPORTED_LOCALES.forEach(locale => {
       const messages = module.messages?.[locale];
       if (!messages) throw new Error(`${module.name} 缺少 ${locale} 语言包`);
-      const keys = Object.keys(messages).sort();
+      const keys = requiredLocaleKeys(messages);
       if (keys.join("\u0000") !== expectedKeys.join("\u0000")) {
         throw new Error(`${module.name} 的 ${locale} 语言包键集合不一致`);
       }
 
       const target = merged.get(locale) as LocaleMessages;
-      keys.forEach(key => {
+      Object.keys(messages).forEach(key => {
         assertLocaleKeyNamespace(module.name, key);
         if (Object.prototype.hasOwnProperty.call(target, key)) {
           throw new Error(`${locale} 语言键重复: ${key}`);
@@ -119,24 +102,21 @@ export function initializeLocale(): SupportedLocale {
   return mutableLocale.value;
 }
 
-/** 应用后端语言配置，并在当前语言不可用时回退到接口主语言。 */
-export function applyLanguageConfig(response: GetLanguageResponse): void {
+/** 应用后端语言配置，并在当前语言不可用时回退到接口第一项。 */
+export function applyLanguageConfig(response: OptionLanguageResponse): void {
   const options = response.languages.reduce<LocaleOption[]>((items, item) => {
     const languageCode = parseSupportedLocale(item.language_code);
     if (!languageCode || items.some((option) => option.language_code === languageCode)) return items;
     items.push({
       language_code: languageCode,
-      language_name: item.language_name || t(`common.language.${languageCode}`),
-      native_name: item.native_name || item.language_name || languageCode,
-      sort: item.sort,
+      native_name: item.native_name || languageCode,
     });
     return items;
   }, []);
-  mutableLanguageOptions.value = options.length ? options.sort((left, right) => left.sort - right.sort) : getFallbackLanguageOptions();
+  mutableLanguageOptions.value = options.length ? options : getFallbackLanguageOptions();
   const availableLocales = getSupportedLocales();
-  const primaryLocale = parseSupportedLocale(response.primary_language_code);
   if (!availableLocales.includes(mutableLocale.value)) {
-    applyLocale(primaryLocale && availableLocales.includes(primaryLocale) ? primaryLocale : availableLocales[0] ?? DEFAULT_LOCALE);
+    applyLocale(availableLocales[0] ?? DEFAULT_LOCALE);
   }
 }
 
@@ -194,18 +174,31 @@ export function useLocaleStore() {
 }
 
 function getFallbackLanguageOptions(): LocaleOption[] {
-  return SUPPORTED_LOCALES.map((languageCode, sort) => ({
-    language_code: languageCode,
-    language_name: t(`common.language.${languageCode}`),
-    native_name: languageCode,
-    sort,
-  }));
+  return SUPPORTED_LOCALES.map(languageCode => {
+    return {
+      language_code: languageCode,
+      native_name: fallbackNativeLanguageName(languageCode),
+    };
+  });
+}
+
+function fallbackNativeLanguageName(languageCode: SupportedLocale): string {
+  return {
+    "zh-CN": "简体中文",
+    "zh-TW": "繁體中文",
+    "en-US": "English",
+    "ja-JP": "日本語",
+    "ko-KR": "한국어",
+    "fr-FR": "Français",
+    "es-ES": "Español",
+  }[languageCode];
 }
 
 function applyLocale(locale: SupportedLocale): void {
   mutableLocale.value = locale;
   adminI18n.global.locale.value = locale;
-  dayjs.locale({ "zh-CN": "zh-cn", "zh-TW": "zh-tw", "en-US": "en", "ja-JP": "ja", "ko-KR": "ko", "fr-FR": "fr", "es-ES": "es" }[locale]);
+  const dayjsLocale = DAYJS_LOCALE_MAP[locale];
+  if (dayjsLocale) dayjs.locale(dayjsLocale);
   document.documentElement.lang = locale;
 }
 
@@ -215,6 +208,12 @@ function assertLocaleKeyNamespace(moduleName: string, key: string): void {
   if (!valid) throw new Error(`${moduleName} 的语言键命名空间无效: ${key}`);
 }
 
+function requiredLocaleKeys(messages: LocaleMessages): string[] {
+  return Object.keys(messages)
+    .filter(key => !key.startsWith("common.language."))
+    .sort();
+}
+
 function assertLocalePlaceholders(moduleName: string, key: string, message: string, sourceMessage: string): void {
   const placeholders = (value: string) => [...value.matchAll(/\{([A-Za-z0-9_]+)\}/g)].map(match => match[1]).sort();
   if (placeholders(message).join("\u0000") !== placeholders(sourceMessage).join("\u0000")) {