@pyreon/zero 0.12.3 → 0.12.5

package/lib/index.js

@@ -1,1094 +1,8 @@
-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, useRequestLocals } from "@pyreon/server";
-import { renderToString } from "@pyreon/runtime-server";
-import { existsSync, readdirSync } from "node:fs";
-import { basename, extname, join } from "node:path";
+import { createContext, createRef, onMount, onUnmount } from "@pyreon/core";
 import { effect, signal } from "@pyreon/reactivity";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { useRouter } from "@pyreon/router";
+import { useHead } from "@pyreon/head";
 
-//#region src/app.ts
-/**
-* Create a full Zero app — assembles router, head provider, and root layout.
-*
-* Used internally by entry-server and entry-client.
-*/
-function createApp(options) {
-	const router = createRouter({
-		routes: options.routes,
-		mode: options.routerMode ?? "history",
-		...options.url ? { url: options.url } : {},
-		scrollBehavior: "top"
-	});
-	const Layout = options.layout ?? DefaultLayout;
-	function App() {
-		return h(HeadProvider, null, h(RouterProvider, { router }, h(Layout, null, h(RouterView, null))));
-	}
-	return {
-		App,
-		router
-	};
-}
-function DefaultLayout(props) {
-	return h(Fragment, null, ...Array.isArray(props.children) ? props.children : [props.children]);
-}
-
-//#endregion
-//#region src/api-routes.ts
-/**
-* Match a URL path against an API route pattern.
-* Returns extracted params or null if no match.
-*/
-function matchApiRoute(pattern, path) {
-	const patternParts = pattern.split("/").filter(Boolean);
-	const pathParts = path.split("/").filter(Boolean);
-	const params = {};
-	for (let i = 0; i < patternParts.length; i++) {
-		const pp = patternParts[i];
-		if (!pp) continue;
-		if (pp.endsWith("*")) {
-			const paramName = pp.slice(1, -1);
-			params[paramName] = pathParts.slice(i).join("/");
-			return params;
-		}
-		if (i >= pathParts.length) return null;
-		if (pp.startsWith(":")) {
-			params[pp.slice(1)] = pathParts[i];
-			continue;
-		}
-		if (pp !== pathParts[i]) return null;
-	}
-	return patternParts.length === pathParts.length ? params : null;
-}
-const HTTP_METHODS = [
-	"GET",
-	"POST",
-	"PUT",
-	"PATCH",
-	"DELETE",
-	"HEAD",
-	"OPTIONS"
-];
-/**
-* Create a middleware that dispatches API route requests.
-* API routes are matched by URL pattern and HTTP method.
-*/
-function createApiMiddleware(routes) {
-	return async (ctx) => {
-		for (const route of routes) {
-			const params = matchApiRoute(route.pattern, ctx.path);
-			if (!params) continue;
-			const method = ctx.req.method.toUpperCase();
-			const handler = route.module[method];
-			if (!handler) {
-				const allowed = HTTP_METHODS.filter((m) => route.module[m]).join(", ");
-				return new Response(null, {
-					status: 405,
-					headers: {
-						Allow: allowed,
-						"Content-Type": "application/json"
-					}
-				});
-			}
-			return handler({
-				request: ctx.req,
-				url: ctx.url,
-				path: ctx.path,
-				params,
-				headers: ctx.req.headers
-			});
-		}
-	};
-}
-/**
-* Detect whether a route file is an API route.
-* API routes are `.ts` or `.js` files inside an `api/` directory.
-*/
-function isApiRoute(filePath) {
-	const normalized = filePath.replace(/\\/g, "/");
-	return normalized.startsWith("api/") && (normalized.endsWith(".ts") || normalized.endsWith(".js")) && !normalized.endsWith(".tsx") && !normalized.endsWith(".jsx");
-}
-/**
-* Convert an API route file path to a URL pattern.
-*
-* Examples:
-*   "api/posts.ts"        → "/api/posts"
-*   "api/posts/index.ts"  → "/api/posts"
-*   "api/posts/[id].ts"   → "/api/posts/:id"
-*   "api/[...path].ts"    → "/api/:path*"
-*/
-function apiFilePathToPattern(filePath) {
-	let route = filePath;
-	for (const ext of [".ts", ".js"]) if (route.endsWith(ext)) {
-		route = route.slice(0, -ext.length);
-		break;
-	}
-	const segments = route.split("/");
-	const urlSegments = [];
-	for (const seg of segments) {
-		if (seg === "index") continue;
-		const catchAll = seg.match(/^\[\.\.\.(\w+)\]$/);
-		if (catchAll) {
-			urlSegments.push(`:${catchAll[1]}*`);
-			continue;
-		}
-		const dynamic = seg.match(/^\[(\w+)\]$/);
-		if (dynamic) {
-			urlSegments.push(`:${dynamic[1]}`);
-			continue;
-		}
-		urlSegments.push(seg);
-	}
-	return `/${urlSegments.join("/")}`;
-}
-/**
-* Generate a virtual module that exports API route entries.
-* Each entry maps a URL pattern to a module with HTTP method handlers.
-*/
-function generateApiRouteModule(files, routesDir) {
-	const apiFiles = files.filter(isApiRoute);
-	if (apiFiles.length === 0) return "export const apiRoutes = []\n";
-	const imports = [];
-	const entries = [];
-	for (let i = 0; i < apiFiles.length; i++) {
-		const name = `_api${i}`;
-		const file = apiFiles[i];
-		if (!file) continue;
-		const fullPath = `${routesDir}/${file}`;
-		const pattern = apiFilePathToPattern(file);
-		imports.push(`import * as ${name} from "${fullPath}"`);
-		entries.push(`  { pattern: ${JSON.stringify(pattern)}, module: ${name} }`);
-	}
-	return [
-		...imports,
-		"",
-		"export const apiRoutes = [",
-		entries.join(",\n"),
-		"]"
-	].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
-/**
-* Create a middleware that dispatches per-route middleware based on URL pattern matching.
-*/
-function createRouteMiddlewareDispatcher(entries) {
-	return async (ctx) => {
-		for (const entry of entries) if (matchPattern(entry.pattern, ctx.path)) {
-			const mw = Array.isArray(entry.middleware) ? entry.middleware : [entry.middleware];
-			for (const fn of mw) {
-				const result = await fn(ctx);
-				if (result) return result;
-			}
-		}
-	};
-}
-/**
-* URL pattern matcher supporting :param and :param* segments.
-*
-* Rules:
-* - Static segments must match exactly
-* - `:param` matches a single path segment
-* - `:param*` matches all remaining segments (must be last, and path must
-*   have matched all preceding segments)
-* - Path length must match pattern length (unless catch-all)
-*/
-function matchPattern(pattern, path) {
-	const patternParts = pattern.split("/").filter(Boolean);
-	const pathParts = path.split("/").filter(Boolean);
-	for (let i = 0; i < patternParts.length; i++) {
-		const pp = patternParts[i];
-		if (pp.endsWith("*")) return i <= pathParts.length;
-		if (i >= pathParts.length) return false;
-		if (pp.startsWith(":")) continue;
-		if (pp !== pathParts[i]) return false;
-	}
-	return patternParts.length === pathParts.length;
-}
-/**
-* Create the SSR request handler for production.
-*
-* @example
-* import { routes } from "virtual:zero/routes"
-* import { routeMiddleware } from "virtual:zero/route-middleware"
-* import { createServer } from "@pyreon/zero"
-*
-* export default createServer({ routes, routeMiddleware, apiRoutes })
-*/
-function createServer(options) {
-	const config = options.config ?? {};
-	const allMiddleware = [];
-	if (options.apiRoutes?.length) allMiddleware.push(createApiMiddleware(options.apiRoutes));
-	if (options.routeMiddleware?.length) allMiddleware.push(createRouteMiddlewareDispatcher(options.routeMiddleware));
-	allMiddleware.push(...config.middleware ?? []);
-	allMiddleware.push(...options.middleware ?? []);
-	const { App } = createApp({
-		routes: options.routes,
-		routerMode: "history"
-	});
-	const handler = createHandler({
-		App,
-		routes: options.routes,
-		middleware: allMiddleware,
-		mode: config.ssr?.mode ?? "string",
-		...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
-//#region src/config.ts
-/**
-* Define a Zero configuration.
-* Used in `zero.config.ts` at the project root.
-*
-* @example
-* import { defineConfig } from "@pyreon/zero/config"
-*
-* export default defineConfig({
-*   mode: "ssr",
-*   ssr: { mode: "stream" },
-*   port: 3000,
-* })
-*/
-function defineConfig(config) {
-	return config;
-}
-/** Merge user config with defaults. */
-function resolveConfig(userConfig = {}) {
-	return {
-		mode: "ssr",
-		base: "/",
-		port: 3e3,
-		adapter: "node",
-		...userConfig,
-		ssr: {
-			mode: "string",
-			...userConfig.ssr
-		}
-	};
-}
-
-//#endregion
-//#region src/error-overlay.ts
-/**
-* Dev-only error overlay for SSR/loader errors.
-* Renders a styled HTML page with the error stack trace.
-*/
-function renderErrorOverlay(error) {
-	return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>SSR Error — Pyreon Zero</title>
-  <style>
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    body {
-      font-family: ui-monospace, "Cascadia Code", "Source Code Pro", Menlo, Consolas, monospace;
-      background: #1a1a2e;
-      color: #e0e0e0;
-      min-height: 100vh;
-      padding: 2rem;
-    }
-    .overlay {
-      max-width: 900px;
-      margin: 0 auto;
-    }
-    .header {
-      display: flex;
-      align-items: center;
-      gap: 0.75rem;
-      margin-bottom: 1.5rem;
-    }
-    .badge {
-      background: #e74c3c;
-      color: white;
-      padding: 0.25rem 0.75rem;
-      border-radius: 4px;
-      font-size: 0.75rem;
-      font-weight: 600;
-      text-transform: uppercase;
-      letter-spacing: 0.05em;
-    }
-    .label {
-      color: #888;
-      font-size: 0.85rem;
-    }
-    .message {
-      font-size: 1.25rem;
-      color: #ff6b6b;
-      margin-bottom: 1.5rem;
-      line-height: 1.5;
-      word-break: break-word;
-    }
-    .stack {
-      background: #16213e;
-      border: 1px solid #2a2a4a;
-      border-radius: 8px;
-      padding: 1.25rem;
-      overflow-x: auto;
-      font-size: 0.8rem;
-      line-height: 1.7;
-      white-space: pre-wrap;
-      word-break: break-all;
-    }
-    .stack .at { color: #888; }
-    .stack .file { color: #4ecdc4; }
-    .hint {
-      margin-top: 1.5rem;
-      padding: 1rem;
-      background: #1e2a45;
-      border-radius: 6px;
-      border-left: 3px solid #3498db;
-      font-size: 0.8rem;
-      color: #aaa;
-      line-height: 1.5;
-    }
-  </style>
-</head>
-<body>
-  <div class="overlay">
-    <div class="header">
-      <span class="badge">SSR Error</span>
-      <span class="label">Pyreon Zero — Dev Mode</span>
-    </div>
-    <div class="message">${escapeHtml(error.message || "Unknown error")}</div>
-    <pre class="stack">${formatStack(escapeHtml(error.stack || ""))}</pre>
-    <div class="hint">
-      This error occurred during server-side rendering. Check the terminal for
-      the full stack trace. This overlay is only shown in development.
-    </div>
-  </div>
-</body>
-</html>`;
-}
-function escapeHtml(str) {
-	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-function formatStack(stack) {
-	return stack.split("\n").map((line) => {
-		if (line.includes("at ")) {
-			const fileMatch = line.match(/\(([^)]+)\)/);
-			if (fileMatch) return line.replace(fileMatch[0], `(<span class="file">${fileMatch[1]}</span>)`);
-		}
-		return line;
-	}).join("\n");
-}
-
-//#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";
-const RESOLVED_VIRTUAL_MIDDLEWARE_ID = `\0${VIRTUAL_MIDDLEWARE_ID}`;
-const VIRTUAL_API_ROUTES_ID = "virtual:zero/api-routes";
-const RESOLVED_VIRTUAL_API_ROUTES_ID = `\0${VIRTUAL_API_ROUTES_ID}`;
-/**
-* Zero Vite plugin — adds file-based routing and zero-config conventions
-* on top of @pyreon/vite-plugin.
-*
-* @example
-* // vite.config.ts
-* import pyreon from "@pyreon/vite-plugin"
-* import zero from "@pyreon/zero"
-*
-* export default {
-*   plugins: [pyreon(), zero()],
-* }
-*/
-function zeroPlugin(userConfig = {}) {
-	const config = resolveConfig(userConfig);
-	let routesDir;
-	let root;
-	return {
-		name: "pyreon-zero",
-		enforce: "pre",
-		_zeroConfig: userConfig,
-		configResolved(resolvedConfig) {
-			root = resolvedConfig.root;
-			routesDir = `${root}/src/routes`;
-		},
-		resolveId(id) {
-			if (id === VIRTUAL_ROUTES_ID) return RESOLVED_VIRTUAL_ROUTES_ID;
-			if (id === VIRTUAL_MIDDLEWARE_ID) return RESOLVED_VIRTUAL_MIDDLEWARE_ID;
-			if (id === VIRTUAL_API_ROUTES_ID) return RESOLVED_VIRTUAL_API_ROUTES_ID;
-		},
-		async load(id) {
-			if (id === RESOLVED_VIRTUAL_ROUTES_ID) try {
-				return generateRouteModule(await scanRouteFiles(routesDir), routesDir, { staticImports: config.mode === "ssg" });
-			} catch (_err) {
-				return `export const routes = []`;
-			}
-			if (id === RESOLVED_VIRTUAL_MIDDLEWARE_ID) try {
-				return generateMiddlewareModule(await scanRouteFiles(routesDir), routesDir);
-			} catch (_err) {
-				return `export const routeMiddleware = []`;
-			}
-			if (id === RESOLVED_VIRTUAL_API_ROUTES_ID) try {
-				return generateApiRouteModule(await scanRouteFiles(routesDir), routesDir);
-			} catch (_err) {
-				return `export const apiRoutes = []`;
-			}
-		},
-		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();
-				}, (err) => {
-					console.error("[zero] Error in 404 handler:", err);
-					next();
-				});
-			});
-			server.middlewares.use((req, res, next) => {
-				if (!(req.headers.accept ?? "").includes("text/html")) return next();
-				const originalEnd = res.end.bind(res);
-				let errored = false;
-				const handleError = (err) => {
-					if (errored) return;
-					errored = true;
-					const error = err instanceof Error ? err : new Error(String(err));
-					server.ssrFixStacktrace(error);
-					const html = renderErrorOverlay(error);
-					res.statusCode = 500;
-					res.setHeader("Content-Type", "text/html; charset=utf-8");
-					res.setHeader("Content-Length", Buffer.byteLength(html));
-					originalEnd(html);
-				};
-				res.on("error", handleError);
-				try {
-					const result = next();
-					if (result && typeof result.catch === "function") result.catch(handleError);
-				} catch (err) {
-					handleError(err);
-				}
-			});
-			server.watcher.add(`${routesDir}/**/*.{tsx,jsx,ts,js}`);
-			server.watcher.on("all", (event, path) => {
-				if (path.startsWith(routesDir) && (event === "add" || event === "unlink")) {
-					for (const resolvedId of [
-						RESOLVED_VIRTUAL_ROUTES_ID,
-						RESOLVED_VIRTUAL_MIDDLEWARE_ID,
-						RESOLVED_VIRTUAL_API_ROUTES_ID
-					]) {
-						const mod = server.moduleGraph.getModuleById(resolvedId);
-						if (mod) server.moduleGraph.invalidateModule(mod);
-					}
-					server.ws.send({ type: "full-reload" });
-				}
-			});
-		},
-		config(userConfig) {
-			return {
-				resolve: { conditions: ["bun"] },
-				optimizeDeps: { exclude: scanPyreonPackages(userConfig.root ?? process.cwd()) },
-				server: { port: config.port },
-				define: {
-					__ZERO_MODE__: JSON.stringify(config.mode),
-					__ZERO_BASE__: JSON.stringify(config.base)
-				}
-			};
-		}
-	};
-}
-/**
-* 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
-/**
-* In-memory ISR cache with stale-while-revalidate semantics.
-*
-* Wraps an SSR handler and caches responses per URL path.
-* Serves stale content immediately while revalidating in the background.
-*/
-function createISRHandler(handler, config) {
-	const cache = /* @__PURE__ */ new Map();
-	const revalidating = /* @__PURE__ */ new Set();
-	const revalidateMs = config.revalidate * 1e3;
-	async function revalidate(url) {
-		const key = url.pathname;
-		if (revalidating.has(key)) return;
-		revalidating.add(key);
-		try {
-			const res = await handler(new Request(url.href, { method: "GET" }));
-			const html = await res.text();
-			const headers = {};
-			res.headers.forEach((v, k) => {
-				headers[k] = v;
-			});
-			cache.set(key, {
-				html,
-				headers,
-				timestamp: Date.now()
-			});
-		} catch {} finally {
-			revalidating.delete(key);
-		}
-	}
-	return async (req) => {
-		if (req.method !== "GET") return handler(req);
-		const url = new URL(req.url);
-		const key = url.pathname;
-		const entry = cache.get(key);
-		if (entry) {
-			const age = Date.now() - entry.timestamp;
-			if (age > revalidateMs) revalidate(url);
-			return new Response(entry.html, {
-				status: 200,
-				headers: {
-					...entry.headers,
-					"content-type": "text/html; charset=utf-8",
-					"x-isr-cache": age > revalidateMs ? "STALE" : "HIT",
-					"x-isr-age": String(Math.round(age / 1e3))
-				}
-			});
-		}
-		const res = await handler(req);
-		const html = await res.text();
-		const headers = {};
-		res.headers.forEach((v, k) => {
-			headers[k] = v;
-		});
-		cache.set(key, {
-			html,
-			headers,
-			timestamp: Date.now()
-		});
-		return new Response(html, {
-			status: 200,
-			headers: {
-				...headers,
-				"content-type": "text/html; charset=utf-8",
-				"x-isr-cache": "MISS"
-			}
-		});
-	};
-}
-
-//#endregion
-//#region src/adapters/validate.ts
-/**
-* Validate that adapter build inputs exist before copying.
-* Throws with a clear error message if directories are missing.
-* @internal
-*/
-async function validateBuildInputs(options) {
-	const { existsSync } = await import("node:fs");
-	if (!existsSync(options.clientOutDir)) throw new Error(`[zero:adapter] Client build output not found: ${options.clientOutDir}. Run "vite build" first.`);
-	if (!existsSync(options.serverEntry)) throw new Error(`[zero:adapter] Server entry not found: ${options.serverEntry}. Run "vite build --ssr" first.`);
-}
-
-//#endregion
-//#region src/adapters/bun.ts
-/**
-* Bun adapter — generates a standalone Bun.serve() entry.
-*/
-function bunAdapter() {
-	return {
-		name: "bun",
-		async build(options) {
-			await validateBuildInputs(options);
-			const { writeFile, cp, mkdir } = await import("node:fs/promises");
-			const { join } = await import("node:path");
-			const outDir = options.outDir;
-			await mkdir(outDir, { recursive: true });
-			await cp(options.clientOutDir, join(outDir, "client"), { recursive: true });
-			await cp(join(options.serverEntry, ".."), join(outDir, "server"), { recursive: true });
-			const port = options.config.port ?? 3e3;
-			const serverEntry = `
-const handler = (await import("./server/entry-server.js")).default
-const clientDir = new URL("./client/", import.meta.url).pathname
-
-Bun.serve({
-  port: ${port},
-  async fetch(req) {
-    const url = new URL(req.url)
-
-    // Try static files first
-    if (req.method === "GET") {
-      const filePath = clientDir + (url.pathname === "/" ? "index.html" : url.pathname)
-      // Prevent path traversal — ensure resolved path stays within clientDir
-      const resolved = Bun.resolveSync(filePath, ".")
-      if (!resolved.startsWith(Bun.resolveSync(clientDir, "."))) {
-        return new Response("Forbidden", { status: 403 })
-      }
-      const file = Bun.file(filePath)
-      if (await file.exists()) {
-        return new Response(file, {
-          headers: {
-            "cache-control": filePath.endsWith(".js") || filePath.endsWith(".css")
-              ? "public, max-age=31536000, immutable"
-              : "public, max-age=3600",
-          },
-        })
-      }
-    }
-
-    // Fall through to SSR handler
-    return handler(req)
-  },
-})
-
-console.log("\\n  ⚡ Zero production server running on http://localhost:${port}\\n")
-`.trimStart();
-			await writeFile(join(outDir, "index.ts"), serverEntry);
-		}
-	};
-}
-
-//#endregion
-//#region src/adapters/cloudflare.ts
-/**
-* Cloudflare Pages adapter — generates output for Cloudflare Pages with Functions.
-*
-* Produces:
-* - Client assets in the output directory root (served as static)
-* - `_worker.js` — Cloudflare Pages Function for SSR
-*
-* Note: Cloudflare Pages Functions have a ~1MB module size limit.
-* For large apps, configure Vite's SSR build to bundle server code:
-* `ssr: { noExternal: true }` in vite.config.ts.
-*
-* Deploy with: `npx wrangler pages deploy ./dist`
-*
-* @example
-* ```ts
-* // zero.config.ts
-* import { defineConfig } from "@pyreon/zero"
-*
-* export default defineConfig({
-*   adapter: "cloudflare",
-* })
-* ```
-*/
-function cloudflareAdapter() {
-	return {
-		name: "cloudflare",
-		async build(options) {
-			await validateBuildInputs(options);
-			const { writeFile, cp, mkdir } = await import("node:fs/promises");
-			const { join } = await import("node:path");
-			const outDir = options.outDir;
-			await mkdir(outDir, { recursive: true });
-			await cp(options.clientOutDir, outDir, { recursive: true });
-			await cp(join(options.serverEntry, ".."), join(outDir, "_server"), { recursive: true });
-			const workerEntry = `
-import handler from "./_server/entry-server.js"
-
-export default {
-  async fetch(request, env, ctx) {
-    const url = new URL(request.url)
-
-    // Let Cloudflare serve static assets (files with extensions)
-    // This check is a fallback — Pages routes static files automatically
-    const ext = url.pathname.split(".").pop()
-    if (ext && ext !== url.pathname && !url.pathname.endsWith("/")) {
-      // Cloudflare Pages handles static assets automatically via its asset binding
-      // Only reach here if the file doesn't exist — fall through to SSR
-    }
-
-    // SSR handler
-    try {
-      return await handler(request)
-    } catch (err) {
-      return new Response("Internal Server Error", { status: 500 })
-    }
-  },
-}
-`.trimStart();
-			await writeFile(join(outDir, "_worker.js"), workerEntry);
-			await writeFile(join(outDir, "_routes.json"), JSON.stringify({
-				version: 1,
-				include: ["/*"],
-				exclude: [
-					"/assets/*",
-					"/favicon.*",
-					"/site.webmanifest",
-					"/robots.txt",
-					"/sitemap.xml"
-				]
-			}, null, 2));
-		}
-	};
-}
-
-//#endregion
-//#region src/adapters/netlify.ts
-/**
-* Netlify adapter — generates output for Netlify Functions (v2).
-*
-* Produces:
-* - Client assets in `publish/` directory
-* - `netlify/functions/ssr.mjs` — Netlify Function for SSR
-* - `netlify.toml` — routing configuration
-*
-* @example
-* ```ts
-* // zero.config.ts
-* import { defineConfig } from "@pyreon/zero"
-*
-* export default defineConfig({
-*   adapter: "netlify",
-* })
-* ```
-*/
-function netlifyAdapter() {
-	return {
-		name: "netlify",
-		async build(options) {
-			await validateBuildInputs(options);
-			const { writeFile, cp, mkdir } = await import("node:fs/promises");
-			const { join } = await import("node:path");
-			const outDir = options.outDir;
-			const publishDir = join(outDir, "publish");
-			const functionsDir = join(outDir, "netlify", "functions");
-			await mkdir(publishDir, { recursive: true });
-			await mkdir(functionsDir, { recursive: true });
-			await cp(options.clientOutDir, publishDir, { recursive: true });
-			await cp(join(options.serverEntry, ".."), join(functionsDir, "_server"), { recursive: true });
-			const funcEntry = `
-import handler from "./_server/entry-server.js"
-
-export default async function(req, context) {
-  try {
-    return await handler(req)
-  } catch (err) {
-    return new Response("Internal Server Error", { status: 500 })
-  }
-}
-
-export const config = {
-  path: "/*",
-  preferStatic: true,
-}
-`.trimStart();
-			await writeFile(join(functionsDir, "ssr.mjs"), funcEntry);
-			const toml = `
-[build]
-  publish = "publish"
-  functions = "netlify/functions"
-
-[[headers]]
-  for = "/assets/*"
-  [headers.values]
-    Cache-Control = "public, max-age=31536000, immutable"
-
-[[redirects]]
-  from = "/*"
-  to = "/.netlify/functions/ssr"
-  status = 200
-  conditions = {Role = ["admin", "user", ""]}
-`.trimStart();
-			await writeFile(join(outDir, "netlify.toml"), toml);
-		}
-	};
-}
-
-//#endregion
-//#region src/adapters/node.ts
-/**
-* Node.js adapter — generates a standalone server entry using node:http.
-*/
-function nodeAdapter() {
-	return {
-		name: "node",
-		async build(options) {
-			await validateBuildInputs(options);
-			const { writeFile, cp, mkdir } = await import("node:fs/promises");
-			const { join } = await import("node:path");
-			const outDir = options.outDir;
-			await mkdir(outDir, { recursive: true });
-			await cp(options.clientOutDir, join(outDir, "client"), { recursive: true });
-			await cp(join(options.serverEntry, ".."), join(outDir, "server"), { recursive: true });
-			const port = options.config.port ?? 3e3;
-			const serverEntry = `
-import { createServer } from "node:http"
-import { readFile } from "node:fs/promises"
-import { join, extname } from "node:path"
-import { fileURLToPath } from "node:url"
-
-const __dirname = fileURLToPath(new URL(".", import.meta.url))
-const handler = (await import("./server/entry-server.js")).default
-const clientDir = join(__dirname, "client")
-
-const MIME_TYPES = {
-  ".html": "text/html",
-  ".js": "application/javascript",
-  ".css": "text/css",
-  ".json": "application/json",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".svg": "image/svg+xml",
-  ".woff2": "font/woff2",
-  ".woff": "font/woff",
-  ".ico": "image/x-icon",
-}
-
-const server = createServer(async (req, res) => {
-  const url = new URL(req.url ?? "/", "http://localhost")
-
-  // Try to serve static files first
-  if (req.method === "GET") {
-    try {
-      const filePath = join(clientDir, url.pathname === "/" ? "index.html" : url.pathname)
-      // Prevent path traversal — ensure resolved path stays within clientDir
-      const { resolve } = await import("node:path")
-      const resolved = resolve(filePath)
-      if (!resolved.startsWith(resolve(clientDir))) {
-        res.writeHead(403)
-        res.end("Forbidden")
-        return
-      }
-      const ext = extname(filePath)
-      if (ext && ext !== ".html") {
-        const data = await readFile(filePath)
-        const mime = MIME_TYPES[ext] || "application/octet-stream"
-        res.writeHead(200, {
-          "content-type": mime,
-          "cache-control": ext === ".js" || ext === ".css"
-            ? "public, max-age=31536000, immutable"
-            : "public, max-age=3600",
-        })
-        res.end(data)
-        return
-      }
-    } catch {}
-  }
-
-  // Fall through to SSR handler
-  const headers = {}
-  for (const [key, value] of Object.entries(req.headers)) {
-    if (value) headers[key] = Array.isArray(value) ? value.join(", ") : value
-  }
-
-  const request = new Request(url.href, {
-    method: req.method,
-    headers,
-  })
-
-  const response = await handler(request)
-  const body = await response.text()
-
-  const responseHeaders = {}
-  response.headers.forEach((v, k) => { responseHeaders[k] = v })
-
-  res.writeHead(response.status, responseHeaders)
-  res.end(body)
-})
-
-server.listen(${port}, () => {
-  console.log("\\n  ⚡ Zero production server running on http://localhost:${port}\\n")
-})
-`.trimStart();
-			await writeFile(join(outDir, "index.js"), serverEntry);
-			await writeFile(join(outDir, "package.json"), JSON.stringify({ type: "module" }, null, 2));
-		}
-	};
-}
-
-//#endregion
-//#region src/adapters/static.ts
-/**
-* Static adapter — just copies the client build output.
-* Used with SSG mode where all pages are pre-rendered at build time.
-*/
-function staticAdapter() {
-	return {
-		name: "static",
-		async build(options) {
-			const { cp, mkdir } = await import("node:fs/promises");
-			await mkdir(options.outDir, { recursive: true });
-			await cp(options.clientOutDir, options.outDir, { recursive: true });
-		}
-	};
-}
-
-//#endregion
-//#region src/adapters/vercel.ts
-/**
-* Vercel adapter — generates output for Vercel's Build Output API v3.
-*
-* Produces a `.vercel/output` directory with:
-* - `static/` — client-side assets (JS, CSS, images)
-* - `functions/ssr.func/` — serverless function for SSR
-* - `config.json` — routing configuration
-*
-* @example
-* ```ts
-* // zero.config.ts
-* import { defineConfig } from "@pyreon/zero"
-*
-* export default defineConfig({
-*   adapter: "vercel",
-* })
-* ```
-*/
-function vercelAdapter() {
-	return {
-		name: "vercel",
-		async build(options) {
-			await validateBuildInputs(options);
-			const { writeFile, cp, mkdir } = await import("node:fs/promises");
-			const { join } = await import("node:path");
-			const vercelDir = join(options.outDir, ".vercel", "output");
-			const staticDir = join(vercelDir, "static");
-			const funcDir = join(vercelDir, "functions", "ssr.func");
-			await mkdir(staticDir, { recursive: true });
-			await mkdir(funcDir, { recursive: true });
-			await cp(options.clientOutDir, staticDir, { recursive: true });
-			await cp(join(options.serverEntry, ".."), funcDir, { recursive: true });
-			const funcEntry = `
-export default async function handler(req) {
-  const handler = (await import("./entry-server.js")).default
-  return handler(req)
-}
-`.trimStart();
-			await writeFile(join(funcDir, "index.js"), funcEntry);
-			await writeFile(join(funcDir, ".vc-config.json"), JSON.stringify({
-				runtime: "nodejs20.x",
-				handler: "index.js",
-				launcherType: "Nodejs"
-			}, null, 2));
-			await writeFile(join(vercelDir, "config.json"), JSON.stringify({
-				version: 3,
-				routes: [
-					{
-						src: "/assets/(.*)",
-						headers: { "Cache-Control": "public, max-age=31536000, immutable" }
-					},
-					{
-						src: "/(favicon\\..*|site\\.webmanifest|robots\\.txt|sitemap\\.xml)",
-						dest: "/$1"
-					},
-					{
-						src: "/(.*)",
-						dest: "/ssr"
-					}
-				]
-			}, null, 2));
-		}
-	};
-}
-
-//#endregion
-//#region src/adapters/index.ts
-/**
-* Resolve the adapter from config.
-* Returns a built-in adapter or throws if unknown.
-*/
-function resolveAdapter(config) {
-	const name = config.adapter ?? "node";
-	switch (name) {
-		case "node": return nodeAdapter();
-		case "bun": return bunAdapter();
-		case "static": return staticAdapter();
-		case "vercel": return vercelAdapter();
-		case "cloudflare": return cloudflareAdapter();
-		case "netlify": return netlifyAdapter();
-		default: throw new Error(`[zero] Unknown adapter: "${name}". Use "node", "bun", "static", "vercel", "cloudflare", or "netlify".`);
-	}
-}
-
-//#endregion
 //#region src/utils/use-intersection-observer.ts
 /**
 * Observes an element and calls `onIntersect` once it enters the viewport.
@@ -1124,7 +38,7 @@ function useIntersectionObserver(getElement, onIntersect, rootMargin = "200px")
 */
 /** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */
 const EMPTY_PROPS = {};
-function h$1(type, props, ...children) {
+function h(type, props, ...children) {
 	return {
 		type,
 		props: props ?? EMPTY_PROPS,
@@ -1155,11 +69,11 @@ function jsx(type, props, key) {
 		...rest,
 		key
 	} : rest;
-	if (typeof type === "function") return h$1(type, children !== void 0 ? {
+	if (typeof type === "function") return h(type, children !== void 0 ? {
 		...propsWithKey,
 		children
 	} : propsWithKey);
-	return h$1(type, propsWithKey, ...children === void 0 ? [] : Array.isArray(children) ? children : [children]);
+	return h(type, propsWithKey, ...children === void 0 ? [] : Array.isArray(children) ? children : [children]);
 }
 const jsxs = jsx;
 
@@ -1492,702 +406,349 @@ function Script(props) {
 }
 
 //#endregion
-//#region src/cache.ts
-const HASHED_ASSET = /\.[a-f0-9]{8,}\.\w+$/;
-const STATIC_EXT = /\.(png|jpe?g|gif|svg|webp|avif|ico|woff2?|ttf|otf|eot|mp4|webm|ogg|mp3|wav)$/i;
-const SCRIPT_EXT = /\.(js|css|mjs)$/i;
-/** @internal Exported for testing */
-function matchGlob(pattern, path) {
-	const regex = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
-	return new RegExp(`^${regex}$`).test(path);
-}
-function resolveControl(path, immutableDuration, staticDuration, pageDuration, swr) {
-	if (HASHED_ASSET.test(path)) return `public, max-age=${immutableDuration}, immutable`;
-	if (SCRIPT_EXT.test(path)) return `public, max-age=3600, stale-while-revalidate=${swr}`;
-	if (STATIC_EXT.test(path)) return `public, max-age=${staticDuration}, stale-while-revalidate=${swr}`;
-	if (pageDuration > 0) return `public, max-age=${pageDuration}, stale-while-revalidate=${swr}`;
-	return "no-cache";
-}
+//#region src/i18n-routing.ts
 /**
-* Cache control middleware for Zero.
-* Sets Cache-Control headers on the response based on asset type.
-*
-* @example
-* import { cacheMiddleware } from "@pyreon/zero/cache"
-*
-* export default createHandler({
-*   routes,
-*   middleware: [
-*     cacheMiddleware({
-*       pages: 60,
-*       staleWhileRevalidate: 300,
-*       rules: [
-*         { match: "/api/*", control: "no-store" },
-*       ],
-*     }),
-*   ],
-* })
+* Extract locale from a URL path.
+* Returns { locale, pathWithoutLocale }.
 */
-function cacheMiddleware(config = {}) {
-	const immutableDuration = config.immutable ?? 31536e3;
-	const staticDuration = config.static ?? 86400;
-	const pageDuration = config.pages ?? 0;
-	const swr = config.staleWhileRevalidate ?? 60;
-	const rules = config.rules ?? [];
-	return (ctx) => {
-		const path = ctx.url.pathname;
-		for (const rule of rules) if (matchGlob(rule.match, path)) {
-			ctx.headers.set("Cache-Control", rule.control);
-			return;
-		}
-		const control = resolveControl(path, immutableDuration, staticDuration, pageDuration, swr);
-		ctx.headers.set("Cache-Control", control);
+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("/") || "/"
 	};
-}
-/**
-* Security headers middleware.
-* Adds common security headers to all responses.
-*/
-function securityHeaders() {
-	return (ctx) => {
-		ctx.headers.set("X-Content-Type-Options", "nosniff");
-		ctx.headers.set("X-Frame-Options", "DENY");
-		ctx.headers.set("X-XSS-Protection", "1; mode=block");
-		ctx.headers.set("Referrer-Policy", "strict-origin-when-cross-origin");
-		ctx.headers.set("Permissions-Policy", "camera=(), microphone=(), geolocation=()");
+	return {
+		locale: defaultLocale,
+		pathWithoutLocale: path
 	};
 }
 /**
-* Compression detection middleware.
-* Sets Vary: Accept-Encoding header so caches can serve compressed variants.
-* Actual compression is handled by the runtime (Bun/Node) or reverse proxy.
+* Build a localized path.
 */
-function varyEncoding() {
-	return (ctx) => {
-		const existing = ctx.headers.get("Vary");
-		if (!existing?.includes("Accept-Encoding")) ctx.headers.set("Vary", existing ? `${existing}, Accept-Encoding` : "Accept-Encoding");
-	};
+function buildLocalePath(path, locale, defaultLocale, strategy) {
+	const clean = path === "/" ? "" : path;
+	if (strategy === "prefix-except-default" && locale === defaultLocale) return path;
+	return `/${locale}${clean}`;
 }
-
-//#endregion
-//#region src/middleware.ts
+/** @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");
 /**
-* 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"
+* Read the current locale reactively.
 *
-* 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`.
+* 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
-* 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
-/**
-* Normalize a GoogleFontInput (string or object) into a ResolvedFont.
-*/
-function resolveGoogleFont(input) {
-	if (typeof input === "string") return parseGoogleFamily(input);
-	if (input.variable) return {
-		family: input.family,
-		italic: input.italic ?? false,
-		variable: true,
-		weightRange: input.weightRange
-	};
-	return {
-		family: input.family,
-		italic: input.italic ?? false,
-		variable: false,
-		weights: input.weights
-	};
-}
-/**
-* Parse Google Fonts family string shorthand.
-*
-* Static weights: "Inter:wght@400;500;700"
-* Variable range:  "Inter:wght@100..900"
-* Variable with italic: "Inter:ital,wght@100..900"
-*/
-function parseGoogleFamily(input) {
-	const parts = input.split(":");
-	const family = (parts[0] ?? "").trim();
-	const spec = parts[1];
-	let italic = false;
-	if (spec) {
-		italic = spec.includes("ital");
-		const rangeMatch = spec.match(/wght@(\d+)\.\.(\d+)/);
-		if (rangeMatch && rangeMatch[1] && rangeMatch[2]) return {
-			family,
-			italic,
-			variable: true,
-			weightRange: [Number(rangeMatch[1]), Number(rangeMatch[2])]
-		};
-		const afterAt = spec.split("@")[1];
-		if (afterAt) {
-			const entries = afterAt.split(";").filter(Boolean);
-			const weights = /* @__PURE__ */ new Set();
-			for (const entry of entries) if (entry.includes(",")) {
-				const parts = entry.split(",");
-				const weight = Number(parts[parts.length - 1]);
-				if (weight > 0) weights.add(weight);
-				if (parts[0] === "1") italic = true;
-			} else if (entry.includes("..")) {} else {
-				const weight = Number(entry);
-				if (weight > 0) weights.add(weight);
-			}
-			if (weights.size > 0) return {
-				family,
-				italic,
-				variable: false,
-				weights: [...weights].sort((a, b) => a - b)
-			};
-		}
-	}
-	return {
-		family,
-		italic,
-		variable: false,
-		weights: [400]
-	};
-}
-/**
-* Generate a Google Fonts CSS URL.
-*/
-function googleFontsUrl(families, display = "swap") {
-	return `https://fonts.googleapis.com/css2?${families.map((f) => {
-		const axes = f.italic ? "ital,wght" : "wght";
-		const name = f.family.replace(/ /g, "+");
-		if (f.variable) {
-			const range = `${f.weightRange[0]}..${f.weightRange[1]}`;
-			return `family=${name}:${axes}@${f.italic ? `0,${range};1,${range}` : range}`;
-		}
-		return `family=${name}:${axes}@${f.weights.map((w) => f.italic ? `0,${w};1,${w}` : String(w)).join(";")}`;
-	}).join("&")}&display=${display}`;
-}
-/**
-* Generate @font-face CSS for local fonts.
-*/
-function localFontFaces(fonts, display) {
-	return fonts.map((f) => `@font-face {
-  font-family: "${f.family}";
-  src: url("${f.src}");
-  font-weight: ${f.weight ?? "400"};
-  font-style: ${f.style ?? "normal"};
-  font-display: ${f.display ?? display};
-}`).join("\n\n");
-}
-/**
-* Generate size-adjusted fallback @font-face declarations to reduce CLS.
-*/
-function fallbackFontFaces(fallbacks) {
-	return Object.entries(fallbacks).map(([family, metrics]) => {
-		const overrides = [];
-		if (metrics.sizeAdjust != null) overrides.push(`  size-adjust: ${metrics.sizeAdjust * 100}%;`);
-		if (metrics.ascentOverride != null) overrides.push(`  ascent-override: ${metrics.ascentOverride}%;`);
-		if (metrics.descentOverride != null) overrides.push(`  descent-override: ${metrics.descentOverride}%;`);
-		if (metrics.lineGapOverride != null) overrides.push(`  line-gap-override: ${metrics.lineGapOverride}%;`);
-		return `@font-face {
-  font-family: "${family} Fallback";
-  src: local("${metrics.fallback}");
-${overrides.join("\n")}
-}`;
-	}).join("\n\n");
-}
-/**
-* Generate preload link tags for critical font files.
-*/
-function preloadTags(fonts) {
-	return fonts.map((f) => {
-		const ext = f.src.split(".").pop();
-		const type = ext === "woff2" ? "font/woff2" : ext === "woff" ? "font/woff" : ext === "ttf" ? "font/ttf" : "font/otf";
-		return `<link rel="preload" href="${f.src}" as="font" type="${type}" crossorigin>`;
-	}).join("\n");
-}
-/**
-* Download Google Fonts CSS with woff2 user agent.
-*/
-async function downloadGoogleFontsCSS(url) {
-	const response = await fetch(url, { headers: { "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" } });
-	if (!response.ok) throw new Error(`Failed to fetch Google Fonts CSS: ${response.status}`);
-	return response.text();
-}
-/**
-* Download a font file.
-*/
-async function downloadFontFile(url) {
-	const response = await fetch(url);
-	if (!response.ok) throw new Error(`Failed to download font: ${url}`);
-	const arrayBuffer = await response.arrayBuffer();
-	return Buffer.from(arrayBuffer);
-}
-/**
-* Extract font file URLs from Google Fonts CSS.
-*/
-function extractFontUrls(css) {
-	const urls = [];
-	for (const match of css.matchAll(/url\((https:\/\/fonts\.gstatic\.com\/[^)]+)\)/g)) if (match[1]) urls.push(match[1]);
-	return urls;
-}
-/**
-* Self-host Google Fonts: download CSS + font files, rewrite URLs to local paths.
+* ```tsx
+* const locale = useLocale() // "en", "de", etc.
+* ```
 */
-async function selfHostFonts(cssUrl, fontsSubDir, root) {
-	const cacheDir = join(root, "node_modules", ".cache", "zero-fonts");
-	const cachePath = join(cacheDir, `${Buffer.from(cssUrl).toString("base64url")}.json`);
-	try {
-		const cached = JSON.parse(await readFile(cachePath, "utf-8"));
-		if (cached.css && cached.fontFiles) return {
-			css: cached.css,
-			fontFiles: cached.fontFiles.map((f) => ({
-				name: f.name,
-				content: Buffer.from(f.content, "base64")
-			}))
-		};
-	} catch {}
-	const css = await downloadGoogleFontsCSS(cssUrl);
-	const fontUrls = extractFontUrls(css);
-	const fontFiles = [];
-	let rewrittenCss = css;
-	for (const url of fontUrls) {
-		const fileName = url.split("/").at(-1)?.split("?")[0] ?? "font";
-		const content = await downloadFontFile(url);
-		fontFiles.push({
-			name: fileName,
-			content
-		});
-		rewrittenCss = rewrittenCss.replace(url, `/${fontsSubDir}/${fileName}`);
-	}
-	try {
-		await mkdir(cacheDir, { recursive: true });
-		await writeFile(cachePath, JSON.stringify({
-			css: rewrittenCss,
-			fontFiles: fontFiles.map((f) => ({
-				name: f.name,
-				content: f.content.toString("base64")
-			}))
-		}));
-	} catch {}
-	return {
-		css: rewrittenCss,
-		fontFiles
-	};
+function useLocale() {
+	return localeSignal();
 }
 /**
-* Zero font optimization Vite plugin.
-*
-* Dev mode: injects Google Fonts CDN link for fast startup.
-* Build mode: downloads and self-hosts fonts for maximum performance + privacy.
+* Set the locale client-side and update the URL.
 *
 * @example
-* import { fontPlugin } from "@pyreon/zero/font"
-*
-* export default {
-*   plugins: [
-*     pyreon(),
-*     zero(),
-*     fontPlugin({
-*       google: ["Inter:wght@400;500;600;700", "JetBrains Mono:wght@400"],
-*       fallbacks: {
-*         "Inter": { fallback: "Arial", sizeAdjust: 1.07, ascentOverride: 90 },
-*       },
-*     }),
-*   ],
-* }
+* ```tsx
+* <button onClick={() => setLocale('de')}>Deutsch</button>
+* ```
 */
-function fontPlugin(config = {}) {
-	const display = config.display ?? "swap";
-	const shouldPreload = config.preload !== false;
-	const shouldSelfHost = config.selfHost !== false;
-	const googleFamilies = (config.google ?? []).map(resolveGoogleFont);
-	let isBuild = false;
-	let root = "";
-	let selfHostedCSS = "";
-	let selfHostedFontFiles = [];
-	return {
-		name: "pyreon-zero-fonts",
-		configResolved(resolvedConfig) {
-			isBuild = resolvedConfig.command === "build";
-			root = resolvedConfig.root;
-		},
-		async buildStart() {
-			if (isBuild && shouldSelfHost && googleFamilies.length > 0) {
-				const cssUrl = googleFontsUrl(googleFamilies, display);
-				try {
-					const result = await selfHostFonts(cssUrl, "assets/fonts", root);
-					selfHostedCSS = result.css;
-					selfHostedFontFiles = result.fontFiles;
-				} catch {}
-			}
-		},
-		generateBundle() {
-			for (const file of selfHostedFontFiles) this.emitFile({
-				type: "asset",
-				fileName: `assets/fonts/${file.name}`,
-				source: file.content
-			});
-		},
-		transformIndexHtml(html) {
-			const tags = [];
-			collectGoogleFontTags(tags, {
-				isBuild,
-				selfHostedCSS,
-				selfHostedFontFiles,
-				shouldPreload,
-				googleFamilies,
-				display
-			});
-			collectLocalFontTags(tags, config, shouldPreload, display);
-			if (tags.length === 0) return html;
-			return html.replace("</head>", `${tags.join("\n")}\n</head>`);
-		}
-	};
-}
-function collectGoogleFontTags(tags, opts) {
-	if (opts.isBuild && opts.selfHostedCSS) {
-		tags.push(`<style>${opts.selfHostedCSS}</style>`);
-		if (opts.shouldPreload) for (const file of opts.selfHostedFontFiles.slice(0, opts.googleFamilies.length)) {
-			const type = file.name.split(".").pop() === "woff2" ? "font/woff2" : "font/woff";
-			tags.push(`<link rel="preload" href="/assets/fonts/${file.name}" as="font" type="${type}" crossorigin>`);
-		}
-	} else if (opts.googleFamilies.length > 0) {
-		const cssUrl = googleFontsUrl(opts.googleFamilies, opts.display);
-		tags.push(`<link rel="preconnect" href="https://fonts.googleapis.com">`);
-		tags.push(`<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>`);
-		tags.push(`<link rel="stylesheet" href="${cssUrl}">`);
+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"));
 	}
 }
-function collectLocalFontTags(tags, config, shouldPreload, display) {
-	if (shouldPreload && config.local?.length) tags.push(preloadTags(config.local));
-	if (config.local?.length) tags.push(`<style>${localFontFaces(config.local, display)}</style>`);
-	if (config.fallbacks && Object.keys(config.fallbacks).length > 0) tags.push(`<style>${fallbackFontFaces(config.fallbacks)}</style>`);
-}
-/**
-* Generate CSS variables for font families.
-*/
-function fontVariables(families) {
-	return `:root {\n${Object.entries(families).map(([key, value]) => `  --font-${key}: ${value};`).join("\n")}\n}`;
-}
 
 //#endregion
-//#region src/image-plugin.ts
-let sharpWarned$2 = false;
-function warnSharpMissing$2() {
-	if (sharpWarned$2) return;
-	sharpWarned$2 = true;
-	console.warn("\n[zero:image] sharp not installed — images will not be optimized. Install for full support: bun add -D sharp\n");
+//#region src/meta.tsx
+function faviconLinks(locale, config) {
+	const hasLocaleOverride = locale && config.locales?.[locale];
+	const prefix = hasLocaleOverride ? `/${locale}` : "";
+	const isSvg = (hasLocaleOverride ? config.locales[locale].source : config.source).endsWith(".svg");
+	const links = [];
+	if (isSvg) links.push({
+		rel: "icon",
+		type: "image/svg+xml",
+		href: `${prefix}/favicon.svg`
+	});
+	links.push({
+		rel: "icon",
+		type: "image/png",
+		sizes: "32x32",
+		href: `${prefix}/favicon-32x32.png`
+	}, {
+		rel: "icon",
+		type: "image/png",
+		sizes: "16x16",
+		href: `${prefix}/favicon-16x16.png`
+	}, {
+		rel: "apple-touch-icon",
+		sizes: "180x180",
+		href: `${prefix}/apple-touch-icon.png`
+	});
+	if (config.manifest !== false) links.push({
+		rel: "manifest",
+		href: `${prefix}/site.webmanifest`
+	});
+	return links;
+}
+function ogImagePath(templateName, locale, outDir = "og", format = "png") {
+	const ext = format === "jpeg" ? "jpg" : "png";
+	return `/${outDir}/${templateName}${locale ? `-${locale}` : ""}.${ext}`;
 }
-const IMAGE_EXT_RE = /\.(jpe?g|png|webp|avif)$/i;
+const resolveStr = (v) => typeof v === "function" ? v() : v;
 /**
-* Zero image processing Vite plugin.
-*
-* Transforms image imports with query params into optimized responsive images:
-*
-* @example
-* // vite.config.ts
-* import { imagePlugin } from "@pyreon/zero/image-plugin"
+* Declarative meta component for SSR-compatible page metadata.
 *
-* export default {
-*   plugins: [
-*     pyreon(),
-*     zero(),
-*     imagePlugin({ widths: [480, 960, 1440], quality: 85 }),
-*   ],
-* }
+* 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
-* // In a component — import with ?optimize
-* import hero from "./images/hero.jpg?optimize"
-* // hero = { src, srcset, width, height, placeholder }
+* ```tsx
+* <Meta title="My Page" description="..." image="/og.jpg" canonical="https://..." />
+* ```
 *
-* <Image {...hero} alt="Hero" priority />
+* @example Reactive title
+* ```tsx
+* const count = signal(0)
+* <Meta title={() => `${count()} items`} />
+* ```
 */
-function imagePlugin(config = {}) {
-	const defaultWidths = config.widths ?? [
-		640,
-		1024,
-		1920
-	];
-	const defaultFormats = config.formats ?? ["webp"];
-	const quality = config.quality ?? 80;
-	const placeholderSize = config.placeholderSize ?? 16;
-	const outSubDir = config.outDir ?? "assets/img";
-	const include = config.include ?? IMAGE_EXT_RE;
-	let root = "";
-	let outDir = "";
-	let isBuild = false;
-	return {
-		name: "pyreon-zero-images",
-		enforce: "pre",
-		configResolved(resolvedConfig) {
-			root = resolvedConfig.root;
-			outDir = resolvedConfig.build.outDir;
-			isBuild = resolvedConfig.command === "build";
-		},
-		async resolveId(id) {
-			if (id.includes("?optimize") && include.test(id.split("?")[0])) return `\0virtual:zero-image:${id}`;
-			return null;
-		},
-		async load(id) {
-			if (!id.startsWith("\0virtual:zero-image:")) return null;
-			const rawPath = id.replace("\0virtual:zero-image:", "").split("?")[0] ?? id;
-			const absPath = rawPath.startsWith("/") ? join(root, "public", rawPath) : rawPath;
-			if (!isBuild) {
-				const result = await loadDevImage(absPath, rawPath, placeholderSize);
-				return `export default ${JSON.stringify(result)}`;
-			}
-			const processed = await processImage(absPath, {
-				widths: defaultWidths,
-				formats: defaultFormats,
-				quality,
-				placeholderSize,
-				outSubDir,
-				outDir: join(root, outDir)
-			});
-			await emitProcessedSources(processed, outSubDir, this);
-			rebuildFormatSrcsets(processed, absPath);
-			return `export default ${JSON.stringify(processed)}`;
-		}
-	};
-}
-async function loadDevImage(absPath, rawPath, placeholderSize) {
-	const metadata = await getImageMetadata(absPath);
-	const publicPath = rawPath.startsWith("/") ? rawPath : `/@fs/${absPath}`;
-	return {
-		src: publicPath,
-		srcset: "",
-		width: metadata.width,
-		height: metadata.height,
-		placeholder: await generateBlurPlaceholder(absPath, placeholderSize),
-		formats: [],
-		sources: [{
-			src: publicPath,
-			width: metadata.width,
-			format: "original"
-		}]
-	};
-}
-async function emitProcessedSources(processed, outSubDir, ctx) {
-	for (const source of processed.sources) {
-		const fileName = join(outSubDir, basename(source.src));
-		const content = await readFile(source.src);
-		ctx.emitFile({
-			type: "asset",
-			fileName,
-			source: content
-		});
-		source.src = `/${fileName}`;
-	}
-}
-function rebuildFormatSrcsets(processed, fallbackPath) {
-	const formatGroups = /* @__PURE__ */ new Map();
-	for (const s of processed.sources) {
-		let group = formatGroups.get(s.format);
-		if (!group) {
-			group = [];
-			formatGroups.set(s.format, group);
-		}
-		group.push(`${s.src} ${s.width}w`);
-	}
-	processed.formats = [...formatGroups.entries()].map(([fmt, entries]) => ({
-		type: `image/${fmt}`,
-		srcset: entries.join(", ")
-	}));
-	processed.srcset = processed.formats.at(-1)?.srcset ?? "";
-	processed.src = processed.sources.at(-1)?.src ?? fallbackPath;
-}
-async function processImage(absPath, opts) {
-	const metadata = await getImageMetadata(absPath);
-	const name = basename(absPath, extname(absPath));
-	const sources = [];
-	const processedDir = join(opts.outDir, opts.outSubDir);
-	if (!existsSync(processedDir)) await mkdir(processedDir, { recursive: true });
-	for (const format of opts.formats) for (const targetWidth of opts.widths) {
-		const width = Math.min(targetWidth, metadata.width);
-		const outPath = join(processedDir, `${name}-${width}.${format}`);
-		await resizeImage(absPath, outPath, width, format, opts.quality);
-		sources.push({
-			src: outPath,
-			width,
-			format
+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
 		});
-	}
-	const formatGroups = /* @__PURE__ */ new Map();
-	for (const s of sources) {
-		let group = formatGroups.get(s.format);
-		if (!group) {
-			group = [];
-			formatGroups.set(s.format, group);
-		}
-		group.push({
-			src: s.src,
-			width: s.width
+		const input = {
+			meta: tags.meta,
+			link: tags.link,
+			script: tags.script
+		};
+		if (title) input.title = title;
+		return input;
+	});
+	else {
+		const title = resolveStr(props.title);
+		const description = resolveStr(props.description);
+		const tags = buildMetaTags({
+			...props,
+			title,
+			description
 		});
-	}
-	const formats = [...formatGroups.entries()].map(([fmt, group]) => ({
-		type: `image/${fmt === "jpeg" ? "jpeg" : fmt}`,
-		srcset: group.map((s) => `${s.src} ${s.width}w`).join(", ")
-	}));
-	const fallbackFormat = formats[formats.length - 1];
-	const fallbackSources = formatGroups.get([...formatGroups.keys()].pop());
-	const placeholder = await generateBlurPlaceholder(absPath, opts.placeholderSize);
-	return {
-		src: fallbackSources[fallbackSources.length - 1]?.src ?? absPath,
-		srcset: fallbackFormat?.srcset ?? "",
-		width: metadata.width,
-		height: metadata.height,
-		placeholder,
-		formats,
-		sources
-	};
-}
-/**
-* Read basic image metadata.
-* Uses minimal binary header parsing — no external dependencies.
-*/
-async function getImageMetadata(absPath) {
-	const buffer = await readFile(absPath);
-	const ext = extname(absPath).toLowerCase();
-	if (ext === ".png") return {
-		width: buffer.readUInt32BE(16),
-		height: buffer.readUInt32BE(20),
-		format: "png"
-	};
-	if (ext === ".jpg" || ext === ".jpeg") return {
-		...parseJpegDimensions(buffer),
-		format: "jpeg"
-	};
-	if (ext === ".webp") return {
-		...parseWebPDimensions(buffer),
-		format: "webp"
-	};
-	return {
-		width: 0,
-		height: 0,
-		format: ext.slice(1)
-	};
-}
-/** @internal Exported for testing */
-function parseJpegDimensions(buffer) {
-	let offset = 2;
-	while (offset < buffer.length) {
-		if (buffer[offset] !== 255) break;
-		const marker = buffer[offset + 1];
-		if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
-			const height = buffer.readUInt16BE(offset + 5);
-			return {
-				width: buffer.readUInt16BE(offset + 7),
-				height
-			};
-		}
-		const length = buffer.readUInt16BE(offset + 2);
-		offset += 2 + length;
-	}
-	return {
-		width: 0,
-		height: 0
-	};
-}
-/** @internal Exported for testing */
-function parseWebPDimensions(buffer) {
-	const chunk = buffer.toString("ascii", 12, 16);
-	if (chunk === "VP8 ") return {
-		width: buffer.readUInt16LE(26) & 16383,
-		height: buffer.readUInt16LE(28) & 16383
-	};
-	if (chunk === "VP8L") {
-		const bits = buffer.readUInt32LE(21);
-		return {
-			width: (bits & 16383) + 1,
-			height: (bits >> 14 & 16383) + 1
+		const input = {
+			meta: tags.meta,
+			link: tags.link,
+			script: tags.script
 		};
+		if (title) input.title = title;
+		useHead(input);
 	}
-	if (chunk === "VP8X") return {
-		width: 1 + ((buffer[24] | buffer[25] << 8 | buffer[26] << 16) & 16777215),
-		height: 1 + ((buffer[27] | buffer[28] << 8 | buffer[29] << 16) & 16777215)
-	};
-	return {
-		width: 0,
-		height: 0
-	};
+	return props.children ?? null;
 }
-/**
-* Resize an image using native platform capabilities.
-* Uses sharp if available, falls back to canvas API.
-*/
-async function resizeImage(input, output, width, format, quality) {
-	try {
-		let pipeline = (await import("sharp").then((m) => m.default ?? m))(input).resize(width);
-		switch (format) {
-			case "webp":
-				pipeline = pipeline.webp({ quality });
-				break;
-			case "avif":
-				pipeline = pipeline.avif({ quality });
-				break;
-			case "jpeg":
-				pipeline = pipeline.jpeg({
-					quality,
-					mozjpeg: true
-				});
-				break;
-			case "png":
-				pipeline = pipeline.png({ compressionLevel: 9 });
-				break;
-		}
-		await pipeline.toFile(output);
-	} catch {
-		warnSharpMissing$2();
-		await writeFile(output, await readFile(input));
+function buildMetaTags(props) {
+	const meta = [];
+	const link = [];
+	const script = [];
+	const { title, description, canonical, imageAlt, imageWidth, imageHeight, type = "website", siteName, twitterCard = "summary_large_image", twitterSite, twitterCreator, locale = "en_US", alternateLocales, publishedTime, modifiedTime, author, tags, jsonLd, extra, video, videoWidth, videoHeight, audio, favicon, ogTemplate, ogImageDir, ogImageFormat } = props;
+	const robots = props.noIndex ? "noindex, nofollow" : props.robots ?? "index, follow";
+	const image = props.image ?? (ogTemplate ? ogImagePath(ogTemplate, locale !== "en_US" ? locale : void 0, ogImageDir, ogImageFormat) : void 0);
+	const resolvedImageWidth = imageWidth ?? (ogTemplate && !props.image ? 1200 : void 0);
+	const resolvedImageHeight = imageHeight ?? (ogTemplate && !props.image ? 630 : void 0);
+	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
+	});
+	if (resolvedImageWidth) meta.push({
+		property: "og:image:width",
+		content: String(resolvedImageWidth)
+	});
+	if (resolvedImageHeight) meta.push({
+		property: "og:image:height",
+		content: String(resolvedImageHeight)
+	});
+	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 (video) {
+		meta.push({
+			property: "og:video",
+			content: video
+		});
+		if (videoWidth) meta.push({
+			property: "og:video:width",
+			content: String(videoWidth)
+		});
+		if (videoHeight) meta.push({
+			property: "og:video:height",
+			content: String(videoHeight)
+		});
+		if (video.endsWith(".mp4")) meta.push({
+			property: "og:video:type",
+			content: "video/mp4"
+		});
+		else if (video.endsWith(".webm")) meta.push({
+			property: "og:video:type",
+			content: "video/webm"
+		});
 	}
-}
-/**
-* Generate a tiny blur placeholder as a base64 data URI.
-*/
-async function generateBlurPlaceholder(input, size) {
-	try {
-		return `data:image/webp;base64,${(await (await import("sharp").then((m) => m.default ?? m))(input).resize(size, size, { fit: "inside" }).blur(2).webp({ quality: 20 }).toBuffer()).toString("base64")}`;
-	} catch {
-		return "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='1' height='1'%3E%3C/svg%3E";
+	if (audio) meta.push({
+		property: "og:audio",
+		content: audio
+	});
+	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}`
+		});
+	}
+	if (favicon) {
+		const faviconLocale = locale !== "en_US" ? locale : void 0;
+		for (const fl of faviconLinks(faviconLocale, favicon)) link.push(fl);
+		if (favicon.themeColor) meta.push({
+			name: "theme-color",
+			content: favicon.themeColor
+		});
 	}
+	return {
+		meta,
+		link,
+		script
+	};
 }
 
 //#endregion
@@ -2245,7 +806,10 @@ function initTheme() {
 		mq.addEventListener("change", onChange);
 		onUnmount(() => mq.removeEventListener("change", onChange));
 		const dispose = effect(() => {
-			document.documentElement.dataset.theme = resolvedTheme();
+			const mode = resolvedTheme();
+			document.documentElement.dataset.theme = mode;
+			const faviconLinks = document.querySelectorAll("[data-favicon-theme]");
+			for (const link of faviconLinks) link.media = link.dataset.faviconTheme === mode ? "" : "not all";
 		});
 		if (dispose) onUnmount(() => dispose.dispose());
 	});
@@ -2356,2302 +920,42 @@ function ThemeToggle(props) {
 *   ...
 * </head>
 */
-const themeScript = `(function(){try{var t=localStorage.getItem("${STORAGE_KEY}");var r=t==="light"?"light":t==="dark"?"dark":window.matchMedia("(prefers-color-scheme:dark)").matches?"dark":"light";document.documentElement.dataset.theme=r}catch(e){}})()`;
-
-//#endregion
-//#region src/seo.ts
-/**
-* Generate a sitemap.xml string from route file paths.
-*/
-function generateSitemap(routeFiles, config) {
-	const { origin, exclude = [], changefreq = "weekly", priority = .7 } = config;
-	return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${[...routeFiles.filter((f) => {
-		const name = f.split("/").pop()?.replace(/\.\w+$/, "");
-		return name !== "_layout" && name !== "_error" && name !== "_loading";
-	}).map((f) => {
-		let path = f.replace(/\.\w+$/, "").replace(/\/index$/, "/").replace(/^index$/, "/");
-		if (path.includes("[")) return null;
-		path = path.replace(/\([\w-]+\)\//g, "");
-		if (!path.startsWith("/")) path = `/${path}`;
-		return path;
-	}).filter((p) => p !== null).filter((p) => !exclude.some((e) => p.startsWith(e))).map((p) => ({
-		path: p,
-		changefreq,
-		priority
-	})), ...config.additionalPaths ?? []].map((entry) => {
-		return `  <url>
-    <loc>${escapeXml$1(`${origin}${entry.path === "/" ? "" : entry.path}`)}</loc>
-    <changefreq>${entry.changefreq ?? changefreq}</changefreq>
-    <priority>${entry.priority ?? priority}</priority>${entry.lastmod ? `\n    <lastmod>${entry.lastmod}</lastmod>` : ""}
-  </url>`;
-	}).join("\n")}
-</urlset>`;
-}
-function escapeXml$1(str) {
-	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
-/**
-* Generate a robots.txt string.
-*/
-function generateRobots(config = {}) {
-	const { rules = [{
-		userAgent: "*",
-		allow: ["/"]
-	}], sitemap, host } = config;
-	const lines = [];
-	for (const rule of rules) {
-		lines.push(`User-agent: ${rule.userAgent}`);
-		if (rule.allow) for (const path of rule.allow) lines.push(`Allow: ${path}`);
-		if (rule.disallow) for (const path of rule.disallow) lines.push(`Disallow: ${path}`);
-		if (rule.crawlDelay) lines.push(`Crawl-delay: ${rule.crawlDelay}`);
-		lines.push("");
-	}
-	if (sitemap) lines.push(`Sitemap: ${sitemap}`);
-	if (host) lines.push(`Host: ${host}`);
-	return lines.join("\n");
-}
-/**
-* Generate a JSON-LD script tag string for structured data.
-*
-* @example
-* useHead({
-*   script: [jsonLd({
-*     "@type": "WebSite",
-*     name: "My Site",
-*     url: "https://example.com",
-*   })],
-* })
-*/
-function jsonLd(data) {
-	const ld = {
-		"@context": "https://schema.org",
-		...data
-	};
-	return `<script type="application/ld+json">${JSON.stringify(ld)}<\/script>`;
-}
-/**
-* Zero SEO Vite plugin.
-* Generates sitemap.xml and robots.txt at build time.
-*
-* @example
-* import { seoPlugin } from "@pyreon/zero/seo"
-*
-* export default {
-*   plugins: [
-*     pyreon(),
-*     zero(),
-*     seoPlugin({
-*       sitemap: { origin: "https://example.com" },
-*       robots: { sitemap: "https://example.com/sitemap.xml" },
-*     }),
-*   ],
-* }
-*/
-function seoPlugin(config = {}) {
-	return {
-		name: "pyreon-zero-seo",
-		apply: "build",
-		async generateBundle(_, _bundle) {
-			if (config.sitemap) {
-				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);
-					this.emitFile({
-						type: "asset",
-						fileName: "sitemap.xml",
-						source: sitemap
-					});
-				} catch {}
-			}
-			if (config.robots) {
-				const robots = generateRobots(config.robots);
-				this.emitFile({
-					type: "asset",
-					fileName: "robots.txt",
-					source: robots
-				});
-			}
-		}
-	};
-}
-/**
-* SEO middleware for dev server.
-* Serves sitemap.xml and robots.txt dynamically during development.
-*/
-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-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 {}
-	};
-}
+const themeScript = `(function(){try{var t=localStorage.getItem("${STORAGE_KEY}");var r=t==="light"?"light":t==="dark"?"dark":window.matchMedia("(prefers-color-scheme:dark)").matches?"dark":"light";document.documentElement.dataset.theme=r;document.querySelectorAll("[data-favicon-theme]").forEach(function(l){l.media=l.dataset.faviconTheme===r?"":"not all"})}catch(e){}})()`;
 
 //#endregion
-//#region src/cors.ts
-const DEFAULT_METHODS = [
-	"GET",
-	"POST",
-	"PUT",
-	"PATCH",
-	"DELETE",
-	"OPTIONS"
-];
-const DEFAULT_HEADERS = ["Content-Type", "Authorization"];
-/**
-* CORS middleware — handles preflight requests and sets appropriate
-* Access-Control headers on all responses.
-*
-* @example
-* import { corsMiddleware } from "@pyreon/zero/cors"
-*
-* corsMiddleware({ origin: "https://example.com", credentials: true })
-*
-* // Allow any origin
-* corsMiddleware({ origin: "*" })
-*
-* // Multiple origins
-* corsMiddleware({ origin: ["https://app.com", "https://admin.com"] })
-*/
-function corsMiddleware(config = {}) {
-	const { origin = "*", methods = DEFAULT_METHODS, allowedHeaders = DEFAULT_HEADERS, exposedHeaders = [], credentials = false, maxAge = 86400 } = config;
-	return (ctx) => {
-		const resolvedOrigin = resolveOrigin(origin, ctx.req.headers.get("origin") ?? "");
-		if (!resolvedOrigin) return;
-		ctx.headers.set("Access-Control-Allow-Origin", resolvedOrigin);
-		if (credentials) ctx.headers.set("Access-Control-Allow-Credentials", "true");
-		if (exposedHeaders.length > 0) ctx.headers.set("Access-Control-Expose-Headers", exposedHeaders.join(", "));
-		if (resolvedOrigin !== "*") ctx.headers.append("Vary", "Origin");
-		if (ctx.req.method === "OPTIONS") return new Response(null, {
-			status: 204,
-			headers: {
-				"Access-Control-Allow-Origin": resolvedOrigin,
-				"Access-Control-Allow-Methods": methods.join(", "),
-				"Access-Control-Allow-Headers": allowedHeaders.join(", "),
-				"Access-Control-Max-Age": String(maxAge),
-				...credentials ? { "Access-Control-Allow-Credentials": "true" } : {}
-			}
-		});
-	};
+//#region src/index.ts
+function serverOnly(name, subpath) {
+	throw new Error(`[Pyreon] "${name}" is server-only and cannot be imported from "@pyreon/zero".\nImport from the subpath instead:\n\n  import { ${name} } from "@pyreon/zero/${subpath}"\n`);
 }
-function resolveOrigin(config, requestOrigin) {
-	if (config === "*") return "*";
-	if (typeof config === "string") return config === requestOrigin ? config : null;
-	if (typeof config === "function") return config(requestOrigin) ? requestOrigin : null;
-	if (Array.isArray(config)) return config.includes(requestOrigin) ? requestOrigin : null;
-	return null;
+/** @deprecated Import from `@pyreon/zero/favicon` instead */
+function faviconPlugin(..._) {
+	return serverOnly("faviconPlugin", "favicon");
 }
-
-//#endregion
-//#region src/rate-limit.ts
-/**
-* Rate limiting middleware — limits requests per client within a time window.
-* Uses an in-memory store (suitable for single-instance deployments).
-*
-* @example
-* import { rateLimitMiddleware } from "@pyreon/zero/rate-limit"
-*
-* // 100 requests per minute (default)
-* rateLimitMiddleware()
-*
-* // Strict API rate limiting
-* rateLimitMiddleware({
-*   max: 20,
-*   window: 60,
-*   include: ["/api/*"],
-* })
-*/
-function rateLimitMiddleware(config = {}) {
-	const { max = 100, window: windowSec = 60, keyFn = defaultKeyFn, onLimit, include, exclude } = config;
-	const windowMs = windowSec * 1e3;
-	const store = /* @__PURE__ */ new Map();
-	const MAX_STORE_SIZE = 1e4;
-	let lastCleanup = Date.now();
-	function cleanupIfNeeded(now) {
-		if (store.size < MAX_STORE_SIZE / 2 && now - lastCleanup < windowMs) return;
-		lastCleanup = now;
-		for (const [key, entry] of store) if (entry.resetAt <= now) store.delete(key);
-	}
-	return (ctx) => {
-		if (include && !include.some((p) => matchSimpleGlob(p, ctx.path))) return;
-		if (exclude?.some((p) => matchSimpleGlob(p, ctx.path))) return;
-		const key = keyFn(ctx);
-		const now = Date.now();
-		cleanupIfNeeded(now);
-		let entry = store.get(key);
-		if (!entry || entry.resetAt <= now) {
-			entry = {
-				count: 0,
-				resetAt: now + windowMs
-			};
-			store.set(key, entry);
-		}
-		entry.count++;
-		const remaining = Math.max(0, max - entry.count);
-		const resetSeconds = Math.ceil((entry.resetAt - now) / 1e3);
-		ctx.headers.set("X-RateLimit-Limit", String(max));
-		ctx.headers.set("X-RateLimit-Remaining", String(remaining));
-		ctx.headers.set("X-RateLimit-Reset", String(resetSeconds));
-		if (entry.count > max) {
-			if (onLimit) return onLimit(ctx);
-			return new Response(JSON.stringify({ error: "Too many requests" }), {
-				status: 429,
-				headers: {
-					"Content-Type": "application/json",
-					"Retry-After": String(resetSeconds),
-					"X-RateLimit-Limit": String(max),
-					"X-RateLimit-Remaining": "0",
-					"X-RateLimit-Reset": String(resetSeconds)
-				}
-			});
-		}
-	};
+/** @deprecated Import from `@pyreon/zero/seo` instead */
+function seoPlugin(..._) {
+	return serverOnly("seoPlugin", "seo");
 }
-function defaultKeyFn(ctx) {
-	return ctx.req.headers.get("x-forwarded-for")?.split(",")[0]?.trim() ?? ctx.req.headers.get("x-real-ip") ?? "unknown";
+/** @deprecated Import from `@pyreon/zero/server` instead */
+function createServer(..._) {
+	return serverOnly("createServer", "server");
 }
-/** Simple glob matching for path patterns. Supports trailing `*`. */
-function matchSimpleGlob(pattern, path) {
-	if (pattern.endsWith("/*")) return path.startsWith(pattern.slice(0, -1));
-	return pattern === path;
+/** @deprecated Import from `@pyreon/zero/config` instead */
+function defineConfig(..._) {
+	return serverOnly("defineConfig", "config");
 }
-
-//#endregion
-//#region src/compression.ts
-/**
-* Compression middleware — compresses responses using gzip or deflate
-* based on the client's Accept-Encoding header.
-*
-* Only compresses text-based content types (HTML, JSON, JS, CSS, XML, SVG).
-* Skips responses below the size threshold and already-encoded responses.
-*
-* @example
-* import { compressionMiddleware } from "@pyreon/zero/compression"
-*
-* compressionMiddleware() // gzip with 1KB threshold
-* compressionMiddleware({ threshold: 512, encodings: ["gzip"] })
-*/
-function compressionMiddleware(config = {}) {
-	const { threshold = 1024, encodings = ["gzip", "deflate"] } = config;
-	return (ctx) => {
-		const acceptEncoding = ctx.req.headers.get("accept-encoding") ?? "";
-		const encoding = encodings.find((enc) => acceptEncoding.includes(enc));
-		if (!encoding) return;
-		ctx.locals.__compressionEncoding = encoding;
-		ctx.locals.__compressionThreshold = threshold;
-		ctx.headers.append("Vary", "Accept-Encoding");
-	};
+/** @deprecated Import from `@pyreon/zero/env` instead */
+function validateEnv(..._) {
+	return serverOnly("validateEnv", "env");
 }
-/**
-* Compress a Response body if it meets the criteria.
-* Use this to post-process responses after the handler runs.
-*
-* @example
-* const response = await handler(request)
-* const compressed = await compressResponse(response, 'gzip', 1024)
-*/
-async function compressResponse(response, encoding, threshold) {
-	if (!isCompressible(response.headers.get("content-type") ?? "")) return response;
-	if (response.headers.get("content-encoding")) return response;
-	const body = await response.arrayBuffer();
-	if (body.byteLength < threshold) return response;
-	const compressed = await compress(body, encoding);
-	const headers = new Headers(response.headers);
-	headers.set("Content-Encoding", encoding);
-	headers.delete("Content-Length");
-	headers.append("Vary", "Accept-Encoding");
-	return new Response(compressed, {
-		status: response.status,
-		statusText: response.statusText,
-		headers
-	});
-}
-const COMPRESSIBLE_TYPES = [
-	"text/",
-	"application/json",
-	"application/javascript",
-	"application/xml",
-	"application/xhtml+xml",
-	"image/svg+xml"
-];
-/** Check if a content type is compressible. Exported for testing. */
-function isCompressible(contentType) {
-	return COMPRESSIBLE_TYPES.some((t) => contentType.includes(t));
-}
-async function compress(data, encoding) {
-	if (typeof CompressionStream !== "undefined") {
-		const format = encoding === "gzip" ? "gzip" : "deflate";
-		const stream = new Blob([data]).stream().pipeThrough(new CompressionStream(format));
-		return new Response(stream).arrayBuffer();
-	}
-	try {
-		const zlib = await import("node:zlib");
-		const { promisify } = await import("node:util");
-		const result = await (encoding === "gzip" ? promisify(zlib.gzip) : promisify(zlib.deflate))(Buffer.from(data));
-		return result.buffer.slice(result.byteOffset, result.byteOffset + result.byteLength);
-	} catch {
-		return data;
-	}
-}
-
-//#endregion
-//#region src/actions.ts
-const actionRegistry = /* @__PURE__ */ new Map();
-/**
-* Define a server action. Returns a callable function that:
-* - On the **client**: sends a POST request to `/_zero/actions/<id>`
-* - On the **server** (SSR): executes the handler directly (no fetch)
-*
-* @example
-* // In a route file or module:
-* export const createPost = defineAction(async (ctx) => {
-*   const data = ctx.json as { title: string; body: string }
-*   // ... save to database
-*   return { success: true, id: 123 }
-* })
-*
-* // In a component:
-* const result = await createPost({ title: 'Hello', body: '...' })
-*/
-function defineAction(handler) {
-	const id = `action_${crypto.randomUUID().slice(0, 8)}`;
-	actionRegistry.set(id, {
-		id,
-		handler
-	});
-	const callable = async (data) => {
-		if (typeof globalThis.window === "undefined") return handler({
-			request: new Request(`http://localhost/_zero/actions/${id}`, {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify(data ?? null)
-			}),
-			formData: null,
-			json: data ?? null,
-			headers: new Headers({ "Content-Type": "application/json" })
-		});
-		const response = await fetch(`/_zero/actions/${id}`, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(data ?? null)
-		});
-		if (!response.ok) {
-			const body = await response.json().catch(() => ({}));
-			throw new Error(body.error ?? `Action failed: ${response.statusText}`);
-		}
-		return response.json();
-	};
-	callable.actionId = id;
-	return callable;
-}
-/**
-* Create a middleware that handles action requests at `/_zero/actions/*`.
-* Mount this before the SSR handler in the server entry.
-*/
-function createActionMiddleware() {
-	return async (ctx) => {
-		if (!ctx.path.startsWith("/_zero/actions/")) return;
-		const actionId = ctx.path.slice(15);
-		const action = actionRegistry.get(actionId);
-		if (!action) return Response.json({ error: "Action not found" }, { status: 404 });
-		if (ctx.req.method !== "POST") return Response.json({ error: "Method not allowed" }, { status: 405 });
-		return executeAction(action, ctx.req);
-	};
-}
-async function executeAction(action, req) {
-	try {
-		const contentType = req.headers.get("content-type") ?? "";
-		let formData = null;
-		let json = null;
-		if (contentType.includes("application/json")) json = await req.json();
-		else if (contentType.includes("multipart/form-data") || contentType.includes("application/x-www-form-urlencoded")) formData = await req.formData();
-		const result = await action.handler({
-			request: req,
-			formData,
-			json,
-			headers: req.headers
-		});
-		return Response.json(result ?? null);
-	} catch (err) {
-		const message = err instanceof Error ? err.message : "Internal server error";
-		return Response.json({ error: message }, { status: 500 });
-	}
-}
-
-//#endregion
-//#region src/favicon.ts
-let sharpWarned$1 = false;
-function warnSharpMissing$1() {
-	if (sharpWarned$1) return;
-	sharpWarned$1 = 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);
-			const devCache = /* @__PURE__ */ new Map();
-			server.middlewares.use(async (req, res, next) => {
-				const url = req.url ?? "";
-				const localeSource = resolveLocaleSource(url, config, root);
-				const svgUrl = localeSource ? localeSource.url : url;
-				const svgPath = localeSource ? localeSource.sourcePath : sourcePath;
-				const isSvgSource = localeSource ? localeSource.source.endsWith(".svg") : config.source.endsWith(".svg");
-				if (svgUrl.endsWith("/favicon.svg") && isSvgSource) try {
-					const content = await readFile(svgPath, "utf-8");
-					res.setHeader("Content-Type", "image/svg+xml");
-					res.end(content);
-					return;
-				} catch {}
-				const baseName = svgUrl.split("/").pop() ?? "";
-				const sizeMatch = SIZES.find((s) => s.name === baseName);
-				if (sizeMatch) {
-					const cacheKey = `${svgPath}:${sizeMatch.size}`;
-					let png = devCache.get(cacheKey);
-					if (!png) {
-						const result = await resizeToPng(svgPath, sizeMatch.size);
-						if (result) {
-							png = result;
-							devCache.set(cacheKey, result);
-						}
-					}
-					if (png) {
-						res.setHeader("Content-Type", "image/png");
-						res.setHeader("Cache-Control", "no-cache");
-						res.end(Buffer.from(png));
-						return;
-					}
-				}
-				if (baseName === "favicon.ico") {
-					const cacheKey = `ico:${svgPath}`;
-					let ico = devCache.get(cacheKey);
-					if (!ico) {
-						const result = await generateIco(svgPath);
-						if (result) {
-							ico = result;
-							devCache.set(cacheKey, result);
-						}
-					}
-					if (ico) {
-						res.setHeader("Content-Type", "image/x-icon");
-						res.setHeader("Cache-Control", "no-cache");
-						res.end(Buffer.from(ico));
-						return;
-					}
-				}
-				if (baseName === "site.webmanifest" && generateManifest) {
-					const prefix = localeSource ? `/${localeSource.locale}` : "";
-					const manifest = {
-						name: config.name ?? "App",
-						short_name: config.name ?? "App",
-						icons: [{
-							src: `${prefix}/icon-192.png`,
-							sizes: "192x192",
-							type: "image/png"
-						}, {
-							src: `${prefix}/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;
-			await generateFaviconSet.call(this, root, config.source, config.darkSource, "", config, themeColor, backgroundColor, generateManifest);
-			if (config.locales) for (const [locale, localeConfig] of Object.entries(config.locales)) await generateFaviconSet.call(this, root, localeConfig.source, localeConfig.darkSource, `${locale}/`, config, themeColor, backgroundColor, generateManifest);
-		}
-	};
-}
-/**
-* 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();
-}
-/**
-* Resolve the source path for a locale-prefixed favicon URL.
-* Returns null if the URL is not locale-prefixed or locale has no override.
-*/
-function resolveLocaleSource(url, config, rootDir) {
-	if (!config.locales) return null;
-	for (const [locale, localeConfig] of Object.entries(config.locales)) {
-		const prefix = `/${locale}/`;
-		if (url.startsWith(prefix)) return {
-			locale,
-			url,
-			source: localeConfig.source,
-			sourcePath: join(rootDir, localeConfig.source)
-		};
-	}
-	return null;
-}
-/**
-* Generate a complete favicon set (SVG, PNGs, ICO, manifest) with a file prefix.
-* Called once for base (prefix = '') and once per locale (prefix = '{locale}/').
-*/
-async function generateFaviconSet(rootDir, source, darkSource, prefix, config, themeColor, backgroundColor, generateManifest) {
-	const sourcePath = join(rootDir, source);
-	if (!existsSync(sourcePath)) {
-		console.warn(`[zero:favicon] Source not found: ${sourcePath}`);
-		return;
-	}
-	if (source.endsWith(".svg")) {
-		const svgContent = await readFile(sourcePath, "utf-8");
-		let finalSvg = svgContent;
-		if (darkSource) {
-			const darkPath = join(rootDir, darkSource);
-			if (existsSync(darkPath)) finalSvg = wrapSvgWithDarkMode(svgContent, await readFile(darkPath, "utf-8"));
-		}
-		this.emitFile({
-			type: "asset",
-			fileName: `${prefix}favicon.svg`,
-			source: finalSvg
-		});
-	}
-	for (const { size, name } of SIZES) {
-		const pngBuffer = await resizeToPng(sourcePath, size);
-		if (pngBuffer) this.emitFile({
-			type: "asset",
-			fileName: `${prefix}${name}`,
-			source: pngBuffer
-		});
-	}
-	const ico = await generateIco(sourcePath);
-	if (ico) this.emitFile({
-		type: "asset",
-		fileName: `${prefix}favicon.ico`,
-		source: ico
-	});
-	if (generateManifest) {
-		const manifestPrefix = prefix ? `/${prefix.slice(0, -1)}` : "";
-		const manifest = {
-			name: config.name ?? "App",
-			short_name: config.name ?? "App",
-			icons: [{
-				src: `${manifestPrefix}/icon-192.png`,
-				sizes: "192x192",
-				type: "image/png"
-			}, {
-				src: `${manifestPrefix}/icon-512.png`,
-				sizes: "512x512",
-				type: "image/png"
-			}],
-			theme_color: themeColor,
-			background_color: backgroundColor,
-			display: "standalone"
-		};
-		this.emitFile({
-			type: "asset",
-			fileName: `${prefix}site.webmanifest`,
-			source: JSON.stringify(manifest, null, 2)
-		});
-	}
-}
-/**
-* Get favicon link tags for a specific locale.
-* Returns link objects suitable for `useHead()` or direct HTML injection.
-*
-* @example
-* ```ts
-* const links = faviconLinks("de", { source: "./icon.svg", locales: { de: { source: "./icon-de.svg" } } })
-* // → [{ rel: "icon", type: "image/svg+xml", href: "/de/favicon.svg" }, ...]
-* ```
-*/
-function faviconLinks(locale, config) {
-	const hasLocaleOverride = locale && config.locales?.[locale];
-	const prefix = hasLocaleOverride ? `/${locale}` : "";
-	const isSvg = (hasLocaleOverride ? config.locales[locale].source : config.source).endsWith(".svg");
-	const links = [];
-	if (isSvg) links.push({
-		rel: "icon",
-		type: "image/svg+xml",
-		href: `${prefix}/favicon.svg`
-	});
-	links.push({
-		rel: "icon",
-		type: "image/png",
-		sizes: "32x32",
-		href: `${prefix}/favicon-32x32.png`
-	}, {
-		rel: "icon",
-		type: "image/png",
-		sizes: "16x16",
-		href: `${prefix}/favicon-16x16.png`
-	}, {
-		rel: "apple-touch-icon",
-		sizes: "180x180",
-		href: `${prefix}/apple-touch-icon.png`
-	});
-	if (config.manifest !== false) links.push({
-		rel: "manifest",
-		href: `${prefix}/site.webmanifest`
-	});
-	return links;
-}
-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$1();
-		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$1();
-		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/og-image.ts
-/**
-* OG Image generation plugin.
-*
-* Generates Open Graph images at build time from templates with
-* text overlays. Supports locale-specific text for i18n apps.
-* Uses sharp for image processing (same optional dep as favicon/image plugins).
-*
-* @example
-* ```ts
-* // vite.config.ts
-* import { ogImagePlugin } from "@pyreon/zero/og-image"
-*
-* export default {
-*   plugins: [
-*     ogImagePlugin({
-*       locales: ["en", "de", "cs"],
-*       templates: [{
-*         name: "default",
-*         background: "./src/assets/og-bg.jpg",
-*         layers: [{
-*           text: { en: "Build faster", de: "Schneller bauen", cs: "Stavte rychleji" },
-*           y: "40%",
-*           fontSize: 72,
-*         }],
-*       }],
-*     }),
-*   ],
-* }
-* ```
-*/
-let sharpWarned = false;
-function warnSharpMissing() {
-	if (sharpWarned) return;
-	sharpWarned = true;
-	console.warn("\n[zero:og-image] sharp not installed — OG images will not be generated. Install for full support: bun add -D sharp\n");
-}
-function resolvePosition(value, dimension, fallback = "50%") {
-	if (value === void 0) value = fallback;
-	if (typeof value === "number") return value;
-	if (value.endsWith("%")) return Math.round(Number.parseFloat(value) / 100 * dimension);
-	return Number.parseInt(value, 10) || 0;
-}
-function resolveLayerText(layer, locale) {
-	if (typeof layer.text === "string") return layer.text;
-	if (typeof layer.text === "function") return layer.text(locale);
-	return layer.text[locale] ?? layer.text[Object.keys(layer.text)[0] ?? ""] ?? "";
-}
-function escapeXml(str) {
-	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
-/**
-* Build an SVG overlay with text layers.
-* @internal Exported for testing.
-*/
-function buildTextOverlaySvg(layers, width, height, locale) {
-	return `<svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">${layers.map((layer) => {
-		const text = resolveLayerText(layer, locale);
-		const x = resolvePosition(layer.x, width, "50%");
-		const y = resolvePosition(layer.y, height, "50%");
-		const fontSize = layer.fontSize ?? 64;
-		const fontFamily = layer.fontFamily ?? "sans-serif";
-		const fontWeight = layer.fontWeight ?? "bold";
-		const color = layer.color ?? "#ffffff";
-		const anchor = layer.textAnchor ?? "middle";
-		const maxWidth = layer.maxWidth ?? Math.round(width * .8);
-		const words = text.split(" ");
-		const lines = [];
-		let currentLine = "";
-		const estimateWidth = (s) => {
-			let width = 0;
-			for (let i = 0; i < s.length; i++) {
-				const code = s.charCodeAt(i);
-				if (code >= 12288 && code <= 40959) width += fontSize * 1;
-				else if (code <= 126 && "iljft!|:;.,'".includes(s[i])) width += fontSize * .35;
-				else width += fontSize * .55;
-			}
-			return width;
-		};
-		for (const word of words) {
-			const testLine = currentLine ? `${currentLine} ${word}` : word;
-			if (estimateWidth(testLine) > maxWidth && currentLine) {
-				lines.push(currentLine);
-				currentLine = word;
-			} else currentLine = testLine;
-		}
-		if (currentLine) lines.push(currentLine);
-		const tspans = lines.map((line, i) => {
-			return `<tspan x="${x}" dy="${i === 0 ? "0" : `${fontSize * 1.2}`}">${escapeXml(line)}</tspan>`;
-		}).join("");
-		return `<text x="${x}" y="${y}" font-size="${fontSize}" font-family="${escapeXml(fontFamily)}" font-weight="${fontWeight}" fill="${color}" text-anchor="${anchor}" dominant-baseline="middle">${tspans}</text>`;
-	}).join("")}</svg>`;
-}
-/**
-* Render an OG image from a template for a specific locale.
-* @internal Exported for testing.
-*/
-async function renderOgImage(template, locale, rootDir) {
-	try {
-		const sharp = await import("sharp").then((m) => m.default ?? m);
-		const width = template.width ?? 1200;
-		const height = template.height ?? 630;
-		let pipeline;
-		if (typeof template.background === "string") pipeline = sharp(join(rootDir, template.background)).resize(width, height, { fit: "cover" });
-		else pipeline = sharp({ create: {
-			width,
-			height,
-			channels: 4,
-			background: template.background.color
-		} });
-		if (template.layers && template.layers.length > 0) {
-			const svgOverlay = buildTextOverlaySvg(template.layers, width, height, locale);
-			pipeline = pipeline.composite([{
-				input: Buffer.from(svgOverlay),
-				top: 0,
-				left: 0
-			}]);
-		}
-		if (template.format === "jpeg") return await pipeline.jpeg({ quality: template.quality ?? 90 }).toBuffer();
-		return await pipeline.png().toBuffer();
-	} catch {
-		warnSharpMissing();
-		return null;
-	}
-}
-/**
-* Compute the OG image path for a template and locale.
-*
-* @example
-* ```ts
-* ogImagePath("default", "de")      // → "/og/default-de.png"
-* ogImagePath("default")            // → "/og/default.png"
-* ogImagePath("hero", "en", "images") // → "/images/hero-en.png"
-* ```
-*/
-function ogImagePath(templateName, locale, outDir = "og", format = "png") {
-	const ext = format === "jpeg" ? "jpg" : "png";
-	return `/${outDir}/${templateName}${locale ? `-${locale}` : ""}.${ext}`;
-}
-/**
-* OG image generation Vite plugin.
-*
-* Generates Open Graph images at build time. In dev, generates on-demand.
-* Requires `sharp` as an optional dependency.
-*
-* @example
-* ```ts
-* // vite.config.ts
-* import { ogImagePlugin } from "@pyreon/zero/og-image"
-*
-* export default {
-*   plugins: [
-*     ogImagePlugin({
-*       locales: ["en", "de"],
-*       templates: [{
-*         name: "default",
-*         background: { color: "#0066ff" },
-*         layers: [{ text: { en: "Hello", de: "Hallo" }, fontSize: 72 }],
-*       }],
-*     }),
-*   ],
-* }
-* ```
-*/
-function ogImagePlugin(config) {
-	const outDir = config.outDir ?? "og";
-	let root = "";
-	let isBuild = false;
-	return {
-		name: "pyreon-zero-og-image",
-		enforce: "pre",
-		configResolved(resolvedConfig) {
-			root = resolvedConfig.root;
-			isBuild = resolvedConfig.command === "build";
-		},
-		configureServer(server) {
-			const devCache = /* @__PURE__ */ new Map();
-			server.middlewares.use(async (req, res, next) => {
-				const url = req.url ?? "";
-				if (!url.startsWith(`/${outDir}/`)) return next();
-				const match = url.slice(outDir.length + 2).match(/^(.+?)(?:-([a-z]{2,5}))?\.(png|jpe?g)$/);
-				if (!match) return next();
-				const [, templateName, locale, ext] = match;
-				const template = config.templates.find((t) => t.name === templateName);
-				if (!template) return next();
-				const resolvedLocale = locale ?? config.locales?.[0] ?? "en";
-				const cacheKey = `${templateName}:${resolvedLocale}`;
-				let buffer = devCache.get(cacheKey);
-				if (!buffer) {
-					const result = await renderOgImage(template, resolvedLocale, root);
-					if (!result) return next();
-					buffer = result;
-					devCache.set(cacheKey, result);
-				}
-				const contentType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : "image/png";
-				res.setHeader("Content-Type", contentType);
-				res.setHeader("Cache-Control", "no-cache");
-				res.end(Buffer.from(buffer));
-			});
-		},
-		async generateBundle() {
-			if (!isBuild) return;
-			for (const template of config.templates) {
-				const locales = config.locales ?? [void 0];
-				const ext = (template.format ?? "png") === "jpeg" ? "jpg" : "png";
-				for (const locale of locales) {
-					if (typeof template.background === "string") {
-						const bgPath = join(root, template.background);
-						if (!existsSync(bgPath)) {
-							console.warn(`[zero:og-image] Background not found: ${bgPath}`);
-							continue;
-						}
-					}
-					const buffer = await renderOgImage(template, locale ?? "en", root);
-					if (!buffer) continue;
-					const suffix = locale ? `-${locale}` : "";
-					this.emitFile({
-						type: "asset",
-						fileName: `${outDir}/${template.name}${suffix}.${ext}`,
-						source: buffer
-					});
-				}
-			}
-		}
-	};
-}
-
-//#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
-		});
-		const input = {
-			meta: tags.meta,
-			link: tags.link,
-			script: tags.script
-		};
-		if (title) input.title = title;
-		return input;
-	});
-	else {
-		const title = resolveStr(props.title);
-		const description = resolveStr(props.description);
-		const tags = buildMetaTags({
-			...props,
-			title,
-			description
-		});
-		const input = {
-			meta: tags.meta,
-			link: tags.link,
-			script: tags.script
-		};
-		if (title) input.title = title;
-		useHead(input);
-	}
-	return props.children ?? null;
-}
-function buildMetaTags(props) {
-	const meta = [];
-	const link = [];
-	const script = [];
-	const { title, description, canonical, imageAlt, imageWidth, imageHeight, type = "website", siteName, twitterCard = "summary_large_image", twitterSite, twitterCreator, locale = "en_US", alternateLocales, publishedTime, modifiedTime, author, tags, jsonLd, extra, video, videoWidth, videoHeight, audio, favicon, ogTemplate, ogImageDir, ogImageFormat } = props;
-	const robots = props.noIndex ? "noindex, nofollow" : props.robots ?? "index, follow";
-	const image = props.image ?? (ogTemplate ? ogImagePath(ogTemplate, locale !== "en_US" ? locale : void 0, ogImageDir, ogImageFormat) : void 0);
-	const resolvedImageWidth = imageWidth ?? (ogTemplate && !props.image ? 1200 : void 0);
-	const resolvedImageHeight = imageHeight ?? (ogTemplate && !props.image ? 630 : void 0);
-	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
-	});
-	if (resolvedImageWidth) meta.push({
-		property: "og:image:width",
-		content: String(resolvedImageWidth)
-	});
-	if (resolvedImageHeight) meta.push({
-		property: "og:image:height",
-		content: String(resolvedImageHeight)
-	});
-	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 (video) {
-		meta.push({
-			property: "og:video",
-			content: video
-		});
-		if (videoWidth) meta.push({
-			property: "og:video:width",
-			content: String(videoWidth)
-		});
-		if (videoHeight) meta.push({
-			property: "og:video:height",
-			content: String(videoHeight)
-		});
-		if (video.endsWith(".mp4")) meta.push({
-			property: "og:video:type",
-			content: "video/mp4"
-		});
-		else if (video.endsWith(".webm")) meta.push({
-			property: "og:video:type",
-			content: "video/webm"
-		});
-	}
-	if (audio) meta.push({
-		property: "og:audio",
-		content: audio
-	});
-	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}`
-		});
-	}
-	if (favicon) {
-		const faviconLocale = locale !== "en_US" ? locale : void 0;
-		for (const fl of faviconLinks(faviconLocale, favicon)) link.push(fl);
-		if (favicon.themeColor) meta.push({
-			name: "theme-color",
-			content: favicon.themeColor
-		});
-	}
-	return {
-		meta,
-		link,
-		script
-	};
-}
-
-//#endregion
-//#region src/csp.ts
-/** Client-side fallback nonce (dev server, SPA). */
-let _clientNonce = "";
-/**
-* Read the current CSP nonce in a component.
-*
-* SSR: reads from per-request `ctx.locals.cspNonce` via Pyreon's context
-* system — fully isolated between concurrent requests via AsyncLocalStorage.
-* Client/dev: falls back to module-level variable set by middleware.
-*
-* @example
-* ```tsx
-* import { useNonce } from "@pyreon/zero/csp"
-*
-* function InlineScript() {
-*   const nonce = useNonce()
-*   return <script nonce={nonce}>console.log("safe")<\/script>
-* }
-* ```
-*/
-function useNonce() {
-	const locals = useRequestLocals();
-	if (locals.cspNonce) return locals.cspNonce;
-	return _clientNonce;
-}
-const DIRECTIVE_MAP = {
-	defaultSrc: "default-src",
-	scriptSrc: "script-src",
-	styleSrc: "style-src",
-	imgSrc: "img-src",
-	fontSrc: "font-src",
-	connectSrc: "connect-src",
-	mediaSrc: "media-src",
-	objectSrc: "object-src",
-	frameSrc: "frame-src",
-	childSrc: "child-src",
-	workerSrc: "worker-src",
-	frameAncestors: "frame-ancestors",
-	formAction: "form-action",
-	baseUri: "base-uri",
-	manifestSrc: "manifest-src",
-	reportUri: "report-uri",
-	reportTo: "report-to"
-};
-/**
-* Build a CSP header string from directives.
-* Exported for testing.
-*/
-function buildCspHeader(directives, nonce) {
-	const parts = [];
-	for (const [key, cssProp] of Object.entries(DIRECTIVE_MAP)) {
-		const value = directives[key];
-		if (!value) continue;
-		if (Array.isArray(value)) {
-			const resolved = nonce ? value.map((v) => v === "'nonce'" ? `'nonce-${nonce}'` : v) : value.filter((v) => v !== "'nonce'");
-			parts.push(`${cssProp} ${resolved.join(" ")}`);
-		} else if (typeof value === "string") parts.push(`${cssProp} ${value}`);
-	}
-	if (directives.upgradeInsecureRequests) parts.push("upgrade-insecure-requests");
-	if (directives.blockAllMixedContent) parts.push("block-all-mixed-content");
-	return parts.join("; ");
-}
-/**
-* Generate a random nonce string (base64, 16 bytes).
-*/
-function generateNonce() {
-	if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-		const bytes = new Uint8Array(16);
-		crypto.getRandomValues(bytes);
-		let binary = "";
-		for (const byte of bytes) binary += String.fromCharCode(byte);
-		return typeof btoa === "function" ? btoa(binary) : Buffer.from(bytes).toString("base64");
-	}
-	return Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
-}
-/**
-* CSP middleware — sets Content-Security-Policy header.
-*
-* When directives contain `"'nonce'"`, a fresh nonce is generated per-request
-* and attached to `ctx.locals.cspNonce` for use in inline script tags.
-*
-* @example
-* ```ts
-* // Apply to all routes
-* export default defineConfig({
-*   middleware: [
-*     cspMiddleware({
-*       directives: {
-*         defaultSrc: ["'self'"],
-*         scriptSrc: ["'self'", "'nonce'"],
-*         styleSrc: ["'self'", "'unsafe-inline'"],
-*         imgSrc: ["'self'", "data:", "https:"],
-*       },
-*     }),
-*   ],
-* })
-* ```
-*/
-function cspMiddleware(config) {
-	const headerName = config.reportOnly ? "Content-Security-Policy-Report-Only" : "Content-Security-Policy";
-	const staticHeader = Object.values(config.directives).some((v) => Array.isArray(v) && v.includes("'nonce'")) ? null : buildCspHeader(config.directives);
-	return (ctx) => {
-		if (staticHeader) {
-			_clientNonce = "";
-			ctx.headers.set(headerName, staticHeader);
-		} else {
-			const nonce = generateNonce();
-			_clientNonce = nonce;
-			ctx.locals.cspNonce = nonce;
-			ctx.headers.set(headerName, buildCspHeader(config.directives, nonce));
-		}
-	};
-}
-
-//#endregion
-//#region src/logger.ts
-const COLORS = {
-	reset: "\x1B[0m",
-	dim: "\x1B[2m",
-	green: "\x1B[32m",
-	yellow: "\x1B[33m",
-	red: "\x1B[31m",
-	cyan: "\x1B[36m",
-	magenta: "\x1B[35m"
-};
-function methodColor(method, colors) {
-	if (!colors) return method.padEnd(7);
-	const padded = method.padEnd(7);
-	switch (method) {
-		case "GET": return `${COLORS.green}${padded}${COLORS.reset}`;
-		case "POST": return `${COLORS.cyan}${padded}${COLORS.reset}`;
-		case "PUT": return `${COLORS.yellow}${padded}${COLORS.reset}`;
-		case "PATCH": return `${COLORS.yellow}${padded}${COLORS.reset}`;
-		case "DELETE": return `${COLORS.red}${padded}${COLORS.reset}`;
-		default: return `${COLORS.magenta}${padded}${COLORS.reset}`;
-	}
-}
-function defaultFormat(entry, colors) {
-	const dur = entry.duration < 1 ? "<1ms" : entry.duration < 1e3 ? `${Math.round(entry.duration)}ms` : `${(entry.duration / 1e3).toFixed(2)}s`;
-	const dim = colors ? COLORS.dim : "";
-	const reset = colors ? COLORS.reset : "";
-	return `  ${methodColor(entry.method, colors)} ${entry.path} ${dim}${dur}${reset}`;
-}
-/**
-* Request logging middleware.
-*
-* Logs incoming requests with method, path, and duration.
-* Runs in middleware phase — logs timing from middleware start to
-* microtask completion (approximate request duration).
-*
-* @example
-* ```ts
-* // Basic usage
-* loggerMiddleware()
-*
-* // Custom format
-* loggerMiddleware({
-*   format: (e) => `${e.method} ${e.path} (${e.duration}ms)`,
-* })
-* ```
-*/
-function loggerMiddleware(config) {
-	if ((config?.level ?? "all") === "none") return () => {};
-	const skip = config?.skip ?? [
-		"/__",
-		"/@",
-		"/node_modules"
-	];
-	const isDev = typeof process !== "undefined" && process.env.NODE_ENV !== "production";
-	const colors = config?.colors ?? isDev;
-	return (ctx) => {
-		if (skip.some((p) => ctx.path.startsWith(p))) return;
-		const start = performance.now();
-		const entry = {
-			method: ctx.req.method ?? "GET",
-			path: ctx.path,
-			duration: 0,
-			timestamp: /* @__PURE__ */ new Date(),
-			userAgent: ctx.req.headers.get("user-agent") ?? void 0
-		};
-		queueMicrotask(() => {
-			entry.duration = performance.now() - start;
-			if (config?.format) {
-				const line = config.format(entry);
-				if (line) console.log(line);
-			} else console.log(defaultFormat(entry, colors));
-		});
-	};
-}
-
-//#endregion
-//#region src/env.ts
-/**
-* String validator — accepts any non-empty string.
-*/
-function str(options) {
-	return {
-		__type: "env-validator",
-		required: options?.default === void 0 && options?.required !== false,
-		defaultValue: options?.default,
-		parse(raw, key) {
-			if (raw === void 0 || raw === "") {
-				if (options?.default !== void 0) return options.default;
-				throw new EnvError(key, "is required but not set", options?.description);
-			}
-			return raw;
-		}
-	};
-}
-/**
-* Number validator — parses to a number, rejects NaN.
-*/
-function num(options) {
-	return {
-		__type: "env-validator",
-		required: options?.default === void 0 && options?.required !== false,
-		defaultValue: options?.default,
-		parse(raw, key) {
-			if (raw === void 0 || raw === "") {
-				if (options?.default !== void 0) return options.default;
-				throw new EnvError(key, "is required but not set", options?.description);
-			}
-			const n = Number(raw);
-			if (Number.isNaN(n)) throw new EnvError(key, `must be a number, got "${raw}"`, options?.description);
-			return n;
-		}
-	};
-}
-/**
-* Boolean validator — accepts "true"/"1" as true, "false"/"0" as false.
-*/
-function bool(options) {
-	return {
-		__type: "env-validator",
-		required: options?.default === void 0 && options?.required !== false,
-		defaultValue: options?.default,
-		parse(raw, key) {
-			if (raw === void 0 || raw === "") {
-				if (options?.default !== void 0) return options.default;
-				throw new EnvError(key, "is required but not set", options?.description);
-			}
-			const lower = raw.toLowerCase();
-			if (lower === "true" || lower === "1") return true;
-			if (lower === "false" || lower === "0") return false;
-			throw new EnvError(key, `must be "true" or "false", got "${raw}"`, options?.description);
-		}
-	};
-}
-/**
-* URL validator — validates that the value is a valid URL.
-*/
-function url(options) {
-	return {
-		__type: "env-validator",
-		required: options?.default === void 0 && options?.required !== false,
-		defaultValue: options?.default,
-		parse(raw, key) {
-			if (raw === void 0 || raw === "") {
-				if (options?.default !== void 0) return options.default;
-				throw new EnvError(key, "is required but not set", options?.description);
-			}
-			try {
-				new URL(raw);
-				return raw;
-			} catch {
-				throw new EnvError(key, `must be a valid URL, got "${raw}"`, options?.description);
-			}
-		}
-	};
-}
-/**
-* Enum validator — value must be one of the allowed values.
-*/
-function oneOf(values, options) {
-	return {
-		__type: "env-validator",
-		required: options?.default === void 0 && options?.required !== false,
-		defaultValue: options?.default,
-		parse(raw, key) {
-			if (raw === void 0 || raw === "") {
-				if (options?.default !== void 0) return options.default;
-				throw new EnvError(key, "is required but not set", options?.description);
-			}
-			if (!values.includes(raw)) throw new EnvError(key, `must be one of [${values.join(", ")}], got "${raw}"`, options?.description);
-			return raw;
-		}
-	};
-}
-var EnvError = class extends Error {
-	constructor(key, message, description) {
-		const desc = description ? ` (${description})` : "";
-		super(`[zero:env] ${key}${desc}: ${message}`);
-		this.name = "EnvError";
-	}
-};
-function isEnvValidator(v) {
-	return typeof v === "object" && v !== null && v.__type === "env-validator";
-}
-/**
-* Convert a plain schema value to an EnvValidator.
-*
-* - `3000` → num({ default: 3000 })
-* - `false` → bool({ default: false })
-* - `"localhost"` → str({ default: "localhost" })
-* - `String` → str() (required)
-* - `Number` → num() (required)
-* - `Boolean` → bool() (required)
-* - EnvValidator → pass through
-*/
-function toValidator(value) {
-	if (isEnvValidator(value)) return value;
-	if (value === String) return str();
-	if (value === Number) return num();
-	if (value === Boolean) return bool();
-	if (typeof value === "number") return num({ default: value });
-	if (typeof value === "boolean") return bool({ default: value });
-	if (typeof value === "string") return str({ default: value });
-	throw new Error(`[zero:env] Invalid schema value: ${String(value)}. Use a default value, String/Number/Boolean, or a validator like url().`);
-}
-/**
-* Validate environment variables.
-*
-* Schema values can be:
-* - **Default values**: `3000`, `false`, `"localhost"` → type inferred, used as default
-* - **Constructors**: `String`, `Number`, `Boolean` → required, no default
-* - **Validators**: `url()`, `oneOf([...])`, `str()`, `num()`, `bool()` → explicit validation
-* - **Custom**: `schema(raw => z.coerce.number().parse(raw))` — bridge to any schema library
-*
-* @example
-* ```ts
-* import { validateEnv, url, oneOf } from "@pyreon/zero/env"
-*
-* const env = validateEnv({
-*   PORT: 3000,                                // optional, default 3000
-*   DATABASE_URL: url(),                       // required, validated URL
-*   NODE_ENV: oneOf(["dev", "prod", "test"]),  // required, must be one of
-*   API_KEY: String,                           // required string
-*   DEBUG: false,                              // optional, default false
-* })
-* ```
-*/
-function validateEnv(schema, source) {
-	const env = source ?? (typeof process !== "undefined" ? process.env : {});
-	const result = {};
-	const errors = [];
-	for (const [key, entry] of Object.entries(schema)) {
-		const validator = toValidator(entry);
-		try {
-			result[key] = validator.parse(env[key], key);
-		} catch (e) {
-			errors.push(e.message);
-		}
-	}
-	if (errors.length > 0) {
-		const header = `\n[zero:env] Environment validation failed (${errors.length} error${errors.length > 1 ? "s" : ""}):\n`;
-		const body = errors.map((e) => `  ✗ ${e.replace("[zero:env] ", "")}`).join("\n");
-		throw new Error(header + body + "\n");
-	}
-	return result;
-}
-function publicEnv(schema) {
-	const prefix = "ZERO_PUBLIC_";
-	const env = typeof process !== "undefined" ? process.env : {};
-	if (!schema) {
-		const result = {};
-		for (const [key, value] of Object.entries(env)) if (key.startsWith(prefix) && value !== void 0) result[key.slice(12)] = value;
-		return result;
-	}
-	const prefixedSource = {};
-	for (const key of Object.keys(schema)) prefixedSource[key] = env[`${prefix}${key}`];
-	return validateEnv(schema, prefixedSource);
-}
-/**
-* Create an env validator from a custom parse function.
-* Use this to integrate any schema library (Zod, Valibot, ArkType, etc.).
-*
-* @example
-* ```ts
-* import { z } from "zod"
-* import { validateEnv, schema } from "@pyreon/zero/env"
-*
-* const env = validateEnv({
-*   PORT: schema(raw => z.coerce.number().parse(raw)),
-*   DATABASE_URL: schema(raw => z.string().url().parse(raw)),
-*   HOST: "localhost",  // plain defaults still work alongside
-* })
-* ```
-*/
-function schema(parse) {
-	return {
-		__type: "env-validator",
-		required: true,
-		defaultValue: void 0,
-		parse(raw, key) {
-			if (raw === void 0 || raw === "") throw new Error(`[zero:env] ${key}: is required but not set`);
-			try {
-				return parse(raw);
-			} catch (e) {
-				const msg = e instanceof Error ? e.message : String(e);
-				throw new Error(`[zero:env] ${key}: ${msg}`);
-			}
-		}
-	};
-}
-
-//#endregion
-//#region src/ai.ts
-/**
-* Generate llms.txt content from route files and config.
-*
-* Format follows the llms.txt proposal:
-* ```
-* # {name}
-* > {description}
-*
-* ## Pages
-* - [/about](/about): About page
-*
-* ## API
-* - GET /api/posts: List posts
-* ```
-*
-* @internal Exported for testing.
-*/
-function generateLlmsTxt(routeFiles, apiFiles, config) {
-	const lines = [];
-	lines.push(`# ${config.name}`);
-	lines.push(`> ${config.description}`);
-	lines.push("");
-	const routes = parseFileRoutes(routeFiles);
-	const pages = routes.filter((r) => !r.isLayout && !r.isError && !r.isLoading && !r.isNotFound && !r.isCatchAll && !r.urlPath.includes(":"));
-	if (pages.length > 0) {
-		lines.push("## Pages");
-		lines.push("");
-		for (const page of pages) {
-			const desc = config.pageDescriptions?.[page.urlPath];
-			const url = `${config.origin}${page.urlPath === "/" ? "" : page.urlPath}`;
-			if (desc) lines.push(`- [${page.urlPath}](${url}): ${desc}`);
-			else lines.push(`- [${page.urlPath}](${url})`);
-		}
-		lines.push("");
-	}
-	const dynamicRoutes = routes.filter((r) => !r.isLayout && !r.isError && !r.isLoading && !r.isNotFound && (r.urlPath.includes(":") || r.isCatchAll));
-	if (dynamicRoutes.length > 0) {
-		lines.push("## Dynamic Pages");
-		lines.push("");
-		for (const route of dynamicRoutes) {
-			const desc = config.pageDescriptions?.[route.urlPath];
-			if (desc) lines.push(`- ${route.urlPath}: ${desc}`);
-			else lines.push(`- ${route.urlPath}`);
-		}
-		lines.push("");
-	}
-	const apiPatterns = parseApiFiles(apiFiles);
-	if (apiPatterns.length > 0 || config.apiDescriptions) {
-		lines.push("## API Endpoints");
-		lines.push("");
-		if (config.apiDescriptions) for (const [endpoint, desc] of Object.entries(config.apiDescriptions)) lines.push(`- ${endpoint}: ${desc}`);
-		const describedPatterns = new Set(Object.keys(config.apiDescriptions ?? {}).map((k) => k.replace(/^(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s+/, "")));
-		for (const pattern of apiPatterns) if (!describedPatterns.has(pattern)) lines.push(`- ${pattern}`);
-		lines.push("");
-	}
-	if (config.llmsExtra) {
-		lines.push(config.llmsExtra);
-		lines.push("");
-	}
-	return lines.join("\n");
-}
-/**
-* Generate llms-full.txt — expanded version with more detail.
-* Includes all route metadata and API descriptions.
-*
-* @internal Exported for testing.
-*/
-function generateLlmsFullTxt(routeFiles, apiFiles, config) {
-	const lines = [];
-	lines.push(`# ${config.name} — Full Reference`);
-	lines.push(`> ${config.description}`);
-	lines.push("");
-	lines.push(`Base URL: ${config.origin}`);
-	lines.push("");
-	const pages = parseFileRoutes(routeFiles).filter((r) => !r.isLayout && !r.isError && !r.isLoading && !r.isNotFound);
-	if (pages.length > 0) {
-		lines.push("## All Routes");
-		lines.push("");
-		for (const page of pages) {
-			const desc = config.pageDescriptions?.[page.urlPath] ?? "";
-			const dynamic = page.urlPath.includes(":") ? " (dynamic)" : "";
-			const catchAll = page.isCatchAll ? " (catch-all)" : "";
-			lines.push(`### ${page.urlPath}${dynamic}${catchAll}`);
-			if (desc) lines.push(desc);
-			lines.push(`- File: ${page.filePath}`);
-			lines.push(`- Render mode: ${page.renderMode}`);
-			lines.push("");
-		}
-	}
-	if (config.apiDescriptions) {
-		lines.push("## API Reference");
-		lines.push("");
-		for (const [endpoint, desc] of Object.entries(config.apiDescriptions)) {
-			lines.push(`### ${endpoint}`);
-			lines.push(desc);
-			lines.push("");
-		}
-	}
-	if (config.llmsExtra) {
-		lines.push("## Additional Information");
-		lines.push("");
-		lines.push(config.llmsExtra);
-		lines.push("");
-	}
-	return lines.join("\n");
-}
-/**
-* Auto-infer JSON-LD structured data from page metadata.
-*
-* Returns an array of JSON-LD objects (multiple schemas can apply to one page).
-* For example, an article page gets both `Article` and `BreadcrumbList`.
-*
-* @example
-* ```tsx
-* const schemas = inferJsonLd({
-*   url: "https://example.com/blog/my-post",
-*   title: "My Post",
-*   description: "A great article",
-*   type: "article",
-*   author: "Vit Bokisch",
-*   publishedTime: "2026-03-31",
-* })
-* // → [Article schema, BreadcrumbList schema]
-* ```
-*/
-function inferJsonLd(options) {
-	const schemas = [];
-	if (options.type === "article") {
-		const article = {
-			"@context": "https://schema.org",
-			"@type": "Article",
-			headline: options.title,
-			url: options.url
-		};
-		if (options.description) article.description = options.description;
-		if (options.image) article.image = options.image;
-		if (options.publishedTime) article.datePublished = options.publishedTime;
-		if (options.author) article.author = {
-			"@type": "Person",
-			name: options.author
-		};
-		if (options.tags && options.tags.length > 0) article.keywords = options.tags.join(", ");
-		if (options.siteName) article.publisher = {
-			"@type": "Organization",
-			name: options.siteName
-		};
-		schemas.push(article);
-	} else if (options.type === "product") {
-		const product = {
-			"@context": "https://schema.org",
-			"@type": "Product",
-			name: options.title,
-			url: options.url
-		};
-		if (options.description) product.description = options.description;
-		if (options.image) product.image = options.image;
-		schemas.push(product);
-	} else {
-		const webpage = {
-			"@context": "https://schema.org",
-			"@type": "WebPage",
-			name: options.title,
-			url: options.url
-		};
-		if (options.description) webpage.description = options.description;
-		if (options.image) webpage.thumbnailUrl = options.image;
-		schemas.push(webpage);
-	}
-	if (options.breadcrumbs && options.breadcrumbs.length > 0) schemas.push({
-		"@context": "https://schema.org",
-		"@type": "BreadcrumbList",
-		itemListElement: options.breadcrumbs.map((bc, i) => ({
-			"@type": "ListItem",
-			position: i + 1,
-			name: bc.name,
-			item: bc.url
-		}))
-	});
-	else {
-		const urlObj = safeParseUrl(options.url);
-		if (urlObj) {
-			const segments = urlObj.pathname.split("/").filter(Boolean);
-			if (segments.length > 0) {
-				const items = [{
-					"@type": "ListItem",
-					position: 1,
-					name: "Home",
-					item: urlObj.origin
-				}];
-				let path = "";
-				for (let i = 0; i < segments.length; i++) {
-					path += `/${segments[i]}`;
-					items.push({
-						"@type": "ListItem",
-						position: i + 2,
-						name: capitalize(segments[i].replace(/-/g, " ")),
-						item: `${urlObj.origin}${path}`
-					});
-				}
-				schemas.push({
-					"@context": "https://schema.org",
-					"@type": "BreadcrumbList",
-					itemListElement: items
-				});
-			}
-		}
-	}
-	return schemas;
-}
-/**
-* Generate an OpenAI-compatible AI plugin manifest.
-*
-* Follows the /.well-known/ai-plugin.json spec.
-*
-* @internal Exported for testing.
-*/
-function generateAiPluginManifest(config) {
-	return {
-		schema_version: "v1",
-		name_for_human: config.name,
-		name_for_model: config.name.toLowerCase().replace(/\s+/g, "_").replace(/[^a-z0-9_]/g, ""),
-		description_for_human: config.description,
-		description_for_model: config.description,
-		auth: { type: "none" },
-		api: {
-			type: "openapi",
-			url: `${config.origin}/.well-known/openapi.yaml`
-		},
-		logo_url: config.logoUrl ?? `${config.origin}/favicon.svg`,
-		contact_email: config.contactEmail ?? "",
-		legal_info_url: config.legalUrl ?? `${config.origin}/legal`
-	};
-}
-/**
-* Generate a minimal OpenAPI 3.0 spec from API route descriptions.
-*
-* @internal Exported for testing.
-*/
-function generateOpenApiSpec(apiFiles, config) {
-	const paths = {};
-	if (config.apiDescriptions) for (const [endpoint, desc] of Object.entries(config.apiDescriptions)) {
-		const match = endpoint.match(/^(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s+(.+)$/);
-		if (match) {
-			const method = match[1].toLowerCase();
-			const openApiPath = match[2].replace(/:(\w+)/g, "{$1}");
-			if (!paths[openApiPath]) paths[openApiPath] = {};
-			paths[openApiPath][method] = {
-				summary: desc,
-				responses: { "200": { description: "Success" } }
-			};
-		}
-	}
-	for (const pattern of parseApiFiles(apiFiles)) {
-		const openApiPath = pattern.replace(/:(\w+)/g, "{$1}");
-		if (!paths[openApiPath]) paths[openApiPath] = { get: {
-			summary: `${openApiPath} endpoint`,
-			responses: { "200": { description: "Success" } }
-		} };
-	}
-	return {
-		openapi: "3.0.0",
-		info: {
-			title: config.name,
-			description: config.description,
-			version: "1.0.0"
-		},
-		servers: [{ url: config.origin }],
-		paths
-	};
-}
-/**
-* AI integration Vite plugin.
-*
-* Generates at build time:
-* - `/llms.txt` — concise site summary for AI agents
-* - `/llms-full.txt` — detailed reference for AI agents
-* - `/.well-known/ai-plugin.json` — OpenAI plugin manifest
-* - `/.well-known/openapi.yaml` — minimal OpenAPI spec from API routes
-*
-* In dev, serves these files via middleware.
-*
-* @example
-* ```ts
-* import { aiPlugin } from "@pyreon/zero/ai"
-*
-* export default {
-*   plugins: [
-*     aiPlugin({
-*       name: "My App",
-*       origin: "https://example.com",
-*       description: "A modern web application",
-*       apiDescriptions: {
-*         "GET /api/posts": "List blog posts",
-*         "GET /api/posts/:id": "Get post by ID",
-*       },
-*     }),
-*   ],
-* }
-* ```
-*/
-function aiPlugin(config) {
-	let root = "";
-	let isBuild = false;
-	let routeFiles = [];
-	let apiFiles = [];
-	return {
-		name: "pyreon-zero-ai",
-		enforce: "post",
-		configResolved(resolvedConfig) {
-			root = resolvedConfig.root;
-			isBuild = resolvedConfig.command === "build";
-		},
-		async buildStart() {
-			try {
-				const { join } = await import("node:path");
-				const routesDir = join(root, config.routesDir ?? "src/routes");
-				const apiDir = join(root, config.apiDir ?? "src/api");
-				routeFiles = await scanDir(routesDir, routesDir);
-				apiFiles = await scanDir(apiDir, apiDir);
-			} catch {}
-		},
-		configureServer(server) {
-			server.middlewares.use(async (req, res, next) => {
-				const url = req.url ?? "";
-				if (url === "/llms.txt") {
-					res.setHeader("Content-Type", "text/plain; charset=utf-8");
-					res.end(generateLlmsTxt(routeFiles, apiFiles, config));
-					return;
-				}
-				if (url === "/llms-full.txt") {
-					res.setHeader("Content-Type", "text/plain; charset=utf-8");
-					res.end(generateLlmsFullTxt(routeFiles, apiFiles, config));
-					return;
-				}
-				if (url === "/.well-known/ai-plugin.json") {
-					res.setHeader("Content-Type", "application/json");
-					res.end(JSON.stringify(generateAiPluginManifest(config), null, 2));
-					return;
-				}
-				if (url === "/.well-known/openapi.yaml" || url === "/.well-known/openapi.json") {
-					res.setHeader("Content-Type", "application/json");
-					res.end(JSON.stringify(generateOpenApiSpec(apiFiles, config), null, 2));
-					return;
-				}
-				next();
-			});
-		},
-		async generateBundle() {
-			if (!isBuild) return;
-			this.emitFile({
-				type: "asset",
-				fileName: "llms.txt",
-				source: generateLlmsTxt(routeFiles, apiFiles, config)
-			});
-			this.emitFile({
-				type: "asset",
-				fileName: "llms-full.txt",
-				source: generateLlmsFullTxt(routeFiles, apiFiles, config)
-			});
-			this.emitFile({
-				type: "asset",
-				fileName: ".well-known/ai-plugin.json",
-				source: JSON.stringify(generateAiPluginManifest(config), null, 2)
-			});
-			this.emitFile({
-				type: "asset",
-				fileName: ".well-known/openapi.json",
-				source: JSON.stringify(generateOpenApiSpec(apiFiles, config), null, 2)
-			});
-		}
-	};
-}
-function parseApiFiles(files) {
-	return files.filter((f) => f.endsWith(".ts") || f.endsWith(".js")).map((f) => {
-		let path = f.replace(/\.\w+$/, "").replace(/\/index$/, "");
-		if (!path.startsWith("/")) path = `/${path}`;
-		path = path.replace(/\[\.\.\.(\w+)\]/g, ":$1*").replace(/\[(\w+)\]/g, ":$1");
-		return `/api${path === "/" ? "" : path}`;
-	});
-}
-async function scanDir(dir, base) {
-	const { readdir, stat } = await import("node:fs/promises");
-	const { join, relative } = await import("node:path");
-	try {
-		const entries = await readdir(dir);
-		const files = [];
-		for (const entry of entries) {
-			const full = join(dir, entry);
-			if ((await stat(full)).isDirectory()) files.push(...await scanDir(full, base));
-			else files.push(relative(base, full));
-		}
-		return files;
-	} catch {
-		return [];
-	}
-}
-function safeParseUrl(url) {
-	try {
-		return new URL(url);
-	} catch {
-		return null;
-	}
+/** @deprecated Import from `@pyreon/zero/og-image` instead */
+function ogImagePlugin(..._) {
+	return serverOnly("ogImagePlugin", "og-image");
 }
-function capitalize(s) {
-	return s.charAt(0).toUpperCase() + s.slice(1);
+/** @deprecated Import from `@pyreon/zero/ai` instead */
+function aiPlugin(..._) {
+	return serverOnly("aiPlugin", "ai");
 }
 
 //#endregion
-export { Image, Link, Meta, Script, ThemeToggle, aiPlugin, bool, buildCspHeader, buildLocalePath, buildMetaTags, bunAdapter, cacheMiddleware, cloudflareAdapter, compose, compressResponse, compressionMiddleware, corsMiddleware, createActionMiddleware, createApiMiddleware, createApp, createISRHandler, createLink, createLocaleContext, createServer, cspMiddleware, zeroPlugin as default, defineAction, defineConfig, detectLocaleFromHeader, extractLocaleFromPath, faviconLinks, faviconPlugin, filePathToUrlPath, fontPlugin, fontVariables, generateAiPluginManifest, generateApiRouteModule, generateLlmsFullTxt, generateLlmsTxt, generateMiddlewareModule, generateOpenApiSpec, generateRobots, generateRouteModule, generateSitemap, getContext, i18nRouting, imagePlugin, inferJsonLd, initTheme, isCompressible, jsonLd, loggerMiddleware, netlifyAdapter, nodeAdapter, num, ogImagePath, ogImagePlugin, oneOf, parseFileRoutes, prefetchRoute, publicEnv, rateLimitMiddleware, render404Page, resolveAdapter, resolveConfig, resolvedTheme, scanRouteFiles, schema, securityHeaders, seoMiddleware, seoPlugin, setLocale, setSSRThemeDefault, setTheme, staticAdapter, str, theme, themeScript, toggleTheme, url, useLink, useLocale, useNonce, validateEnv, varyEncoding, vercelAdapter };
+export { Image, Link, Meta, Script, ThemeToggle, aiPlugin, buildLocalePath, buildMetaTags, createLink, createServer, defineConfig, extractLocaleFromPath, faviconPlugin, initTheme, ogImagePlugin, prefetchRoute, resolvedTheme, seoPlugin, setLocale, setSSRThemeDefault, setTheme, theme, themeScript, toggleTheme, useLink, useLocale, validateEnv };
 //# sourceMappingURL=index.js.map