@i18n-micro/astro 1.2.1 → 1.3.0

package/dist/client/core.d.ts

@@ -1,6 +1,6 @@
 import { Params, Translations } from '@i18n-micro/types';
 /**
- * Состояние i18n для клиентских островов
+ * I18n state for client islands
  */
 export interface I18nState {
     locale: string;
@@ -9,7 +9,7 @@ export interface I18nState {
     currentRoute: string;
 }
 /**
- * Чистая функция для получения перевода из состояния
+ * Pure function to get a translation from state
  *
  * Note: This is a simplified version optimized for client-side islands.
  * It supports basic translation lookup, interpolation, and fallback to general translations.
@@ -18,6 +18,6 @@ export interface I18nState {
  */
 export declare function translate(state: I18nState, key: string, params?: Params, defaultValue?: string | null, routeName?: string): string | number | boolean | Translations | null;
 /**
- * Проверяет наличие перевода в состоянии
+ * Checks if a translation exists in the state
  */
 export declare function hasTranslation(state: I18nState, key: string, routeName?: string): boolean;

package/dist/client/svelte.d.ts

@@ -3,12 +3,12 @@ import { Writable } from 'svelte/store';
 import { I18nClientProps } from '../utils';
 import { I18nState } from './core';
 /**
- * Создает Svelte store для i18n состояния
+ * Creates a Svelte store for i18n state
  */
 export declare function createI18nStore(props: I18nClientProps): Writable<I18nState>;
 /**
- * Хук для использования i18n в Svelte компонентах
- * Используйте в <script> блоке компонента
+ * Hook for using i18n in Svelte components
+ * Use in the component's <script> block
  */
 export declare function useAstroI18n(store: Writable<I18nState>): {
     store: Writable<I18nState>;

package/dist/client/svelte.js

@@ -13,7 +13,7 @@ function F(o) {
 function P(o) {
   const n = () => v(o), c = (t, e, r, a) => S(n(), t, e, r, a);
   return {
-    // Store для реактивности в шаблонах (используйте $i18nStore в шаблонах)
+    // Store for reactivity in templates (use $i18nStore in templates)
     store: o,
     // Translation methods
     t: c,
@@ -38,7 +38,7 @@ function P(o) {
       return l.formatRelativeTime(t, r.locale, e);
     },
     has: (t, e) => L(n(), t, e),
-    // Геттеры для текущего состояния (для использования в скриптах)
+    // Getters for current state (for use in scripts)
     get locale() {
       return n().locale;
     },

package/dist/client/vue.d.ts

@@ -3,12 +3,12 @@ import { Ref } from 'vue';
 import { I18nClientProps } from '../utils';
 import { I18nState } from './core';
 /**
- * Инициализирует i18n провайдер для Vue острова
- * Вызывайте в корневом компоненте острова
+ * Initializes the i18n provider for a Vue island
+ * Call in the island's root component
  */
 export declare function provideI18n(props: I18nClientProps): Ref<I18nState>;
 /**
- * Хук для использования i18n в Vue компонентах
+ * Hook for using i18n in Vue components
  */
 export declare function useAstroI18n(): {
     t: (key: TranslationKey, params?: Params, defaultValue?: string | null, routeName?: string) => CleanTranslation;

package/dist/composer.d.ts

@@ -30,6 +30,5 @@ export declare class AstroI18n extends BaseI18n {
     addTranslations(locale: string, translations: Translations, merge?: boolean): void;
     addRouteTranslations(locale: string, routeName: string, translations: Translations, merge?: boolean): void;
     mergeTranslations(locale: string, routeName: string, translations: Translations): void;
-    mergeGlobalTranslations(locale: string, translations: Translations): void;
     clearCache(): void;
 }

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("@i18n-micro/core"),b=require("node:fs"),I=require("node:path");class j extends T.BaseI18n{constructor(e){const s=e._storage||{translations:new Map};if(super({storage:s,plural:e.plural,missingWarn:e.missingWarn,missingHandler:e.missingHandler}),this.initialMessages={},this.storage=s,this._locale=e.locale,this._fallbackLocale=e.fallbackLocale||e.locale,this._currentRoute="general",e.messages){this.initialMessages={...e.messages};for(const[a,i]of Object.entries(e.messages))this.helper.loadTranslations(a,i)}}cloneStorage(e){const s=new Map;for(const[a,i]of e.translations)s.set(a,{...i});return{translations:s}}clone(e){const s=this.cloneStorage(this.storage);return new j({locale:e||this._locale,fallbackLocale:this._fallbackLocale,plural:this.pluralFunc,missingWarn:this.missingWarn,missingHandler:this.missingHandler,_storage:s})}get locale(){return this._locale}set locale(e){this._locale=e}get fallbackLocale(){return this._fallbackLocale}set fallbackLocale(e){this._fallbackLocale=e}setRoute(e){this._currentRoute=e}getLocale(){return this._locale}getFallbackLocale(){return this._fallbackLocale}getRoute(){return this._currentRoute}getRouteTranslations(e,s){const a=`${e}:${s}`;return this.storage.translations.get(a)??null}addTranslations(e,s,a=!0){super.loadTranslationsCore(e,s,a)}addRouteTranslations(e,s,a,i=!0){super.loadRouteTranslationsCore(e,s,a,i)}mergeTranslations(e,s,a){this.helper.mergeTranslation(e,s,a,!0)}mergeGlobalTranslations(e,s){this.helper.mergeGlobalTranslation(e,s,!0)}clearCache(){const e={...this.initialMessages};if(super.clearCache(),Object.keys(e).length>0)for(const[s,a]of Object.entries(e))this.helper.loadTranslations(s,a)}}let $=null;function D(){return $}function C(n){const{locale:e,fallbackLocale:s,translationDir:a,routingStrategy:i}=n;return $=i||null,{name:"@i18n-micro/astro",hooks:{"astro:config:setup":c=>{const{updateConfig:f}=c,t="virtual:i18n-micro/config",l=`\0${t}`,r={defaultLocale:e,fallbackLocale:s||e,locales:n.locales||[],localeCodes:(n.locales||[]).map(o=>o.code),translationDir:a||null,autoDetect:n.autoDetect??!0,redirectToDefault:n.redirectToDefault??!1,localeCookie:n.localeCookie===null?null:n.localeCookie||"i18n-locale",missingWarn:n.missingWarn??!1};f({vite:{plugins:[{name:"vite-plugin-i18n-micro-config",resolveId(o){if(o===t)return l},load(o){if(o===l)return`export const config = ${JSON.stringify(r)}`}}]}})},"astro:config:done":c=>{const{injectTypes:f}=c;f({filename:"i18n-micro-env.d.ts",content:`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const j=require("@i18n-micro/core"),b=require("node:fs"),I=require("node:path");class w extends j.BaseI18n{constructor(e){const s=e._storage||{translations:new Map};if(super({storage:s,plural:e.plural,missingWarn:e.missingWarn,missingHandler:e.missingHandler}),this.initialMessages={},this.storage=s,this._locale=e.locale,this._fallbackLocale=e.fallbackLocale||e.locale,this._currentRoute="index",e.messages){this.initialMessages={...e.messages};for(const[o,i]of Object.entries(e.messages))this.helper.loadTranslations(o,i)}}cloneStorage(e){const s=new Map;for(const[o,i]of e.translations)s.set(o,{...i});return{translations:s}}clone(e){const s=this.cloneStorage(this.storage);return new w({locale:e||this._locale,fallbackLocale:this._fallbackLocale,plural:this.pluralFunc,missingWarn:this.missingWarn,missingHandler:this.missingHandler,_storage:s})}get locale(){return this._locale}set locale(e){this._locale=e}get fallbackLocale(){return this._fallbackLocale}set fallbackLocale(e){this._fallbackLocale=e}setRoute(e){this._currentRoute=e}getLocale(){return this._locale}getFallbackLocale(){return this._fallbackLocale}getRoute(){return this._currentRoute}getRouteTranslations(e,s){const o=`${e}:${s}`;return this.storage.translations.get(o)??null}addTranslations(e,s,o=!0){super.loadTranslationsCore(e,s,o)}addRouteTranslations(e,s,o,i=!0){super.loadRouteTranslationsCore(e,s,o,i)}mergeTranslations(e,s,o){this.helper.mergeTranslation(e,s,o,!0)}clearCache(){const e={...this.initialMessages};if(super.clearCache(),Object.keys(e).length>0)for(const[s,o]of Object.entries(e))this.helper.loadTranslations(s,o)}}let $=null;function D(){return $}function C(n){const{locale:e,fallbackLocale:s,translationDir:o,routingStrategy:i}=n;return $=i||null,{name:"@i18n-micro/astro",hooks:{"astro:config:setup":c=>{const{updateConfig:f}=c,t="virtual:i18n-micro/config",l=`\0${t}`,r={defaultLocale:e,fallbackLocale:s||e,locales:n.locales||[],localeCodes:(n.locales||[]).map(a=>a.code),translationDir:o||null,autoDetect:n.autoDetect??!0,redirectToDefault:n.redirectToDefault??!1,localeCookie:n.localeCookie===null?null:n.localeCookie||"i18n-locale",missingWarn:n.missingWarn??!1};f({vite:{plugins:[{name:"vite-plugin-i18n-micro-config",resolveId(a){if(a===t)return l},load(a){if(a===l)return`export const config = ${JSON.stringify(r)}`}}]}})},"astro:config:done":c=>{const{injectTypes:f}=c;f({filename:"i18n-micro-env.d.ts",content:`
             /// <reference types="@i18n-micro/astro/env" />
 
             declare module 'virtual:i18n-micro/config' {
@@ -14,4 +14,4 @@
                 missingWarn: boolean | null;
               }
             }
-          `})}}}}function N(n){return new j(n)}function F(n){const{translationDir:e,rootDir:s=process.cwd(),disablePageLocales:a=!1}=n,i=I.resolve(s,e);if(!b.existsSync(i))return console.warn(`[i18n] Translation directory not found: ${i}`),{general:{},routes:{}};const c={},f={},t=(l,r="")=>{if(!b.existsSync(l))return;const o=b.readdirSync(l);for(const u of o){const h=I.join(l,u);if(b.statSync(h).isDirectory())u==="pages"&&!a?t(h,""):r||a?t(h,r):t(h,u);else if(u.endsWith(".json")){const m=u.replace(".json","");try{const g=b.readFileSync(h,"utf-8"),p=JSON.parse(g);r&&!a?(f[r]||(f[r]={}),f[r][m]=p):c[m]=p}catch(g){console.error(`[i18n] Failed to load translation file: ${h}`,g)}}}};return t(i),{general:c,routes:f}}function q(n,e){const{general:s,routes:a}=F(e);for(const[i,c]of Object.entries(s))n.addTranslations(i,c,!1);for(const[i,c]of Object.entries(a))for(const[f,t]of Object.entries(c))n.addRouteTranslations(f,i,t,!1)}function M(n){const{i18n:e,defaultLocale:s,locales:a,localeObjects:i,autoDetect:c=!0,redirectToDefault:f=!1,routingStrategy:t}=n,l=t||D();return async(r,o)=>{if(r.locals.locale&&r.locals.i18n)return o();const u=r.url,h=u.pathname;if(!l){const S=e.clone(s),O=h==="/"||h===""?"index":h.split("/").filter(Boolean).join("-");return S.setRoute(O),r.locals.i18n=S,r.locals.locale=s,r.locals.defaultLocale=s,r.locals.locales=i||a.map(_=>({code:_})),r.locals.currentUrl=u,o()}const d={...l,getCurrentPath:()=>h,getRoute:()=>({fullPath:u.pathname+u.search,query:Object.fromEntries(u.searchParams)})},g=h.split("/").filter(Boolean)[0],p=g!==void 0&&a.includes(g);let P;p&&g?P=g:d.getLocaleFromPath?P=d.getLocaleFromPath(h,s,a):P=s;const L=e.clone(P),y=d.getRouteName?d.getRouteName(h,a):"general";return L.setRoute(y),r.locals.i18n=L,r.locals.locale=P,r.locals.defaultLocale=s,r.locals.locales=i||a.map(S=>({code:S})),r.locals.currentUrl=u,r.locals.routingStrategy=d,o()}}function A(n){const e=[],s=n.split(",");for(const a of s){const[i,c="1.0"]=a.trim().split(";q=");if(Number.parseFloat(c)>0&&i){const t=i.split("-")[0]?.toLowerCase();t&&(e.push(t),i!==t&&e.push(i.toLowerCase()))}}return e}function W(n,e,s,a,i,c="i18n-locale"){const f=D();let t=a;if(f?.getLocaleFromPath)t=f.getLocaleFromPath(n,a,i);else{const r=n.split("/").filter(Boolean)[0];r&&i.includes(r)&&(t=r)}if(c!==null&&t===a&&e.get(c)){const l=e.get(c)?.value;l&&i.includes(l)&&(t=l)}if(t===a)try{const l=s.get("accept-language");if(l){const r=A(l);for(const o of r)if(i.includes(o)){t=o;break}}}catch{}return t}function z(n,e,s){const a=n.map(o=>o.code),i=(o,u=[])=>{const h=o.replace(/^\//,"").replace(/\/$/,"");if(!h)return"index";const d=h.split("/").filter(Boolean),m=d[0];return m&&u.includes(m)&&d.shift(),d.length===0?"index":d.join("-")},c=(o,u="en",h=[])=>{const m=o.split("/").filter(Boolean)[0];return m&&h.includes(m)?m:u},f=(o,u,h=[],d)=>{const m=o.split("/").filter(Boolean),g=m[0];return g&&h.includes(g)&&m.shift(),(u!==d||d===void 0)&&m.unshift(u),`/${m.join("/")}`},t=(o,u,h=[],d)=>{const g=(o.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),p=g[0];return p&&h.includes(p)&&g.shift(),(u!==d||d===void 0)&&g.unshift(u),`/${g.join("/")}`};return{getCurrentPath:()=>s?s().pathname:typeof window<"u"?window.location.pathname:"/",getRouteName:i,getLocaleFromPath:c,switchLocalePath:f,localizePath:t,removeLocaleFromPath:(o,u=[])=>{const h=o.split("/").filter(Boolean),d=h[0];return d&&u.includes(d)&&h.shift(),`/${h.join("/")}`},resolvePath:(o,u)=>{const h=typeof o=="string"?o:o.path||"/";return t(h,u,a,e)},getRoute:()=>{if(s){const o=s();return{fullPath:o.pathname+o.search,query:Object.fromEntries(o.searchParams)}}if(typeof window<"u"){const o=new URL(window.location.href);return{fullPath:o.pathname+o.search,query:Object.fromEntries(o.searchParams)}}return{fullPath:"/",query:{}}},push:o=>{typeof window<"u"&&(window.location.href=o.path)},replace:o=>{typeof window<"u"&&window.location.replace(o.path)}}}function H(n,e=[]){const s=n.replace(/^\//,"").replace(/\/$/,"");if(!s)return"index";const a=s.split("/").filter(Boolean),i=a[0];return i&&e.includes(i)&&a.shift(),a.length===0?"index":a.join("-")}function G(n,e="en",s=[]){const i=n.split("/").filter(Boolean)[0];return i&&s.includes(i)?i:e}function U(n,e,s=[],a){const i=n.split("/").filter(Boolean),c=i[0];return c&&s.includes(c)&&i.shift(),(e!==a||a===void 0)&&i.unshift(e),`/${i.join("/")}`}function E(n,e,s=[],a){const c=(n.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),f=c[0];return f&&s.includes(f)&&c.shift(),(e!==a||a===void 0)&&c.unshift(e),`/${c.join("/")}`}function J(n,e=[]){const s=n.split("/").filter(Boolean),a=s[0];return a&&e.includes(a)&&s.shift(),`/${s.join("/")}`}function v(n){const e=n.locals.i18n;if(!e)throw new Error("i18n instance not found. Make sure i18n middleware is configured.");return e}function w(n){return n.locals.locale||"en"}function R(n){return n.locals.defaultLocale||"en"}function k(n){return n.locals.locales||[]}function B(n){return n.locals.routingStrategy||null}function V(n){const e=v(n),s=w(n),a=R(n),i=k(n),c=i.map(t=>t.code),f=B(n);return{locale:s,defaultLocale:a,locales:i,t:(t,l,r,o)=>e.t(t,l,r,o),ts:(t,l,r,o)=>e.ts(t,l,r,o),tc:(t,l,r)=>e.tc(t,l,r),tn:(t,l)=>e.tn(t,l),td:(t,l)=>e.td(t,l),tdr:(t,l)=>e.tdr(t,l),has:(t,l)=>e.has(t,l),getRoute:()=>e.getRoute(),getRouteName:t=>{const l=t||n.url.pathname;if(f?.getRouteName)return f.getRouteName(l,c);const r=l.replace(/^\//,"").replace(/\/$/,"");if(!r)return"index";const o=r.split("/").filter(Boolean),u=o[0];return u&&c.includes(u)&&o.shift(),o.length===0?"index":o.join("-")},getLocaleFromPath:t=>{const l=t||n.url.pathname;if(f?.getLocaleFromPath)return f.getLocaleFromPath(l,a,c);const o=l.split("/").filter(Boolean)[0];return o&&c.includes(o)?o:a},switchLocalePath:t=>{if(f?.switchLocalePath)return f.switchLocalePath(n.url.pathname,t,c,a);const l=n.url.pathname.split("/").filter(Boolean),r=l[0];return r&&c.includes(r)&&l.shift(),t!==a&&l.unshift(t),`/${l.join("/")}`},localizePath:(t,l)=>{if(f?.localizePath)return f.localizePath(t,l||s,c,a);const o=(t.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),u=o[0];return u&&c.includes(u)&&o.shift(),l&&l!==a&&o.unshift(l),`/${o.join("/")}`},getI18n:()=>e,getBasePath:t=>{const o=(t||n.url).pathname.split("/").filter(Boolean),u=o[0];return u&&c.includes(u)&&o.shift(),o.length>0?`/${o.join("/")}`:"/"},addTranslations:(t,l,r=!0)=>{e.addTranslations(t,l,r)},addRouteTranslations:(t,l,r,o=!0)=>{e.addRouteTranslations(t,l,r,o)},mergeTranslations:(t,l,r)=>{e.mergeTranslations(t,l,r)},mergeGlobalTranslations:(t,l)=>{e.mergeGlobalTranslations(t,l)},clearCache:()=>{e.clearCache()}}}function K(n,e={}){const{baseUrl:s="/",addDirAttribute:a=!0,addSeoAttributes:i=!0}=e,c=w(n),f=R(n),t=k(n),l=t.find(g=>g.code===c);if(!l)return{htmlAttrs:{},link:[],meta:[]};const r=l.iso||c,o=l.dir||"auto",u={htmlAttrs:{lang:r,...a?{dir:o}:{}},link:[],meta:[]};if(!i)return u;const h=`${s}${n.url.pathname}`;u.link.push({rel:"canonical",href:h});const d=B(n),m=t.map(g=>g.code);for(const g of t){if(g.code===c)continue;let p=n.url.pathname;if(d?.switchLocalePath)p=d.switchLocalePath(n.url.pathname,g.code,m,f);else{const L=n.url.pathname.split("/").filter(Boolean),y=L[0];y&&m.includes(y)&&L.shift(),g.code!==f&&L.unshift(g.code),p=`/${L.join("/")}`}const P=`${s}${p}`;u.link.push({rel:"alternate",href:P,hreflang:g.code}),g.iso&&g.iso!==g.code&&u.link.push({rel:"alternate",href:P,hreflang:g.iso})}u.meta.push({property:"og:locale",content:r}),u.meta.push({property:"og:url",content:h});for(const g of t)g.code!==c&&u.meta.push({property:"og:locale:alternate",content:g.iso||g.code});return u}function Q(n,e,s){const a=e.split(".");let i=n;for(let f=0;f<a.length-1;f++){const t=a[f];i[t]||(i[t]={}),i=i[t]}const c=a[a.length-1];c!==void 0&&(i[c]=s)}function X(n,e){const s=v(n),a=w(n),i=R(n),c=s.getRoute(),f={};if(e&&e.length>0){const t={};for(const l of e){const r=s.t(l,void 0,void 0,c);r!=null&&r!==l&&Q(t,l,r)}Object.keys(t).length>0&&(f[c]=t)}else{const t=s.getRouteTranslations(a,c);t&&(f[c]=t)}return{locale:a,fallbackLocale:i,currentRoute:c,translations:f}}Object.defineProperty(exports,"FormatService",{enumerable:!0,get:()=>T.FormatService});Object.defineProperty(exports,"defaultPlural",{enumerable:!0,get:()=>T.defaultPlural});Object.defineProperty(exports,"interpolate",{enumerable:!0,get:()=>T.interpolate});exports.AstroI18n=j;exports.createAstroRouterAdapter=z;exports.createI18n=N;exports.createI18nMiddleware=M;exports.detectLocale=W;exports.getDefaultLocale=R;exports.getI18n=v;exports.getI18nProps=X;exports.getLocale=w;exports.getLocaleFromPath=G;exports.getLocales=k;exports.getRouteName=H;exports.i18nIntegration=C;exports.loadTranslationsFromDir=F;exports.loadTranslationsIntoI18n=q;exports.localizePath=E;exports.removeLocaleFromPath=J;exports.switchLocalePath=U;exports.useI18n=V;exports.useLocaleHead=K;
+          `})}}}}function N(n){return new w(n)}function F(n){const{translationDir:e,rootDir:s=process.cwd(),disablePageLocales:o=!1}=n,i=I.resolve(s,e);if(!b.existsSync(i))return console.warn(`[i18n] Translation directory not found: ${i}`),{root:{},routes:{}};const c={},f={},t=(l,r="")=>{if(!b.existsSync(l))return;const a=b.readdirSync(l);for(const u of a){const h=I.join(l,u);if(b.statSync(h).isDirectory())u==="pages"&&!o?t(h,""):r||o?t(h,r):t(h,u);else if(u.endsWith(".json")){const m=u.replace(".json","");try{const g=b.readFileSync(h,"utf-8"),p=JSON.parse(g);r&&!o?(f[r]||(f[r]={}),f[r][m]=p):c[m]=p}catch(g){console.error(`[i18n] Failed to load translation file: ${h}`,g)}}}};return t(i),{root:c,routes:f}}function q(n,e){const{root:s,routes:o}=F(e);for(const[i,c]of Object.entries(s))n.addTranslations(i,c,!1);for(const[i,c]of Object.entries(o))for(const[f,t]of Object.entries(c)){const l=s[f]||{};n.addRouteTranslations(f,i,{...l,...t},!1)}}function M(n){const{i18n:e,defaultLocale:s,locales:o,localeObjects:i,autoDetect:c=!0,redirectToDefault:f=!1,routingStrategy:t}=n,l=t||D();return async(r,a)=>{if(r.locals.locale&&r.locals.i18n)return a();const u=r.url,h=u.pathname;if(!l){const S=e.clone(s),O=h==="/"||h===""?"index":h.split("/").filter(Boolean).join("-");return S.setRoute(O),r.locals.i18n=S,r.locals.locale=s,r.locals.defaultLocale=s,r.locals.locales=i||o.map(_=>({code:_})),r.locals.currentUrl=u,a()}const d={...l,getCurrentPath:()=>h,getRoute:()=>({fullPath:u.pathname+u.search,query:Object.fromEntries(u.searchParams)})},g=h.split("/").filter(Boolean)[0],p=g!==void 0&&o.includes(g);let P;p&&g?P=g:d.getLocaleFromPath?P=d.getLocaleFromPath(h,s,o):P=s;const L=e.clone(P),y=d.getRouteName?d.getRouteName(h,o):"index";return L.setRoute(y),r.locals.i18n=L,r.locals.locale=P,r.locals.defaultLocale=s,r.locals.locales=i||o.map(S=>({code:S})),r.locals.currentUrl=u,r.locals.routingStrategy=d,a()}}function A(n){const e=[],s=n.split(",");for(const o of s){const[i,c="1.0"]=o.trim().split(";q=");if(Number.parseFloat(c)>0&&i){const t=i.split("-")[0]?.toLowerCase();t&&(e.push(t),i!==t&&e.push(i.toLowerCase()))}}return e}function W(n,e,s,o,i,c="i18n-locale"){const f=D();let t=o;if(f?.getLocaleFromPath)t=f.getLocaleFromPath(n,o,i);else{const r=n.split("/").filter(Boolean)[0];r&&i.includes(r)&&(t=r)}if(c!==null&&t===o&&e.get(c)){const l=e.get(c)?.value;l&&i.includes(l)&&(t=l)}if(t===o)try{const l=s.get("accept-language");if(l){const r=A(l);for(const a of r)if(i.includes(a)){t=a;break}}}catch{}return t}function z(n,e,s){const o=n.map(a=>a.code),i=(a,u=[])=>{const h=a.replace(/^\//,"").replace(/\/$/,"");if(!h)return"index";const d=h.split("/").filter(Boolean),m=d[0];return m&&u.includes(m)&&d.shift(),d.length===0?"index":d.join("-")},c=(a,u="en",h=[])=>{const m=a.split("/").filter(Boolean)[0];return m&&h.includes(m)?m:u},f=(a,u,h=[],d)=>{const m=a.split("/").filter(Boolean),g=m[0];return g&&h.includes(g)&&m.shift(),(u!==d||d===void 0)&&m.unshift(u),`/${m.join("/")}`},t=(a,u,h=[],d)=>{const g=(a.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),p=g[0];return p&&h.includes(p)&&g.shift(),(u!==d||d===void 0)&&g.unshift(u),`/${g.join("/")}`};return{getCurrentPath:()=>s?s().pathname:typeof window<"u"?window.location.pathname:"/",getRouteName:i,getLocaleFromPath:c,switchLocalePath:f,localizePath:t,removeLocaleFromPath:(a,u=[])=>{const h=a.split("/").filter(Boolean),d=h[0];return d&&u.includes(d)&&h.shift(),`/${h.join("/")}`},resolvePath:(a,u)=>{const h=typeof a=="string"?a:a.path||"/";return t(h,u,o,e)},getRoute:()=>{if(s){const a=s();return{fullPath:a.pathname+a.search,query:Object.fromEntries(a.searchParams)}}if(typeof window<"u"){const a=new URL(window.location.href);return{fullPath:a.pathname+a.search,query:Object.fromEntries(a.searchParams)}}return{fullPath:"/",query:{}}},push:a=>{typeof window<"u"&&(window.location.href=a.path)},replace:a=>{typeof window<"u"&&window.location.replace(a.path)}}}function H(n,e=[]){const s=n.replace(/^\//,"").replace(/\/$/,"");if(!s)return"index";const o=s.split("/").filter(Boolean),i=o[0];return i&&e.includes(i)&&o.shift(),o.length===0?"index":o.join("-")}function U(n,e="en",s=[]){const i=n.split("/").filter(Boolean)[0];return i&&s.includes(i)?i:e}function E(n,e,s=[],o){const i=n.split("/").filter(Boolean),c=i[0];return c&&s.includes(c)&&i.shift(),(e!==o||o===void 0)&&i.unshift(e),`/${i.join("/")}`}function J(n,e,s=[],o){const c=(n.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),f=c[0];return f&&s.includes(f)&&c.shift(),(e!==o||o===void 0)&&c.unshift(e),`/${c.join("/")}`}function V(n,e=[]){const s=n.split("/").filter(Boolean),o=s[0];return o&&e.includes(o)&&s.shift(),`/${s.join("/")}`}function v(n){const e=n.locals.i18n;if(!e)throw new Error("i18n instance not found. Make sure i18n middleware is configured.");return e}function R(n){return n.locals.locale||"en"}function T(n){return n.locals.defaultLocale||"en"}function k(n){return n.locals.locales||[]}function B(n){return n.locals.routingStrategy||null}function G(n){const e=v(n),s=R(n),o=T(n),i=k(n),c=i.map(t=>t.code),f=B(n);return{locale:s,defaultLocale:o,locales:i,t:(t,l,r,a)=>e.t(t,l,r,a),ts:(t,l,r,a)=>e.ts(t,l,r,a),tc:(t,l,r)=>e.tc(t,l,r),tn:(t,l)=>e.tn(t,l),td:(t,l)=>e.td(t,l),tdr:(t,l)=>e.tdr(t,l),has:(t,l)=>e.has(t,l),getRoute:()=>e.getRoute(),getRouteName:t=>{const l=t||n.url.pathname;if(f?.getRouteName)return f.getRouteName(l,c);const r=l.replace(/^\//,"").replace(/\/$/,"");if(!r)return"index";const a=r.split("/").filter(Boolean),u=a[0];return u&&c.includes(u)&&a.shift(),a.length===0?"index":a.join("-")},getLocaleFromPath:t=>{const l=t||n.url.pathname;if(f?.getLocaleFromPath)return f.getLocaleFromPath(l,o,c);const a=l.split("/").filter(Boolean)[0];return a&&c.includes(a)?a:o},switchLocalePath:t=>{if(f?.switchLocalePath)return f.switchLocalePath(n.url.pathname,t,c,o);const l=n.url.pathname.split("/").filter(Boolean),r=l[0];return r&&c.includes(r)&&l.shift(),t!==o&&l.unshift(t),`/${l.join("/")}`},localizePath:(t,l)=>{if(f?.localizePath)return f.localizePath(t,l||s,c,o);const a=(t.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),u=a[0];return u&&c.includes(u)&&a.shift(),l&&l!==o&&a.unshift(l),`/${a.join("/")}`},getI18n:()=>e,getBasePath:t=>{const a=(t||n.url).pathname.split("/").filter(Boolean),u=a[0];return u&&c.includes(u)&&a.shift(),a.length>0?`/${a.join("/")}`:"/"},addTranslations:(t,l,r=!0)=>{e.addTranslations(t,l,r)},addRouteTranslations:(t,l,r,a=!0)=>{e.addRouteTranslations(t,l,r,a)},mergeTranslations:(t,l,r)=>{e.mergeTranslations(t,l,r)},clearCache:()=>{e.clearCache()}}}function K(n,e={}){const{baseUrl:s="/",addDirAttribute:o=!0,addSeoAttributes:i=!0}=e,c=R(n),f=T(n),t=k(n),l=t.find(g=>g.code===c);if(!l)return{htmlAttrs:{},link:[],meta:[]};const r=l.iso||c,a=l.dir||"auto",u={htmlAttrs:{lang:r,...o?{dir:a}:{}},link:[],meta:[]};if(!i)return u;const h=`${s}${n.url.pathname}`;u.link.push({rel:"canonical",href:h});const d=B(n),m=t.map(g=>g.code);for(const g of t){if(g.code===c)continue;let p=n.url.pathname;if(d?.switchLocalePath)p=d.switchLocalePath(n.url.pathname,g.code,m,f);else{const L=n.url.pathname.split("/").filter(Boolean),y=L[0];y&&m.includes(y)&&L.shift(),g.code!==f&&L.unshift(g.code),p=`/${L.join("/")}`}const P=`${s}${p}`;u.link.push({rel:"alternate",href:P,hreflang:g.code}),g.iso&&g.iso!==g.code&&u.link.push({rel:"alternate",href:P,hreflang:g.iso})}u.meta.push({property:"og:locale",content:r}),u.meta.push({property:"og:url",content:h});for(const g of t)g.code!==c&&u.meta.push({property:"og:locale:alternate",content:g.iso||g.code});return u}function Q(n,e,s){const o=e.split(".");let i=n;for(let f=0;f<o.length-1;f++){const t=o[f];i[t]||(i[t]={}),i=i[t]}const c=o[o.length-1];c!==void 0&&(i[c]=s)}function X(n,e){const s=v(n),o=R(n),i=T(n),c=s.getRoute(),f={};if(e&&e.length>0){const t={};for(const l of e){const r=s.t(l,void 0,void 0,c);r!=null&&r!==l&&Q(t,l,r)}Object.keys(t).length>0&&(f[c]=t)}else{const t=s.getRouteTranslations(o,c);t&&(f[c]=t)}return{locale:o,fallbackLocale:i,currentRoute:c,translations:f}}Object.defineProperty(exports,"FormatService",{enumerable:!0,get:()=>j.FormatService});Object.defineProperty(exports,"defaultPlural",{enumerable:!0,get:()=>j.defaultPlural});Object.defineProperty(exports,"interpolate",{enumerable:!0,get:()=>j.interpolate});exports.AstroI18n=w;exports.createAstroRouterAdapter=z;exports.createI18n=N;exports.createI18nMiddleware=M;exports.detectLocale=W;exports.getDefaultLocale=T;exports.getI18n=v;exports.getI18nProps=X;exports.getLocale=R;exports.getLocaleFromPath=U;exports.getLocales=k;exports.getRouteName=H;exports.i18nIntegration=C;exports.loadTranslationsFromDir=F;exports.loadTranslationsIntoI18n=q;exports.localizePath=J;exports.removeLocaleFromPath=V;exports.switchLocalePath=E;exports.useI18n=G;exports.useLocaleHead=K;

package/dist/index.mjs

@@ -1,38 +1,38 @@
 import { BaseI18n as I } from "@i18n-micro/core";
 import { FormatService as le, defaultPlural as re, interpolate as ie } from "@i18n-micro/core";
-import { existsSync as R, readdirSync as _, statSync as C, readFileSync as N } from "node:fs";
+import { existsSync as j, readdirSync as _, statSync as C, readFileSync as N } from "node:fs";
 import { resolve as O, join as q } from "node:path";
 class S extends I {
   constructor(e) {
-    const s = e._storage || {
+    const a = e._storage || {
       translations: /* @__PURE__ */ new Map()
     };
     if (super({
-      storage: s,
+      storage: a,
       plural: e.plural,
       missingWarn: e.missingWarn,
       missingHandler: e.missingHandler
-    }), this.initialMessages = {}, this.storage = s, this._locale = e.locale, this._fallbackLocale = e.fallbackLocale || e.locale, this._currentRoute = "general", e.messages) {
+    }), this.initialMessages = {}, this.storage = a, this._locale = e.locale, this._fallbackLocale = e.fallbackLocale || e.locale, this._currentRoute = "index", e.messages) {
       this.initialMessages = { ...e.messages };
       for (const [o, i] of Object.entries(e.messages))
         this.helper.loadTranslations(o, i);
     }
   }
   cloneStorage(e) {
-    const s = /* @__PURE__ */ new Map();
+    const a = /* @__PURE__ */ new Map();
     for (const [o, i] of e.translations)
-      s.set(o, { ...i });
-    return { translations: s };
+      a.set(o, { ...i });
+    return { translations: a };
   }
   clone(e) {
-    const s = this.cloneStorage(this.storage);
+    const a = this.cloneStorage(this.storage);
     return new S({
       locale: e || this._locale,
       fallbackLocale: this._fallbackLocale,
       plural: this.pluralFunc,
       missingWarn: this.missingWarn,
       missingHandler: this.missingHandler,
-      _storage: s
+      _storage: a
     });
   }
   get locale() {
@@ -59,45 +59,42 @@ class S extends I {
   getRoute() {
     return this._currentRoute;
   }
-  getRouteTranslations(e, s) {
-    const o = `${e}:${s}`;
+  getRouteTranslations(e, a) {
+    const o = `${e}:${a}`;
     return this.storage.translations.get(o) ?? null;
   }
-  addTranslations(e, s, o = !0) {
-    super.loadTranslationsCore(e, s, o);
+  addTranslations(e, a, o = !0) {
+    super.loadTranslationsCore(e, a, o);
   }
-  addRouteTranslations(e, s, o, i = !0) {
-    super.loadRouteTranslationsCore(e, s, o, i);
+  addRouteTranslations(e, a, o, i = !0) {
+    super.loadRouteTranslationsCore(e, a, o, i);
   }
-  mergeTranslations(e, s, o) {
-    this.helper.mergeTranslation(e, s, o, !0);
-  }
-  mergeGlobalTranslations(e, s) {
-    this.helper.mergeGlobalTranslation(e, s, !0);
+  mergeTranslations(e, a, o) {
+    this.helper.mergeTranslation(e, a, o, !0);
   }
   clearCache() {
     const e = { ...this.initialMessages };
     if (super.clearCache(), Object.keys(e).length > 0)
-      for (const [s, o] of Object.entries(e))
-        this.helper.loadTranslations(s, o);
+      for (const [a, o] of Object.entries(e))
+        this.helper.loadTranslations(a, o);
   }
 }
-let j = null;
+let T = null;
 function v() {
-  return j;
+  return T;
 }
-function U(n) {
-  const { locale: e, fallbackLocale: s, translationDir: o, routingStrategy: i } = n;
-  return j = i || null, {
+function E(n) {
+  const { locale: e, fallbackLocale: a, translationDir: o, routingStrategy: i } = n;
+  return T = i || null, {
     name: "@i18n-micro/astro",
     hooks: {
-      // 1. Настройка Vite (Виртуальный модуль) происходит здесь
+      // 1. Vite setup (virtual module) happens here
       "astro:config:setup": (c) => {
         const { updateConfig: f } = c, t = "virtual:i18n-micro/config", l = `\0${t}`, r = {
           defaultLocale: e,
-          fallbackLocale: s || e,
+          fallbackLocale: a || e,
           locales: n.locales || [],
-          localeCodes: (n.locales || []).map((a) => a.code),
+          localeCodes: (n.locales || []).map((s) => s.code),
           translationDir: o || null,
           autoDetect: n.autoDetect ?? !0,
           redirectToDefault: n.redirectToDefault ?? !1,
@@ -109,12 +106,12 @@ function U(n) {
             plugins: [
               {
                 name: "vite-plugin-i18n-micro-config",
-                resolveId(a) {
-                  if (a === t)
+                resolveId(s) {
+                  if (s === t)
                     return l;
                 },
-                load(a) {
-                  if (a === l)
+                load(s) {
+                  if (s === l)
                     return `export const config = ${JSON.stringify(r)}`;
                 }
               }
@@ -122,7 +119,7 @@ function U(n) {
           }
         });
       },
-      // 2. Инъекция типов происходит здесь (согласно документации Astro)
+      // 2. Type injection happens here (per Astro documentation)
       "astro:config:done": (c) => {
         const { injectTypes: f } = c;
         f({
@@ -149,17 +146,17 @@ function U(n) {
     }
   };
 }
-function E(n) {
+function J(n) {
   return new S(n);
 }
 function M(n) {
-  const { translationDir: e, rootDir: s = process.cwd(), disablePageLocales: o = !1 } = n, i = O(s, e);
-  if (!R(i))
-    return console.warn(`[i18n] Translation directory not found: ${i}`), { general: {}, routes: {} };
+  const { translationDir: e, rootDir: a = process.cwd(), disablePageLocales: o = !1 } = n, i = O(a, e);
+  if (!j(i))
+    return console.warn(`[i18n] Translation directory not found: ${i}`), { root: {}, routes: {} };
   const c = {}, f = {}, t = (l, r = "") => {
-    if (!R(l)) return;
-    const a = _(l);
-    for (const u of a) {
+    if (!j(l)) return;
+    const s = _(l);
+    for (const u of s) {
       const h = q(l, u);
       if (C(h).isDirectory())
         u === "pages" && !o ? t(h, "") : r || o ? t(h, r) : t(h, u);
@@ -174,34 +171,36 @@ function M(n) {
       }
     }
   };
-  return t(i), { general: c, routes: f };
+  return t(i), { root: c, routes: f };
 }
-function J(n, e) {
-  const { general: s, routes: o } = M(e);
-  for (const [i, c] of Object.entries(s))
+function V(n, e) {
+  const { root: a, routes: o } = M(e);
+  for (const [i, c] of Object.entries(a))
     n.addTranslations(i, c, !1);
   for (const [i, c] of Object.entries(o))
-    for (const [f, t] of Object.entries(c))
-      n.addRouteTranslations(f, i, t, !1);
+    for (const [f, t] of Object.entries(c)) {
+      const l = a[f] || {};
+      n.addRouteTranslations(f, i, { ...l, ...t }, !1);
+    }
 }
-function V(n) {
+function G(n) {
   const {
     i18n: e,
-    // Это глобальный синглтон с кэшем
-    defaultLocale: s,
+    // This is the global singleton with cache
+    defaultLocale: a,
     locales: o,
     localeObjects: i,
     autoDetect: c = !0,
     redirectToDefault: f = !1,
     routingStrategy: t
   } = n, l = t || v();
-  return async (r, a) => {
+  return async (r, s) => {
     if (r.locals.locale && r.locals.i18n)
-      return a();
+      return s();
     const u = r.url, h = u.pathname;
     if (!l) {
-      const y = e.clone(s), B = h === "/" || h === "" ? "index" : h.split("/").filter(Boolean).join("-");
-      return y.setRoute(B), r.locals.i18n = y, r.locals.locale = s, r.locals.defaultLocale = s, r.locals.locales = i || o.map((F) => ({ code: F })), r.locals.currentUrl = u, a();
+      const b = e.clone(a), B = h === "/" || h === "" ? "index" : h.split("/").filter(Boolean).join("-");
+      return b.setRoute(B), r.locals.i18n = b, r.locals.locale = a, r.locals.defaultLocale = a, r.locals.locales = i || o.map((F) => ({ code: F })), r.locals.currentUrl = u, s();
     }
     const d = {
       ...l,
@@ -212,14 +211,14 @@ function V(n) {
       })
     }, g = h.split("/").filter(Boolean)[0], p = g !== void 0 && o.includes(g);
     let P;
-    p && g ? P = g : d.getLocaleFromPath ? P = d.getLocaleFromPath(h, s, o) : P = s;
-    const L = e.clone(P), b = d.getRouteName ? d.getRouteName(h, o) : "general";
-    return L.setRoute(b), r.locals.i18n = L, r.locals.locale = P, r.locals.defaultLocale = s, r.locals.locales = i || o.map((y) => ({ code: y })), r.locals.currentUrl = u, r.locals.routingStrategy = d, a();
+    p && g ? P = g : d.getLocaleFromPath ? P = d.getLocaleFromPath(h, a, o) : P = a;
+    const L = e.clone(P), y = d.getRouteName ? d.getRouteName(h, o) : "index";
+    return L.setRoute(y), r.locals.i18n = L, r.locals.locale = P, r.locals.defaultLocale = a, r.locals.locales = i || o.map((b) => ({ code: b })), r.locals.currentUrl = u, r.locals.routingStrategy = d, s();
   };
 }
 function W(n) {
-  const e = [], s = n.split(",");
-  for (const o of s) {
+  const e = [], a = n.split(",");
+  for (const o of a) {
     const [i, c = "1.0"] = o.trim().split(";q=");
     if (Number.parseFloat(c) > 0 && i) {
       const t = i.split("-")[0]?.toLowerCase();
@@ -228,7 +227,7 @@ function W(n) {
   }
   return e;
 }
-function K(n, e, s, o, i, c = "i18n-locale") {
+function K(n, e, a, o, i, c = "i18n-locale") {
   const f = v();
   let t = o;
   if (f?.getLocaleFromPath)
@@ -243,12 +242,12 @@ function K(n, e, s, o, i, c = "i18n-locale") {
   }
   if (t === o)
     try {
-      const l = s.get("accept-language");
+      const l = a.get("accept-language");
       if (l) {
         const r = W(l);
-        for (const a of r)
-          if (i.includes(a)) {
-            t = a;
+        for (const s of r)
+          if (i.includes(s)) {
+            t = s;
             break;
           }
       }
@@ -256,50 +255,50 @@ function K(n, e, s, o, i, c = "i18n-locale") {
     }
   return t;
 }
-function Q(n, e, s) {
-  const o = n.map((a) => a.code), i = (a, u = []) => {
-    const h = a.replace(/^\//, "").replace(/\/$/, "");
+function Q(n, e, a) {
+  const o = n.map((s) => s.code), i = (s, u = []) => {
+    const h = s.replace(/^\//, "").replace(/\/$/, "");
     if (!h)
       return "index";
     const d = h.split("/").filter(Boolean), m = d[0];
     return m && u.includes(m) && d.shift(), d.length === 0 ? "index" : d.join("-");
-  }, c = (a, u = "en", h = []) => {
-    const m = a.split("/").filter(Boolean)[0];
+  }, c = (s, u = "en", h = []) => {
+    const m = s.split("/").filter(Boolean)[0];
     return m && h.includes(m) ? m : u;
-  }, f = (a, u, h = [], d) => {
-    const m = a.split("/").filter(Boolean), g = m[0];
+  }, f = (s, u, h = [], d) => {
+    const m = s.split("/").filter(Boolean), g = m[0];
     return g && h.includes(g) && m.shift(), (u !== d || d === void 0) && m.unshift(u), `/${m.join("/")}`;
-  }, t = (a, u, h = [], d) => {
-    const g = (a.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), p = g[0];
+  }, t = (s, u, h = [], d) => {
+    const g = (s.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), p = g[0];
     return p && h.includes(p) && g.shift(), (u !== d || d === void 0) && g.unshift(u), `/${g.join("/")}`;
   };
   return {
-    getCurrentPath: () => s ? s().pathname : typeof window < "u" ? window.location.pathname : "/",
+    getCurrentPath: () => a ? a().pathname : typeof window < "u" ? window.location.pathname : "/",
     getRouteName: i,
     getLocaleFromPath: c,
     switchLocalePath: f,
     localizePath: t,
-    removeLocaleFromPath: (a, u = []) => {
-      const h = a.split("/").filter(Boolean), d = h[0];
+    removeLocaleFromPath: (s, u = []) => {
+      const h = s.split("/").filter(Boolean), d = h[0];
       return d && u.includes(d) && h.shift(), `/${h.join("/")}`;
     },
-    resolvePath: (a, u) => {
-      const h = typeof a == "string" ? a : a.path || "/";
+    resolvePath: (s, u) => {
+      const h = typeof s == "string" ? s : s.path || "/";
       return t(h, u, o, e);
     },
     getRoute: () => {
-      if (s) {
-        const a = s();
+      if (a) {
+        const s = a();
         return {
-          fullPath: a.pathname + a.search,
-          query: Object.fromEntries(a.searchParams)
+          fullPath: s.pathname + s.search,
+          query: Object.fromEntries(s.searchParams)
         };
       }
       if (typeof window < "u") {
-        const a = new URL(window.location.href);
+        const s = new URL(window.location.href);
         return {
-          fullPath: a.pathname + a.search,
-          query: Object.fromEntries(a.searchParams)
+          fullPath: s.pathname + s.search,
+          query: Object.fromEntries(s.searchParams)
         };
       }
       return {
@@ -308,36 +307,36 @@ function Q(n, e, s) {
       };
     },
     // Optional: client-side navigation for islands
-    push: (a) => {
-      typeof window < "u" && (window.location.href = a.path);
+    push: (s) => {
+      typeof window < "u" && (window.location.href = s.path);
     },
-    replace: (a) => {
-      typeof window < "u" && window.location.replace(a.path);
+    replace: (s) => {
+      typeof window < "u" && window.location.replace(s.path);
     }
   };
 }
 function X(n, e = []) {
-  const s = n.replace(/^\//, "").replace(/\/$/, "");
-  if (!s)
+  const a = n.replace(/^\//, "").replace(/\/$/, "");
+  if (!a)
     return "index";
-  const o = s.split("/").filter(Boolean), i = o[0];
+  const o = a.split("/").filter(Boolean), i = o[0];
   return i && e.includes(i) && o.shift(), o.length === 0 ? "index" : o.join("-");
 }
-function Y(n, e = "en", s = []) {
+function Y(n, e = "en", a = []) {
   const i = n.split("/").filter(Boolean)[0];
-  return i && s.includes(i) ? i : e;
+  return i && a.includes(i) ? i : e;
 }
-function Z(n, e, s = [], o) {
+function Z(n, e, a = [], o) {
   const i = n.split("/").filter(Boolean), c = i[0];
-  return c && s.includes(c) && i.shift(), (e !== o || o === void 0) && i.unshift(e), `/${i.join("/")}`;
+  return c && a.includes(c) && i.shift(), (e !== o || o === void 0) && i.unshift(e), `/${i.join("/")}`;
 }
-function x(n, e, s = [], o) {
+function x(n, e, a = [], o) {
   const c = (n.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), f = c[0];
-  return f && s.includes(f) && c.shift(), (e !== o || o === void 0) && c.unshift(e), `/${c.join("/")}`;
+  return f && a.includes(f) && c.shift(), (e !== o || o === void 0) && c.unshift(e), `/${c.join("/")}`;
 }
 function ee(n, e = []) {
-  const s = n.split("/").filter(Boolean), o = s[0];
-  return o && e.includes(o) && s.shift(), `/${s.join("/")}`;
+  const a = n.split("/").filter(Boolean), o = a[0];
+  return o && e.includes(o) && a.shift(), `/${a.join("/")}`;
 }
 function k(n) {
   const e = n.locals.i18n;
@@ -345,10 +344,10 @@ function k(n) {
     throw new Error("i18n instance not found. Make sure i18n middleware is configured.");
   return e;
 }
-function T(n) {
+function w(n) {
   return n.locals.locale || "en";
 }
-function w(n) {
+function R(n) {
   return n.locals.defaultLocale || "en";
 }
 function $(n) {
@@ -358,15 +357,15 @@ function D(n) {
   return n.locals.routingStrategy || null;
 }
 function te(n) {
-  const e = k(n), s = T(n), o = w(n), i = $(n), c = i.map((t) => t.code), f = D(n);
+  const e = k(n), a = w(n), o = R(n), i = $(n), c = i.map((t) => t.code), f = D(n);
   return {
     // Current locale
-    locale: s,
+    locale: a,
     defaultLocale: o,
     locales: i,
     // Translation methods
-    t: (t, l, r, a) => e.t(t, l, r, a),
-    ts: (t, l, r, a) => e.ts(t, l, r, a),
+    t: (t, l, r, s) => e.t(t, l, r, s),
+    ts: (t, l, r, s) => e.ts(t, l, r, s),
     tc: (t, l, r) => e.tc(t, l, r),
     tn: (t, l) => e.tn(t, l),
     td: (t, l) => e.td(t, l),
@@ -380,15 +379,15 @@ function te(n) {
         return f.getRouteName(l, c);
       const r = l.replace(/^\//, "").replace(/\/$/, "");
       if (!r) return "index";
-      const a = r.split("/").filter(Boolean), u = a[0];
-      return u && c.includes(u) && a.shift(), a.length === 0 ? "index" : a.join("-");
+      const s = r.split("/").filter(Boolean), u = s[0];
+      return u && c.includes(u) && s.shift(), s.length === 0 ? "index" : s.join("-");
     },
     getLocaleFromPath: (t) => {
       const l = t || n.url.pathname;
       if (f?.getLocaleFromPath)
         return f.getLocaleFromPath(l, o, c);
-      const a = l.split("/").filter(Boolean)[0];
-      return a && c.includes(a) ? a : o;
+      const s = l.split("/").filter(Boolean)[0];
+      return s && c.includes(s) ? s : o;
     },
     // Path utilities
     switchLocalePath: (t) => {
@@ -399,50 +398,47 @@ function te(n) {
     },
     localizePath: (t, l) => {
       if (f?.localizePath)
-        return f.localizePath(t, l || s, c, o);
-      const a = (t.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), u = a[0];
-      return u && c.includes(u) && a.shift(), l && l !== o && a.unshift(l), `/${a.join("/")}`;
+        return f.localizePath(t, l || a, c, o);
+      const s = (t.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), u = s[0];
+      return u && c.includes(u) && s.shift(), l && l !== o && s.unshift(l), `/${s.join("/")}`;
     },
     // Get i18n instance
     getI18n: () => e,
     // Get base path without locale (for rewrite)
     getBasePath: (t) => {
-      const a = (t || n.url).pathname.split("/").filter(Boolean), u = a[0];
-      return u && c.includes(u) && a.shift(), a.length > 0 ? `/${a.join("/")}` : "/";
+      const s = (t || n.url).pathname.split("/").filter(Boolean), u = s[0];
+      return u && c.includes(u) && s.shift(), s.length > 0 ? `/${s.join("/")}` : "/";
     },
     // Translation management
     addTranslations: (t, l, r = !0) => {
       e.addTranslations(t, l, r);
     },
-    addRouteTranslations: (t, l, r, a = !0) => {
-      e.addRouteTranslations(t, l, r, a);
+    addRouteTranslations: (t, l, r, s = !0) => {
+      e.addRouteTranslations(t, l, r, s);
     },
     mergeTranslations: (t, l, r) => {
       e.mergeTranslations(t, l, r);
     },
-    mergeGlobalTranslations: (t, l) => {
-      e.mergeGlobalTranslations(t, l);
-    },
     clearCache: () => {
       e.clearCache();
     }
   };
 }
 function ne(n, e = {}) {
-  const { baseUrl: s = "/", addDirAttribute: o = !0, addSeoAttributes: i = !0 } = e, c = T(n), f = w(n), t = $(n), l = t.find((g) => g.code === c);
+  const { baseUrl: a = "/", addDirAttribute: o = !0, addSeoAttributes: i = !0 } = e, c = w(n), f = R(n), t = $(n), l = t.find((g) => g.code === c);
   if (!l)
     return { htmlAttrs: {}, link: [], meta: [] };
-  const r = l.iso || c, a = l.dir || "auto", u = {
+  const r = l.iso || c, s = l.dir || "auto", u = {
     htmlAttrs: {
       lang: r,
-      ...o ? { dir: a } : {}
+      ...o ? { dir: s } : {}
     },
     link: [],
     meta: []
   };
   if (!i)
     return u;
-  const h = `${s}${n.url.pathname}`;
+  const h = `${a}${n.url.pathname}`;
   u.link.push({
     rel: "canonical",
     href: h
@@ -454,10 +450,10 @@ function ne(n, e = {}) {
     if (d?.switchLocalePath)
       p = d.switchLocalePath(n.url.pathname, g.code, m, f);
     else {
-      const L = n.url.pathname.split("/").filter(Boolean), b = L[0];
-      b && m.includes(b) && L.shift(), g.code !== f && L.unshift(g.code), p = `/${L.join("/")}`;
+      const L = n.url.pathname.split("/").filter(Boolean), y = L[0];
+      y && m.includes(y) && L.shift(), g.code !== f && L.unshift(g.code), p = `/${L.join("/")}`;
     }
-    const P = `${s}${p}`;
+    const P = `${a}${p}`;
     u.link.push({
       rel: "alternate",
       href: P,
@@ -482,7 +478,7 @@ function ne(n, e = {}) {
     });
   return u;
 }
-function A(n, e, s) {
+function A(n, e, a) {
   const o = e.split(".");
   let i = n;
   for (let f = 0; f < o.length - 1; f++) {
@@ -490,19 +486,19 @@ function A(n, e, s) {
     i[t] || (i[t] = {}), i = i[t];
   }
   const c = o[o.length - 1];
-  c !== void 0 && (i[c] = s);
+  c !== void 0 && (i[c] = a);
 }
 function oe(n, e) {
-  const s = k(n), o = T(n), i = w(n), c = s.getRoute(), f = {};
+  const a = k(n), o = w(n), i = R(n), c = a.getRoute(), f = {};
   if (e && e.length > 0) {
     const t = {};
     for (const l of e) {
-      const r = s.t(l, void 0, void 0, c);
+      const r = a.t(l, void 0, void 0, c);
       r != null && r !== l && A(t, l, r);
     }
     Object.keys(t).length > 0 && (f[c] = t);
   } else {
-    const t = s.getRouteTranslations(o, c);
+    const t = a.getRouteTranslations(o, c);
     t && (f[c] = t);
   }
   return {
@@ -516,21 +512,21 @@ export {
   S as AstroI18n,
   le as FormatService,
   Q as createAstroRouterAdapter,
-  E as createI18n,
-  V as createI18nMiddleware,
+  J as createI18n,
+  G as createI18nMiddleware,
   re as defaultPlural,
   K as detectLocale,
-  w as getDefaultLocale,
+  R as getDefaultLocale,
   k as getI18n,
   oe as getI18nProps,
-  T as getLocale,
+  w as getLocale,
   Y as getLocaleFromPath,
   $ as getLocales,
   X as getRouteName,
-  U as i18nIntegration,
+  E as i18nIntegration,
   ie as interpolate,
   M as loadTranslationsFromDir,
-  J as loadTranslationsIntoI18n,
+  V as loadTranslationsIntoI18n,
   x as localizePath,
   ee as removeLocaleFromPath,
   Z as switchLocalePath,

package/dist/load-translations.d.ts

@@ -21,7 +21,7 @@ export interface LoadTranslationsOptions {
     disablePageLocales?: boolean;
 }
 export interface LoadedTranslations {
-    general: Record<string, Translations>;
+    root: Record<string, Translations>;
     routes: Record<string, Record<string, Translations>>;
 }
 /**

package/dist/utils.d.ts

@@ -42,7 +42,6 @@ export declare function useI18n(astro: AstroGlobal): {
     addTranslations: (locale: string, translations: Record<string, unknown>, merge?: boolean) => void;
     addRouteTranslations: (locale: string, routeName: string, translations: Record<string, unknown>, merge?: boolean) => void;
     mergeTranslations: (locale: string, routeName: string, translations: Record<string, unknown>) => void;
-    mergeGlobalTranslations: (locale: string, translations: Record<string, unknown>) => void;
     clearCache: () => void;
 };
 /**
@@ -70,7 +69,7 @@ export interface LocaleHeadResult {
 }
 export declare function useLocaleHead(astro: AstroGlobal, options?: LocaleHeadOptions): LocaleHeadResult;
 /**
- * Props для передачи в клиентские острова (Vue, React, Svelte, Preact)
+ * Props to pass to client islands (Vue, React, Svelte, Preact)
  */
 export interface I18nClientProps {
     locale: string;
@@ -79,9 +78,9 @@ export interface I18nClientProps {
     currentRoute: string;
 }
 /**
- * Подготавливает пропсы для передачи в клиентский остров.
- * Принимает список ключей, которые нужно передать в остров.
- * Использует методы i18n для правильной работы с routesLocaleLinks.
- * currentRoute уже нормализован через middleware (getRouteName), поэтому используем его напрямую.
+ * Prepares props to pass to a client island.
+ * Accepts a list of keys to pass to the island.
+ * Uses i18n methods for proper routesLocaleLinks support.
+ * currentRoute is already normalized via middleware (getRouteName), so we use it directly.
  */
 export declare function getI18nProps(astro: AstroGlobal, keys?: string[]): I18nClientProps;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/astro",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -51,9 +51,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@i18n-micro/core": "1.1.2",
-    "@i18n-micro/types": "1.1.1",
-    "@i18n-micro/node": "1.1.1"
+    "@i18n-micro/core": "1.2.0",
+    "@i18n-micro/types": "1.1.5",
+    "@i18n-micro/node": "1.2.0"
   },
   "peerDependencies": {
     "astro": "^5.16.5",

package/src/client/core.ts

@@ -2,7 +2,7 @@ import { interpolate } from '@i18n-micro/core'
 import type { Params, Translations } from '@i18n-micro/types'
 
 /**
- * Состояние i18n для клиентских островов
+ * I18n state for client islands
  */
 export interface I18nState {
   locale: string
@@ -11,7 +11,7 @@ export interface I18nState {
   currentRoute: string
 }
 
-// Вспомогательная функция для поиска перевода в объекте Translations
+// Helper function to find a translation in a Translations object
 // Returns the value as-is, including objects (for nested translations)
 function findTranslation<T = unknown>(translations: Translations | null, key: string): T | null {
   if (translations === null || typeof key !== 'string') {
@@ -20,11 +20,11 @@ function findTranslation<T = unknown>(translations: Translations | null, key: st
 
   let value: string | number | boolean | Translations | unknown | null = translations
 
-  // Прямой доступ к ключу
+  // Direct key access
   if (translations[key]) {
     value = translations[key]
   } else {
-    // Поиск по вложенным ключам (например, "nested.message")
+    // Search by nested keys (e.g. "nested.message")
     const parts = key.toString().split('.')
     for (const part of parts) {
       if (value && typeof value === 'object' && value !== null && part in value) {
@@ -41,7 +41,7 @@ function findTranslation<T = unknown>(translations: Translations | null, key: st
 }
 
 /**
- * Чистая функция для получения перевода из состояния
+ * Pure function to get a translation from state
  *
  * Note: This is a simplified version optimized for client-side islands.
  * It supports basic translation lookup, interpolation, and fallback to general translations.
@@ -62,40 +62,40 @@ export function translate(
   const route = routeName || state.currentRoute
   let value: string | number | boolean | Translations | null = null
 
-  // 1. Ищем в route-specific переводах
+  // 1. Look in route-specific translations
   if (state.translations[route]) {
     value = findTranslation<string | number | boolean | Translations>(state.translations[route], key)
   }
 
-  // 2. Fallback на general переводы
+  // 2. Fallback to general translations
   if (!value && state.translations.general) {
     value = findTranslation<string | number | boolean | Translations>(state.translations.general, key)
   }
 
-  // 3. Если не найдено, используем defaultValue или key
+  // 3. If not found, use defaultValue or key
   if (!value) {
     value = defaultValue === undefined ? key : defaultValue || key
   }
 
-  // 4. Интерполяция параметров (только для строк)
+  // 4. Parameter interpolation (strings only)
   if (typeof value === 'string' && params) {
     return interpolate(value, params)
   }
 
-  // 5. Возвращаем value как есть (может быть string, number, boolean, object, или null)
-  // Это соответствует типу CleanTranslation
+  // 5. Return value as-is (can be string, number, boolean, object, or null)
+  // This matches the CleanTranslation type
   return value
 }
 
 /**
- * Проверяет наличие перевода в состоянии
+ * Checks if a translation exists in the state
  */
 export function hasTranslation(state: I18nState, key: string, routeName?: string): boolean {
   const route = routeName || state.currentRoute
   const routeTranslations = state.translations[route]
   const generalTranslations = state.translations.general
 
-  // Проверяем в route-specific переводах
+  // Check in route-specific translations
   if (routeTranslations) {
     const value = findTranslation(routeTranslations, key)
     if (value !== null && typeof value !== 'object') {
@@ -103,7 +103,7 @@ export function hasTranslation(state: I18nState, key: string, routeName?: string
     }
   }
 
-  // Проверяем в general переводах
+  // Check in general translations
   if (generalTranslations) {
     const value = findTranslation(generalTranslations, key)
     if (value !== null && typeof value !== 'object') {

package/src/client/index.ts

@@ -1,4 +1,4 @@
-// Core utilities (чистые функции)
+// Core utilities (pure functions)
 
 export type { I18nState } from './core'
 export { hasTranslation, translate } from './core'

package/src/client/svelte.ts

@@ -7,7 +7,7 @@ import { hasTranslation, type I18nState, translate } from './core'
 const formatter = new FormatService()
 
 /**
- * Создает Svelte store для i18n состояния
+ * Creates a Svelte store for i18n state
  */
 export function createI18nStore(props: I18nClientProps): Writable<I18nState> {
   return writable<I18nState>({
@@ -19,8 +19,8 @@ export function createI18nStore(props: I18nClientProps): Writable<I18nState> {
 }
 
 /**
- * Хук для использования i18n в Svelte компонентах
- * Используйте в <script> блоке компонента
+ * Hook for using i18n in Svelte components
+ * Use in the component's <script> block
  */
 export function useAstroI18n(store: Writable<I18nState>) {
   const getState = () => get(store)
@@ -71,7 +71,7 @@ export function useAstroI18n(store: Writable<I18nState>) {
   }
 
   return {
-    // Store для реактивности в шаблонах (используйте $i18nStore в шаблонах)
+    // Store for reactivity in templates (use $i18nStore in templates)
     store,
 
     // Translation methods
@@ -83,7 +83,7 @@ export function useAstroI18n(store: Writable<I18nState>) {
     tdr,
     has,
 
-    // Геттеры для текущего состояния (для использования в скриптах)
+    // Getters for current state (for use in scripts)
     get locale() {
       return getState().locale
     },

package/src/client/vue.ts

@@ -9,8 +9,8 @@ const formatter = new FormatService()
 const I18nSymbol = Symbol('i18n-astro') as InjectionKey<Ref<I18nState>>
 
 /**
- * Инициализирует i18n провайдер для Vue острова
- * Вызывайте в корневом компоненте острова
+ * Initializes the i18n provider for a Vue island
+ * Call in the island's root component
  */
 export function provideI18n(props: I18nClientProps): Ref<I18nState> {
   const state = ref<I18nState>({
@@ -24,7 +24,7 @@ export function provideI18n(props: I18nClientProps): Ref<I18nState> {
 }
 
 /**
- * Хук для использования i18n в Vue компонентах
+ * Hook for using i18n in Vue components
  */
 export function useAstroI18n() {
   const state = inject(I18nSymbol)

package/src/composer.ts

@@ -35,7 +35,7 @@ export class AstroI18n extends BaseI18n {
     this.storage = storage
     this._locale = options.locale
     this._fallbackLocale = options.fallbackLocale || options.locale
-    this._currentRoute = 'general'
+    this._currentRoute = 'index'
 
     if (options.messages) {
       this.initialMessages = { ...options.messages }
@@ -115,10 +115,6 @@ export class AstroI18n extends BaseI18n {
     this.helper.mergeTranslation(locale, routeName, translations, true)
   }
 
-  public mergeGlobalTranslations(locale: string, translations: Translations): void {
-    this.helper.mergeGlobalTranslation(locale, translations, true)
-  }
-
   public override clearCache(): void {
     const initialMessages = { ...this.initialMessages }
 

package/src/integration.ts

@@ -39,7 +39,7 @@ export function i18nIntegration(options: I18nIntegrationOptions): AstroIntegrati
   return {
     name: '@i18n-micro/astro',
     hooks: {
-      // 1. Настройка Vite (Виртуальный модуль) происходит здесь
+      // 1. Vite setup (virtual module) happens here
       'astro:config:setup': (params) => {
         const { updateConfig } = params as HookParameters<'astro:config:setup'>
 
@@ -79,7 +79,7 @@ export function i18nIntegration(options: I18nIntegrationOptions): AstroIntegrati
         })
       },
 
-      // 2. Инъекция типов происходит здесь (согласно документации Astro)
+      // 2. Type injection happens here (per Astro documentation)
       'astro:config:done': (params) => {
         const { injectTypes } = params as HookParameters<'astro:config:done'>
 

package/src/load-translations.ts

@@ -26,7 +26,7 @@ export interface LoadTranslationsOptions {
 }
 
 export interface LoadedTranslations {
-  general: Record<string, Translations>
+  root: Record<string, Translations>
   routes: Record<string, Record<string, Translations>>
 }
 
@@ -43,10 +43,10 @@ export function loadTranslationsFromDir(options: LoadTranslationsOptions): Loade
 
   if (!existsSync(fullTranslationDir)) {
     console.warn(`[i18n] Translation directory not found: ${fullTranslationDir}`)
-    return { general: {}, routes: {} }
+    return { root: {}, routes: {} }
   }
 
-  const general: Record<string, Translations> = {}
+  const root: Record<string, Translations> = {}
   const routes: Record<string, Record<string, Translations>> = {}
 
   /**
@@ -84,8 +84,8 @@ export function loadTranslationsFromDir(options: LoadTranslationsOptions): Loade
             }
             routes[routePrefix][locale] = translations
           } else {
-            // General translation
-            general[locale] = translations
+            // Root-level translation
+            root[locale] = translations
           }
         } catch (error) {
           console.error(`[i18n] Failed to load translation file: ${fullPath}`, error)
@@ -96,7 +96,7 @@ export function loadTranslationsFromDir(options: LoadTranslationsOptions): Loade
 
   loadFiles(fullTranslationDir)
 
-  return { general, routes }
+  return { root, routes }
 }
 
 /**
@@ -112,17 +112,18 @@ export function loadTranslationsIntoI18n(
   },
   options: LoadTranslationsOptions,
 ): void {
-  const { general, routes } = loadTranslationsFromDir(options)
+  const { root, routes } = loadTranslationsFromDir(options)
 
-  // Load general translations
-  for (const [locale, translations] of Object.entries(general)) {
+  // Load root-level translations as index
+  for (const [locale, translations] of Object.entries(root)) {
     i18n.addTranslations(locale, translations, false)
   }
 
-  // Load route-specific translations
+  // Load route-specific translations (with root baked in)
   for (const [routeName, routeTranslations] of Object.entries(routes)) {
     for (const [locale, translations] of Object.entries(routeTranslations)) {
-      i18n.addRouteTranslations(locale, routeName, translations, false)
+      const base = root[locale] || {}
+      i18n.addRouteTranslations(locale, routeName, { ...base, ...translations }, false)
     }
   }
 }

package/src/middleware.ts

@@ -21,7 +21,7 @@ export interface I18nMiddlewareOptions {
  */
 export function createI18nMiddleware(options: I18nMiddlewareOptions): MiddlewareHandler {
   const {
-    i18n: globalI18n, // Это глобальный синглтон с кэшем
+    i18n: globalI18n, // This is the global singleton with cache
     defaultLocale,
     locales,
     localeObjects,
@@ -93,7 +93,7 @@ export function createI18nMiddleware(options: I18nMiddlewareOptions): Middleware
     const requestI18n = globalI18n.clone(detectedLocale)
 
     // 4. Set route name using routing strategy
-    const routeName = contextStrategy.getRouteName ? contextStrategy.getRouteName(pathname, locales) : 'general'
+    const routeName = contextStrategy.getRouteName ? contextStrategy.getRouteName(pathname, locales) : 'index'
     requestI18n.setRoute(routeName)
 
     // 5. Store in locals (Type-safe now thanks to astro-shim.d.ts)

package/src/routing.ts

@@ -3,7 +3,7 @@
  * Extracts route name from path (e.g., /en/about -> about)
  */
 export function getRouteName(path: string, locales: string[] = []): string {
-  // Нормализуем путь
+  // Normalize the path
   const cleanPath = path.replace(/^\//, '').replace(/\/$/, '')
 
   if (!cleanPath) {

package/src/utils.ts

@@ -179,9 +179,6 @@ export function useI18n(astro: AstroGlobal) {
     mergeTranslations: (locale: string, routeName: string, translations: Record<string, unknown>): void => {
       i18n.mergeTranslations(locale, routeName, translations)
     },
-    mergeGlobalTranslations: (locale: string, translations: Record<string, unknown>): void => {
-      i18n.mergeGlobalTranslations(locale, translations)
-    },
     clearCache: (): void => {
       i18n.clearCache()
     },
@@ -312,7 +309,7 @@ export function useLocaleHead(astro: AstroGlobal, options: LocaleHeadOptions = {
 }
 
 /**
- * Props для передачи в клиентские острова (Vue, React, Svelte, Preact)
+ * Props to pass to client islands (Vue, React, Svelte, Preact)
  */
 export interface I18nClientProps {
   locale: string
@@ -322,7 +319,7 @@ export interface I18nClientProps {
 }
 
 /**
- * Создает вложенную структуру из ключа (например, 'islands.vue.title' -> { islands: { vue: { title: value } } })
+ * Creates a nested structure from a key (e.g. 'islands.vue.title' -> { islands: { vue: { title: value } } })
  */
 function setNestedValue(obj: Translations, key: string, value: unknown): void {
   const parts = key.split('.')
@@ -341,30 +338,30 @@ function setNestedValue(obj: Translations, key: string, value: unknown): void {
 }
 
 /**
- * Подготавливает пропсы для передачи в клиентский остров.
- * Принимает список ключей, которые нужно передать в остров.
- * Использует методы i18n для правильной работы с routesLocaleLinks.
- * currentRoute уже нормализован через middleware (getRouteName), поэтому используем его напрямую.
+ * Prepares props to pass to a client island.
+ * Accepts a list of keys to pass to the island.
+ * Uses i18n methods for proper routesLocaleLinks support.
+ * currentRoute is already normalized via middleware (getRouteName), so we use it directly.
  */
 export function getI18nProps(astro: AstroGlobal, keys?: string[]): I18nClientProps {
   const i18n = getI18n(astro)
   const locale = getLocale(astro)
   const fallbackLocale = getDefaultLocale(astro)
-  // currentRoute уже нормализован через middleware.setRoute(getRouteName(...))
-  // getRouteName учитывает routesLocaleLinks, если они настроены
+  // currentRoute is already normalized via middleware.setRoute(getRouteName(...))
+  // getRouteName takes routesLocaleLinks into account if configured
   const currentRoute = i18n.getRoute()
 
   const translations: Record<string, Translations> = {}
 
-  // Если указаны ключи, извлекаем только их из кэша
+  // If keys are specified, extract only those from cache
   if (keys && keys.length > 0) {
     const extracted: Translations = {}
 
-    // Используем методы i18n для получения переводов
-    // Это гарантирует правильную работу с routesLocaleLinks
+    // Use i18n methods to get translations
+    // This guarantees proper routesLocaleLinks support
     for (const key of keys) {
-      // Используем i18n.t() который использует helper.getTranslation внутри
-      // и правильно резолвит ключ кэша с учетом routesLocaleLinks
+      // Use i18n.t() which internally uses helper.getTranslation
+      // and properly resolves the cache key considering routesLocaleLinks
       const value = i18n.t(key, undefined, undefined, currentRoute)
       if (value !== null && value !== undefined && value !== key) {
         setNestedValue(extracted, key, value)
@@ -375,8 +372,8 @@ export function getI18nProps(astro: AstroGlobal, keys?: string[]): I18nClientPro
       translations[currentRoute] = extracted
     }
   } else {
-    // Если ключи не указаны, берем route-specific переводы
-    // Используем публичный метод getRouteTranslations для безопасного доступа
+    // If no keys specified, get route-specific translations
+    // Use the public getRouteTranslations method for safe access
     const routeTrans = i18n.getRouteTranslations(locale, currentRoute)
     if (routeTrans) {
       translations[currentRoute] = routeTrans