@i18n-micro/core 1.1.3 → 1.2.0

package/README.md

@@ -93,10 +93,6 @@ console.log(localizedRoute) // Localized route object
   Sets the cache for a specific route and locale.
 - **`mergeTranslation(locale: string, routeName: string, newTranslations: Translations, force = false): void`**:
   Merges new translations into the cache for a specific route and locale.
-- **`mergeGlobalTranslation(locale: string, newTranslations: Translations, force = false): void`**:
-  Merges new translations into the global cache for a specific locale.
-- **`hasGeneralTranslation(locale: string): boolean`**:
-  Checks if global translations are loaded for the specified locale.
 - **`hasPageTranslation(locale: string, routeName: string): boolean`**:
   Checks if translations for a specific route and locale are loaded.
 - **`hasTranslation(locale: string, key: string): boolean`**:

package/dist/base.d.ts

@@ -6,12 +6,7 @@ export interface BaseI18nOptions {
     plural?: PluralFunc;
     missingWarn?: boolean;
     missingHandler?: (locale: string, key: string, routeName: string) => void;
-    getPreviousPageInfo?: () => {
-        locale: string;
-        routeName: string;
-    } | null;
     getCustomMissingHandler?: () => MissingHandler | null;
-    enablePreviousPageFallback?: boolean;
 }
 /**
  * Abstract base class for i18n adapters
@@ -25,12 +20,7 @@ export declare abstract class BaseI18n {
     pluralFunc: PluralFunc;
     missingWarn: boolean;
     missingHandler?: (locale: string, key: string, routeName: string) => void;
-    getPreviousPageInfo?: () => {
-        locale: string;
-        routeName: string;
-    } | null;
     getCustomMissingHandler?: () => MissingHandler | null;
-    enablePreviousPageFallback: boolean;
     constructor(options?: BaseI18nOptions);
     /**
      * Get current locale
@@ -82,7 +72,7 @@ export declare abstract class BaseI18n {
      * Core translation loading logic (without reactivity)
      * Subclasses can override addTranslations/addRouteTranslations to add reactivity
      */
-    loadTranslationsCore(locale: string, translations: Translations, merge: boolean): void;
+    loadTranslationsCore(locale: string, translations: Translations, merge: boolean, routeName?: string): void;
     /**
      * Core route translation loading logic (without reactivity)
      * Subclasses can override addRouteTranslations to add reactivity

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class g{formatNumber(e,t,r){return new Intl.NumberFormat(t,r).format(e)}formatDate(e,t,r){const n=new Date(e);return Number.isNaN(n.getTime())?"Invalid Date":new Intl.DateTimeFormat(t,r).format(n)}formatRelativeTime(e,t,r){const n=new Date(e);if(Number.isNaN(n.getTime()))return new Intl.RelativeTimeFormat(t,r).format(0,"second");const i=Math.floor((new Date().getTime()-n.getTime())/1e3),o=[{unit:"year",seconds:31536e3},{unit:"month",seconds:2592e3},{unit:"day",seconds:86400},{unit:"hour",seconds:3600},{unit:"minute",seconds:60},{unit:"second",seconds:1}];for(const{unit:l,seconds:u}of o){const c=Math.floor(i/u);if(c>=1)return new Intl.RelativeTimeFormat(t,r).format(-c,l)}return new Intl.RelativeTimeFormat(t,r).format(0,"second")}}const p=/\{(\w+)\}/g;function h(s,e){return e?s.replace(p,(t,r)=>{const n=e[r];return n!==void 0?String(n):`{${r}}`}):s}function v(s){return s==="prefix"||s==="prefix_and_default"}function T(s){return s==="no_prefix"}function P(s){return s==="prefix"}function b(s){return s==="prefix_except_default"}function x(s){return s==="prefix_and_default"}const m=(s,e,t,r,n)=>{const a=n(s,t);if(!a)return null;const i=a.toString().split("|");if(i.length===0)return null;const o=e<i.length?i[e]:i[i.length-1];return o?o.trim().replace("{count}",e.toString()):null};function f(s,e){if(!s||typeof e!="string")return null;if(e in s){const n=s[e];return n}const t=e.split(".");let r=s;for(const n of t)if(r&&typeof r=="object"&&n in r)r=r[n];else return null;return r??null}function d(s){const e=s?.translations??new Map;return{hasCache(t,r){const n=`${t}:${r}`;return e.has(n)||e.has(t)},getCache(t,r){const n=`${t}:${r}`;return e.get(n)},setCache(t,r,n){},hasTranslation(t,r){for(const[n,a]of e)if((n===t||n.startsWith(`${t}:`))&&f(a,r)!==null)return!0;return!1},hasGeneralTranslation(t){return e.has(t)},hasPageTranslation(t,r){return e.has(`${t}:${r}`)},getTranslation(t,r,n){const a=`${t}:${r}`,i=e.get(a),o=f(i,n);if(o!==null)return o;const l=e.get(t);return f(l,n)},loadTranslations(t,r){const n=e.get(t)??{};e.set(t,{...n,...r})},setTranslations(t,r){e.set(t,r)},loadPageTranslations(t,r,n){const a=`${t}:${r}`,i=e.get(a);!i||Object.keys(i).length===0?e.set(a,n):e.set(a,{...i,...n})},mergeTranslation(t,r,n,a=!1){const i=`${t}:${r}`,o=e.get(i)??{};e.set(i,{...o,...n})},mergeGlobalTranslation(t,r,n=!1){const a=e.get(t)??{};e.set(t,{...a,...r})},clearCache(){e.clear()}}}class N{constructor(e={}){this.formatter=new g,this.helper=d(e.storage),this.formatter=new g,this.pluralFunc=e.plural||m,this.missingWarn=e.missingWarn??!0,this.missingHandler=e.missingHandler,this.getPreviousPageInfo=e.getPreviousPageInfo,this.getCustomMissingHandler=e.getCustomMissingHandler,this.enablePreviousPageFallback=e.enablePreviousPageFallback??!1}t(e,t,r,n){if(!e)return"";const a=this.getLocale(),i=n||this.getRoute();let o=this.helper.getTranslation(a,i,e);if(!o&&this.enablePreviousPageFallback&&this.getPreviousPageInfo){const l=this.getPreviousPageInfo();if(l){const u=this.helper.getTranslation(l.locale,l.routeName,e);u&&(o=u,process.env.NODE_ENV!=="production"&&console.log(`Using fallback translation from previous route: ${l.routeName} -> ${e}`))}}if(!o){const l=this.getFallbackLocale();a!==l&&(o=this.helper.getTranslation(l,i,e))}if(!o){const l=this.getCustomMissingHandler?.();l?l(a,e,i):this.missingHandler?this.missingHandler(a,e,i):this.missingWarn&&process.env.NODE_ENV!=="production"&&typeof window<"u"&&console.warn(`Not found '${e}' key in '${a}' locale messages for route '${i}'.`),o=r===void 0?e:r||e}return typeof o=="string"&&t?h(o,t):o}ts(e,t,r,n){return this.t(e,t,r,n)?.toString()??r??e}tc(e,t,r){const{count:n,...a}=typeof t=="number"?{count:t}:t;if(n===void 0)return r??e;const i=(l,u,c)=>this.t(l,u,c);return this.pluralFunc(e,Number.parseInt(n.toString(),10),a,this.getLocale(),i)??r??e}tn(e,t){return this.formatter.formatNumber(e,this.getLocale(),t)}td(e,t){return this.formatter.formatDate(e,this.getLocale(),t)}tdr(e,t){return this.formatter.formatRelativeTime(e,this.getLocale(),t)}has(e,t){const r=t||this.getRoute(),n=this.getLocale();return!!this.helper.getTranslation(n,r,e)}clearCache(){this.helper.clearCache()}loadTranslationsCore(e,t,r){r?this.helper.mergeGlobalTranslation(e,t,!0):this.helper.setTranslations(e,t)}loadRouteTranslationsCore(e,t,r,n){n?this.helper.mergeTranslation(e,t,r,!0):this.helper.loadPageTranslations(e,t,r)}}exports.BaseI18n=N;exports.FormatService=g;exports.defaultPlural=m;exports.interpolate=h;exports.isNoPrefixStrategy=T;exports.isPrefixAndDefaultStrategy=x;exports.isPrefixExceptDefaultStrategy=b;exports.isPrefixStrategy=P;exports.useTranslationHelper=d;exports.withPrefixStrategy=v;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class f{formatNumber(t,e,n){return new Intl.NumberFormat(e,n).format(t)}formatDate(t,e,n){const r=new Date(t);return Number.isNaN(r.getTime())?"Invalid Date":new Intl.DateTimeFormat(e,n).format(r)}formatRelativeTime(t,e,n){const r=new Date(t);if(Number.isNaN(r.getTime()))return new Intl.RelativeTimeFormat(e,n).format(0,"second");const i=Math.floor((new Date().getTime()-r.getTime())/1e3),o=[{unit:"year",seconds:31536e3},{unit:"month",seconds:2592e3},{unit:"day",seconds:86400},{unit:"hour",seconds:3600},{unit:"minute",seconds:60},{unit:"second",seconds:1}];for(const{unit:l,seconds:c}of o){const u=Math.floor(i/c);if(u>=1)return new Intl.RelativeTimeFormat(e,n).format(-u,l)}return new Intl.RelativeTimeFormat(e,n).format(0,"second")}}const p=/\{(\w+)\}/g;function h(s,t){return t?s.replace(p,(e,n)=>{const r=t[n];return r!==void 0?String(r):`{${n}}`}):s}function x(s){return s==="prefix"||s==="prefix_and_default"}function T(s){return s==="no_prefix"}function v(s){return s==="prefix"}function $(s){return s==="prefix_except_default"}function S(s){return s==="prefix_and_default"}const m=(s,t,e,n,r)=>{const a=r(s,e);if(!a)return null;const i=a.toString().split("|");if(i.length===0)return null;const o=t<i.length?i[t]:i[i.length-1];return o?o.trim().replace("{count}",t.toString()):null};function g(s,t){if(!s||typeof t!="string")return null;if(t in s){const r=s[t];return r}const e=t.split(".");let n=s;for(const r of e)if(n&&typeof n=="object"&&r in n)n=n[r];else return null;return n??null}function d(s){const t=s?.translations??new Map;return{hasCache(e,n){const r=n||"index";return t.has(`${e}:${r}`)},getCache(e,n){const r=n||"index";return t.get(`${e}:${r}`)},setCache(e,n,r){},hasTranslation(e,n){for(const[r,a]of t)if(r.startsWith(`${e}:`)&&g(a,n)!==null)return!0;return!1},hasPageTranslation(e,n){const r=n||"index";return t.has(`${e}:${r}`)},getTranslation(e,n,r){const a=n||"index";return g(t.get(`${e}:${a}`),r)},loadTranslations(e,n,r="index"){const i=`${e}:${r||"index"}`,o=t.get(i)??{};t.set(i,{...o,...n})},setTranslations(e,n,r="index"){const a=r||"index";t.set(`${e}:${a}`,n)},loadPageTranslations(e,n,r){const i=`${e}:${n||"index"}`,o=t.get(i);!o||Object.keys(o).length===0?t.set(i,r):t.set(i,{...o,...r})},mergeTranslation(e,n,r,a=!1){const o=`${e}:${n||"index"}`,l=t.get(o)??{};t.set(o,{...l,...r})},clearCache(){t.clear()}}}class w{constructor(t={}){this.formatter=new f,this.helper=d(t.storage),this.formatter=new f,this.pluralFunc=t.plural||m,this.missingWarn=t.missingWarn??!0,this.missingHandler=t.missingHandler,this.getCustomMissingHandler=t.getCustomMissingHandler}t(t,e,n,r){if(!t)return"";const a=this.getLocale(),i=r||this.getRoute();let o=this.helper.getTranslation(a,i,t);if(!o){const l=this.getFallbackLocale();a!==l&&(o=this.helper.getTranslation(l,i,t))}if(!o){const l=this.getCustomMissingHandler?.();l?l(a,t,i):this.missingHandler?this.missingHandler(a,t,i):this.missingWarn&&process.env.NODE_ENV!=="production"&&typeof window<"u"&&console.warn(`Not found '${t}' key in '${a}' locale messages for route '${i}'.`),o=n===void 0?t:n||t}return typeof o=="string"&&e?h(o,e):o}ts(t,e,n,r){return this.t(t,e,n,r)?.toString()??n??t}tc(t,e,n){const{count:r,...a}=typeof e=="number"?{count:e}:e;if(r===void 0)return n??t;const i=(l,c,u)=>this.t(l,c,u);return this.pluralFunc(t,Number.parseInt(r.toString(),10),a,this.getLocale(),i)??n??t}tn(t,e){return this.formatter.formatNumber(t,this.getLocale(),e)}td(t,e){return this.formatter.formatDate(t,this.getLocale(),e)}tdr(t,e){return this.formatter.formatRelativeTime(t,this.getLocale(),e)}has(t,e){const n=e||this.getRoute(),r=this.getLocale();return!!this.helper.getTranslation(r,n,t)}clearCache(){this.helper.clearCache()}loadTranslationsCore(t,e,n,r="index"){n?this.helper.mergeTranslation(t,r,e,!0):this.helper.setTranslations(t,e,r)}loadRouteTranslationsCore(t,e,n,r){r?this.helper.mergeTranslation(t,e,n,!0):this.helper.loadPageTranslations(t,e,n)}}exports.BaseI18n=w;exports.FormatService=f;exports.defaultPlural=m;exports.interpolate=h;exports.isNoPrefixStrategy=T;exports.isPrefixAndDefaultStrategy=S;exports.isPrefixExceptDefaultStrategy=$;exports.isPrefixStrategy=v;exports.useTranslationHelper=d;exports.withPrefixStrategy=x;

package/dist/index.mjs

@@ -1,15 +1,15 @@
-class g {
-  formatNumber(e, t, n) {
-    return new Intl.NumberFormat(t, n).format(e);
+class f {
+  formatNumber(t, e, n) {
+    return new Intl.NumberFormat(e, n).format(t);
   }
-  formatDate(e, t, n) {
-    const r = new Date(e);
-    return Number.isNaN(r.getTime()) ? "Invalid Date" : new Intl.DateTimeFormat(t, n).format(r);
+  formatDate(t, e, n) {
+    const r = new Date(t);
+    return Number.isNaN(r.getTime()) ? "Invalid Date" : new Intl.DateTimeFormat(e, n).format(r);
   }
-  formatRelativeTime(e, t, n) {
-    const r = new Date(e);
+  formatRelativeTime(t, e, n) {
+    const r = new Date(t);
     if (Number.isNaN(r.getTime()))
-      return new Intl.RelativeTimeFormat(t, n).format(0, "second");
+      return new Intl.RelativeTimeFormat(e, n).format(0, "second");
     const i = Math.floor(((/* @__PURE__ */ new Date()).getTime() - r.getTime()) / 1e3), o = [
       { unit: "year", seconds: 31536e3 },
       { unit: "month", seconds: 2592e3 },
@@ -21,51 +21,51 @@ class g {
     for (const { unit: l, seconds: u } of o) {
       const c = Math.floor(i / u);
       if (c >= 1)
-        return new Intl.RelativeTimeFormat(t, n).format(-c, l);
+        return new Intl.RelativeTimeFormat(e, n).format(-c, l);
     }
-    return new Intl.RelativeTimeFormat(t, n).format(0, "second");
+    return new Intl.RelativeTimeFormat(e, n).format(0, "second");
   }
 }
-const h = /\{(\w+)\}/g;
-function m(s, e) {
-  return e ? s.replace(h, (t, n) => {
-    const r = e[n];
+const g = /\{(\w+)\}/g;
+function m(s, t) {
+  return t ? s.replace(g, (e, n) => {
+    const r = t[n];
     return r !== void 0 ? String(r) : `{${n}}`;
   }) : s;
 }
-function v(s) {
+function x(s) {
   return s === "prefix" || s === "prefix_and_default";
 }
 function T(s) {
   return s === "no_prefix";
 }
-function P(s) {
+function $(s) {
   return s === "prefix";
 }
-function b(s) {
+function v(s) {
   return s === "prefix_except_default";
 }
-function N(s) {
+function w(s) {
   return s === "prefix_and_default";
 }
-const d = (s, e, t, n, r) => {
-  const a = r(s, t);
+const d = (s, t, e, n, r) => {
+  const a = r(s, e);
   if (!a)
     return null;
   const i = a.toString().split("|");
   if (i.length === 0) return null;
-  const o = e < i.length ? i[e] : i[i.length - 1];
-  return o ? o.trim().replace("{count}", e.toString()) : null;
+  const o = t < i.length ? i[t] : i[i.length - 1];
+  return o ? o.trim().replace("{count}", t.toString()) : null;
 };
-function f(s, e) {
-  if (!s || typeof e != "string") return null;
-  if (e in s) {
-    const r = s[e];
+function h(s, t) {
+  if (!s || typeof t != "string") return null;
+  if (t in s) {
+    const r = s[t];
     return r;
   }
-  const t = e.split(".");
+  const e = t.split(".");
   let n = s;
-  for (const r of t)
+  for (const r of e)
     if (n && typeof n == "object" && r in n)
       n = n[r];
     else
@@ -73,131 +73,117 @@ function f(s, e) {
   return n ?? null;
 }
 function p(s) {
-  const e = s?.translations ?? /* @__PURE__ */ new Map();
+  const t = s?.translations ?? /* @__PURE__ */ new Map();
   return {
-    hasCache(t, n) {
-      const r = `${t}:${n}`;
-      return e.has(r) || e.has(t);
+    hasCache(e, n) {
+      const r = n || "index";
+      return t.has(`${e}:${r}`);
     },
-    getCache(t, n) {
-      const r = `${t}:${n}`;
-      return e.get(r);
+    getCache(e, n) {
+      const r = n || "index";
+      return t.get(`${e}:${r}`);
     },
-    setCache(t, n, r) {
+    setCache(e, n, r) {
     },
-    hasTranslation(t, n) {
-      for (const [r, a] of e)
-        if ((r === t || r.startsWith(`${t}:`)) && f(a, n) !== null)
+    hasTranslation(e, n) {
+      for (const [r, a] of t)
+        if (r.startsWith(`${e}:`) && h(a, n) !== null)
           return !0;
       return !1;
     },
-    hasGeneralTranslation(t) {
-      return e.has(t);
-    },
-    hasPageTranslation(t, n) {
-      return e.has(`${t}:${n}`);
+    hasPageTranslation(e, n) {
+      const r = n || "index";
+      return t.has(`${e}:${r}`);
     },
-    getTranslation(t, n, r) {
-      const a = `${t}:${n}`, i = e.get(a), o = f(i, r);
-      if (o !== null) return o;
-      const l = e.get(t);
-      return f(l, r);
+    getTranslation(e, n, r) {
+      const a = n || "index";
+      return h(t.get(`${e}:${a}`), r);
     },
-    loadTranslations(t, n) {
-      const r = e.get(t) ?? {};
-      e.set(t, { ...r, ...n });
+    loadTranslations(e, n, r = "index") {
+      const i = `${e}:${r || "index"}`, o = t.get(i) ?? {};
+      t.set(i, { ...o, ...n });
     },
-    setTranslations(t, n) {
-      e.set(t, n);
+    setTranslations(e, n, r = "index") {
+      const a = r || "index";
+      t.set(`${e}:${a}`, n);
     },
-    loadPageTranslations(t, n, r) {
-      const a = `${t}:${n}`, i = e.get(a);
-      !i || Object.keys(i).length === 0 ? e.set(a, r) : e.set(a, { ...i, ...r });
+    loadPageTranslations(e, n, r) {
+      const i = `${e}:${n || "index"}`, o = t.get(i);
+      !o || Object.keys(o).length === 0 ? t.set(i, r) : t.set(i, { ...o, ...r });
     },
-    mergeTranslation(t, n, r, a = !1) {
-      const i = `${t}:${n}`, o = e.get(i) ?? {};
-      e.set(i, { ...o, ...r });
-    },
-    mergeGlobalTranslation(t, n, r = !1) {
-      const a = e.get(t) ?? {};
-      e.set(t, { ...a, ...n });
+    mergeTranslation(e, n, r, a = !1) {
+      const o = `${e}:${n || "index"}`, l = t.get(o) ?? {};
+      t.set(o, { ...l, ...r });
     },
     clearCache() {
-      e.clear();
+      t.clear();
     }
   };
 }
-class $ {
-  constructor(e = {}) {
-    this.formatter = new g(), this.helper = p(e.storage), this.formatter = new g(), this.pluralFunc = e.plural || d, this.missingWarn = e.missingWarn ?? !0, this.missingHandler = e.missingHandler, this.getPreviousPageInfo = e.getPreviousPageInfo, this.getCustomMissingHandler = e.getCustomMissingHandler, this.enablePreviousPageFallback = e.enablePreviousPageFallback ?? !1;
+class _ {
+  constructor(t = {}) {
+    this.formatter = new f(), this.helper = p(t.storage), this.formatter = new f(), this.pluralFunc = t.plural || d, this.missingWarn = t.missingWarn ?? !0, this.missingHandler = t.missingHandler, this.getCustomMissingHandler = t.getCustomMissingHandler;
   }
   // --- Public methods (implemented in base class) ---
   /**
    * Get translation for a key
    * Based on logic from src/runtime/plugins/01.plugin.ts
    */
-  t(e, t, n, r) {
-    if (!e) return "";
+  t(t, e, n, r) {
+    if (!t) return "";
     const a = this.getLocale(), i = r || this.getRoute();
-    let o = this.helper.getTranslation(a, i, e);
-    if (!o && this.enablePreviousPageFallback && this.getPreviousPageInfo) {
-      const l = this.getPreviousPageInfo();
-      if (l) {
-        const u = this.helper.getTranslation(l.locale, l.routeName, e);
-        u && (o = u, process.env.NODE_ENV !== "production" && console.log(`Using fallback translation from previous route: ${l.routeName} -> ${e}`));
-      }
-    }
+    let o = this.helper.getTranslation(a, i, t);
     if (!o) {
       const l = this.getFallbackLocale();
-      a !== l && (o = this.helper.getTranslation(l, i, e));
+      a !== l && (o = this.helper.getTranslation(l, i, t));
     }
     if (!o) {
       const l = this.getCustomMissingHandler?.();
-      l ? l(a, e, i) : this.missingHandler ? this.missingHandler(a, e, i) : this.missingWarn && process.env.NODE_ENV !== "production" && typeof window < "u" && console.warn(`Not found '${e}' key in '${a}' locale messages for route '${i}'.`), o = n === void 0 ? e : n || e;
+      l ? l(a, t, i) : this.missingHandler ? this.missingHandler(a, t, i) : this.missingWarn && process.env.NODE_ENV !== "production" && typeof window < "u" && console.warn(`Not found '${t}' key in '${a}' locale messages for route '${i}'.`), o = n === void 0 ? t : n || t;
     }
-    return typeof o == "string" && t ? m(o, t) : o;
+    return typeof o == "string" && e ? m(o, e) : o;
   }
   /**
    * Get translation as string
    */
-  ts(e, t, n, r) {
-    return this.t(e, t, n, r)?.toString() ?? n ?? e;
+  ts(t, e, n, r) {
+    return this.t(t, e, n, r)?.toString() ?? n ?? t;
   }
   /**
    * Plural translation
    */
-  tc(e, t, n) {
-    const { count: r, ...a } = typeof t == "number" ? { count: t } : t;
+  tc(t, e, n) {
+    const { count: r, ...a } = typeof e == "number" ? { count: e } : e;
     if (r === void 0)
-      return n ?? e;
+      return n ?? t;
     const i = (l, u, c) => this.t(l, u, c);
-    return this.pluralFunc(e, Number.parseInt(r.toString(), 10), a, this.getLocale(), i) ?? n ?? e;
+    return this.pluralFunc(t, Number.parseInt(r.toString(), 10), a, this.getLocale(), i) ?? n ?? t;
   }
   /**
    * Format number
    */
-  tn(e, t) {
-    return this.formatter.formatNumber(e, this.getLocale(), t);
+  tn(t, e) {
+    return this.formatter.formatNumber(t, this.getLocale(), e);
   }
   /**
    * Format date
    */
-  td(e, t) {
-    return this.formatter.formatDate(e, this.getLocale(), t);
+  td(t, e) {
+    return this.formatter.formatDate(t, this.getLocale(), e);
   }
   /**
    * Format relative time
    */
-  tdr(e, t) {
-    return this.formatter.formatRelativeTime(e, this.getLocale(), t);
+  tdr(t, e) {
+    return this.formatter.formatRelativeTime(t, this.getLocale(), e);
   }
   /**
    * Check if translation exists
    * Based on logic from src/runtime/plugins/01.plugin.ts
    */
-  has(e, t) {
-    const n = t || this.getRoute(), r = this.getLocale();
-    return !!this.helper.getTranslation(r, n, e);
+  has(t, e) {
+    const n = e || this.getRoute(), r = this.getLocale();
+    return !!this.helper.getTranslation(r, n, t);
   }
   /**
    * Clear cache
@@ -210,26 +196,26 @@ class $ {
    * Core translation loading logic (without reactivity)
    * Subclasses can override addTranslations/addRouteTranslations to add reactivity
    */
-  loadTranslationsCore(e, t, n) {
-    n ? this.helper.mergeGlobalTranslation(e, t, !0) : this.helper.setTranslations(e, t);
+  loadTranslationsCore(t, e, n, r = "index") {
+    n ? this.helper.mergeTranslation(t, r, e, !0) : this.helper.setTranslations(t, e, r);
   }
   /**
    * Core route translation loading logic (without reactivity)
    * Subclasses can override addRouteTranslations to add reactivity
    */
-  loadRouteTranslationsCore(e, t, n, r) {
-    r ? this.helper.mergeTranslation(e, t, n, !0) : this.helper.loadPageTranslations(e, t, n);
+  loadRouteTranslationsCore(t, e, n, r) {
+    r ? this.helper.mergeTranslation(t, e, n, !0) : this.helper.loadPageTranslations(t, e, n);
   }
 }
 export {
-  $ as BaseI18n,
-  g as FormatService,
+  _ as BaseI18n,
+  f as FormatService,
   d as defaultPlural,
   m as interpolate,
   T as isNoPrefixStrategy,
-  N as isPrefixAndDefaultStrategy,
-  b as isPrefixExceptDefaultStrategy,
-  P as isPrefixStrategy,
+  w as isPrefixAndDefaultStrategy,
+  v as isPrefixExceptDefaultStrategy,
+  $ as isPrefixStrategy,
   p as useTranslationHelper,
-  v as withPrefixStrategy
+  x as withPrefixStrategy
 };

package/dist/translation.d.ts

@@ -1,7 +1,7 @@
 import { Translations } from '@i18n-micro/types';
 /**
  * Bare Metal: Simple translation storage without Ref, useState, devalue.
- * Map key: locale (general) or locale:routeName (page-specific).
+ * Map key: `${locale}:${routeName}` (page-specific).
  */
 export interface TranslationStorage {
     translations: Map<string, Translations>;
@@ -11,13 +11,11 @@ export declare function useTranslationHelper(storage?: TranslationStorage): {
     getCache(locale: string, routeName: string): Translations | undefined;
     setCache(_locale: string, _routeName: string, _cache: Map<string, unknown>): void;
     hasTranslation(locale: string, key: string): boolean;
-    hasGeneralTranslation(locale: string): boolean;
     hasPageTranslation(locale: string, routeName: string): boolean;
     getTranslation<T = unknown>(locale: string, routeName: string, key: string): T | null;
-    loadTranslations(locale: string, data: Translations): void;
-    setTranslations(locale: string, data: Translations): void;
+    loadTranslations(locale: string, data: Translations, routeName?: string): void;
+    setTranslations(locale: string, data: Translations, routeName?: string): void;
     loadPageTranslations(locale: string, routeName: string, data: Translations): void;
     mergeTranslation(locale: string, routeName: string, newTranslations: Translations, _force?: boolean): void;
-    mergeGlobalTranslation(locale: string, newTranslations: Translations, _force?: boolean): void;
     clearCache(): void;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/core",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "",
   "repository": "s00d/nuxt-i18n-micro",
   "license": "MIT",
@@ -22,7 +22,7 @@
   },
   "keywords": [],
   "dependencies": {
-    "@i18n-micro/types": "1.1.3"
+    "@i18n-micro/types": "1.1.5"
   },
   "devDependencies": {
     "vite": "^7.3.1",

package/src/base.ts

@@ -8,10 +8,7 @@ export interface BaseI18nOptions {
   plural?: PluralFunc
   missingWarn?: boolean
   missingHandler?: (locale: string, key: string, routeName: string) => void
-  // Optional hooks for Nuxt runtime specific features
-  getPreviousPageInfo?: () => { locale: string; routeName: string } | null
   getCustomMissingHandler?: () => MissingHandler | null
-  enablePreviousPageFallback?: boolean
 }
 
 /**
@@ -27,10 +24,7 @@ export abstract class BaseI18n {
   public pluralFunc: PluralFunc
   public missingWarn: boolean
   public missingHandler?: (locale: string, key: string, routeName: string) => void
-  // Optional hooks for Nuxt runtime specific features
-  public getPreviousPageInfo?: () => { locale: string; routeName: string } | null
   public getCustomMissingHandler?: () => MissingHandler | null
-  public enablePreviousPageFallback: boolean
 
   constructor(options: BaseI18nOptions = {}) {
     this.helper = useTranslationHelper(options.storage)
@@ -38,9 +32,7 @@ export abstract class BaseI18n {
     this.pluralFunc = options.plural || defaultPlural
     this.missingWarn = options.missingWarn ?? true
     this.missingHandler = options.missingHandler
-    this.getPreviousPageInfo = options.getPreviousPageInfo
     this.getCustomMissingHandler = options.getCustomMissingHandler
-    this.enablePreviousPageFallback = options.enablePreviousPageFallback ?? false
   }
 
   // --- Abstract methods (must be implemented by subclasses) ---
@@ -74,24 +66,9 @@ export abstract class BaseI18n {
     const route = routeName || this.getRoute()
 
     // 1. Try to find translation in current locale
-    // Note: In Nuxt runtime, server already merges global translations, so we don't need explicit fallback
     let value = this.helper.getTranslation<string>(locale, route, key)
 
-    // 2. If translation not found and there are saved previous translations, use them (only if enabled)
-    if (!value && this.enablePreviousPageFallback && this.getPreviousPageInfo) {
-      const prev = this.getPreviousPageInfo()
-      if (prev) {
-        const prevValue = this.helper.getTranslation<string>(prev.locale, prev.routeName, key)
-        if (prevValue) {
-          value = prevValue
-          if (process.env.NODE_ENV !== 'production') {
-            console.log(`Using fallback translation from previous route: ${prev.routeName} -> ${key}`)
-          }
-        }
-      }
-    }
-
-    // 3. Fallback to fallbackLocale if not found and different (for non-Nuxt adapters)
+    // 2. Fallback to fallbackLocale if not found and different
     if (!value) {
       const fallbackLocale = this.getFallbackLocale()
       if (locale !== fallbackLocale) {
@@ -99,7 +76,7 @@ export abstract class BaseI18n {
       }
     }
 
-    // 4. Handle missing
+    // 3. Handle missing
     if (!value) {
       // Call custom handler if set (Nuxt runtime), otherwise use instance handler
       const customHandler = this.getCustomMissingHandler?.()
@@ -117,7 +94,7 @@ export abstract class BaseI18n {
       value = defaultValue === undefined ? key : defaultValue || key
     }
 
-    // 5. Interpolate
+    // 4. Interpolate
     return typeof value === 'string' && params ? interpolate(value, params) : (value as CleanTranslation)
   }
 
@@ -195,11 +172,11 @@ export abstract class BaseI18n {
    * Core translation loading logic (without reactivity)
    * Subclasses can override addTranslations/addRouteTranslations to add reactivity
    */
-  public loadTranslationsCore(locale: string, translations: Translations, merge: boolean): void {
+  public loadTranslationsCore(locale: string, translations: Translations, merge: boolean, routeName = 'index'): void {
     if (merge) {
-      this.helper.mergeGlobalTranslation(locale, translations, true)
+      this.helper.mergeTranslation(locale, routeName, translations, true)
     } else {
-      this.helper.setTranslations(locale, translations)
+      this.helper.setTranslations(locale, translations, routeName)
     }
   }
 

package/src/translation.ts

@@ -2,7 +2,7 @@ import type { Translations } from '@i18n-micro/types'
 
 /**
  * Bare Metal: Simple translation storage without Ref, useState, devalue.
- * Map key: locale (general) or locale:routeName (page-specific).
+ * Map key: `${locale}:${routeName}` (page-specific).
  */
 export interface TranslationStorage {
   translations: Map<string, Translations>
@@ -36,52 +36,46 @@ export function useTranslationHelper(storage?: TranslationStorage) {
 
   return {
     hasCache(locale: string, page: string) {
-      const cacheKey = `${locale}:${page}`
-      return translations.has(cacheKey) || translations.has(locale)
+      const p = page || 'index'
+      return translations.has(`${locale}:${p}`)
     },
     getCache(locale: string, routeName: string) {
-      const cacheKey = `${locale}:${routeName}`
-      return translations.get(cacheKey)
+      const rn = routeName || 'index'
+      return translations.get(`${locale}:${rn}`)
     },
     setCache(_locale: string, _routeName: string, _cache: Map<string, unknown>) {
       // No-op for bare metal
     },
     hasTranslation(locale: string, key: string): boolean {
       for (const [k, v] of translations) {
-        if ((k === locale || k.startsWith(`${locale}:`)) && findValue(v, key) !== null) {
+        if (k.startsWith(`${locale}:`) && findValue(v, key) !== null) {
           return true
         }
       }
       return false
     },
-    hasGeneralTranslation(locale: string): boolean {
-      return translations.has(locale)
-    },
     hasPageTranslation(locale: string, routeName: string): boolean {
-      return translations.has(`${locale}:${routeName}`)
+      const rn = routeName || 'index'
+      return translations.has(`${locale}:${rn}`)
     },
     getTranslation<T = unknown>(locale: string, routeName: string, key: string): T | null {
-      const routeKey = `${locale}:${routeName}`
-      const routeData = translations.get(routeKey)
-      const val = findValue<T>(routeData, key)
-      if (val !== null) return val
-
-      const generalData = translations.get(locale)
-      return findValue<T>(generalData, key)
+      const rn = routeName || 'index'
+      return findValue<T>(translations.get(`${locale}:${rn}`), key)
     },
-    loadTranslations(locale: string, data: Translations): void {
-      // Merge with existing, replacing duplicate keys
-      const existing = translations.get(locale) ?? {}
-      translations.set(locale, { ...existing, ...data })
+    loadTranslations(locale: string, data: Translations, routeName = 'index'): void {
+      const rn = routeName || 'index'
+      const key = `${locale}:${rn}`
+      const existing = translations.get(key) ?? {}
+      translations.set(key, { ...existing, ...data })
     },
-    setTranslations(locale: string, data: Translations): void {
-      // Replace all translations for locale (no merge)
-      translations.set(locale, data)
+    setTranslations(locale: string, data: Translations, routeName = 'index'): void {
+      const rn = routeName || 'index'
+      translations.set(`${locale}:${rn}`, data)
     },
     loadPageTranslations(locale: string, routeName: string, data: Translations): void {
-      const key = `${locale}:${routeName}`
+      const rn = routeName || 'index'
+      const key = `${locale}:${rn}`
       const existing = translations.get(key)
-      // Perf: when existing is empty — keep reference, avoid O(n) copying of large objects
       if (!existing || Object.keys(existing).length === 0) {
         translations.set(key, data)
       } else {
@@ -89,14 +83,11 @@ export function useTranslationHelper(storage?: TranslationStorage) {
       }
     },
     mergeTranslation(locale: string, routeName: string, newTranslations: Translations, _force = false): void {
-      const key = `${locale}:${routeName}`
+      const rn = routeName || 'index'
+      const key = `${locale}:${rn}`
       const existing = translations.get(key) ?? {}
       translations.set(key, { ...existing, ...newTranslations })
     },
-    mergeGlobalTranslation(locale: string, newTranslations: Translations, _force = false): void {
-      const existing = translations.get(locale) ?? {}
-      translations.set(locale, { ...existing, ...newTranslations })
-    },
     clearCache(): void {
       translations.clear()
     },

package/tests/base.test.ts

@@ -38,44 +38,44 @@ class TestI18n extends BaseI18n {
 describe('BaseI18n', () => {
   describe('Constructor', () => {
     test('should initialize with default options', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.getLocale()).toBe('en')
       expect(i18n.getFallbackLocale()).toBe('en')
-      expect(i18n.getRoute()).toBe('general')
+      expect(i18n.getRoute()).toBe('index')
     })
 
     test('should initialize with custom storage', () => {
       const storage = { translations: new Map<string, Translations>() }
-      const i18n = new TestI18n('en', 'en', 'general', { storage })
+      const i18n = new TestI18n('en', 'en', 'index', { storage })
       expect(i18n).toBeDefined()
     })
 
     test('should initialize with custom plural function', () => {
       const customPlural: PluralFunc = () => 'custom'
-      const i18n = new TestI18n('en', 'en', 'general', { plural: customPlural })
+      const i18n = new TestI18n('en', 'en', 'index', { plural: customPlural })
       expect(i18n).toBeDefined()
     })
 
     test('should initialize with missingWarn option', () => {
-      const i18n = new TestI18n('en', 'en', 'general', { missingWarn: false })
+      const i18n = new TestI18n('en', 'en', 'index', { missingWarn: false })
       expect(i18n).toBeDefined()
     })
 
     test('should initialize with missingHandler', () => {
       const handler = jest.fn()
-      const i18n = new TestI18n('en', 'en', 'general', { missingHandler: handler })
+      const i18n = new TestI18n('en', 'en', 'index', { missingHandler: handler })
       expect(i18n).toBeDefined()
     })
   })
 
   describe('t() method', () => {
     test('should return empty string for empty key', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.t('')).toBe('')
     })
 
     test('should return translation for existing key', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { greeting: 'Hello' }
       i18n['helper'].loadTranslations('en', translations)
 
@@ -84,7 +84,7 @@ describe('BaseI18n', () => {
 
     test('should interpolate params in translation', async () => {
       const storage = { translations: new Map<string, Translations>() }
-      const i18n = new TestI18n('en', 'en', 'general', { storage })
+      const i18n = new TestI18n('en', 'en', 'index', { storage })
       const translations: Translations = { greeting: 'Hello, {name}!' }
       await i18n['helper'].loadTranslations('en', translations)
 
@@ -92,18 +92,18 @@ describe('BaseI18n', () => {
     })
 
     test('should use defaultValue when translation is missing', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.t('missing.key', undefined, 'Default value')).toBe('Default value')
     })
 
     test('should return key when translation is missing and no defaultValue', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.t('missing.key')).toBe('missing.key')
     })
 
     test('should fallback to fallbackLocale when translation is missing', async () => {
       const storage = { translations: new Map<string, Translations>() }
-      const i18n = new TestI18n('en', 'fr', 'general', { storage })
+      const i18n = new TestI18n('en', 'fr', 'index', { storage })
       const translations: Translations = { greeting: 'Bonjour' }
       await i18n['helper'].loadTranslations('fr', translations)
 
@@ -111,53 +111,36 @@ describe('BaseI18n', () => {
     })
 
     test('should use route-specific translation when routeName is provided', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const routeTranslations: Translations = { title: 'Route Title' }
       await i18n['helper'].loadPageTranslations('en', 'about', routeTranslations)
 
       expect(i18n.t('title', undefined, undefined, 'about')).toBe('Route Title')
     })
 
-    test('should use previousPageInfo fallback when enabled', async () => {
-      const storage = { translations: new Map<string, Translations>() }
-      const prevInfo = { locale: 'fr', routeName: 'previous' }
-      const i18n = new TestI18n('en', 'en', 'general', {
-        storage,
-        getPreviousPageInfo: () => prevInfo,
-        enablePreviousPageFallback: true,
-      })
-
-      const translations: Translations = { greeting: 'Bonjour' }
-      await i18n['helper'].loadPageTranslations('fr', 'previous', translations)
-
-      // Current locale is 'en', route is 'general', translation not found
-      // Should fallback to previous page info: locale 'fr', route 'previous'
-      expect(i18n.t('greeting')).toBe('Bonjour')
-    })
-
     test('should call missingHandler when translation is missing', () => {
       const handler = jest.fn()
-      const i18n = new TestI18n('en', 'en', 'general', { missingHandler: handler })
+      const i18n = new TestI18n('en', 'en', 'index', { missingHandler: handler })
 
       i18n.t('missing.key')
 
-      expect(handler).toHaveBeenCalledWith('en', 'missing.key', 'general')
+      expect(handler).toHaveBeenCalledWith('en', 'missing.key', 'index')
     })
 
     test('should call customMissingHandler when set (Nuxt runtime)', () => {
       const customHandler = jest.fn()
-      const i18n = new TestI18n('en', 'en', 'general', {
+      const i18n = new TestI18n('en', 'en', 'index', {
         getCustomMissingHandler: () => customHandler,
       })
 
       i18n.t('missing.key')
 
-      expect(customHandler).toHaveBeenCalledWith('en', 'missing.key', 'general')
+      expect(customHandler).toHaveBeenCalledWith('en', 'missing.key', 'index')
     })
 
     test('should not warn when missingWarn is false', () => {
       const consoleSpy = jest.spyOn(console, 'warn').mockImplementation()
-      const i18n = new TestI18n('en', 'en', 'general', { missingWarn: false })
+      const i18n = new TestI18n('en', 'en', 'index', { missingWarn: false })
 
       i18n.t('missing.key')
 
@@ -168,7 +151,7 @@ describe('BaseI18n', () => {
 
   describe('ts() method', () => {
     test('should return translation as string', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { greeting: 'Hello' }
       i18n['helper'].loadTranslations('en', translations)
 
@@ -176,17 +159,17 @@ describe('BaseI18n', () => {
     })
 
     test('should return defaultValue when translation is missing', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.ts('missing.key', undefined, 'Default')).toBe('Default')
     })
 
     test('should return key when translation is missing and no defaultValue', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.ts('missing.key')).toBe('missing.key')
     })
 
     test('should convert non-string values to string', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { count: 42 }
       i18n['helper'].loadTranslations('en', translations)
 
@@ -196,12 +179,12 @@ describe('BaseI18n', () => {
 
   describe('tc() method', () => {
     test('should return defaultValue when count is undefined', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.tc('apples', { other: 'params' }, 'No count')).toBe('No count')
     })
 
     test('should use plural function with count', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { apples: 'apple|apples' }
       await i18n['helper'].loadTranslations('en', translations)
 
@@ -213,7 +196,7 @@ describe('BaseI18n', () => {
     })
 
     test('should handle count as number', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { apples: 'apple|apples' }
       i18n['helper'].loadTranslations('en', translations)
 
@@ -221,7 +204,7 @@ describe('BaseI18n', () => {
     })
 
     test('should handle count as Params object', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { apples: 'apple|apples' }
       i18n['helper'].loadTranslations('en', translations)
 
@@ -229,7 +212,7 @@ describe('BaseI18n', () => {
     })
 
     test('should return defaultValue when plural function returns null', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       // When translation is missing, t() returns key, which is passed to pluralFunc
       // pluralFunc tries to process 'missing.key' as translation, but since it doesn't contain '|',
       // it returns the key itself. So tc returns the key, not defaultValue.
@@ -241,19 +224,19 @@ describe('BaseI18n', () => {
 
   describe('tn() method', () => {
     test('should format number with default locale', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const result = i18n.tn(1234.56)
       expect(result).toMatch(/1[,.]234[.,]56/)
     })
 
     test('should format number with custom options', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const result = i18n.tn(1234.56, { style: 'currency', currency: 'USD' })
       expect(result).toContain('1,234.56')
     })
 
     test('should use current locale for formatting', () => {
-      const i18n = new TestI18n('ru', 'en', 'general')
+      const i18n = new TestI18n('ru', 'en', 'index')
       const result = i18n.tn(1234.56)
       // Russian locale uses different number formatting
       expect(result).toBeDefined()
@@ -262,7 +245,7 @@ describe('BaseI18n', () => {
 
   describe('td() method', () => {
     test('should format date with default locale', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const date = new Date('2024-01-15')
       const result = i18n.td(date)
       expect(result).toBeDefined()
@@ -270,7 +253,7 @@ describe('BaseI18n', () => {
     })
 
     test('should format date with custom options', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const date = new Date('2024-01-15')
       const result = i18n.td(date, { year: 'numeric', month: 'long', day: 'numeric' })
       expect(result).toContain('2024')
@@ -278,7 +261,7 @@ describe('BaseI18n', () => {
     })
 
     test('should handle date as number (timestamp)', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const timestamp = new Date('2024-01-15').getTime()
       const result = i18n.td(timestamp)
       expect(result).toBeDefined()
@@ -286,7 +269,7 @@ describe('BaseI18n', () => {
     })
 
     test('should handle date as string', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const result = i18n.td('2024-01-15')
       expect(result).toBeDefined()
       expect(result).not.toBe('Invalid Date')
@@ -295,7 +278,7 @@ describe('BaseI18n', () => {
 
   describe('tdr() method', () => {
     test('should format relative time', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const yesterday = new Date(Date.now() - 86400000)
       const result = i18n.tdr(yesterday)
       expect(result).toBeDefined()
@@ -303,14 +286,14 @@ describe('BaseI18n', () => {
     })
 
     test('should format relative time with custom options', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const yesterday = new Date(Date.now() - 86400000)
       const result = i18n.tdr(yesterday, { numeric: 'always' })
       expect(result).toBeDefined()
     })
 
     test('should handle invalid date gracefully', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const invalidDate = new Date('invalid')
       const result = i18n.tdr(invalidDate)
       expect(result).toBeDefined()
@@ -319,7 +302,7 @@ describe('BaseI18n', () => {
 
   describe('has() method', () => {
     test('should return true when translation exists', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { greeting: 'Hello' }
       i18n['helper'].loadTranslations('en', translations)
 
@@ -327,17 +310,17 @@ describe('BaseI18n', () => {
     })
 
     test('should return false when translation does not exist', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.has('missing.key')).toBe(false)
     })
 
     test('should check route-specific translation when routeName is provided', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const routeTranslations: Translations = { title: 'Route Title' }
       await i18n['helper'].loadPageTranslations('en', 'about', routeTranslations)
 
       expect(i18n.has('title', 'about')).toBe(true)
-      expect(i18n.has('title', 'general')).toBe(false)
+      expect(i18n.has('title', 'index')).toBe(false)
     })
 
     test('should use current route when routeName is not provided', async () => {
@@ -351,7 +334,7 @@ describe('BaseI18n', () => {
 
   describe('clearCache() method', () => {
     test('should clear all translations from cache', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { greeting: 'Hello' }
       i18n['helper'].loadTranslations('en', translations)
 
@@ -365,7 +348,7 @@ describe('BaseI18n', () => {
 
   describe('loadTranslationsCore() method', () => {
     test('should load translations when merge is false', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { greeting: 'Hello' }
 
       i18n['loadTranslationsCore']('en', translations, false)
@@ -376,7 +359,7 @@ describe('BaseI18n', () => {
     })
 
     test('should merge translations when merge is true', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const initial: Translations = { greeting: 'Hello' }
       const additional: Translations = { farewell: 'Goodbye' }
 
@@ -392,7 +375,7 @@ describe('BaseI18n', () => {
 
   describe('loadRouteTranslationsCore() method', () => {
     test('should load route translations when merge is false', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = { title: 'Page Title' }
 
       i18n['loadRouteTranslationsCore']('en', 'about', translations, false)
@@ -403,7 +386,7 @@ describe('BaseI18n', () => {
     })
 
     test('should merge route translations when merge is true', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const initial: Translations = { title: 'Page Title' }
       const additional: Translations = { description: 'Page Description' }
 
@@ -419,7 +402,7 @@ describe('BaseI18n', () => {
 
   describe('Edge cases', () => {
     test('should handle nested translation keys', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = {
         nested: {
           deep: {
@@ -433,7 +416,7 @@ describe('BaseI18n', () => {
     })
 
     test('should handle multiple params in interpolation', async () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       const translations: Translations = {
         message: 'Hello, {name}! You are {age} years old.',
       }
@@ -443,23 +426,25 @@ describe('BaseI18n', () => {
     })
 
     test('should handle null defaultValue', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       expect(i18n.t('missing.key', undefined, null)).toBe('missing.key')
     })
 
     test('should handle empty string defaultValue', () => {
-      const i18n = new TestI18n('en', 'en', 'general')
+      const i18n = new TestI18n('en', 'en', 'index')
       // Empty string is falsy, so it will fall back to key (as per defaultValue || key logic)
       expect(i18n.t('missing.key', undefined, '')).toBe('missing.key')
     })
 
     test('should handle route change', async () => {
       const storage = { translations: new Map<string, Translations>() }
-      const i18n = new TestI18n('en', 'en', 'general', { storage })
-      const generalTranslations: Translations = { greeting: 'Hello' }
-      const routeTranslations: Translations = { title: 'About Page' }
+      const i18n = new TestI18n('en', 'en', 'index', { storage })
+      const rootTranslations: Translations = { greeting: 'Hello' }
+      // Packages (vue, node, etc.) merge root into pages automatically.
+      // Core does not — so we simulate pre-merged data here.
+      const routeTranslations: Translations = { greeting: 'Hello', title: 'About Page' }
 
-      await i18n['helper'].loadTranslations('en', generalTranslations)
+      await i18n['helper'].loadTranslations('en', rootTranslations)
       await i18n['helper'].loadPageTranslations('en', 'about', routeTranslations)
 
       // Verify translations are loaded
@@ -467,14 +452,13 @@ describe('BaseI18n', () => {
       expect(i18n.has('title', 'about')).toBe(true)
 
       // Check route-specific translation with explicit routeName
-      // Note: getTranslation uses routeName parameter, so this should work
       const titleValue = i18n.t('title', undefined, undefined, 'about')
       expect(titleValue).toBe('About Page')
 
       // Change route and check
       i18n.setRoute('about')
       expect(i18n.t('title')).toBe('About Page')
-      expect(i18n.t('greeting')).toBe('Hello') // Should still work from general
+      expect(i18n.t('greeting')).toBe('Hello')
     })
   })
 })

package/tests/core.test.ts

@@ -63,12 +63,12 @@ describe('Translation Helper', () => {
     expect(helper.getTranslation('en', 'home', 'newKey')).toBe('New value')
   })
 
-  test('mergeGlobalTranslation updates general translations', () => {
+  test('mergeTranslation with index routeName updates index translations', () => {
     const helper = useTranslationHelper()
     helper.loadTranslations('en', translations.en)
 
-    helper.mergeGlobalTranslation('en', { newGlobalKey: 'Global value' })
-    expect(helper.getTranslation('en', 'index', 'newGlobalKey')).toBe('Global value')
+    helper.mergeTranslation('en', 'index', { newKey: 'New value' })
+    expect(helper.getTranslation('en', 'index', 'newKey')).toBe('New value')
   })
 
   test('deepClone creates a deep copy of objects', () => {