@i18n-micro/astro 1.3.25 → 2.0.0

package/dist/integration.d.cts

@@ -0,0 +1,26 @@
+import { Locale } from '@i18n-micro/types';
+import { AstroIntegration } from 'astro';
+import { AstroI18n, AstroI18nOptions } from './composer.cjs';
+export interface I18nIntegrationOptions {
+    locale: string;
+    fallbackLocale?: string;
+    locales?: Locale[];
+    missingWarn?: boolean;
+    localeCookie?: string | null;
+    autoDetect?: boolean;
+    /** `/` also redirects when nothing prefers another locale: see `createI18nMiddleware`. */
+    redirectToDefault?: boolean;
+    /** Bundled into the server at build time, relative to the project root. */
+    translationDir?: string;
+    /** Page files (`pages/about/de.json`) count as root translations. */
+    disablePageLocales?: boolean;
+    /**
+     * `false`: no middleware from the integration. Write `src/middleware.ts` with `createI18nMiddleware`
+     * for what cannot cross from the Astro config to the server bundle: `plural`, `missingHandler`, a strategy.
+     */
+    middleware?: boolean;
+}
+/** Astro integration for i18n-micro: publishes the config and dictionaries, and installs the middleware. */
+export declare function i18nIntegration(options: I18nIntegrationOptions): AstroIntegration;
+/** Create an i18n instance (for a `src/middleware.ts` of your own). */
+export declare function createI18n(options: AstroI18nOptions): AstroI18n;

package/dist/integration.d.ts

@@ -1,27 +1,26 @@
-import { Locale, ModuleOptions, PluralFunc } from '@i18n-micro/types';
+import { Locale } from '@i18n-micro/types';
 import { AstroIntegration } from 'astro';
-import { AstroI18n, AstroI18nOptions } from './composer';
-import { I18nRoutingStrategy } from './router/types';
-export interface I18nIntegrationOptions extends Omit<ModuleOptions, 'plural'> {
+import { AstroI18n, AstroI18nOptions } from './composer.js';
+export interface I18nIntegrationOptions {
     locale: string;
     fallbackLocale?: string;
     locales?: Locale[];
-    messages?: Record<string, Record<string, unknown>>;
-    plural?: PluralFunc;
     missingWarn?: boolean;
-    missingHandler?: (locale: string, key: string, routeName: string) => void;
     localeCookie?: string | null;
     autoDetect?: boolean;
+    /** `/` also redirects when nothing prefers another locale: see `createI18nMiddleware`. */
     redirectToDefault?: boolean;
+    /** Bundled into the server at build time, relative to the project root. */
     translationDir?: string;
-    routingStrategy?: I18nRoutingStrategy;
+    /** Page files (`pages/about/de.json`) count as root translations. */
+    disablePageLocales?: boolean;
+    /**
+     * `false`: no middleware from the integration. Write `src/middleware.ts` with `createI18nMiddleware`
+     * for what cannot cross from the Astro config to the server bundle: `plural`, `missingHandler`, a strategy.
+     */
+    middleware?: boolean;
 }
-export { getGlobalRoutingStrategy, runWithRoutingStrategy, setGlobalRoutingStrategy } from './routing-context';
-/**
- * Astro Integration for i18n-micro
- */
+/** Astro integration for i18n-micro: publishes the config and dictionaries, and installs the middleware. */
 export declare function i18nIntegration(options: I18nIntegrationOptions): AstroIntegration;
-/**
- * Create i18n instance (for manual setup)
- */
+/** Create an i18n instance (for a `src/middleware.ts` of your own). */
 export declare function createI18n(options: AstroI18nOptions): AstroI18n;

package/dist/middleware-BT3OA5YL.cjs

@@ -0,0 +1 @@
+let e=require("@i18n-micro/core"),t=require("@i18n-micro/runtime"),n=require("@i18n-micro/utils/active-locales"),r=require("@i18n-micro/utils/app-path"),i=require("@i18n-micro/utils/cookie"),a=require("@i18n-micro/utils/resolve-locale");var o=class extends t.I18n{constructor(e){super(e);let t=e.parent;this.initialMessages=t?.initialMessages??{...e.messages},this.initialRouteMessages=t?.initialRouteMessages??Object.fromEntries(Object.entries(e.routeMessages??{}).map(([e,t])=>[e,{...t}]))}keepMessages(e,t){this.initialMessages={...this.initialMessages,...e};let n={...this.initialRouteMessages};for(let[e,r]of Object.entries(t))n[e]={...n[e],...r};this.initialRouteMessages=n}getLocaleIso(){return this.localeIso}getRouteTranslations(e,t){return this.helper.getCache(e,t)??null}mergeTranslations(e,t,n){this.addRouteTranslations(e,t,n)}clearCache(){super.clearCache(),this.loadMessages(this.initialMessages,this.initialRouteMessages)}},s=e=>(0,r.trimTrailingSlashes)(e??``);function c(e,t){return t?e===`/`?t:`${t}${e}`:e}function l(e,t){try{return e.request.headers.get(t)}catch{return null}}function u(e){let t=e.isPrerendered?null:l(e,`referer`);if(!t)return null;try{return new URL(t)}catch{return null}}function d(e,t){let n=l(e,`sec-fetch-site`);return n?n===`same-origin`:t.host===e.url.host}function f(e){let t=u(e);return t&&new URL(t.pathname+t.search,e.url)}var p=e=>e?.startsWith(`/_server-islands/`)===!0||e?.startsWith(`/_actions/`)===!0;function m(e,t){let{routePattern:n,params:r}=e;if(!n)return;let i=/^\/\[([^\].]+)\]/.exec(n),a=i?r?.[i[1]]:void 0;if(!a)return n;let o=n.slice(i[0].length);return t.includes(a)?`/${a}${o}`:i[1]===`locale`?o||`/`:n}function h(e,{defaultLocale:t,locales:n,strategy:r}){let i=(0,a.localeFromPath)(e,n);if(i)return i;let o=r.getLocaleFromPath?.(e,t,n)??null;return o!==t&&o!==null&&n.includes(o)?o:null}function g(e,t){let{strategy:n,locales:i,defaultLocale:a,base:o}=t,s=p(e.routePattern),c=s&&f(e)||e.url,l=(0,r.withoutAppBaseURL)(c.pathname,o),u=h(l,t),d=s?void 0:m(e,i);return{url:c,partOfPage:s,path:l,urlLocale:u,locale:u??a,route:n.getRouteName(l,i,d)}}function _(e,t,n){let i=u(e);return!i||!d(e,i)?!1:(h((0,r.withoutAppBaseURL)(i.pathname,n.base),n)??n.defaultLocale)!==t.locale}function v(e,t){let n=e.request.method??`GET`;return!t.partOfPage&&!e.isPrerendered&&(n===`GET`||n===`HEAD`)}function y(e,t){return!t.ok||!t.headers.get(`content-type`)?.startsWith(`text/html`)?!1:!`${l(e,`sec-purpose`)} ${l(e,`purpose`)}`.includes(`prefetch`)}var b=/^[a-z][a-z\d+.-]*:/i;function x(t,n,i){if(t===``||t[0]===`#`||t[0]===`?`)return t;let a=(0,e.externalLinkHref)(t)??(b.test(t)?t:void 0);if(a)return a;let{strategy:o,codes:s,defaultLocale:l,base:u,from:d=`/`}=i,f=(0,e.pathEnd)(t),p=f===-1?t:t.slice(0,f),m=(0,e.withoutDots)(p[0]===`/`?(0,r.withoutAppBaseURL)(p,u):`${(0,r.trimTrailingSlashes)(d)}/${p}`),h=o.localizePath(m,n,s,l);return`${c(h+(p.length>1&&p.endsWith(`/`)&&!h.endsWith(`/`)?`/`:``),u)}${f===-1?``:t.slice(f)}`}var S=/\[(?:\.\.\.)?([^\]]+)\]/g;function C(t,n){let r=(0,e.pathSegments)((0,e.urlPath)(t));return r[0]!==void 0&&n.includes(r[0])&&r.shift(),r}var w=t=>t.slice((0,e.urlPath)(t).length);function T(e,t=[]){let n=C(e,t);if(n.length===0)return`index`;let r=n.join(`-`);return r.includes(`[`)?r.replace(S,`$1`):r}var E=(e,t=[])=>`/${C(e,t).join(`/`)}${w(e)}`;function D(e,t,n=[],r){let i=C(e,n);return t!==r&&i.unshift(t),`/${i.join(`/`)}${w(e)}`}function O(e,t,n){let i=e.map(e=>e.code),o=()=>n?.()??(typeof window<`u`?new URL(window.location.href):null);return{getCurrentPath:()=>o()?.pathname??`/`,getRouteName:(e,t=[],n)=>T(n??e,t),getLocaleFromPath:(e,t=`en`,n=[])=>(0,a.localeFromPath)(`/${(0,r.trimLeadingSlashes)(e)}`,n)??t,switchLocalePath:D,localizePath:D,removeLocaleFromPath:E,resolvePath:(e,n)=>D(typeof e==`string`?e:e.path||`/`,n,i,t),getRoute:()=>{let e=o();return e?{fullPath:e.pathname+e.search,query:Object.fromEntries(e.searchParams)}:{fullPath:`/`,query:{}}},push:e=>{typeof window<`u`&&(window.location.href=e.path)},replace:e=>{typeof window<`u`&&window.location.replace(e.path)}}}var k=`i18n-locale`;function A(e,t){if(t===null)return null;try{return e.get(t)?.value??null}catch{return null}}function j(e,t,n){let r=O(t,n);if(!e)return r;let i=e,a={};for(let[t,n]of Object.entries(r)){let r=i[t];a[t]=typeof r==`function`?r.bind(e):n}return a}function M(e,t,{cookies:n,headers:r,localeCookie:i,autoDetect:o}){return(0,a.resolveLocale)({defaultLocale:t.defaultLocale,validLocales:t.locales,autoDetectLanguage:o,url:h(e,t),cookie:o?A(n,i):null,acceptLanguage:o?l({request:{headers:r}},`accept-language`):null})}function N(e,t,n,r,i,a=k,o,s=!0){return M(e,{defaultLocale:r,locales:i,strategy:j(o,i.map(e=>({code:e})),r)},{cookies:t,headers:n,localeCookie:a,autoDetect:s})}var P=!1;function F(){P||(P=!0,console.warn("[i18n-micro] i18nIntegration already installs the middleware: pass `middleware: false` to it to use your own createI18nMiddleware."))}function I(e){let{i18n:t,defaultLocale:r,localeObjects:a,autoDetect:o=!0}=e,l=e.localeCookie===void 0?k:e.localeCookie,u=a??e.locales.map(e=>({code:e})),d=s(e.base),f={defaultLocale:r,base:d,locales:(0,n.getEnabledLocaleCodes)(u).filter(t=>e.locales.includes(t)),strategy:j(e.routingStrategy,u,r)},p={path:d||`/`,maxAge:i.DEFAULT_COOKIE_MAX_AGE,sameSite:`lax`},m=l===null?`Accept-Language`:`Cookie, Accept-Language`,h=async(n,r)=>{if(n.locals.locale&&n.locals.i18n)return n.locals.i18nHandler&&n.locals.i18nHandler!==h&&F(),r();let i=g(n,f),{path:a,url:s,locale:b,partOfPage:x}=i,S=v(n,i),C=S&&_(n,i,f),w=S&&a===`/`,T=o&&w&&!C?M(a,f,{cookies:n.cookies,headers:n.request.headers,localeCookie:l,autoDetect:!0}):b,E=[x||C?`Referer`:``,o&&w?m:``].filter(Boolean).join(`, `)||null,D=T!==b||w&&e.redirectToDefault?R(T,f):a;if(D!==a)return z(n.redirect(c(D,d)+s.search,302),E);Object.assign(n.locals,L(t,i,f,u,h));let O=await r();return C&&l!==null&&y(n,O)&&n.cookies.set(l,b,p),z(O,E)};return h}function L(e,t,n,r,i){let{url:a,path:o,locale:s,route:c}=t,l=e.fork(s);l.setRoute(c);let u=Object.create(n.strategy);return u.getCurrentPath=()=>o,u.getRoute=()=>({fullPath:o+a.search,query:Object.fromEntries(a.searchParams)}),{i18n:l,locale:s,defaultLocale:n.defaultLocale,locales:r,currentUrl:a,routingStrategy:u,i18nBase:n.base,i18nHandler:i}}function R(e,{strategy:t,defaultLocale:n}){let r=t.resolvePath(`/`,e);return(typeof r==`string`?r:r.path)||(e===n?`/`:`/${e}`)}function z(e,t){if(t===null)return e;try{e.headers.append(`Vary`,t)}catch{}return e}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return I}});

package/dist/middleware-Ch8E0iV_.js

@@ -0,0 +1,257 @@
+import { externalLinkHref as e, pathEnd as t, pathSegments as n, urlPath as r, withoutDots as i } from "@i18n-micro/core";
+import { I18n as a } from "@i18n-micro/runtime";
+import { getEnabledLocaleCodes as o } from "@i18n-micro/utils/active-locales";
+import { trimLeadingSlashes as s, trimTrailingSlashes as c, withoutAppBaseURL as l } from "@i18n-micro/utils/app-path";
+import { DEFAULT_COOKIE_MAX_AGE as u } from "@i18n-micro/utils/cookie";
+import { localeFromPath as d, resolveLocale as f } from "@i18n-micro/utils/resolve-locale";
+// src/composer.ts
+var p = class extends a {
+	constructor(e) {
+		super(e);
+		let t = e.parent;
+		this.initialMessages = t?.initialMessages ?? { ...e.messages }, this.initialRouteMessages = t?.initialRouteMessages ?? Object.fromEntries(Object.entries(e.routeMessages ?? {}).map(([e, t]) => [e, { ...t }]));
+	}
+	keepMessages(e, t) {
+		this.initialMessages = {
+			...this.initialMessages,
+			...e
+		};
+		let n = { ...this.initialRouteMessages };
+		for (let [e, r] of Object.entries(t)) n[e] = {
+			...n[e],
+			...r
+		};
+		this.initialRouteMessages = n;
+	}
+	getLocaleIso() {
+		return this.localeIso;
+	}
+	getRouteTranslations(e, t) {
+		return this.helper.getCache(e, t) ?? null;
+	}
+	mergeTranslations(e, t, n) {
+		this.addRouteTranslations(e, t, n);
+	}
+	clearCache() {
+		super.clearCache(), this.loadMessages(this.initialMessages, this.initialRouteMessages);
+	}
+}, m = (e) => c(e ?? "");
+function h(e, t) {
+	return t ? e === "/" ? t : `${t}${e}` : e;
+}
+function g(e, t) {
+	try {
+		return e.request.headers.get(t);
+	} catch {
+		return null;
+	}
+}
+function _(e) {
+	let t = e.isPrerendered ? null : g(e, "referer");
+	if (!t) return null;
+	try {
+		return new URL(t);
+	} catch {
+		return null;
+	}
+}
+function v(e, t) {
+	let n = g(e, "sec-fetch-site");
+	return n ? n === "same-origin" : t.host === e.url.host;
+}
+function y(e) {
+	let t = _(e);
+	return t && new URL(t.pathname + t.search, e.url);
+}
+var b = (e) => e?.startsWith("/_server-islands/") === !0 || e?.startsWith("/_actions/") === !0;
+function x(e, t) {
+	let { routePattern: n, params: r } = e;
+	if (!n) return;
+	let i = /^\/\[([^\].]+)\]/.exec(n), a = i ? r?.[i[1]] : void 0;
+	if (!a) return n;
+	let o = n.slice(i[0].length);
+	return t.includes(a) ? `/${a}${o}` : i[1] === "locale" ? o || "/" : n;
+}
+function S(e, { defaultLocale: t, locales: n, strategy: r }) {
+	let i = d(e, n);
+	if (i) return i;
+	let a = r.getLocaleFromPath?.(e, t, n) ?? null;
+	return a !== t && a !== null && n.includes(a) ? a : null;
+}
+function C(e, t) {
+	let { strategy: n, locales: r, defaultLocale: i, base: a } = t, o = b(e.routePattern), s = o && y(e) || e.url, c = l(s.pathname, a), u = S(c, t), d = o ? void 0 : x(e, r);
+	return {
+		url: s,
+		partOfPage: o,
+		path: c,
+		urlLocale: u,
+		locale: u ?? i,
+		route: n.getRouteName(c, r, d)
+	};
+}
+function w(e, t, n) {
+	let r = _(e);
+	return !r || !v(e, r) ? !1 : (S(l(r.pathname, n.base), n) ?? n.defaultLocale) !== t.locale;
+}
+function T(e, t) {
+	let n = e.request.method ?? "GET";
+	return !t.partOfPage && !e.isPrerendered && (n === "GET" || n === "HEAD");
+}
+function E(e, t) {
+	return !t.ok || !t.headers.get("content-type")?.startsWith("text/html") ? !1 : !`${g(e, "sec-purpose")} ${g(e, "purpose")}`.includes("prefetch");
+}
+var D = /^[a-z][a-z\d+.-]*:/i;
+function O(n, r, a) {
+	if (n === "" || n[0] === "#" || n[0] === "?") return n;
+	let o = e(n) ?? (D.test(n) ? n : void 0);
+	if (o) return o;
+	let { strategy: s, codes: u, defaultLocale: d, base: f, from: p = "/" } = a, m = t(n), g = m === -1 ? n : n.slice(0, m), _ = i(g[0] === "/" ? l(g, f) : `${c(p)}/${g}`), v = s.localizePath(_, r, u, d);
+	return `${h(v + (g.length > 1 && g.endsWith("/") && !v.endsWith("/") ? "/" : ""), f)}${m === -1 ? "" : n.slice(m)}`;
+}
+// src/router/adapter.ts
+var k = /\[(?:\.\.\.)?([^\]]+)\]/g;
+function A(e, t) {
+	let i = n(r(e));
+	return i[0] !== void 0 && t.includes(i[0]) && i.shift(), i;
+}
+var j = (e) => e.slice(r(e).length);
+function M(e, t = []) {
+	let n = A(e, t);
+	if (n.length === 0) return "index";
+	let r = n.join("-");
+	return r.includes("[") ? r.replace(k, "$1") : r;
+}
+var N = (e, t = []) => `/${A(e, t).join("/")}${j(e)}`;
+function P(e, t, n = [], r) {
+	let i = A(e, n);
+	return t !== r && i.unshift(t), `/${i.join("/")}${j(e)}`;
+}
+function F(e, t, n) {
+	let r = e.map((e) => e.code), i = () => n?.() ?? (typeof window < "u" ? new URL(window.location.href) : null);
+	return {
+		getCurrentPath: () => i()?.pathname ?? "/",
+		getRouteName: (e, t = [], n) => M(n ?? e, t),
+		getLocaleFromPath: (e, t = "en", n = []) => d(`/${s(e)}`, n) ?? t,
+		switchLocalePath: P,
+		localizePath: P,
+		removeLocaleFromPath: N,
+		resolvePath: (e, n) => P(typeof e == "string" ? e : e.path || "/", n, r, t),
+		getRoute: () => {
+			let e = i();
+			return e ? {
+				fullPath: e.pathname + e.search,
+				query: Object.fromEntries(e.searchParams)
+			} : {
+				fullPath: "/",
+				query: {}
+			};
+		},
+		push: (e) => {
+			typeof window < "u" && (window.location.href = e.path);
+		},
+		replace: (e) => {
+			typeof window < "u" && window.location.replace(e.path);
+		}
+	};
+}
+// src/middleware.ts
+var I = "i18n-locale";
+function L(e, t) {
+	if (t === null) return null;
+	try {
+		return e.get(t)?.value ?? null;
+	} catch {
+		return null;
+	}
+}
+function R(e, t, n) {
+	let r = F(t, n);
+	if (!e) return r;
+	let i = e, a = {};
+	for (let [t, n] of Object.entries(r)) {
+		let r = i[t];
+		a[t] = typeof r == "function" ? r.bind(e) : n;
+	}
+	return a;
+}
+function z(e, t, { cookies: n, headers: r, localeCookie: i, autoDetect: a }) {
+	return f({
+		defaultLocale: t.defaultLocale,
+		validLocales: t.locales,
+		autoDetectLanguage: a,
+		url: S(e, t),
+		cookie: a ? L(n, i) : null,
+		acceptLanguage: a ? g({ request: { headers: r } }, "accept-language") : null
+	});
+}
+function B(e, t, n, r, i, a = I, o, s = !0) {
+	return z(e, {
+		defaultLocale: r,
+		locales: i,
+		strategy: R(o, i.map((e) => ({ code: e })), r)
+	}, {
+		cookies: t,
+		headers: n,
+		localeCookie: a,
+		autoDetect: s
+	});
+}
+var V = !1;
+function H() {
+	V || (V = !0, console.warn("[i18n-micro] i18nIntegration already installs the middleware: pass `middleware: false` to it to use your own createI18nMiddleware."));
+}
+function U(e) {
+	let { i18n: t, defaultLocale: n, localeObjects: r, autoDetect: i = !0 } = e, a = e.localeCookie === void 0 ? I : e.localeCookie, s = r ?? e.locales.map((e) => ({ code: e })), c = m(e.base), l = {
+		defaultLocale: n,
+		base: c,
+		locales: o(s).filter((t) => e.locales.includes(t)),
+		strategy: R(e.routingStrategy, s, n)
+	}, d = {
+		path: c || "/",
+		maxAge: u,
+		sameSite: "lax"
+	}, f = a === null ? "Accept-Language" : "Cookie, Accept-Language", p = async (n, r) => {
+		if (n.locals.locale && n.locals.i18n) return n.locals.i18nHandler && n.locals.i18nHandler !== p && H(), r();
+		let o = C(n, l), { path: u, url: m, locale: g, partOfPage: _ } = o, v = T(n, o), y = v && w(n, o, l), b = v && u === "/", x = i && b && !y ? z(u, l, {
+			cookies: n.cookies,
+			headers: n.request.headers,
+			localeCookie: a,
+			autoDetect: !0
+		}) : g, S = [_ || y ? "Referer" : "", i && b ? f : ""].filter(Boolean).join(", ") || null, D = x !== g || b && e.redirectToDefault ? G(x, l) : u;
+		if (D !== u) return K(n.redirect(h(D, c) + m.search, 302), S);
+		Object.assign(n.locals, W(t, o, l, s, p));
+		let O = await r();
+		return y && a !== null && E(n, O) && n.cookies.set(a, g, d), K(O, S);
+	};
+	return p;
+}
+function W(e, t, n, r, i) {
+	let { url: a, path: o, locale: s, route: c } = t, l = e.fork(s);
+	l.setRoute(c);
+	let u = Object.create(n.strategy);
+	return u.getCurrentPath = () => o, u.getRoute = () => ({
+		fullPath: o + a.search,
+		query: Object.fromEntries(a.searchParams)
+	}), {
+		i18n: l,
+		locale: s,
+		defaultLocale: n.defaultLocale,
+		locales: r,
+		currentUrl: a,
+		routingStrategy: u,
+		i18nBase: n.base,
+		i18nHandler: i
+	};
+}
+function G(e, { strategy: t, defaultLocale: n }) {
+	let r = t.resolvePath("/", e);
+	return (typeof r == "string" ? r : r.path) || (e === n ? "/" : `/${e}`);
+}
+function K(e, t) {
+	if (t === null) return e;
+	try {
+		e.headers.append("Vary", t);
+	} catch {}
+	return e;
+}
+export { h as a, O as i, B as n, p as o, F as r, U as t };

package/dist/middleware.d.cts

@@ -0,0 +1,34 @@
+import { Locale } from '@i18n-micro/types';
+import { MiddlewareHandler } from 'astro';
+import { AstroI18n } from './composer.cjs';
+import { I18nRoutingStrategy } from './router/types.cjs';
+export interface I18nMiddlewareOptions {
+    i18n: AstroI18n;
+    defaultLocale: string;
+    locales: string[];
+    localeObjects?: Locale[];
+    /** `/` redirects to the locale the cookie / Accept-Language prefer (default `true`); pages keep the URL's locale. */
+    autoDetect?: boolean;
+    /**
+     * `/` also redirects when nothing prefers another locale: to the home `routingStrategy` resolves
+     * for the default locale (default `false`). Without one `/` stays: it is the default locale's page.
+     */
+    redirectToDefault?: boolean;
+    routingStrategy?: I18nRoutingStrategy;
+    /** Cookie holding the visitor's locale (default `'i18n-locale'`); `null` disables it. */
+    localeCookie?: string | null;
+    /** Astro's `base`, `config.base` of the virtual config. */
+    base?: string;
+}
+export declare const DEFAULT_ASTRO_LOCALE_COOKIE = "i18n-locale";
+/**
+ * Locale a visitor prefers: URL prefix → cookie → Accept-Language → default, the one precedence of
+ * `resolveLocale`. An explicit prefix always wins; `autoDetect: false` leaves only the URL.
+ */
+export declare function detectLocale(pathname: string, cookies: {
+    get: (name: string) => {
+        value: string;
+    } | undefined;
+}, headers: Headers, defaultLocale: string, locales: string[], localeCookie?: string | null, routingStrategy?: I18nRoutingStrategy | null, autoDetect?: boolean): string;
+/** Create Astro middleware for i18n locale detection */
+export declare function createI18nMiddleware(options: I18nMiddlewareOptions): MiddlewareHandler;

package/dist/middleware.d.ts

@@ -1,25 +1,34 @@
 import { Locale } from '@i18n-micro/types';
 import { MiddlewareHandler } from 'astro';
-import { AstroI18n } from './composer';
-import { I18nRoutingStrategy } from './router/types';
+import { AstroI18n } from './composer.js';
+import { I18nRoutingStrategy } from './router/types.js';
 export interface I18nMiddlewareOptions {
     i18n: AstroI18n;
     defaultLocale: string;
     locales: string[];
     localeObjects?: Locale[];
+    /** `/` redirects to the locale the cookie / Accept-Language prefer (default `true`); pages keep the URL's locale. */
     autoDetect?: boolean;
+    /**
+     * `/` also redirects when nothing prefers another locale: to the home `routingStrategy` resolves
+     * for the default locale (default `false`). Without one `/` stays: it is the default locale's page.
+     */
     redirectToDefault?: boolean;
     routingStrategy?: I18nRoutingStrategy;
+    /** Cookie holding the visitor's locale (default `'i18n-locale'`); `null` disables it. */
+    localeCookie?: string | null;
+    /** Astro's `base`, `config.base` of the virtual config. */
+    base?: string;
 }
+export declare const DEFAULT_ASTRO_LOCALE_COOKIE = "i18n-locale";
 /**
- * Create Astro middleware for i18n locale detection
- */
-export declare function createI18nMiddleware(options: I18nMiddlewareOptions): MiddlewareHandler;
-/**
- * Detect locale from request
+ * Locale a visitor prefers: URL prefix → cookie → Accept-Language → default, the one precedence of
+ * `resolveLocale`. An explicit prefix always wins; `autoDetect: false` leaves only the URL.
  */
 export declare function detectLocale(pathname: string, cookies: {
     get: (name: string) => {
         value: string;
     } | undefined;
-}, headers: Headers, defaultLocale: string, locales: string[], localeCookie?: string | null, routingStrategy?: I18nRoutingStrategy | null): string;
+}, headers: Headers, defaultLocale: string, locales: string[], localeCookie?: string | null, routingStrategy?: I18nRoutingStrategy | null, autoDetect?: boolean): string;
+/** Create Astro middleware for i18n locale detection */
+export declare function createI18nMiddleware(options: I18nMiddlewareOptions): MiddlewareHandler;

package/dist/middleware.js

@@ -0,0 +1,23 @@
+import { o as e, t } from "./middleware-Ch8E0iV_.js";
+import { localeIsoMap as n } from "@i18n-micro/core";
+import { config as r } from "virtual:i18n-micro/config";
+import { messages as i } from "virtual:i18n-micro/messages";
+// src/auto-middleware.ts
+var a = new e({
+	locale: r.defaultLocale,
+	fallbackLocale: r.fallbackLocale,
+	missingWarn: r.missingWarn,
+	localeIso: n(r.locales),
+	messages: i.root,
+	routeMessages: i.routes
+}), o = t({
+	i18n: a,
+	defaultLocale: r.defaultLocale,
+	locales: r.localeCodes,
+	localeObjects: r.locales,
+	autoDetect: r.autoDetect,
+	redirectToDefault: r.redirectToDefault,
+	localeCookie: r.localeCookie,
+	base: r.base
+});
+export { o as onRequest };

package/dist/node.d.ts

@@ -0,0 +1,26 @@
+import { Translations } from '@i18n-micro/types';
+import { TranslationFileBuckets } from '@i18n-micro/utils/parse-path';
+export interface LoadTranslationsOptions {
+    translationDir: string;
+    rootDir?: string;
+    disablePageLocales?: boolean;
+}
+export interface LoadedTranslations extends TranslationFileBuckets<Translations> {
+}
+/** Load all translations from a directory: flat (`en.json`) and nested (`pages/home/en.json`). */
+export declare function loadTranslationsFromDir(options: LoadTranslationsOptions): LoadedTranslations;
+/** The directory's dictionaries and the files they came from, for the integration's build. */
+export declare function readTranslationDir(options: {
+    translationDir: string;
+    rootDir: URL;
+    disablePageLocales?: boolean;
+}): {
+    messages: TranslationFileBuckets<Translations>;
+    files: string[];
+};
+/** Load a directory into an instance, replacing the chunks it finds. */
+export declare function loadTranslationsIntoI18n(i18n: {
+    addTranslations: (locale: string, translations: Translations, merge?: boolean) => void;
+    addRouteTranslations: (locale: string, routeName: string, translations: Translations, merge?: boolean) => void;
+    keepMessages?: (messages: Record<string, Translations>, routeMessages: Record<string, Record<string, Translations>>) => void;
+}, options: LoadTranslationsOptions): void;

package/dist/node.js

@@ -0,0 +1,22 @@
+import { resolve as e } from "node:path";
+import { fileURLToPath as t } from "node:url";
+import { listTranslationFiles as n, loadTranslationDir as r, loadTranslationFiles as i } from "@i18n-micro/utils/load-dir";
+// src/node.ts
+function a(t) {
+	let { translationDir: n, rootDir: i = process.cwd(), disablePageLocales: a = !1 } = t;
+	return r(e(i, n), a);
+}
+function o(r) {
+	let a = e(t(r.rootDir), r.translationDir), o = n(a);
+	return {
+		messages: i(o, r.disablePageLocales),
+		files: [a, ...o.map((e) => e.absolutePath)]
+	};
+}
+function s(e, t) {
+	let { root: n, routes: r } = a(t);
+	for (let [t, r] of Object.entries(n)) e.addTranslations(t, r, !1);
+	for (let [t, n] of Object.entries(r)) for (let [r, i] of Object.entries(n)) e.addRouteTranslations(r, t, i, !1);
+	e.keepMessages?.(n, r);
+}
+export { a as loadTranslationsFromDir, s as loadTranslationsIntoI18n, o as readTranslationDir };

package/dist/request.d.ts

@@ -0,0 +1,69 @@
+import { I18nRoutingStrategy } from './router/types.js';
+/**
+ * The one request model. Everything below works on the page's path without Astro's `base`:
+ * the middleware strips it once, every URL that goes out gets it back from {@link withBase}.
+ */
+export interface I18nRouting {
+    defaultLocale: string;
+    /** Codes of the locales in service: a disabled one is neither a URL's locale nor a redirect target. */
+    locales: string[];
+    /** `''` or `/docs`, no trailing slash. */
+    base: string;
+    strategy: I18nRoutingStrategy;
+}
+/** The parts of an Astro context a request is read from: also a mock in tests. */
+export interface RequestContext {
+    url: URL;
+    params?: Record<string, string | undefined>;
+    routePattern?: string;
+    isPrerendered?: boolean;
+    request: {
+        headers: Headers;
+        method?: string;
+    };
+}
+export interface I18nRequest {
+    /** The page this request is for: another URL than `context.url` for a server island or action. */
+    url: URL;
+    /** A server island or action: it belongs to the page in `url`, and is no page view itself. */
+    partOfPage: boolean;
+    /** `url.pathname` without `base`. */
+    path: string;
+    /** The locale `url` names, `null` for an unprefixed URL. */
+    urlLocale: string | null;
+    /** The URL's locale, else the default one: an unprefixed URL is the default locale's page. */
+    locale: string;
+    route: string;
+}
+export declare const normalizeBase: (base: string | undefined) => string;
+/** `path`, which has no `base`, as a URL of the site. */
+export declare function withBase(path: string, base: string): string;
+/** A request header, or null where there is none (static prerendering). */
+export declare function header(context: Pick<RequestContext, 'request'>, name: string): string | null;
+/**
+ * Locale a path names: its prefix, or what the strategy reads from it when that is not the default
+ * (a strategy's `getLocaleFromPath` answers the default for a URL without a locale).
+ */
+export declare function localeOfPath(path: string, { defaultLocale, locales, strategy }: Omit<I18nRouting, 'base'>): string | null;
+export declare function resolveRequest(context: RequestContext, routing: I18nRouting): I18nRequest;
+/** Whether the visitor comes from a page of this site in another locale. */
+export declare function isSwitch(context: RequestContext, request: I18nRequest, routing: I18nRouting): boolean;
+/** A document may be asked for by this request: an island, an action or a form post is no landing. */
+export declare function asksForPage(context: RequestContext, request: I18nRequest): boolean;
+/**
+ * The visitor did see this response as a page: no endpoint, image, 404 or redirect, and not a
+ * prefetch of a link they may never follow.
+ * ponytail: a `fetch` of an HTML fragment from a page of another locale still counts; `<ClientRouter>`
+ * navigates by `fetch` too, and the two look the same from here.
+ */
+export declare function isPageView(context: RequestContext, response: Response): boolean;
+export interface HrefContext extends Pick<I18nRouting, 'base' | 'defaultLocale' | 'strategy'> {
+    codes: string[];
+    /** What a relative `href` resolves against: the page's path. */
+    from?: string;
+}
+/**
+ * `href` as a link to `locale`. What leaves the app, and a bare `#hash` or `?query`, stays as
+ * written; a route is localized and keeps its query, hash and trailing slash.
+ */
+export declare function localizeHref(href: string, locale: string, context: HrefContext): string;

package/dist/router/adapter.d.cts

@@ -0,0 +1,9 @@
+import { Locale } from '@i18n-micro/types';
+import { I18nRoutingStrategy } from './types.cjs';
+/** `/en/blog/post` → `blog-post`, `/blog/[slug]` → `blog-slug`, `/` → `index`. */
+export declare function routeNameFromPath(path: string, locales?: readonly string[]): string;
+/**
+ * Prefix-except-default routing over plain paths. Paths here never carry Astro's `base`: the
+ * middleware strips it from what comes in and adds it to what goes out.
+ */
+export declare function createAstroRouterAdapter(locales: Locale[], defaultLocale: string, getCurrentUrl?: () => URL): I18nRoutingStrategy;

package/dist/router/adapter.d.ts

@@ -1,8 +1,9 @@
 import { Locale } from '@i18n-micro/types';
-import { I18nRoutingStrategy } from './types';
+import { I18nRoutingStrategy } from './types.js';
+/** `/en/blog/post` → `blog-post`, `/blog/[slug]` → `blog-slug`, `/` → `index`. */
+export declare function routeNameFromPath(path: string, locales?: readonly string[]): string;
 /**
- * Factory for Astro router adapter
- * Implements routing utilities for Astro file-based routing
- * Uses standard Astro APIs: Astro.url, context.url
+ * Prefix-except-default routing over plain paths. Paths here never carry Astro's `base`: the
+ * middleware strips it from what comes in and adds it to what goes out.
  */
 export declare function createAstroRouterAdapter(locales: Locale[], defaultLocale: string, getCurrentUrl?: () => URL): I18nRoutingStrategy;

package/dist/router/types.d.cts

@@ -0,0 +1,66 @@
+/**
+ * Routing strategy interface for i18n in Astro
+ * Implement this interface to integrate with any routing logic
+ * Matches Vue/Solid/React package interface for consistency
+ * Adapted for Astro SSR context (push/replace are optional)
+ */
+export interface I18nRoutingStrategy {
+    /**
+     * Returns current path (without locale prefix if needed, or full path)
+     * Used for determining active classes in links
+     */
+    getCurrentPath: () => string;
+    /**
+     * Generate path for specific locale
+     */
+    resolvePath?: (to: string | {
+        path?: string;
+    }, locale: string) => string | {
+        path?: string;
+    };
+    /**
+     * Get route name from path (e.g., /en/about -> about)
+     * Used in middleware to set route name. `routePattern` is the page's pattern (`/blog/[slug]`), with
+     * a `[locale]` param already replaced by its value: use it to give every URL of a page one name.
+     */
+    getRouteName?: (path: string, locales: string[], routePattern?: string) => string;
+    /**
+     * Get locale from path
+     * Checks if first segment is a locale code
+     */
+    getLocaleFromPath?: (path: string, defaultLocale: string, locales: string[]) => string;
+    /**
+     * Switch locale in path
+     * Replaces or adds locale prefix to path
+     */
+    switchLocalePath?: (path: string, newLocale: string, locales: string[], defaultLocale?: string) => string;
+    /**
+     * Localize path with locale prefix
+     */
+    localizePath?: (path: string, locale: string, locales: string[], defaultLocale?: string) => string;
+    /**
+     * Remove locale from path
+     */
+    removeLocaleFromPath?: (path: string, locales: string[]) => string;
+    /**
+     * (Optional) Function to navigate to another route/locale
+     * Not used in SSR, but can be used in client-side islands
+     */
+    push?: (target: {
+        path: string;
+    }) => void;
+    /**
+     * (Optional) Function to replace current route
+     * Not used in SSR, but can be used in client-side islands
+     */
+    replace?: (target: {
+        path: string;
+    }) => void;
+    /**
+     * (Optional) Get current route object for SEO/Meta tags
+     */
+    getRoute?: () => {
+        fullPath: string;
+        query: Record<string, unknown>;
+    };
+}