@liujitcn/kratos-admin-core 0.0.19 → 0.0.21

package/README.md

@@ -142,8 +142,8 @@ core 通过 `ADMIN_STATIC_VIEWS` 注册全部默认静态页面，后注册业
 
 ## 公共 Interface
 
-| 能力             | 入口                                                   |
-| ---------------- | ------------------------------------------------------ |
+| 能力             | 入口                                                        |
+| ---------------- | ----------------------------------------------------------- |
 | 应用与模块注册   | `@liujitcn/kratos-admin-core`                               |
 | 请求客户端       | `@liujitcn/kratos-admin-core/request`                       |
 | 路由与跳转       | `@liujitcn/kratos-admin-core/navigation`                    |

package/dist/package/declarations/src/api/base/language.d.ts

@@ -0,0 +1,8 @@
+import type { GetLanguageRequest, GetLanguageResponse, LanguageService } from "../../rpc/base/v1/language";
+/** 语言公共服务。 */
+export declare class LanguageServiceImpl implements LanguageService {
+    /** 查询当前支持的语言和主语言。 */
+    GetLanguage(request: GetLanguageRequest): Promise<GetLanguageResponse>;
+}
+/** 主语言公共服务。 */
+export declare const defLanguageService: LanguageServiceImpl;

package/dist/package/declarations/src/components/Dialog/ProDialog.vue.d.ts

@@ -1,3 +1,4 @@
+/** 通用弹窗组件属性。 */
 interface ProDialogProps {
     modelValue: boolean;
     title?: string;

package/dist/package/declarations/src/components/LocaleSwitch/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./modules";
+export * from "./locales";
+export { defLanguageService } from "./api/base/language";
 export { kratosAdminModule } from "./modules/kratosAdmin";
 export { bootstrapAdminApp } from "./bootstrap";

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

@@ -0,0 +1,63 @@
+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 type { AdminModule } from "../modules";
+import type { GetLanguageResponse } from "../rpc/base/v1/language";
+/** 管理端支持的语言区域。 */
+export declare const SUPPORTED_LOCALES: readonly ["zh-CN", "zh-TW", "en-US", "ja-JP", "ko-KR", "fr-FR", "es-ES"];
+/** 管理端支持的语言区域类型。 */
+export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+/** 单个模块的扁平语言包。 */
+export type LocaleMessages = Record<string, string>;
+/** 翻译插值参数。 */
+export type LocaleParams = Record<string, string | number>;
+/** 运行时语言选项。 */
+export interface LocaleOption {
+    /** 标准语言代码。 */
+    language_code: SupportedLocale;
+    /** 语言名称。 */
+    language_name: string;
+    /** 本地语言名称。 */
+    native_name: string;
+    /** 排序值。 */
+    sort: number;
+}
+export declare const DEFAULT_LOCALE: SupportedLocale;
+export declare const LOCALE_STORAGE_KEY = "kratos-admin:locale";
+/** 管理端 Vue I18n 实例。 */
+export declare const adminI18n: import("vue-i18n").I18n<{}, {}, {}, "zh-CN", false>;
+/** 规范化任意语言输入到管理端白名单。 */
+export declare function normalizeLocale(value?: string): SupportedLocale;
+/** 注册模块语言包并校验七语键、占位符和命名空间。 */
+export declare function registerLocaleMessages(modules: AdminModule[]): void;
+/** 初始化持久化语言偏好并同步日期库。 */
+export declare function initializeLocale(): SupportedLocale;
+/** 应用后端语言配置，并在当前语言不可用时回退到接口主语言。 */
+export declare function applyLanguageConfig(response: GetLanguageResponse): void;
+/** 获取当前接口配置的语言选项。 */
+export declare function getLanguageOptions(): LocaleOption[];
+/** 获取当前可切换的语言区域。 */
+export declare function getSupportedLocales(): SupportedLocale[];
+/** 获取当前规范语言区域。 */
+export declare function getCurrentLocale(): SupportedLocale;
+/** 获取非 Axios 请求统一使用的语言头。 */
+export declare function getLocaleRequestHeaders(): Record<"Accept-Language", SupportedLocale>;
+/** 切换语言并刷新动态本地化数据。 */
+export declare function setCurrentLocale(value: SupportedLocale): Promise<void>;
+/** 注册语言切换后的动态数据刷新处理器。 */
+export declare function registerLocaleChangeHandler(handler: () => void | Promise<void>): () => void;
+/** 在非组件代码中翻译稳定语言键。 */
+export declare function t(key: string, params?: LocaleParams): string;
+/** 管理端响应式语言状态。 */
+export declare function useLocaleStore(): {
+    locale: Readonly<globalThis.Ref<"zh-CN" | "zh-TW" | "en-US" | "ja-JP" | "ko-KR" | "fr-FR" | "es-ES", "zh-CN" | "zh-TW" | "en-US" | "ja-JP" | "ko-KR" | "fr-FR" | "es-ES">>;
+    localeIndex: globalThis.ComputedRef<number>;
+    languageOptions: globalThis.ComputedRef<LocaleOption[]>;
+    supportedLocales: globalThis.ComputedRef<("zh-CN" | "zh-TW" | "en-US" | "ja-JP" | "ko-KR" | "fr-FR" | "es-ES")[]>;
+    setLocale: typeof setCurrentLocale;
+    t: typeof t;
+};

package/dist/package/declarations/src/modules/index.d.ts

@@ -1,5 +1,6 @@
 import type { Component } from "vue";
 import type { RouteLocationNormalizedLoaded } from "vue-router";
+import type { LocaleMessages, SupportedLocale } from "../locales";
 /**
  * 管理端视图加载器。
  */
@@ -35,8 +36,10 @@ export interface AdminHeaderTool {
 export interface AdminUserMenuAction {
     /** 操作唯一名称。 */
     name: string;
-    /** 操作显示名称。 */
-    label: string;
+    /** 操作显示名称对应的稳定语言键。 */
+    labelKey?: string;
+    /** 兼容未迁移模块的静态显示名称。 */
+    label?: string;
     /** 对应后端动态菜单名称，菜单不存在时不显示操作。 */
     menuName: string;
     /** 操作图标。 */
@@ -65,6 +68,8 @@ export interface AdminModule {
     routeOptions?: Record<string, AdminRouteOptions>;
     /** 模块提供的命名扩展，由扩展所属业务包定义具体类型。 */
     extensions?: Record<string, unknown>;
+    /** 模块按语言区域贡献的扁平语言包。 */
+    messages?: Partial<Record<SupportedLocale, LocaleMessages>>;
 }
 /**
  * 声明一个可被管理端宿主注册的模块。

package/dist/package/declarations/src/request.d.ts

@@ -1,2 +1,3 @@
 export { default } from "./utils/request";
 export { ensureAccessToken, getRequestAccessToken, handleAuthExpired, hasValidAccessToken, requestBaseURL } from "./utils/request";
+export { getLocaleRequestHeaders } from "./locales";

package/dist/package/declarations/src/routers/modules/staticRouter.d.ts

@@ -14,6 +14,7 @@ export declare const errorRouter: ({
     }>;
     meta: {
         title: string;
+        titleKey: string;
     };
 } | {
     path: string;

package/dist/package/declarations/src/rpc/base/v1/config.d.ts

@@ -6,6 +6,8 @@ export interface GetConfigRequest {
 }
 /** 系统配置项 */
 export interface ConfigItem {
+    /** 配置ID */
+    id: number;
     /** 配置key */
     key: string;
     /** 配置value */

package/dist/package/declarations/src/rpc/base/v1/language.d.ts

@@ -0,0 +1,26 @@
+/** 查询语言请求参数。 */
+export interface GetLanguageRequest {
+}
+/** 支持的语言。 */
+export interface LanguageItem {
+    /** 标准语言代码 */
+    language_code: string;
+    /** 语言名称 */
+    language_name: string;
+    /** 本地语言名称 */
+    native_name: string;
+    /** 排序，值越小越靠前 */
+    sort: number;
+}
+/** 当前支持的语言查询结果。 */
+export interface GetLanguageResponse {
+    /** 当前支持的语言列表 */
+    languages: LanguageItem[];
+    /** 主语言代码 */
+    primary_language_code: string;
+}
+/** 语言公共服务。 */
+export interface LanguageService {
+    /** 查询当前支持的语言和主语言。 */
+    GetLanguage(request: GetLanguageRequest): Promise<GetLanguageResponse>;
+}

package/dist/package/declarations/src/rpc/system/admin/v1/base_dict.d.ts

@@ -1,5 +1,6 @@
 import type { Status } from "../../../common/v1/enum";
 import type { Empty } from "../../../google/protobuf/empty";
+import type { TranslationStatus } from "./base_translation";
 /** 字典选项查询条件 */
 export interface OptionBaseDictRequest {
 }
@@ -79,6 +80,8 @@ export interface BaseDictForm {
     code: string;
     /** 字典名称 */
     name: string;
+    /** 非主语言翻译 */
+    translations: BaseDictTranslation[];
     /** 状态 */
     status: Status;
 }
@@ -101,6 +104,8 @@ export interface BaseDictItemForm {
     tag_type: string;
     /** 排序 */
     sort: number;
+    /** 非主语言翻译 */
+    translations: BaseDictItemTranslation[];
     /** 状态 */
     status: Status;
 }
@@ -156,6 +161,8 @@ export interface BaseDict {
     code: string;
     /** 字典名称 */
     name: string;
+    /** 非主语言翻译 */
+    translations: BaseDictTranslation[];
     /** 状态 */
     status: Status;
     /** 创建时间 */
@@ -177,6 +184,8 @@ export interface BaseDictItem {
     tag_type: string;
     /** 排序 */
     sort: number;
+    /** 非主语言翻译 */
+    translations: BaseDictItemTranslation[];
     /** 状态 */
     status: Status;
     /** 创建时间 */
@@ -184,6 +193,76 @@ export interface BaseDictItem {
     /** 更新时间 */
     updated_at: string;
 }
+/** 字典翻译 */
+export interface BaseDictTranslation {
+    /** 主键ID */
+    id: number;
+    /** 字典ID */
+    dict_id: number;
+    /** 语言代码 */
+    locale: string;
+    /** 字典名称 */
+    name: string;
+    /** 翻译状态 */
+    translation_status: TranslationStatus;
+    /** 中文源文SHA-256 */
+    source_hash: string;
+    /** 机器翻译提供方 */
+    translation_provider: string;
+    /** 最近机器翻译时间 */
+    translated_at: string;
+    /** 审核人ID */
+    reviewed_by: number;
+    /** 审核时间 */
+    reviewed_at: string;
+    /** 创建人ID */
+    created_by: number;
+    /** 更新人ID */
+    updated_by: number;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 删除时间 */
+    deleted_at: number;
+    /** 中文源文是否已变化 */
+    source_changed: boolean;
+}
+/** 字典项翻译 */
+export interface BaseDictItemTranslation {
+    /** 主键ID */
+    id: number;
+    /** 字典项ID */
+    dict_item_id: number;
+    /** 语言代码 */
+    locale: string;
+    /** 字典项标签 */
+    label: string;
+    /** 翻译状态 */
+    translation_status: TranslationStatus;
+    /** 中文源文SHA-256 */
+    source_hash: string;
+    /** 机器翻译提供方 */
+    translation_provider: string;
+    /** 最近机器翻译时间 */
+    translated_at: string;
+    /** 审核人ID */
+    reviewed_by: number;
+    /** 审核时间 */
+    reviewed_at: string;
+    /** 创建人ID */
+    created_by: number;
+    /** 更新人ID */
+    updated_by: number;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 删除时间 */
+    deleted_at: number;
+    /** 中文源文是否已变化 */
+    source_changed: boolean;
+}
 /** Admin字典服务 */
 export interface BaseDictService {
     /** 查询字典列表 */

package/dist/package/declarations/src/rpc/system/admin/v1/base_translation.d.ts

@@ -0,0 +1,102 @@
+/** 翻译状态 */
+export declare enum TranslationStatus {
+    TRANSLATION_STATUS_UNSPECIFIED = 0,
+    TRANSLATION_STATUS_PENDING = 1,
+    TRANSLATION_STATUS_MACHINE = 2,
+    TRANSLATION_STATUS_REVIEWED = 3
+}
+/** 翻译资源类型 */
+export declare enum TranslationResourceType {
+    TRANSLATION_RESOURCE_TYPE_UNSPECIFIED = 0,
+    TRANSLATION_RESOURCE_TYPE_MENU = 1,
+    TRANSLATION_RESOURCE_TYPE_DICT = 2,
+    TRANSLATION_RESOURCE_TYPE_DICT_ITEM = 3,
+    TRANSLATION_RESOURCE_TYPE_CONFIG = 4
+}
+/** 系统配置翻译字段 */
+export declare enum BaseConfigTranslationField {
+    BASE_CONFIG_TRANSLATION_FIELD_UNSPECIFIED = 0,
+    BASE_CONFIG_TRANSLATION_FIELD_NAME = 1,
+    BASE_CONFIG_TRANSLATION_FIELD_VALUE = 2
+}
+/** 生成翻译草稿请求 */
+export interface GenerateTranslationDraftRequest {
+    /** 资源类型 */
+    resource_type: TranslationResourceType;
+    /** 已保存资源ID */
+    resource_id: number;
+    /** 目标语言代码 */
+    target_locale: string;
+    /** 系统配置翻译字段，配置资源必填 */
+    field: BaseConfigTranslationField;
+}
+/** 生成翻译草稿响应 */
+export interface GenerateTranslationDraftResponse {
+    /** 资源类型 */
+    resource_type: TranslationResourceType;
+    /** 资源ID */
+    resource_id: number;
+    /** 语言区域 */
+    locale: string;
+    /** 机器翻译草稿 */
+    translation: string;
+    /** 翻译状态 */
+    translation_status: TranslationStatus;
+    /** 中文源文SHA-256 */
+    source_hash: string;
+    /** 机器翻译提供方 */
+    translation_provider: string;
+    /** 最近机器翻译时间 */
+    translated_at: string;
+    /** 系统配置翻译字段 */
+    field: BaseConfigTranslationField;
+}
+/** 系统配置单语言翻译 */
+export interface BaseConfigTranslation {
+    /** 翻译记录ID */
+    id: number;
+    /** 系统配置ID */
+    config_id: number;
+    /** 语言区域 */
+    locale: string;
+    /** 翻译字段：name或value */
+    field: BaseConfigTranslationField;
+    /** 翻译文本 */
+    text: string;
+    /** 翻译审核状态 */
+    translation_status: TranslationStatus;
+    /** 中文源文SHA-256 */
+    source_hash: string;
+    /** 中文源文是否已变化 */
+    source_changed: boolean;
+    /** 机器翻译提供方 */
+    translation_provider: string;
+    /** 最近机器翻译时间 */
+    translated_at: string;
+    /** 审核人ID */
+    reviewed_by: number;
+    /** 审核时间 */
+    reviewed_at: string;
+    /** 创建人ID */
+    created_by: number;
+    /** 更新人ID */
+    updated_by: number;
+    /** 创建时间 */
+    created_at: string;
+    /** 更新时间 */
+    updated_at: string;
+    /** 删除时间 */
+    deleted_at: number;
+}
+/** 代码生成单语言国际化配置 */
+export interface CodeGenLocaleConfig {
+    /** 业务或字段描述 */
+    comment: string;
+    /** 左树描述 */
+    left_tree_comment: string;
+}
+/** Admin翻译草稿服务 */
+export interface BaseTranslationService {
+    /** 为单个已保存资源生成机器翻译草稿 */
+    GenerateTranslationDraft(request: GenerateTranslationDraftRequest): Promise<GenerateTranslationDraftResponse>;
+}

package/dist/package/declarations/src/stores/interface/index.d.ts

@@ -87,4 +87,6 @@ export interface SiteConfigState {
     display: SiteDisplayConfig;
     /** 当前登录验证码配置 */
     captcha: LoginCaptchaConfig;
+    /** 是否允许显式生成机器翻译草稿。 */
+    translationDraftEnabled: boolean;
 }

package/dist/package/declarations/src/stores/runtime.d.ts

@@ -1,4 +1,5 @@
 export { useAuthStore } from "./modules/auth";
+export { useConfigStore } from "./modules/config";
 export { useGlobalStore } from "./modules/global";
 export { useTabsStore } from "./modules/tabs";
 export { useUserStore } from "./modules/user";

package/dist/package/declarations/src/utils/dict.d.ts

@@ -2,14 +2,14 @@
  * @description：用户性别
  */
 export declare const genderType: {
-    label: string;
+    readonly label: string;
     value: number;
 }[];
 /**
  * @description：用户状态
  */
 export declare const userStatus: {
-    label: string;
+    readonly label: string;
     value: number;
     tagType: string;
 }[];

package/dist/package/declarations/src/utils/index.d.ts

@@ -90,7 +90,7 @@ export declare function randomNum(min: number, max: number): number;
  * @description 获取当前时间对应的提示语
  * @returns {String}
  */
-export declare function getTimeState(): "早上好 ⛅" | "中午好 🌞" | "下午好 🌞" | "晚上好 🌛" | "凌晨好 🌛" | undefined;
+export declare function getTimeState(): string;
 /**
  * @description 获取不同路由模式所对应的 url + params
  * @returns {String}

package/dist/package/declarations/src/utils/oauthProvider.d.ts

@@ -3,6 +3,8 @@ import { type Component } from "vue";
 export interface OauthProviderDisplay {
     /** 登录方式名称。 */
     name: string;
+    /** 登录方式名称对应的稳定语言键。 */
+    nameKey: string;
     /** 登录方式图标标识。 */
     icon: string;
 }

package/dist/package/declarations/src/utils/passwordStrength.d.ts

@@ -8,15 +8,9 @@ export interface PasswordStrengthResult {
     strengthScore: number;
     /** 强度等级。 */
     level: PasswordStrengthLevel;
-    /** 强度文案。 */
-    text: string;
     /** 是否达到允许提交的最高强度。 */
     isValid: boolean;
 }
-/** 密码强度错误提示。 */
-export declare const PASSWORD_STRENGTH_ERROR_MESSAGE = "\u5BC6\u7801\u9700\u540C\u65F6\u5305\u542B\u5927\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u7279\u6B8A\u5B57\u7B26\uFF0C\u4E14\u957F\u5EA6\u4E0D\u5C11\u4E8E 8 \u4F4D";
-/** 密码强度说明文案。 */
-export declare const PASSWORD_STRENGTH_TIP = "\u9700\u540C\u65F6\u5305\u542B\u5927\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u7279\u6B8A\u5B57\u7B26\uFF0C\u4E14\u957F\u5EA6\u4E0D\u5C11\u4E8E 8 \u4F4D\uFF0C\u8FBE\u5230\u6700\u9AD8\u5F3A\u5EA6\u540E\u624D\u53EF\u63D0\u4EA4\u3002";
 /**
  * 计算密码强度结果，供表单展示和校验统一复用。
  *
@@ -32,5 +26,4 @@ export declare function getPasswordStrength(password?: string): PasswordStrength
  */
 export declare function validatePasswordStrengthValue(password?: string): {
     valid: boolean;
-    message: string;
 };

package/dist/package/src/App.vue

@@ -1,5 +1,5 @@
 <template>
-  <el-config-provider :locale="zhCn" :size="assemblySize" :button="buttonConfig">
+  <el-config-provider :locale="elementLocale" :size="assemblySize" :button="buttonConfig">
     <router-view></router-view>
   </el-config-provider>
 </template>
@@ -9,9 +9,18 @@ import { reactive, computed } from "vue";
 import { useTheme } from "./hooks/useTheme";
 import { ElConfigProvider } from "element-plus";
 import { useGlobalStore } from "./stores/modules/global";
+import { useLocaleStore } from "./locales";
+import en from "element-plus/es/locale/lang/en";
+import ja from "element-plus/es/locale/lang/ja";
 import zhCn from "element-plus/es/locale/lang/zh-cn";
+import zhTw from "element-plus/es/locale/lang/zh-tw";
+import ko from "element-plus/es/locale/lang/ko";
+import fr from "element-plus/es/locale/lang/fr";
+import es from "element-plus/es/locale/lang/es";
 
 const globalStore = useGlobalStore();
+const { locale } = useLocaleStore();
+const elementLocale = computed(() => ({ "zh-CN": zhCn, "zh-TW": zhTw, "en-US": en, "ja-JP": ja, "ko-KR": ko, "fr-FR": fr, "es-ES": es })[locale.value]);
 
 // init theme
 const { initTheme } = useTheme();

package/dist/package/src/api/base/language.ts

@@ -0,0 +1,20 @@
+import service from "../../utils/request";
+import type { GetLanguageRequest, GetLanguageResponse, LanguageService } from "../../rpc/base/v1/language";
+
+const LANGUAGE_URL = "/v1/base/language";
+
+/** 语言公共服务。 */
+export class LanguageServiceImpl implements LanguageService {
+  /** 查询当前支持的语言和主语言。 */
+  GetLanguage(request: GetLanguageRequest): Promise<GetLanguageResponse> {
+    return service<GetLanguageRequest, GetLanguageResponse>({
+      url: LANGUAGE_URL,
+      method: "get",
+      params: request,
+      headers: { Authorization: "no-auth" }
+    });
+  }
+}
+
+/** 主语言公共服务。 */
+export const defLanguageService = new LanguageServiceImpl();

package/dist/package/src/api/base/oauth.ts

@@ -43,7 +43,6 @@ export class OauthServiceImpl {
       headers: { Authorization: "no-auth" }
     });
   }
-
 }
 
 /** defOauthService 三方登录服务实例。 */

package/dist/package/src/api/system/auth.ts

@@ -38,7 +38,6 @@ export class AuthServiceImpl {
       params: request
     });
   }
-
 }
 
 /** defAuthService 管理端运行壳认证服务实例。 */

package/dist/package/src/bootstrap.ts

@@ -22,6 +22,13 @@ import { useConfigStore } from "./stores/modules/config";
 import { kratosAdminModule } from "./modules/kratosAdmin";
 import { registerAdminModules } from "./modules";
 import type { AdminModule } from "./modules";
+import { adminI18n, applyLanguageConfig, initializeLocale, registerLocaleChangeHandler, registerLocaleMessages, t } from "./locales";
+import { useAuthStore } from "./stores/modules/auth";
+import { useDictStore } from "./stores/modules/dict";
+import { useTabsStore } from "./stores/modules/tabs";
+import { useUserStore } from "./stores/modules/user";
+import { getRouteMetaTitle } from "./utils";
+import { defLanguageService } from "./api/base/language";
 
 /**
  * 管理端启动参数。
@@ -37,7 +44,15 @@ export interface AdminBootstrapOptions {
  * 创建并启动管理端应用，业务项目可通过 modules 注册自己的页面。
  */
 export async function bootstrapAdminApp(options: AdminBootstrapOptions = {}) {
-  registerAdminModules([kratosAdminModule, ...(options.modules ?? [])]);
+  const modules = [kratosAdminModule, ...(options.modules ?? [])];
+  registerAdminModules(modules);
+  registerLocaleMessages(modules);
+  initializeLocale();
+  try {
+    applyLanguageConfig(await defLanguageService.GetLanguage({}));
+  } catch {
+    // 语言公共接口失败时继续使用静态语言包和系统语言。
+  }
 
   const app = createApp(App);
 
@@ -56,7 +71,8 @@ export async function bootstrapAdminApp(options: AdminBootstrapOptions = {}) {
   // 按需加载模式不会自动注册 v-loading 指令，需要显式挂载。
   app.directive("loading", ElLoading.directive);
 
-  app.use(directives).use(pinia).use(router);
+  app.use(directives).use(pinia).use(router).use(adminI18n);
+  registerLocaleChangeHandler(refreshLocalizedRuntimeData);
 
   try {
     await useConfigStore().loadDisplayConfig();
@@ -67,3 +83,42 @@ export async function bootstrapAdminApp(options: AdminBootstrapOptions = {}) {
   app.mount(options.mount ?? "#app");
   return app;
 }
+
+/** 刷新当前语言对应的菜单、字典、页签和页面标题。 */
+async function refreshLocalizedRuntimeData() {
+  const userStore = useUserStore(pinia);
+  const authStore = useAuthStore(pinia);
+  const dictStore = useDictStore(pinia);
+  const configStore = useConfigStore(pinia);
+  await Promise.allSettled([configStore.loadDisplayConfig()]);
+  if (userStore.token || userStore.refreshToken) {
+    await Promise.allSettled([authStore.getAuthMenuList(), dictStore.updateDictionaryCache()]);
+    syncLocalizedRouteState();
+  }
+  updateDocumentTitle();
+}
+
+function syncLocalizedRouteState() {
+  const authStore = useAuthStore(pinia);
+  const tabsStore = useTabsStore(pinia);
+  const menuMap = new Map(authStore.flatMenuListGet.flatMap(item => (item.name ? [[item.name, item] as const] : [])));
+
+  router.getRoutes().forEach(record => {
+    const menu = typeof record.name === "string" ? menuMap.get(record.name) : undefined;
+    if (menu?.meta) Object.assign(record.meta, menu.meta);
+  });
+  tabsStore.setTabs(
+    tabsStore.tabsMenuList.map(tab => {
+      const menu = menuMap.get(tab.name);
+      return menu ? { ...tab, title: getRouteMetaTitle(menu.meta) } : tab;
+    })
+  );
+}
+
+function updateDocumentTitle() {
+  const route = router.currentRoute.value;
+  const titleKey = typeof route.meta.titleKey === "string" ? route.meta.titleKey : "";
+  const routeTitle = titleKey ? t(titleKey) : String(route.meta.title ?? "");
+  const appTitle = import.meta.env.VITE_GLOB_APP_TITLE;
+  document.title = routeTitle ? `${routeTitle} - ${appTitle}` : appTitle;
+}