gc_i18n 1.5.4 → 1.5.6

package/AGENTS.md

@@ -0,0 +1,24 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+`packages/` contains the published library source: `index.js` is the main entry, `libs/` holds utilities and services, and `components/` contains reusable UI pieces. `src/` is the local Vite playground used to exercise the plugin in a Vue app, with routes in `src/router/` and views in `src/view/`. `lang/` stores bundled language data. `example/vue2-test/` and `example/vue3-test/` are manual integration fixtures. `lib/` contains build artifacts and should only change when releasing a new build.
+
+## Build, Test, and Development Commands
+Prefer `pnpm` because the repo declares `pnpm@10` and includes a workspace file.
+
+- `pnpm dev`: start the local Vite playground.
+- `pnpm dev:unit`: run the playground in `unit` mode on port `8080`.
+- `pnpm dev:template`: run the template mode on port `8081`.
+- `pnpm build`: generate library bundles in `lib/`.
+- `pnpm preview`: preview the latest production build.
+- `cd example/vue3-test && pnpm dev`: verify Vue 3 integration.
+- `cd example/vue2-test && pnpm dev`: verify Vue 2 integration.
+
+## Coding Style & Naming Conventions
+Match the style of the file you touch. In current source, prefer double quotes, semicolons, and descriptive camelCase names for variables and functions. Use PascalCase for Vue components such as `Home.vue`, and keep utility modules in lowercase filenames such as `service.js` or `i18nUtils.ts`. Default to 2-space indentation in Vue/JS files unless the target file already uses a different width.
+
+## Testing Guidelines
+There is no automated unit test suite configured in the root package. Validate changes by running `pnpm build` and manually exercising the Vue 2 and Vue 3 examples, especially `$t()`, locale switching, router integration, and keyboard-triggered flows. Keep example-specific notes in `example/TEST_REPORT.md` when behavior or compatibility changes.
+
+## Commit & Pull Request Guidelines
+Recent history uses short conventional prefixes: `feat:`, `fix:`, and `build:`. Follow that format and keep subjects brief, for example `fix: normalize Firefox locale handling`. Pull requests should state the user-facing change, list verification steps, and include screenshots or recordings for UI or modal changes. Call out any regenerated `lib/` files so reviewers can separate source edits from build output.

package/example/vue3-test/lang/index.js

@@ -1,29 +1,29 @@
+import pro_zh_CN from "pro_iview_v3/lib/locales/zh-CN";
+import iview_zh_CN from "view-ui-plus/dist/locale/zh-CN";
+import pro_zh_TW from "pro_iview_v3/lib/locales/zh-TW";
+import iview_zh_TW from "view-ui-plus/dist/locale/zh-TW";
 
-import pro_zh_CN from 'pro_iview_v3/lib/locales/zh-CN';
-import iview_zh_CN from 'view-ui-plus/dist/locale/zh-CN';
-import pro_zh_TW from 'pro_iview_v3/lib/locales/zh-TW';
-import iview_zh_TW from 'view-ui-plus/dist/locale/zh-TW';
-
-import gc_i18n from 'gc_i18n'
-export const languages = [{
-                code: "zh-CN",
-                name: "简体中文"
-            },{
-                code: "zh-TW",
-                name: "繁体中文"
-            }]
+import gc_i18n from "../../../packages/index";
+export const languages = [
+  {
+    code: "zh-CN",
+    name: "简体中文"
+  },
+  {
+    code: "zh-TW",
+    name: "繁体中文"
+  }
+];
 export default {
-    install(app, router) {
-        const { i18n } = new gc_i18n({
-            appCode: "TEST",
-            router,
-            local: localStorage.getItem('I18N_LANGUAGE'),
-            token: localStorage.getItem('I18N_TOKEN'),
-            messages:{
-                "zh-CN":{...pro_zh_CN, ...iview_zh_CN},"zh-TW":{...pro_zh_TW, ...iview_zh_TW}
-            }
-        })
-        app.use(i18n)
-    }
-}
-    
+  install(app, router) {
+    const { i18n } = new gc_i18n({
+      appCode: "TEST_VUE3",
+      router,
+      messages: {
+        "zh-CN": { ...pro_zh_CN, ...iview_zh_CN },
+        "zh-TW": { ...pro_zh_TW, ...iview_zh_TW }
+      }
+    });
+    app.use(i18n);
+  }
+};

package/example/vue3-test/lang/index.json

@@ -14,5 +14,37 @@
 	"lws22": {
 		"zh-cn": "繁体",
 		"zh-tw": "繁體"
+	},
+	"lggagb5": {
+		"zh-cn": "登录状态:",
+		"zh-tw": "登錄狀態:"
+	},
+	"ec1po3": {
+		"zh-cn": "已登录",
+		"zh-tw": "已登錄"
+	},
+	"fonok3": {
+		"zh-cn": "未登录",
+		"zh-tw": "未登錄"
+	},
+	"koca2": {
+		"zh-cn": "登录",
+		"zh-tw": "登錄"
+	},
+	"klpb2": {
+		"zh-cn": "登出",
+		"zh-tw": "登出"
+	},
+	"gkc0dp4": {
+		"zh-cn": "繁體中文",
+		"zh-tw": "繁體中文"
+	},
+	"kgsv2": {
+		"zh-cn": "用户",
+		"zh-tw": "用戶"
+	},
+	"f6tq2o4": {
+		"zh-cn": "用户房子",
+		"zh-tw": "用戶房子"
 	}
 }

package/example/vue3-test/src/App.vue

@@ -2,9 +2,14 @@
   <div id="app">
     <h1>{{ $t("welcome") }}</h1>
     <p>{{ $t("description") }}</p>
+    <p class="status">登录状态: {{ authState.token ? "已登录" : "未登录" }}</p>
+    <p class="status">Scope: {{ authState.scope || "登录" }}</p>
     <div>
       <button @click="changeLang('zh-CN')">中文</button>
+      <button @click="changeLang('zh-TW')">繁體中文</button>
       <button @click="changeLang('en-US')">English</button>
+      <button @click="login">登录</button>
+      <button @click="logout">登出</button>
     </div>
     <router-view />
   </div>
@@ -12,12 +17,21 @@
 
 <script setup>
 import { getCurrentInstance } from "vue";
+import { authState, auth } from "./auth";
 
 const { proxy } = getCurrentInstance();
 
 const changeLang = (lang) => {
   proxy.$i18n.changeLocale(lang);
 };
+
+const login = () => {
+  auth.login("demo-user");
+};
+
+const logout = () => {
+  auth.logout();
+};
 </script>
 
 <style>
@@ -42,4 +56,9 @@ button {
 button:hover {
   background: #f0f0f0;
 }
+
+.status {
+  margin: 8px 0;
+  color: #666;
+}
 </style>

package/example/vue3-test/src/auth.js

@@ -0,0 +1,43 @@
+import { reactive } from "vue";
+
+const TOKEN_KEY = "I18N_TOKEN";
+const SCOPE_KEY = "I18N_SCOPE";
+
+const listeners = new Set();
+
+export const authState = reactive({
+  token: localStorage.getItem(TOKEN_KEY) || "",
+  scope: localStorage.getItem(SCOPE_KEY) || ""
+});
+
+const emit = () => {
+  const state = {
+    token: authState.token,
+    scope: authState.scope,
+    isAuthenticated: !!authState.token
+  };
+  listeners.forEach((listener) => listener(state));
+};
+
+export const auth = {
+  getToken: () => authState.token,
+  getScope: () => authState.scope,
+  subscribe(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  },
+  login(scope = "demo-user") {
+    authState.token = `test-token-${scope}`;
+    authState.scope = scope;
+    localStorage.setItem(TOKEN_KEY, authState.token);
+    localStorage.setItem(SCOPE_KEY, authState.scope);
+    emit();
+  },
+  logout() {
+    authState.token = "";
+    authState.scope = "";
+    localStorage.removeItem(TOKEN_KEY);
+    localStorage.removeItem(SCOPE_KEY);
+    emit();
+  }
+};

package/example/vue3-test/src/main.js

@@ -1,7 +1,8 @@
 import { createApp } from "vue";
 import { createRouter, createWebHistory } from "vue-router";
-import I18n from "gc_i18n";
+import I18n from "../../../packages/index";
 import App from "./App.vue";
+import { auth } from "./auth";
 
 // 创建路由实例
 const router = createRouter({
@@ -23,29 +24,13 @@ const i18n = new I18n({
   appCode: "TEST_VUE3",
   router,
   env: "dev",
-  messages: {
-    "zh-CN": {
-      welcome: "你好"
-    },
-    "en-US": {
-      welcome: "Hello"
-    }
-  }
+  auth
 });
 
-console.log("i18n instance:", i18n);
-console.log("i18n.install:", i18n.install);
-
 // 使用插件
 app.use(router);
 app.use(i18n);
 
-// 手动测试
-console.log(
-  "After app.use, app.config.globalProperties.$t:",
-  app.config.globalProperties.$t
-);
-
 // 挂载应用
 app.mount("#app");
 

package/example/vue3-test/vite.config.js

@@ -6,7 +6,7 @@ import { resolve } from "path";
 
 // 配置 i18n 插件
 const i18nPlugin = vitePluginsAutoI18n({
-  appCode: "TEST",
+  appCode: "TEST_VUE3",
   env: "local",
   excludedPath: ["node_modules", "src/main.js"]
 });

package/lang/index.json

@@ -134,5 +134,9 @@
 	"mhhc53": {
 		"zh-cn": "阿拉伯",
 		"zh-tw": "阿拉伯"
+	},
+	"je4zs38": {
+		"zh-cn": "保存的翻译数据:",
+		"zh-tw": "保存的翻譯數據:"
 	}
 }