npm - @voltro/cli - Versions diffs - 0.50.0 → 0.51.0 - Mend

@voltro/cli 0.50.0 → 0.51.0

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

Files changed (111) hide show

package/dist/{webDev-B4IEMB0n.js → webDev-B-ubQEMX.js} RENAMED Viewed

@@ -3,7 +3,7 @@ import { n as t } from "./loadEnv-D9nEOClM.js";
 import { t as n } from "./bootRefusal-pgvDxlrU.js";
 import { r } from "./appPort-B_HpJ_ck.js";
 import { A as i, _ as a, g as o, h as s, m as c, o as l } from "./fileConventions-Cof68_BL.js";
-import { A as u, D as d, a as f, h as p, j as m, k as h } from "./inspect-B7U7Cl_Z.js";
+import { A as u, D as d, a as f, h as p, j as m, k as h } from "./inspect-CtL_xTbu.js";
 import { n as g } from "./agentsMd-D6yD7IQv.js";
 import { c as _, p as v, t as y } from "./renderModeScan-D7J1B7Kw.js";
 import { t as b } from "./pageConvention-cEiRxdab.js";
@@ -16,7 +16,7 @@ import { addSink as R, createLogger as z, printReadyBlock as ne } from "@voltro/
 import { createRequire as B } from "node:module";
 import { currentTraceContext as V, resolveSecret as re } from "@voltro/runtime";
 import { homedir as H } from "node:os";
-import { FRAMEWORK_ENV_CATALOG as U, appEnvEntries as ie, checkEnvNaming as W, formatEnvErrors as ae, installEnvSnapshot as G, isEnvContract as oe, pluginEnvEntries as se, renderDotEnvExample as ce, resolveEnv as le } from "@voltro/env";
+import { FRAMEWORK_ENV_CATALOG as U, appEnvEntries as ie, checkEnvNaming as ae, formatEnvErrors as oe, installEnvSnapshot as W, isEnvContract as G, pluginEnvEntries as se, renderDotEnvExample as ce, resolveEnv as le } from "@voltro/env";
 import { __installPublicEnv as ue } from "@voltro/env/public";
 import { mkdir as de, writeFile as fe } from "node:fs/promises";
 import { createHash as pe } from "node:crypto";
@@ -66,12 +66,12 @@ __installPublicEnv(publicEnvValues)
 `;
 	await de(e, { recursive: !0 }), await fe(O(e, "env.public.ts"), n, "utf8");
 }, Ce = async (e) => {
-	let t = oe(e.rawEnv) ? e.rawEnv : void 0, n = await le({
+	let t = G(e.rawEnv) ? e.rawEnv : void 0, n = await le({
 		contract: t,
 		resolveSecret: re
-	}), r = [...n.errors, ...W(t, e.appType)];
-	if (r.length > 0) throw Error(ae(r));
-	G(n.values), e.appType === "web" && ue(n.publicValues);
+	}), r = [...n.errors, ...ae(t, e.appType)];
+	if (r.length > 0) throw Error(oe(r));
+	W(n.values), e.appType === "web" && ue(n.publicValues);
 	let i = t ? Object.keys(t.vars).length : 0;
 	if (i > 0) {
 		let r = Object.keys(n.publicValues).length;
@@ -582,7 +582,7 @@ __installPublicEnv(publicEnvValues)
 		if (!j(a)) continue;
 		let s;
 		try {
-			let { pages: e } = await Jr(a);
+			let { pages: e } = await Xr(a);
 			s = e.map((e) => ({
 				pattern: e.pattern,
 				params: at(e.pattern)
@@ -1442,15 +1442,18 @@ import {
 		tail: `${Qn}${r.slice(i + 21)}`,
 		bootstrapModules: n
 	};
-}, rr = (e, t) => (/<title>/i.test(t) ? e.replace(/[^\S\n]*<title>[\s\S]*?<\/title>\n?/i, "") : e).replace("</head>", `    ${t}\n  </head>`), ir = (e) => rr(e.head, e.headInjection).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${e.htmlLang}"`), ar = (e) => {
-	let { res: t, shell: n, htmlLang: r, headInjection: i } = e, a = null, o = !1, s = !1, c = () => {
+}, rr = (e, t) => (/<title>/i.test(t) ? e.replace(/[^\S\n]*<title>[\s\S]*?<\/title>\n?/i, "") : e).replace("</head>", `    ${t}\n  </head>`), ir = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), ar = (e, t) => {
+	let n = [t.timeZone === void 0 ? "" : ` data-voltro-tz="${ir(t.timeZone)}"`, t.renderedAt === void 0 ? "" : ` data-voltro-now="${t.renderedAt}"`].join("");
+	return e.replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${ir(t.lang)}"${n}`);
+}, or = (e) => ar(rr(e.head, e.headInjection), e.documentAttrs), sr = (e) => {
+	let { res: t, shell: n, documentAttrs: r, headInjection: i } = e, a = null, o = !1, s = !1, c = () => {
 		if (s || !o || a === null) return;
 		s = !0, t.statusCode = e.statusCode ?? 200;
 		for (let [n, r] of Object.entries(e.headers ?? {})) t.setHeader(n, r);
-		t.flushHeaders?.(), t.write(ir({
+		t.flushHeaders?.(), t.write(or({
 			head: n.head,
 			headInjection: i(a.meta),
-			htmlLang: r
+			documentAttrs: r
 		}));
 		let c = new he();
 		c.pipe(t, { end: !1 }), c.on("end", () => {
@@ -1477,16 +1480,16 @@ import {
 		return;
 	}
 	c();
-}, or = (e) => Array.isArray(e.preload) && e.preload.length > 0, sr = (e, t) => typeof e == "string" ? {
+}, cr = (e) => Array.isArray(e.preload) && e.preload.length > 0, lr = (e, t) => typeof e == "string" ? {
 	tag: e,
 	input: {}
 } : {
 	tag: e.tag,
 	input: e.input?.(t) ?? {}
-}, cr = async (e) => {
+}, ur = async (e) => {
 	let { pageMod: t, params: n, query: r, apiName: i, seed: a, seedFailure: o, onError: s } = e;
-	if (or(t) && r !== void 0 && i !== void 0) for (let e of t.preload) {
-		let { tag: t, input: c } = sr(e, n);
+	if (cr(t) && r !== void 0 && i !== void 0) for (let e of t.preload) {
+		let { tag: t, input: c } = lr(e, n);
 		try {
 			a(i, t, c, await r(t, c));
 		} catch (e) {
@@ -1496,12 +1499,12 @@ import {
 			}, e);
 		}
 	}
-}, lr = (e) => a.test(e) || e.endsWith(".workflow.server.tsx") ? !1 : o.test(e) || l.test(e) || i.test(e), ur = /* @__PURE__ */ new Set([
+}, dr = (e) => a.test(e) || e.endsWith(".workflow.server.tsx") ? !1 : o.test(e) || l.test(e) || i.test(e), fr = /* @__PURE__ */ new Set([
 	"node_modules",
 	"dist",
 	".framework",
 	".git"
-]), dr = async (e) => {
+]), pr = async (e) => {
 	let t = [], n = async (e) => {
 		let r;
 		try {
@@ -1511,15 +1514,15 @@ import {
 		}
 		for (let i of r) if (!(i.name.startsWith(".") && i.isDirectory())) {
 			if (i.isDirectory()) {
-				if (ur.has(i.name)) continue;
+				if (fr.has(i.name)) continue;
 				await n(O(e, i.name));
-			} else lr(i.name) && t.push(O(e, i.name));
+			} else dr(i.name) && t.push(O(e, i.name));
 		}
 	};
 	return await n(e), t.sort();
-}, fr = async (e) => {
+}, mr = async (e) => {
 	let t = pe("sha1");
-	for (let n of await dr(e)) {
+	for (let n of await pr(e)) {
 		t.update(n.slice(e.length)), t.update("\0");
 		try {
 			t.update(await M.readFile(n));
@@ -1530,28 +1533,28 @@ import {
 		t.update(await M.readFile(O(e, "rpcGroup.generated.ts")));
 	} catch {}
 	return t.digest("hex");
-}, pr = async (e) => {
+}, hr = async (e) => {
 	if (e.length === 0) return;
 	let t = [];
-	for (let n of [...e].sort()) t.push(await fr(n));
+	for (let n of [...e].sort()) t.push(await mr(n));
 	return pe("sha1").update(t.join("\0")).digest("hex");
-}, mr = (e) => typeof e == "object" && !!e && e._tag === "VoltroMiddleware" && typeof e.run == "function", hr = ["middleware.ts", "middleware.tsx"], gr = (e) => {
+}, gr = (e) => typeof e == "object" && !!e && e._tag === "VoltroMiddleware" && typeof e.run == "function", _r = ["middleware.ts", "middleware.tsx"], vr = (e) => {
 	let t = e.replace(/\/+$/, "");
 	return t === "" ? "/" : t;
 }, Z = (e, t) => {
-	let n = gr(e);
+	let n = vr(e);
 	if (n === "/") return !0;
-	let r = gr(t);
+	let r = vr(t);
 	return r === n || r.startsWith(`${n}/`);
-}, _r = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, vr = (e, t) => {
+}, yr = (e) => e === void 0 ? [] : typeof e == "string" ? [e] : e, br = (e, t) => {
 	if (e === void 0) return !0;
-	let n = _r(e.under), r = e.routes ?? [];
+	let n = yr(e.under), r = e.routes ?? [];
 	return n.length === 0 && r.length === 0 || r.includes(t) || n.some((e) => Z(e, t)) ? !(e.except ?? []).some((e) => e === t || Z(e, t)) : !1;
-}, yr = (e) => {
+}, xr = (e) => {
 	if (e?.assets !== !0) return [];
-	let t = _r(e.under);
+	let t = yr(e.under);
 	return t.length > 0 ? t : (e.routes ?? []).length > 0 ? [] : ["/"];
-}, br = (e, t) => yr(e).some((e) => Z(e, t)) ? !(e?.except ?? []).some((e) => Z(e, t)) : !1, xr = (e, t) => e.find(({ middleware: e }) => t.route === void 0 ? br(e.match, t.pathname) : vr(e.match, t.route))?.middleware, Sr = (e, t) => {
+}, Sr = (e, t) => xr(e).some((e) => Z(e, t)) ? !(e?.except ?? []).some((e) => Z(e, t)) : !1, Cr = (e, t) => e.find(({ middleware: e }) => t.route === void 0 ? Sr(e.match, t.pathname) : br(e.match, t.route))?.middleware, wr = (e, t) => {
 	let n = [];
 	for (let { exportName: r, middleware: i } of e) {
 		let e = i.match;
@@ -1559,13 +1562,13 @@ import {
 			kind: "dead-matcher",
 			message: `\`${r}\` matches routes: ['${i}'], which is not a route in this app. Route patterns are spelled as the router spells them, e.g. \`/notes/[id]\`.`
 		});
-		if (e?.assets !== !0) for (let [i, a] of [["under", _r(e?.under)], ["except", e?.except ?? []]]) for (let e of a) t.some((t) => Z(e, t)) || n.push({
+		if (e?.assets !== !0) for (let [i, a] of [["under", yr(e?.under)], ["except", e?.except ?? []]]) for (let e of a) t.some((t) => Z(e, t)) || n.push({
 			kind: "dead-matcher",
 			message: `\`${r}\` matches ${i}: ['${e}'], which covers no route in this app. ` + (i === "except" ? "An `except` that excludes nothing is a rule that reads as active and is not." : "Add `assets: true` if you meant a path the router does not serve.")
 		});
 	}
 	for (let r = 0; r < e.length; r += 1) for (let i = r + 1; i < e.length; i += 1) {
-		let a = e[r], o = e[i], s = t.find((e) => vr(a.middleware.match, e) && vr(o.middleware.match, e));
+		let a = e[r], o = e[i], s = t.find((e) => br(a.middleware.match, e) && br(o.middleware.match, e));
 		if (s !== void 0) {
 			n.push({
 				kind: "overlap",
@@ -1574,7 +1577,7 @@ import {
 			continue;
 		}
 		{
-			let e = yr(a.middleware.match), t = yr(o.middleware.match), r = e.some((e) => t.some((t) => Z(e, t) || Z(t, e))), i = (a.middleware.match?.except ?? []).some((e) => t.length > 0 && t.every((t) => Z(e, t))) || (o.middleware.match?.except ?? []).some((t) => e.length > 0 && e.every((e) => Z(t, e)));
+			let e = xr(a.middleware.match), t = xr(o.middleware.match), r = e.some((e) => t.some((t) => Z(e, t) || Z(t, e))), i = (a.middleware.match?.except ?? []).some((e) => t.length > 0 && t.every((t) => Z(e, t))) || (o.middleware.match?.except ?? []).some((t) => e.length > 0 && e.every((e) => Z(t, e)));
 			r && !i && n.push({
 				kind: "overlap",
 				message: `\`${a.exportName}\` and \`${o.exportName}\` both declare \`assets: true\` over overlapping paths. A non-page request would match both, and there is no route to tell them apart.`
@@ -1582,10 +1585,10 @@ import {
 		}
 	}
 	return n;
-}, Cr = (e, t) => {
-	let r = Sr(e, t);
+}, Tr = (e, t) => {
+	let r = wr(e, t);
 	if (r.length !== 0) throw n(`middleware.ts: ${r.length} problem(s)\n\n` + r.map((e) => `  • ${e.message}`).join("\n\n"));
-}, wr = (e) => {
+}, Er = (e) => {
 	let t = {};
 	if (!e) return t;
 	for (let n of e.split(";")) {
@@ -1599,11 +1602,11 @@ import {
 		}
 	}
 	return t;
-}, Tr = (e) => Object.entries(e).map(([e, t]) => `${e}=${encodeURIComponent(t)}`).join("; "), Er = /(^|[-_.])(auth[-_.]?token|session|access[-_.]?token)([-_.]|$)|^sb-.*-auth-token$/i, Dr = (e) => e.httpOnly === void 0 && Er.test(e.name), Or = (e) => {
+}, Dr = (e) => Object.entries(e).map(([e, t]) => `${e}=${encodeURIComponent(t)}`).join("; "), Or = /(^|[-_.])(auth[-_.]?token|session|access[-_.]?token)([-_.]|$)|^sb-.*-auth-token$/i, kr = (e) => e.httpOnly === void 0 && Or.test(e.name), Ar = (e) => {
 	let t = [`${e.name}=${encodeURIComponent(e.value)}`];
 	return t.push(`Path=${e.path ?? "/"}`), e.maxAge !== void 0 && t.push(`Max-Age=${Math.trunc(e.maxAge)}`), e.httpOnly !== !1 && t.push("HttpOnly"), e.secure === !0 && t.push("Secure"), t.push(`SameSite=${e.sameSite ?? "lax"}`), t.join("; ");
-}, kr = (e) => e.length === 0 ? {} : { "set-cookie": e.map(Or) }, Ar = async (e, t = (e) => import(L(e).href)) => {
-	for (let r of hr) {
+}, jr = (e) => e.length === 0 ? {} : { "set-cookie": e.map(Ar) }, Mr = async (e, t = (e) => import(L(e).href)) => {
+	for (let r of _r) {
 		let i;
 		try {
 			i = await t(O(e, r));
@@ -1612,7 +1615,7 @@ import {
 			if (t === "ERR_MODULE_NOT_FOUND" || t === "MODULE_NOT_FOUND") continue;
 			throw e;
 		}
-		let a = Object.entries(i ?? {}), o = a.filter((e) => mr(e[1])).map(([e, t]) => ({
+		let a = Object.entries(i ?? {}), o = a.filter((e) => gr(e[1])).map(([e, t]) => ({
 			exportName: e,
 			middleware: t
 		}));
@@ -1630,7 +1633,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		return o;
 	}
 	return [];
-}, jr = async (e, t, n) => {
+}, Nr = async (e, t, n) => {
 	let r = {
 		headers: t.headers,
 		cookies: t.cookies,
@@ -1640,7 +1643,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	let i = await e.run(t);
 	if (!i) return r;
 	let a = i.setCookies ?? [];
-	if (n !== void 0) for (let e of a) Dr(e) && n(e);
+	if (n !== void 0) for (let e of a) kr(e) && n(e);
 	let o = i.headers ? {
 		...t.headers,
 		...i.headers
@@ -1652,19 +1655,19 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	};
 	let s = { ...t.cookies };
 	for (let e of a) e.maxAge !== void 0 && e.maxAge <= 0 ? delete s[e.name] : s[e.name] = e.value;
-	return i.headers?.cookie === void 0 && (o.cookie = Tr(s)), {
+	return i.headers?.cookie === void 0 && (o.cookie = Dr(s)), {
 		headers: o,
 		cookies: s,
 		setCookies: a
 	};
-}, Q = z({ scope: "voltro:dev:web" }), Mr = z({ scope: "vite" }), Nr = await (async () => {
+}, Q = z({ scope: "voltro:dev:web" }), Pr = z({ scope: "vite" }), Fr = await (async () => {
 	try {
 		let e = O(D(te(import.meta.url)), "..", "package.json"), t = await M.readFile(e, "utf8");
 		return JSON.parse(t).version ?? "0.0.0";
 	} catch {
 		return "0.0.0";
 	}
-})(), Pr = async () => {
+})(), Ir = async () => {
 	try {
 		let e = D(te(import.meta.url)), t = A(e, "..", "..", "devtools");
 		if (j(O(t, "package.json"))) return t;
@@ -1673,7 +1676,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	} catch {
 		return null;
 	}
-}, Fr = (e, t) => e.disableDevtools || !t ? [] : [
+}, Lr = (e, t) => e.disableDevtools || !t ? [] : [
 	"",
 	"// Dev-only in-page devtools overlay. The `import.meta.env.DEV` guard is a",
 	"// compile-time constant, so prod builds strip this whole `if` block — the",
@@ -1683,12 +1686,12 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	"  await import('@voltro/devtools/styles.css')",
 	"  Devtools = (await import('@voltro/devtools')).VoltroDevtools",
 	"}"
-], Ir = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], Lr = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], Rr = (e) => e.sentry ? [
+], Rr = (e, t) => e.disableDevtools || !t ? [] : ["  ...(Devtools ? { Devtools } : {}),"], zr = (e) => e.sentry ? ["import { initSentryBrowser } from '@voltro/plugin-sentry/web'"] : [], Br = (e) => e.sentry ? [
 	"",
 	"// Browser-side Sentry (frontend half of the deep integration). Errors +",
 	"// browser rpc spans flow to Sentry, sharing the server transactions' trace.",
 	`await initSentryBrowser(${JSON.stringify(e.sentry)})`
-] : [], zr = (e) => e.env ? ["import './env.public'"] : [], Br = (e) => {
+] : [], Vr = (e) => e.env ? ["import './env.public'"] : [], Hr = (e) => {
 	let t = [], n = A(e);
 	for (;;) {
 		j(O(n, "pnpm-workspace.yaml")) && t.push(n);
@@ -1697,14 +1700,14 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		n = e;
 	}
 	return t;
-}, Vr = b, Hr = (e) => {
+}, Ur = b, Wr = (e) => {
 	if (/\/node_modules\/(?:\.pnpm\/[^/]+\/node_modules\/)?(?:react|react-dom|scheduler)\//.test(e)) return "react";
 	let t = /\/([^/]+)\.island\.tsx?$/.exec(e);
 	if (t) return `island-${t[1]}`;
-}, Ur = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, Wr = (e) => e.startsWith("(") && e.endsWith(")"), Gr = (e) => e.filter((e) => !Wr(e)), Kr = (e) => {
-	let t = e.replace(c, "").split("/").filter(Boolean).filter((e) => !Wr(e));
+}, Gr = /export\s+(?:async\s+)?(?:const|function|let|var)\s+loader\b/, Kr = (e) => e.startsWith("(") && e.endsWith(")"), qr = (e) => e.filter((e) => !Kr(e)), Jr = (e) => {
+	let t = e.replace(c, "").split("/").filter(Boolean).filter((e) => !Kr(e));
 	return t.length === 0 ? "/" : "/" + t.join("/");
-}, qr = (e) => `${e.replace(c, "").split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Index"}Page`, $ = (e, t) => e === "" ? `Root${t}` : `${e.split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Root"}${t}`, Jr = async (e) => {
+}, Yr = (e) => `${e.replace(c, "").split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Index"}Page`, $ = (e, t) => e === "" ? `Root${t}` : `${e.split("/").filter(Boolean).map((e) => e.replace(/[()]/g, "").replace(/\[\.\.\./g, "_rest_").replace(/[[\]]/g, "_")).map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("").replace(/[^A-Za-z0-9_]/g, "_") || "Root"}${t}`, Xr = async (e) => {
 	let t = [], n = [], r = async (e, i) => {
 		let a = [];
 		try {
@@ -1712,17 +1715,17 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		} catch {
 			return;
 		}
-		let o = a.filter((e) => e.isDirectory()).map((e) => e.name).sort(), l = a.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !Vr(e.name)).map((e) => e.name).sort(), u = new Set(l), d = i.join("/");
+		let o = a.filter((e) => e.isDirectory()).map((e) => e.name).sort(), l = a.filter((e) => e.isFile() && e.name.endsWith(".tsx") && !Ur(e.name)).map((e) => e.name).sort(), u = new Set(l), d = i.join("/");
 		if (l.some((e) => s.has(e))) {
 			let t = u.has("layout.tsx"), r = !1;
 			if (t) try {
 				let t = await M.readFile(O(e, "layout.tsx"), "utf8");
-				r = Ur.test(t);
+				r = Gr.test(t);
 			} catch {}
 			n.push({
 				dir: d,
 				chain: i,
-				contributesToUrl: i.length === 0 || !Wr(i[i.length - 1]),
+				contributesToUrl: i.length === 0 || !Kr(i[i.length - 1]),
 				hasLayout: t,
 				hasLayoutLoader: r,
 				hasError: u.has("error.tsx"),
@@ -1736,8 +1739,8 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			let n = d ? `${d}/${e}` : e;
 			t.push({
 				file: n,
-				pattern: Kr(n),
-				ident: qr(n),
+				pattern: Jr(n),
+				ident: Yr(n),
 				dirChain: i
 			});
 		}
@@ -1756,14 +1759,14 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		dirs: a,
 		orphanedSpecials: o
 	};
-}, Yr = (e, t) => {
+}, Zr = (e, t) => {
 	let n = [];
 	for (let r = 0; r <= t.length; r++) {
 		let i = t.slice(0, r).join("/"), a = e.find((e) => e.dir === i);
 		a && n.push(a);
 	}
 	return n;
-}, Xr = async (e) => {
+}, Qr = async (e) => {
 	let { entries: t, loadLayout: n, loadError: r, loadPending: i, ctx: a } = e, o = {};
 	return {
 		chain: await Promise.all(t.map(async (e, t) => {
@@ -1787,10 +1790,10 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		})),
 		segmentLoaderData: o
 	};
-}, Zr = (e) => {
-	let t = Gr(e);
+}, $r = (e) => {
+	let t = qr(e);
 	return t.length === 0 ? "" : "/" + t.join("/");
-}, Qr = [
+}, ei = [
 	"// Hot-reload bridge: keep SSR-injected <link rel=\"stylesheet\"> tags",
 	"// in sync with Vite's CSS HMR. Without this, edits to .css files",
 	"// only update the JS-injected <style> overlay; the underlying <link>",
@@ -1883,7 +1886,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	"    _vdtErrorStart('Build error')",
 	"  })",
 	"}"
-].join("\n"), $r = (e) => {
+].join("\n"), ti = (e) => {
 	let t = [], n = 0, r = e.split("/").filter(Boolean), i = [];
 	for (let e of r) e.startsWith("[[...") && e.endsWith("]]") ? (i.push("(.*)"), t.push(e.slice(5, -2)), n += 2) : e.startsWith("[...") && e.endsWith("]") ? (i.push("(.+)"), t.push(e.slice(4, -1)), n += 3) : e.startsWith("[") && e.endsWith("]") ? (i.push("([^/]+)"), t.push(e.slice(1, -1)), n += 1) : i.push(e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
 	let a = i.join("/");
@@ -1892,8 +1895,8 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		paramNames: t,
 		priority: n
 	};
-}, ei = (e) => e.map((e) => {
-	let { regex: t, paramNames: n, priority: r } = $r(e.pattern);
+}, ni = (e) => e.map((e) => {
+	let { regex: t, paramNames: n, priority: r } = ti(e.pattern);
 	return {
 		pattern: e.pattern,
 		file: e.file,
@@ -1902,7 +1905,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		paramNames: n,
 		priority: r
 	};
-}).slice().sort((e, t) => e.priority - t.priority), ti = (e, t) => {
+}).slice().sort((e, t) => e.priority - t.priority), ri = (e, t) => {
 	for (let n of t) {
 		let t = n.regex.exec(e);
 		if (!t) continue;
@@ -1914,7 +1917,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		};
 	}
 	return null;
-}, ni = J, ri = async (e) => {
+}, ii = J, ai = async (e) => {
 	try {
 		let t = await import(L(O(e, "app.config.ts")).href), n = t.default?.port, i = r({
 			kind: "api",
@@ -1930,7 +1933,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		kind: "api",
 		env: {}
 	}).port };
-}, ii = (e, t) => ({
+}, oi = (e, t) => ({
 	name: e,
 	pkg: t.package,
 	browserWsUrl: t.url,
@@ -1938,7 +1941,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	...t.serverUrl ? { serverOrigin: t.serverUrl } : {},
 	...t.headers ? { headers: t.headers } : {},
 	...t.authHeaders ? { hasAuthHeaders: !0 } : {}
-}), ai = (e, t, n) => {
+}), si = (e, t, n) => {
 	let r = t.transport?.wsPath ?? n.wsPath;
 	return {
 		name: e,
@@ -1950,7 +1953,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		...t.headers ? { headers: t.headers } : {},
 		...t.authHeaders ? { hasAuthHeaders: !0 } : {}
 	};
-}, oi = (e) => {
+}, ci = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		if (n.proxyTarget === void 0) continue;
@@ -1958,43 +1961,43 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		if (e) throw Error(`[voltro] api ${JSON.stringify(n.name)} and ${JSON.stringify(e)} both resolve the same-origin WS path ${JSON.stringify(n.browserWsUrl)}. A custom transport.wsPath must be unique per origin (one api per origin may use a fixed path). Give each a distinct wsPath, or drop the override to use the default /ws/<name>.`);
 		t.set(n.browserWsUrl, n.name);
 	}
-}, si = async (e, t) => {
+}, li = async (e, t) => {
 	let n = Object.entries(t.apis ?? {}), r = [];
 	for (let [t, i] of n) {
 		if (i.url) {
-			r.push(ii(t, i));
+			r.push(oi(t, i));
 			continue;
 		}
-		let n = await ni(e, i.package);
+		let n = await ii(e, i.package);
 		if (!n) throw Error(`[voltro dev] api ${JSON.stringify(t)} (package ${JSON.stringify(i.package)}) is not a workspace dep and has no \`url\` set in app.config.ts. External apis need an explicit \`url\` because the framework can't discover their dev port.`);
-		r.push(ai(t, i, await ri(n)));
+		r.push(si(t, i, await ai(n)));
 	}
-	return oi(r), r;
-}, ci = (e) => {
+	return ci(r), r;
+}, ui = (e) => {
 	if (!(!/^wss?:\/\//.test(e) && !/^https?:\/\//.test(e))) try {
 		let t = new URL(e);
 		return t.protocol = t.protocol === "wss:" || t.protocol === "https:" ? "https:" : "http:", `${t.protocol}//${t.host}`;
 	} catch {
 		return;
 	}
-}, li = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, ui = (e) => process.env[li(e)] ?? process.env.VOLTRO_API_ORIGIN, di = (e, t) => {
+}, di = (e) => `VOLTRO_API_ORIGIN_${e.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`, fi = (e) => process.env[di(e)] ?? process.env.VOLTRO_API_ORIGIN, pi = (e, t) => {
 	if (!e) return;
-	let n = ui(e.name) ?? e.serverOrigin;
+	let n = fi(e.name) ?? e.serverOrigin;
 	if (n) {
-		let e = ci(n);
+		let e = ui(n);
 		if (e) return e;
 	}
 	if (t?.allowDevProxy && e.proxyTarget) {
-		let t = ci(e.proxyTarget);
+		let t = ui(e.proxyTarget);
 		if (t) return t;
 	}
-	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return ci(e.browserWsUrl);
-}, fi = (e, t, n) => {
+	if (!e.proxyTarget && /^wss?:\/\//.test(e.browserWsUrl)) return ui(e.browserWsUrl);
+}, mi = (e, t, n) => {
 	if (!e) {
 		if (n?.apiName === void 0) return;
 		let e = n.apiName;
 		return async () => {
-			throw Error(`[loader.query] api '${e}' has no server-side origin for SSR. In a split web/api deployment the web pod reaches the api by internal DNS, not the browser's relative wsPath — set ${li(e)} (or VOLTRO_API_ORIGIN, or apis.${e}.serverUrl in app.config.ts) to the api's internal origin, e.g. http://api.<namespace>.svc.cluster.local. The browser transport is unaffected.`);
+			throw Error(`[loader.query] api '${e}' has no server-side origin for SSR. In a split web/api deployment the web pod reaches the api by internal DNS, not the browser's relative wsPath — set ${di(e)} (or VOLTRO_API_ORIGIN, or apis.${e}.serverUrl in app.config.ts) to the api's internal origin, e.g. http://api.<namespace>.svc.cluster.local. The browser transport is unaffected.`);
 		};
 	}
 	return async (r, i) => {
@@ -2017,7 +2020,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			});
 		} catch (t) {
 			let i = t?.cause?.code ?? String(t?.message ?? t);
-			throw Error(`[loader.query] ${r}: could not reach the api at ${e}/rpc (${i}). ${n?.apiName ? `Set ${li(n.apiName)} / VOLTRO_API_ORIGIN` : "Set the api server origin"} to the api's SSR-reachable origin (internal cluster DNS in a split deployment).`, { cause: t });
+			throw Error(`[loader.query] ${r}: could not reach the api at ${e}/rpc (${i}). ${n?.apiName ? `Set ${di(n.apiName)} / VOLTRO_API_ORIGIN` : "Set the api server origin"} to the api's SSR-reachable origin (internal cluster DNS in a split deployment).`, { cause: t });
 		}
 		if (!o.ok) throw Error(`[loader.query] ${r}: HTTP ${o.status} ${await o.text()}`);
 		let s = await o.json();
@@ -2047,8 +2050,8 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		}
 		if (u) return l;
 	};
-}, pi = async (e, t, n, r = {}) => {
-	let i = t.title ?? t.name ?? "app", a = t.theme === "dark" ? " class=\"dark\"" : t.theme === "light" ? " class=\"light\"" : "", o = j(O(e, "node_modules", "@voltro", "devtools", "package.json")) || await Pr() !== null, s = t.theme === "system" ? [
+}, hi = async (e, t, n, r = {}) => {
+	let i = t.title ?? t.name ?? "app", a = t.theme === "dark" ? " class=\"dark\"" : t.theme === "light" ? " class=\"light\"" : "", o = j(O(e, "node_modules", "@voltro", "devtools", "package.json")) || await Ir() !== null, s = t.theme === "system" ? [
 		"    <script>",
 		"      (function () {",
 		"        var root = document.documentElement",
@@ -2069,7 +2072,19 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		"        }",
 		"      })()",
 		"    <\/script>"
-	].join("\n") : "", c = [
+	].join("\n") : "", c = t.timeZone === "viewer" ? [
+		"    <script>",
+		"      (function () {",
+		"        try {",
+		"          if (/(?:^|;\\s*)voltro:tz=/.test(document.cookie)) return",
+		"          var tz = Intl.DateTimeFormat().resolvedOptions().timeZone",
+		"          if (!tz) return",
+		"          document.cookie = 'voltro:tz=' + encodeURIComponent(tz)",
+		"            + '; path=/; max-age=31536000; SameSite=Lax'",
+		"        } catch (e) {}",
+		"      })()",
+		"    <\/script>"
+	].join("\n") : "", l = [
 		"<!doctype html>",
 		"<!-- GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot. -->",
 		`<html lang="en"${a}>`,
@@ -2079,6 +2094,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		`    <title>${i}</title>`,
 		"    <link rel=\"icon\" type=\"image/svg+xml\" href=\"/favicon.svg\" />",
 		...s ? [s] : [],
+		...c ? [c] : [],
 		"  </head>",
 		"  <body>",
 		"    <div id=\"root\"></div>",
@@ -2086,35 +2102,35 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		"  </body>",
 		"</html>",
 		""
-	].join("\n"), l = O(e, "src", "pages"), { pages: u, dirs: d, orphanedSpecials: f } = await Jr(l);
-	await y(l, u);
-	for (let e of f) Q.warn(`src/pages/${e.dir || "."}/ contains ${e.files.join(", ")} but no page.tsx at or below it — ${e.files.length > 1 ? "those files are" : "that file is"} inert. A layout/error/loading/not-found file only applies to routes in its own directory tree; if this is an ordinary component, rename it so it does not read as a route boundary.`);
-	let p = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppGroup`, m = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppDescriptors`, h = n.map((e) => `import { appGroup as ${p(e.name)}, appDescriptors as ${m(e.name)} } from '${e.pkg}/rpcGroup'`);
-	n.some((e) => e.hasAuthHeaders) && (h.push("import __voltroAppConfig from '../app.config'"), h.push("const __voltroAuthHeaders = (__voltroAppConfig as { readonly apis?: Record<string, { readonly authHeaders?: () => Record<string, string> | Promise<Record<string, string>> }> }).apis"));
-	let g = n.map((e) => {
-		let t = [`group: ${p(e.name)}`];
-		return t.push(`descriptors: ${m(e.name)}`), t.push(`wsUrl: ${JSON.stringify(e.browserWsUrl)}`), e.hasAuthHeaders ? t.push(`headers: __voltroAuthHeaders?.[${JSON.stringify(e.name)}]?.authHeaders`) : e.headers && t.push(`headers: ${JSON.stringify(e.headers)}`), `    ${JSON.stringify(e.name)}: { ${t.join(", ")} },`;
-	}), _, v, b;
-	if (u.length > 0) {
-		let n = u.map((e) => `  ${JSON.stringify(e.pattern)}: () => import('../src/pages/${e.file}'),`), r = [];
-		for (let e of d) {
+	].join("\n"), u = O(e, "src", "pages"), { pages: d, dirs: f, orphanedSpecials: p } = await Xr(u);
+	await y(u, d);
+	for (let e of p) Q.warn(`src/pages/${e.dir || "."}/ contains ${e.files.join(", ")} but no page.tsx at or below it — ${e.files.length > 1 ? "those files are" : "that file is"} inert. A layout/error/loading/not-found file only applies to routes in its own directory tree; if this is an ordinary component, rename it so it does not read as a route boundary.`);
+	let m = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppGroup`, h = (e) => `${e.replace(/[^a-zA-Z0-9]/g, "_")}AppDescriptors`, g = n.map((e) => `import { appGroup as ${m(e.name)}, appDescriptors as ${h(e.name)} } from '${e.pkg}/rpcGroup'`);
+	n.some((e) => e.hasAuthHeaders) && (g.push("import __voltroAppConfig from '../app.config'"), g.push("const __voltroAuthHeaders = (__voltroAppConfig as { readonly apis?: Record<string, { readonly authHeaders?: () => Record<string, string> | Promise<Record<string, string>> }> }).apis"));
+	let _ = n.map((e) => {
+		let t = [`group: ${m(e.name)}`];
+		return t.push(`descriptors: ${h(e.name)}`), t.push(`wsUrl: ${JSON.stringify(e.browserWsUrl)}`), e.hasAuthHeaders ? t.push(`headers: __voltroAuthHeaders?.[${JSON.stringify(e.name)}]?.authHeaders`) : e.headers && t.push(`headers: ${JSON.stringify(e.headers)}`), `    ${JSON.stringify(e.name)}: { ${t.join(", ")} },`;
+	}), v, b, x;
+	if (d.length > 0) {
+		let n = d.map((e) => `  ${JSON.stringify(e.pattern)}: () => import('../src/pages/${e.file}'),`), r = [];
+		for (let e of f) {
 			let t = e.dir === "" ? "../src/pages" : `../src/pages/${e.dir}`;
 			e.hasLayout && e.hasLayoutLoader ? r.push(`import * as ${$(e.dir, "Layout")}Mod from '${t}/layout.tsx'`) : e.hasLayout && r.push(`import ${$(e.dir, "Layout")}   from '${t}/layout.tsx'`), e.hasError && r.push(`import ${$(e.dir, "Error")}    from '${t}/error.tsx'`), e.hasPending && r.push(`import ${$(e.dir, "Pending")}  from '${t}/loading.tsx'`), e.hasNotFound && r.push(`import ${$(e.dir, "NotFound")} from '${t}/not-found.tsx'`);
 		}
-		let i = u.map((e) => {
-			let t = Yr(d, e.dirChain).map((e) => {
+		let i = d.map((e) => {
+			let t = Zr(f, e.dirChain).map((e) => {
 				let t = [`id: ${JSON.stringify(e.dir || "/")}`], n = JSON.stringify(e.dir);
 				return e.hasLayout && t.push(`Layout:  refs.layouts[${n}]`), e.hasLayoutLoader && t.push(`loader:  refs.layoutLoaders[${n}]`), e.hasError && t.push(`Error:   refs.errors[${n}]`), e.hasPending && t.push(`Pending: refs.pendings[${n}]`), `      { ${t.join(", ")} }`;
 			}).join(",\n");
 			return `    makePageRoute(${JSON.stringify(e.pattern)}, ${t.length > 0 ? `[\n${t},\n    ]` : "undefined"}),`;
-		}), a = d.filter((e) => e.hasNotFound).map((e) => {
-			let t = Zr(e.chain), n = Yr(d, e.chain).map((e) => {
+		}), a = f.filter((e) => e.hasNotFound).map((e) => {
+			let t = $r(e.chain), n = Zr(f, e.chain).map((e) => {
 				let t = [`id: ${JSON.stringify(e.dir || "/")}`], n = JSON.stringify(e.dir);
 				return e.hasLayout && t.push(`Layout: refs.layouts[${n}]`), e.hasError && t.push(`Error:  refs.errors[${n}]`), `        { ${t.join(", ")} }`;
 			}).join(",\n"), r = n.length > 0 ? `\n      chain: [\n${n},\n      ],` : "";
 			return `    {\n      prefix: ${JSON.stringify(t)},\n      Component: refs.notFounds[${JSON.stringify(e.dir)}],${r}\n    },`;
-		}), s = [], c = [], l = [], f = [], p = [], m = [];
-		for (let e of d) {
+		}), s = [], c = [], l = [], u = [], p = [], m = [];
+		for (let e of f) {
 			let t = e.dir === "" ? "../src/pages/layout.tsx" : `../src/pages/${e.dir}/layout.tsx`, n = e.dir === "" ? "../src/pages/error.tsx" : `../src/pages/${e.dir}/error.tsx`, r = e.dir === "" ? "../src/pages/loading.tsx" : `../src/pages/${e.dir}/loading.tsx`, i = e.dir === "" ? "../src/pages/not-found.tsx" : `../src/pages/${e.dir}/not-found.tsx`, a = JSON.stringify(e.dir);
 			e.hasLayout && e.hasLayoutLoader ? (c.push(`  ${a}: ${$(e.dir, "Layout")}Mod.default,`), l.push(`  ${a}: ${$(e.dir, "Layout")}Mod.loader,`), s.push({
 				relPath: t,
@@ -2124,7 +2140,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				relPath: t,
 				kind: "layout",
 				slotKey: e.dir
-			})), e.hasError && (f.push(`  ${a}: ${$(e.dir, "Error")},`), s.push({
+			})), e.hasError && (u.push(`  ${a}: ${$(e.dir, "Error")},`), s.push({
 				relPath: n,
 				kind: "error",
 				slotKey: e.dir
@@ -2138,12 +2154,12 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				slotKey: e.dir
 			}));
 		}
-		for (let e of u) s.push({
+		for (let e of d) s.push({
 			relPath: `../src/pages/${e.file}`,
 			kind: "page",
 			slotKey: e.pattern
 		});
-		let y = s.map((e) => `      ${JSON.stringify(e.relPath)},`), x = s.map((e, t) => {
+		let h = s.map((e) => `      ${JSON.stringify(e.relPath)},`), y = s.map((e, t) => {
 			let n = JSON.stringify(e.slotKey);
 			return e.kind === "page" ? `      if (newMods[${t}] && refs.pages[${n}] !== undefined) { refs.pages[${n}] = newMods[${t}]; changed = true }` : `      if (newMods[${t}]?.default) { refs.${e.kind === "layout" ? "layouts" : e.kind === "error" ? "errors" : e.kind === "pending" ? "pendings" : "notFounds"}[${n}] = newMods[${t}].default;${e.kind === "layout" ? ` refs.layoutLoaders[${n}] = newMods[${t}].loader;` : ""} changed = true }`;
 		}), S = t.locales ?? [], C = S.length > 0 && S.every((t) => j(O(e, "src", "locales", `${t}.ts`)) || j(O(e, "src", "locales", `${t}.tsx`))), w = C, T = t.defaultLocale ?? S[0] ?? "en";
@@ -2154,7 +2170,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			"import { useServerRequest } from '@voltro/web'",
 			...S.map((e) => `import i18nCatalog_${e} from '../src/locales/${e}'`)
 		] : [];
-		v = [
+		b = [
 			"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 			"// Routes + per-page chain + not-found scopes assembled from src/pages/.",
 			"//",
@@ -2194,7 +2210,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			...l,
 			"  },",
 			"  errors: {",
-			...f,
+			...u,
 			"  },",
 			"  pendings: {",
 			...p,
@@ -2265,17 +2281,17 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			"if (import.meta.hot) {",
 			"  import.meta.hot.accept(",
 			"    [",
-			...y,
+			...h,
 			"    ],",
 			"    (newMods: Array<Record<string, unknown> | undefined>) => {",
 			"      let changed = false",
-			...x,
+			...y,
 			"      if (changed) bump()",
 			"    },",
 			"  )",
 			"}",
 			""
-		].join("\n"), _ = [
+		].join("\n"), v = [
 			"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 			"// The app's root component. It exports `App` and NOTHING ELSE: react-refresh",
 			"// only accepts a module whose every export is a component, and a module it",
@@ -2297,6 +2313,29 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				`const I18N_SUPPORTED: ReadonlyArray<string> = [${S.map((e) => JSON.stringify(e)).join(", ")}]`,
 				`const I18N_DEFAULT = ${JSON.stringify(T)}`,
 				"",
+				"// The zone + clock the SERVER decided for this document, read back off",
+				"// <html>. Same contract as <html lang> below and for the same reason:",
+				"// the browser could answer both of these itself, its answer would",
+				"// differ from the server's, and a difference is a hydration mismatch.",
+				"//",
+				"// Reading the ATTRIBUTE rather than the browser is the whole point.",
+				"// 'Intl.DateTimeFormat().resolvedOptions().timeZone' is the viewer's",
+				"// TRUE zone and is therefore the wrong value here — the server could",
+				"// not know it, so it did not render with it. The app makes the server",
+				"// know it by writing the 'voltro:tz' cookie (the pre-paint script",
+				"// seeds it from the browser; a login overwrites it with the user's",
+				"// own), and then the server's answer IS the viewer's zone.",
+				"const readPublishedDocumentAttrs = (): { timeZone?: string; renderedAt?: number } => {",
+				"  if (typeof document === 'undefined') return {}",
+				"  const el = document.documentElement",
+				"  const tz = el.getAttribute('data-voltro-tz')",
+				"  const now = Number(el.getAttribute('data-voltro-now'))",
+				"  return {",
+				"    ...(tz ? { timeZone: tz } : {}),",
+				"    ...(Number.isFinite(now) && now > 0 ? { renderedAt: now } : {}),",
+				"  }",
+				"}",
+				"",
 				"const pickI18nLocale = (ssr: ReturnType<typeof useServerRequest>): string => {",
 				"  if (ssr) {",
 				"    return resolveLocale({",
@@ -2350,28 +2389,37 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				"  const ssr = useServerRequest()",
 				"  const locale = pickI18nLocale(ssr)",
 				"  const messages = I18N_CATALOGS[locale] ?? I18N_CATALOGS[I18N_DEFAULT]!",
+				"  // Read once per mount, not per render: the values are fixed for the",
+				"  // life of the document, and 'renderedAt' moving would defeat the",
+				"  // point of pinning it.",
+				"  const published = useMemo(readPublishedDocumentAttrs, [])",
 				"  return (",
-				"    <I18nProvider locale={locale} messages={messages} defaultLocale={I18N_DEFAULT}>",
+				"    <I18nProvider",
+				"      locale={locale}",
+				"      messages={messages}",
+				"      defaultLocale={I18N_DEFAULT}",
+				"      {...published}",
+				"    >",
 				"      <Router routes={routes} notFounds={notFounds} />",
 				"    </I18nProvider>",
 				"  )"
 			] : ["  return <Router routes={routes} notFounds={notFounds} />"],
 			"}",
 			""
-		].join("\n"), b = [
+		].join("\n"), x = [
 			"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 			"// Entry: imports the generated App component and calls mount() with the",
 			"// resolved apis map. Side-effect only — no local component definitions —",
 			"// so downstream invalidations (user page edits) terminate at app.tsx.",
 			"",
-			...zr(t),
+			...Vr(t),
 			"import { mount } from '@voltro/web'",
-			...h,
+			...g,
 			"import { App } from './app'",
 			"import { preloadCurrentRoute } from './routeTable'",
-			...Lr(t),
-			...Fr(t, o),
-			...Rr(t),
+			...zr(t),
+			...Lr(t, o),
+			...Br(t),
 			"",
 			"// Preload the current route's page chunk BEFORE hydration so the first",
 			"// client render matches the SSG/SSR-prerendered HTML. Without it, a lazy",
@@ -2386,52 +2434,52 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			"",
 			"mount(App, {",
 			"  apis: {",
-			...g,
+			..._,
 			"  },",
-			...Ir(t, o),
+			...Rr(t, o),
 			"})",
 			"",
-			Qr
+			ei
 		].join("\n");
-	} else _ = "", v = "", b = [
+	} else v = "", b = "", x = [
 		"// GENERATED BY `voltro dev` — do not edit; will be overwritten on next boot.",
 		"// The user's root component lives at ../src/App.tsx; this file imports it",
 		"// and calls mount(). Side-effect only, no component definitions, so the",
 		"// user's component file remains the Fast Refresh boundary.",
 		"",
-		...zr(t),
+		...Vr(t),
 		"import { mount } from '@voltro/web'",
-		...h,
+		...g,
 		"import App from '../src/App'",
-		...Lr(t),
-		...Fr(t, o),
-		...Rr(t),
+		...zr(t),
+		...Lr(t, o),
+		...Br(t),
 		"",
 		"mount(App, {",
 		"  apis: {",
-		...g,
+		..._,
 		"  },",
-		...Ir(t, o),
+		...Rr(t, o),
 		"})",
 		"",
-		Qr
+		ei
 	].join("\n");
-	let x = O(e, ".framework");
-	await M.mkdir(x, { recursive: !0 }), t.env ? await Se(x, r) : await M.rm(O(x, "env.public.ts"), { force: !0 }), await M.writeFile(O(x, "index.html"), c, "utf8"), await M.writeFile(O(x, "main.tsx"), b, "utf8"), _ ? (await M.writeFile(O(x, "app.tsx"), _, "utf8"), await M.writeFile(O(x, "routeTable.ts"), v, "utf8")) : (await M.rm(O(x, "app.tsx"), { force: !0 }), await M.rm(O(x, "routeTable.ts"), { force: !0 }));
-	let S = O(e, ".gitignore"), C = "";
+	let S = O(e, ".framework");
+	await M.mkdir(S, { recursive: !0 }), t.env ? await Se(S, r) : await M.rm(O(S, "env.public.ts"), { force: !0 }), await M.writeFile(O(S, "index.html"), l, "utf8"), await M.writeFile(O(S, "main.tsx"), x, "utf8"), v ? (await M.writeFile(O(S, "app.tsx"), v, "utf8"), await M.writeFile(O(S, "routeTable.ts"), b, "utf8")) : (await M.rm(O(S, "app.tsx"), { force: !0 }), await M.rm(O(S, "routeTable.ts"), { force: !0 }));
+	let C = O(e, ".gitignore"), w = "";
 	try {
-		C = await M.readFile(S, "utf8");
+		w = await M.readFile(C, "utf8");
 	} catch {}
-	let w = ["/.framework/"], T = new Set(C.split("\n").map((e) => e.trim())), E = w.filter((e) => !T.has(e));
-	if (E.length > 0) {
-		let e = C === "" || C.endsWith("\n") ? "" : "\n";
+	let T = ["/.framework/"], E = new Set(w.split("\n").map((e) => e.trim())), D = T.filter((e) => !E.has(e));
+	if (D.length > 0) {
+		let e = w === "" || w.endsWith("\n") ? "" : "\n";
 		try {
-			await M.appendFile(S, `${e}${E.join("\n")}\n`, "utf8");
+			await M.appendFile(C, `${e}${D.join("\n")}\n`, "utf8");
 		} catch (e) {
-			Q.warn(`could not add ${E.join(", ")} to ${S} — add it by hand so the generated directory stays out of git. The build is unaffected.`, { reason: e?.message ?? String(e) });
+			Q.warn(`could not add ${D.join(", ")} to ${C} — add it by hand so the generated directory stays out of git. The build is unaffected.`, { reason: e?.message ?? String(e) });
 		}
 	}
-}, mi = async (e, t) => {
+}, gi = async (e, t) => {
 	try {
 		let n = D(e), r = O(n, "project.json");
 		if (!j(r)) return;
@@ -2444,16 +2492,16 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			projectJson: r
 		});
 	} catch {}
-}, hi = (e) => O(e, ".framework", "dist", "server", "appConfig.js"), gi = async (e, t = {}) => {
-	let n = hi(e), r = t.preferSource !== !0 && j(n) ? n : O(e, "app.config.ts");
+}, _i = (e) => O(e, ".framework", "dist", "server", "appConfig.js"), vi = async (e, t = {}) => {
+	let n = _i(e), r = t.preferSource !== !0 && j(n) ? n : O(e, "app.config.ts");
 	try {
 		let e = (await import(L(r).href)).default;
 		return typeof e == "object" && e && "type" in e && e.type === "web" ? e : null;
 	} catch {
 		return null;
 	}
-}, _i = async (e) => {
-	let n = await gi(e, { preferSource: !0 });
+}, yi = async (e) => {
+	let n = await vi(e, { preferSource: !0 });
 	if (!n) return {
 		ran: !1,
 		exitCode: 0
@@ -2461,7 +2509,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	ln();
 	let i = St();
 	Bt(i), Q.info("booting voltro dev (web)", { app: n.name ?? "(unnamed)" }), We(e, Q);
-	let a = await si(e, n);
+	let a = await li(e, n);
 	for (let e of a) Q.info("api wired", {
 		name: e.name,
 		pkg: e.pkg,
@@ -2480,7 +2528,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		log: Q,
 		generateTypes: !0
 	}), s = o.publicValues;
-	await pi(e, n, a, s), Q.debug("generated framework entry files", { files: [
+	await hi(e, n, a, s), Q.debug("generated framework entry files", { files: [
 		"index.html",
 		".framework/main.tsx",
 		...n.env ? [".framework/env.public.ts"] : []
@@ -2501,10 +2549,10 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		pid: process.pid,
 		status: "booting",
 		logFile: D.path
-	}).catch(() => {}), await mi(e, l);
-	let { pages: N, dirs: P } = await Jr(O(e, "src", "pages")), F = {
+	}).catch(() => {}), await gi(e, l);
+	let { pages: N, dirs: P } = await Xr(O(e, "src", "pages")), F = {
 		dirs: P,
-		ssrRoutes: ei(N)
+		ssrRoutes: ni(N)
 	}, ee = P.map((e) => ({
 		dir: e.dir,
 		hasLayout: e.hasLayout,
@@ -2536,31 +2584,31 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			}
 			for (let n of await De(e)) t.watcher.add(n.dir);
 		}
-	}, H = O(e, "src", "pages"), U = (e) => e.endsWith(".tsx") && (e === H || e.startsWith(H + "/")), ie = (e) => e === H || e.startsWith(H + "/"), W = async (t) => {
+	}, H = O(e, "src", "pages"), U = (e) => e.endsWith(".tsx") && (e === H || e.startsWith(H + "/")), ie = (e) => e === H || e.startsWith(H + "/"), ae = async (t) => {
 		try {
 			let r = Date.now();
-			await pi(e, n, a, s);
-			let { pages: i, dirs: o } = await Jr(H);
+			await hi(e, n, a, s);
+			let { pages: i, dirs: o } = await Xr(H);
 			await mt({
 				appRoot: e,
 				pages: i
-			}), F.dirs = o, F.ssrRoutes = ei(i), Q.info("page tree regenerated", {
+			}), F.dirs = o, F.ssrRoutes = ni(i), Q.info("page tree regenerated", {
 				reason: t,
 				ms: Date.now() - r,
 				routes: F.ssrRoutes.length
 			});
-			for (let e of Sr(X, F.ssrRoutes.map((e) => e.pattern))) Q.error(`middleware.ts: ${e.message}`);
+			for (let e of wr(X, F.ssrRoutes.map((e) => e.pattern))) Q.error(`middleware.ts: ${e.message}`);
 		} catch (e) {
 			Q.error("page tree regen failed", { reason: t }, e);
 		}
-	}, ae = {
+	}, oe = {
 		name: "framework:regenerate-on-page-tree-change",
 		configureServer(t) {
 			let n = null, r = [], i = (e) => {
 				r.push(e), n && clearTimeout(n), n = setTimeout(() => {
 					n = null;
 					let e = r.length === 1 ? r[0] : `${r.length} events (${r[0]}, …)`;
-					r.length = 0, W(e);
+					r.length = 0, ae(e);
 				}, 50);
 			};
 			t.watcher.on("add", (t) => {
@@ -2573,14 +2621,14 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				ie(t) && i(`unlinkDir ${k(e, t)}`);
 			});
 		}
-	}, G = O(e, "app.config.ts"), se = (e) => {
-		if (!oe(e.env)) return "";
+	}, W = O(e, "app.config.ts"), se = (e) => {
+		if (!G(e.env)) return "";
 		let t = Object.entries(e.env.vars).map(([e, t]) => `${e}:${t.access}`).sort();
 		return `${String(e.env.publicPrefix)}|${t.join(",")}`;
 	}, ce = (e, t) => {
 		let n = [];
 		return e.port !== t.port && n.push(`port ${e.port ?? "(default)"} → ${t.port ?? "(default)"}`), JSON.stringify(e.proxies) !== JSON.stringify(t.proxies) && n.push("proxies"), JSON.stringify(e.allowedHosts) !== JSON.stringify(t.allowedHosts) && n.push("allowedHosts"), JSON.stringify(e.apis) !== JSON.stringify(t.apis) && n.push("apis"), se(e) !== se(t) && n.push("env"), n;
-	}, le = n, ue = A(G), de = () => {
+	}, le = n, ue = A(W), de = () => {
 		let e = me(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
 			stdio: "inherit",
 			env: process.env,
@@ -2596,8 +2644,8 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	}, fe = {
 		name: "framework:watch-app-config",
 		async configureServer(n) {
-			n.watcher.add(G), Q.info("watching app.config.ts for changes", { path: k(e, G) });
-			let r = hr.map((t) => O(e, t)), i = new Set(r.map((e) => A(e)));
+			n.watcher.add(W), Q.info("watching app.config.ts for changes", { path: k(e, W) });
+			let r = _r.map((t) => O(e, t)), i = new Set(r.map((e) => A(e)));
 			for (let e of r) n.watcher.add(e);
 			n.watcher.on("all", (t, r) => {
 				i.has(A(r)) && (Q.warn("middleware.ts changed — restarting (it is loaded once per boot)", { path: k(e, r) }), n.close().catch(() => void 0).then(() => {
@@ -2607,10 +2655,10 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			let a = async () => {
 				try {
 					try {
-						let e = n.moduleGraph.getModuleById(G);
+						let e = n.moduleGraph.getModuleById(W);
 						e && n.moduleGraph.invalidateModule(e);
 					} catch {}
-					let e = (await n.ssrLoadModule(G, { fixStacktrace: !0 })).default;
+					let e = (await n.ssrLoadModule(W, { fixStacktrace: !0 })).default;
 					return typeof e == "object" && e && "type" in e && e.type === "web" ? e : (Q.warn("app.config.ts re-load returned wrong shape", { hasDefault: e !== void 0 }), null);
 				} catch (e) {
 					return Q.warn("app.config.ts re-load failed — ignoring this change", {}, e), null;
@@ -2644,7 +2692,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				}
 				try {
 					let r = Date.now();
-					await pi(e, t, await si(e, t)), le = t, n.ws && n.ws.send({
+					await hi(e, t, await li(e, t)), le = t, n.ws && n.ws.send({
 						type: "full-reload",
 						path: "*"
 					}), Q.info("app.config.ts soft-regen", {
@@ -2654,7 +2702,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				} catch (e) {
 					Q.error("app.config.ts soft-regen failed", {}, e);
 				}
-			}, l = (e) => E(e) === "app.config.ts" ? e === G || A(e) === ue : !1;
+			}, l = (e) => E(e) === "app.config.ts" ? e === W || A(e) === ue : !1;
 			n.watcher.on("change", (e) => {
 				l(e) && (Q.info("app.config.ts change event (chokidar)", { file: e }), s());
 			}), n.watcher.on("add", (e) => {
@@ -2662,7 +2710,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			});
 			try {
 				let { watchFile: e } = await import("node:fs");
-				e(G, { interval: 500 }, (e, t) => {
+				e(W, { interval: 500 }, (e, t) => {
 					e.mtimeMs !== t.mtimeMs && (Q.info("app.config.ts change event (poll)", { mtime: e.mtimeMs }), s());
 				}), Q.info("app.config.ts polling watcher attached", { intervalMs: 500 });
 			} catch (e) {
@@ -2683,21 +2731,21 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		async configureServer(t) {
 			let n = [];
 			for (let r of a) {
-				let i = await ni(e, r.pkg);
+				let i = await ii(e, r.pkg);
 				if (i) {
 					n.push(i);
 					try {
 						t.watcher.add(O(i, "rpcGroup.generated.ts"));
 					} catch {}
-					for (let e of await dr(i)) try {
+					for (let e of await pr(i)) try {
 						t.watcher.add(e);
 					} catch {}
 				}
 			}
 			if (n.length === 0) return;
-			let r = await pr(n), i = null, o = !1, s = async () => {
+			let r = await hr(n), i = null, o = !1, s = async () => {
 				if (o) return;
-				let e = await pr(n);
+				let e = await hr(n);
 				if (e !== void 0 && e !== r) {
 					r = e, o = !0, Q.info("the api surface changed — re-bundling the api client + reloading (descriptor edits propagate automatically; no manual restart needed)");
 					try {
@@ -2711,7 +2759,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				}
 			}, c = (e) => {
 				let t = A(e);
-				!lr(t) && !t.endsWith("rpcGroup.generated.ts") || (i && clearTimeout(i), i = setTimeout(() => {
+				!dr(t) && !t.endsWith("rpcGroup.generated.ts") || (i && clearTimeout(i), i = setTimeout(() => {
 					s();
 				}, 120));
 			};
@@ -2963,7 +3011,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 						kind: "web",
 						meta: {
 							name: n.name ?? "(unnamed)",
-							voltroVersion: Nr,
+							voltroVersion: Fr,
 							port: l,
 							mode: "dev",
 							apis: Object.entries(n.apis ?? {}).map(([e, t]) => {
@@ -2981,7 +3029,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 							size: 0,
 							entries: []
 						}),
-						env: () => Te(n.name ?? "app", { contract: oe(n.env) ? n.env : void 0 })
+						env: () => Te(n.name ?? "app", { contract: G(n.env) ? n.env : void 0 })
 					}, c = p(o, i, s, { method: e.method ?? "GET" });
 					if (c === null) return r();
 					t.statusCode = c.status, t.setHeader("content-type", c.contentType);
@@ -3039,29 +3087,36 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				if (i !== void 0) return i;
 				let t = n.locales ?? [], a = n.defaultLocale ?? t[0] ?? "en";
 				return t.length === 0 ? (i = Promise.resolve(() => void 0), i) : (i = (async () => {
-					let [{ makeSsgWrap: n }, { makeSsrI18nResolver: i }] = await Promise.all([r("@voltro/i18n"), r("@voltro/i18n/server")]), s = {};
-					for (let i of t) if (j(O(e, "src", "locales", `${i}.ts`))) try {
-						let t = (await r(O(e, "src", "locales", `${i}.ts`))).default;
-						t !== void 0 && (s[i] = n(i, t, a));
+					let [{ makeSsgWrap: i }, { makeSsrI18nResolver: s }] = await Promise.all([r("@voltro/i18n"), r("@voltro/i18n/server")]), c = {};
+					for (let n of t) if (j(O(e, "src", "locales", `${n}.ts`))) try {
+						let t = (await r(O(e, "src", "locales", `${n}.ts`))).default;
+						t !== void 0 && (c[n] = i(n, t, a));
 					} catch (e) {
-						Q.warn("locale catalog failed to load for SSR", { locale: i }, e);
+						Q.warn("locale catalog failed to load for SSR", { locale: n }, e);
 					}
-					if (o = Object.keys(s).length > 0, Object.keys(s).length === 0) {
-						let { resolveLocale: e } = await r("@voltro/i18n/server");
-						return (n, r) => ({
+					if (o = Object.keys(c).length > 0, Object.keys(c).length === 0) {
+						let { resolveLocale: e, resolveTimeZone: i } = await r("@voltro/i18n/server");
+						return (r, o) => ({
 							locale: e({
-								cookieHeader: n ?? null,
-								acceptLanguageHeader: r ?? null,
+								cookieHeader: r ?? null,
+								acceptLanguageHeader: o ?? null,
 								supported: t,
 								defaultLocale: a
 							}),
+							timeZone: i({
+								cookieHeader: r ?? null,
+								configured: n.timeZone ?? null,
+								defaultTimeZone: n.defaultTimeZone ?? null
+							}),
 							outerWrap: (e) => e
 						});
 					}
-					return i({
-						wraps: s,
+					return s({
+						wraps: c,
 						supported: t,
-						defaultLocale: a
+						defaultLocale: a,
+						timeZone: n.timeZone ?? null,
+						defaultTimeZone: n.defaultTimeZone ?? null
 					});
 				})(), i);
 			};
@@ -3073,24 +3128,24 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				if (d.startsWith("/@") || d.startsWith("/node_modules/") || d.startsWith("/.framework/") || d.startsWith("/_voltro/") || d === "/main.tsx" || d === "/index.html" || d === "/sw.js" || d === "/favicon.ico" || d === "/robots.txt") return l();
 				let p = async () => {
 					if (X.length === 0) return;
-					let e = xr(X, {
+					let e = Cr(X, {
 						route: void 0,
 						pathname: d
 					});
 					if (e === void 0) return;
 					let t = {};
 					for (let [e, n] of Object.entries(i.headers ?? {})) typeof n == "string" ? t[e] = n : Array.isArray(n) && (t[e] = n.join(", "));
-					let n = await jr(e, {
+					let n = await Nr(e, {
 						pathname: d,
 						search: f,
 						headers: t,
-						cookies: wr(t.cookie),
+						cookies: Er(t.cookie),
 						route: void 0
 					});
-					for (let e of n.setCookies) c.appendHeader("set-cookie", Or(e));
+					for (let e of n.setCookies) c.appendHeader("set-cookie", Ar(e));
 				};
 				if (/\.[a-z0-9]+$/i.test(d)) return await p(), l();
-				let m = ti(d, F.ssrRoutes);
+				let m = ri(d, F.ssrRoutes);
 				if (!m) return await p(), l();
 				let h = !xe.has(m.route.pattern), g = Date.now();
 				h && Q.info(`ssr compiling ${m.route.pattern}`, {
@@ -3112,29 +3167,29 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 					}
 				}, x = !1;
 				try {
-					let S = await y("loadPage", async () => await r(O(e, "src", "pages", m.route.file))), C = _(S, O("src", "pages", m.route.file)), w = Yr(F.dirs, m.route.dirChain), T = C === "spa" && w.some((e) => e.hasLayout);
+					let S = await y("loadPage", async () => await r(O(e, "src", "pages", m.route.file))), C = _(S, O("src", "pages", m.route.file)), w = Zr(F.dirs, m.route.dirChain), T = C === "spa" && w.some((e) => e.hasLayout);
 					if (C !== "ssr" && C !== "isr" && !T) return await p(), l();
 					let E = {};
 					for (let [e, t] of Object.entries(i.headers ?? {})) typeof t == "string" ? E[e] = t : Array.isArray(t) && (E[e] = t.join(", "));
-					let D = await jr(xr(X, {
+					let D = await Nr(Cr(X, {
 						route: m.route.pattern,
 						pathname: d
 					}), {
 						pathname: d,
 						search: f,
 						headers: E,
-						cookies: wr(E.cookie),
+						cookies: Er(E.cookie),
 						route: m.route.pattern
 					}, ze);
-					for (let e of D.setCookies) c.appendHeader("set-cookie", Or(e));
-					let k = D.headers, A = fi(di(a[0], { allowDevProxy: !0 }), D.headers.cookie, {
+					for (let e of D.setCookies) c.appendHeader("set-cookie", Ar(e));
+					let k = D.headers, A = mi(pi(a[0], { allowDevProxy: !0 }), D.headers.cookie, {
 						apiName: a[0]?.name,
 						headers: D.headers
 					}), j = new AbortController(), M = () => j.abort();
 					c.once("close", M);
 					let N = null, P = [], ee = {};
 					try {
-						(await r("@voltro/web/ssr")).beginStoreSeeds(), {chain: P, segmentLoaderData: ee} = await y("loadChain", () => Xr({
+						(await r("@voltro/web/ssr")).beginStoreSeeds(), {chain: P, segmentLoaderData: ee} = await y("loadChain", () => Qr({
 							entries: w,
 							loadLayout: (t) => r(O(e, "src", "pages", t.dir, "layout.tsx")),
 							loadError: (t) => r(O(e, "src", "pages", t.dir, "error.tsx")),
@@ -3163,7 +3218,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 						c.off("close", M);
 					}
 					let I = await y("loadSsrHelpers", async () => await r("@voltro/web/ssr"));
-					T || await cr({
+					T || await ur({
 						pageMod: S,
 						params: m.params,
 						query: A,
@@ -3230,7 +3285,11 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 						];
 						for (let e of n) await b(e, t, re);
 					});
-					let H = await y("readShell", Oe), U = await y("transformShell", () => t.transformIndexHtml(u, H)), ie = re.map((e) => `<link rel="stylesheet" href="${e}?direct" />`).join("\n    "), W = z?.locale ?? L.cookies["voltro:locale"] ?? n.defaultLocale ?? (n.locales ?? [])[0] ?? "en", ae = Date.now();
+					let H = await y("readShell", Oe), U = await y("transformShell", () => t.transformIndexHtml(u, H)), ie = re.map((e) => `<link rel="stylesheet" href="${e}?direct" />`).join("\n    "), ae = z?.locale ?? L.cookies["voltro:locale"] ?? n.defaultLocale ?? (n.locales ?? [])[0] ?? "en", oe = Date.now(), W = {
+						lang: ae,
+						...z?.timeZone === void 0 ? {} : { timeZone: z.timeZone },
+						renderedAt: oe
+					};
 					if (B) {
 						let e = (e) => Vn({
 							helpers: I,
@@ -3239,13 +3298,13 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 							interactive: R,
 							extra: [ie]
 						});
-						if (B.hasDeferred) ar({
+						if (B.hasDeferred) sr({
 							res: c,
 							shell: nr({
 								shell: U,
 								inlineModuleScriptsAsync: !0
 							}),
-							htmlLang: W,
+							documentAttrs: W,
 							headers: {
 								"content-type": "text/html; charset=utf-8",
 								"x-voltro-rendered-by": "spa-shell-dev"
@@ -3263,7 +3322,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 							let t = Bn({
 								helpers: I,
 								prepared: B
-							}), n = U.replace("<div id=\"root\"></div>", `<div id="root">${t.body}</div>`).replace("</head>", `    ${e(t.meta)}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${W}"`);
+							}), n = ar(U.replace("<div id=\"root\"></div>", `<div id="root">${t.body}</div>`).replace("</head>", `    ${e(t.meta)}\n  </head>`), W);
 							c.statusCode = 200, c.setHeader("content-type", "text/html; charset=utf-8"), c.setHeader("x-voltro-rendered-by", "spa-shell-dev"), c.end(n);
 						}
 					} else if (V) {
@@ -3283,13 +3342,13 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 							requestContext: L,
 							...ne
 						};
-						if (C === "ssr" && R === "full") ar({
+						if (C === "ssr" && R === "full") sr({
 							res: c,
 							shell: nr({
 								shell: U,
 								inlineModuleScriptsAsync: !0
 							}),
-							htmlLang: W,
+							documentAttrs: W,
 							headers: {
 								"content-type": "text/html; charset=utf-8",
 								"x-voltro-rendered-by": "ssr-dev"
@@ -3304,11 +3363,11 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 							}
 						});
 						else {
-							let { html: n, meta: r } = I.renderPageToHtml(t), i = U.replace("<div id=\"root\"></div>", `<div id="root">${n}</div>`).replace("</head>", `    ${e(r)}\n  </head>`).replace(/<html(\s+lang="[^"]*")?/i, `<html lang="${W}"`);
+							let { html: n, meta: r } = I.renderPageToHtml(t), i = ar(U.replace("<div id=\"root\"></div>", `<div id="root">${n}</div>`).replace("</head>", `    ${e(r)}\n  </head>`), W);
 							c.statusCode = 200, c.setHeader("content-type", "text/html; charset=utf-8"), c.setHeader("x-voltro-rendered-by", "ssr-dev"), c.end(i);
 						}
 					}
-					v.render = Date.now() - ae;
+					v.render = Date.now() - oe;
 					let G = Date.now() - g;
 					h ? (xe.add(m.route.pattern), Q.info(`ssr compiled ${m.route.pattern} in ${G}ms`, {
 						pattern: m.route.pattern,
@@ -3342,13 +3401,13 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 				}
 			});
 		}
-	}, je = Date.now(), Me = te.version ?? "?", Ne = await Pr(), Fe = O(e, "node_modules", "@voltro", "ui-shadcn"), Y = j(O(Fe, "package.json")) ? Fe : null, Ie = [], Le = await (async () => {
+	}, je = Date.now(), Me = te.version ?? "?", Ne = await Ir(), Fe = O(e, "node_modules", "@voltro", "ui-shadcn"), Y = j(O(Fe, "package.json")) ? Fe : null, Ie = [], Le = await (async () => {
 		let t = [];
 		for (let n of a) {
-			let r = await ni(e, n.pkg);
+			let r = await ii(e, n.pkg);
 			r && t.push(r);
 		}
-		let n = await pr(t);
+		let n = await hr(t);
 		if (n === void 0) return !1;
 		let r = O(z, ".voltro-rpcgroup-optimize"), i = "";
 		try {
@@ -3364,8 +3423,8 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			cookie: e.name,
 			hint: "If your IdP client reads this from `document.cookie` (Supabase's `createBrowserClient` does), pass `httpOnly: false`. Otherwise the SSR render succeeds and the user is signed out at the first client-side call. Set `httpOnly: true` explicitly to silence this."
 		}));
-	}, X = await Ar(e);
-	X.length > 0 && Q.info(`middleware.ts loaded — ${X.length} middleware(s): ` + X.map((e) => e.exportName).join(", ")), Cr(X, F.ssrRoutes.map((e) => e.pattern)), Le && Q.info("rpcGroup changed since last boot — forcing a dep re-optimize so the browser loads the current api client");
+	}, X = await Mr(e);
+	X.length > 0 && Q.info(`middleware.ts loaded — ${X.length} middleware(s): ` + X.map((e) => e.exportName).join(", ")), Tr(X, F.ssrRoutes.map((e) => e.pattern)), Le && Q.info("rpcGroup changed since last boot — forcing a dep re-optimize so the browser loads the current api client");
 	try {
 		await Pe(l, "voltro dev (web)");
 	} catch (e) {
@@ -3421,7 +3480,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			L(),
 			R(),
 			re,
-			ae,
+			oe,
 			fe,
 			he,
 			ge,
@@ -3435,12 +3494,12 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 			host: !0,
 			allowedHosts: n.allowedHosts === !0 || [...n.allowedHosts ?? []],
 			proxy: q,
-			fs: { allow: [e, ...Br(e)] }
+			fs: { allow: [e, ...Hr(e)] }
 		},
 		appType: "spa",
 		cacheDir: O(z, ".vite"),
 		publicDir: O(e, "public")
-	})).listen(), Mr.info(`v${Me} ready in ${Date.now() - je}ms`, {
+	})).listen(), Pr.info(`v${Me} ready in ${Date.now() - je}ms`, {
 		version: Me,
 		bootMs: Date.now() - je
 	}), Q.info(`listening on http://localhost:${l}`, {
@@ -3490,23 +3549,23 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		url: `http://localhost:${l}`,
 		bootMs: Date.now() - je
 	}), new Promise(() => {});
-}, vi = async (t) => {
+}, bi = async (t) => {
 	e("serve");
-	let n = await gi(t);
+	let n = await vi(t);
 	if (!n) return {
 		ran: !1,
 		exitCode: 0
 	};
 	let i = Date.now(), a = Q.child("serve");
 	a.info("booting voltro serve (preview)", { app: n.name ?? "(unnamed)" });
-	let o = await si(t, n);
+	let o = await li(t, n);
 	for (let e of o) a.info("api wired", {
 		name: e.name,
 		pkg: e.pkg
 	});
-	await pi(t, n, o);
+	await hi(t, n, o);
 	{
-		let { pages: e } = await Jr(O(t, "src", "pages"));
+		let { pages: e } = await Xr(O(t, "src", "pages"));
 		await mt({
 			appRoot: t,
 			pages: e
@@ -3530,7 +3589,7 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 		] },
 		build: {
 			outDir: "dist",
-			rollupOptions: { output: { manualChunks: Hr } }
+			rollupOptions: { output: { manualChunks: Wr } }
 		},
 		publicDir: O(t, "public")
 	});
@@ -3552,4 +3611,4 @@ The wrapper is what carries \`match\`, and what lets \`voltro doctor\` report wh
 	}), new Promise(() => {});
 };
 //#endregion
-export { yt as $, rr as A, Cn as B, Ar as C, xr as D, jr as E, zn as F, Xt as G, wn as H, Bn as I, Ft as J, Jt as K, Vn as L, ar as M, In as N, Or as O, Rn as P, bt as Q, Hn as R, kr as S, wr as T, on as U, Pn as V, en as W, St as X, Ct as Y, wt as Z, vi as _, be as _t, Xr as a, He as at, pi as b, Kr as c, We as ct, gi as d, J as dt, mt as et, si as f, De as ft, _i as g, xe as gt, li as h, Ce as ht, fi as i, Be as it, nr as j, cr as k, $ as l, Pe as lt, ai as m, Ee as mt, di as n, nt, hi as o, Ve as ot, ii as p, Te as pt, Bt as q, oi as r, tt as rt, Yr as s, Ue as st, Ur as t, it as tt, qr as u, ke as ut, Hr as v, _e as vt, Sr as w, Cr as x, Jr as y, Tn as z };
+export { bt as $, ar as A, Tn as B, Mr as C, Cr as D, Nr as E, Rn as F, en as G, Pn as H, zn as I, Bt as J, Xt as K, Bn as L, nr as M, sr as N, Ar as O, In as P, wt as Q, Vn as R, jr as S, Er as T, wn as U, Cn as V, on as W, Ct as X, Ft as Y, St as Z, bi as _, xe as _t, Qr as a, Be as at, hi as b, Jr as c, Ue as ct, vi as d, ke as dt, yt as et, li as f, J as ft, yi as g, Ce as gt, di as h, Ee as ht, mi as i, tt as it, rr as j, ur as k, $ as l, We as lt, si as m, Te as mt, pi as n, it as nt, _i as o, He as ot, oi as p, De as pt, Jt as q, ci as r, nt as rt, Zr as s, Ve as st, Gr as t, mt as tt, Yr as u, Pe as ut, Wr as v, be as vt, wr as w, Tr as x, Xr as y, _e as yt, Hn as z };