@liujitcn/kratos-admin-core 0.0.20 → 0.0.23

package/dist/package/src/locales/fr-FR.json

@@ -0,0 +1,283 @@
+{
+  "common.action.back": "Retour",
+  "common.action.cancel": "Annuler",
+  "common.action.close": "Fermer",
+  "common.action.confirm": "Confirmer",
+  "common.action.create": "Créer",
+  "common.action.delete": "Supprimer",
+  "common.action.download": "Télécharger",
+  "common.action.edit": "Modifier",
+  "common.action.expand": "Développer",
+  "common.action.collapse": "Réduire",
+  "common.action.login": "Se connecter",
+  "common.action.logout": "Se déconnecter",
+  "common.action.reset": "Réinitialiser",
+  "common.action.save": "Enregistrer",
+  "common.action.search": "Rechercher",
+  "common.action.view": "Afficher",
+  "common.field.end_time": "Heure de fin",
+  "common.field.language": "Langue",
+  "common.field.operation": "Actions",
+  "common.field.parameter_name": "Nom du paramètre",
+  "common.field.parameter_value": "Valeur du paramètre",
+  "common.field.phone": "Numéro de téléphone",
+  "common.field.start_time": "Heure de début",
+  "common.language.en-US": "Anglais",
+  "common.language.ja-JP": "Japonais",
+  "common.language.zh-CN": "Chinois simplifié",
+  "common.language.zh-TW": "Chinois traditionnel",
+  "common.language.ko-KR": "Coréen",
+  "common.language.fr-FR": "Français",
+  "common.language.es-ES": "Espagnol",
+  "common.message.no_data": "Aucune donnée",
+  "common.message.operation_success": "Opération terminée",
+  "common.message.system_error": "Erreur système",
+  "common.validation.phone_invalid": "Saisissez un numéro de téléphone valide",
+  "common.validation.phone_required": "Saisissez un numéro de téléphone",
+  "common.title.notice": "Avis",
+  "common.title.warning": "Confirmation",
+  "common.placeholder.input": "Saisissez une valeur",
+  "common.placeholder.input_content": "Saisissez le contenu",
+  "common.placeholder.select": "Sélectionnez une valeur",
+  "common.status.disabled": "Désactivé",
+  "common.status.enabled": "Activé",
+  "common.value.female": "Femme",
+  "common.value.male": "Homme",
+  "common.value.all": "Tous",
+  "core.auth.login_again": "Se reconnecter",
+  "core.auth.refresh_token_missing": "Le jeton d’actualisation est manquant",
+  "core.auth.session_expired": "Votre session a expiré. Veuillez vous reconnecter.",
+  "core.auth.no_menu_permission": "Ce compte n’a aucun droit de menu. Contactez un administrateur.",
+  "core.auth.no_permission": "Accès refusé",
+  "core.clipboard.success": "Copié",
+  "core.cron.cycle_unit.day": "jours",
+  "core.cron.cycle_unit.hour": "heures",
+  "core.cron.cycle_unit.minute": "minutes",
+  "core.cron.cycle_unit.month": "mois",
+  "core.cron.cycle_unit.second": "secondes",
+  "core.cron.cycle_unit.year": "ans",
+  "core.cron.description.every": "Chaque {unit}",
+  "core.cron.description.range": "{segment} de {start} à {end}",
+  "core.cron.description.specific": "{segment} : {values}",
+  "core.cron.description.step": "À partir de {start} {unit}, exécuter toutes les {step} {cycleUnit}",
+  "core.cron.description.unspecified": "{segment} non défini",
+  "core.cron.description.weekday": "Jour ouvré le plus proche du {day} de ce mois",
+  "core.cron.description_separator": "; ",
+  "core.cron.edit": "Modifier l'expression",
+  "core.cron.every_unit": "Chaque {unit}",
+  "core.cron.expression": "Expression Cron",
+  "core.cron.from": "à partir de",
+  "core.cron.last_day": "Dernier jour de ce mois",
+  "core.cron.nearest_workday": "jour ouvré le plus proche",
+  "core.cron.not_configured": "Aucune planification configurée",
+  "core.cron.placeholder": "Saisissez une expression Cron",
+  "core.cron.preset.daily_eight": "Tous les jours à 8 h",
+  "core.cron.preset.daily_midnight": "Tous les jours à minuit",
+  "core.cron.preset.every_five_minutes": "Toutes les 5 minutes",
+  "core.cron.preset.every_hour": "Toutes les heures",
+  "core.cron.preset.every_minute": "Toutes les minutes",
+  "core.cron.preset.monthly_first": "Le 1er de chaque mois à minuit",
+  "core.cron.preset.next_year_daily": "Tous les jours de l'année prochaine à minuit",
+  "core.cron.presets": "Expressions courantes",
+  "core.cron.range": "Plage",
+  "core.cron.repeat": "Répéter",
+  "core.cron.run_once": "Exécuter une fois par {unit}",
+  "core.cron.segment.day": "Jour",
+  "core.cron.segment.hour": "Heure",
+  "core.cron.segment.minute": "Minute",
+  "core.cron.segment.month": "Mois",
+  "core.cron.segment.second": "Seconde",
+  "core.cron.segment.year": "Année",
+  "core.cron.specific": "Spécifique",
+  "core.cron.start_every": "{unit}, toutes les",
+  "core.cron.this_month": "Jour de ce mois",
+  "core.cron.title": "Modifier l'expression de planification",
+  "core.cron.to": "à",
+  "core.cron.unit.day": "jour",
+  "core.cron.unit.hour": "heure",
+  "core.cron.unit.minute": "minute",
+  "core.cron.unit.month": "mois",
+  "core.cron.unit.second": "seconde",
+  "core.cron.unit.year": "an",
+  "core.cron.unspecified": "Non défini",
+  "core.cron.value_separator": ", ",
+  "core.cron.value_with_unit": "{value} {unit}",
+  "core.cron.workday": "Jour ouvré",
+  "core.data.confirm_action": "Voulez-vous vraiment {action} ?",
+  "core.data.operation_success": "{action} terminé",
+  "core.download.large_file_notice": "Le téléchargement de gros volumes de données peut prendre plus de temps. Veuillez patienter.",
+  "core.error.403.detail": "Vous n’avez pas l’autorisation d’accéder à cette page.",
+  "core.error.404.detail": "La page demandée n’existe pas.",
+  "core.error.500.detail": "Le serveur a rencontré une erreur.",
+  "core.error.pending.detail": "Cette fonctionnalité est en cours de développement.",
+  "core.error.javascript.eval": "Utilisation invalide de Eval",
+  "core.error.javascript.internal": "Erreur interne du moteur JavaScript",
+  "core.error.javascript.range": "Le paramètre est hors limites",
+  "core.error.javascript.reference": "Objet introuvable",
+  "core.error.javascript.syntax": "Erreur de syntaxe",
+  "core.error.javascript.type": "Type ou objet invalide",
+  "core.error.javascript.unknown": "Erreur inconnue",
+  "core.error.javascript.uri": "Erreur d’URI",
+  "core.header.fullscreen": "Plein écran",
+  "core.header.fullscreen_exit": "Quitter le plein écran",
+  "core.header.fullscreen_unsupported": "Le plein écran n’est pas pris en charge par ce navigateur",
+  "core.header.language": "Changer de langue",
+  "core.header.menu_search": "Rechercher dans les menus",
+  "core.header.menu_search_empty": "Aucun menu trouvé",
+  "core.header.menu_search_placeholder": "Rechercher par nom ou chemin du menu",
+  "core.header.size.default": "Par défaut",
+  "core.header.size.large": "Grand",
+  "core.header.size.small": "Petit",
+  "core.header.size_select": "Taille du composant",
+  "core.header.theme": "Paramètres du thème",
+  "core.icon.empty": "Aucune icône correspondante",
+  "core.icon.placeholder": "Sélectionnez une icône",
+  "core.icon.search": "Rechercher des icônes",
+  "core.layout.department_unassigned": "Aucun département attribué",
+  "core.layout.home": "Accueil",
+  "core.layout.info": "Informations personnelles",
+  "core.layout.password_change": "Modifier le mot de passe",
+  "core.layout.unnamed_menu": "Menu sans nom",
+  "core.layout.logout_confirm": "Voulez-vous vraiment vous déconnecter ?",
+  "core.layout.logout_success": "Déconnecté",
+  "core.layout.not_set": "Non défini",
+  "core.layout.role_unassigned": "Aucun rôle attribué",
+  "core.login.behavior_click": "Cliquez sur les caractères dans l'ordre",
+  "core.login.behavior_confirm": "Confirmer",
+  "core.login.behavior_puzzle": "Faites glisser le curseur pour terminer le puzzle",
+  "core.login.behavior_rotate": "Faites glisser le curseur pour remettre l'image intérieure à l'endroit",
+  "core.login.captcha": "Saisissez le code de vérification",
+  "core.login.captcha_alt": "Code de vérification",
+  "core.login.greeting.afternoon": "Bon après-midi",
+  "core.login.greeting.evening": "Bonsoir",
+  "core.login.greeting.morning": "Bonjour",
+  "core.login.greeting.night": "Bonjour",
+  "core.login.greeting.noon": "Bon après-midi",
+  "core.login.other_methods": "Autres méthodes de connexion",
+  "core.login.password": "Saisissez le mot de passe",
+  "core.login.tenant_code": "Saisissez le code du locataire",
+  "core.login.user_name": "Saisissez le nom d'utilisateur",
+  "core.login.welcome": "Bienvenue dans la console d'administration",
+  "core.oauth.dingtalk": "DingTalk",
+  "core.oauth.feishu": "Feishu",
+  "core.oauth.wechat": "WeChat",
+  "core.oauth.wechatmp": "Compte officiel WeChat",
+  "core.oauth.wechatwork": "WeCom",
+  "core.oauth.unknown": "Fournisseur inconnu",
+  "core.password.error": "Le mot de passe doit contenir des majuscules, des minuscules, un chiffre et un caractère spécial, et comporter au moins 8 caractères.",
+  "core.password.crypto_unsupported": "Le chiffrement des mots de passe n’est pas pris en charge dans cet environnement",
+  "core.password.required": "Le mot de passe est obligatoire",
+  "core.password.strength": "Force du mot de passe",
+  "core.password.strength.empty": "Non saisie",
+  "core.password.strength.high": "Élevée",
+  "core.password.strength.low": "Faible",
+  "core.password.strength.medium": "Moyenne",
+  "core.password.tip": "Utilisez au moins 8 caractères avec des majuscules, des minuscules, un chiffre et un caractère spécial. Le mot de passe doit atteindre une force élevée avant l’envoi.",
+  "core.theme.accordion": "Menu accordéon",
+  "core.theme.aside_inverted": "Barre latérale sombre",
+  "core.theme.aside_inverted_tip": "Utiliser des couleurs sombres pour la barre latérale",
+  "core.theme.breadcrumb": "Fil d’Ariane",
+  "core.theme.breadcrumb_icon": "Icônes du fil d’Ariane",
+  "core.theme.color": "Couleur du thème",
+  "core.theme.dark": "Mode sombre",
+  "core.theme.footer": "Pied de page",
+  "core.theme.global": "Thème global",
+  "core.theme.grey": "Mode niveaux de gris",
+  "core.theme.header_inverted": "En-tête sombre",
+  "core.theme.header_inverted_tip": "Utiliser des couleurs sombres pour l’en-tête",
+  "core.theme.interface": "Paramètres de l’interface",
+  "core.theme.layout": "Mise en page",
+  "core.theme.layout.classic": "Classique",
+  "core.theme.layout.columns": "Colonnes",
+  "core.theme.layout.transverse": "Transversal",
+  "core.theme.layout.vertical": "Vertical",
+  "core.theme.menu_collapse": "Réduire le menu",
+  "core.theme.primary_reset": "Couleur du thème réinitialisée à {color}",
+  "core.theme.settings": "Paramètres de mise en page",
+  "core.theme.tabs": "Onglets",
+  "core.theme.tabs_icon": "Icônes des onglets",
+  "core.theme.watermark": "Filigrane",
+  "core.theme.weak": "Mode daltonisme",
+  "core.theme.color_hex_invalid": "Saisissez une couleur hexadécimale valide",
+  "core.theme.color_rgb_invalid": "Saisissez une couleur RGB valide",
+  "core.route.forbidden": "Page 403",
+  "core.route.login": "Se connecter",
+  "core.route.not_found": "Page 404",
+  "core.route.server_error": "Page 500",
+  "core.tabs.close_all": "Tout fermer",
+  "core.tabs.close_current": "Fermer l’onglet actuel",
+  "core.tabs.close_left": "Fermer les onglets à gauche",
+  "core.tabs.close_other": "Fermer les autres onglets",
+  "core.tabs.close_right": "Fermer les onglets à droite",
+  "core.tabs.maximize": "Maximiser",
+  "core.tabs.refresh": "Actualiser",
+  "core.table.collapse_all": "Tout réduire",
+  "core.table.column_name": "Colonne",
+  "core.table.column_setting": "Paramètres des colonnes",
+  "core.table.expand_all": "Tout développer",
+  "core.table.hide_search": "Masquer la recherche",
+  "core.table.no_configurable_columns": "Aucune colonne configurable",
+  "core.table.refresh": "Actualiser les données",
+  "core.table.show": "Visible",
+  "core.table.show_search": "Afficher la recherche",
+  "core.table.sort": "Triable",
+  "core.tree.filter_placeholder": "Saisissez des mots-clés à filtrer",
+  "core.tree.reset_selection": "Réinitialiser la sélection",
+  "core.upload.action": "Téléverser un fichier",
+  "core.upload.batch_add": "Ajouter {resource} par lot",
+  "core.upload.batch_failed": "Échec de l’ajout groupé de {resource}. Téléversez à nouveau le fichier.",
+  "core.upload.batch_success": "{resource} ajouté avec succès",
+  "core.upload.click": "cliquez pour téléverser",
+  "core.upload.data_cover": "Écraser les données",
+  "core.upload.drag_or_click": "Déposez un fichier ici ou ",
+  "core.upload.excel_format": "Téléversez un fichier .xls ou .xlsx standard de {size} Mo maximum",
+  "core.upload.file": "Téléversement de fichier",
+  "core.upload.file_failed": "Échec du téléversement. Réessayez.",
+  "core.upload.file_format_invalid": "Le format du fichier n’est pas pris en charge",
+  "core.upload.file_size_exceeded": "Le fichier ne doit pas dépasser {size} Mo",
+  "core.upload.file_success": "Fichier téléversé",
+  "core.upload.image_failed": "Échec du téléversement de l’image. Réessayez.",
+  "core.upload.image_format_invalid": "Le format de l’image n’est pas pris en charge",
+  "core.upload.image_limit_exceeded": "Vous pouvez téléverser jusqu’à {limit} images. Supprimez-en une avant d’en téléverser une autre.",
+  "core.upload.image_size_exceeded": "L’image ne doit pas dépasser {size} Mo",
+  "core.upload.image_success": "Image téléversée",
+  "core.upload.limit_exceeded": "Vous pouvez téléverser jusqu’à {limit} fichiers. Supprimez-en un avant d’en téléverser un autre.",
+  "core.upload.single_file_only": "Un seul fichier peut être téléversé",
+  "core.upload.template": "Modèle de {resource}",
+  "core.upload.template_download": "Télécharger le modèle",
+  "core.upload.unnamed_file": "Fichier sans nom",
+  "common.action.create_resource": "Créer {resource}",
+  "common.action.edit_resource": "Modifier {resource}",
+  "common.action.refresh_cache": "Actualiser le cache",
+  "common.dialog.cancel_delete": "Suppression de {resource} annulée",
+  "common.dialog.delete_batch": "Supprimer les {count} {resource} {unit} sélectionnés ?",
+  "common.dialog.delete_selected": "Supprimer le {resource} sélectionné ?",
+  "common.dialog.delete_single": "Supprimer ce {resource} ?",
+  "common.dialog.resource_field": "{field} : {value}",
+  "common.dialog.status_change": "{action} ce {resource} ?\n{field} : {value}",
+  "common.field.created_at": "Créé le",
+  "common.field.remark": "Remarques",
+  "common.field.sort": "Ordre",
+  "common.field.status": "Statut",
+  "common.field.tenant": "Locataire",
+  "common.field.updated_at": "Mis à jour le",
+  "common.message.create_success": "{resource} créé",
+  "common.message.delete_success": "{resource} supprimé",
+  "common.message.load_children_failed": "Échec du chargement des {resource} enfants",
+  "common.message.refresh_success": "Actualisé",
+  "common.message.select_delete_item": "Sélectionnez les éléments à supprimer",
+  "common.message.status_success": "{action} terminé",
+  "common.message.update_success": "{resource} mis à jour",
+  "common.placeholder.remark": "Saisissez des remarques",
+  "common.validation.max_length": "{field} ne doit pas dépasser {max} caractères",
+  "common.validation.required_input": "Saisissez {field}",
+  "common.validation.required_select": "Sélectionnez {field}",
+  "common.validation.sort_positive": "L’ordre doit être supérieur à 0",
+  "common.field.action": "Actions",
+  "common.placeholder.start_date": "Date de début",
+  "common.placeholder.end_date": "Date de fin",
+  "common.value.yes": "Oui",
+  "common.value.no": "Non",
+  "common.value.unknown": "Inconnu",
+  "common.value.none": "Aucun"
+}

package/dist/package/src/locales/generated.ts

@@ -0,0 +1,57 @@
+/* 此文件由 scripts/sync_locales.py 生成，请勿手工修改。 */
+import "dayjs/locale/zh-cn";
+import "dayjs/locale/en";
+import "dayjs/locale/es";
+import "dayjs/locale/fr";
+import "dayjs/locale/ja";
+import "dayjs/locale/ko";
+import "dayjs/locale/zh-tw";
+import elementLocaleZhCn from "element-plus/es/locale/lang/zh-cn";
+import elementLocaleEnUs from "element-plus/es/locale/lang/en";
+import elementLocaleEsEs from "element-plus/es/locale/lang/es";
+import elementLocaleFrFr from "element-plus/es/locale/lang/fr";
+import elementLocaleJaJp from "element-plus/es/locale/lang/ja";
+import elementLocaleKoKr from "element-plus/es/locale/lang/ko";
+import elementLocaleZhTw from "element-plus/es/locale/lang/zh-tw";
+
+import localeZhCn from "./zh-CN.json";
+import localeEnUs from "./en-US.json";
+import localeEsEs from "./es-ES.json";
+import localeFrFr from "./fr-FR.json";
+import localeJaJp from "./ja-JP.json";
+import localeKoKr from "./ko-KR.json";
+import localeZhTw from "./zh-TW.json";
+
+export const LOCALE_MESSAGES = {
+  "zh-CN": localeZhCn,
+  "en-US": localeEnUs,
+  "es-ES": localeEsEs,
+  "fr-FR": localeFrFr,
+  "ja-JP": localeJaJp,
+  "ko-KR": localeKoKr,
+  "zh-TW": localeZhTw,
+} as const satisfies Record<string, Record<string, string>>;
+
+export type GeneratedLocale = keyof typeof LOCALE_MESSAGES;
+export const DEFAULT_LOCALE: GeneratedLocale = "zh-CN";
+export const SUPPORTED_LOCALES = Object.keys(LOCALE_MESSAGES) as GeneratedLocale[];
+
+export const DAYJS_LOCALE_MAP: Record<string, string> = {
+  "zh-CN": "zh-cn",
+  "en-US": "en",
+  "es-ES": "es",
+  "fr-FR": "fr",
+  "ja-JP": "ja",
+  "ko-KR": "ko",
+  "zh-TW": "zh-tw",
+};
+
+export const ELEMENT_LOCALES = {
+  "zh-CN": elementLocaleZhCn,
+  "en-US": elementLocaleEnUs,
+  "es-ES": elementLocaleEsEs,
+  "fr-FR": elementLocaleFrFr,
+  "ja-JP": elementLocaleJaJp,
+  "ko-KR": elementLocaleKoKr,
+  "zh-TW": elementLocaleZhTw,
+} as const;

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

@@ -0,0 +1,222 @@
+/**
+ * 管理端国际化运行时：合并 core 和业务模块语言包，并为 Vue I18n、组件和请求层提供统一入口。
+ * 各语言 JSON 由对应模块定义文件导入，不能在 JSON 文件内添加注释。
+ */
+import dayjs from "dayjs";
+import { computed, readonly, ref } from "vue";
+import { createI18n } from "vue-i18n";
+import type { AdminModule } from "../modules";
+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 = GeneratedLocale;
+/** 单个模块的扁平语言包。 */
+export type LocaleMessages = Record<string, string>;
+/** 翻译插值参数。 */
+export type LocaleParams = Record<string, string | number>;
+
+/** 运行时语言选项。 */
+export interface LocaleOption {
+  /** 标准语言代码。 */
+  language_code: SupportedLocale;
+  /** 本地语言名称。 */
+  native_name: string;
+}
+
+export const DEFAULT_LOCALE: SupportedLocale = GENERATED_DEFAULT_LOCALE;
+export const LOCALE_STORAGE_KEY = "kratos-admin:locale";
+
+const mutableLocale = ref<SupportedLocale>(DEFAULT_LOCALE);
+const mutableLanguageOptions = ref<LocaleOption[]>([]);
+const localeChangeHandlers = new Set<() => void | Promise<void>>();
+
+/** 管理端 Vue I18n 实例。 */
+export const adminI18n = createI18n({
+  legacy: false,
+  locale: DEFAULT_LOCALE,
+  fallbackLocale: DEFAULT_LOCALE,
+  messages: {},
+  missingWarn: false,
+  fallbackWarn: false
+});
+
+/** 规范化任意语言输入到管理端白名单。 */
+export function normalizeLocale(value?: string): SupportedLocale {
+  return parseSupportedLocale(value) ?? DEFAULT_LOCALE;
+}
+
+/** 将接口或系统语言代码解析为已打包的语言区域。 */
+function parseSupportedLocale(value?: string): SupportedLocale | undefined {
+  const normalized = String(value ?? "").replace("_", "-").toLowerCase();
+  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 = requiredLocaleKeys(module.messages[DEFAULT_LOCALE] ?? {});
+    SUPPORTED_LOCALES.forEach(locale => {
+      const messages = module.messages?.[locale];
+      if (!messages) throw new Error(`${module.name} 缺少 ${locale} 语言包`);
+      const keys = requiredLocaleKeys(messages);
+      if (keys.join("\u0000") !== expectedKeys.join("\u0000")) {
+        throw new Error(`${module.name} 的 ${locale} 语言包键集合不一致`);
+      }
+
+      const target = merged.get(locale) as LocaleMessages;
+      Object.keys(messages).forEach(key => {
+        assertLocaleKeyNamespace(module.name, key);
+        if (Object.prototype.hasOwnProperty.call(target, key)) {
+          throw new Error(`${locale} 语言键重复: ${key}`);
+        }
+        assertLocalePlaceholders(module.name, key, messages[key], module.messages?.[DEFAULT_LOCALE]?.[key] ?? "");
+        target[key] = messages[key];
+      });
+    });
+  });
+
+  SUPPORTED_LOCALES.forEach(locale => adminI18n.global.setLocaleMessage(locale, merged.get(locale) ?? {}));
+}
+
+/** 初始化持久化语言偏好并同步日期库。 */
+export function initializeLocale(): SupportedLocale {
+  const stored = window.localStorage.getItem(LOCALE_STORAGE_KEY) ?? "";
+  const preferred = stored || window.navigator.languages?.[0] || window.navigator.language;
+  applyLocale(normalizeLocale(preferred));
+  return mutableLocale.value;
+}
+
+/** 应用后端语言配置，并在当前语言不可用时回退到接口第一项。 */
+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,
+      native_name: item.native_name || languageCode,
+    });
+    return items;
+  }, []);
+  mutableLanguageOptions.value = options.length ? options : getFallbackLanguageOptions();
+  const availableLocales = getSupportedLocales();
+  if (!availableLocales.includes(mutableLocale.value)) {
+    applyLocale(availableLocales[0] ?? DEFAULT_LOCALE);
+  }
+}
+
+/** 获取当前接口配置的语言选项。 */
+export function getLanguageOptions(): LocaleOption[] {
+  return mutableLanguageOptions.value.length ? mutableLanguageOptions.value : getFallbackLanguageOptions();
+}
+
+/** 获取当前可切换的语言区域。 */
+export function getSupportedLocales(): SupportedLocale[] {
+  return getLanguageOptions().map((item) => item.language_code);
+}
+
+/** 获取当前规范语言区域。 */
+export function getCurrentLocale(): SupportedLocale {
+  return mutableLocale.value;
+}
+
+/** 获取非 Axios 请求统一使用的语言头。 */
+export function getLocaleRequestHeaders(): Record<"Accept-Language", SupportedLocale> {
+  return { "Accept-Language": getCurrentLocale() };
+}
+
+/** 切换语言并刷新动态本地化数据。 */
+export async function setCurrentLocale(value: SupportedLocale): Promise<void> {
+  const locale = normalizeLocale(value);
+  if (!getSupportedLocales().includes(locale)) return;
+  if (locale === mutableLocale.value) return;
+  applyLocale(locale);
+  window.localStorage.setItem(LOCALE_STORAGE_KEY, locale);
+  for (const handler of localeChangeHandlers) await handler();
+}
+
+/** 注册语言切换后的动态数据刷新处理器。 */
+export function registerLocaleChangeHandler(handler: () => void | Promise<void>): () => void {
+  localeChangeHandlers.add(handler);
+  return () => localeChangeHandlers.delete(handler);
+}
+
+/** 在非组件代码中翻译稳定语言键。 */
+export function t(key: string, params: LocaleParams = {}): string {
+  return String(adminI18n.global.t(key, params));
+}
+
+/** 管理端响应式语言状态。 */
+export function useLocaleStore() {
+  return {
+    locale: readonly(mutableLocale),
+    localeIndex: computed(() => Math.max(0, getSupportedLocales().indexOf(mutableLocale.value))),
+    languageOptions: computed(() => getLanguageOptions()),
+    supportedLocales: computed(() => getSupportedLocales()),
+    setLocale: setCurrentLocale,
+    t
+  };
+}
+
+function getFallbackLanguageOptions(): LocaleOption[] {
+  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;
+  const dayjsLocale = DAYJS_LOCALE_MAP[locale];
+  if (dayjsLocale) dayjs.locale(dayjsLocale);
+  document.documentElement.lang = locale;
+}
+
+function assertLocaleKeyNamespace(moduleName: string, key: string): void {
+  const valid =
+    moduleName === "kratos-admin" ? key.startsWith("common.") || key.startsWith("core.") : key.startsWith(`${moduleName}.`);
+  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")) {
+    throw new Error(`${moduleName} 的 ${key} 占位符集合不一致`);
+  }
+}