@routa/i18n-vue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Routa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,193 @@
+# @routa/i18n-vue
+
+Vue-first adapter for the Routa i18n runtime.
+
+This package wraps the instance-based core runtime with:
+
+- `createI18n()` for Vue apps
+- `app.use(i18n)` installation
+- `useI18n()` and `useLocale()`
+- default-instance convenience exports such as `t` and `setLocale`
+
+## Quick Start
+
+```ts
+import path from 'node:path'
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { i18nPlugin } from '@routa/i18n-vue/vite-plugin'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    i18nPlugin({
+      localesDir: path.resolve(__dirname, 'locales'),
+      outputDir: path.resolve(__dirname, '.i18n'),
+      sourceLocale: 'zh-CN',
+      include: [path.resolve(__dirname, 'src')],
+    }),
+  ],
+})
+```
+
+## Locale Files
+
+Use the same filesystem-domain layout as the core runtime:
+
+```text
+locales/
+  zh-CN/
+    nav.ts
+    user.ts
+  en-US/
+    nav.ts
+    user.ts
+```
+
+## App Installation
+
+Create and install a Vue i18n instance:
+
+```ts
+import { createApp } from 'vue'
+import App from './App.vue'
+import { createI18n } from '@routa/i18n-vue'
+
+const i18n = createI18n({
+  sourceLocale: 'zh-CN',
+  initialLocale: 'zh-CN',
+  messages: {
+    'zh-CN': {
+      nav: {
+        guide: 'Guide Source',
+      },
+    },
+    'en-US': {
+      nav: {
+        guide: 'Guide',
+      },
+    },
+  },
+})
+
+createApp(App).use(i18n).mount('#app')
+```
+
+## Typed Key Usage
+
+Import generated keys from `virtual:routa-i18n/keys`:
+
+```ts
+import { k, nav } from 'virtual:routa-i18n/keys'
+import { t } from '@routa/i18n-vue'
+
+t(k.nav.guide, 'Guide')
+t(nav.guide, 'Guide')
+```
+
+The recommended safe path is:
+
+- `t(k.xxx.xxx, ...)`
+- `t(domain.xxx, ...)`
+
+Avoid raw string keys in application code when type safety matters.
+
+## Composition API
+
+Use the installed instance inside components:
+
+```ts
+import { computed } from 'vue'
+import { useI18n, useLocale } from '@routa/i18n-vue'
+import { k } from 'virtual:routa-i18n/keys'
+
+export function useNavTitle() {
+  const { t } = useI18n()
+  const locale = useLocale()
+
+  const title = computed(() => t(k.nav.guide, 'Guide'))
+
+  return {
+    title,
+    locale,
+  }
+}
+```
+
+`useI18n()` returns the active Vue wrapper instance.
+
+`useLocale()` returns a writable computed locale ref.
+
+## Default Instance Convenience
+
+For simple SPA usage, a default instance is also exported:
+
+```ts
+import { currentLocale, setLocale, t } from '@routa/i18n-vue'
+import { k } from 'virtual:routa-i18n/keys'
+
+t(k.nav.guide, 'Guide')
+await setLocale('en-US')
+console.log(currentLocale.value)
+```
+
+This is convenient for:
+
+- simple single-app SPAs
+- docs sites
+- quick prototypes
+
+Prefer explicit instances for:
+
+- SSR
+- tests that need isolation
+- multi-app pages
+- library-style Vue integrations
+
+## ICU Calls
+
+The adapter uses the same `t()` overloads as the core package:
+
+```ts
+t(k.nav.guide)
+t(k.nav.guide, 'Guide')
+t(k.user.welcome, { name: 'Ada' })
+t(k.user.welcome, 'Hello, {name}', { name: 'Ada' })
+```
+
+Supported ICU subset today:
+
+- `{name}`
+- `plural`
+- `select`
+- `number`, `date`, and `time`
+
+## Runtime Behavior
+
+Locale lookup order:
+
+1. current locale
+2. source locale
+3. call-site `defaultValue`
+4. key path
+
+Locale changes are reactive, so Vue render output updates after `setLocale(...)`.
+
+## Relationship To The Core Runtime
+
+`@routa/i18n-vue` is a wrapper, not a separate runtime.
+
+Use the underlying core runtime when you need:
+
+- framework-agnostic runtime access
+- low-level runtime control
+- direct compiler integration
+
+Use `@routa/i18n-vue` when you need:
+
+- `app.use(...)`
+- `useI18n()`
+- `useLocale()`
+- default Vue-friendly convenience exports
+
+For lower-level compiler/runtime details, see [../i18n/README.md](../i18n/README.md).

package/dist/icu-7NWX4KPY.js

@@ -0,0 +1,214 @@
+const s = /* @__PURE__ */ new Map();
+function M(n) {
+  const r = w(n), i = {};
+  return y(r, i), i;
+}
+function O(n, r, i) {
+  try {
+    const e = w(n);
+    return f(e, r, i ?? {}, void 0);
+  } catch {
+    return S(n, i);
+  }
+}
+function w(n) {
+  const r = s.get(n);
+  if (r)
+    return r;
+  const i = {
+    index: 0,
+    input: n
+  }, e = g(i, !1, !1);
+  if (i.index !== i.input.length)
+    throw new Error(`Unexpected trailing ICU input at index ${i.index}`);
+  return s.set(n, e), e;
+}
+function g(n, r, i) {
+  const e = [];
+  let t = "";
+  for (; n.index < n.input.length; ) {
+    const o = n.input[n.index];
+    if (o === "{") {
+      l(e, t), t = "", n.index += 1, e.push(I(n));
+      continue;
+    }
+    if (o === "}") {
+      if (r)
+        break;
+      throw new Error(`Unexpected ICU closing brace at index ${n.index}`);
+    }
+    if (o === "#" && i) {
+      l(e, t), t = "", n.index += 1, e.push({ type: "pound" });
+      continue;
+    }
+    t += o, n.index += 1;
+  }
+  return l(e, t), e;
+}
+function I(n) {
+  u(n);
+  const r = h(n);
+  if (!r)
+    throw new Error(`Expected ICU argument name at index ${n.index}`);
+  if (u(n), n.input[n.index] === "}")
+    return n.index += 1, { type: "argument", name: r };
+  c(n, ","), u(n);
+  const i = h(n);
+  if (!i)
+    throw new Error(`Expected ICU argument kind for "${r}" at index ${n.index}`);
+  if (u(n), i === "number" || i === "date" || i === "time") {
+    if (n.input[n.index] === ",")
+      for (n.index += 1; n.index < n.input.length && n.input[n.index] !== "}"; )
+        n.index += 1;
+    return c(n, "}"), { type: "format", name: r, kind: i };
+  }
+  if (i !== "plural" && i !== "select")
+    throw new Error(`Unsupported ICU kind "${i}" for "${r}"`);
+  c(n, ",");
+  const e = E(n, i === "plural");
+  return c(n, "}"), {
+    type: i,
+    name: r,
+    options: e
+  };
+}
+function E(n, r) {
+  const i = {};
+  for (; n.index < n.input.length && (u(n), n.input[n.index] !== "}"); ) {
+    const e = D(n);
+    if (!e)
+      throw new Error(`Expected ICU selector at index ${n.index}`);
+    u(n), c(n, "{");
+    const t = g(n, !0, r);
+    c(n, "}"), i[e] = t;
+  }
+  return i;
+}
+function y(n, r) {
+  for (const i of n) {
+    if (i.type === "argument") {
+      p(r, i.name, { kind: "argument" });
+      continue;
+    }
+    if (i.type === "format") {
+      p(r, i.name, { kind: i.kind });
+      continue;
+    }
+    if (i.type === "plural" || i.type === "select") {
+      p(r, i.name, {
+        kind: i.type,
+        selectors: Object.keys(i.options)
+      });
+      for (const e of Object.values(i.options))
+        y(e, r);
+    }
+  }
+}
+function p(n, r, i) {
+  var o;
+  const e = n[r];
+  if (!e) {
+    n[r] = {
+      kind: i.kind,
+      selectors: i.selectors ? [...i.selectors] : void 0
+    };
+    return;
+  }
+  if (e.kind !== i.kind)
+    throw new Error(`ICU parameter "${r}" changes kind from "${e.kind}" to "${i.kind}"`);
+  if (!((o = i.selectors) != null && o.length))
+    return;
+  const t = /* @__PURE__ */ new Set([...e.selectors ?? [], ...i.selectors]);
+  n[r] = {
+    kind: e.kind,
+    selectors: [...t]
+  };
+}
+function f(n, r, i, e) {
+  return n.map((t) => U(t, r, i, e)).join("");
+}
+function U(n, r, i, e) {
+  if (n.type === "text")
+    return n.value;
+  if (n.type === "pound")
+    return e === void 0 ? "#" : String(e);
+  if (n.type === "argument")
+    return b(i[n.name], `{${n.name}}`);
+  if (n.type === "format")
+    return C(n.kind, i[n.name], r, n.name);
+  if (n.type === "select") {
+    const N = String(i[n.name] ?? "other"), m = n.options[N] ?? n.options.other;
+    return m ? f(m, r, i, e) : "";
+  }
+  const t = k(i[n.name]);
+  if (t === null)
+    return `{${n.name}}`;
+  const o = n.options[`=${t}`];
+  if (o)
+    return f(o, r, i, t);
+  const $ = new Intl.PluralRules(r).select(t), x = n.options[$] ?? n.options.other;
+  return x ? f(x, r, i, t) : "";
+}
+function b(n, r) {
+  return n == null ? r : n instanceof Date ? n.toISOString() : String(n);
+}
+function C(n, r, i, e) {
+  if (n === "number") {
+    const d = k(r);
+    return d === null ? `{${e}}` : new Intl.NumberFormat(i).format(d);
+  }
+  const t = F(r);
+  return t ? (n === "date" ? new Intl.DateTimeFormat(i) : new Intl.DateTimeFormat(i, {
+    hour: "numeric",
+    minute: "numeric"
+  })).format(t) : `{${e}}`;
+}
+function S(n, r) {
+  return r ? n.replace(/\{(\w+)\}/g, (i, e) => b(r[e], `{${e}}`)) : n;
+}
+function k(n) {
+  if (typeof n == "number" && Number.isFinite(n))
+    return n;
+  if (typeof n == "string" && n.trim() !== "") {
+    const r = Number(n);
+    return Number.isFinite(r) ? r : null;
+  }
+  return null;
+}
+function F(n) {
+  if (n instanceof Date && !Number.isNaN(n.valueOf()))
+    return n;
+  if (typeof n == "number" && Number.isFinite(n)) {
+    const r = new Date(n);
+    return Number.isNaN(r.valueOf()) ? null : r;
+  }
+  return null;
+}
+function l(n, r) {
+  r && n.push({ type: "text", value: r });
+}
+function u(n) {
+  for (; n.index < n.input.length && /\s/.test(n.input[n.index]); )
+    n.index += 1;
+}
+function h(n) {
+  const r = n.index;
+  for (; n.index < n.input.length && /[A-Za-z0-9_$-]/.test(n.input[n.index]); )
+    n.index += 1;
+  return n.input.slice(r, n.index);
+}
+function D(n) {
+  const r = n.index;
+  for (; n.index < n.input.length && !/[\s{}]/.test(n.input[n.index]); )
+    n.index += 1;
+  return n.input.slice(r, n.index);
+}
+function c(n, r) {
+  if (u(n), n.input[n.index] !== r)
+    throw new Error(`Expected "${r}" at index ${n.index}`);
+  n.index += 1;
+}
+export {
+  M as c,
+  O as f
+};

package/dist/icu-DcjP9e-V.cjs

@@ -0,0 +1 @@
+"use strict";const s=new Map;function N(n){const e=w(n),i={};return y(e,i),i}function E(n,e,i){try{const r=w(n);return f(r,e,i??{},void 0)}catch{return M(n,i)}}function w(n){const e=s.get(n);if(e)return e;const i={index:0,input:n},r=g(i,!1,!1);if(i.index!==i.input.length)throw new Error(`Unexpected trailing ICU input at index ${i.index}`);return s.set(n,r),r}function g(n,e,i){const r=[];let t="";for(;n.index<n.input.length;){const o=n.input[n.index];if(o==="{"){l(r,t),t="",n.index+=1,r.push(U(n));continue}if(o==="}"){if(e)break;throw new Error(`Unexpected ICU closing brace at index ${n.index}`)}if(o==="#"&&i){l(r,t),t="",n.index+=1,r.push({type:"pound"});continue}t+=o,n.index+=1}return l(r,t),r}function U(n){u(n);const e=h(n);if(!e)throw new Error(`Expected ICU argument name at index ${n.index}`);if(u(n),n.input[n.index]==="}")return n.index+=1,{type:"argument",name:e};c(n,","),u(n);const i=h(n);if(!i)throw new Error(`Expected ICU argument kind for "${e}" at index ${n.index}`);if(u(n),i==="number"||i==="date"||i==="time"){if(n.input[n.index]===",")for(n.index+=1;n.index<n.input.length&&n.input[n.index]!=="}";)n.index+=1;return c(n,"}"),{type:"format",name:e,kind:i}}if(i!=="plural"&&i!=="select")throw new Error(`Unsupported ICU kind "${i}" for "${e}"`);c(n,",");const r=C(n,i==="plural");return c(n,"}"),{type:i,name:e,options:r}}function C(n,e){const i={};for(;n.index<n.input.length&&(u(n),n.input[n.index]!=="}");){const r=O(n);if(!r)throw new Error(`Expected ICU selector at index ${n.index}`);u(n),c(n,"{");const t=g(n,!0,e);c(n,"}"),i[r]=t}return i}function y(n,e){for(const i of n){if(i.type==="argument"){p(e,i.name,{kind:"argument"});continue}if(i.type==="format"){p(e,i.name,{kind:i.kind});continue}if(i.type==="plural"||i.type==="select"){p(e,i.name,{kind:i.type,selectors:Object.keys(i.options)});for(const r of Object.values(i.options))y(r,e)}}}function p(n,e,i){var o;const r=n[e];if(!r){n[e]={kind:i.kind,selectors:i.selectors?[...i.selectors]:void 0};return}if(r.kind!==i.kind)throw new Error(`ICU parameter "${e}" changes kind from "${r.kind}" to "${i.kind}"`);if(!((o=i.selectors)!=null&&o.length))return;const t=new Set([...r.selectors??[],...i.selectors]);n[e]={kind:r.kind,selectors:[...t]}}function f(n,e,i,r){return n.map(t=>S(t,e,i,r)).join("")}function S(n,e,i,r){if(n.type==="text")return n.value;if(n.type==="pound")return r===void 0?"#":String(r);if(n.type==="argument")return b(i[n.name],`{${n.name}}`);if(n.type==="format")return F(n.kind,i[n.name],e,n.name);if(n.type==="select"){const I=String(i[n.name]??"other"),m=n.options[I]??n.options.other;return m?f(m,e,i,r):""}const t=k(i[n.name]);if(t===null)return`{${n.name}}`;const o=n.options[`=${t}`];if(o)return f(o,e,i,t);const $=new Intl.PluralRules(e).select(t),x=n.options[$]??n.options.other;return x?f(x,e,i,t):""}function b(n,e){return n==null?e:n instanceof Date?n.toISOString():String(n)}function F(n,e,i,r){if(n==="number"){const d=k(e);return d===null?`{${r}}`:new Intl.NumberFormat(i).format(d)}const t=D(e);return t?(n==="date"?new Intl.DateTimeFormat(i):new Intl.DateTimeFormat(i,{hour:"numeric",minute:"numeric"})).format(t):`{${r}}`}function M(n,e){return e?n.replace(/\{(\w+)\}/g,(i,r)=>b(e[r],`{${r}}`)):n}function k(n){if(typeof n=="number"&&Number.isFinite(n))return n;if(typeof n=="string"&&n.trim()!==""){const e=Number(n);return Number.isFinite(e)?e:null}return null}function D(n){if(n instanceof Date&&!Number.isNaN(n.valueOf()))return n;if(typeof n=="number"&&Number.isFinite(n)){const e=new Date(n);return Number.isNaN(e.valueOf())?null:e}return null}function l(n,e){e&&n.push({type:"text",value:e})}function u(n){for(;n.index<n.input.length&&/\s/.test(n.input[n.index]);)n.index+=1}function h(n){const e=n.index;for(;n.index<n.input.length&&/[A-Za-z0-9_$-]/.test(n.input[n.index]);)n.index+=1;return n.input.slice(e,n.index)}function O(n){const e=n.index;for(;n.index<n.input.length&&!/[\s{}]/.test(n.input[n.index]);)n.index+=1;return n.input.slice(e,n.index)}function c(n,e){if(u(n),n.input[n.index]!==e)throw new Error(`Expected "${e}" at index ${n.index}`);n.index+=1}exports.collectIcuParams=N;exports.formatIcuMessage=E;

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { CreateI18nOptions, Locale, TranslateFn } from '../../i18n/src/index';
+import { App, ShallowRef } from 'vue';
+export type { CreateI18nOptions, I18nKey, TranslateFn } from '../../i18n/src/index';
+type LocaleMessages = NonNullable<CreateI18nOptions['messages']>[Locale];
+interface CoreLocaleSignal<T> {
+    value: T;
+}
+interface CoreI18nContract {
+    readonly locale: CoreLocaleSignal<Locale>;
+    readonly sourceLocale: Locale;
+    t: TranslateFn;
+    getLocale(): Locale;
+    setLocale(locale: Locale): Promise<void>;
+    preloadLocale(locale: Locale): Promise<void>;
+    has(key: string, locale?: Locale): boolean;
+    addMessages(locale: Locale, data: LocaleMessages): void;
+    dispose(): void;
+}
+export interface VueI18n extends Omit<CoreI18nContract, 'locale' | 't' | 'dispose'> {
+    readonly core: CoreI18nContract;
+    readonly locale: ShallowRef<Locale>;
+    t: TranslateFn;
+    install(app: App): void;
+    dispose(): void;
+}
+export declare function createI18n(options: CreateI18nOptions): VueI18n;
+export declare function useI18n(): VueI18n;
+export declare function useLocale(): import('vue').WritableComputedRef<string, string>;
+export declare const t: TranslateFn;
+export declare const setLocale: (locale: Locale) => Promise<void>;
+export declare const currentLocale: ShallowRef<string>;

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var z=Object.defineProperty;var K=(e,t,n)=>t in e?z(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n;var u=(e,t,n)=>K(e,typeof t!="symbol"?t+"":t,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./icu-DcjP9e-V.cjs"),m=require("vue");let o=null;class N{constructor(t){u(this,"subscribers",new Set);u(this,"_value");u(this,"version",0);u(this,"depth",0);this._value=t}get value(){return o&&(o.dependencies.has(this)||(o.dependencies.add(this),this.subscribers.add(o),this.depth>=o.depth&&(o.depth=this.depth+1))),this._value}set value(t){if(!Object.is(this._value,t)){this._value=t,this.version++;for(const n of Array.from(this.subscribers))n.notify()}}unsubscribe(t){this.subscribers.delete(t)}peek(){return this._value}}function C(e){return new N(e)}class R{constructor(t){u(this,"dependencies",new Set);u(this,"depth",0);u(this,"active",!0);u(this,"running",!1);this.fn=t,this.run()}cleanup(){for(const t of this.dependencies)t.unsubscribe(this);this.dependencies.clear()}run(){if(!this.active)return;if(this.running)throw new Error("[Routa Engine] Circular dependency detected in effect.");this.cleanup();const t=o;o=this,this.running=!0;try{this.fn()}finally{this.running=!1,o=t}}notify(){this.run()}dispose(){this.active=!1,this.cleanup()}}function q(e){const t=new R(e);return()=>t.dispose()}const y="routa_locale";function O(e){const t=e.storageKey===void 0?y:e.storageKey,n=e.initialLocale??$(t)??e.sourceLocale,s=C(n),a=C(Y(e.messages)),c=e.fallbackLocale??e.sourceLocale,g=e.dev??!0;async function S(r){var f;if(a.value[r])return;const l=(f=e.loaders)==null?void 0:f[r];if(!l)return;const L=await l();I(r,L)}async function A(r){await S(r),s.value=r,F(t,r)}function I(r,l){a.value={...a.value,[r]:M(a.value[r],l)}}function P(r,l=s.value){return typeof v(a.value[l],r)=="string"}const T=(r,l,L)=>{const{defaultValue:f,params:p}=D(l,L),i=String(r),w=v(a.value[s.value],i);if(typeof w=="string")return b.formatIcuMessage(w,s.value,p);const _=v(a.value[e.sourceLocale],i)??(c!==e.sourceLocale?v(a.value[c],i):void 0);return typeof _=="string"?(E(e,g,"source",i,s.value),b.formatIcuMessage(_,e.sourceLocale,p)):f!==void 0?(E(e,g,"default",i,s.value),b.formatIcuMessage(f,s.value,p)):i};return{sourceLocale:e.sourceLocale,locale:s,t:T,getLocale:()=>s.value,setLocale:A,preloadLocale:S,has:P,addMessages:I,dispose(){}}}const d=O({sourceLocale:"zh-CN",initialLocale:$(y)??"zh-CN",storageKey:y});d.t;d.locale;d.setLocale;d.addMessages;function v(e,t){if(!e)return;let n=e;for(const s of t.split(".")){if(!n||typeof n=="string")return;n=n[s]}return n}function D(e,t){return typeof e=="string"?{defaultValue:e,params:t}:{defaultValue:void 0,params:e}}function E(e,t,n,s,a){if(!t)return;const c={type:n,key:s,locale:a,message:n==="source"?`[i18n] Missing "${s}" in locale "${a}", falling back to source locale "${e.sourceLocale}".`:`[i18n] Missing "${s}" in locale "${a}", falling back to call-site defaultValue.`};if(e.warn){e.warn(c);return}typeof console<"u"&&typeof console.warn=="function"&&console.warn(c.message)}function Y(e){return e?Object.fromEntries(Object.entries(e).map(([t,n])=>[t,B(n)])):{}}function B(e){return M(void 0,e)}function M(e,t){const n={...e??{}};for(const[s,a]of Object.entries(t)){if(typeof a=="string"){n[s]=a;continue}const c=n[s];n[s]=M(c&&typeof c!="string"?c:void 0,a)}return n}function $(e){if(!e||typeof localStorage>"u")return null;try{return localStorage.getItem(e)}catch{return null}}function F(e,t){if(!(!e||typeof localStorage>"u"))try{localStorage.setItem(e,t)}catch{}}const j=Symbol("routa-i18n");function G(e){return V(O(e))}function k(){return m.inject(j,h)}function U(){const e=k();return m.computed({get:()=>e.locale.value,set:t=>{e.setLocale(t)}})}const h=V(d),W=h.t,H=h.setLocale,J=h.locale;function V(e){const t=m.shallowRef(e.getLocale()),n=q(()=>{t.value=e.locale.value}),s={sourceLocale:e.sourceLocale,core:e,locale:t,t:((a,c,g)=>(t.value,e.t(a,c,g))),getLocale:e.getLocale,setLocale:e.setLocale,preloadLocale:e.preloadLocale,has:e.has,addMessages:e.addMessages,install(a){a.provide(j,s),a.config.globalProperties.$t=s.t},dispose(){n(),e.dispose()}};return s}exports.createI18n=G;exports.currentLocale=J;exports.setLocale=H;exports.t=W;exports.useI18n=k;exports.useLocale=U;

package/dist/index.mjs

@@ -0,0 +1,247 @@
+var z = Object.defineProperty;
+var K = (e, t, n) => t in e ? z(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
+var o = (e, t, n) => K(e, typeof t != "symbol" ? t + "" : t, n);
+import { f as b } from "./icu-7NWX4KPY.js";
+import { shallowRef as N, inject as P, computed as R } from "vue";
+let u = null;
+class T {
+  // Signals are always at depth 0
+  constructor(t) {
+    o(this, "subscribers", /* @__PURE__ */ new Set());
+    o(this, "_value");
+    o(this, "version", 0);
+    o(this, "depth", 0);
+    this._value = t;
+  }
+  get value() {
+    return u && (u.dependencies.has(this) || (u.dependencies.add(this), this.subscribers.add(u), this.depth >= u.depth && (u.depth = this.depth + 1))), this._value;
+  }
+  set value(t) {
+    if (!Object.is(this._value, t)) {
+      this._value = t, this.version++;
+      for (const n of Array.from(this.subscribers))
+        n.notify();
+    }
+  }
+  unsubscribe(t) {
+    this.subscribers.delete(t);
+  }
+  peek() {
+    return this._value;
+  }
+}
+function _(e) {
+  return new T(e);
+}
+class D {
+  constructor(t) {
+    o(this, "dependencies", /* @__PURE__ */ new Set());
+    o(this, "depth", 0);
+    o(this, "active", !0);
+    o(this, "running", !1);
+    this.fn = t, this.run();
+  }
+  cleanup() {
+    for (const t of this.dependencies)
+      t.unsubscribe(this);
+    this.dependencies.clear();
+  }
+  run() {
+    if (!this.active) return;
+    if (this.running)
+      throw new Error("[Routa Engine] Circular dependency detected in effect.");
+    this.cleanup();
+    const t = u;
+    u = this, this.running = !0;
+    try {
+      this.fn();
+    } finally {
+      this.running = !1, u = t;
+    }
+  }
+  notify() {
+    this.run();
+  }
+  dispose() {
+    this.active = !1, this.cleanup();
+  }
+}
+function Y(e) {
+  const t = new D(e);
+  return () => t.dispose();
+}
+const y = "routa_locale";
+function E(e) {
+  const t = e.storageKey === void 0 ? y : e.storageKey, n = e.initialLocale ?? $(t) ?? e.sourceLocale, s = _(n), a = _(F(e.messages)), c = e.fallbackLocale ?? e.sourceLocale, g = e.dev ?? !0;
+  async function w(r) {
+    var f;
+    if (a.value[r])
+      return;
+    const l = (f = e.loaders) == null ? void 0 : f[r];
+    if (!l)
+      return;
+    const p = await l();
+    S(r, p);
+  }
+  async function k(r) {
+    await w(r), s.value = r, U(t, r);
+  }
+  function S(r, l) {
+    a.value = {
+      ...a.value,
+      [r]: m(a.value[r], l)
+    };
+  }
+  function V(r, l = s.value) {
+    return typeof v(a.value[l], r) == "string";
+  }
+  const A = (r, l, p) => {
+    const { defaultValue: f, params: L } = B(l, p), i = String(r), M = v(a.value[s.value], i);
+    if (typeof M == "string")
+      return b(M, s.value, L);
+    const I = v(a.value[e.sourceLocale], i) ?? (c !== e.sourceLocale ? v(a.value[c], i) : void 0);
+    return typeof I == "string" ? (C(e, g, "source", i, s.value), b(I, e.sourceLocale, L)) : f !== void 0 ? (C(e, g, "default", i, s.value), b(f, s.value, L)) : i;
+  };
+  return {
+    sourceLocale: e.sourceLocale,
+    locale: s,
+    t: A,
+    getLocale: () => s.value,
+    setLocale: k,
+    preloadLocale: w,
+    has: V,
+    addMessages: S,
+    dispose() {
+    }
+  };
+}
+const d = E({
+  sourceLocale: "zh-CN",
+  initialLocale: $(y) ?? "zh-CN",
+  storageKey: y
+});
+d.t;
+d.locale;
+d.setLocale;
+d.addMessages;
+function v(e, t) {
+  if (!e)
+    return;
+  let n = e;
+  for (const s of t.split(".")) {
+    if (!n || typeof n == "string")
+      return;
+    n = n[s];
+  }
+  return n;
+}
+function B(e, t) {
+  return typeof e == "string" ? {
+    defaultValue: e,
+    params: t
+  } : {
+    defaultValue: void 0,
+    params: e
+  };
+}
+function C(e, t, n, s, a) {
+  if (!t)
+    return;
+  const c = {
+    type: n,
+    key: s,
+    locale: a,
+    message: n === "source" ? `[i18n] Missing "${s}" in locale "${a}", falling back to source locale "${e.sourceLocale}".` : `[i18n] Missing "${s}" in locale "${a}", falling back to call-site defaultValue.`
+  };
+  if (e.warn) {
+    e.warn(c);
+    return;
+  }
+  typeof console < "u" && typeof console.warn == "function" && console.warn(c.message);
+}
+function F(e) {
+  return e ? Object.fromEntries(
+    Object.entries(e).map(([t, n]) => [t, G(n)])
+  ) : {};
+}
+function G(e) {
+  return m(void 0, e);
+}
+function m(e, t) {
+  const n = { ...e ?? {} };
+  for (const [s, a] of Object.entries(t)) {
+    if (typeof a == "string") {
+      n[s] = a;
+      continue;
+    }
+    const c = n[s];
+    n[s] = m(
+      c && typeof c != "string" ? c : void 0,
+      a
+    );
+  }
+  return n;
+}
+function $(e) {
+  if (!e || typeof localStorage > "u")
+    return null;
+  try {
+    return localStorage.getItem(e);
+  } catch {
+    return null;
+  }
+}
+function U(e, t) {
+  if (!(!e || typeof localStorage > "u"))
+    try {
+      localStorage.setItem(e, t);
+    } catch {
+    }
+}
+const O = Symbol("routa-i18n");
+function Q(e) {
+  return j(E(e));
+}
+function W() {
+  return P(O, h);
+}
+function X() {
+  const e = W();
+  return R({
+    get: () => e.locale.value,
+    set: (t) => {
+      e.setLocale(t);
+    }
+  });
+}
+const h = j(d), Z = h.t, x = h.setLocale, ee = h.locale;
+function j(e) {
+  const t = N(e.getLocale()), n = Y(() => {
+    t.value = e.locale.value;
+  }), s = {
+    sourceLocale: e.sourceLocale,
+    core: e,
+    locale: t,
+    t: ((a, c, g) => (t.value, e.t(a, c, g))),
+    getLocale: e.getLocale,
+    setLocale: e.setLocale,
+    preloadLocale: e.preloadLocale,
+    has: e.has,
+    addMessages: e.addMessages,
+    install(a) {
+      a.provide(O, s), a.config.globalProperties.$t = s.t;
+    },
+    dispose() {
+      n(), e.dispose();
+    }
+  };
+  return s;
+}
+export {
+  Q as createI18n,
+  ee as currentLocale,
+  x as setLocale,
+  Z as t,
+  W as useI18n,
+  X as useLocale
+};

package/dist/vite-plugin.d.ts

@@ -0,0 +1 @@
+export { i18nPlugin } from '../../i18n/src/vite-plugin';

package/dist/vite-plugin.js

@@ -0,0 +1,16 @@
+"use strict";var I=Object.defineProperty;var b=(i,t,e)=>t in i?I(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var S=(i,t,e)=>b(i,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("node:path"),o=require("typescript"),p=require("node:fs"),g=require("./icu-DcjP9e-V.cjs");function T(i){return!!i&&typeof i=="object"&&!Array.isArray(i)}class C{constructor(t){S(this,"localeFileCache",new Map);S(this,"lastTranslationsMap",null);this.options=t}setStrict(t){this.options.strict=t}generate(){this.localeFileCache.clear();const{localesDir:t,outputDir:e,sourceLocale:r}=this.options;if(!p.existsSync(t)){this.warn(`[i18n] Locales directory not found: ${t}`);return}const n=this.loadAllLocales(t);if(!n[r])throw new Error(`[i18n] Source locale not found: ${r}`);const a=this.validateLocales(n);this.flushDiagnostics(a),p.mkdirSync(e,{recursive:!0}),this.writeRuntimeArtifacts(n),this.writeVirtualKeyDeclaration(n),this.removeObsoleteArtifacts(e),this.lastTranslationsMap=n}renderVirtualKeyRuntimeModule(){this.lastTranslationsMap||this.generate();const t=this.lastTranslationsMap;if(!t)return`export const k = {} as const
+export default k
+`;const e=t[this.options.sourceLocale],r=Object.keys(e).filter(j);return["export const k = "+this.renderRuntimeKeyTree(e),...r.map(n=>`export const ${n} = k.${n}`),"export default k",""].join(`
+`)}loadAllLocales(t){const e=p.readdirSync(t).filter(n=>p.statSync(u.join(t,n)).isDirectory()).sort((n,s)=>n.localeCompare(s)),r={};for(const n of e)r[n]=this.loadLocaleCatalog(u.join(t,n));return r}loadLocaleCatalog(t){const e=this.getDomainLocaleFiles(t),r={};for(const n of e)r[n.domain]=this.parseLocaleFile(n.filePath);return r}getDomainLocaleFiles(t){return p.readdirSync(t).filter(e=>e==="index.ts"||e.endsWith(".d.ts")?!1:e.endsWith(".ts")||e.endsWith(".json")).map(e=>({domain:u.basename(e,u.extname(e)),filePath:u.join(t,e)})).sort((e,r)=>e.domain.localeCompare(r.domain))}parseLocaleFile(t){const e=u.resolve(t),r=this.localeFileCache.get(e);if(r)return r;if(u.extname(e)===".json"){const l=JSON.parse(p.readFileSync(e,"utf8"));return this.localeFileCache.set(e,l),l}const s=o.createSourceFile(e,p.readFileSync(e,"utf8"),o.ScriptTarget.Latest,!0,o.ScriptKind.TS),a={declarations:this.collectDeclarations(s),sourceFile:s},c=this.parseDefaultExport(s,a);return this.localeFileCache.set(e,c),c}collectDeclarations(t){const e=new Map;for(const r of t.statements)if(o.isVariableStatement(r))for(const n of r.declarationList.declarations)!o.isIdentifier(n.name)||!n.initializer||e.set(n.name.text,n.initializer);return e}parseDefaultExport(t,e){for(const r of t.statements)if(o.isExportAssignment(r)&&!r.isExportEquals)return this.parseLocaleExpression(r.expression,e);throw new Error(`[i18n] Missing default export in locale file: ${t.fileName}`)}parseLocaleExpression(t,e){const r=this.unwrapExpression(t);if(o.isIdentifier(r)){const n=e.declarations.get(r.text);if(!n)throw new Error(`[i18n] Unsupported locale export reference "${r.text}" in ${e.sourceFile.fileName}`);return this.parseLocaleExpression(n,e)}if(!o.isObjectLiteralExpression(r))throw new Error(`[i18n] Locale default export must be an object literal in ${e.sourceFile.fileName}`);return this.parseLocaleObjectLiteral(r,e)}parseLocaleObjectLiteral(t,e){const r={};for(const n of t.properties){if(o.isSpreadAssignment(n))throw new Error(`[i18n] Unsupported spread locale property in ${e.sourceFile.fileName}`);if(!o.isPropertyAssignment(n)&&!o.isShorthandPropertyAssignment(n))throw new Error(`[i18n] Unsupported locale property in ${e.sourceFile.fileName}`);const s=this.readPropertyName(n.name,e.sourceFile),a=o.isShorthandPropertyAssignment(n)?n.name:n.initializer;r[s]=this.parseLocaleValue(a,e)}return r}parseLocaleValue(t,e){const r=this.unwrapExpression(t);if(o.isStringLiteral(r)||o.isNoSubstitutionTemplateLiteral(r))return r.text;if(o.isIdentifier(r)){const n=e.declarations.get(r.text);if(!n)throw new Error(`[i18n] Unsupported locale value reference "${r.text}" in ${e.sourceFile.fileName}`);return this.parseLocaleValue(n,e)}if(o.isObjectLiteralExpression(r))return this.parseLocaleObjectLiteral(r,e);throw new Error(`[i18n] Locale values must be strings or nested objects in ${e.sourceFile.fileName}`)}unwrapExpression(t){let e=t;for(;o.isAsExpression(e)||o.isParenthesizedExpression(e)||o.isSatisfiesExpression(e)||o.isTypeAssertionExpression(e);)e=e.expression;return e}readPropertyName(t,e){if(o.isIdentifier(t)||o.isStringLiteral(t)||o.isNumericLiteral(t))return t.text;throw new Error(`[i18n] Unsupported locale property name "${t.getText(e)}" in ${e.fileName}`)}validateLocales(t){const e=[],r=t[this.options.sourceLocale];this.validateSourceMessages(r,e,"");for(const[n,s]of Object.entries(t))n!==this.options.sourceLocale&&this.assertMatchingLocaleTree(r,s,n,"",e);return e}validateSourceMessages(t,e,r){if(typeof t=="string"){try{g.collectIcuParams(t)}catch(n){e.push(this.createDiagnostic("error",`[i18n] Invalid ICU message at "${r}": ${L(n)}`))}return}for(const[n,s]of Object.entries(t)){const a=r?`${r}.${n}`:n;this.validateSourceMessages(s,e,a)}}assertMatchingLocaleTree(t,e,r,n,s){if(typeof t=="string"){if(typeof e!="string"){s.push(this.createMissingKeyDiagnostic(r,n));return}this.compareMessages(t,e,r,n,s);return}if(!T(e)){this.collectMissingLeafDiagnostics(t,r,n,s);return}for(const[a,c]of Object.entries(t)){const l=n?`${n}.${a}`:a;this.assertMatchingLocaleTree(c,e[a],r,l,s)}}collectMissingLeafDiagnostics(t,e,r,n){if(typeof t=="string"){n.push(this.createMissingKeyDiagnostic(e,r));return}for(const[s,a]of Object.entries(t)){const c=r?`${r}.${s}`:s;this.collectMissingLeafDiagnostics(a,e,c,n)}}compareMessages(t,e,r,n,s){let a,c;try{a=g.collectIcuParams(t),c=g.collectIcuParams(e)}catch(f){s.push(this.createDiagnostic("error",`[i18n] ICU signature error at "${n}" in locale "${r}": ${L(f)}`));return}const l=Object.keys(a).sort(),d=Object.keys(c).sort();if(l.join("|")!==d.join("|")){s.push(this.createDiagnostic("error",`[i18n] ICU params mismatch at "${n}" in locale "${r}". Expected [${l.join(", ")}], received [${d.join(", ")}].`));return}for(const f of l){const m=a[f],h=c[f];if(!h||m.kind!==h.kind){s.push(this.createDiagnostic("error",`[i18n] ICU param "${f}" at "${n}" in locale "${r}" must stay "${m.kind}".`));continue}if(m.kind==="select"){const E=new Set([...m.selectors??[],"other"]);for(const w of E)(h.selectors??[]).includes(w)||s.push(this.createDiagnostic("error",`[i18n] ICU select "${f}" at "${n}" in locale "${r}" is missing selector "${w}".`))}m.kind==="plural"&&!(h.selectors??[]).includes("other")&&s.push(this.createDiagnostic("error",`[i18n] ICU plural "${f}" at "${n}" in locale "${r}" must include "other".`))}}createMissingKeyDiagnostic(t,e){const[r="unknown"]=e.split("."),n=u.join(this.options.localesDir,t,`${r}.ts`),s=this.options.strict===!1?"warn":"error";return this.createDiagnostic(s,`[i18n] Locale "${t}" is missing key "${e}". File: ${n}. Reference locale: ${this.options.sourceLocale}`)}createDiagnostic(t,e){return{level:t,message:e}}flushDiagnostics(t){for(const r of t.filter(n=>n.level==="warn"))this.warn(r.message);const e=t.filter(r=>r.level==="error");if(e.length>0)throw new Error(e.map(r=>r.message).join(`
+`))}writeRuntimeArtifacts(t){const e=u.join(this.options.outputDir,"runtime");p.mkdirSync(e,{recursive:!0});const r=Object.keys(t).sort((n,s)=>n.localeCompare(s));p.writeFileSync(u.join(e,"manifest.json"),`${JSON.stringify({sourceLocale:this.options.sourceLocale,locales:r},null,2)}
+`);for(const n of r)p.writeFileSync(u.join(e,`${n}.json`),`${JSON.stringify(t[n],null,2)}
+`)}writeVirtualKeyDeclaration(t){const e=t[this.options.sourceLocale],r=Object.keys(e).filter(j),n=["declare module 'virtual:routa-i18n/keys' {","  import type { I18nKey, I18nPrimitive } from '@routa/i18n'","",`  export declare const k: ${this.renderDeclarationTree(e,t,"",1)}`,...r.map(s=>`  export declare const ${s}: typeof k.${s}`),"}",""].join(`
+`);p.writeFileSync(u.join(this.options.outputDir,"virtual-routa-i18n-keys.d.ts"),n)}renderDeclarationTree(t,e,r="",n=0){const s="  ".repeat(n),a="  ".repeat(n+1);return typeof t=="string"?`I18nKey<'${$(r)}', ${this.renderParamsType(t)}>`:`{
+${Object.entries(t).map(([l,d])=>{const f=r?`${r}.${l}`:l,m=this.renderPropertyName(l);return typeof d=="string"?`${this.renderHoverDoc(e,f,n+1)}
+${a}${m}: ${this.renderDeclarationTree(d,e,f,n+1)}`:`${a}${m}: ${this.renderDeclarationTree(d,e,f,n+1)}`}).join(`,
+`)}
+${s}}`}renderHoverDoc(t,e,r){const n="  ".repeat(r),s=[`${n}/**`];for(const[a,c]of Object.entries(t)){const l=this.getTranslationByPath(c,e);l!==null&&s.push(`${n} * ${a}: ${P(l)}`)}return s.push(`${n} */`),s.join(`
+`)}renderParamsType(t){const e=g.collectIcuParams(t),r=Object.entries(e);return r.length===0?"undefined":`{ ${r.map(([s,a])=>`${this.renderPropertyName(s)}: ${this.renderParamMetaType(a)}`).join("; ")} }`}renderParamMetaType(t){var r;return t.kind==="argument"?"I18nPrimitive":t.kind==="number"||t.kind==="plural"?"number":t.kind==="date"||t.kind==="time"?"Date | number":((r=t.selectors)!=null&&r.length?t.selectors:["other"]).map(n=>`'${$(n)}'`).join(" | ")}renderRuntimeKeyTree(t,e="",r=0){const n="  ".repeat(r),s="  ".repeat(r+1);return typeof t=="string"?`'${$(e)}'`:`{
+${Object.entries(t).map(([c,l])=>{const d=e?`${e}.${c}`:c;return`${s}${this.renderPropertyName(c)}: ${this.renderRuntimeKeyTree(l,d,r+1)}`}).join(`,
+`)}
+${n}}`}getTranslationByPath(t,e){const r=e.split(".");let n=t;for(const s of r){if(!n||typeof n=="string")return null;n=n[s]}return typeof n=="string"?n:null}renderPropertyName(t){return j(t)?t:`'${$(t)}'`}removeObsoleteArtifacts(t){for(const e of["keys.ts","keys.gen.ts","meta.json","source-catalog.ts"]){const r=u.join(t,e);p.existsSync(r)&&p.unlinkSync(r)}}warn(t){if(this.options.onWarn){this.options.onWarn(t);return}console.warn(t)}}function $(i){return i.replace(/\\/g,"\\\\").replace(/'/g,"\\'")}function P(i){return i.replace(/\r?\n/g,"\\n").replace(/\*\//g,"*\\/")}function L(i){return i instanceof Error?i.message:String(i)}function j(i){return/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(i)}const x="virtual:routa-i18n/keys",D=`\0${x}`;function v(i){const t=new C(i),e=i.include.map(r=>y(u.resolve(r)));return{name:"routa:i18n",resolveId(r){return r===x?D:null},load(r){return r===D?t.renderVirtualKeyRuntimeModule():null},configResolved(r){t.setStrict(i.strict??(r.command==="build"||process.env.CI==="true")),t.generate()},transform(r,n){const s=y(n.split("?")[0]);if(!e.some(l=>s.startsWith(l))||!O(n,s))return null;const c=F(r,s);return c===r?null:{code:c,map:null}},configureServer(r){r.watcher.add(u.resolve(i.localesDir)),r.watcher.on("change",n=>{y(n).startsWith(y(u.resolve(i.localesDir)))&&(t.generate(),r.ws.send({type:"full-reload"}))})}}}function F(i,t){const e=o.createSourceFile(t,i,o.ScriptTarget.Latest,!0,A(t)),r=M(e);if(r.size===0)return i;const n=[],s=c=>{if(o.isPropertyAccessExpression(c)){const l=N(c,r);if(l){n.push({start:c.getStart(e),end:c.getEnd(),replacement:`'${l}'`});return}}o.forEachChild(c,s)};if(s(e),n.length===0)return i;let a=i;for(const c of n.sort((l,d)=>d.start-l.start))a=`${a.slice(0,c.start)}${c.replacement}${a.slice(c.end)}`;return a}function M(i){var e,r;const t=new Map;for(const n of i.statements){if(!o.isImportDeclaration(n)||!((e=n.importClause)!=null&&e.namedBindings)||!o.isStringLiteral(n.moduleSpecifier)||n.moduleSpecifier.text!==x)continue;const s=n.importClause.namedBindings;if(o.isNamedImports(s))for(const a of s.elements){const c=((r=a.propertyName)==null?void 0:r.text)??a.name.text;t.set(a.name.text,c==="k"?"":c)}}return t}function N(i,t){const e=[i.name.text];let r=i.expression;for(;o.isPropertyAccessExpression(r);)e.unshift(r.name.text),r=r.expression;if(!o.isIdentifier(r))return null;const n=t.get(r.text);return n===void 0?null:n?`${n}.${e.join(".")}`:e.join(".")}function O(i,t){return/\.(ts|tsx|js|jsx|vue)$/.test(t)||i.includes(".vue?")||i.includes("&lang.ts")||i.includes("&lang.js")}function A(i){return i.endsWith(".tsx")?o.ScriptKind.TSX:i.endsWith(".jsx")?o.ScriptKind.JSX:i.endsWith(".js")?o.ScriptKind.JS:o.ScriptKind.TS}function y(i){return i.replaceAll("\\","/")}exports.i18nPlugin=v;

package/dist/vite-plugin.mjs

@@ -0,0 +1,464 @@
+var I = Object.defineProperty;
+var b = (i, t, e) => t in i ? I(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
+var x = (i, t, e) => b(i, typeof t != "symbol" ? t + "" : t, e);
+import u from "node:path";
+import o from "typescript";
+import p from "node:fs";
+import { c as g } from "./icu-7NWX4KPY.js";
+function T(i) {
+  return !!i && typeof i == "object" && !Array.isArray(i);
+}
+class C {
+  constructor(t) {
+    x(this, "localeFileCache", /* @__PURE__ */ new Map());
+    x(this, "lastTranslationsMap", null);
+    this.options = t;
+  }
+  setStrict(t) {
+    this.options.strict = t;
+  }
+  generate() {
+    this.localeFileCache.clear();
+    const { localesDir: t, outputDir: e, sourceLocale: r } = this.options;
+    if (!p.existsSync(t)) {
+      this.warn(`[i18n] Locales directory not found: ${t}`);
+      return;
+    }
+    const n = this.loadAllLocales(t);
+    if (!n[r])
+      throw new Error(`[i18n] Source locale not found: ${r}`);
+    const a = this.validateLocales(n);
+    this.flushDiagnostics(a), p.mkdirSync(e, { recursive: !0 }), this.writeRuntimeArtifacts(n), this.writeVirtualKeyDeclaration(n), this.removeObsoleteArtifacts(e), this.lastTranslationsMap = n;
+  }
+  renderVirtualKeyRuntimeModule() {
+    this.lastTranslationsMap || this.generate();
+    const t = this.lastTranslationsMap;
+    if (!t)
+      return `export const k = {} as const
+export default k
+`;
+    const e = t[this.options.sourceLocale], r = Object.keys(e).filter(S);
+    return [
+      "export const k = " + this.renderRuntimeKeyTree(e),
+      ...r.map((n) => `export const ${n} = k.${n}`),
+      "export default k",
+      ""
+    ].join(`
+`);
+  }
+  loadAllLocales(t) {
+    const e = p.readdirSync(t).filter((n) => p.statSync(u.join(t, n)).isDirectory()).sort((n, s) => n.localeCompare(s)), r = {};
+    for (const n of e)
+      r[n] = this.loadLocaleCatalog(u.join(t, n));
+    return r;
+  }
+  loadLocaleCatalog(t) {
+    const e = this.getDomainLocaleFiles(t), r = {};
+    for (const n of e)
+      r[n.domain] = this.parseLocaleFile(n.filePath);
+    return r;
+  }
+  getDomainLocaleFiles(t) {
+    return p.readdirSync(t).filter((e) => e === "index.ts" || e.endsWith(".d.ts") ? !1 : e.endsWith(".ts") || e.endsWith(".json")).map((e) => ({
+      domain: u.basename(e, u.extname(e)),
+      filePath: u.join(t, e)
+    })).sort((e, r) => e.domain.localeCompare(r.domain));
+  }
+  parseLocaleFile(t) {
+    const e = u.resolve(t), r = this.localeFileCache.get(e);
+    if (r)
+      return r;
+    if (u.extname(e) === ".json") {
+      const l = JSON.parse(p.readFileSync(e, "utf8"));
+      return this.localeFileCache.set(e, l), l;
+    }
+    const s = o.createSourceFile(
+      e,
+      p.readFileSync(e, "utf8"),
+      o.ScriptTarget.Latest,
+      !0,
+      o.ScriptKind.TS
+    ), a = {
+      declarations: this.collectDeclarations(s),
+      sourceFile: s
+    }, c = this.parseDefaultExport(s, a);
+    return this.localeFileCache.set(e, c), c;
+  }
+  collectDeclarations(t) {
+    const e = /* @__PURE__ */ new Map();
+    for (const r of t.statements)
+      if (o.isVariableStatement(r))
+        for (const n of r.declarationList.declarations)
+          !o.isIdentifier(n.name) || !n.initializer || e.set(n.name.text, n.initializer);
+    return e;
+  }
+  parseDefaultExport(t, e) {
+    for (const r of t.statements)
+      if (o.isExportAssignment(r) && !r.isExportEquals)
+        return this.parseLocaleExpression(r.expression, e);
+    throw new Error(`[i18n] Missing default export in locale file: ${t.fileName}`);
+  }
+  parseLocaleExpression(t, e) {
+    const r = this.unwrapExpression(t);
+    if (o.isIdentifier(r)) {
+      const n = e.declarations.get(r.text);
+      if (!n)
+        throw new Error(`[i18n] Unsupported locale export reference "${r.text}" in ${e.sourceFile.fileName}`);
+      return this.parseLocaleExpression(n, e);
+    }
+    if (!o.isObjectLiteralExpression(r))
+      throw new Error(`[i18n] Locale default export must be an object literal in ${e.sourceFile.fileName}`);
+    return this.parseLocaleObjectLiteral(r, e);
+  }
+  parseLocaleObjectLiteral(t, e) {
+    const r = {};
+    for (const n of t.properties) {
+      if (o.isSpreadAssignment(n))
+        throw new Error(`[i18n] Unsupported spread locale property in ${e.sourceFile.fileName}`);
+      if (!o.isPropertyAssignment(n) && !o.isShorthandPropertyAssignment(n))
+        throw new Error(`[i18n] Unsupported locale property in ${e.sourceFile.fileName}`);
+      const s = this.readPropertyName(n.name, e.sourceFile), a = o.isShorthandPropertyAssignment(n) ? n.name : n.initializer;
+      r[s] = this.parseLocaleValue(a, e);
+    }
+    return r;
+  }
+  parseLocaleValue(t, e) {
+    const r = this.unwrapExpression(t);
+    if (o.isStringLiteral(r) || o.isNoSubstitutionTemplateLiteral(r))
+      return r.text;
+    if (o.isIdentifier(r)) {
+      const n = e.declarations.get(r.text);
+      if (!n)
+        throw new Error(`[i18n] Unsupported locale value reference "${r.text}" in ${e.sourceFile.fileName}`);
+      return this.parseLocaleValue(n, e);
+    }
+    if (o.isObjectLiteralExpression(r))
+      return this.parseLocaleObjectLiteral(r, e);
+    throw new Error(`[i18n] Locale values must be strings or nested objects in ${e.sourceFile.fileName}`);
+  }
+  unwrapExpression(t) {
+    let e = t;
+    for (; o.isAsExpression(e) || o.isParenthesizedExpression(e) || o.isSatisfiesExpression(e) || o.isTypeAssertionExpression(e); )
+      e = e.expression;
+    return e;
+  }
+  readPropertyName(t, e) {
+    if (o.isIdentifier(t) || o.isStringLiteral(t) || o.isNumericLiteral(t))
+      return t.text;
+    throw new Error(`[i18n] Unsupported locale property name "${t.getText(e)}" in ${e.fileName}`);
+  }
+  validateLocales(t) {
+    const e = [], r = t[this.options.sourceLocale];
+    this.validateSourceMessages(r, e, "");
+    for (const [n, s] of Object.entries(t))
+      n !== this.options.sourceLocale && this.assertMatchingLocaleTree(r, s, n, "", e);
+    return e;
+  }
+  validateSourceMessages(t, e, r) {
+    if (typeof t == "string") {
+      try {
+        g(t);
+      } catch (n) {
+        e.push(this.createDiagnostic("error", `[i18n] Invalid ICU message at "${r}": ${L(n)}`));
+      }
+      return;
+    }
+    for (const [n, s] of Object.entries(t)) {
+      const a = r ? `${r}.${n}` : n;
+      this.validateSourceMessages(s, e, a);
+    }
+  }
+  assertMatchingLocaleTree(t, e, r, n, s) {
+    if (typeof t == "string") {
+      if (typeof e != "string") {
+        s.push(this.createMissingKeyDiagnostic(r, n));
+        return;
+      }
+      this.compareMessages(t, e, r, n, s);
+      return;
+    }
+    if (!T(e)) {
+      this.collectMissingLeafDiagnostics(t, r, n, s);
+      return;
+    }
+    for (const [a, c] of Object.entries(t)) {
+      const l = n ? `${n}.${a}` : a;
+      this.assertMatchingLocaleTree(c, e[a], r, l, s);
+    }
+  }
+  collectMissingLeafDiagnostics(t, e, r, n) {
+    if (typeof t == "string") {
+      n.push(this.createMissingKeyDiagnostic(e, r));
+      return;
+    }
+    for (const [s, a] of Object.entries(t)) {
+      const c = r ? `${r}.${s}` : s;
+      this.collectMissingLeafDiagnostics(a, e, c, n);
+    }
+  }
+  compareMessages(t, e, r, n, s) {
+    let a, c;
+    try {
+      a = g(t), c = g(e);
+    } catch (f) {
+      s.push(
+        this.createDiagnostic("error", `[i18n] ICU signature error at "${n}" in locale "${r}": ${L(f)}`)
+      );
+      return;
+    }
+    const l = Object.keys(a).sort(), d = Object.keys(c).sort();
+    if (l.join("|") !== d.join("|")) {
+      s.push(
+        this.createDiagnostic(
+          "error",
+          `[i18n] ICU params mismatch at "${n}" in locale "${r}". Expected [${l.join(", ")}], received [${d.join(", ")}].`
+        )
+      );
+      return;
+    }
+    for (const f of l) {
+      const m = a[f], h = c[f];
+      if (!h || m.kind !== h.kind) {
+        s.push(
+          this.createDiagnostic(
+            "error",
+            `[i18n] ICU param "${f}" at "${n}" in locale "${r}" must stay "${m.kind}".`
+          )
+        );
+        continue;
+      }
+      if (m.kind === "select") {
+        const E = /* @__PURE__ */ new Set([...m.selectors ?? [], "other"]);
+        for (const w of E)
+          (h.selectors ?? []).includes(w) || s.push(
+            this.createDiagnostic(
+              "error",
+              `[i18n] ICU select "${f}" at "${n}" in locale "${r}" is missing selector "${w}".`
+            )
+          );
+      }
+      m.kind === "plural" && !(h.selectors ?? []).includes("other") && s.push(
+        this.createDiagnostic(
+          "error",
+          `[i18n] ICU plural "${f}" at "${n}" in locale "${r}" must include "other".`
+        )
+      );
+    }
+  }
+  createMissingKeyDiagnostic(t, e) {
+    const [r = "unknown"] = e.split("."), n = u.join(this.options.localesDir, t, `${r}.ts`), s = this.options.strict === !1 ? "warn" : "error";
+    return this.createDiagnostic(
+      s,
+      `[i18n] Locale "${t}" is missing key "${e}". File: ${n}. Reference locale: ${this.options.sourceLocale}`
+    );
+  }
+  createDiagnostic(t, e) {
+    return { level: t, message: e };
+  }
+  flushDiagnostics(t) {
+    for (const r of t.filter((n) => n.level === "warn"))
+      this.warn(r.message);
+    const e = t.filter((r) => r.level === "error");
+    if (e.length > 0)
+      throw new Error(e.map((r) => r.message).join(`
+`));
+  }
+  writeRuntimeArtifacts(t) {
+    const e = u.join(this.options.outputDir, "runtime");
+    p.mkdirSync(e, { recursive: !0 });
+    const r = Object.keys(t).sort((n, s) => n.localeCompare(s));
+    p.writeFileSync(
+      u.join(e, "manifest.json"),
+      `${JSON.stringify({ sourceLocale: this.options.sourceLocale, locales: r }, null, 2)}
+`
+    );
+    for (const n of r)
+      p.writeFileSync(
+        u.join(e, `${n}.json`),
+        `${JSON.stringify(t[n], null, 2)}
+`
+      );
+  }
+  writeVirtualKeyDeclaration(t) {
+    const e = t[this.options.sourceLocale], r = Object.keys(e).filter(S), n = [
+      "declare module 'virtual:routa-i18n/keys' {",
+      "  import type { I18nKey, I18nPrimitive } from '@routa/i18n'",
+      "",
+      `  export declare const k: ${this.renderDeclarationTree(e, t, "", 1)}`,
+      ...r.map((s) => `  export declare const ${s}: typeof k.${s}`),
+      "}",
+      ""
+    ].join(`
+`);
+    p.writeFileSync(u.join(this.options.outputDir, "virtual-routa-i18n-keys.d.ts"), n);
+  }
+  renderDeclarationTree(t, e, r = "", n = 0) {
+    const s = "  ".repeat(n), a = "  ".repeat(n + 1);
+    return typeof t == "string" ? `I18nKey<'${$(r)}', ${this.renderParamsType(t)}>` : `{
+${Object.entries(t).map(([l, d]) => {
+      const f = r ? `${r}.${l}` : l, m = this.renderPropertyName(l);
+      return typeof d == "string" ? `${this.renderHoverDoc(e, f, n + 1)}
+${a}${m}: ${this.renderDeclarationTree(d, e, f, n + 1)}` : `${a}${m}: ${this.renderDeclarationTree(d, e, f, n + 1)}`;
+    }).join(`,
+`)}
+${s}}`;
+  }
+  renderHoverDoc(t, e, r) {
+    const n = "  ".repeat(r), s = [`${n}/**`];
+    for (const [a, c] of Object.entries(t)) {
+      const l = this.getTranslationByPath(c, e);
+      l !== null && s.push(`${n} * ${a}: ${F(l)}`);
+    }
+    return s.push(`${n} */`), s.join(`
+`);
+  }
+  renderParamsType(t) {
+    const e = g(t), r = Object.entries(e);
+    return r.length === 0 ? "undefined" : `{ ${r.map(([s, a]) => `${this.renderPropertyName(s)}: ${this.renderParamMetaType(a)}`).join("; ")} }`;
+  }
+  renderParamMetaType(t) {
+    var r;
+    return t.kind === "argument" ? "I18nPrimitive" : t.kind === "number" || t.kind === "plural" ? "number" : t.kind === "date" || t.kind === "time" ? "Date | number" : ((r = t.selectors) != null && r.length ? t.selectors : ["other"]).map((n) => `'${$(n)}'`).join(" | ");
+  }
+  renderRuntimeKeyTree(t, e = "", r = 0) {
+    const n = "  ".repeat(r), s = "  ".repeat(r + 1);
+    return typeof t == "string" ? `'${$(e)}'` : `{
+${Object.entries(t).map(([c, l]) => {
+      const d = e ? `${e}.${c}` : c;
+      return `${s}${this.renderPropertyName(c)}: ${this.renderRuntimeKeyTree(l, d, r + 1)}`;
+    }).join(`,
+`)}
+${n}}`;
+  }
+  getTranslationByPath(t, e) {
+    const r = e.split(".");
+    let n = t;
+    for (const s of r) {
+      if (!n || typeof n == "string")
+        return null;
+      n = n[s];
+    }
+    return typeof n == "string" ? n : null;
+  }
+  renderPropertyName(t) {
+    return S(t) ? t : `'${$(t)}'`;
+  }
+  removeObsoleteArtifacts(t) {
+    for (const e of ["keys.ts", "keys.gen.ts", "meta.json", "source-catalog.ts"]) {
+      const r = u.join(t, e);
+      p.existsSync(r) && p.unlinkSync(r);
+    }
+  }
+  warn(t) {
+    if (this.options.onWarn) {
+      this.options.onWarn(t);
+      return;
+    }
+    console.warn(t);
+  }
+}
+function $(i) {
+  return i.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function F(i) {
+  return i.replace(/\r?\n/g, "\\n").replace(/\*\//g, "*\\/");
+}
+function L(i) {
+  return i instanceof Error ? i.message : String(i);
+}
+function S(i) {
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(i);
+}
+const j = "virtual:routa-i18n/keys", D = `\0${j}`;
+function z(i) {
+  const t = new C(i), e = i.include.map((r) => y(u.resolve(r)));
+  return {
+    name: "routa:i18n",
+    resolveId(r) {
+      return r === j ? D : null;
+    },
+    load(r) {
+      return r === D ? t.renderVirtualKeyRuntimeModule() : null;
+    },
+    configResolved(r) {
+      t.setStrict(i.strict ?? (r.command === "build" || process.env.CI === "true")), t.generate();
+    },
+    transform(r, n) {
+      const s = y(n.split("?")[0]);
+      if (!e.some((l) => s.startsWith(l)) || !O(n, s))
+        return null;
+      const c = v(r, s);
+      return c === r ? null : {
+        code: c,
+        map: null
+      };
+    },
+    configureServer(r) {
+      r.watcher.add(u.resolve(i.localesDir)), r.watcher.on("change", (n) => {
+        y(n).startsWith(y(u.resolve(i.localesDir))) && (t.generate(), r.ws.send({ type: "full-reload" }));
+      });
+    }
+  };
+}
+function v(i, t) {
+  const e = o.createSourceFile(t, i, o.ScriptTarget.Latest, !0, A(t)), r = M(e);
+  if (r.size === 0)
+    return i;
+  const n = [], s = (c) => {
+    if (o.isPropertyAccessExpression(c)) {
+      const l = N(c, r);
+      if (l) {
+        n.push({
+          start: c.getStart(e),
+          end: c.getEnd(),
+          replacement: `'${l}'`
+        });
+        return;
+      }
+    }
+    o.forEachChild(c, s);
+  };
+  if (s(e), n.length === 0)
+    return i;
+  let a = i;
+  for (const c of n.sort((l, d) => d.start - l.start))
+    a = `${a.slice(0, c.start)}${c.replacement}${a.slice(c.end)}`;
+  return a;
+}
+function M(i) {
+  var e, r;
+  const t = /* @__PURE__ */ new Map();
+  for (const n of i.statements) {
+    if (!o.isImportDeclaration(n) || !((e = n.importClause) != null && e.namedBindings) || !o.isStringLiteral(n.moduleSpecifier) || n.moduleSpecifier.text !== j)
+      continue;
+    const s = n.importClause.namedBindings;
+    if (o.isNamedImports(s))
+      for (const a of s.elements) {
+        const c = ((r = a.propertyName) == null ? void 0 : r.text) ?? a.name.text;
+        t.set(a.name.text, c === "k" ? "" : c);
+      }
+  }
+  return t;
+}
+function N(i, t) {
+  const e = [i.name.text];
+  let r = i.expression;
+  for (; o.isPropertyAccessExpression(r); )
+    e.unshift(r.name.text), r = r.expression;
+  if (!o.isIdentifier(r))
+    return null;
+  const n = t.get(r.text);
+  return n === void 0 ? null : n ? `${n}.${e.join(".")}` : e.join(".");
+}
+function O(i, t) {
+  return /\.(ts|tsx|js|jsx|vue)$/.test(t) || i.includes(".vue?") || i.includes("&lang.ts") || i.includes("&lang.js");
+}
+function A(i) {
+  return i.endsWith(".tsx") ? o.ScriptKind.TSX : i.endsWith(".jsx") ? o.ScriptKind.JSX : i.endsWith(".js") ? o.ScriptKind.JS : o.ScriptKind.TS;
+}
+function y(i) {
+  return i.replaceAll("\\", "/");
+}
+export {
+  z as i18nPlugin
+};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@routa/i18n-vue",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "http://git.sunbtech.com/wangzg/routa.git"
+  },
+  "bugs": {
+    "url": "http://git.sunbtech.com/wangzg/routa/-/issues"
+  },
+  "homepage": "http://git.sunbtech.com/wangzg/routa",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./vite-plugin": {
+      "types": "./dist/vite-plugin.d.ts",
+      "import": "./dist/vite-plugin.mjs",
+      "require": "./dist/vite-plugin.js"
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "typescript": "~6.0.3"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0"
+  },
+  "devDependencies": {
+    "vue": "^3.5.13",
+    "vite": "^6.4.2",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}