@arronqzy/i18n 0.1.1

package/README.md

@@ -0,0 +1,42 @@
+# @arronqzy/i18n
+
+Abuilder 共享国际化包，默认支持 **zh-CN** / **en-US**，可同时用于 React 与 Vue。
+
+## 安装
+
+```bash
+pnpm add @arronqzy/i18n
+```
+
+## React
+
+```tsx
+import { I18nProvider, useI18n } from "@arronqzy/i18n/react";
+
+<I18nProvider locale="zh-CN">
+  <App />
+</I18nProvider>
+
+const { t, locale, setLocale } = useI18n();
+t("panel.menubar.file");
+```
+
+## Vue
+
+```ts
+import { abuilderI18n, useI18n, provideI18n } from "@arronqzy/i18n/vue";
+
+app.use(abuilderI18n, { locale: "en-US" });
+// 或在组件内 provideI18n({ locale: "zh-CN" })
+```
+
+## 语言解析优先级
+
+1. 显式 `locale` prop
+2. `localStorage`（默认 key：`abuilder.locale`）
+3. 浏览器语言（`zh*` → zh-CN，否则 en-US）
+4. 回退 `zh-CN`
+
+## 许可证
+
+MIT

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@arronqzy/i18n",
+  "version": "0.1.1",
+  "description": "Shared Chinese/English i18n for Abuilder (React + Vue)",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "src"
+  ],
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./react": "./src/react/index.ts",
+    "./vue": "./src/vue/index.ts"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "vue": "^3.4.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.1",
+    "eslint": "^8.57.0",
+    "react": "^19",
+    "typescript": "^5.5.4",
+    "vue": "^3.5.13",
+    "@arronqzy/eslint-config": "0.0.0",
+    "@arronqzy/typescript-config": "1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "pnpm run typecheck"
+  }
+}

package/src/core.ts

@@ -0,0 +1,96 @@
+import type { Locale, MessageParams, NestedMessages } from "./types";
+import { LOCALE_STORAGE_KEY } from "./types";
+
+function getByPath(messages: NestedMessages, path: string): string | undefined {
+  const parts = path.split(".");
+  let cur: string | NestedMessages | undefined = messages;
+  for (const part of parts) {
+    if (cur == null || typeof cur === "string") return undefined;
+    cur = cur[part];
+  }
+  return typeof cur === "string" ? cur : undefined;
+}
+
+export function interpolate(template: string, params?: MessageParams): string {
+  if (!params) return template;
+  return template.replace(/\{(\w+)\}/g, (_, key: string) => {
+    const value = params[key];
+    return value == null ? "" : String(value);
+  });
+}
+
+export function createTranslator(messages: NestedMessages) {
+  return function t(key: string, params?: MessageParams): string {
+    const raw = getByPath(messages, key);
+    if (raw == null) {
+      if (shouldWarnMissingKey()) {
+        console.warn(`[i18n] missing key: ${key}`);
+      }
+      return key;
+    }
+    return interpolate(raw, params);
+  };
+}
+
+/** Avoid `@types/node`; bundlers may still inject `process.env`. */
+function shouldWarnMissingKey(): boolean {
+  const g = globalThis as typeof globalThis & {
+    process?: { env?: Record<string, string | undefined> };
+  };
+  return g.process?.env?.NODE_ENV !== "production";
+}
+
+export function isLocale(value: unknown): value is Locale {
+  return value === "zh-CN" || value === "en-US";
+}
+
+export function detectBrowserLocale(): Locale {
+  if (typeof navigator === "undefined") return "zh-CN";
+  const lang = (navigator.language || "").toLowerCase();
+  return lang.startsWith("zh") ? "zh-CN" : "en-US";
+}
+
+export function readStoredLocale(storageKey = LOCALE_STORAGE_KEY): Locale | null {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const raw = localStorage.getItem(storageKey);
+    return isLocale(raw) ? raw : null;
+  } catch {
+    return null;
+  }
+}
+
+export function writeStoredLocale(locale: Locale, storageKey = LOCALE_STORAGE_KEY): void {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(storageKey, locale);
+  } catch {
+    /* ignore quota / private mode */
+  }
+}
+
+export type ResolveLocaleOptions = {
+  /** Explicit prop wins when set */
+  locale?: Locale | null;
+  storageKey?: string;
+  /** When true, use browser language if nothing else (default true) */
+  detectBrowser?: boolean;
+  fallback?: Locale;
+};
+
+/**
+ * Priority: explicit locale → localStorage → browser → fallback (zh-CN)
+ */
+export function resolveLocale(options: ResolveLocaleOptions = {}): Locale {
+  const {
+    locale,
+    storageKey = LOCALE_STORAGE_KEY,
+    detectBrowser = true,
+    fallback = "zh-CN",
+  } = options;
+  if (isLocale(locale)) return locale;
+  const stored = readStoredLocale(storageKey);
+  if (stored) return stored;
+  if (detectBrowser) return detectBrowserLocale();
+  return fallback;
+}

package/src/index.ts

@@ -0,0 +1,37 @@
+export type {
+  Locale,
+  MessageParams,
+  NestedMessages,
+  TranslateFn,
+} from "./types";
+export { LOCALES, LOCALE_STORAGE_KEY } from "./types";
+export {
+  createTranslator,
+  interpolate,
+  resolveLocale,
+  detectBrowserLocale,
+  readStoredLocale,
+  writeStoredLocale,
+  isLocale,
+} from "./core";
+export { zhCN } from "./locales/zh-CN";
+export { enUS } from "./locales/en-US";
+export type { MessageCatalog } from "./locales/zh-CN";
+
+import { createTranslator } from "./core";
+import { zhCN } from "./locales/zh-CN";
+import { enUS } from "./locales/en-US";
+import type { Locale, NestedMessages } from "./types";
+
+const catalogs: Record<Locale, NestedMessages> = {
+  "zh-CN": zhCN as unknown as NestedMessages,
+  "en-US": enUS as unknown as NestedMessages,
+};
+
+export function getMessages(locale: Locale): NestedMessages {
+  return catalogs[locale];
+}
+
+export function tForLocale(locale: Locale) {
+  return createTranslator(catalogs[locale]);
+}