@bams-app/i18n¶

const i18n = createI18nManager(options);

import { createI18nManager } from "@bams-app/i18n";

const i18n = createI18nManager({
  // 默认语言
  locale: "zh-CN",
  // 兜底语言（当前语言找不到翻译时使用）
  fallbackLocale: "zh-CN",
  // 是否持久化到 localStorage
  persist: true,
  // 自定义存储 key
  storageKey: "my-app-locale",
  // 初始化时预注册的模块
  modules: [],
  // 可用语言列表（会动态扩展）
  availableLocales: ["zh-CN", "en-US"],
});

app.use(i18n);
await i18n.init();

import { defineI18nModule } from "@bams-app/i18n";

export const demoI18nModule = defineI18nModule({
  name: "demo-module",
  namespace: "demoModule",
  // 同步消息（启动时立即加载）
  messages: {
    "zh-CN": {
      common: {
        confirm: "确定",
        cancel: "取消",
      },
    },
    "en-US": {
      common: {
        confirm: "Confirm",
        cancel: "Cancel",
      },
    },
  },
  // 异步加载器（按需加载，减少首屏体积）
  loaders: {
    "zh-CN": () => import("./locales/zh-CN.js"),
    "en-US": () => import("./locales/en-US.js"),
  },
});

import { demoI18nModule } from "./i18n.js";

// 单个注册
await i18n.registerModule(demoI18nModule);

// 批量注册
await i18n.registerModules([module1, module2]);

import { useScopedI18n } from "@bams-app/i18n";

// 带命名空间的翻译
const { t, te, locale, setLocale } = useScopedI18n("demoModule");

// 使用：t("common.confirm") 等价于 t("demoModule.common.confirm")
console.log(t("common.confirm"));

import { useLocale } from "@bams-app/i18n";

const { t, te } = useLocale();

// 使用完整路径
console.log(t("demoModule.common.confirm"));

import ReportTeam from "./ReportTeam.vue";
import { defineBusinessI18n, attachI18n } from "@bams-app/i18n";

// 定义业务模块（自动将 kebab-case 包名转成 camelCase namespace）
const i18nModule = defineBusinessI18n({
  name: "ui-report-team",
  loaders: {
    "zh-CN": () => import("./locales/zh-CN.js"),
    "en-US": () => import("./locales/en-US.js"),
  },
});

// 自动挂载（生命周期管理 + namespace 注入）
export default attachI18n(ReportTeam, i18nModule);

const translator = useLocalI18n({
  messages: localMessages,
  namespace: 'myModule',
  fallbackToGlobal: true,
});

// 可以直接调用 translator()
translator('key');

// 也可以通过属性访问：
translator.t;         // 翻译函数
translator.te;        // 检查翻译是否存在
translator.locale;    // 当前语言（响应式）
translator.setLocale; // 设置语言
translator.antdLocale;// Ant Design 的 locale 对象
translator.loading;   // 加载状态
translator.state;     // 完整的 i18n 状态
translator.namespace; // 当前 namespace

import { getI18nManager } from "@bams-app/i18n";

const i18n = getI18nManager();
if (i18n) {
  console.log(i18n.t("path.to.key"));
}

import { translate } from "@bams-app/i18n";

const msg = translate("demoModule.common.confirm");
const msgWithParams = translate("greeting", { name: "张三" });
const msgWithLocale = translate("hello", {}, "en-US");

import { translateScoped } from "@bams-app/i18n";

const msg = translateScoped("reportTeam", "toolbar.export");

import { createScopedTranslator } from "@bams-app/i18n";

const scopedT = createScopedTranslator("reportTeam");

// 方式1：直接调用
console.log(scopedT("toolbar.export"));

// 方式2：通过 .t 调用
console.log(scopedT.t("toolbar.export"));

// 检查是否存在
console.log(scopedT.te("toolbar.export"));

import { createLocalTranslator } from "@bams-app/i18n";

const localT = createLocalTranslator({
  messages: {
    "zh-CN": { confirm: "确定", cancel: "取消" },
    "en-US": { confirm: "Confirm", cancel: "Cancel" },
  },
  namespace: "myUtils",
  fallbackToGlobal: true,
});

console.log(localT("confirm"));
console.log(localT.te("confirm"));

import { useLocale } from "@bams-app/i18n";

const { setLocale } = useLocale();

// 切换到英文
await setLocale("en-US");

// 切换到中文（支持别名）
await setLocale("zh");

import { getI18nManager } from "@bams-app/i18n";

const i18n = getI18nManager();

const unsubscribe = i18n.onLocaleChange((locale, aggregate) => {
  console.log("语言已切换为:", locale);
  console.log("三方库 locale:", aggregate.antdLocale);
});

// 取消监听
unsubscribe();

import { getI18nManager } from "@bams-app/i18n";

const i18n = getI18nManager();

// 预加载英文资源（提升切换体验）
await i18n.loadLocale("en-US");

import { retainI18nModule, releaseI18nModule } from "@bams-app/i18n";

// 增加引用计数并注册模块（如果未注册）
await retainI18nModule(myModule);

// 减少引用计数，计数为 0 时卸载模块
await releaseI18nModule(myModule);

// 语言包文件
export default {
  greeting: params => {
    const hour = new Date().getHours();
    if (hour < 12) return `早上好，${params.name}！`;
    if (hour < 18) return `下午好，${params.name}！`;
    return `晚上好，${params.name}！`;
  },
};

// 使用
t("greeting", { name: "张三" });

import { getI18nManager } from "@bams-app/i18n";

const i18n = getI18nManager();
const modules = i18n.getRegisteredModules();
console.log("已注册模块:", modules);

import { getI18nManager } from "@bams-app/i18n";

const i18n = getI18nManager();
const messages = i18n.getLocaleMessages(); // 当前语言
const enMessages = i18n.getLocaleMessages("en-US"); // 指定语言

// zh-CN.js
export default {
  toolbar: {
    export: "导出",
    import: "导入",
  },
  table: {
    columns: {
      name: "名称",
      date: "日期",
    },
  },
};