@i18n-micro/astro 1.3.8 → 1.3.10

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("@i18n-micro/core"),E=require("node:async_hooks"),w=require("node:fs"),R=require("node:path"),B=require("@i18n-micro/utils/parse-path"),z=require("@i18n-micro/utils/accept-language");class j extends T.BaseI18n{constructor(e){const o=e._storage||{translations:new Map};if(super({storage:o,plural:e.plural,missingWarn:e.missingWarn,missingHandler:e.missingHandler,numberFormats:e.numberFormats,datetimeFormats:e.datetimeFormats}),this.initialMessages={},this.storage=o,this._locale=e.locale,this._fallbackLocale=e.fallbackLocale||e.locale,this._currentRoute="index",e.messages){this.initialMessages={...e.messages};for(const[a,i]of Object.entries(e.messages))this.helper.loadTranslations(a,i)}}cloneStorage(e){const o=new Map;for(const[a,i]of e.translations)o.set(a,{...i});return{translations:o}}clone(e){const o=this.cloneStorage(this.storage);return new j({locale:e||this._locale,fallbackLocale:this._fallbackLocale,plural:this.pluralFunc,missingWarn:this.missingWarn,missingHandler:this.missingHandler,numberFormats:this.formatter.getNumberFormats(),datetimeFormats:this.formatter.getDateTimeFormats(),_storage:o})}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,o){const a=`${e}:${o}`;return this.storage.translations.get(a)??null}addTranslations(e,o,a=!0){super.loadTranslationsCore(e,o,a)}addRouteTranslations(e,o,a,i=!0){super.loadRouteTranslationsCore(e,o,a,i)}mergeTranslations(e,o,a){this.helper.mergeTranslation(e,o,a,!0)}clearCache(){const e={...this.initialMessages};if(super.clearCache(),Object.keys(e).length>0)for(const[o,a]of Object.entries(e))this.helper.loadTranslations(o,a)}}let N=null;const q=new E.AsyncLocalStorage;function D(){const t=q.getStore();return t!==void 0?t:N}function A(t){N=t}function M(t,e){return q.run(t,e)}function x(t){const{locale:e,fallbackLocale:o,translationDir:a,routingStrategy:i}=t;return A(i||null),{name:"@i18n-micro/astro",hooks:{"astro:config:setup":c=>{const{updateConfig:u}=c,s="virtual:i18n-micro/config",r=`\0${s}`,l={defaultLocale:e,fallbackLocale:o||e,locales:t.locales||[],localeCodes:(t.locales||[]).map(n=>n.code),translationDir:a||null,autoDetect:t.autoDetect??!0,redirectToDefault:t.redirectToDefault??!1,localeCookie:t.localeCookie===null?null:t.localeCookie||"i18n-locale",missingWarn:t.missingWarn??!1};u({vite:{plugins:[{name:"vite-plugin-i18n-micro-config",resolveId(n){if(n===s)return r},load(n){if(n===r)return`export const config = ${JSON.stringify(l)}`}}]}})},"astro:config:done":c=>{const{injectTypes:u}=c;u({filename:"i18n-micro-env.d.ts",content:`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const j=require("@i18n-micro/core"),G=require("node:async_hooks"),R=require("node:fs"),$=require("node:path"),M=require("@i18n-micro/utils/parse-path"),V=require("@i18n-micro/utils/accept-language");class v extends j.BaseI18n{constructor(e){const r=e._storage||{translations:new Map};if(super({storage:r,plural:e.plural,missingWarn:e.missingWarn,missingHandler:e.missingHandler,numberFormats:e.numberFormats,datetimeFormats:e.datetimeFormats}),this.initialMessages={},this.storage=r,this._locale=e.locale,this._fallbackLocale=e.fallbackLocale||e.locale,this._currentRoute="index",e.messages){this.initialMessages={...e.messages};for(const[l,c]of Object.entries(e.messages))this.helper.loadTranslations(l,c)}}cloneStorage(e){const r=new Map;for(const[l,c]of e.translations)r.set(l,{...c});return{translations:r}}clone(e){const r=this.cloneStorage(this.storage);return new v({locale:e||this._locale,fallbackLocale:this._fallbackLocale,plural:this.pluralFunc,missingWarn:this.missingWarn,missingHandler:this.missingHandler,numberFormats:this.formatter.getNumberFormats(),datetimeFormats:this.formatter.getDateTimeFormats(),_storage:r})}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,r){const l=`${e}:${r}`;return this.storage.translations.get(l)??null}addTranslations(e,r,l=!0){super.loadTranslationsCore(e,r,l)}addRouteTranslations(e,r,l,c=!0){super.loadRouteTranslationsCore(e,r,l,c)}mergeTranslations(e,r,l){this.helper.mergeTranslation(e,r,l,!0)}clearCache(){const e={...this.initialMessages};if(super.clearCache(),Object.keys(e).length>0)for(const[r,l]of Object.entries(e))this.helper.loadTranslations(r,l)}}let q=null;const W=new G.AsyncLocalStorage;function _(){const t=W.getStore();return t!==void 0?t:q}function U(t){q=t}function H(t,e){return W.run(t,e)}function J(t){const{locale:e,fallbackLocale:r,translationDir:l,routingStrategy:c}=t;return U(c||null),{name:"@i18n-micro/astro",hooks:{"astro:config:setup":u=>{const{updateConfig:i}=u,o="virtual:i18n-micro/config",s=`\0${o}`,a={defaultLocale:e,fallbackLocale:r||e,locales:t.locales||[],localeCodes:(t.locales||[]).map(n=>n.code),translationDir:l||null,autoDetect:t.autoDetect??!0,redirectToDefault:t.redirectToDefault??!1,localeCookie:t.localeCookie===null?null:t.localeCookie||"i18n-locale",missingWarn:t.missingWarn??!1};i({vite:{plugins:[{name:"vite-plugin-i18n-micro-config",resolveId(n){if(n===o)return s},load(n){if(n===s)return`export const config = ${JSON.stringify(a)}`}}]}})},"astro:config:done":u=>{const{injectTypes:i}=u;i({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 G(t){return new j(t)}function W(t,e){if(w.existsSync(t))for(const o of w.readdirSync(t)){const a=R.join(t,o);if(w.statSync(a).isDirectory()){W(a,e);continue}o.endsWith(".json")&&e(a)}}function U(t){const{translationDir:e,rootDir:o=process.cwd(),disablePageLocales:a=!1}=t,i=R.resolve(o,e);if(!w.existsSync(i))return console.warn(`[i18n] Translation directory not found: ${i}`),{root:{},routes:{}};const c={root:{},routes:{}};return W(i,u=>{const s=R.relative(i,u).split(R.sep).join("/");try{const r=w.readFileSync(u,"utf-8"),l=JSON.parse(r);B.storeLoadedTranslationFile(c,s,l,a)}catch(r){console.error(`[i18n] Failed to load translation file: ${u}`,r)}}),c}function V(t,e){const{root:o,routes:a}=U(e);for(const[i,c]of Object.entries(o))t.addTranslations(i,c,!1);for(const[i,c]of Object.entries(a))for(const[u,s]of Object.entries(c))t.addRouteTranslations(u,i,B.mergeRouteTranslationsWithRoot(o[u],s),!1)}function J(t){const{i18n:e,defaultLocale:o,locales:a,localeObjects:i,autoDetect:c=!0,redirectToDefault:u=!1,routingStrategy:s}=t,r=s||D();return async(l,n)=>{if(l.locals.locale&&l.locals.i18n)return n();const f=l.url,d=f.pathname;if(!r){const b=e.clone(o),y=d==="/"||d===""?"index":d.split("/").filter(Boolean).join("-");return b.setRoute(y),l.locals.i18n=b,l.locals.locale=o,l.locals.defaultLocale=o,l.locals.locales=i||a.map(S=>({code:S})),l.locals.currentUrl=f,n()}const h={...r,getCurrentPath:()=>d,getRoute:()=>({fullPath:f.pathname+f.search,query:Object.fromEntries(f.searchParams)})},p=d.split("/").filter(Boolean)[0],P=p!==void 0&&a.includes(p);let L;P&&p?L=p:h.getLocaleFromPath?L=h.getLocaleFromPath(d,o,a):L=o;const k=e.clone(L),g=h.getRouteName?h.getRouteName(d,a):"index";return k.setRoute(g),l.locals.i18n=k,l.locals.locale=L,l.locals.defaultLocale=o,l.locals.locales=i||a.map(b=>({code:b})),l.locals.currentUrl=f,l.locals.routingStrategy=h,M(h,()=>n())}}function K(t,e,o,a,i,c="i18n-locale",u){const s=u??D();let r=a;if(s?.getLocaleFromPath)r=s.getLocaleFromPath(t,a,i);else{const n=t.split("/").filter(Boolean)[0];n&&i.includes(n)&&(r=n)}if(c!==null&&r===a&&e.get(c)){const l=e.get(c)?.value;l&&i.includes(l)&&(r=l)}if(r===a)try{const l=z.detectLocaleFromAcceptLanguage(o.get("accept-language")??void 0,i);l&&(r=l)}catch{}return r}function Z(t,e,o){const a=t.map(n=>n.code),i=(n,f=[])=>{const d=n.replace(/^\//,"").replace(/\/$/,"");if(!d)return"index";const h=d.split("/").filter(Boolean),m=h[0];return m&&f.includes(m)&&h.shift(),h.length===0?"index":h.join("-")},c=(n,f="en",d=[])=>{const m=n.split("/").filter(Boolean)[0];return m&&d.includes(m)?m:f},u=(n,f,d=[],h)=>{const m=n.split("/").filter(Boolean),p=m[0];return p&&d.includes(p)&&m.shift(),(f!==h||h===void 0)&&m.unshift(f),`/${m.join("/")}`},s=(n,f,d=[],h)=>{const p=(n.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),P=p[0];return P&&d.includes(P)&&p.shift(),(f!==h||h===void 0)&&p.unshift(f),`/${p.join("/")}`};return{getCurrentPath:()=>o?o().pathname:typeof window<"u"?window.location.pathname:"/",getRouteName:i,getLocaleFromPath:c,switchLocalePath:u,localizePath:s,removeLocaleFromPath:(n,f=[])=>{const d=n.split("/").filter(Boolean),h=d[0];return h&&f.includes(h)&&d.shift(),`/${d.join("/")}`},resolvePath:(n,f)=>{const d=typeof n=="string"?n:n.path||"/";return s(d,f,a,e)},getRoute:()=>{if(o){const n=o();return{fullPath:n.pathname+n.search,query:Object.fromEntries(n.searchParams)}}if(typeof window<"u"){const n=new URL(window.location.href);return{fullPath:n.pathname+n.search,query:Object.fromEntries(n.searchParams)}}return{fullPath:"/",query:{}}},push:n=>{typeof window<"u"&&(window.location.href=n.path)},replace:n=>{typeof window<"u"&&window.location.replace(n.path)}}}function F(t){const e=t.og?.trim();if(e)return e;const o=t.iso?.trim();if(!o)return null;const a=o.indexOf("_");if(a>0){const c=o.slice(0,a),u=o.slice(a+1);if(c.length>=2&&u.length===2)return`${c.toLowerCase()}_${u.toUpperCase()}`}const i=o.indexOf("-");if(i>0){const c=o.slice(0,i),u=o.slice(i+1);if(c.length>=2&&u.length===2&&/^[A-Za-z]{2}$/.test(u))return`${c.toLowerCase()}_${u.toUpperCase()}`}return null}function C(t,e={}){if(F(t)!==null||e.missingWarn===!1||process.env.NODE_ENV==="production")return;const o=e.tag??"og:locale",a=String(t.code??"unknown"),i=t.iso?`, iso: '${t.iso}'`:"";console.warn(`[i18n] Cannot derive ${o} for locale '${a}'${i}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`)}function I(t){const e=t.locals.i18n;if(!e)throw new Error("i18n instance not found. Make sure i18n middleware is configured.");return e}function v(t){return t.locals.locale||"en"}function $(t){return t.locals.defaultLocale||"en"}function _(t){return t.locals.locales||[]}function H(t){return t.locals.routingStrategy||null}function Q(t){const e=I(t),o=v(t),a=$(t),i=_(t),c=i.map(s=>s.code),u=H(t);return{locale:o,defaultLocale:a,locales:i,t:(s,r,l,n)=>e.t(s,r,l,n),ts:(s,r,l,n)=>e.ts(s,r,l,n),tc:(s,r,l)=>e.tc(s,r,l),tn:e.tn.bind(e),td:e.td.bind(e),tdr:e.tdr.bind(e),has:(s,r)=>e.has(s,r),getRoute:()=>e.getRoute(),getRouteName:s=>{const r=s||t.url.pathname;if(u?.getRouteName)return u.getRouteName(r,c);const l=r.replace(/^\//,"").replace(/\/$/,"");if(!l)return"index";const n=l.split("/").filter(Boolean),f=n[0];return f&&c.includes(f)&&n.shift(),n.length===0?"index":n.join("-")},getLocaleFromPath:s=>{const r=s||t.url.pathname;if(u?.getLocaleFromPath)return u.getLocaleFromPath(r,a,c);const n=r.split("/").filter(Boolean)[0];return n&&c.includes(n)?n:a},switchLocalePath:s=>{if(u?.switchLocalePath)return u.switchLocalePath(t.url.pathname,s,c,a);const r=t.url.pathname.split("/").filter(Boolean),l=r[0];return l&&c.includes(l)&&r.shift(),s!==a&&r.unshift(s),`/${r.join("/")}`},localizePath:(s,r)=>{if(u?.localizePath)return u.localizePath(s,r||o,c,a);const n=(s.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),f=n[0];return f&&c.includes(f)&&n.shift(),r&&r!==a&&n.unshift(r),`/${n.join("/")}`},getI18n:()=>e,getBasePath:s=>{const n=(s||t.url).pathname.split("/").filter(Boolean),f=n[0];return f&&c.includes(f)&&n.shift(),n.length>0?`/${n.join("/")}`:"/"},addTranslations:(s,r,l=!0)=>{e.addTranslations(s,r,l)},addRouteTranslations:(s,r,l,n=!0)=>{e.addRouteTranslations(s,r,l,n)},mergeTranslations:(s,r,l)=>{e.mergeTranslations(s,r,l)},clearCache:()=>{e.clearCache()}}}function X(t,e={}){const{baseUrl:o="/",addDirAttribute:a=!0,addSeoAttributes:i=!0}=e,c=v(t),u=$(t),r=_(t).filter(g=>!g.disabled),l=r.filter(g=>g.seo!==!1),n=r.find(g=>g.code===c);if(!n)return{htmlAttrs:{},link:[],meta:[]};const f=n.iso||c,d=F(n),h=n.dir||"auto",m={htmlAttrs:{lang:f,...a?{dir:h}:{}},link:[],meta:[]};if(!i)return m;const p=`${o}${t.url.pathname}`;m.link.push({rel:"canonical",href:p});const P=H(t),L=r.map(g=>g.code);for(const g of l){let b=t.url.pathname;if(P?.switchLocalePath)b=P.switchLocalePath(t.url.pathname,g.code,L,u);else{const S=t.url.pathname.split("/").filter(Boolean),O=S[0];O&&L.includes(O)&&S.shift(),g.code!==u&&S.unshift(g.code),b=`/${S.join("/")}`}const y=`${o}${b}`;m.link.push({rel:"alternate",href:y,hreflang:g.code}),g.iso&&g.iso!==g.code&&m.link.push({rel:"alternate",href:y,hreflang:g.iso})}if(r.find(g=>g.code===u)?.seo!==!1){let g=t.url.pathname;if(P?.switchLocalePath)g=P.switchLocalePath(t.url.pathname,u,L,u);else{const b=t.url.pathname.split("/").filter(Boolean),y=b[0];y&&L.includes(y)&&b.shift(),g=`/${b.join("/")}`}m.link.push({rel:"alternate",href:`${o}${g}`,hreflang:"x-default"})}d?m.meta.push({property:"og:locale",content:d}):C(n,{tag:"og:locale"}),m.meta.push({property:"og:url",content:p});for(const g of l){if(g.code===c)continue;const b=F(g);if(!b){C(g,{tag:"og:locale:alternate"});continue}m.meta.push({property:"og:locale:alternate",content:b})}return m}function Y(t,e,o){const a=e.split(".");let i=t;for(let u=0;u<a.length-1;u++){const s=a[u];i[s]||(i[s]={}),i=i[s]}const c=a[a.length-1];c!==void 0&&(i[c]=o)}function ee(t,e){const o=I(t),a=v(t),i=$(t),c=o.getRoute(),u={};if(e&&e.length>0){const s={};for(const r of e){const l=o.t(r,void 0,void 0,c);l!=null&&l!==r&&Y(s,r,l)}Object.keys(s).length>0&&(u[c]=s)}else{const s=o.getRouteTranslations(a,c);s&&(u[c]=s)}return{locale:a,fallbackLocale:i,currentRoute:c,translations:u}}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=G;exports.createI18nMiddleware=J;exports.detectLocale=K;exports.getDefaultLocale=$;exports.getGlobalRoutingStrategy=D;exports.getI18n=I;exports.getI18nProps=ee;exports.getLocale=v;exports.getLocales=_;exports.i18nIntegration=x;exports.loadTranslationsFromDir=U;exports.loadTranslationsIntoI18n=V;exports.runWithRoutingStrategy=M;exports.setGlobalRoutingStrategy=A;exports.useI18n=Q;exports.useLocaleHead=X;
+          `})}}}}function Z(t){return new v(t)}function z(t,e){if(R.existsSync(t))for(const r of R.readdirSync(t)){const l=$.join(t,r);if(R.statSync(l).isDirectory()){z(l,e);continue}r.endsWith(".json")&&e(l)}}function E(t){const{translationDir:e,rootDir:r=process.cwd(),disablePageLocales:l=!1}=t,c=$.resolve(r,e);if(!R.existsSync(c))return console.warn(`[i18n] Translation directory not found: ${c}`),{root:{},routes:{}};const u={root:{},routes:{}};return z(c,i=>{const o=$.relative(c,i).split($.sep).join("/");try{const s=R.readFileSync(i,"utf-8"),a=JSON.parse(s);M.storeLoadedTranslationFile(u,o,a,l)}catch(s){console.error(`[i18n] Failed to load translation file: ${i}`,s)}}),u}function K(t,e){const{root:r,routes:l}=E(e);for(const[c,u]of Object.entries(r))t.addTranslations(c,u,!1);for(const[c,u]of Object.entries(l))for(const[i,o]of Object.entries(u))t.addRouteTranslations(i,c,M.mergeRouteTranslationsWithRoot(r[i],o),!1)}function Q(t){const{i18n:e,defaultLocale:r,locales:l,localeObjects:c,autoDetect:u=!0,redirectToDefault:i=!1,routingStrategy:o}=t,s=o||_();return async(a,n)=>{if(a.locals.locale&&a.locals.i18n)return n();const f=a.url,d=f.pathname;if(!s){const w=e.clone(r),g=d==="/"||d===""?"index":d.split("/").filter(Boolean).join("-");return w.setRoute(g),a.locals.i18n=w,a.locals.locale=r,a.locals.defaultLocale=r,a.locals.locales=c||l.map(L=>({code:L})),a.locals.currentUrl=f,n()}const h={...s,getCurrentPath:()=>d,getRoute:()=>({fullPath:f.pathname+f.search,query:Object.fromEntries(f.searchParams)})},m=d.split("/").filter(Boolean)[0],P=m!==void 0&&l.includes(m);let S;P&&m?S=m:h.getLocaleFromPath?S=h.getLocaleFromPath(d,r,l):S=r;const y=e.clone(S),T=h.getRouteName?h.getRouteName(d,l):"index";return y.setRoute(T),a.locals.i18n=y,a.locals.locale=S,a.locals.defaultLocale=r,a.locals.locales=c||l.map(w=>({code:w})),a.locals.currentUrl=f,a.locals.routingStrategy=h,H(h,()=>n())}}function X(t,e,r,l,c,u="i18n-locale",i){const o=i??_();let s=l;if(o?.getLocaleFromPath)s=o.getLocaleFromPath(t,l,c);else{const n=t.split("/").filter(Boolean)[0];n&&c.includes(n)&&(s=n)}if(u!==null&&s===l&&e.get(u)){const a=e.get(u)?.value;a&&c.includes(a)&&(s=a)}if(s===l)try{const a=V.detectLocaleFromAcceptLanguage(r.get("accept-language")??void 0,c);a&&(s=a)}catch{}return s}function Y(t,e,r){const l=t.map(n=>n.code),c=(n,f=[])=>{const d=n.replace(/^\//,"").replace(/\/$/,"");if(!d)return"index";const h=d.split("/").filter(Boolean),p=h[0];return p&&f.includes(p)&&h.shift(),h.length===0?"index":h.join("-")},u=(n,f="en",d=[])=>{const p=n.split("/").filter(Boolean)[0];return p&&d.includes(p)?p:f},i=(n,f,d=[],h)=>{const p=n.split("/").filter(Boolean),m=p[0];return m&&d.includes(m)&&p.shift(),(f!==h||h===void 0)&&p.unshift(f),`/${p.join("/")}`},o=(n,f,d=[],h)=>{const m=(n.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),P=m[0];return P&&d.includes(P)&&m.shift(),(f!==h||h===void 0)&&m.unshift(f),`/${m.join("/")}`};return{getCurrentPath:()=>r?r().pathname:typeof window<"u"?window.location.pathname:"/",getRouteName:c,getLocaleFromPath:u,switchLocalePath:i,localizePath:o,removeLocaleFromPath:(n,f=[])=>{const d=n.split("/").filter(Boolean),h=d[0];return h&&f.includes(h)&&d.shift(),`/${d.join("/")}`},resolvePath:(n,f)=>{const d=typeof n=="string"?n:n.path||"/";return o(d,f,l,e)},getRoute:()=>{if(r){const n=r();return{fullPath:n.pathname+n.search,query:Object.fromEntries(n.searchParams)}}if(typeof window<"u"){const n=new URL(window.location.href);return{fullPath:n.pathname+n.search,query:Object.fromEntries(n.searchParams)}}return{fullPath:"/",query:{}}},push:n=>{typeof window<"u"&&(window.location.href=n.path)},replace:n=>{typeof window<"u"&&window.location.replace(n.path)}}}function D(t){return t.iso?.trim()||String(t.code)}function N(t){const e=t.match(/^([A-Za-z]{2,3})(?:[-_](.+))?$/);return e?{language:e[1],region:e[2]}:{language:t}}function ee(t,e={}){const{hreflangBaseLanguage:r=!1}=e;if(!r)return t.map(i=>{const o=String(i.code);return{hreflang:D(i),localeCode:o}});const l=new Map;for(const i of t){const o=String(i.code),s=D(i),{language:a,region:n}=N(s);a&&n&&!l.has(a)&&l.set(a,o),l.set(s,o)}const c=new Set,u=[];for(const i of t){const o=String(i.code),s=D(i),{language:a,region:n}=N(s);a&&n&&l.get(a)===o&&!c.has(a)&&(c.add(a),u.push({hreflang:a,localeCode:o})),c.has(s)||(c.add(s),u.push({hreflang:s,localeCode:o}))}return u}function I(t){const e=t.og?.trim();if(e)return e;const r=t.iso?.trim();if(!r)return null;const l=r.indexOf("_");if(l>0){const u=r.slice(0,l),i=r.slice(l+1);if(u.length>=2&&i.length===2)return`${u.toLowerCase()}_${i.toUpperCase()}`}const c=r.indexOf("-");if(c>0){const u=r.slice(0,c),i=r.slice(c+1);if(u.length>=2&&i.length===2&&/^[A-Za-z]{2}$/.test(i))return`${u.toLowerCase()}_${i.toUpperCase()}`}return null}function A(t,e={}){if(I(t)!==null||e.missingWarn===!1||process.env.NODE_ENV==="production")return;const r=e.tag??"og:locale",l=String(t.code??"unknown"),c=t.iso?`, iso: '${t.iso}'`:"";console.warn(`[i18n] Cannot derive ${r} for locale '${l}'${c}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`)}function O(t){const e=t.locals.i18n;if(!e)throw new Error("i18n instance not found. Make sure i18n middleware is configured.");return e}function F(t){return t.locals.locale||"en"}function k(t){return t.locals.defaultLocale||"en"}function C(t){return t.locals.locales||[]}function x(t){return t.locals.routingStrategy||null}function te(t){const e=O(t),r=F(t),l=k(t),c=C(t),u=c.map(o=>o.code),i=x(t);return{locale:r,defaultLocale:l,locales:c,t:(o,s,a,n)=>e.t(o,s,a,n),ts:(o,s,a,n)=>e.ts(o,s,a,n),tc:(o,s,a)=>e.tc(o,s,a),tn:e.tn.bind(e),td:e.td.bind(e),tdr:e.tdr.bind(e),has:(o,s)=>e.has(o,s),getRoute:()=>e.getRoute(),getRouteName:o=>{const s=o||t.url.pathname;if(i?.getRouteName)return i.getRouteName(s,u);const a=s.replace(/^\//,"").replace(/\/$/,"");if(!a)return"index";const n=a.split("/").filter(Boolean),f=n[0];return f&&u.includes(f)&&n.shift(),n.length===0?"index":n.join("-")},getLocaleFromPath:o=>{const s=o||t.url.pathname;if(i?.getLocaleFromPath)return i.getLocaleFromPath(s,l,u);const n=s.split("/").filter(Boolean)[0];return n&&u.includes(n)?n:l},switchLocalePath:o=>{if(i?.switchLocalePath)return i.switchLocalePath(t.url.pathname,o,u,l);const s=t.url.pathname.split("/").filter(Boolean),a=s[0];return a&&u.includes(a)&&s.shift(),o!==l&&s.unshift(o),`/${s.join("/")}`},localizePath:(o,s)=>{if(i?.localizePath)return i.localizePath(o,s||r,u,l);const n=(o.replace(/^\//,"").replace(/\/$/,"")||"").split("/").filter(Boolean),f=n[0];return f&&u.includes(f)&&n.shift(),s&&s!==l&&n.unshift(s),`/${n.join("/")}`},getI18n:()=>e,getBasePath:o=>{const n=(o||t.url).pathname.split("/").filter(Boolean),f=n[0];return f&&u.includes(f)&&n.shift(),n.length>0?`/${n.join("/")}`:"/"},addTranslations:(o,s,a=!0)=>{e.addTranslations(o,s,a)},addRouteTranslations:(o,s,a,n=!0)=>{e.addRouteTranslations(o,s,a,n)},mergeTranslations:(o,s,a)=>{e.mergeTranslations(o,s,a)},clearCache:()=>{e.clearCache()}}}function ne(t,e={}){const{baseUrl:r="/",addDirAttribute:l=!0,addSeoAttributes:c=!0,hreflangBaseLanguage:u=!1}=e,i=F(t),o=k(t),a=C(t).filter(g=>!g.disabled),n=a.filter(g=>g.seo!==!1),f=a.find(g=>g.code===i);if(!f)return{htmlAttrs:{},link:[],meta:[]};const d=f.iso||i,h=I(f),p=f.dir||"auto",m={htmlAttrs:{lang:d,...l?{dir:p}:{}},link:[],meta:[]};if(!c)return m;const P=`${r}${t.url.pathname}`;m.link.push({rel:"canonical",href:P});const S=x(t),y=a.map(g=>g.code),T=new Map;for(const g of n){let L=t.url.pathname;if(S?.switchLocalePath)L=S.switchLocalePath(t.url.pathname,g.code,y,o);else{const b=t.url.pathname.split("/").filter(Boolean),B=b[0];B&&y.includes(B)&&b.shift(),g.code!==o&&b.unshift(g.code),L=`/${b.join("/")}`}T.set(String(g.code),`${r}${L}`)}for(const{hreflang:g,localeCode:L}of ee(n,{hreflangBaseLanguage:u})){const b=T.get(L);b&&m.link.push({rel:"alternate",href:b,hreflang:g})}if(a.find(g=>g.code===o)?.seo!==!1){let g=t.url.pathname;if(S?.switchLocalePath)g=S.switchLocalePath(t.url.pathname,o,y,o);else{const L=t.url.pathname.split("/").filter(Boolean),b=L[0];b&&y.includes(b)&&L.shift(),g=`/${L.join("/")}`}m.link.push({rel:"alternate",href:`${r}${g}`,hreflang:"x-default"})}h?m.meta.push({property:"og:locale",content:h}):A(f,{tag:"og:locale"}),m.meta.push({property:"og:url",content:P});for(const g of n){if(g.code===i)continue;const L=I(g);if(!L){A(g,{tag:"og:locale:alternate"});continue}m.meta.push({property:"og:locale:alternate",content:L})}return m}function oe(t,e,r){const l=e.split(".");let c=t;for(let i=0;i<l.length-1;i++){const o=l[i];c[o]||(c[o]={}),c=c[o]}const u=l[l.length-1];u!==void 0&&(c[u]=r)}function ae(t,e){const r=O(t),l=F(t),c=k(t),u=r.getRoute(),i={};if(e&&e.length>0){const o={};for(const s of e){const a=r.t(s,void 0,void 0,u);a!=null&&a!==s&&oe(o,s,a)}Object.keys(o).length>0&&(i[u]=o)}else{const o=r.getRouteTranslations(l,u);o&&(i[u]=o)}return{locale:l,fallbackLocale:c,currentRoute:u,translations:i}}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=v;exports.createAstroRouterAdapter=Y;exports.createI18n=Z;exports.createI18nMiddleware=Q;exports.detectLocale=X;exports.getDefaultLocale=k;exports.getGlobalRoutingStrategy=_;exports.getI18n=O;exports.getI18nProps=ae;exports.getLocale=F;exports.getLocales=C;exports.i18nIntegration=J;exports.loadTranslationsFromDir=E;exports.loadTranslationsIntoI18n=K;exports.runWithRoutingStrategy=H;exports.setGlobalRoutingStrategy=U;exports.useI18n=te;exports.useLocaleHead=ne;

package/dist/index.mjs

@@ -1,37 +1,37 @@
-import { BaseI18n as W } from "@i18n-micro/core";
-import { FormatService as pe, defaultPlural as Le, interpolate as Pe } from "@i18n-micro/core";
-import { AsyncLocalStorage as A } from "node:async_hooks";
-import { existsSync as F, readdirSync as M, statSync as U, readFileSync as q } from "node:fs";
-import { resolve as E, join as H, relative as x, sep as z } from "node:path";
-import { mergeRouteTranslationsWithRoot as V, storeLoadedTranslationFile as G } from "@i18n-micro/utils/parse-path";
-import { detectLocaleFromAcceptLanguage as J } from "@i18n-micro/utils/accept-language";
-class T extends W {
+import { BaseI18n as U } from "@i18n-micro/core";
+import { FormatService as be, defaultPlural as ye, interpolate as we } from "@i18n-micro/core";
+import { AsyncLocalStorage as q } from "node:async_hooks";
+import { existsSync as _, readdirSync as z, statSync as E, readFileSync as H } from "node:fs";
+import { resolve as x, join as V, relative as G, sep as J } from "node:path";
+import { mergeRouteTranslationsWithRoot as Z, storeLoadedTranslationFile as K } from "@i18n-micro/utils/parse-path";
+import { detectLocaleFromAcceptLanguage as Q } from "@i18n-micro/utils/accept-language";
+class v extends U {
   constructor(e) {
-    const o = e._storage || {
+    const r = e._storage || {
       translations: /* @__PURE__ */ new Map()
     };
     if (super({
-      storage: o,
+      storage: r,
       plural: e.plural,
       missingWarn: e.missingWarn,
       missingHandler: e.missingHandler,
       numberFormats: e.numberFormats,
       datetimeFormats: e.datetimeFormats
-    }), this.initialMessages = {}, this.storage = o, this._locale = e.locale, this._fallbackLocale = e.fallbackLocale || e.locale, this._currentRoute = "index", e.messages) {
+    }), this.initialMessages = {}, this.storage = r, this._locale = e.locale, this._fallbackLocale = e.fallbackLocale || e.locale, this._currentRoute = "index", e.messages) {
       this.initialMessages = { ...e.messages };
-      for (const [a, i] of Object.entries(e.messages))
-        this.helper.loadTranslations(a, i);
+      for (const [l, c] of Object.entries(e.messages))
+        this.helper.loadTranslations(l, c);
     }
   }
   cloneStorage(e) {
-    const o = /* @__PURE__ */ new Map();
-    for (const [a, i] of e.translations)
-      o.set(a, { ...i });
-    return { translations: o };
+    const r = /* @__PURE__ */ new Map();
+    for (const [l, c] of e.translations)
+      r.set(l, { ...c });
+    return { translations: r };
   }
   clone(e) {
-    const o = this.cloneStorage(this.storage);
-    return new T({
+    const r = this.cloneStorage(this.storage);
+    return new v({
       locale: e || this._locale,
       fallbackLocale: this._fallbackLocale,
       plural: this.pluralFunc,
@@ -39,7 +39,7 @@ class T extends W {
       missingHandler: this.missingHandler,
       numberFormats: this.formatter.getNumberFormats(),
       datetimeFormats: this.formatter.getDateTimeFormats(),
-      _storage: o
+      _storage: r
     });
   }
   get locale() {
@@ -66,68 +66,68 @@ class T extends W {
   getRoute() {
     return this._currentRoute;
   }
-  getRouteTranslations(e, o) {
-    const a = `${e}:${o}`;
-    return this.storage.translations.get(a) ?? null;
+  getRouteTranslations(e, r) {
+    const l = `${e}:${r}`;
+    return this.storage.translations.get(l) ?? null;
   }
-  addTranslations(e, o, a = !0) {
-    super.loadTranslationsCore(e, o, a);
+  addTranslations(e, r, l = !0) {
+    super.loadTranslationsCore(e, r, l);
   }
-  addRouteTranslations(e, o, a, i = !0) {
-    super.loadRouteTranslationsCore(e, o, a, i);
+  addRouteTranslations(e, r, l, c = !0) {
+    super.loadRouteTranslationsCore(e, r, l, c);
   }
-  mergeTranslations(e, o, a) {
-    this.helper.mergeTranslation(e, o, a, !0);
+  mergeTranslations(e, r, l) {
+    this.helper.mergeTranslation(e, r, l, !0);
   }
   clearCache() {
     const e = { ...this.initialMessages };
     if (super.clearCache(), Object.keys(e).length > 0)
-      for (const [o, a] of Object.entries(e))
-        this.helper.loadTranslations(o, a);
+      for (const [r, l] of Object.entries(e))
+        this.helper.loadTranslations(r, l);
   }
 }
-let D = null;
-const _ = new A();
-function O() {
-  const t = _.getStore();
-  return t !== void 0 ? t : D;
+let B = null;
+const O = new q();
+function I() {
+  const t = O.getStore();
+  return t !== void 0 ? t : B;
 }
-function K(t) {
-  D = t;
+function X(t) {
+  B = t;
 }
-function Z(t, e) {
-  return _.run(t, e);
+function Y(t, e) {
+  return O.run(t, e);
 }
-function le(t) {
-  const { locale: e, fallbackLocale: o, translationDir: a, routingStrategy: i } = t;
-  return K(i || null), {
+function ce(t) {
+  const { locale: e, fallbackLocale: r, translationDir: l, routingStrategy: c } = t;
+  return X(c || null), {
     name: "@i18n-micro/astro",
     hooks: {
       // 1. Vite setup (virtual module) happens here
-      "astro:config:setup": (c) => {
-        const { updateConfig: u } = c, s = "virtual:i18n-micro/config", l = `\0${s}`, r = {
+      "astro:config:setup": (u) => {
+        const { updateConfig: i } = u, o = "virtual:i18n-micro/config", s = `\0${o}`, a = {
           defaultLocale: e,
-          fallbackLocale: o || e,
+          fallbackLocale: r || e,
           locales: t.locales || [],
           localeCodes: (t.locales || []).map((n) => n.code),
-          translationDir: a || null,
+          translationDir: l || null,
           autoDetect: t.autoDetect ?? !0,
           redirectToDefault: t.redirectToDefault ?? !1,
           localeCookie: t.localeCookie === null ? null : t.localeCookie || "i18n-locale",
           missingWarn: t.missingWarn ?? !1
         };
-        u({
+        i({
           vite: {
             plugins: [
               {
                 name: "vite-plugin-i18n-micro-config",
                 resolveId(n) {
-                  if (n === s)
-                    return l;
+                  if (n === o)
+                    return s;
                 },
                 load(n) {
-                  if (n === l)
-                    return `export const config = ${JSON.stringify(r)}`;
+                  if (n === s)
+                    return `export const config = ${JSON.stringify(a)}`;
                 }
               }
             ]
@@ -135,9 +135,9 @@ function le(t) {
         });
       },
       // 2. Type injection happens here (per Astro documentation)
-      "astro:config:done": (c) => {
-        const { injectTypes: u } = c;
-        u({
+      "astro:config:done": (u) => {
+        const { injectTypes: i } = u;
+        i({
           filename: "i18n-micro-env.d.ts",
           content: `
             /// <reference types="@i18n-micro/astro/env" />
@@ -161,131 +161,131 @@ function le(t) {
     }
   };
 }
-function re(t) {
-  return new T(t);
+function ue(t) {
+  return new v(t);
 }
-function C(t, e) {
-  if (F(t))
-    for (const o of M(t)) {
-      const a = H(t, o);
-      if (U(a).isDirectory()) {
-        C(a, e);
+function N(t, e) {
+  if (_(t))
+    for (const r of z(t)) {
+      const l = V(t, r);
+      if (E(l).isDirectory()) {
+        N(l, e);
         continue;
       }
-      o.endsWith(".json") && e(a);
+      r.endsWith(".json") && e(l);
     }
 }
-function Q(t) {
-  const { translationDir: e, rootDir: o = process.cwd(), disablePageLocales: a = !1 } = t, i = E(o, e);
-  if (!F(i))
-    return console.warn(`[i18n] Translation directory not found: ${i}`), { root: {}, routes: {} };
-  const c = { root: {}, routes: {} };
-  return C(i, (u) => {
-    const s = x(i, u).split(z).join("/");
+function ee(t) {
+  const { translationDir: e, rootDir: r = process.cwd(), disablePageLocales: l = !1 } = t, c = x(r, e);
+  if (!_(c))
+    return console.warn(`[i18n] Translation directory not found: ${c}`), { root: {}, routes: {} };
+  const u = { root: {}, routes: {} };
+  return N(c, (i) => {
+    const o = G(c, i).split(J).join("/");
     try {
-      const l = q(u, "utf-8"), r = JSON.parse(l);
-      G(c, s, r, a);
-    } catch (l) {
-      console.error(`[i18n] Failed to load translation file: ${u}`, l);
+      const s = H(i, "utf-8"), a = JSON.parse(s);
+      K(u, o, a, l);
+    } catch (s) {
+      console.error(`[i18n] Failed to load translation file: ${i}`, s);
     }
-  }), c;
+  }), u;
 }
-function se(t, e) {
-  const { root: o, routes: a } = Q(e);
-  for (const [i, c] of Object.entries(o))
-    t.addTranslations(i, c, !1);
-  for (const [i, c] of Object.entries(a))
-    for (const [u, s] of Object.entries(c))
-      t.addRouteTranslations(u, i, V(o[u], s), !1);
+function fe(t, e) {
+  const { root: r, routes: l } = ee(e);
+  for (const [c, u] of Object.entries(r))
+    t.addTranslations(c, u, !1);
+  for (const [c, u] of Object.entries(l))
+    for (const [i, o] of Object.entries(u))
+      t.addRouteTranslations(i, c, Z(r[i], o), !1);
 }
-function ie(t) {
+function ge(t) {
   const {
     i18n: e,
     // This is the global singleton with cache
-    defaultLocale: o,
-    locales: a,
-    localeObjects: i,
-    autoDetect: c = !0,
-    redirectToDefault: u = !1,
-    routingStrategy: s
-  } = t, l = s || O();
-  return async (r, n) => {
-    if (r.locals.locale && r.locals.i18n)
+    defaultLocale: r,
+    locales: l,
+    localeObjects: c,
+    autoDetect: u = !0,
+    redirectToDefault: i = !1,
+    routingStrategy: o
+  } = t, s = o || I();
+  return async (a, n) => {
+    if (a.locals.locale && a.locals.i18n)
       return n();
-    const f = r.url, h = f.pathname;
-    if (!l) {
-      const L = e.clone(o), S = h === "/" || h === "" ? "index" : h.split("/").filter(Boolean).join("-");
-      return L.setRoute(S), r.locals.i18n = L, r.locals.locale = o, r.locals.defaultLocale = o, r.locals.locales = i || a.map((y) => ({ code: y })), r.locals.currentUrl = f, n();
+    const f = a.url, h = f.pathname;
+    if (!s) {
+      const w = e.clone(r), g = h === "/" || h === "" ? "index" : h.split("/").filter(Boolean).join("-");
+      return w.setRoute(g), a.locals.i18n = w, a.locals.locale = r, a.locals.defaultLocale = r, a.locals.locales = c || l.map((L) => ({ code: L })), a.locals.currentUrl = f, n();
     }
     const d = {
-      ...l,
+      ...s,
       getCurrentPath: () => h,
       getRoute: () => ({
         fullPath: f.pathname + f.search,
         query: Object.fromEntries(f.searchParams)
       })
-    }, p = h.split("/").filter(Boolean)[0], b = p !== void 0 && a.includes(p);
-    let P;
-    b && p ? P = p : d.getLocaleFromPath ? P = d.getLocaleFromPath(h, o, a) : P = o;
-    const w = e.clone(P), g = d.getRouteName ? d.getRouteName(h, a) : "index";
-    return w.setRoute(g), r.locals.i18n = w, r.locals.locale = P, r.locals.defaultLocale = o, r.locals.locales = i || a.map((L) => ({ code: L })), r.locals.currentUrl = f, r.locals.routingStrategy = d, Z(d, () => n());
+    }, m = h.split("/").filter(Boolean)[0], b = m !== void 0 && l.includes(m);
+    let S;
+    b && m ? S = m : d.getLocaleFromPath ? S = d.getLocaleFromPath(h, r, l) : S = r;
+    const y = e.clone(S), R = d.getRouteName ? d.getRouteName(h, l) : "index";
+    return y.setRoute(R), a.locals.i18n = y, a.locals.locale = S, a.locals.defaultLocale = r, a.locals.locales = c || l.map((w) => ({ code: w })), a.locals.currentUrl = f, a.locals.routingStrategy = d, Y(d, () => n());
   };
 }
-function ce(t, e, o, a, i, c = "i18n-locale", u) {
-  const s = u ?? O();
-  let l = a;
-  if (s?.getLocaleFromPath)
-    l = s.getLocaleFromPath(t, a, i);
+function he(t, e, r, l, c, u = "i18n-locale", i) {
+  const o = i ?? I();
+  let s = l;
+  if (o?.getLocaleFromPath)
+    s = o.getLocaleFromPath(t, l, c);
   else {
     const n = t.split("/").filter(Boolean)[0];
-    n && i.includes(n) && (l = n);
+    n && c.includes(n) && (s = n);
   }
-  if (c !== null && l === a && e.get(c)) {
-    const r = e.get(c)?.value;
-    r && i.includes(r) && (l = r);
+  if (u !== null && s === l && e.get(u)) {
+    const a = e.get(u)?.value;
+    a && c.includes(a) && (s = a);
   }
-  if (l === a)
+  if (s === l)
     try {
-      const r = J(o.get("accept-language") ?? void 0, i);
-      r && (l = r);
+      const a = Q(r.get("accept-language") ?? void 0, c);
+      a && (s = a);
     } catch {
     }
-  return l;
+  return s;
 }
-function ue(t, e, o) {
-  const a = t.map((n) => n.code), i = (n, f = []) => {
+function de(t, e, r) {
+  const l = t.map((n) => n.code), c = (n, f = []) => {
     const h = n.replace(/^\//, "").replace(/\/$/, "");
     if (!h)
       return "index";
-    const d = h.split("/").filter(Boolean), m = d[0];
-    return m && f.includes(m) && d.shift(), d.length === 0 ? "index" : d.join("-");
-  }, c = (n, f = "en", h = []) => {
-    const m = n.split("/").filter(Boolean)[0];
-    return m && h.includes(m) ? m : f;
-  }, u = (n, f, h = [], d) => {
-    const m = n.split("/").filter(Boolean), p = m[0];
-    return p && h.includes(p) && m.shift(), (f !== d || d === void 0) && m.unshift(f), `/${m.join("/")}`;
-  }, s = (n, f, h = [], d) => {
-    const p = (n.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), b = p[0];
-    return b && h.includes(b) && p.shift(), (f !== d || d === void 0) && p.unshift(f), `/${p.join("/")}`;
+    const d = h.split("/").filter(Boolean), p = d[0];
+    return p && f.includes(p) && d.shift(), d.length === 0 ? "index" : d.join("-");
+  }, u = (n, f = "en", h = []) => {
+    const p = n.split("/").filter(Boolean)[0];
+    return p && h.includes(p) ? p : f;
+  }, i = (n, f, h = [], d) => {
+    const p = n.split("/").filter(Boolean), m = p[0];
+    return m && h.includes(m) && p.shift(), (f !== d || d === void 0) && p.unshift(f), `/${p.join("/")}`;
+  }, o = (n, f, h = [], d) => {
+    const m = (n.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), b = m[0];
+    return b && h.includes(b) && m.shift(), (f !== d || d === void 0) && m.unshift(f), `/${m.join("/")}`;
   };
   return {
-    getCurrentPath: () => o ? o().pathname : typeof window < "u" ? window.location.pathname : "/",
-    getRouteName: i,
-    getLocaleFromPath: c,
-    switchLocalePath: u,
-    localizePath: s,
+    getCurrentPath: () => r ? r().pathname : typeof window < "u" ? window.location.pathname : "/",
+    getRouteName: c,
+    getLocaleFromPath: u,
+    switchLocalePath: i,
+    localizePath: o,
     removeLocaleFromPath: (n, f = []) => {
       const h = n.split("/").filter(Boolean), d = h[0];
       return d && f.includes(d) && h.shift(), `/${h.join("/")}`;
     },
     resolvePath: (n, f) => {
       const h = typeof n == "string" ? n : n.path || "/";
-      return s(h, f, a, e);
+      return o(h, f, l, e);
     },
     getRoute: () => {
-      if (o) {
-        const n = o();
+      if (r) {
+        const n = r();
         return {
           fullPath: n.pathname + n.search,
           query: Object.fromEntries(n.searchParams)
@@ -312,183 +312,208 @@ function ue(t, e, o) {
     }
   };
 }
-function R(t) {
+function T(t) {
+  return t.iso?.trim() || String(t.code);
+}
+function D(t) {
+  const e = t.match(/^([A-Za-z]{2,3})(?:[-_](.+))?$/);
+  return e ? { language: e[1], region: e[2] } : { language: t };
+}
+function te(t, e = {}) {
+  const { hreflangBaseLanguage: r = !1 } = e;
+  if (!r)
+    return t.map((i) => {
+      const o = String(i.code);
+      return { hreflang: T(i), localeCode: o };
+    });
+  const l = /* @__PURE__ */ new Map();
+  for (const i of t) {
+    const o = String(i.code), s = T(i), { language: a, region: n } = D(s);
+    a && n && !l.has(a) && l.set(a, o), l.set(s, o);
+  }
+  const c = /* @__PURE__ */ new Set(), u = [];
+  for (const i of t) {
+    const o = String(i.code), s = T(i), { language: a, region: n } = D(s);
+    a && n && l.get(a) === o && !c.has(a) && (c.add(a), u.push({ hreflang: a, localeCode: o })), c.has(s) || (c.add(s), u.push({ hreflang: s, localeCode: o }));
+  }
+  return u;
+}
+function $(t) {
   const e = t.og?.trim();
   if (e) return e;
-  const o = t.iso?.trim();
-  if (!o) return null;
-  const a = o.indexOf("_");
-  if (a > 0) {
-    const c = o.slice(0, a), u = o.slice(a + 1);
-    if (c.length >= 2 && u.length === 2)
-      return `${c.toLowerCase()}_${u.toUpperCase()}`;
+  const r = t.iso?.trim();
+  if (!r) return null;
+  const l = r.indexOf("_");
+  if (l > 0) {
+    const u = r.slice(0, l), i = r.slice(l + 1);
+    if (u.length >= 2 && i.length === 2)
+      return `${u.toLowerCase()}_${i.toUpperCase()}`;
   }
-  const i = o.indexOf("-");
-  if (i > 0) {
-    const c = o.slice(0, i), u = o.slice(i + 1);
-    if (c.length >= 2 && u.length === 2 && /^[A-Za-z]{2}$/.test(u))
-      return `${c.toLowerCase()}_${u.toUpperCase()}`;
+  const c = r.indexOf("-");
+  if (c > 0) {
+    const u = r.slice(0, c), i = r.slice(c + 1);
+    if (u.length >= 2 && i.length === 2 && /^[A-Za-z]{2}$/.test(i))
+      return `${u.toLowerCase()}_${i.toUpperCase()}`;
   }
   return null;
 }
-function k(t, e = {}) {
-  if (R(t) !== null || e.missingWarn === !1 || process.env.NODE_ENV === "production") return;
-  const o = e.tag ?? "og:locale", a = String(t.code ?? "unknown"), i = t.iso ? `, iso: '${t.iso}'` : "";
+function C(t, e = {}) {
+  if ($(t) !== null || e.missingWarn === !1 || process.env.NODE_ENV === "production") return;
+  const r = e.tag ?? "og:locale", l = String(t.code ?? "unknown"), c = t.iso ? `, iso: '${t.iso}'` : "";
   console.warn(
-    `[i18n] Cannot derive ${o} for locale '${a}'${i}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`
+    `[i18n] Cannot derive ${r} for locale '${l}'${c}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`
   );
 }
-function B(t) {
+function M(t) {
   const e = t.locals.i18n;
   if (!e)
     throw new Error("i18n instance not found. Make sure i18n middleware is configured.");
   return e;
 }
-function $(t) {
+function j(t) {
   return t.locals.locale || "en";
 }
-function v(t) {
+function k(t) {
   return t.locals.defaultLocale || "en";
 }
-function I(t) {
+function A(t) {
   return t.locals.locales || [];
 }
-function N(t) {
+function W(t) {
   return t.locals.routingStrategy || null;
 }
-function fe(t) {
-  const e = B(t), o = $(t), a = v(t), i = I(t), c = i.map((s) => s.code), u = N(t);
+function me(t) {
+  const e = M(t), r = j(t), l = k(t), c = A(t), u = c.map((o) => o.code), i = W(t);
   return {
     // Current locale
-    locale: o,
-    defaultLocale: a,
-    locales: i,
+    locale: r,
+    defaultLocale: l,
+    locales: c,
     // Translation methods
-    t: (s, l, r, n) => e.t(s, l, r, n),
-    ts: (s, l, r, n) => e.ts(s, l, r, n),
-    tc: (s, l, r) => e.tc(s, l, r),
+    t: (o, s, a, n) => e.t(o, s, a, n),
+    ts: (o, s, a, n) => e.ts(o, s, a, n),
+    tc: (o, s, a) => e.tc(o, s, a),
     tn: e.tn.bind(e),
     td: e.td.bind(e),
     tdr: e.tdr.bind(e),
-    has: (s, l) => e.has(s, l),
+    has: (o, s) => e.has(o, s),
     // Route management
     getRoute: () => e.getRoute(),
-    getRouteName: (s) => {
-      const l = s || t.url.pathname;
-      if (u?.getRouteName)
-        return u.getRouteName(l, c);
-      const r = l.replace(/^\//, "").replace(/\/$/, "");
-      if (!r) return "index";
-      const n = r.split("/").filter(Boolean), f = n[0];
-      return f && c.includes(f) && n.shift(), n.length === 0 ? "index" : n.join("-");
+    getRouteName: (o) => {
+      const s = o || t.url.pathname;
+      if (i?.getRouteName)
+        return i.getRouteName(s, u);
+      const a = s.replace(/^\//, "").replace(/\/$/, "");
+      if (!a) return "index";
+      const n = a.split("/").filter(Boolean), f = n[0];
+      return f && u.includes(f) && n.shift(), n.length === 0 ? "index" : n.join("-");
     },
-    getLocaleFromPath: (s) => {
-      const l = s || t.url.pathname;
-      if (u?.getLocaleFromPath)
-        return u.getLocaleFromPath(l, a, c);
-      const n = l.split("/").filter(Boolean)[0];
-      return n && c.includes(n) ? n : a;
+    getLocaleFromPath: (o) => {
+      const s = o || t.url.pathname;
+      if (i?.getLocaleFromPath)
+        return i.getLocaleFromPath(s, l, u);
+      const n = s.split("/").filter(Boolean)[0];
+      return n && u.includes(n) ? n : l;
     },
     // Path utilities
-    switchLocalePath: (s) => {
-      if (u?.switchLocalePath)
-        return u.switchLocalePath(t.url.pathname, s, c, a);
-      const l = t.url.pathname.split("/").filter(Boolean), r = l[0];
-      return r && c.includes(r) && l.shift(), s !== a && l.unshift(s), `/${l.join("/")}`;
+    switchLocalePath: (o) => {
+      if (i?.switchLocalePath)
+        return i.switchLocalePath(t.url.pathname, o, u, l);
+      const s = t.url.pathname.split("/").filter(Boolean), a = s[0];
+      return a && u.includes(a) && s.shift(), o !== l && s.unshift(o), `/${s.join("/")}`;
     },
-    localizePath: (s, l) => {
-      if (u?.localizePath)
-        return u.localizePath(s, l || o, c, a);
-      const n = (s.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), f = n[0];
-      return f && c.includes(f) && n.shift(), l && l !== a && n.unshift(l), `/${n.join("/")}`;
+    localizePath: (o, s) => {
+      if (i?.localizePath)
+        return i.localizePath(o, s || r, u, l);
+      const n = (o.replace(/^\//, "").replace(/\/$/, "") || "").split("/").filter(Boolean), f = n[0];
+      return f && u.includes(f) && n.shift(), s && s !== l && n.unshift(s), `/${n.join("/")}`;
     },
     // Get i18n instance
     getI18n: () => e,
     // Get base path without locale (for rewrite)
-    getBasePath: (s) => {
-      const n = (s || t.url).pathname.split("/").filter(Boolean), f = n[0];
-      return f && c.includes(f) && n.shift(), n.length > 0 ? `/${n.join("/")}` : "/";
+    getBasePath: (o) => {
+      const n = (o || t.url).pathname.split("/").filter(Boolean), f = n[0];
+      return f && u.includes(f) && n.shift(), n.length > 0 ? `/${n.join("/")}` : "/";
     },
     // Translation management
-    addTranslations: (s, l, r = !0) => {
-      e.addTranslations(s, l, r);
+    addTranslations: (o, s, a = !0) => {
+      e.addTranslations(o, s, a);
     },
-    addRouteTranslations: (s, l, r, n = !0) => {
-      e.addRouteTranslations(s, l, r, n);
+    addRouteTranslations: (o, s, a, n = !0) => {
+      e.addRouteTranslations(o, s, a, n);
     },
-    mergeTranslations: (s, l, r) => {
-      e.mergeTranslations(s, l, r);
+    mergeTranslations: (o, s, a) => {
+      e.mergeTranslations(o, s, a);
     },
     clearCache: () => {
       e.clearCache();
     }
   };
 }
-function ge(t, e = {}) {
-  const { baseUrl: o = "/", addDirAttribute: a = !0, addSeoAttributes: i = !0 } = e, c = $(t), u = v(t), l = I(t).filter((g) => !g.disabled), r = l.filter((g) => g.seo !== !1), n = l.find((g) => g.code === c);
-  if (!n)
+function pe(t, e = {}) {
+  const { baseUrl: r = "/", addDirAttribute: l = !0, addSeoAttributes: c = !0, hreflangBaseLanguage: u = !1 } = e, i = j(t), o = k(t), a = A(t).filter((g) => !g.disabled), n = a.filter((g) => g.seo !== !1), f = a.find((g) => g.code === i);
+  if (!f)
     return { htmlAttrs: {}, link: [], meta: [] };
-  const f = n.iso || c, h = R(n), d = n.dir || "auto", m = {
+  const h = f.iso || i, d = $(f), p = f.dir || "auto", m = {
     htmlAttrs: {
-      lang: f,
-      ...a ? { dir: d } : {}
+      lang: h,
+      ...l ? { dir: p } : {}
     },
     link: [],
     meta: []
   };
-  if (!i)
+  if (!c)
     return m;
-  const p = `${o}${t.url.pathname}`;
+  const b = `${r}${t.url.pathname}`;
   m.link.push({
     rel: "canonical",
-    href: p
+    href: b
   });
-  const b = N(t), P = l.map((g) => g.code);
-  for (const g of r) {
+  const S = W(t), y = a.map((g) => g.code), R = /* @__PURE__ */ new Map();
+  for (const g of n) {
     let L = t.url.pathname;
-    if (b?.switchLocalePath)
-      L = b.switchLocalePath(t.url.pathname, g.code, P, u);
+    if (S?.switchLocalePath)
+      L = S.switchLocalePath(t.url.pathname, g.code, y, o);
     else {
-      const y = t.url.pathname.split("/").filter(Boolean), j = y[0];
-      j && P.includes(j) && y.shift(), g.code !== u && y.unshift(g.code), L = `/${y.join("/")}`;
+      const P = t.url.pathname.split("/").filter(Boolean), F = P[0];
+      F && y.includes(F) && P.shift(), g.code !== o && P.unshift(g.code), L = `/${P.join("/")}`;
     }
-    const S = `${o}${L}`;
-    m.link.push({
-      rel: "alternate",
-      href: S,
-      hreflang: g.code
-    }), g.iso && g.iso !== g.code && m.link.push({
+    R.set(String(g.code), `${r}${L}`);
+  }
+  for (const { hreflang: g, localeCode: L } of te(n, { hreflangBaseLanguage: u })) {
+    const P = R.get(L);
+    P && m.link.push({
       rel: "alternate",
-      href: S,
-      hreflang: g.iso
+      href: P,
+      hreflang: g
     });
   }
-  if (l.find((g) => g.code === u)?.seo !== !1) {
+  if (a.find((g) => g.code === o)?.seo !== !1) {
     let g = t.url.pathname;
-    if (b?.switchLocalePath)
-      g = b.switchLocalePath(t.url.pathname, u, P, u);
+    if (S?.switchLocalePath)
+      g = S.switchLocalePath(t.url.pathname, o, y, o);
     else {
-      const L = t.url.pathname.split("/").filter(Boolean), S = L[0];
-      S && P.includes(S) && L.shift(), g = `/${L.join("/")}`;
+      const L = t.url.pathname.split("/").filter(Boolean), P = L[0];
+      P && y.includes(P) && L.shift(), g = `/${L.join("/")}`;
     }
     m.link.push({
       rel: "alternate",
-      href: `${o}${g}`,
+      href: `${r}${g}`,
       hreflang: "x-default"
     });
   }
-  h ? m.meta.push({
+  d ? m.meta.push({
     property: "og:locale",
-    content: h
-  }) : k(n, { tag: "og:locale" }), m.meta.push({
+    content: d
+  }) : C(f, { tag: "og:locale" }), m.meta.push({
     property: "og:url",
-    content: p
+    content: b
   });
-  for (const g of r) {
-    if (g.code === c) continue;
-    const L = R(g);
+  for (const g of n) {
+    if (g.code === i) continue;
+    const L = $(g);
     if (!L) {
-      k(g, { tag: "og:locale:alternate" });
+      C(g, { tag: "og:locale:alternate" });
       continue;
     }
     m.meta.push({
@@ -498,56 +523,56 @@ function ge(t, e = {}) {
   }
   return m;
 }
-function X(t, e, o) {
-  const a = e.split(".");
-  let i = t;
-  for (let u = 0; u < a.length - 1; u++) {
-    const s = a[u];
-    i[s] || (i[s] = {}), i = i[s];
+function ne(t, e, r) {
+  const l = e.split(".");
+  let c = t;
+  for (let i = 0; i < l.length - 1; i++) {
+    const o = l[i];
+    c[o] || (c[o] = {}), c = c[o];
   }
-  const c = a[a.length - 1];
-  c !== void 0 && (i[c] = o);
+  const u = l[l.length - 1];
+  u !== void 0 && (c[u] = r);
 }
-function he(t, e) {
-  const o = B(t), a = $(t), i = v(t), c = o.getRoute(), u = {};
+function Le(t, e) {
+  const r = M(t), l = j(t), c = k(t), u = r.getRoute(), i = {};
   if (e && e.length > 0) {
-    const s = {};
-    for (const l of e) {
-      const r = o.t(l, void 0, void 0, c);
-      r != null && r !== l && X(s, l, r);
+    const o = {};
+    for (const s of e) {
+      const a = r.t(s, void 0, void 0, u);
+      a != null && a !== s && ne(o, s, a);
     }
-    Object.keys(s).length > 0 && (u[c] = s);
+    Object.keys(o).length > 0 && (i[u] = o);
   } else {
-    const s = o.getRouteTranslations(a, c);
-    s && (u[c] = s);
+    const o = r.getRouteTranslations(l, u);
+    o && (i[u] = o);
   }
   return {
-    locale: a,
-    fallbackLocale: i,
-    currentRoute: c,
-    translations: u
+    locale: l,
+    fallbackLocale: c,
+    currentRoute: u,
+    translations: i
   };
 }
 export {
-  T as AstroI18n,
-  pe as FormatService,
-  ue as createAstroRouterAdapter,
-  re as createI18n,
-  ie as createI18nMiddleware,
-  Le as defaultPlural,
-  ce as detectLocale,
-  v as getDefaultLocale,
-  O as getGlobalRoutingStrategy,
-  B as getI18n,
-  he as getI18nProps,
-  $ as getLocale,
-  I as getLocales,
-  le as i18nIntegration,
-  Pe as interpolate,
-  Q as loadTranslationsFromDir,
-  se as loadTranslationsIntoI18n,
-  Z as runWithRoutingStrategy,
-  K as setGlobalRoutingStrategy,
-  fe as useI18n,
-  ge as useLocaleHead
+  v as AstroI18n,
+  be as FormatService,
+  de as createAstroRouterAdapter,
+  ue as createI18n,
+  ge as createI18nMiddleware,
+  ye as defaultPlural,
+  he as detectLocale,
+  k as getDefaultLocale,
+  I as getGlobalRoutingStrategy,
+  M as getI18n,
+  Le as getI18nProps,
+  j as getLocale,
+  A as getLocales,
+  ce as i18nIntegration,
+  we as interpolate,
+  ee as loadTranslationsFromDir,
+  fe as loadTranslationsIntoI18n,
+  Y as runWithRoutingStrategy,
+  X as setGlobalRoutingStrategy,
+  me as useI18n,
+  pe as useLocaleHead
 };

package/dist/utils.d.ts

@@ -59,6 +59,11 @@ export interface LocaleHeadOptions {
     baseUrl?: string;
     addDirAttribute?: boolean;
     addSeoAttributes?: boolean;
+    /**
+     * Also emit bare-language `hreflang` tags derived from `iso` (never from routing `code`).
+     * @default false
+     */
+    hreflangBaseLanguage?: boolean;
 }
 export interface LocaleHeadResult {
     htmlAttrs: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/astro",
-  "version": "1.3.8",
+  "version": "1.3.10",
   "description": "Astro integration for i18n-micro — translations, routing, and islands.",
   "keywords": [
     "astro",
@@ -77,10 +77,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@i18n-micro/types": "1.2.7",
-    "@i18n-micro/core": "1.3.8",
-    "@i18n-micro/utils": "1.0.8",
-    "@i18n-micro/node": "1.2.4"
+    "@i18n-micro/node": "^1.2.6",
+    "@i18n-micro/core": "^1.3.11",
+    "@i18n-micro/utils": "^1.0.13",
+    "@i18n-micro/types": "^1.2.10"
   },
   "devDependencies": {
     "astro": "^5.0.0 || ^6.0.0 || ^7.0.0",

package/src/utils.ts

@@ -1,4 +1,5 @@
 import type { CleanTranslation, Locale, Params, TranslationKey, Translations } from '@i18n-micro/types'
+import { resolveHreflangAlternates } from '@i18n-micro/utils/resolve-hreflang'
 import { resolveOgLocale, warnUnresolvedOgLocale } from '@i18n-micro/utils/resolve-og-locale'
 import type { AstroGlobal } from 'astro'
 import type { AstroI18n } from './composer'
@@ -187,6 +188,11 @@ export interface LocaleHeadOptions {
   baseUrl?: string
   addDirAttribute?: boolean
   addSeoAttributes?: boolean
+  /**
+   * Also emit bare-language `hreflang` tags derived from `iso` (never from routing `code`).
+   * @default false
+   */
+  hreflangBaseLanguage?: boolean
 }
 
 export interface LocaleHeadResult {
@@ -206,7 +212,7 @@ export interface LocaleHeadResult {
 }
 
 export function useLocaleHead(astro: AstroGlobal, options: LocaleHeadOptions = {}): LocaleHeadResult {
-  const { baseUrl = '/', addDirAttribute = true, addSeoAttributes = true } = options
+  const { baseUrl = '/', addDirAttribute = true, addSeoAttributes = true, hreflangBaseLanguage = false } = options
 
   const locale = getLocale(astro)
   const defaultLocale = getDefaultLocale(astro)
@@ -248,6 +254,7 @@ export function useLocaleHead(astro: AstroGlobal, options: LocaleHeadOptions = {
   const allLocaleCodes = locales.map((l) => l.code)
 
   // Alternate languages (includes current locale for self-referencing hreflang, per Google guidelines)
+  const hrefByCode = new Map<string, string>()
   for (const loc of localesForSeo) {
     let alternatePath = astro.url.pathname
     if (routingStrategy?.switchLocalePath) {
@@ -264,21 +271,17 @@ export function useLocaleHead(astro: AstroGlobal, options: LocaleHeadOptions = {
       }
       alternatePath = `/${segments.join('/')}`
     }
-    const alternateUrl = `${baseUrl}${alternatePath}`
+    hrefByCode.set(String(loc.code), `${baseUrl}${alternatePath}`)
+  }
 
+  for (const { hreflang, localeCode } of resolveHreflangAlternates(localesForSeo, { hreflangBaseLanguage })) {
+    const alternateUrl = hrefByCode.get(localeCode)
+    if (!alternateUrl) continue
     result.link.push({
       rel: 'alternate',
       href: alternateUrl,
-      hreflang: loc.code,
+      hreflang,
     })
-
-    if (loc.iso && loc.iso !== loc.code) {
-      result.link.push({
-        rel: 'alternate',
-        href: alternateUrl,
-        hreflang: loc.iso,
-      })
-    }
   }
 
   // x-default hreflang — points to the default locale's URL.