@stratal/inertia 0.0.21 → 0.0.23

package/dist/index.mjs

@@ -1,14 +1,10 @@
-import { n as runTypeGeneration, t as findPagesDir } from "./type-generator-o_PxETTs.mjs";
-import { DI_TOKENS, Scope, Transient, inject } from "stratal/di";
+import { t as __decorate } from "./decorate-B7nr7eBl.mjs";
+import { n as buildSeoTags, r as descriptorToHtml, t as DATA_SEO_ATTR } from "./build-seo-tags-DBsHKxX9.mjs";
 import { ApplicationError } from "stratal/errors";
-import { I18N_TOKENS } from "stratal/i18n";
 import { Module } from "stratal/module";
-import { Delete, Get, Patch, Post, Put, ROUTER_TOKENS, Route, RouterContext, SchemaValidationError } from "stratal/router";
-import { spawn } from "node:child_process";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join, relative } from "node:path";
-import { Command } from "stratal/quarry";
-import { watch } from "node:fs/promises";
+import { Delete, Get, Patch, Post, Put, ROUTER_TOKENS, Route, RouterContext, SchemaValidationError, applyTrailingSlash } from "stratal/router";
+import { CONTAINER_TOKEN, DI_TOKENS, Request, Singleton, Transient, inject } from "stratal/di";
+import { I18N_TOKENS } from "stratal/i18n";
 import { LOGGER_TOKENS } from "stratal/logger";
 import { deleteCookie, getSignedCookie, setSignedCookie } from "hono/cookie";
 import { z } from "stratal/validation";
@@ -44,359 +40,35 @@ function augmentRouterContext(resolveService) {
 		const flashOut = this.c.get("inertiaFlashOut");
 		if (flashOut) flashOut[key] = value;
 	});
+	RouterContext.macro("share", function(key, value) {
+		resolveService(this).share(key, value);
+	});
+	RouterContext.macro("seo", function(data) {
+		resolveService(this).seo(data);
+	});
 	RouterContext.macro("withoutSsr", function() {
 		this.c.set("withoutSsr", true);
 	});
 }
 //#endregion
-//#region src/vite/create-vite-config.ts
-function writeTempViteConfig(options) {
-	const configPath = join(join(options.cwd, "node_modules", ".stratal"), "vite.config.mjs");
-	mkdirSync(dirname(configPath), { recursive: true });
-	const hasUserConfig = existsSync(join(options.cwd, "vite.config.ts"));
-	const serverConfig = options.server ? `server: { port: ${options.server.port}, host: ${options.server.host ? "true" : "undefined"} },` : "";
-	const outDirConfig = options.outDir ? `outDir: '${options.outDir}',` : "";
-	writeFileSync(configPath, `
-import { mergeConfig } from 'vite'
-import { cloudflare } from '@cloudflare/vite-plugin'
-import { stratalInertia } from '@stratal/inertia/vite'
-
-let inertiaPlugin = null
-try {
-  const mod = await import('@inertiajs/vite')
-  const inertia = mod.default ?? mod
-  inertiaPlugin = inertia()
-} catch {}
-
-const baseConfig = {
-  plugins: [
-    cloudflare(${options.persistTo ? `{ persistState: { path: ${JSON.stringify(options.persistTo)} } }` : ""}),
-    ...(inertiaPlugin ? [inertiaPlugin] : []),
-    ...stratalInertia(),
-  ],
-  publicDir: '${join(options.cwd, "src", "inertia", "public").replace(/\\/g, "/")}',
-  build: {
-    ${outDirConfig}
-  },
-  ${serverConfig}
-}
-
-${hasUserConfig ? `const userModule = await import('${join(options.cwd, "vite.config.ts").replace(/\\/g, "/")}')
-const userConfig = userModule.default ?? userModule
-export default mergeConfig(baseConfig, userConfig)` : "export default baseConfig"}
-`, "utf-8");
-	return configPath;
-}
-//#endregion
-//#region src/commands/inertia-build.command.ts
-var InertiaBuildCommand = class extends Command {
-	static command = "inertia:build {--outDir=dist : Output directory} {--ssr : Also build SSR bundle}";
-	static description = "Build Inertia.js frontend for production";
-	async handle() {
-		const outDir = this.string("outDir") || "dist";
-		const shouldBuildSsr = this.boolean("ssr");
-		const cwd = process.cwd();
-		if (!existsSync(join(cwd, "src/inertia/app.tsx"))) {
-			this.fail("src/inertia/app.tsx not found. Run `quarry inertia:install` first.");
-			return 1;
-		}
-		const configPath = writeTempViteConfig({
-			cwd,
-			outDir
-		});
-		this.info("Building Inertia.js frontend for production...");
-		const clientCode = await this.spawnVite(cwd, configPath, ["build"]);
-		if (clientCode !== 0) {
-			this.fail("Client build failed.");
-			return clientCode;
-		}
-		this.success("Client build complete!");
-		if (shouldBuildSsr) {
-			this.info("Building SSR bundle...");
-			const ssrCode = await this.spawnVite(cwd, configPath, ["build", "--ssr"]);
-			if (ssrCode !== 0) {
-				this.fail("SSR build failed.");
-				return ssrCode;
-			}
-			this.success("SSR build complete!");
-		}
-		this.success(`Output in ${outDir}/`);
-		this.info("Deploy with: npx wrangler deploy");
-		return 0;
-	}
-	spawnVite(cwd, configPath, args) {
-		return new Promise((resolve) => {
-			const child = spawn("npx", [
-				"vite",
-				"--config",
-				configPath,
-				...args
-			], {
-				cwd,
-				stdio: "inherit",
-				shell: true
-			});
-			child.on("error", (err) => {
-				this.fail(`Vite process error: ${err.message}`);
-				resolve(1);
-			});
-			child.on("close", (code) => {
-				resolve(code ?? 0);
-			});
-		});
-	}
-};
-//#endregion
-//#region src/commands/inertia-dev.command.ts
-var InertiaDevCommand = class extends Command {
-	static command = "inertia:dev {--port= : Dev server port} {--host : Expose to network} {--persist-to= : Shared persist directory for @cloudflare/vite-plugin (relative to cwd; the plugin appends /v3). Use to share R2/KV/cache emulator state across multiple workers in dev.}";
-	static description = "Start Inertia.js Vite development server";
-	async handle() {
-		const port = this.number("port");
-		const host = this.boolean("host");
-		const persistTo = this.string("persist-to");
-		const cwd = process.cwd();
-		if (!existsSync(join(cwd, "src/inertia/app.tsx"))) {
-			this.fail("src/inertia/app.tsx not found. Run `quarry inertia:install` first.");
-			return 1;
-		}
-		const configPath = writeTempViteConfig({
-			cwd,
-			server: {
-				port,
-				host
-			},
-			persistTo
-		});
-		this.info("Starting Vite dev server...");
-		const args = [
-			"vite",
-			"dev",
-			"--config",
-			configPath
-		];
-		if (host) args.push("--host");
-		return new Promise((resolve) => {
-			const child = spawn("npx", args, {
-				cwd,
-				stdio: "inherit",
-				shell: true
-			});
-			child.on("error", (err) => {
-				this.fail(`Failed to start dev server: ${err.message}`);
-				resolve(1);
-			});
-			child.on("close", (code) => {
-				resolve(code ?? 0);
-			});
-		});
-	}
-};
-//#endregion
-//#region src/commands/inertia-install.command.ts
-const ROOT_HTML = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  @viteHead
-  @inertiaHead
-</head>
-<body>
-  @inertia
-  @viteScripts
-</body>
-</html>`;
-const APP_TSX = `import { createInertiaApp } from '@inertiajs/react'
-
-createInertiaApp({
-  resolve: async (name) => {
-    const pages = import.meta.glob('./pages/**/*.tsx')
-    const page = await pages[\`./pages/\${name}.tsx\`]?.()
-    if (!page) throw new Error(\`Page not found: \${name}\`)
-    return page
-  },
-})`;
-const HOME_TSX = `export default function Home({ message }: { message: string }) {
-  return (
-    <div>
-      <h1>{message}</h1>
-      <p>This page is rendered with Inertia.js and Stratal.</p>
-    </div>
-  )
-}`;
-var InertiaInstallCommand = class extends Command {
-	static command = "inertia:install {--skip-deps : Skip installing npm dependencies}";
-	static description = "Scaffold Inertia.js files for a Stratal project";
-	async handle() {
-		const skipDeps = this.boolean("skip-deps");
-		const cwd = process.cwd();
-		const inertiaDir = join(cwd, "src", "inertia");
-		const pagesDir = join(inertiaDir, "pages");
-		this.info("Creating src/inertia/ directory...");
-		mkdirSync(pagesDir, { recursive: true });
-		const publicDir = join(inertiaDir, "public");
-		mkdirSync(publicDir, { recursive: true });
-		const gitkeepPath = join(publicDir, ".gitkeep");
-		if (!existsSync(gitkeepPath)) writeFileSync(gitkeepPath, "", "utf-8");
-		this.success("Created src/inertia/public/");
-		const files = [
-			{
-				path: join(inertiaDir, "root.html"),
-				content: ROOT_HTML,
-				name: "root.html"
-			},
-			{
-				path: join(inertiaDir, "app.tsx"),
-				content: APP_TSX,
-				name: "app.tsx"
-			},
-			{
-				path: join(pagesDir, "Home.tsx"),
-				content: HOME_TSX,
-				name: "pages/Home.tsx"
-			}
-		];
-		for (const file of files) if (existsSync(file.path)) this.warn(`Skipping ${file.name} (already exists)`);
-		else {
-			writeFileSync(file.path, file.content, "utf-8");
-			this.success(`Created src/inertia/${file.name}`);
-		}
-		const appModulePath = join(cwd, "src", "app.module.ts");
-		if (existsSync(appModulePath)) {
-			this.info("Updating src/app.module.ts...");
-			try {
-				if (await this.updateAppModule(appModulePath)) this.success("Updated src/app.module.ts with InertiaModule");
-				else this.info("InertiaModule already configured in app.module.ts");
-			} catch (err) {
-				this.warn(`Could not auto-update app.module.ts: ${err.message}`);
-				this.info("Please manually add InertiaModule.forRoot() to your module imports");
-			}
-		} else this.info("No src/app.module.ts found — please manually configure InertiaModule");
-		try {
-			const { outputPath, pageCount } = await runTypeGeneration(cwd);
-			const relPath = relative(cwd, outputPath);
-			this.success(`Generated ${relPath} (${pageCount} page${pageCount !== 1 ? "s" : ""})`);
-		} catch {
-			this.warn("Could not generate initial type definitions. Run `quarry inertia:types` manually.");
-		}
-		if (!skipDeps) {
-			this.newLine();
-			this.info("Install the following dependencies:");
-			this.line("  npm install @stratal/inertia @inertiajs/react @inertiajs/vite react react-dom");
-			this.line("  npm install -D @types/react @types/react-dom vite @cloudflare/vite-plugin");
-		}
-		this.newLine();
-		this.success("Inertia.js scaffolding complete!");
-		this.info("Run `quarry inertia:dev` to start the dev server");
-		return 0;
-	}
-	async updateAppModule(modulePath) {
-		const { Project, SyntaxKind } = await import("ts-morph");
-		const sourceFile = new Project({ useInMemoryFileSystem: false }).addSourceFileAtPath(modulePath);
-		if (sourceFile.getImportDeclaration((decl) => decl.getModuleSpecifierValue() === "@stratal/inertia")) return false;
-		sourceFile.addImportDeclaration({
-			defaultImport: "rootView",
-			moduleSpecifier: "./inertia/root.html?raw"
-		});
-		sourceFile.addImportDeclaration({
-			namedImports: ["InertiaModule"],
-			moduleSpecifier: "@stratal/inertia"
-		});
-		const classes = sourceFile.getClasses();
-		for (const cls of classes) {
-			const moduleDecorator = cls.getDecorator("Module");
-			if (!moduleDecorator) continue;
-			const args = moduleDecorator.getArguments();
-			if (args.length === 0) continue;
-			const objLiteral = args[0].asKind(SyntaxKind.ObjectLiteralExpression);
-			if (!objLiteral) continue;
-			const importsProp = objLiteral.getProperty("imports");
-			if (importsProp) {
-				const arrayLiteral = (importsProp.asKind(SyntaxKind.PropertyAssignment)?.getInitializer())?.asKind(SyntaxKind.ArrayLiteralExpression);
-				if (arrayLiteral) arrayLiteral.addElement(`InertiaModule.forRoot({\n    rootView,\n  })`);
-			} else objLiteral.addPropertyAssignment({
-				name: "imports",
-				initializer: `[\n    InertiaModule.forRoot({\n      rootView,\n    }),\n  ]`
-			});
-			break;
-		}
-		await sourceFile.save();
-		return true;
-	}
-};
-//#endregion
-//#region src/commands/inertia-types.command.ts
-var InertiaTypesCommand = class extends Command {
-	static command = "inertia:types {--watch : Watch for changes and regenerate}";
-	static description = "Generate Inertia.js page type definitions";
-	async handle() {
-		const cwd = process.cwd();
-		if (!existsSync(findPagesDir(cwd))) {
-			this.fail("src/inertia/pages/ not found. Run `quarry inertia:install` first.");
-			return 1;
-		}
-		if (!await this.generate(cwd)) return 1;
-		if (this.boolean("watch")) {
-			this.info("Watching for changes...");
-			await this.watchForChanges(cwd);
-		}
-		return 0;
-	}
-	async generate(cwd) {
-		try {
-			const { outputPath, pageCount } = await runTypeGeneration(cwd);
-			const relPath = relative(cwd, outputPath);
-			this.success(`Generated ${relPath} (${pageCount} page${pageCount !== 1 ? "s" : ""})`);
-			return true;
-		} catch (err) {
-			this.fail(`Type generation failed: ${err.message}`);
-			return false;
-		}
-	}
-	async watchForChanges(cwd) {
-		const srcDir = join(cwd, "src");
-		try {
-			const watcher = watch(srcDir, { recursive: true });
-			for await (const event of watcher) if (event.filename && /\.(tsx|ts)$/.test(event.filename)) {
-				this.info(`Change detected: ${event.filename}`);
-				await this.generate(cwd);
-			}
-		} catch (err) {
-			this.fail(`Watch failed: ${err.message}`);
-		}
-	}
-};
-//#endregion
 //#region src/inertia.tokens.ts
 const INERTIA_TOKENS = {
 	Options: Symbol.for("stratal:inertia:options"),
 	InertiaService: Symbol.for("stratal:inertia:service"),
 	TemplateService: Symbol.for("stratal:inertia:template"),
 	ManifestService: Symbol.for("stratal:inertia:manifest"),
-	SsrRenderer: Symbol.for("stratal:inertia:ssr-renderer")
+	SsrRenderer: Symbol.for("stratal:inertia:ssr-renderer"),
+	HreflangService: Symbol.for("stratal:inertia:hreflang"),
+	SeoService: Symbol.for("stratal:inertia:seo")
 };
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
+//#region \0@oxc-project+runtime@0.133.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-//#endregion
 //#region src/middleware/inertia.middleware.ts
 let InertiaMiddleware = class InertiaMiddleware {
 	options;
@@ -440,11 +112,61 @@ let InertiaMiddleware = class InertiaMiddleware {
 		}
 	}
 };
-InertiaMiddleware = __decorate([
-	Transient(),
-	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
-	__decorateMetadata("design:paramtypes", [Object])
-], InertiaMiddleware);
+InertiaMiddleware = __decorate([Transient(), __decorateParam(0, inject(INERTIA_TOKENS.Options))], InertiaMiddleware);
+//#endregion
+//#region src/services/hreflang.service.ts
+let HreflangService = class HreflangService {
+	container;
+	constructor(container) {
+		this.container = container;
+	}
+	buildLinks(currentUrl) {
+		const i18n = this.container.tryResolve(I18N_TOKENS.Options);
+		if (!i18n) return [];
+		const locales = i18n.locales ?? ["en"];
+		if (locales.length < 2) return [];
+		const defaultLocale = i18n.defaultLocale ?? "en";
+		const trailingSlash = this.container.resolve(DI_TOKENS.Application).config.trailingSlash ?? "ignore";
+		const localeUrl = this.container.resolve(ROUTER_TOKENS.LocaleUrlService);
+		if (localeUrl.pathEnabled) return this.buildPathLinks(currentUrl, locales, defaultLocale, localeUrl, trailingSlash);
+		if ((i18n.detection && "strategy" in i18n.detection ? i18n.detection.strategy : void 0) === "querystring") return this.buildQuerystringLinks(currentUrl, locales, defaultLocale, trailingSlash);
+		return [];
+	}
+	buildPathLinks(url, locales, defaultLocale, localeUrl, trailingSlash) {
+		const basePath = localeUrl.stripPrefix(url.pathname);
+		const links = locales.map((locale) => this.linkTag(locale, this.compose(url, localeUrl.applyPrefix(basePath, locale), url.search, trailingSlash)));
+		links.push(this.linkTag("x-default", this.compose(url, localeUrl.applyPrefix(basePath, defaultLocale), url.search, trailingSlash)));
+		return links;
+	}
+	buildQuerystringLinks(url, locales, defaultLocale, trailingSlash) {
+		const params = new URLSearchParams(url.search);
+		params.delete("locale");
+		const baseQs = params.toString();
+		const links = locales.map((locale) => {
+			const qs = this.composeQuery(baseQs, locale === defaultLocale ? null : ["locale", locale]);
+			return this.linkTag(locale, this.compose(url, url.pathname, qs, trailingSlash));
+		});
+		const xDefaultQs = baseQs ? `?${baseQs}` : "";
+		links.push(this.linkTag("x-default", this.compose(url, url.pathname, xDefaultQs, trailingSlash)));
+		return links;
+	}
+	compose(url, pathname, search, mode) {
+		return applyTrailingSlash(url.origin + pathname + search, mode);
+	}
+	composeQuery(baseQs, extra) {
+		if (!extra) return baseQs ? `?${baseQs}` : "";
+		const tail = `${extra[0]}=${encodeURIComponent(extra[1])}`;
+		return baseQs ? `?${baseQs}&${tail}` : `?${tail}`;
+	}
+	linkTag(hreflang, href) {
+		return {
+			rel: "alternate",
+			hreflang,
+			href
+		};
+	}
+};
+HreflangService = __decorate([Singleton(), __decorateParam(0, inject(CONTAINER_TOKEN))], HreflangService);
 //#endregion
 //#region src/types.ts
 const INERTIA_PROP_OPTIONAL = Symbol.for("stratal:inertia:prop:optional");
@@ -458,15 +180,20 @@ let InertiaService = class InertiaService {
 	options;
 	template;
 	ssr;
+	seoService;
 	sharedData = {};
-	constructor(options, template, ssr) {
+	constructor(options, template, ssr, seoService) {
 		this.options = options;
 		this.template = template;
 		this.ssr = ssr;
+		this.seoService = seoService;
 	}
 	share(key, value) {
 		this.sharedData[key] = value;
 	}
+	seo(data) {
+		this.seoService.set(data);
+	}
 	location(url) {
 		return new Response("", {
 			status: 409,
@@ -513,12 +240,18 @@ let InertiaService = class InertiaService {
 		const url = reqUrl.search ? `${reqUrl.pathname}${reqUrl.search}` : reqUrl.pathname;
 		const isInertia = ctx.c.get("inertia");
 		const { shared: resolvedShared, sharedKeys } = await this.resolveSharedData(ctx);
+		const resolvedSeo = await this.seoService.resolve(ctx);
 		const allProps = {
 			...resolvedShared,
 			...this.sharedData,
+			seo: this.always(() => resolvedSeo),
 			...props
 		};
-		const allSharedKeys = [...sharedKeys, ...Object.keys(this.sharedData)];
+		const allSharedKeys = [
+			...sharedKeys,
+			...Object.keys(this.sharedData),
+			"seo"
+		];
 		const result = await this.processProps(allProps, ctx, component, isInertia);
 		const { errors: flashErrors, ...flash } = ctx.c.get("inertiaFlash") ?? {};
 		const errors = flashErrors && typeof flashErrors === "object" && !Array.isArray(flashErrors) ? flashErrors : {};
@@ -545,8 +278,9 @@ let InertiaService = class InertiaService {
 			...renderOptions.clearHistory ? { clearHistory: true } : {},
 			...renderOptions.preserveFragment ? { preserveFragment: true } : {}
 		};
+		const status = renderOptions.status ?? 200;
 		if (isInertia) return new Response(JSON.stringify(page), {
-			status: 200,
+			status,
 			headers: {
 				"Content-Type": "application/json",
 				"X-Inertia": "true",
@@ -557,9 +291,10 @@ let InertiaService = class InertiaService {
 			head: [],
 			body: ""
 		} : await this.ssr.render(page);
-		const html = this.template.render(page, ssrResult.head, ssrResult.body);
+		const seoTags = this.seoService.tagsFor(resolvedSeo);
+		const html = this.template.render(page, [...ssrResult.head, ...seoTags], ssrResult.body);
 		return new Response(html, {
-			status: 200,
+			status,
 			headers: { "Content-Type": "text/html; charset=utf-8" }
 		});
 	}
@@ -588,6 +323,7 @@ let InertiaService = class InertiaService {
 			const uri = container.resolve(ROUTER_TOKENS.Uri);
 			const name = registry.findNameByRoute(ctx.c.req.method, ctx.c.req.routePath) ?? null;
 			const params = { ...ctx.param() };
+			const localePathService = container.resolve(ROUTER_TOKENS.LocalePathService);
 			shared.routes = this.serializeRoutes(registry.named());
 			shared.trailingSlash = application.config.trailingSlash ?? "ignore";
 			shared.route = {
@@ -595,6 +331,10 @@ let InertiaService = class InertiaService {
 				params,
 				defaults: uri.getDefaults()
 			};
+			shared.localeConfig = {
+				defaultLocale: localePathService.localePathConfig?.defaultLocale ?? null,
+				prefixDefaultLocale: localePathService.prefixDefaultLocale
+			};
 		}
 		return {
 			shared,
@@ -619,6 +359,7 @@ let InertiaService = class InertiaService {
 		const partialDataHeader = ctx.header("x-inertia-partial-data");
 		const partialExceptHeader = ctx.header("x-inertia-partial-except");
 		const resetHeader = ctx.header("x-inertia-reset");
+		const shouldResolveDeferred = ctx.header("x-inertia-resolve-deferred") === "true";
 		const isPartialReload = isInertia && partialComponent === component && partialDataHeader;
 		const requestedProps = partialDataHeader?.split(",").map((s) => s.trim()) ?? [];
 		const exceptProps = partialExceptHeader?.split(",").map((s) => s.trim()) ?? [];
@@ -641,7 +382,8 @@ let InertiaService = class InertiaService {
 			}
 			if (this.isDeferredProp(value)) {
 				if (isPartialReload && this.isRequested(key, requestedProps)) resolvedProps[key] = await value.callback();
-				else if (!isPartialReload) {
+				else if (!isPartialReload) if (shouldResolveDeferred) resolvedProps[key] = await value.callback();
+				else {
 					deferredProps[value.group] ??= [];
 					deferredProps[value.group].push(key);
 				}
@@ -728,15 +470,11 @@ let InertiaService = class InertiaService {
 	}
 };
 InertiaService = __decorate([
-	Transient(INERTIA_TOKENS.InertiaService),
+	Request(INERTIA_TOKENS.InertiaService),
 	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
 	__decorateParam(1, inject(INERTIA_TOKENS.TemplateService)),
 	__decorateParam(2, inject(INERTIA_TOKENS.SsrRenderer)),
-	__decorateMetadata("design:paramtypes", [
-		Object,
-		Object,
-		Object
-	])
+	__decorateParam(3, inject(INERTIA_TOKENS.SeoService))
 ], InertiaService);
 //#endregion
 //#region src/services/manifest.service.ts
@@ -744,12 +482,11 @@ const DEFAULT_ENTRY_CLIENT_PATH = "src/inertia/app.tsx";
 let ManifestService = class ManifestService {
 	manifest;
 	entryClientPath;
+	isDev = Boolean(import.meta.env.DEV);
 	constructor(options) {
-		this.manifest = options.manifest ?? null;
+		this.manifest = globalThis.__STRATAL_INERTIA_MANIFEST__ ?? null;
 		this.entryClientPath = (options.entryClientPath ?? DEFAULT_ENTRY_CLIENT_PATH).replace(/^\/+/, "");
-	}
-	get isDev() {
-		return this.manifest === null;
+		if (!this.isDev && !this.manifest) throw new Error("@stratal/inertia: production build is missing the Vite client manifest. This is wired by stratalInertia() in vite.config.ts — confirm it is in your plugin list and that the client environment built successfully before the worker environment.");
 	}
 	getHeadTags() {
 		if (this.isDev) return "<link rel=\"stylesheet\" href=\"/__inertia/ssr-css\" data-ssr-css />";
@@ -779,11 +516,71 @@ hot.on("vite:afterUpdate", () => {
 		return tags.join("\n");
 	}
 };
-ManifestService = __decorate([
-	Transient(),
+ManifestService = __decorate([Transient(), __decorateParam(0, inject(INERTIA_TOKENS.Options))], ManifestService);
+//#endregion
+//#region src/services/seo.service.ts
+let SeoService = class SeoService {
+	options;
+	hreflang;
+	accumulated = {};
+	constructor(options, hreflang) {
+		this.options = options;
+		this.hreflang = hreflang;
+	}
+	/** Merges the given metadata into the request's accumulated SEO data. */
+	set(data) {
+		this.accumulated = mergeSeo(this.accumulated, data);
+	}
+	/**
+	* Resolves the final SEO data: module defaults (base) merged with the
+	* request's accumulated data, then the title template applied. Resolver
+	* functions for `defaults`/`titleTemplate` are awaited with the request `ctx`.
+	* Locale-aware `hreflang` alternates are appended last so they ride the same
+	* head injection and SPA reconciliation as the rest of the SEO tags.
+	*
+	* The resolved `title` is ALWAYS a string (falling back to `''`). This makes
+	* the `<title>` descriptor deterministic: every navigation — including to a
+	* page with no SEO — produces a title, so the client head-sync sets
+	* `document.title` rather than leaving the previous page's title stale.
+	*/
+	async resolve(ctx) {
+		const seo = this.options.seo;
+		const resolved = mergeSeo(typeof seo?.defaults === "function" ? await seo.defaults(ctx) : seo?.defaults ?? {}, this.accumulated);
+		const template = seo?.titleTemplate;
+		if (typeof template === "function") resolved.title = await template(resolved.title, ctx);
+		else if (typeof template === "string" && this.accumulated.title != null) resolved.title = template.split("%s").join(this.accumulated.title);
+		resolved.title ??= "";
+		const hreflang = this.hreflang.buildLinks(new URL(ctx.c.req.url));
+		if (hreflang.length > 0) resolved.link = [...resolved.link ?? [], ...hreflang];
+		return resolved;
+	}
+	/** Renders resolved SEO data into a list of head-tag HTML strings. */
+	tagsFor(resolved) {
+		return buildSeoTags(resolved).map(descriptorToHtml);
+	}
+};
+SeoService = __decorate([
+	Request(INERTIA_TOKENS.SeoService),
 	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
-	__decorateMetadata("design:paramtypes", [Object])
-], ManifestService);
+	__decorateParam(1, inject(INERTIA_TOKENS.HreflangService))
+], SeoService);
+/** Merges `b` over `a`: `openGraph`/`twitter` shallow-merge, `meta`/`link` concat, scalars overwrite. */
+function mergeSeo(a, b) {
+	return {
+		...a,
+		...b,
+		...a.openGraph || b.openGraph ? { openGraph: {
+			...a.openGraph,
+			...b.openGraph
+		} } : {},
+		...a.twitter || b.twitter ? { twitter: {
+			...a.twitter,
+			...b.twitter
+		} } : {},
+		...a.meta || b.meta ? { meta: [...a.meta ?? [], ...b.meta ?? []] } : {},
+		...a.link || b.link ? { link: [...a.link ?? [], ...b.link ?? []] } : {}
+	};
+}
 //#endregion
 //#region src/services/ssr-renderer.service.ts
 let SsrRendererService = class SsrRendererService {
@@ -827,10 +624,9 @@ let SsrRendererService = class SsrRendererService {
 	}
 };
 SsrRendererService = __decorate([
-	Transient(),
+	Singleton(),
 	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
-	__decorateParam(1, inject(LOGGER_TOKENS.LoggerService)),
-	__decorateMetadata("design:paramtypes", [Object, Object])
+	__decorateParam(1, inject(LOGGER_TOKENS.LoggerService))
 ], SsrRendererService);
 //#endregion
 //#region src/services/template.service.ts
@@ -847,10 +643,10 @@ let TemplateService = class TemplateService {
 		const viteHead = this.manifest.getHeadTags();
 		const viteScripts = this.manifest.getScriptTags();
 		let html = this.options.rootView;
-		html = html.replace("@inertiaHead", headTags);
-		html = html.replace("@inertia", appHtml);
-		html = html.replace("@viteHead", viteHead);
-		html = html.replace("@viteScripts", viteScripts);
+		html = html.replace("@inertiaHead", () => headTags);
+		html = html.replace("@inertia", () => appHtml);
+		html = html.replace("@viteHead", () => viteHead);
+		html = html.replace("@viteScripts", () => viteScripts);
 		return html;
 	}
 	buildClientOnlyBody(page) {
@@ -860,8 +656,7 @@ let TemplateService = class TemplateService {
 TemplateService = __decorate([
 	Transient(),
 	__decorateParam(0, inject(INERTIA_TOKENS.Options)),
-	__decorateParam(1, inject(INERTIA_TOKENS.ManifestService)),
-	__decorateMetadata("design:paramtypes", [Object, Object])
+	__decorateParam(1, inject(INERTIA_TOKENS.ManifestService))
 ], TemplateService);
 //#endregion
 //#region src/inertia.module.ts
@@ -894,7 +689,8 @@ let InertiaModule = _InertiaModule = class InertiaModule {
 			if (context.type !== "http") return void 0;
 			if (this.isPrecognitionRequest(context)) return this.handlePrecognitionValidationError(error, context);
 			if (!this.isInertiaRequest(context)) return void 0;
-			const issues = error.metadata?.issues ?? [];
+			if (this.isReadRequest(context)) return void 0;
+			const issues = error.issues ?? [];
 			const errors = {};
 			for (const issue of issues) errors[issue.path] = issue.message;
 			context.ctx.flash("errors", errors);
@@ -902,12 +698,23 @@ let InertiaModule = _InertiaModule = class InertiaModule {
 		});
 		handler.renderable(ApplicationError, (error, context) => {
 			if (context.type !== "http") return void 0;
-			const message = context.ctx.getContainer().resolve(I18N_TOKENS.I18nService).t(error.message, error.metadata);
+			const message = error.message;
 			if (this.isPrecognitionRequest(context)) return this.createPrecognitionErrorResponse({ _form: message });
 			if (!this.isInertiaRequest(context)) return void 0;
+			if (this.isReadRequest(context)) return void 0;
 			context.ctx.flash("errors", { _form: message });
 			return this.redirectBack(context);
 		});
+		handler.errorPage(async (errorResponse, status, context) => {
+			try {
+				return await context.ctx.getContainer().resolve(INERTIA_TOKENS.InertiaService).render(context.ctx, `Errors/${status}`, {
+					status,
+					message: errorResponse.message
+				}, { status });
+			} catch {
+				return;
+			}
+		});
 	}
 	onInitialize() {
 		augmentRouterContext((ctx) => {
@@ -917,11 +724,28 @@ let InertiaModule = _InertiaModule = class InertiaModule {
 	isInertiaRequest(context) {
 		return context.ctx.header("x-inertia") === "true";
 	}
+	/**
+	* GET/HEAD requests are idempotent navigations — including Inertia deferred
+	* partial reloads, which fetch deferred props over a follow-up XHR that still
+	* carries `X-Inertia: true`.
+	*
+	* Such requests must NOT use the flash-errors + redirect-back convention: the
+	* redirect points back at the very URL that just threw, so an error raised
+	* while resolving a deferred prop would redirect → re-request → throw again
+	* in an infinite loop (`ERR_TOO_MANY_REDIRECTS`). For these we fall through to
+	* the errorPage pipeline, which renders `Errors/${status}` in place as an
+	* Inertia response. Redirect-back stays for mutations (POST/PUT/PATCH/DELETE),
+	* where it drives the post-submit form-error flow.
+	*/
+	isReadRequest(context) {
+		const method = context.ctx.c.req.method.toUpperCase();
+		return method === "GET" || method === "HEAD";
+	}
 	isPrecognitionRequest(context) {
 		return context.ctx.header("precognition") === "true";
 	}
 	handlePrecognitionValidationError(error, context) {
-		const issues = error.metadata?.issues ?? [];
+		const issues = error.issues ?? [];
 		let errors = {};
 		for (const issue of issues) errors[issue.path] = issue.message;
 		const validateOnly = context.ctx.header("precognition-validate-only");
@@ -964,8 +788,7 @@ let InertiaModule = _InertiaModule = class InertiaModule {
 InertiaModule = _InertiaModule = __decorate([Module({ providers: [
 	{
 		provide: INERTIA_TOKENS.InertiaService,
-		useClass: InertiaService,
-		scope: Scope.Request
+		useClass: InertiaService
 	},
 	{
 		provide: INERTIA_TOKENS.TemplateService,
@@ -977,13 +800,16 @@ InertiaModule = _InertiaModule = __decorate([Module({ providers: [
 	},
 	{
 		provide: INERTIA_TOKENS.SsrRenderer,
-		useClass: SsrRendererService,
-		scope: Scope.Singleton
+		useClass: SsrRendererService
+	},
+	{
+		provide: INERTIA_TOKENS.HreflangService,
+		useClass: HreflangService
 	},
-	InertiaInstallCommand,
-	InertiaTypesCommand,
-	InertiaDevCommand,
-	InertiaBuildCommand
+	{
+		provide: INERTIA_TOKENS.SeoService,
+		useClass: SeoService
+	}
 ] })], InertiaModule);
 //#endregion
 //#region src/flash/cookie-flash-store.ts
@@ -1175,6 +1001,6 @@ let HandlePrecognitiveRequests = class HandlePrecognitiveRequests {
 };
 HandlePrecognitiveRequests = __decorate([Transient()], HandlePrecognitiveRequests);
 //#endregion
-export { CookieFlashStore, HandlePrecognitiveRequests, INERTIA_TOKENS, InertiaBuildCommand, InertiaDelete, InertiaDevCommand, InertiaGet, InertiaInstallCommand, InertiaMiddleware, InertiaModule, InertiaPatch, InertiaPost, InertiaPut, InertiaRoute, InertiaService, InertiaTypesCommand, ManifestService, SsrRendererService, TemplateService, runTypeGeneration };
+export { CookieFlashStore, DATA_SEO_ATTR, HandlePrecognitiveRequests, INERTIA_TOKENS, InertiaDelete, InertiaGet, InertiaMiddleware, InertiaModule, InertiaPatch, InertiaPost, InertiaPut, InertiaRoute, InertiaService, ManifestService, SeoService, SsrRendererService, TemplateService, buildSeoTags, descriptorToHtml };
 
 //# sourceMappingURL=index.mjs.map