@i18n-micro/astro 1.3.12 → 1.3.13

package/README.md

@@ -58,6 +58,23 @@ const { t, locale } = useI18n(Astro)
 </html>
 ```
 
+### 3. Locale-prefixed URLs (`/[locale]/*`)
+
+When using `createAstroRouterAdapter`, add rewrite stubs under `src/pages/[locale]/`:
+
+```astro
+---
+import { prepareLocaleRewrite } from '@i18n-micro/astro'
+
+const rewriteTarget = prepareLocaleRewrite(Astro)
+if (rewriteTarget instanceof Response) return rewriteTarget
+
+return Astro.rewrite(rewriteTarget)
+---
+```
+
+See the [full Astro integration guide](https://s00d.github.io/nuxt-i18n-micro/integrations/astro-package.html#locale-prefixed-routes-locale) for routing layout and typecheck notes.
+
 ## Resources
 
 - **Repository**: [https://github.com/s00d/nuxt-i18n-micro](https://github.com/s00d/nuxt-i18n-micro)

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -11,4 +11,4 @@ export { createI18nMiddleware, detectLocale } from './middleware';
 export { createAstroRouterAdapter } from './router/adapter';
 export type { I18nRoutingStrategy } from './router/types';
 export type { I18nClientProps, LocaleHeadOptions, LocaleHeadResult } from './utils';
-export { getDefaultLocale, getI18n, getI18nProps, getLocale, getLocales, useI18n, useLocaleHead } from './utils';
+export { getDefaultLocale, getI18n, getI18nProps, getLocale, getLocaleRewritePath, getLocales, prepareLocaleRewrite, useI18n, useLocaleHead, } from './utils';

package/dist/index.d.ts

@@ -11,4 +11,4 @@ export { createI18nMiddleware, detectLocale } from './middleware';
 export { createAstroRouterAdapter } from './router/adapter';
 export type { I18nRoutingStrategy } from './router/types';
 export type { I18nClientProps, LocaleHeadOptions, LocaleHeadResult } from './utils';
-export { getDefaultLocale, getI18n, getI18nProps, getLocale, getLocales, useI18n, useLocaleHead } from './utils';
+export { getDefaultLocale, getI18n, getI18nProps, getLocale, getLocaleRewritePath, getLocales, prepareLocaleRewrite, useI18n, useLocaleHead, } from './utils';

package/dist/index.mjs

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

package/dist/utils.d.ts

@@ -52,6 +52,15 @@ export declare function useI18n(astro: AstroGlobal): {
     mergeTranslations: (locale: string, routeName: string, translations: Record<string, unknown>) => void;
     clearCache: () => void;
 };
+/**
+ * Strip locale prefix from the current URL for `Astro.rewrite()` on `/[locale]/*` routes.
+ */
+export declare function getLocaleRewritePath(astro: AstroGlobal): string;
+/**
+ * Validate `:locale`, sync i18n/locals, and return the base path for `Astro.rewrite()`.
+ * Returns a `Response` when the locale param is invalid.
+ */
+export declare function prepareLocaleRewrite(astro: AstroGlobal): Response | string;
 /**
  * Generate locale head meta tags for SEO
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/astro",
-  "version": "1.3.12",
+  "version": "1.3.13",
   "description": "Astro integration for i18n-micro — translations, routing, and islands.",
   "keywords": [
     "astro",
@@ -43,6 +43,9 @@
     "./env": {
       "types": "./dist/env.d.ts"
     },
+    "./astro-shim": {
+      "types": "./dist/env.d.ts"
+    },
     "./components/i18n-t.astro": "./src/components/i18n-t.astro",
     "./components/i18n-link.astro": "./src/components/i18n-link.astro",
     "./components/i18n-switcher.astro": "./src/components/i18n-switcher.astro",
@@ -77,10 +80,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@i18n-micro/core": "^1.3.14",
-    "@i18n-micro/types": "^1.2.11",
-    "@i18n-micro/node": "^1.2.8",
-    "@i18n-micro/utils": "^1.0.14"
+    "@i18n-micro/core": "^1.3.15",
+    "@i18n-micro/node": "^1.2.9",
+    "@i18n-micro/utils": "^1.0.15",
+    "@i18n-micro/types": "^1.2.12"
   },
   "devDependencies": {
     "astro": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -123,6 +126,6 @@
     "dev": "cd playground && astro dev",
     "test": "vitest run",
     "test:dist": "vitest run --config vitest.dist.config.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit && pnpm --dir playground typecheck"
   }
 }

package/src/astro-shim.d.ts

@@ -0,0 +1 @@
+import './env'

package/src/index.ts

@@ -20,5 +20,15 @@ export { createAstroRouterAdapter } from './router/adapter'
 export type { I18nRoutingStrategy } from './router/types'
 export type { I18nClientProps, LocaleHeadOptions, LocaleHeadResult } from './utils'
 // Utilities
-export { getDefaultLocale, getI18n, getI18nProps, getLocale, getLocales, useI18n, useLocaleHead } from './utils'
+export {
+  getDefaultLocale,
+  getI18n,
+  getI18nProps,
+  getLocale,
+  getLocaleRewritePath,
+  getLocales,
+  prepareLocaleRewrite,
+  useI18n,
+  useLocaleHead,
+} from './utils'
 // It's loaded directly by Astro via entrypoint in integration config

package/src/utils.ts

@@ -181,6 +181,35 @@ export function useI18n(astro: AstroGlobal) {
   }
 }
 
+/**
+ * Strip locale prefix from the current URL for `Astro.rewrite()` on `/[locale]/*` routes.
+ */
+export function getLocaleRewritePath(astro: AstroGlobal): string {
+  const url = astro.locals.currentUrl ?? astro.url
+  return useI18n(astro).getBasePath(url)
+}
+
+/**
+ * Validate `:locale`, sync i18n/locals, and return the base path for `Astro.rewrite()`.
+ * Returns a `Response` when the locale param is invalid.
+ */
+export function prepareLocaleRewrite(astro: AstroGlobal): Response | string {
+  const { locale } = astro.params
+  const localeCodes = getLocales(astro).map((entry) => entry.code)
+
+  if (!locale || !localeCodes.includes(locale)) {
+    return new Response(null, { status: 404 })
+  }
+
+  const i18n = astro.locals.i18n
+  if (i18n) {
+    i18n.locale = locale
+    astro.locals.locale = locale
+  }
+
+  return getLocaleRewritePath(astro)
+}
+
 /**
  * Generate locale head meta tags for SEO
  */