npm - @pyreon/zero - Versions diffs - 0.11.8 → 0.11.9 - Mend

@pyreon/zero 0.11.8 → 0.11.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/lib/fs-router-BkbIWqek.js.map +1 -1
package/lib/{fs-router-n4VA4lxu.js → fs-router-Dil4IKZR.js} +23 -19
package/lib/fs-router-Dil4IKZR.js.map +1 -0
package/lib/index.js +872 -17
package/lib/index.js.map +1 -1
package/lib/link.js +12 -1
package/lib/link.js.map +1 -1
package/package.json +10 -10
package/src/entry-server.ts +124 -76
package/src/favicon.ts +380 -0
package/src/fs-router.ts +54 -13
package/src/i18n-routing.ts +299 -0
package/src/index.ts +125 -76
package/src/link.tsx +12 -0
package/src/meta.tsx +210 -0
package/src/middleware.ts +65 -0
package/src/not-found.ts +44 -0
package/src/types.ts +2 -0
package/src/vite-plugin.ts +258 -127
package/lib/fs-router-n4VA4lxu.js.map +0 -1

package/lib/index.js CHANGED Viewed

@@ -1,12 +1,13 @@
-import { a as parseFileRoutes, i as generateRouteModule, o as scanRouteFiles, r as generateMiddlewareModule, t as filePathToUrlPath } from "./fs-router-n4VA4lxu.js";
-import { Fragment, createRef, h, onMount, onUnmount } from "@pyreon/core";
-import { HeadProvider } from "@pyreon/head";
+import { a as parseFileRoutes, i as generateRouteModule, o as scanRouteFiles, r as generateMiddlewareModule, t as filePathToUrlPath } from "./fs-router-Dil4IKZR.js";
+import { Fragment, createContext, createRef, h, onMount, onUnmount } from "@pyreon/core";
+import { HeadProvider, useHead } from "@pyreon/head";
 import { RouterProvider, RouterView, createRouter, useRouter } from "@pyreon/router";
 import { createHandler } from "@pyreon/server";
+import { renderToString } from "@pyreon/runtime-server";
+import { existsSync, readdirSync } from "node:fs";
+import { basename, extname, join } from "node:path";
 import { effect, signal } from "@pyreon/reactivity";
-import { existsSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { basename, extname, join } from "node:path";
 //#region src/app.ts
 /**
@@ -169,6 +170,31 @@ function generateApiRouteModule(files, routesDir) {
 	].join("\n");
 }
+//#endregion
+//#region src/not-found.ts
+const DEFAULT_404_BODY = "<h1>404 — Not Found</h1><p>The page you requested does not exist.</p>";
+/**
+* Render a 404 component to a full HTML string.
+* If no component is provided, returns a default 404 page.
+*/
+async function render404Page(component, template) {
+	let body;
+	if (component) body = await renderToString(h(component, null));
+	else body = DEFAULT_404_BODY;
+	if (template?.includes("<!--pyreon-app-->")) return template.replace("<!--pyreon-app-->", body);
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>404 — Not Found</title>
+</head>
+<body>
+  ${body}
+</body>
+</html>`;
+}
 //#endregion
 //#region src/entry-server.ts
 /**
@@ -219,7 +245,7 @@ function createServer(options) {
 		routes: options.routes,
 		routerMode: "history"
 	});
-	return createHandler({
+	const handler = createHandler({
 		App,
 		routes: options.routes,
 		middleware: allMiddleware,
@@ -227,6 +253,30 @@ function createServer(options) {
 		...options.template ? { template: options.template } : {},
 		...options.clientEntry ? { clientEntry: options.clientEntry } : {}
 	});
+	if (!options.notFoundComponent) return handler;
+	const NotFound = options.notFoundComponent;
+	const routePatterns = flattenRoutePatterns$1(options.routes);
+	return async (req) => {
+		const pathname = new URL(req.url).pathname;
+		if (!routePatterns.some((pattern) => matchPattern(pattern, pathname))) {
+			const fullHtml = await render404Page(NotFound, options.template);
+			return new Response(fullHtml, {
+				status: 404,
+				headers: { "Content-Type": "text/html; charset=utf-8" }
+			});
+		}
+		return handler(req);
+	};
+}
+/** Extract all URL patterns from a nested route tree. */
+function flattenRoutePatterns$1(routes, prefix = "") {
+	const patterns = [];
+	for (const route of routes) {
+		const fullPath = route.path === "/" && prefix ? prefix : `${prefix}${route.path}`;
+		patterns.push(fullPath);
+		if (route.children) patterns.push(...flattenRoutePatterns$1(route.children, fullPath));
+	}
+	return patterns;
 }
 //#endregion
@@ -371,6 +421,19 @@ function formatStack(stack) {
 //#endregion
 //#region src/vite-plugin.ts
+/**
+* Scan node_modules/@pyreon/ to discover all installed Pyreon packages.
+* Returns package names to exclude from Vite's dep optimizer.
+*/
+function scanPyreonPackages(root) {
+	const pyreonDir = join(root, "node_modules", "@pyreon");
+	if (!existsSync(pyreonDir)) return [];
+	try {
+		return readdirSync(pyreonDir).filter((name) => !name.startsWith(".")).map((name) => `@pyreon/${name}`);
+	} catch {
+		return [];
+	}
+}
 const VIRTUAL_ROUTES_ID = "virtual:zero/routes";
 const RESOLVED_VIRTUAL_ROUTES_ID = `\0${VIRTUAL_ROUTES_ID}`;
 const VIRTUAL_MIDDLEWARE_ID = "virtual:zero/route-middleware";
@@ -409,7 +472,7 @@ function zeroPlugin(userConfig = {}) {
 		},
 		async load(id) {
 			if (id === RESOLVED_VIRTUAL_ROUTES_ID) try {
-				return generateRouteModule(await scanRouteFiles(routesDir), routesDir);
+				return generateRouteModule(await scanRouteFiles(routesDir), routesDir, { staticImports: config.mode === "ssg" });
 			} catch (_err) {
 				return `export const routes = []`;
 			}
@@ -425,6 +488,16 @@ function zeroPlugin(userConfig = {}) {
 			}
 		},
 		configureServer(server) {
+			server.middlewares.use((req, res, next) => {
+				const accept = req.headers.accept ?? "";
+				if (!accept.includes("text/html") && !accept.includes("*/*")) return next();
+				const pathname = req.url?.split("?")[0] ?? "/";
+				if (pathname.startsWith("/@") || pathname.startsWith("/__")) return next();
+				if (/\.\w+$/.test(pathname)) return next();
+				handle404(server, routesDir, pathname, res).then((handled) => {
+					if (!handled) next();
+				}, () => next());
+			});
 			server.middlewares.use((req, res, next) => {
 				if (!(req.headers.accept ?? "").includes("text/html")) return next();
 				const originalEnd = res.end.bind(res);
@@ -442,7 +515,8 @@ function zeroPlugin(userConfig = {}) {
 				};
 				res.on("error", handleError);
 				try {
-					next();
+					const result = next();
+					if (result && typeof result.catch === "function") result.catch(handleError);
 				} catch (err) {
 					handleError(err);
 				}
@@ -462,9 +536,10 @@ function zeroPlugin(userConfig = {}) {
 				}
 			});
 		},
-		config() {
+		config(userConfig) {
 			return {
 				resolve: { conditions: ["bun"] },
+				optimizeDeps: { exclude: scanPyreonPackages(userConfig.root ?? process.cwd()) },
 				server: { port: config.port },
 				define: {
 					__ZERO_MODE__: JSON.stringify(config.mode),
@@ -474,6 +549,36 @@ function zeroPlugin(userConfig = {}) {
 		}
 	};
 }
+/**
+* Check if the requested path matches any route. If not, render a 404 page.
+* Returns true if the 404 was handled (response sent), false otherwise.
+*
+* In dev mode, the _404.tsx component cannot be SSR-rendered because
+* the compiler emits _tpl() calls that require `document`. Instead,
+* we return a static 404 page. The actual component rendering happens
+* on the client side when the SPA loads.
+*/
+async function handle404(server, _routesDir, pathname, res) {
+	const routes = (await server.ssrLoadModule(VIRTUAL_ROUTES_ID)).routes;
+	if (flattenRoutePatterns(routes).some((pattern) => matchPattern(pattern, pathname))) return false;
+	const html = await render404Page(void 0);
+	res.statusCode = 404;
+	res.setHeader("Content-Type", "text/html; charset=utf-8");
+	res.setHeader("Content-Length", Buffer.byteLength(html));
+	res.end(html);
+	return true;
+}
+/** Extract all URL patterns from a nested route tree. */
+function flattenRoutePatterns(routes, prefix = "") {
+	const patterns = [];
+	for (const route of routes) {
+		if (!route.path) continue;
+		const fullPath = route.path === "/" && prefix ? prefix : `${prefix}${route.path}`;
+		patterns.push(fullPath);
+		if (route.children) patterns.push(...flattenRoutePatterns(route.children, fullPath));
+	}
+	return patterns;
+}
 //#endregion
 //#region src/isr.ts
@@ -914,6 +1019,17 @@ function doPrefetch(href) {
 	} catch {}
 }
 /**
+* Prefetch a route's JS chunk by injecting `<link rel="prefetch">` into the
+* document head. Deduplicates — calling with the same href twice is a no-op.
+*
+* @example
+* prefetchRoute('/about')
+* prefetchRoute('/dashboard')
+*/
+function prefetchRoute(href) {
+	doPrefetch(href);
+}
+/**
 * Composable that provides all link behavior — navigation, prefetching,
 * active state, and viewport observation.
 *
@@ -1202,6 +1318,57 @@ function varyEncoding() {
 	};
 }
+//#endregion
+//#region src/middleware.ts
+/**
+* Compose multiple middleware into a single middleware function.
+* Middleware runs sequentially — if any returns a Response, the chain stops.
+*
+* @example
+* import { compose } from "@pyreon/zero/middleware"
+* import { corsMiddleware } from "@pyreon/zero/cors"
+* import { rateLimitMiddleware } from "@pyreon/zero/rate-limit"
+*
+* const combined = compose(
+*   corsMiddleware({ origin: "*" }),
+*   rateLimitMiddleware({ max: 100 }),
+*   cacheMiddleware(),
+* )
+*/
+function compose(...middlewares) {
+	return async (ctx) => {
+		for (const mw of middlewares) {
+			const result = await mw(ctx);
+			if (result instanceof Response) return result;
+		}
+	};
+}
+const ZERO_CTX_KEY = "__zeroCtx";
+/**
+* Get the shared Zero context from a middleware context.
+* Creates one if it doesn't exist. Middleware can use this to
+* pass data to downstream middleware without polluting `ctx.locals`.
+*
+* @example
+* const authMiddleware: Middleware = (ctx) => {
+*   const zctx = getContext(ctx)
+*   zctx.userId = "user_123"
+* }
+*
+* const loggingMiddleware: Middleware = (ctx) => {
+*   const zctx = getContext(ctx)
+*   console.log("User:", zctx.userId)
+* }
+*/
+function getContext(ctx) {
+	let zctx = ctx.locals[ZERO_CTX_KEY];
+	if (!zctx) {
+		zctx = {};
+		ctx.locals[ZERO_CTX_KEY] = zctx;
+	}
+	return zctx;
+}
 //#endregion
 //#region src/font.ts
 /**
@@ -1454,10 +1621,10 @@ function fontVariables(families) {
 //#endregion
 //#region src/image-plugin.ts
-let sharpWarned = false;
-function warnSharpMissing() {
-	if (sharpWarned) return;
-	sharpWarned = true;
+let sharpWarned$1 = false;
+function warnSharpMissing$1() {
+	if (sharpWarned$1) return;
+	sharpWarned$1 = true;
 	console.warn("\n[zero:image] sharp not installed — images will not be optimized. Install for full support: bun add -D sharp\n");
 }
 const IMAGE_EXT_RE = /\.(jpe?g|png|webp|avif)$/i;
@@ -1720,7 +1887,7 @@ async function resizeImage(input, output, width, format, quality) {
 		}
 		await pipeline.toFile(output);
 	} catch {
-		warnSharpMissing();
+		warnSharpMissing$1();
 		await writeFile(output, await readFile(input));
 	}
 }
@@ -1991,7 +2158,7 @@ function seoPlugin(config = {}) {
 		apply: "build",
 		async generateBundle(_, _bundle) {
 			if (config.sitemap) {
-				const { scanRouteFiles } = await import("./fs-router-n4VA4lxu.js").then((n) => n.n);
+				const { scanRouteFiles } = await import("./fs-router-Dil4IKZR.js").then((n) => n.n);
 				const routesDir = `${process.cwd()}/src/routes`;
 				try {
 					const sitemap = generateSitemap(await scanRouteFiles(routesDir), config.sitemap);
@@ -2021,7 +2188,7 @@ function seoMiddleware(config = {}) {
 	return async (ctx) => {
 		if (ctx.url.pathname === "/robots.txt" && config.robots) return new Response(generateRobots(config.robots), { headers: { "Content-Type": "text/plain" } });
 		if (ctx.url.pathname === "/sitemap.xml" && config.sitemap) try {
-			const { scanRouteFiles } = await import("./fs-router-n4VA4lxu.js").then((n) => n.n);
+			const { scanRouteFiles } = await import("./fs-router-Dil4IKZR.js").then((n) => n.n);
 			const sitemap = generateSitemap(await scanRouteFiles(`${process.cwd()}/src/routes`), config.sitemap);
 			return new Response(sitemap, { headers: { "Content-Type": "application/xml" } });
 		} catch {}
@@ -2308,5 +2475,693 @@ async function executeAction(action, req) {
 }
 //#endregion
-export { Image, Link, Script, ThemeToggle, bunAdapter, cacheMiddleware, compressResponse, compressionMiddleware, corsMiddleware, createActionMiddleware, createApiMiddleware, createApp, createISRHandler, createLink, createServer, zeroPlugin as default, defineAction, defineConfig, filePathToUrlPath, fontPlugin, fontVariables, generateApiRouteModule, generateMiddlewareModule, generateRobots, generateRouteModule, generateSitemap, imagePlugin, initTheme, isCompressible, jsonLd, nodeAdapter, parseFileRoutes, rateLimitMiddleware, resolveAdapter, resolveConfig, resolvedTheme, scanRouteFiles, securityHeaders, seoMiddleware, seoPlugin, setTheme, staticAdapter, theme, themeScript, toggleTheme, useLink, varyEncoding };
+//#region src/favicon.ts
+let sharpWarned = false;
+function warnSharpMissing() {
+	if (sharpWarned) return;
+	sharpWarned = true;
+	console.warn("\n[zero:favicon] sharp not installed — favicons will not be generated. Install for full support: bun add -D sharp\n");
+}
+const SIZES = [
+	{
+		size: 16,
+		name: "favicon-16x16.png"
+	},
+	{
+		size: 32,
+		name: "favicon-32x32.png"
+	},
+	{
+		size: 180,
+		name: "apple-touch-icon.png"
+	},
+	{
+		size: 192,
+		name: "icon-192.png"
+	},
+	{
+		size: 512,
+		name: "icon-512.png"
+	}
+];
+/**
+* Favicon generation Vite plugin.
+*
+* Generates all required favicon formats at build time from a single source.
+* In dev mode, serves the source directly.
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import { faviconPlugin } from "@pyreon/zero"
+*
+* export default {
+*   plugins: [faviconPlugin({ source: "./src/assets/icon.svg" })],
+* }
+* ```
+*/
+function faviconPlugin(config) {
+	const themeColor = config.themeColor ?? "#ffffff";
+	const backgroundColor = config.backgroundColor ?? "#ffffff";
+	const generateManifest = config.manifest !== false;
+	let root = "";
+	let isBuild = false;
+	return {
+		name: "pyreon-zero-favicon",
+		enforce: "pre",
+		configResolved(resolvedConfig) {
+			root = resolvedConfig.root;
+			isBuild = resolvedConfig.command === "build";
+		},
+		configureServer(server) {
+			const sourcePath = join(root, config.source);
+			server.middlewares.use(async (req, res, next) => {
+				const url = req.url ?? "";
+				if (url === "/favicon.svg" && config.source.endsWith(".svg")) try {
+					const content = await readFile(sourcePath, "utf-8");
+					res.setHeader("Content-Type", "image/svg+xml");
+					res.end(content);
+					return;
+				} catch {}
+				const sizeMatch = SIZES.find((s) => url === `/${s.name}`);
+				if (sizeMatch) {
+					const png = await resizeToPng(sourcePath, sizeMatch.size);
+					if (png) {
+						res.setHeader("Content-Type", "image/png");
+						res.setHeader("Cache-Control", "no-cache");
+						res.end(Buffer.from(png));
+						return;
+					}
+				}
+				if (url === "/favicon.ico") {
+					const ico = await generateIco(sourcePath);
+					if (ico) {
+						res.setHeader("Content-Type", "image/x-icon");
+						res.setHeader("Cache-Control", "no-cache");
+						res.end(Buffer.from(ico));
+						return;
+					}
+				}
+				if (url === "/site.webmanifest" && generateManifest) {
+					const manifest = {
+						name: config.name ?? "App",
+						short_name: config.name ?? "App",
+						icons: [{
+							src: "/icon-192.png",
+							sizes: "192x192",
+							type: "image/png"
+						}, {
+							src: "/icon-512.png",
+							sizes: "512x512",
+							type: "image/png"
+						}],
+						theme_color: themeColor,
+						background_color: backgroundColor,
+						display: "standalone"
+					};
+					res.setHeader("Content-Type", "application/manifest+json");
+					res.end(JSON.stringify(manifest, null, 2));
+					return;
+				}
+				next();
+			});
+		},
+		transformIndexHtml() {
+			const isSvg = config.source.endsWith(".svg");
+			const tags = [];
+			if (isSvg) tags.push({
+				tag: "link",
+				attrs: {
+					rel: "icon",
+					type: "image/svg+xml",
+					href: "/favicon.svg"
+				},
+				injectTo: "head"
+			});
+			tags.push({
+				tag: "link",
+				attrs: {
+					rel: "icon",
+					type: "image/png",
+					sizes: "32x32",
+					href: "/favicon-32x32.png"
+				},
+				injectTo: "head"
+			}, {
+				tag: "link",
+				attrs: {
+					rel: "icon",
+					type: "image/png",
+					sizes: "16x16",
+					href: "/favicon-16x16.png"
+				},
+				injectTo: "head"
+			}, {
+				tag: "link",
+				attrs: {
+					rel: "apple-touch-icon",
+					sizes: "180x180",
+					href: "/apple-touch-icon.png"
+				},
+				injectTo: "head"
+			});
+			if (generateManifest) tags.push({
+				tag: "link",
+				attrs: {
+					rel: "manifest",
+					href: "/site.webmanifest"
+				},
+				injectTo: "head"
+			});
+			tags.push({
+				tag: "meta",
+				attrs: {
+					name: "theme-color",
+					content: themeColor
+				},
+				injectTo: "head"
+			});
+			return tags;
+		},
+		async generateBundle() {
+			if (!isBuild) return;
+			const sourcePath = join(root, config.source);
+			if (!existsSync(sourcePath)) {
+				console.warn(`[zero:favicon] Source not found: ${sourcePath}`);
+				return;
+			}
+			if (config.source.endsWith(".svg")) {
+				const svgContent = await readFile(sourcePath, "utf-8");
+				let finalSvg = svgContent;
+				if (config.darkSource) {
+					const darkPath = join(root, config.darkSource);
+					if (existsSync(darkPath)) finalSvg = wrapSvgWithDarkMode(svgContent, await readFile(darkPath, "utf-8"));
+				}
+				this.emitFile({
+					type: "asset",
+					fileName: "favicon.svg",
+					source: finalSvg
+				});
+			}
+			for (const { size, name } of SIZES) {
+				const pngBuffer = await resizeToPng(sourcePath, size);
+				if (pngBuffer) this.emitFile({
+					type: "asset",
+					fileName: name,
+					source: pngBuffer
+				});
+			}
+			const ico = await generateIco(sourcePath);
+			if (ico) this.emitFile({
+				type: "asset",
+				fileName: "favicon.ico",
+				source: ico
+			});
+			if (generateManifest) {
+				const manifest = {
+					name: config.name ?? "App",
+					short_name: config.name ?? "App",
+					icons: [{
+						src: "/icon-192.png",
+						sizes: "192x192",
+						type: "image/png"
+					}, {
+						src: "/icon-512.png",
+						sizes: "512x512",
+						type: "image/png"
+					}],
+					theme_color: themeColor,
+					background_color: backgroundColor,
+					display: "standalone"
+				};
+				this.emitFile({
+					type: "asset",
+					fileName: "site.webmanifest",
+					source: JSON.stringify(manifest, null, 2)
+				});
+			}
+		}
+	};
+}
+/**
+* Wrap two SVGs into a single SVG that switches based on prefers-color-scheme.
+*/
+function wrapSvgWithDarkMode(lightSvg, darkSvg) {
+	return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${lightSvg.match(/viewBox="([^"]*)"/)?.[1] ?? "0 0 32 32"}">
+  <style>
+    :root { color-scheme: light dark; }
+    @media (prefers-color-scheme: dark) { .light { display: none; } }
+    @media (prefers-color-scheme: light), (prefers-color-scheme: no-preference) { .dark { display: none; } }
+  </style>
+  <g class="light">${stripSvgWrapper(lightSvg)}</g>
+  <g class="dark">${stripSvgWrapper(darkSvg)}</g>
+</svg>`;
+}
+function stripSvgWrapper(svg) {
+	return svg.replace(/<svg[^>]*>/, "").replace(/<\/svg>\s*$/, "").trim();
+}
+async function resizeToPng(input, size) {
+	try {
+		return await (await import("sharp").then((m) => m.default ?? m))(input).resize(size, size, {
+			fit: "contain",
+			background: {
+				r: 0,
+				g: 0,
+				b: 0,
+				alpha: 0
+			}
+		}).png().toBuffer();
+	} catch {
+		warnSharpMissing();
+		return null;
+	}
+}
+async function generateIco(input) {
+	try {
+		const sharp = await import("sharp").then((m) => m.default ?? m);
+		const png16 = await sharp(input).resize(16, 16, {
+			fit: "contain",
+			background: {
+				r: 0,
+				g: 0,
+				b: 0,
+				alpha: 0
+			}
+		}).png().toBuffer();
+		const png32 = await sharp(input).resize(32, 32, {
+			fit: "contain",
+			background: {
+				r: 0,
+				g: 0,
+				b: 0,
+				alpha: 0
+			}
+		}).png().toBuffer();
+		return createIcoFromPngs([{
+			buffer: png16,
+			size: 16
+		}, {
+			buffer: png32,
+			size: 32
+		}]);
+	} catch {
+		warnSharpMissing();
+		return null;
+	}
+}
+/** @internal Exported for testing */
+function createIcoFromPngs(entries) {
+	const headerSize = 6;
+	const dirEntrySize = 16;
+	const dirSize = dirEntrySize * entries.length;
+	let dataOffset = headerSize + dirSize;
+	const header = Buffer.alloc(headerSize);
+	header.writeUInt16LE(0, 0);
+	header.writeUInt16LE(1, 2);
+	header.writeUInt16LE(entries.length, 4);
+	const dirEntries = Buffer.alloc(dirSize);
+	const dataBuffers = [];
+	for (let i = 0; i < entries.length; i++) {
+		const entry = entries[i];
+		const offset = i * dirEntrySize;
+		dirEntries.writeUInt8(entry.size === 256 ? 0 : entry.size, offset);
+		dirEntries.writeUInt8(entry.size === 256 ? 0 : entry.size, offset + 1);
+		dirEntries.writeUInt8(0, offset + 2);
+		dirEntries.writeUInt8(0, offset + 3);
+		dirEntries.writeUInt16LE(1, offset + 4);
+		dirEntries.writeUInt16LE(32, offset + 6);
+		dirEntries.writeUInt32LE(entry.buffer.length, offset + 8);
+		dirEntries.writeUInt32LE(dataOffset, offset + 12);
+		dataOffset += entry.buffer.length;
+		dataBuffers.push(entry.buffer);
+	}
+	return Buffer.concat([
+		header,
+		dirEntries,
+		...dataBuffers
+	]);
+}
+//#endregion
+//#region src/i18n-routing.ts
+/**
+* Detect preferred locale from Accept-Language header.
+*/
+function detectLocaleFromHeader(acceptLanguage, locales, defaultLocale) {
+	if (!acceptLanguage) return defaultLocale;
+	const preferred = acceptLanguage.split(",").map((part) => {
+		const [lang, q] = part.trim().split(";q=");
+		return {
+			lang: lang?.split("-")[0]?.toLowerCase() ?? "",
+			quality: q ? Number.parseFloat(q) : 1
+		};
+	}).sort((a, b) => b.quality - a.quality);
+	for (const { lang } of preferred) if (locales.includes(lang)) return lang;
+	return defaultLocale;
+}
+/**
+* Extract locale from a URL path.
+* Returns { locale, pathWithoutLocale }.
+*/
+function extractLocaleFromPath(path, locales, defaultLocale) {
+	const segments = path.split("/").filter(Boolean);
+	const firstSegment = segments[0]?.toLowerCase();
+	if (firstSegment && locales.includes(firstSegment)) return {
+		locale: firstSegment,
+		pathWithoutLocale: "/" + segments.slice(1).join("/") || "/"
+	};
+	return {
+		locale: defaultLocale,
+		pathWithoutLocale: path
+	};
+}
+/**
+* Build a localized path.
+*/
+function buildLocalePath(path, locale, defaultLocale, strategy) {
+	const clean = path === "/" ? "" : path;
+	if (strategy === "prefix-except-default" && locale === defaultLocale) return path;
+	return `/${locale}${clean}`;
+}
+/**
+* Create a LocaleContext for use in components and loaders.
+*/
+function createLocaleContext(locale, path, config) {
+	const strategy = config.strategy ?? "prefix-except-default";
+	return {
+		locale,
+		locales: config.locales,
+		defaultLocale: config.defaultLocale,
+		localePath(targetPath, targetLocale) {
+			return buildLocalePath(targetPath, targetLocale ?? locale, config.defaultLocale, strategy);
+		},
+		alternates() {
+			const { pathWithoutLocale } = extractLocaleFromPath(path, config.locales, config.defaultLocale);
+			return config.locales.map((loc) => ({
+				locale: loc,
+				url: buildLocalePath(pathWithoutLocale, loc, config.defaultLocale, strategy)
+			}));
+		}
+	};
+}
+/**
+* I18n routing middleware for Zero's server.
+*
+* - Detects locale from URL prefix or Accept-Language header
+* - Redirects root to preferred locale (when detectLocale is true)
+* - Sets locale context for loaders and components
+*
+* @example
+* ```ts
+* // zero.config.ts
+* import { i18nRouting } from "@pyreon/zero"
+*
+* export default defineConfig({
+*   plugins: [
+*     i18nRouting({
+*       locales: ["en", "de", "cs"],
+*       defaultLocale: "en",
+*     }),
+*   ],
+* })
+* ```
+*/
+function i18nRouting(config) {
+	const strategy = config.strategy ?? "prefix-except-default";
+	const detectEnabled = config.detectLocale !== false;
+	const cookieName = config.cookieName ?? "locale";
+	return {
+		name: "pyreon-zero-i18n-routing",
+		configResolved() {},
+		configureServer(server) {
+			server.middlewares.use((req, res, next) => {
+				const url = req.url ?? "/";
+				if (url.startsWith("/@") || url.startsWith("/__") || url.includes(".")) return next();
+				const { locale } = extractLocaleFromPath(url, config.locales, config.defaultLocale);
+				if (detectEnabled && url === "/") {
+					const preferredFromCookie = parseCookies(req.headers.cookie)[cookieName];
+					const preferredFromHeader = detectLocaleFromHeader(req.headers["accept-language"], config.locales, config.defaultLocale);
+					const preferred = preferredFromCookie && config.locales.includes(preferredFromCookie) ? preferredFromCookie : preferredFromHeader;
+					if (strategy === "prefix" || preferred !== config.defaultLocale) {
+						res.writeHead(302, { Location: `/${preferred}/` });
+						res.end();
+						return;
+					}
+				}
+				req.__locale = locale;
+				req.__localeContext = createLocaleContext(locale, url, config);
+				localeSignal.set(locale);
+				next();
+			});
+		}
+	};
+}
+function parseCookies(header) {
+	if (!header) return {};
+	const result = {};
+	for (const pair of header.split(";")) {
+		const [key, value] = pair.trim().split("=");
+		if (key && value) result[key] = decodeURIComponent(value);
+	}
+	return result;
+}
+/** @internal Context for the current locale. */
+const LocaleCtx = createContext("en");
+/** Current locale signal — set by the server middleware or client-side detection. */
+const localeSignal = signal("en");
+/**
+* Read the current locale reactively.
+*
+* Returns the locale signal value directly — reactive in both SSR and CSR.
+* The server middleware sets `localeSignal` per-request, and client-side
+* `setLocale()` updates it as well.
+*
+* @example
+* ```tsx
+* const locale = useLocale() // "en", "de", etc.
+* ```
+*/
+function useLocale() {
+	return localeSignal();
+}
+/**
+* Set the locale client-side and update the URL.
+*
+* @example
+* ```tsx
+* <button onClick={() => setLocale('de')}>Deutsch</button>
+* ```
+*/
+function setLocale(locale, config) {
+	localeSignal.set(locale);
+	if (typeof document !== "undefined") document.cookie = `${config.cookieName ?? "locale"}=${locale}; path=/; max-age=31536000`;
+	if (typeof window !== "undefined") {
+		const strategy = config.strategy ?? "prefix-except-default";
+		const { pathWithoutLocale } = extractLocaleFromPath(window.location.pathname, config.locales, config.defaultLocale);
+		const newPath = buildLocalePath(pathWithoutLocale, locale, config.defaultLocale, strategy);
+		window.history.pushState(null, "", newPath);
+		window.dispatchEvent(new PopStateEvent("popstate"));
+	}
+}
+//#endregion
+//#region src/meta.tsx
+const resolveStr = (v) => typeof v === "function" ? v() : v;
+/**
+* Declarative meta component for SSR-compatible page metadata.
+*
+* Supports reactive title/description — when passed as `() => string` accessors,
+* they are forwarded to `useHead()` as a reactive getter so updates propagate
+* automatically via signal tracking.
+*
+* @example
+* ```tsx
+* <Meta title="My Page" description="..." image="/og.jpg" canonical="https://..." />
+* ```
+*
+* @example Reactive title
+* ```tsx
+* const count = signal(0)
+* <Meta title={() => `${count()} items`} />
+* ```
+*/
+function Meta(props) {
+	const hasReactiveTitle = typeof props.title === "function";
+	const hasReactiveDescription = typeof props.description === "function";
+	if (hasReactiveTitle || hasReactiveDescription) useHead((() => {
+		const title = resolveStr(props.title);
+		const description = resolveStr(props.description);
+		const tags = buildMetaTags({
+			...props,
+			title,
+			description
+		});
+		return {
+			title,
+			meta: tags.meta,
+			link: tags.link,
+			script: tags.script
+		};
+	}));
+	else {
+		const title = resolveStr(props.title);
+		const description = resolveStr(props.description);
+		const tags = buildMetaTags({
+			...props,
+			title,
+			description
+		});
+		useHead({
+			title,
+			meta: tags.meta,
+			link: tags.link,
+			script: tags.script
+		});
+	}
+	return props.children ?? null;
+}
+function buildMetaTags(props) {
+	const meta = [];
+	const link = [];
+	const script = [];
+	const { title, description, canonical, image, imageAlt, type = "website", siteName, twitterCard = "summary_large_image", twitterSite, twitterCreator, locale = "en_US", alternateLocales, robots = "index, follow", publishedTime, modifiedTime, author, tags, jsonLd, extra } = props;
+	if (description) meta.push({
+		name: "description",
+		content: description
+	});
+	if (robots) meta.push({
+		name: "robots",
+		content: robots
+	});
+	if (author) meta.push({
+		name: "author",
+		content: author
+	});
+	if (title) meta.push({
+		property: "og:title",
+		content: title
+	});
+	if (description) meta.push({
+		property: "og:description",
+		content: description
+	});
+	if (canonical) meta.push({
+		property: "og:url",
+		content: canonical
+	});
+	if (image) meta.push({
+		property: "og:image",
+		content: image
+	});
+	if (imageAlt) meta.push({
+		property: "og:image:alt",
+		content: imageAlt
+	});
+	meta.push({
+		property: "og:type",
+		content: type
+	});
+	if (siteName) meta.push({
+		property: "og:site_name",
+		content: siteName
+	});
+	meta.push({
+		property: "og:locale",
+		content: locale
+	});
+	if (type === "article") {
+		if (publishedTime) meta.push({
+			property: "article:published_time",
+			content: publishedTime
+		});
+		if (modifiedTime) meta.push({
+			property: "article:modified_time",
+			content: modifiedTime
+		});
+		if (author) meta.push({
+			property: "article:author",
+			content: author
+		});
+		if (tags) for (const tag of tags) meta.push({
+			property: "article:tag",
+			content: tag
+		});
+	}
+	meta.push({
+		name: "twitter:card",
+		content: twitterCard
+	});
+	if (title) meta.push({
+		name: "twitter:title",
+		content: title
+	});
+	if (description) meta.push({
+		name: "twitter:description",
+		content: description
+	});
+	if (image) meta.push({
+		name: "twitter:image",
+		content: image
+	});
+	if (imageAlt) meta.push({
+		name: "twitter:image:alt",
+		content: imageAlt
+	});
+	if (twitterSite) meta.push({
+		name: "twitter:site",
+		content: twitterSite
+	});
+	if (twitterCreator) meta.push({
+		name: "twitter:creator",
+		content: twitterCreator
+	});
+	if (canonical) link.push({
+		rel: "canonical",
+		href: canonical
+	});
+	if (alternateLocales) for (const alt of alternateLocales) link.push({
+		rel: "alternate",
+		hreflang: alt.locale,
+		href: alt.url
+	});
+	if (jsonLd) script.push({
+		type: "application/ld+json",
+		children: JSON.stringify({
+			"@context": "https://schema.org",
+			...jsonLd
+		})
+	});
+	if (extra) for (const tag of extra) meta.push(tag);
+	if (props.i18n) {
+		const i18nConfig = props.i18n;
+		const origin = props.origin ?? "";
+		const { pathWithoutLocale } = extractLocaleFromPath(canonical?.replace(origin, "") ?? "/", i18nConfig.locales, i18nConfig.defaultLocale);
+		const strategy = i18nConfig.strategy ?? "prefix-except-default";
+		for (const loc of i18nConfig.locales) {
+			const localizedPath = strategy === "prefix-except-default" && loc === i18nConfig.defaultLocale ? pathWithoutLocale : `/${loc}${pathWithoutLocale === "/" ? "" : pathWithoutLocale}`;
+			link.push({
+				rel: "alternate",
+				hreflang: loc,
+				href: `${origin}${localizedPath}`
+			});
+			if (loc !== locale) meta.push({
+				property: "og:locale:alternate",
+				content: loc
+			});
+		}
+		link.push({
+			rel: "alternate",
+			hreflang: "x-default",
+			href: `${origin}${pathWithoutLocale}`
+		});
+	}
+	return {
+		meta,
+		link,
+		script
+	};
+}
+//#endregion
+export { Image, Link, Meta, Script, ThemeToggle, buildLocalePath, buildMetaTags, bunAdapter, cacheMiddleware, compose, compressResponse, compressionMiddleware, corsMiddleware, createActionMiddleware, createApiMiddleware, createApp, createISRHandler, createLink, createLocaleContext, createServer, zeroPlugin as default, defineAction, defineConfig, detectLocaleFromHeader, extractLocaleFromPath, faviconPlugin, filePathToUrlPath, fontPlugin, fontVariables, generateApiRouteModule, generateMiddlewareModule, generateRobots, generateRouteModule, generateSitemap, getContext, i18nRouting, imagePlugin, initTheme, isCompressible, jsonLd, nodeAdapter, parseFileRoutes, prefetchRoute, rateLimitMiddleware, render404Page, resolveAdapter, resolveConfig, resolvedTheme, scanRouteFiles, securityHeaders, seoMiddleware, seoPlugin, setLocale, setTheme, staticAdapter, theme, themeScript, toggleTheme, useLink, useLocale, varyEncoding };
 //# sourceMappingURL=index.js.map