@axewo/fin-locale 3.0.2 → 3.0.4

package/README.md

@@ -41,3 +41,48 @@ const stopLocaleStorage = connectFinLocaleStorage(
 包根导出 `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)`，不创建共享全局实例。
+
+## 在 setup 外读取当前应用的语言
+
+组件内继续使用 `useFinLocale()`。请求层、字典工具或旧代码需要在 `setup` 外访问语言时，每个项目创建一个 `createFinLocaleContext()`，并绑定该 App 安装的真实 i18n 实例：
+
+```ts
+// 项目 src/locales/context.ts：导出本项目自己的访问器。
+import { createFinLocaleContext } from '@axewo/fin-locale'
+export const appLocale = createFinLocaleContext()
+```
+
+```ts
+// 启动入口。
+import { installFinI18n } from '@axewo/fin-locale'
+import { appLocale } from './locales/context'
+
+const i18n = installFinI18n(app, { messages })!
+const stopLocaleContext = appLocale.bind(i18n)
+// 后续请求按调用时读取：appLocale.locale.value。
+// 挂载失败或卸载时：stopLocaleContext()。
+```
+
+访问器提供只读 `locale`、保留 vue-i18n 插值和复数参数的 `t`、词条检查 `te`。绑定前及释放后使用 `zh-CN`，`t` 返回原键，`te` 返回 `false`。重新绑定会复用访问器上的稳定响应式引用；上一轮的释放函数不能清除新绑定，即使两轮使用同一 i18n 实例。访问器只连接 composition 模式实例，不创建词条、另一份语言状态或持久化监听。
+
+基座和每个子应用各自创建访问器，服务端渲染则每个请求各自创建。库不导出全局默认 `i18n`。后台 `Content-Language` 要求下划线等协议转换由项目请求层完成，公共访问器保留 UI 的语言标识。已有 `src/lang/index.ts` 可以暂作重导出兼容入口；调用方迁移后删除，不应再维护第二套实现。
+
+## 后台多语言字段
+
+菜单名称、字典标签等 `{ 'zh-CN': '名称', 'en-US': 'Name' }` 字段使用以下工具，不交给 UI 消息树处理：
+
+```ts
+import {
+  toLocaleKey, normalizeLocaleString, buildLocaleString,
+  getExactLocaleText, getLocaleText, useFinLocale,
+} from '@axewo/fin-locale'
+
+const { locale } = useFinLocale()
+toLocaleKey('en') // 'en-US'，保留后台字段地区键
+const names = normalizeLocaleString({ en_US: 'Name', ja_JP: '名前' }, '名称')
+getLocaleText(names, locale.value) // 展示：精确语言 → 同语言族 → 中文 → 首个翻译
+getExactLocaleText(names, 'zh-CN') // 编辑：只读中文或 zh，不借用其他语言
+buildLocaleString({ ...names, 'ja-JP': '' }) // 提交时去掉清空的翻译
+```
+
+`LocaleString` 为 `Record<string, string>`。上述函数不创建 i18n 实例、不读取全局语言或存储、不修改传入对象。`getLocaleText` 的第二个参数省略时为中文；需要随语言切换更新时，在 `computed` 或渲染函数中传入当前 `locale.value`。旧单语字符串在 `normalizeLocaleString` 中写入中文；无效非字符串翻译会被忽略。后台语言字典的接口、权限与加载状态仍由项目维护。

package/dist/context.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("vue");function l(){const t=n.shallowRef();return{locale:n.computed(()=>{var e;return((e=t.value)==null?void 0:e.composer.locale.value)??"zh-CN"}),t:(...e)=>{var c;const o=(c=t.value)==null?void 0:c.composer;return o?Reflect.apply(o.t,o,e):String(e[0])},te:(e,o)=>{var c;return((c=t.value)==null?void 0:c.composer.te(e,o))??!1},bind(e){if(e.mode!=="composition")throw new TypeError("createFinLocaleContext requires a composition-mode i18n instance");const o={composer:e.global};return t.value=o,()=>{t.value===o&&(t.value=void 0)}}}}exports.createFinLocaleContext=l;

package/dist/context.mjs

@@ -0,0 +1,30 @@
+import { shallowRef as n, computed as l } from "vue";
+function p() {
+  const t = n();
+  return {
+    locale: l(() => {
+      var e;
+      return ((e = t.value) == null ? void 0 : e.composer.locale.value) ?? "zh-CN";
+    }),
+    t: (...e) => {
+      var c;
+      const o = (c = t.value) == null ? void 0 : c.composer;
+      return o ? Reflect.apply(o.t, o, e) : String(e[0]);
+    },
+    te: (e, o) => {
+      var c;
+      return ((c = t.value) == null ? void 0 : c.composer.te(e, o)) ?? !1;
+    },
+    bind(e) {
+      if (e.mode !== "composition")
+        throw new TypeError("createFinLocaleContext requires a composition-mode i18n instance");
+      const o = { composer: e.global };
+      return t.value = o, () => {
+        t.value === o && (t.value = void 0);
+      };
+    }
+  };
+}
+export {
+  p as createFinLocaleContext
+};

package/dist/create-i18n.cjs

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

package/dist/create-i18n.mjs

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

package/dist/index.cjs

@@ -1 +1 @@
-"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});
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./create-i18n.cjs"),o=require("./storage.cjs"),i=require("./context.cjs"),t=require("./locale-string.cjs"),a=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=o.connectFinLocaleStorage;exports.createFinLocaleContext=i.createFinLocaleContext;exports.buildLocaleString=t.buildLocaleString;exports.getExactLocaleText=t.getExactLocaleText;exports.getLocaleText=t.getLocaleText;exports.normalizeLocaleString=t.normalizeLocaleString;exports.toLocaleKey=t.toLocaleKey;exports.zhCNFormulaAdditions=a;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,19 +1,27 @@
-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";
+import { createFinI18n as t, en as a, installFinI18n as n, translateFinBuiltin as r, useFinLocale as l, useFinText as i, zhCN as c } from "./create-i18n.mjs";
+import { connectFinLocaleStorage as x } from "./storage.mjs";
+import { createFinLocaleContext as L } from "./context.mjs";
+import { buildLocaleString as p, getExactLocaleText as s, getLocaleText as u, normalizeLocaleString as d, toLocaleKey as g } from "./locale-string.mjs";
+import { default as A } from "./locales/zh-CN/formula-additions.mjs";
+import { default as S } from "./locales/en/formula-additions.mjs";
+import { normalizeAppLocale as h, normalizeFinLocale as I } from "@axewo/fin-core/locale";
 export {
-  s as connectFinLocaleStorage,
-  n as createFinI18n,
+  p as buildLocaleString,
+  x as connectFinLocaleStorage,
+  t as createFinI18n,
+  L as createFinLocaleContext,
   a as en,
-  u as enFormulaAdditions,
-  r as installFinI18n,
-  x as normalizeAppLocale,
-  z as normalizeFinLocale,
-  t as translateFinBuiltin,
-  i as useFinLocale,
-  l as useFinText,
-  m as zhCN,
-  f as zhCNFormulaAdditions
+  S as enFormulaAdditions,
+  s as getExactLocaleText,
+  u as getLocaleText,
+  n as installFinI18n,
+  h as normalizeAppLocale,
+  I as normalizeFinLocale,
+  d as normalizeLocaleString,
+  g as toLocaleKey,
+  r as translateFinBuiltin,
+  l as useFinLocale,
+  i as useFinText,
+  c as zhCN,
+  A as zhCNFormulaAdditions
 };

package/dist/locale-string.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function L(t){const e=t.trim().replaceAll("_","-");if(e.toLowerCase()==="zh")return"zh-CN";if(e.toLowerCase()==="en")return"en-US";try{return Intl.getCanonicalLocales(e)[0]||e}catch{return e}}function f(t){return!t||typeof t!="object"||Array.isArray(t)?[]:Object.entries(t).filter(e=>typeof e[1]=="string")}function c(t){return t.trim().replaceAll("_","-").toLowerCase()}function y(t,e){var a,l;const r=c(e),n=r.split("-")[0],o=f(t);return((a=o.find(([s])=>c(s)===r))==null?void 0:a[1])||((l=o.find(([s])=>c(s)===n))==null?void 0:l[1])||""}function p(t,e=""){const r=new Map(f(t).map(([o,a])=>[L(o),a])),n=typeof t=="string"?t:e;return!r.get("zh-CN")&&n&&r.set("zh-CN",n),Object.fromEntries(r)}function m(t){return Object.fromEntries(Object.entries(p(t)).filter(([,e])=>e.trim()))}function b(t,e="zh-CN",r=""){var l,s,g,u;if(typeof t=="string")return t;const n=f(t).filter(([,i])=>i),o=c(e||"zh-CN"),a=o.split("-")[0];return((l=n.find(([i])=>c(i)===o))==null?void 0:l[1])||((s=n.find(([i])=>c(i).split("-")[0]===a))==null?void 0:s[1])||((g=n.find(([i])=>c(i)==="zh-cn"))==null?void 0:g[1])||((u=n[0])==null?void 0:u[1])||r}exports.buildLocaleString=m;exports.getExactLocaleText=y;exports.getLocaleText=b;exports.normalizeLocaleString=p;exports.toLocaleKey=L;

package/dist/locale-string.mjs

@@ -0,0 +1,45 @@
+function p(t) {
+  const n = t.trim().replaceAll("_", "-");
+  if (n.toLowerCase() === "zh") return "zh-CN";
+  if (n.toLowerCase() === "en") return "en-US";
+  try {
+    return Intl.getCanonicalLocales(n)[0] || n;
+  } catch {
+    return n;
+  }
+}
+function l(t) {
+  return !t || typeof t != "object" || Array.isArray(t) ? [] : Object.entries(t).filter(
+    (n) => typeof n[1] == "string"
+  );
+}
+function c(t) {
+  return t.trim().replaceAll("_", "-").toLowerCase();
+}
+function m(t, n) {
+  var s, f;
+  const r = c(n), e = r.split("-")[0], i = l(t);
+  return ((s = i.find(([a]) => c(a) === r)) == null ? void 0 : s[1]) || ((f = i.find(([a]) => c(a) === e)) == null ? void 0 : f[1]) || "";
+}
+function h(t, n = "") {
+  const r = new Map(l(t).map(([i, s]) => [p(i), s])), e = typeof t == "string" ? t : n;
+  return !r.get("zh-CN") && e && r.set("zh-CN", e), Object.fromEntries(r);
+}
+function y(t) {
+  return Object.fromEntries(
+    Object.entries(h(t)).filter(([, n]) => n.trim())
+  );
+}
+function z(t, n = "zh-CN", r = "") {
+  var f, a, u, g;
+  if (typeof t == "string") return t;
+  const e = l(t).filter(([, o]) => o), i = c(n || "zh-CN"), s = i.split("-")[0];
+  return ((f = e.find(([o]) => c(o) === i)) == null ? void 0 : f[1]) || ((a = e.find(([o]) => c(o).split("-")[0] === s)) == null ? void 0 : a[1]) || ((u = e.find(([o]) => c(o) === "zh-cn")) == null ? void 0 : u[1]) || ((g = e[0]) == null ? void 0 : g[1]) || r;
+}
+export {
+  y as buildLocaleString,
+  m as getExactLocaleText,
+  z as getLocaleText,
+  h as normalizeLocaleString,
+  p as toLocaleKey
+};

package/dist/locales/en/platform.cjs

@@ -1 +1 @@
-"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;
+"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",appLoading:"Loading application…",loadFailed:"Application failed to load",loadFailedDescription:"Please reload or contact your administrator",reload:"Reload",startupFailed:"Application failed to start",startupCancelled:"Startup was cancelled. You can retry."}}};module.exports=e;

package/dist/locales/en/platform.mjs

@@ -79,6 +79,10 @@ const e = {
       standalone: "Standalone mode",
       loading: "Starting application, please wait…",
       retry: "Retry startup",
+      appLoading: "Loading application…",
+      loadFailed: "Application failed to load",
+      loadFailedDescription: "Please reload or contact your administrator",
+      reload: "Reload",
       startupFailed: "Application failed to start",
       startupCancelled: "Startup was cancelled. You can retry."
     }

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

@@ -1 +1 @@
-"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;
+"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:"重试启动",appLoading:"子应用加载中…",loadFailed:"子应用加载失败",loadFailedDescription:"请重新加载或联系管理员",reload:"重新加载",startupFailed:"应用启动失败",startupCancelled:"应用启动已取消，可重试启动"}}};module.exports=e;

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

@@ -79,6 +79,10 @@ const e = {
       standalone: "独立运行",
       loading: "正在启动应用，请稍候…",
       retry: "重试启动",
+      appLoading: "子应用加载中…",
+      loadFailed: "子应用加载失败",
+      loadFailedDescription: "请重新加载或联系管理员",
+      reload: "重新加载",
       startupFailed: "应用启动失败",
       startupCancelled: "应用启动已取消，可重试启动"
     }

package/dist/types/context.d.ts

@@ -0,0 +1,16 @@
+import { ComputedRef } from 'vue';
+import { Composer, I18n } from 'vue-i18n';
+/** 供请求层等 setup 外代码访问当前应用的语言实例，不创建第二份 i18n。 */
+export interface FinLocaleContext {
+    readonly locale: ComputedRef<string>;
+    readonly t: Composer['t'];
+    readonly te: Composer['te'];
+    /** 挂载后绑定；返回本次绑定的幂等释放函数，旧释放不会清除后续绑定。 */
+    bind(i18n: I18n): () => void;
+}
+/**
+ * 每个应用独立创建，再在启动时绑定 installFinI18n 返回的实例。
+ * 不使用包级全局实例，不读写存储，不负责后台语言键格式转换。
+ * 未绑定或释放后 locale 为 zh-CN，t 返回原键，te 返回 false。
+ */
+export declare function createFinLocaleContext(): FinLocaleContext;

package/dist/types/index.d.ts

@@ -3,5 +3,7 @@
  */
 export { createFinI18n, en, installFinI18n, useFinLocale, useFinText, zhCN, normalizeAppLocale, normalizeFinLocale, translateFinBuiltin, type FinLocale } from './create-i18n';
 export { connectFinLocaleStorage } from './storage';
+export { createFinLocaleContext, type FinLocaleContext } from './context';
+export { toLocaleKey, getExactLocaleText, normalizeLocaleString, buildLocaleString, getLocaleText, type LocaleString } from './locale-string';
 export { default as zhCNFormulaAdditions } from './locales/zh-CN/formula-additions';
 export { default as enFormulaAdditions } from './locales/en/formula-additions';

package/dist/types/locale-string.d.ts

@@ -0,0 +1,23 @@
+/** 后台业务字段的多语言映射，与 UI 消息树分开处理。 */
+export type LocaleString = Record<string, string>;
+/**
+ * 规范后台字段语言键，保留地区和扩展语种；en/zh 使用后台默认键。
+ * 与 normalizeAppLocale 不同，en-US 不会折叠成 UI 内置标识 en。
+ * 无法识别的历史键保留原值，由业务校验是否允许提交。
+ */
+export declare function toLocaleKey(locale: string): string;
+/**
+ * 编辑时读取指定语言，仅兼容连接符、大小写和无地区语言键。
+ * 不回退到其他地区或其他语言，避免将显示用回退文案写入表单。
+ */
+export declare function getExactLocaleText(value: unknown, locale: string): string;
+/** 保留所有字符串翻译，规范历史键；旧单语字段补入中文，不修改原对象。 */
+export declare function normalizeLocaleString(value: unknown, legacyChinese?: string): LocaleString;
+/** 提交时去掉空翻译；保留其余文本原值，不自动改写输入内容。 */
+export declare function buildLocaleString(value: unknown): LocaleString;
+/**
+ * 展示业务字段：精确语言 → 同语言族 → 中文 → 首个非空翻译 → fallback。
+ * 字符串原样返回；不读取全局 i18n、浏览器或持久化状态。
+ * 当前 UI 语言由调用方显式传入，省略时使用中文。
+ */
+export declare function getLocaleText(value: unknown, locale?: string, fallback?: string): string;

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

@@ -80,6 +80,10 @@ declare const _default: {
             standalone: string;
             loading: string;
             retry: string;
+            appLoading: string;
+            loadFailed: string;
+            loadFailedDescription: string;
+            reload: string;
             startupFailed: string;
             startupCancelled: string;
         };

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

@@ -80,6 +80,10 @@ declare const _default: {
             standalone: string;
             loading: string;
             retry: string;
+            appLoading: string;
+            loadFailed: string;
+            loadFailedDescription: string;
+            reload: string;
             startupFailed: string;
             startupCancelled: string;
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axewo/fin-locale",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",