@axewo/fin-locale 3.0.0 → 3.0.2

package/README.md

@@ -20,6 +20,24 @@ setLocale('en')
 
 业务 `messages` 为 `{ 'zh-CN': {...}, en: {...} }`，递归合并公共词条；业务命名空间建议独立于 `fin.*`。使用 fin-ui 的 `FinLocaleProvider` 让 Fin UI 和 Element Plus 跟随同一语言与尺寸。
 
-包根导出 `zhCN`、`en`、`createFinI18n`、`installFinI18n`、`useFinLocale`、`normalizeFinLocale`、`translateFinBuiltin`、`useFinText`。规范子路径为 `/locales/zh-CN` 和 `/locales/en`，旧 `/lang/zh-CN`、`/lang/en` 保留兼容；源码只维护 `src/locales`。
+需要刷新保留语言时，在应用首次渲染前连接持久化，并在卸载或启动失败时释放：
+
+```ts
+import type { Composer } from 'vue-i18n'
+import { connectFinLocaleStorage, installFinI18n } from '@axewo/fin-locale'
+
+const i18n = installFinI18n(app, { messages })!
+const stopLocaleStorage = connectFinLocaleStorage(
+  (i18n.global as Composer).locale,
+  'my-workspace:locale',
+)
+// 应用卸载/启动失败：stopLocaleStorage()
+```
+
+连接时读取已保存的语言，后续变化同步写入 localStorage；首次连接不写入默认值。历史 `en_US` 等标识统一归一化，非法存储值保留当前默认语言。支持 `ja-JP` 等扩展语种，缺失词条默认回退中文；无浏览器或存储不可用时继续使用内存语言。每个应用使用独立键；嵌入子应用只跟随宿主偏好，不连接自身的语言存储。持久化仅处理 UI 语言，不用于后台多语言业务字段。
+
+`setLocale` 使用 `normalizeAppLocale`：中英文别名仍归一化为 `zh-CN`、`en`，其他有效语言标识按 BCP 47 规范保留。扩展语言词条放在 `messages['ja-JP']` 等对应键下；只有语言列表不会自动生成翻译。`normalizeFinLocale` 保留原有仅识别内置中英文的行为，供内置文案和组件库语言回退使用。
+
+包根导出 `zhCN`、`en`、`createFinI18n`、`installFinI18n`、`useFinLocale`、`normalizeAppLocale`、`normalizeFinLocale`、`translateFinBuiltin`、`useFinText`、`connectFinLocaleStorage`。规范子路径为 `/locales/zh-CN` 和 `/locales/en`，旧 `/lang/zh-CN`、`/lang/en` 保留兼容；源码只维护 `src/locales`。
 
 `useFinText` 供可独立使用的公共展示组件读取当前 App 的翻译，未注入时回退中文；业务页面应使用 `useFinLocale`。非 Vue 启动边界使用 `translateFinBuiltin(key, locale)`，不创建共享全局实例。

package/dist/create-i18n.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("vue-i18n"),L=require("vue"),o=require("@axewo/fin-core/locale"),F=require("./locales/zh-CN/index.cjs"),p=require("./locales/zh-CN/formula-additions.cjs"),M=require("./locales/en/index.cjs"),_=require("./locales/en/formula-additions.cjs"),d=require("./locales/zh-CN/platform.cjs"),I=require("./locales/en/platform.cjs");function r(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}const i=o.mergeLocaleMessages(o.mergeLocaleMessages(F,p),d),a=o.mergeLocaleMessages(o.mergeLocaleMessages(M,_),I);function g(e,t="zh-CN"){let n=o.normalizeFinLocale(t)==="en"?a:i;for(const s of e.split("."))n=r(n)?n[s]:void 0;return typeof n=="string"?n:e}function z(e){const t={"zh-CN":o.mergeLocaleMessages({},i),en:o.mergeLocaleMessages({},a)};if(!r(e))return t;for(const[n,s]of Object.entries(e))r(s)&&(t[n]=t[n]?o.mergeLocaleMessages(t[n],s):o.mergeLocaleMessages({},s));return t}function f(e){const{messages:t,...n}=e||{};return u.createI18n({locale:"zh-CN",fallbackLocale:"zh-CN",legacy:!1,...n,messages:z(t)})}function m(){const{t:e,locale:t}=u.useI18n({useScope:"global"});return{t:e,locale:t,setLocale:n=>{t.value=o.normalizeFinLocale(n)}}}function b(){var n;const e=(n=L.getCurrentInstance())==null?void 0:n.appContext.app;if(!(e!=null&&e.__VUE_I18N_SYMBOL__))return s=>g(s);const{t}=m();return s=>t(s)}function q(e,t){const n=e,s=n.__VUE_I18N_SYMBOL__;if(s){const l=n._context.provides[s];if(l)return l}const c=f(t);return e.use(c),c}Object.defineProperty(exports,"normalizeFinLocale",{enumerable:!0,get:()=>o.normalizeFinLocale});exports.createFinI18n=f;exports.en=a;exports.installFinI18n=q;exports.translateFinBuiltin=g;exports.useFinLocale=m;exports.useFinText=b;exports.zhCN=i;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("vue-i18n"),p=require("vue"),o=require("@axewo/fin-core/locale"),L=require("./locales/zh-CN/index.cjs"),z=require("./locales/zh-CN/formula-additions.cjs"),F=require("./locales/en/index.cjs"),M=require("./locales/en/formula-additions.cjs"),_=require("./locales/zh-CN/platform.cjs"),b=require("./locales/en/platform.cjs");function a(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}const i=o.mergeLocaleMessages(o.mergeLocaleMessages(L,z),_),l=o.mergeLocaleMessages(o.mergeLocaleMessages(F,M),b);function g(e,t="zh-CN"){let n=o.normalizeFinLocale(t)==="en"?l:i;for(const s of e.split("."))n=a(n)?n[s]:void 0;return typeof n=="string"?n:e}function d(e){const t={"zh-CN":o.mergeLocaleMessages({},i),en:o.mergeLocaleMessages({},l)};if(!a(e))return t;for(const[n,s]of Object.entries(e)){const r=o.normalizeAppLocale(n,"");!r||!a(s)||(t[r]=t[r]?o.mergeLocaleMessages(t[r],s):o.mergeLocaleMessages({},s))}return t}function f(e){const{messages:t,...n}=e||{};return u.createI18n({fallbackLocale:"zh-CN",legacy:!1,missingWarn:!1,fallbackWarn:!1,...n,locale:o.normalizeAppLocale(n.locale),messages:d(t)})}function m(){const{t:e,locale:t}=u.useI18n({useScope:"global"});return{t:e,locale:t,setLocale:n=>{t.value=o.normalizeAppLocale(n)}}}function I(){var n;const e=(n=p.getCurrentInstance())==null?void 0:n.appContext.app;if(!(e!=null&&e.__VUE_I18N_SYMBOL__))return s=>g(s);const{t}=m();return s=>t(s)}function q(e,t){const n=e,s=n.__VUE_I18N_SYMBOL__;if(s){const c=n._context.provides[s];if(c)return c}const r=f(t);return e.use(r),r}Object.defineProperty(exports,"normalizeAppLocale",{enumerable:!0,get:()=>o.normalizeAppLocale});Object.defineProperty(exports,"normalizeFinLocale",{enumerable:!0,get:()=>o.normalizeFinLocale});exports.createFinI18n=f;exports.en=l;exports.installFinI18n=q;exports.translateFinBuiltin=g;exports.useFinLocale=m;exports.useFinText=I;exports.zhCN=i;

package/dist/create-i18n.mjs

@@ -1,76 +1,81 @@
 import { createI18n as m, useI18n as u } from "vue-i18n";
 import { getCurrentInstance as p } from "vue";
-import { mergeLocaleMessages as r, normalizeFinLocale as c } from "@axewo/fin-core/locale";
-import { normalizeFinLocale as U } from "@axewo/fin-core/locale";
-import g from "./locales/zh-CN/index.mjs";
-import _ from "./locales/zh-CN/formula-additions.mjs";
-import z from "./locales/en/index.mjs";
-import h from "./locales/en/formula-additions.mjs";
-import C from "./locales/zh-CN/platform.mjs";
-import F from "./locales/en/platform.mjs";
-function s(e) {
+import { mergeLocaleMessages as r, normalizeAppLocale as a, normalizeFinLocale as g } from "@axewo/fin-core/locale";
+import { normalizeAppLocale as U, normalizeFinLocale as V } from "@axewo/fin-core/locale";
+import _ from "./locales/zh-CN/index.mjs";
+import z from "./locales/zh-CN/formula-additions.mjs";
+import L from "./locales/en/index.mjs";
+import F from "./locales/en/formula-additions.mjs";
+import h from "./locales/zh-CN/platform.mjs";
+import C from "./locales/en/platform.mjs";
+function i(e) {
   return typeof e == "object" && e !== null && !Array.isArray(e);
 }
-const l = r(r(g, _), C), f = r(r(z, h), F);
-function N(e, n = "zh-CN") {
-  let t = c(n) === "en" ? f : l;
-  for (const o of e.split(".")) t = s(t) ? t[o] : void 0;
-  return typeof t == "string" ? t : e;
+const l = r(r(_, z), h), f = r(r(L, F), C);
+function I(e, o = "zh-CN") {
+  let n = g(o) === "en" ? f : l;
+  for (const t of e.split(".")) n = i(n) ? n[t] : void 0;
+  return typeof n == "string" ? n : e;
 }
-function I(e) {
-  const n = {
+function N(e) {
+  const o = {
     "zh-CN": r({}, l),
     en: r({}, f)
   };
-  if (!s(e))
-    return n;
-  for (const [t, o] of Object.entries(e))
-    s(o) && (n[t] = n[t] ? r(n[t], o) : r({}, o));
-  return n;
+  if (!i(e))
+    return o;
+  for (const [n, t] of Object.entries(e)) {
+    const s = a(n, "");
+    !s || !i(t) || (o[s] = o[s] ? r(o[s], t) : r({}, t));
+  }
+  return o;
 }
-function L(e) {
-  const { messages: n, ...t } = e || {};
+function b(e) {
+  const { messages: o, ...n } = e || {};
   return m({
-    locale: "zh-CN",
     fallbackLocale: "zh-CN",
     legacy: !1,
-    ...t,
-    messages: I(n)
+    missingWarn: !1,
+    fallbackWarn: !1,
+    ...n,
+    locale: a(n.locale),
+    messages: N(o)
   });
 }
 function d() {
-  const { t: e, locale: n } = u({ useScope: "global" });
+  const { t: e, locale: o } = u({ useScope: "global" });
   return {
     t: e,
-    locale: n,
-    setLocale: (t) => {
-      n.value = c(t);
+    locale: o,
+    setLocale: (n) => {
+      o.value = a(n);
     }
   };
 }
 function v() {
-  var t;
-  const e = (t = p()) == null ? void 0 : t.appContext.app;
-  if (!(e != null && e.__VUE_I18N_SYMBOL__)) return (o) => N(o);
-  const { t: n } = d();
-  return (o) => n(o);
+  var n;
+  const e = (n = p()) == null ? void 0 : n.appContext.app;
+  if (!(e != null && e.__VUE_I18N_SYMBOL__)) return (t) => I(t);
+  const { t: o } = d();
+  return (t) => o(t);
 }
-function E(e, n) {
-  const t = e, o = t.__VUE_I18N_SYMBOL__;
-  if (o) {
-    const a = t._context.provides[o];
-    if (a)
-      return a;
+function E(e, o) {
+  const n = e, t = n.__VUE_I18N_SYMBOL__;
+  if (t) {
+    const c = n._context.provides[t];
+    if (c)
+      return c;
   }
-  const i = L(n);
-  return e.use(i), i;
+  const s = b(o);
+  return e.use(s), s;
 }
 export {
-  L as createFinI18n,
+  b as createFinI18n,
   f as en,
   E as installFinI18n,
-  U as normalizeFinLocale,
-  N as translateFinBuiltin,
+  U as normalizeAppLocale,
+  V as normalizeFinLocale,
+  I as translateFinBuiltin,
   d as useFinLocale,
   v as useFinText,
   l as zhCN

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./create-i18n.cjs"),n=require("./locales/zh-CN/formula-additions.cjs"),i=require("./locales/en/formula-additions.cjs"),t=require("@axewo/fin-core/locale");exports.createFinI18n=e.createFinI18n;exports.en=e.en;exports.installFinI18n=e.installFinI18n;exports.translateFinBuiltin=e.translateFinBuiltin;exports.useFinLocale=e.useFinLocale;exports.useFinText=e.useFinText;exports.zhCN=e.zhCN;exports.zhCNFormulaAdditions=n;exports.enFormulaAdditions=i;Object.defineProperty(exports,"normalizeFinLocale",{enumerable:!0,get:()=>t.normalizeFinLocale});
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./create-i18n.cjs"),i=require("./storage.cjs"),t=require("./locales/zh-CN/formula-additions.cjs"),r=require("./locales/en/formula-additions.cjs"),n=require("@axewo/fin-core/locale");exports.createFinI18n=e.createFinI18n;exports.en=e.en;exports.installFinI18n=e.installFinI18n;exports.translateFinBuiltin=e.translateFinBuiltin;exports.useFinLocale=e.useFinLocale;exports.useFinText=e.useFinText;exports.zhCN=e.zhCN;exports.connectFinLocaleStorage=i.connectFinLocaleStorage;exports.zhCNFormulaAdditions=t;exports.enFormulaAdditions=r;Object.defineProperty(exports,"normalizeAppLocale",{enumerable:!0,get:()=>n.normalizeAppLocale});Object.defineProperty(exports,"normalizeFinLocale",{enumerable:!0,get:()=>n.normalizeFinLocale});

package/dist/index.mjs

@@ -1,16 +1,19 @@
-import { createFinI18n as o, en as i, installFinI18n as t, translateFinBuiltin as a, useFinLocale as r, useFinText as l, zhCN as s } from "./create-i18n.mjs";
-import { default as m } from "./locales/zh-CN/formula-additions.mjs";
-import { default as d } from "./locales/en/formula-additions.mjs";
-import { normalizeFinLocale as x } from "@axewo/fin-core/locale";
+import { createFinI18n as n, en as a, installFinI18n as r, translateFinBuiltin as t, useFinLocale as i, useFinText as l, zhCN as m } from "./create-i18n.mjs";
+import { connectFinLocaleStorage as s } from "./storage.mjs";
+import { default as f } from "./locales/zh-CN/formula-additions.mjs";
+import { default as u } from "./locales/en/formula-additions.mjs";
+import { normalizeAppLocale as x, normalizeFinLocale as z } from "@axewo/fin-core/locale";
 export {
-  o as createFinI18n,
-  i as en,
-  d as enFormulaAdditions,
-  t as installFinI18n,
-  x as normalizeFinLocale,
-  a as translateFinBuiltin,
-  r as useFinLocale,
+  s as connectFinLocaleStorage,
+  n as createFinI18n,
+  a as en,
+  u as enFormulaAdditions,
+  r as installFinI18n,
+  x as normalizeAppLocale,
+  z as normalizeFinLocale,
+  t as translateFinBuiltin,
+  i as useFinLocale,
   l as useFinText,
-  s as zhCN,
-  m as zhCNFormulaAdditions
+  m as zhCN,
+  f as zhCNFormulaAdditions
 };

package/dist/locales/en/platform.cjs

@@ -1 +1 @@
-"use strict";const e={fin:{shell:{closePopover:"Close popover",expand:"Expand sidebar",collapse:"Collapse sidebar",search:"Search menus",searchPlaceholder:"Search menus and apps…",searchTitle:"Menu search",noResults:"No matching menus",notifications:"Notifications",noMessages:"Message service is not connected",messageHint:"Notifications will appear here after the service is connected.",profile:"My profile",exiting:"Confirming sign out…",closeTabMenu:"Close tab menu",leftTabs:"Scroll tabs left",rightTabs:"Scroll tabs right",openedPages:"Open pages",moreTabs:"More tab actions",tabMenu:"Tab actions",refresh:"Refresh page",close:"Close current",closeOthers:"Close others",closeLeft:"Close left",closeRight:"Close right",closeAll:"Close all business pages",mainNav:"Main navigation",ready:"Workspace is ready",closeTab:"Close",pageLoading:"Loading page…",pageFailed:"Page failed to load",reload:"Reload"},errors:{unauthenticated:"Your session has expired. Please sign in again.",forbidden:"403: You do not have permission for this action.",timeout:"The operation timed out. Please try again.",network:"Connection failed. Please check your network.",unknown:"The operation failed. Please try again or contact support.",cancelled:"Operation cancelled"},auth:{independent:"Standalone mode",login:"Sign in",logout:"Sign out",username:"Username",password:"Password",required:"Sign in to access business features.",devSettings:"Development settings",token:"Test token",verify:"Verify and apply",clear:"Clear credentials",close:"Close",configured:"Credentials configured",unconfigured:"No credentials configured",memoryHint:"Credentials are stored in memory and cleared when the page reloads.",developmentStorageHint:"Development credentials are stored locally and validated on reload. Clear credentials or sign out to remove them.",verifyHint:"User and permissions are updated only after the session endpoint validates the token.",saved:"Credentials verified",cleared:"Credentials cleared"},micro:{connected:"Connected to host",disconnected:"Host unavailable",workspace:"Workspace",language:"Language",standalone:"Standalone mode",loading:"Starting application, please wait…",retry:"Retry startup",startupFailed:"Application failed to start",startupCancelled:"Startup was cancelled. You can retry."}}};module.exports=e;
+"use strict";const e={fin:{confirmation:{logoutTitle:"Sign out of the system?",logoutContent:"Unsaved changes will be lost after signing out.",logoutConfirm:"Sign out",unsavedTitle:"Discard changes?",unsavedContent:"The following changes have not been saved and will be lost when you leave.",continueEditing:"Continue editing",discardConfirm:"Discard and leave",currentPage:"Current page",unsavedForms:"Pages and forms with unsaved changes"},shell:{closePopover:"Close popover",expand:"Expand sidebar",collapse:"Collapse sidebar",search:"Search menus",searchPlaceholder:"Search menus and apps…",searchTitle:"Menu search",noResults:"No matching menus",notifications:"Notifications",noMessages:"Message service is not connected",messageHint:"Notifications will appear here after the service is connected.",profile:"My profile",exiting:"Confirming sign out…",closeTabMenu:"Close tab menu",leftTabs:"Scroll tabs left",rightTabs:"Scroll tabs right",openedPages:"Open pages",moreTabs:"More tab actions",tabMenu:"Tab actions",refresh:"Refresh page",close:"Close current",closeOthers:"Close others",closeLeft:"Close left",closeRight:"Close right",closeAll:"Close all business pages",mainNav:"Main navigation",ready:"Workspace is ready",closeTab:"Close",pageLoading:"Loading page…",pageFailed:"Page failed to load",reload:"Reload"},errors:{unauthenticated:"Your session has expired. Please sign in again.",forbidden:"403: You do not have permission for this action.",timeout:"The operation timed out. Please try again.",network:"Connection failed. Please check your network.",unknown:"The operation failed. Please try again or contact support.",cancelled:"Operation cancelled"},auth:{independent:"Standalone mode",login:"Sign in",logout:"Sign out",username:"Username",password:"Password",required:"Sign in to access business features.",devSettings:"Development settings",token:"Test token",verify:"Verify and apply",clear:"Clear credentials",close:"Close",configured:"Credentials configured",unconfigured:"No credentials configured",memoryHint:"Credentials are stored in memory and cleared when the page reloads.",developmentStorageHint:"Development credentials are stored locally and validated on reload. Clear credentials or sign out to remove them.",verifyHint:"User and permissions are updated only after the session endpoint validates the token.",saved:"Credentials verified",cleared:"Credentials cleared"},micro:{connected:"Connected to host",disconnected:"Host unavailable",workspace:"Workspace",language:"Language",standalone:"Standalone mode",loading:"Starting application, please wait…",retry:"Retry startup",startupFailed:"Application failed to start",startupCancelled:"Startup was cancelled. You can retry."}}};module.exports=e;

package/dist/locales/en/platform.mjs

@@ -1,5 +1,16 @@
 const e = {
   fin: {
+    confirmation: {
+      logoutTitle: "Sign out of the system?",
+      logoutContent: "Unsaved changes will be lost after signing out.",
+      logoutConfirm: "Sign out",
+      unsavedTitle: "Discard changes?",
+      unsavedContent: "The following changes have not been saved and will be lost when you leave.",
+      continueEditing: "Continue editing",
+      discardConfirm: "Discard and leave",
+      currentPage: "Current page",
+      unsavedForms: "Pages and forms with unsaved changes"
+    },
     shell: {
       closePopover: "Close popover",
       expand: "Expand sidebar",

package/dist/locales/zh-CN/platform.cjs

@@ -1 +1 @@
-"use strict";const e={fin:{shell:{closePopover:"关闭弹出菜单",expand:"展开侧栏",collapse:"折叠侧栏",search:"搜索菜单",searchPlaceholder:"搜索菜单、应用…",searchTitle:"菜单搜索",noResults:"未找到匹配的菜单",notifications:"消息通知",noMessages:"尚未接入消息服务",messageHint:"接入后将在这里显示真实的通知消息。",profile:"个人中心",exiting:"正在确认退出…",closeTabMenu:"关闭页签菜单",leftTabs:"向左查看页签",rightTabs:"向右查看页签",openedPages:"已打开页面",moreTabs:"更多页签操作",tabMenu:"页签操作菜单",refresh:"刷新页面",close:"关闭当前",closeOthers:"关闭其他",closeLeft:"关闭左侧",closeRight:"关闭右侧",closeAll:"关闭全部业务页",mainNav:"主导航",ready:"工作空间已就绪",closeTab:"关闭",pageLoading:"页面加载中…",pageFailed:"页面加载失败",reload:"重新加载"},errors:{unauthenticated:"登录已失效，请重新登录",forbidden:"403：无权执行此操作，请联系管理员",timeout:"操作超时，请稍后重试",network:"连接失败，请检查网络后重试",unknown:"操作失败，请稍后重试或联系管理员",cancelled:"操作已取消"},auth:{independent:"独立运行",login:"登录",logout:"退出登录",username:"账号",password:"密码",required:"请登录后访问业务功能",devSettings:"开发设置",token:"测试 Token",verify:"验证并应用",clear:"清除凭据",close:"关闭",configured:"已配置凭据",unconfigured:"未配置凭据",memoryHint:"凭据仅保存在内存，刷新页面后需重新设置。",developmentStorageHint:"开发凭据保存在本地，刷新后自动验证恢复；清除凭据或退出登录时删除。",verifyHint:"验证会话接口成功后才会更新用户与权限。",saved:"凭据已验证",cleared:"凭据已清除"},micro:{connected:"宿主已连接",disconnected:"未连接宿主",workspace:"工作空间",language:"语言",standalone:"独立运行",loading:"正在启动应用，请稍候…",retry:"重试启动",startupFailed:"应用启动失败",startupCancelled:"应用启动已取消，可重试启动"}}};module.exports=e;
+"use strict";const e={fin:{confirmation:{logoutTitle:"是否退出管理系统？",logoutContent:"退出后，未保存的内容将丢失。",logoutConfirm:"确认退出",unsavedTitle:"是否放弃修改？",unsavedContent:"以下内容尚未保存，离开后本次修改将丢失。",continueEditing:"继续编辑",discardConfirm:"放弃修改并离开",currentPage:"当前页面",unsavedForms:"未保存的页面和表单"},shell:{closePopover:"关闭弹出菜单",expand:"展开侧栏",collapse:"折叠侧栏",search:"搜索菜单",searchPlaceholder:"搜索菜单、应用…",searchTitle:"菜单搜索",noResults:"未找到匹配的菜单",notifications:"消息通知",noMessages:"尚未接入消息服务",messageHint:"接入后将在这里显示真实的通知消息。",profile:"个人中心",exiting:"正在确认退出…",closeTabMenu:"关闭页签菜单",leftTabs:"向左查看页签",rightTabs:"向右查看页签",openedPages:"已打开页面",moreTabs:"更多页签操作",tabMenu:"页签操作菜单",refresh:"刷新页面",close:"关闭当前",closeOthers:"关闭其他",closeLeft:"关闭左侧",closeRight:"关闭右侧",closeAll:"关闭全部业务页",mainNav:"主导航",ready:"工作空间已就绪",closeTab:"关闭",pageLoading:"页面加载中…",pageFailed:"页面加载失败",reload:"重新加载"},errors:{unauthenticated:"登录已失效，请重新登录",forbidden:"403：无权执行此操作，请联系管理员",timeout:"操作超时，请稍后重试",network:"连接失败，请检查网络后重试",unknown:"操作失败，请稍后重试或联系管理员",cancelled:"操作已取消"},auth:{independent:"独立运行",login:"登录",logout:"退出登录",username:"账号",password:"密码",required:"请登录后访问业务功能",devSettings:"开发设置",token:"测试 Token",verify:"验证并应用",clear:"清除凭据",close:"关闭",configured:"已配置凭据",unconfigured:"未配置凭据",memoryHint:"凭据仅保存在内存，刷新页面后需重新设置。",developmentStorageHint:"开发凭据保存在本地，刷新后自动验证恢复；清除凭据或退出登录时删除。",verifyHint:"验证会话接口成功后才会更新用户与权限。",saved:"凭据已验证",cleared:"凭据已清除"},micro:{connected:"宿主已连接",disconnected:"未连接宿主",workspace:"工作空间",language:"语言",standalone:"独立运行",loading:"正在启动应用，请稍候…",retry:"重试启动",startupFailed:"应用启动失败",startupCancelled:"应用启动已取消，可重试启动"}}};module.exports=e;

package/dist/locales/zh-CN/platform.mjs

@@ -1,5 +1,16 @@
 const e = {
   fin: {
+    confirmation: {
+      logoutTitle: "是否退出管理系统？",
+      logoutContent: "退出后，未保存的内容将丢失。",
+      logoutConfirm: "确认退出",
+      unsavedTitle: "是否放弃修改？",
+      unsavedContent: "以下内容尚未保存，离开后本次修改将丢失。",
+      continueEditing: "继续编辑",
+      discardConfirm: "放弃修改并离开",
+      currentPage: "当前页面",
+      unsavedForms: "未保存的页面和表单"
+    },
     shell: {
       closePopover: "关闭弹出菜单",
       expand: "展开侧栏",

package/dist/storage.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("vue"),n=require("@axewo/fin-core/locale");function a(r,o){if(!o.trim())throw new Error("语言存储键不能为空");if(typeof window>"u")return()=>{};let e;try{e=globalThis.localStorage}catch{return()=>{}}if(!e)return()=>{};try{const t=e.getItem(o);t!==null&&(r.value=n.normalizeAppLocale(t,n.normalizeAppLocale(r.value)))}catch{}return c.watch(r,t=>{try{e.setItem(o,n.normalizeAppLocale(t))}catch{}},{flush:"sync"})}exports.connectFinLocaleStorage=a;

package/dist/storage.mjs

@@ -0,0 +1,34 @@
+import { watch as c } from "vue";
+import { normalizeAppLocale as n } from "@axewo/fin-core/locale";
+function f(e, o) {
+  if (!o.trim()) throw new Error("语言存储键不能为空");
+  if (typeof window > "u") return () => {
+  };
+  let t;
+  try {
+    t = globalThis.localStorage;
+  } catch {
+    return () => {
+    };
+  }
+  if (!t) return () => {
+  };
+  try {
+    const r = t.getItem(o);
+    r !== null && (e.value = n(r, n(e.value)));
+  } catch {
+  }
+  return c(
+    e,
+    (r) => {
+      try {
+        t.setItem(o, n(r));
+      } catch {
+      }
+    },
+    { flush: "sync" }
+  );
+}
+export {
+  f as connectFinLocaleStorage
+};

package/dist/types/create-i18n.d.ts

@@ -1,6 +1,6 @@
 import { I18nOptions, I18n, Composer } from 'vue-i18n';
 import { App } from 'vue';
-export { normalizeFinLocale, type FinLocale } from '@axewo/fin-core/locale';
+export { normalizeAppLocale, normalizeFinLocale, type FinLocale } from '@axewo/fin-core/locale';
 type MessageTree = Record<string, any>;
 /** 供工厂和公共导出共同使用的完整内置语言包。 */
 export declare const zhCN: MessageTree;
@@ -35,4 +35,3 @@ export declare function useFinText(): (key: string) => string;
  * @returns 当前 App 独立的 i18n 实例；不创建模块级单例，不改变其他 App。
  */
 export declare function installFinI18n(app: App, options?: Partial<I18nOptions>): I18n | undefined;
-//# sourceMappingURL=create-i18n.d.ts.map

package/dist/types/entries/en.d.ts

@@ -1,3 +1,2 @@
 /** 公开子路径转发完整内置词条，业务优先从包根命名导入 en。 */
 export { en as default } from '../create-i18n';
-//# sourceMappingURL=en.d.ts.map

package/dist/types/entries/zh-CN.d.ts

@@ -1,3 +1,2 @@
 /** 公开子路径转发完整内置词条，业务优先从包根命名导入 zhCN。 */
 export { zhCN as default } from '../create-i18n';
-//# sourceMappingURL=zh-CN.d.ts.map

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @axewo/fin-locale - 国际化统一入口
  */
-export { createFinI18n, en, installFinI18n, useFinLocale, useFinText, zhCN, normalizeFinLocale, translateFinBuiltin, type FinLocale } from './create-i18n';
+export { createFinI18n, en, installFinI18n, useFinLocale, useFinText, zhCN, normalizeAppLocale, normalizeFinLocale, translateFinBuiltin, type FinLocale } from './create-i18n';
+export { connectFinLocaleStorage } from './storage';
 export { default as zhCNFormulaAdditions } from './locales/zh-CN/formula-additions';
 export { default as enFormulaAdditions } from './locales/en/formula-additions';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/locales/en/dashboard-additions.d.ts

@@ -153,4 +153,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=dashboard-additions.d.ts.map

package/dist/types/locales/en/dashboard-core-additions.d.ts

@@ -245,4 +245,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=dashboard-core-additions.d.ts.map

package/dist/types/locales/en/formula-additions.d.ts

@@ -100,4 +100,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=formula-additions.d.ts.map

package/dist/types/locales/en/index.d.ts

@@ -323,4 +323,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=index.d.ts.map

package/dist/types/locales/en/platform.d.ts

@@ -1,6 +1,17 @@
 /** 与中文保持相同的公共键与插值结构。 */
 declare const _default: {
     fin: {
+        confirmation: {
+            logoutTitle: string;
+            logoutContent: string;
+            logoutConfirm: string;
+            unsavedTitle: string;
+            unsavedContent: string;
+            continueEditing: string;
+            discardConfirm: string;
+            currentPage: string;
+            unsavedForms: string;
+        };
         shell: {
             closePopover: string;
             expand: string;
@@ -75,4 +86,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=platform.d.ts.map

package/dist/types/locales/en/ui-additions.d.ts

@@ -50,4 +50,3 @@ declare const uiAdditions: {
     };
 };
 export default uiAdditions;
-//# sourceMappingURL=ui-additions.d.ts.map

package/dist/types/locales/zh-CN/dashboard-additions.d.ts

@@ -153,4 +153,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=dashboard-additions.d.ts.map

package/dist/types/locales/zh-CN/dashboard-core-additions.d.ts

@@ -246,4 +246,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=dashboard-core-additions.d.ts.map

package/dist/types/locales/zh-CN/formula-additions.d.ts

@@ -100,4 +100,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=formula-additions.d.ts.map

package/dist/types/locales/zh-CN/index.d.ts

@@ -323,4 +323,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=index.d.ts.map

package/dist/types/locales/zh-CN/platform.d.ts

@@ -1,6 +1,17 @@
 /** 公共平台文案；业务应用只维护自己的业务命名空间。 */
 declare const _default: {
     fin: {
+        confirmation: {
+            logoutTitle: string;
+            logoutContent: string;
+            logoutConfirm: string;
+            unsavedTitle: string;
+            unsavedContent: string;
+            continueEditing: string;
+            discardConfirm: string;
+            currentPage: string;
+            unsavedForms: string;
+        };
         shell: {
             closePopover: string;
             expand: string;
@@ -75,4 +86,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=platform.d.ts.map

package/dist/types/locales/zh-CN/ui-additions.d.ts

@@ -50,4 +50,3 @@ declare const uiAdditions: {
     };
 };
 export default uiAdditions;
-//# sourceMappingURL=ui-additions.d.ts.map

package/dist/types/storage.d.ts

@@ -0,0 +1,10 @@
+import { Ref } from 'vue';
+/**
+ * 恢复并保存当前应用的 UI 语言，不创建另一份语言状态。
+ * @param locale 当前 App 的 composer.locale 或 useFinLocale().locale。
+ * @param key 应用独立的 localStorage 键；宿主和独立子应用应使用不同键。
+ * @returns 幂等释放函数，挂载失败或卸载时调用；释放后不再写入。
+ * @remarks 在首次渲染前连接。SSR 或存储不可用时保留内存语言，不阻断启动和切换。
+ * 嵌入子应用应使用宿主偏好同步，不连接本地存储，避免覆盖宿主语言。
+ */
+export declare function connectFinLocaleStorage(locale: Ref<string>, key: string): () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axewo/fin-locale",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -34,7 +34,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@axewo/fin-core": "3.0.0"
+    "@axewo/fin-core": "3.0.2"
   },
   "files": [
     "dist",
@@ -57,8 +57,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "vite build",
-    "test": "vitest run",
-    "clean": "rm -rf dist"
+    "build": "pnpm typecheck && vite build",
+    "clean": "node ../../scripts/clean.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "check:package": "node ../../scripts/check-packages.mjs locale"
   }
 }

package/dist/types/create-i18n.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-i18n.d.ts","sourceRoot":"","sources":["../../src/create-i18n.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAuB,KAAK,WAAW,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC1F,OAAO,EAAsB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAGlD,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAQ3E,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAMtC,4BAA4B;AAC5B,eAAO,MAAM,IAAI,EAAE,WAAkG,CAAA;AACrH,eAAO,MAAM,EAAE,EAAE,WAA8F,CAAA;AAE/G;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAiB,GAAG,MAAM,CAIlF;AAyBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAUlE;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI;IAC9B,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;IAChB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC,CASA;AAED,uDAAuD;AACvD,wBAAgB,UAAU,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAOpD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAiBzF"}

package/dist/types/entries/en.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/entries/en.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/types/entries/zh-CN.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../src/entries/zh-CN.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1J,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/types/locales/en/dashboard-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/en/dashboard-additions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAyJC"}

package/dist/types/locales/en/dashboard-core-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-core-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/en/dashboard-core-additions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAqPC"}

package/dist/types/locales/en/formula-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formula-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/en/formula-additions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAoGC"}

package/dist/types/locales/en/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/locales/en/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAgTC"}

package/dist/types/locales/en/platform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../../src/locales/en/platform.ts"],"names":[],"mappings":"AAAA,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACxB,wBA2EC"}

package/dist/types/locales/en/ui-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/en/ui-additions.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDhB,CAAA;AAED,eAAe,WAAW,CAAA"}

package/dist/types/locales/zh-CN/dashboard-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/zh-CN/dashboard-additions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAyJC"}

package/dist/types/locales/zh-CN/dashboard-core-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-core-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/zh-CN/dashboard-core-additions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAsPC"}

package/dist/types/locales/zh-CN/formula-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formula-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/zh-CN/formula-additions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAoGC"}

package/dist/types/locales/zh-CN/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/locales/zh-CN/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBA+SC"}

package/dist/types/locales/zh-CN/platform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../../src/locales/zh-CN/platform.ts"],"names":[],"mappings":"AAAA,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAC/B,wBA0EC"}

package/dist/types/locales/zh-CN/ui-additions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui-additions.d.ts","sourceRoot":"","sources":["../../../../src/locales/zh-CN/ui-additions.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDhB,CAAA;AAED,eAAe,WAAW,CAAA"}