@i18n-micro/core 1.1.4 → 1.3.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

@@ -72,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(t,e,r){return new Intl.NumberFormat(e,r).format(t)}formatDate(t,e,r){const n=new Date(t);return Number.isNaN(n.getTime())?"Invalid Date":new Intl.DateTimeFormat(e,r).format(n)}formatRelativeTime(t,e,r){const n=new Date(t);if(Number.isNaN(n.getTime()))return new Intl.RelativeTimeFormat(e,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:c}of o){const u=Math.floor(i/c);if(u>=1)return new Intl.RelativeTimeFormat(e,r).format(-u,l)}return new Intl.RelativeTimeFormat(e,r).format(0,"second")}}const p=/\{(\w+)\}/g;function h(s,t){return t?s.replace(p,(e,r)=>{const n=t[r];return n!==void 0?String(n):`{${r}}`}):s}function T(s){return s==="prefix"||s==="prefix_and_default"}function v(s){return s==="no_prefix"}function x(s){return s==="prefix"}function S(s){return s==="prefix_except_default"}function w(s){return s==="prefix_and_default"}const m=(s,t,e,r,n)=>{const a=n(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 f(s,t){if(!s||typeof t!="string")return null;if(t in s){const n=s[t];return n}const e=t.split(".");let r=s;for(const n of e)if(r&&typeof r=="object"&&n in r)r=r[n];else return null;return r??null}function d(s){const t=s?.translations??new Map;return{hasCache(e,r){const n=`${e}:${r}`;return t.has(n)||t.has(e)},getCache(e,r){const n=`${e}:${r}`;return t.get(n)},setCache(e,r,n){},hasTranslation(e,r){for(const[n,a]of t)if((n===e||n.startsWith(`${e}:`))&&f(a,r)!==null)return!0;return!1},hasGeneralTranslation(e){return t.has(e)},hasPageTranslation(e,r){return t.has(`${e}:${r}`)},getTranslation(e,r,n){const a=`${e}:${r}`,i=t.get(a),o=f(i,n);if(o!==null)return o;const l=t.get(e);return f(l,n)},loadTranslations(e,r){const n=t.get(e)??{};t.set(e,{...n,...r})},setTranslations(e,r){t.set(e,r)},loadPageTranslations(e,r,n){const a=`${e}:${r}`,i=t.get(a);!i||Object.keys(i).length===0?t.set(a,n):t.set(a,{...i,...n})},mergeTranslation(e,r,n,a=!1){const i=`${e}:${r}`,o=t.get(i)??{};t.set(i,{...o,...n})},mergeGlobalTranslation(e,r,n=!1){const a=t.get(e)??{};t.set(e,{...a,...r})},clearCache(){t.clear()}}}class ${constructor(t={}){this.formatter=new g,this.helper=d(t.storage),this.formatter=new g,this.pluralFunc=t.plural||m,this.missingWarn=t.missingWarn??!0,this.missingHandler=t.missingHandler,this.getCustomMissingHandler=t.getCustomMissingHandler}t(t,e,r,n){if(!t)return"";const a=this.getLocale(),i=n||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=r===void 0?t:r||t}return typeof o=="string"&&e?h(o,e):o}ts(t,e,r,n){return this.t(t,e,r,n)?.toString()??r??t}tc(t,e,r){const{count:n,...a}=typeof e=="number"?{count:e}:e;if(n===void 0)return r??t;const i=(l,c,u)=>this.t(l,c,u);return this.pluralFunc(t,Number.parseInt(n.toString(),10),a,this.getLocale(),i)??r??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 r=e||this.getRoute(),n=this.getLocale();return!!this.helper.getTranslation(n,r,t)}clearCache(){this.helper.clearCache()}loadTranslationsCore(t,e,r){r?this.helper.mergeGlobalTranslation(t,e,!0):this.helper.setTranslations(t,e)}loadRouteTranslationsCore(t,e,r,n){n?this.helper.mergeTranslation(t,e,r,!0):this.helper.loadPageTranslations(t,e,r)}}exports.BaseI18n=$;exports.FormatService=g;exports.defaultPlural=m;exports.interpolate=h;exports.isNoPrefixStrategy=v;exports.isPrefixAndDefaultStrategy=w;exports.isPrefixExceptDefaultStrategy=S;exports.isPrefixStrategy=x;exports.useTranslationHelper=d;exports.withPrefixStrategy=T;
+"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,4 +1,4 @@
-class h {
+class f {
   formatNumber(t, e, n) {
     return new Intl.NumberFormat(e, n).format(t);
   }
@@ -18,10 +18,10 @@ class h {
       { 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);
+    for (const { unit: l, seconds: u } of o) {
+      const c = Math.floor(i / u);
+      if (c >= 1)
+        return new Intl.RelativeTimeFormat(e, n).format(-c, l);
     }
     return new Intl.RelativeTimeFormat(e, n).format(0, "second");
   }
@@ -33,19 +33,19 @@ function m(s, t) {
     return r !== void 0 ? String(r) : `{${n}}`;
   }) : s;
 }
-function T(s) {
+function x(s) {
   return s === "prefix" || s === "prefix_and_default";
 }
-function v(s) {
+function T(s) {
   return s === "no_prefix";
 }
-function w(s) {
+function $(s) {
   return s === "prefix";
 }
-function x(s) {
+function v(s) {
   return s === "prefix_except_default";
 }
-function $(s) {
+function w(s) {
   return s === "prefix_and_default";
 }
 const d = (s, t, e, n, r) => {
@@ -57,7 +57,7 @@ const d = (s, t, e, n, r) => {
   const o = t < i.length ? i[t] : i[i.length - 1];
   return o ? o.trim().replace("{count}", t.toString()) : null;
 };
-function f(s, t) {
+function h(s, t) {
   if (!s || typeof t != "string") return null;
   if (t in s) {
     const r = s[t];
@@ -76,51 +76,44 @@ function p(s) {
   const t = s?.translations ?? /* @__PURE__ */ new Map();
   return {
     hasCache(e, n) {
-      const r = `${e}:${n}`;
-      return t.has(r) || t.has(e);
+      const r = n || "index";
+      return t.has(`${e}:${r}`);
     },
     getCache(e, n) {
-      const r = `${e}:${n}`;
-      return t.get(r);
+      const r = n || "index";
+      return t.get(`${e}:${r}`);
     },
     setCache(e, n, r) {
     },
     hasTranslation(e, n) {
       for (const [r, a] of t)
-        if ((r === e || r.startsWith(`${e}:`)) && f(a, n) !== null)
+        if (r.startsWith(`${e}:`) && h(a, n) !== null)
           return !0;
       return !1;
     },
-    hasGeneralTranslation(e) {
-      return t.has(e);
-    },
     hasPageTranslation(e, n) {
-      return t.has(`${e}:${n}`);
+      const r = n || "index";
+      return t.has(`${e}:${r}`);
     },
     getTranslation(e, n, r) {
-      const a = `${e}:${n}`, i = t.get(a), o = f(i, r);
-      if (o !== null) return o;
-      const l = t.get(e);
-      return f(l, r);
+      const a = n || "index";
+      return h(t.get(`${e}:${a}`), r);
     },
-    loadTranslations(e, n) {
-      const r = t.get(e) ?? {};
-      t.set(e, { ...r, ...n });
+    loadTranslations(e, n, r = "index") {
+      const i = `${e}:${r || "index"}`, o = t.get(i) ?? {};
+      t.set(i, { ...o, ...n });
     },
-    setTranslations(e, n) {
-      t.set(e, n);
+    setTranslations(e, n, r = "index") {
+      const a = r || "index";
+      t.set(`${e}:${a}`, n);
     },
     loadPageTranslations(e, n, r) {
-      const a = `${e}:${n}`, i = t.get(a);
-      !i || Object.keys(i).length === 0 ? t.set(a, r) : t.set(a, { ...i, ...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 i = `${e}:${n}`, o = t.get(i) ?? {};
-      t.set(i, { ...o, ...r });
-    },
-    mergeGlobalTranslation(e, n, r = !1) {
-      const a = t.get(e) ?? {};
-      t.set(e, { ...a, ...n });
+      const o = `${e}:${n || "index"}`, l = t.get(o) ?? {};
+      t.set(o, { ...l, ...r });
     },
     clearCache() {
       t.clear();
@@ -129,7 +122,7 @@ function p(s) {
 }
 class _ {
   constructor(t = {}) {
-    this.formatter = new h(), this.helper = p(t.storage), this.formatter = new h(), this.pluralFunc = t.plural || d, this.missingWarn = t.missingWarn ?? !0, this.missingHandler = t.missingHandler, this.getCustomMissingHandler = t.getCustomMissingHandler;
+    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) ---
   /**
@@ -163,7 +156,7 @@ class _ {
     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);
+    const i = (l, u, c) => this.t(l, u, c);
     return this.pluralFunc(t, Number.parseInt(r.toString(), 10), a, this.getLocale(), i) ?? n ?? t;
   }
   /**
@@ -203,8 +196,8 @@ class _ {
    * Core translation loading logic (without reactivity)
    * Subclasses can override addTranslations/addRouteTranslations to add reactivity
    */
-  loadTranslationsCore(t, e, n) {
-    n ? this.helper.mergeGlobalTranslation(t, e, !0) : this.helper.setTranslations(t, e);
+  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)
@@ -216,13 +209,13 @@ class _ {
 }
 export {
   _ as BaseI18n,
-  h as FormatService,
+  f as FormatService,
   d as defaultPlural,
   m as interpolate,
-  v as isNoPrefixStrategy,
-  $ as isPrefixAndDefaultStrategy,
-  x as isPrefixExceptDefaultStrategy,
-  w as isPrefixStrategy,
+  T as isNoPrefixStrategy,
+  w as isPrefixAndDefaultStrategy,
+  v as isPrefixExceptDefaultStrategy,
+  $ as isPrefixStrategy,
   p as useTranslationHelper,
-  T 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.4",
+  "version": "1.3.0",
   "description": "",
   "repository": "s00d/nuxt-i18n-micro",
   "license": "MIT",
@@ -22,7 +22,7 @@
   },
   "keywords": [],
   "dependencies": {
-    "@i18n-micro/types": "1.1.4"
+    "@i18n-micro/types": "1.2.0"
   },
   "devDependencies": {
     "vite": "^7.3.1",

package/src/base.ts

@@ -66,10 +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. 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) {
@@ -173,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,7 +111,7 @@ 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)
 
@@ -120,27 +120,27 @@ describe('BaseI18n', () => {
 
     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')
 
@@ -151,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)
 
@@ -159,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)
 
@@ -179,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)
 
@@ -196,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)
 
@@ -204,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)
 
@@ -212,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.
@@ -224,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()
@@ -245,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()
@@ -253,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')
@@ -261,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()
@@ -269,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')
@@ -278,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()
@@ -286,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()
@@ -302,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)
 
@@ -310,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 () => {
@@ -334,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)
 
@@ -348,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)
@@ -359,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' }
 
@@ -375,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)
@@ -386,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' }
 
@@ -402,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: {
@@ -416,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.',
       }
@@ -426,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
@@ -450,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', () => {